blob: f9808c76dad8682aa784bf6615712051674bc131 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
# Get Started Building EC Images (Quickly)
[TOC]
The
[Chromium OS Developer Guide](https://chromium.googlesource.com/chromiumos/docs/+/HEAD/developer_guide.md)
and [README](../README.md) walk through the steps needed to fetch and build
Chromium OS source. These steps can be followed to retrieve and build EC source
as well. On the other hand, if your sole interest is building an EC image, the
general developer guide contains some extra unneeded steps.
The fastest possible way to build an EC image is to skip the Chromium OS chroot
install entirely. The following steps have been tested on an Ubuntu 15.10 (Wily
Werewolf) 64-bit host machine. Other distros / versions may be used, but
toolchain incompatibilities may require extra debug.
## Building
1. Install build / dev tools:
```bash
sudo apt-get install git libftdi-dev libusb-dev libncurses5-dev gcc-arm-none-eabi
```
1. Sync the cros-ec git repo:
```bash
git clone https://chromium.googlesource.com/chromiumos/platform/ec
```
1. Select a target board
```bash
export BOARD=<target board>
```
Refer to the [Chromium OS Developer
Guide](https://chromium.googlesource.com/chromiumos/docs/+/HEAD/developer_guide.md)
for more details about selecting the appropriate target board. If you are
just getting your environment set up and are unsure which board you will be
targeting then you may select a board from `board/` or just
choose a safe default, such as `nocturne`.
1. Build your EC image:
```bash
HOSTCC=x86_64-linux-gnu-gcc CROSS_COMPILE_arm=arm-none-eabi- make BOARD=${BOARD}
```
Note: the EC supports multiple architectures, check `core/*/build.mk` files
for other supported `CROSS_COMPILE_` variables.
## External Dependencies
Most boards are buildable, but some will fail due to dependencies on external
binaries (such as [`futility`](#building-futility)). Also, some related tools
(such as `flash_ec` and `servod`) must be run from the Chromium OS chroot. Here
is a set of steps to setup a minimal development environment to build EC images
from the Chromium OS chroot:
1. Create a folder for your chroot:
```bash
mkdir cros-src; cd cros-src
```
1. Run
```bash
repo init -u https://chromium.googlesource.com/chromiumos/manifest -g minilayout,firmware
```
1. Run `repo sync`:
```bash
repo sync -j <number of cores on your workstatsion>
```
1. Enter the chroot and enter your password for `sudo` if prompted:
```bash
./chromite/bin/cros_sdk
```
1. Set up your board:
```bash
setup_board --board=${BOARD}
```
(ex. `setup_board --board=glados`)
1. Build EC:
```bash
./build_packages --board=${BOARD} chromeos-ec
```
1. Now, EC images for any board can be built with:
```bash
cd ~/trunk/src/platform/ec; make BOARD=${BOARD} -j
```
## Building `futility` outside the chroot {#building-futility}
If you want to build the `futility` host tool outside the normal Chrome OS
chroot self-contained environment, you can try the following
1. Install futility build dependencies:
```bash
sudo apt-get install uuid-dev liblzma-dev libyaml-dev libssl-dev
```
1. Get the vboot reference sources:
```bash
git clone https://chromium.googlesource.com/chromiumos/platform/vboot_reference
```
1. Build it:
```bash
cd vboot_reference ; make
```
1. Install it in `/usr/local/bin`:
```bash
sudo make install
```
1. Add `/usr/local/bin` to your default `PATH`:
```bash
export PATH="${PATH}:/usr/local/bin"
```
|
