|
1 | 1 | # ADI br2-external |
2 | 2 |
|
3 | 3 | This [br2-external](https://buildroot.org/downloads/manual/manual.html#outside-br-custom) |
4 | | -contains Buildroot configuration specific to ADI that can not be mainlined. |
5 | | -Generic support for ADI evaluation boards is implemented in the [ADI Buildroot |
6 | | -tree](github.com/analogdevicesinc/buildroot). |
| 4 | +contains Buildroot configuration specific to ADI that cannot be mainlined. |
| 5 | +Generic support for ADI evaluation boards is implemented in the |
| 6 | +[ADI Buildroot tree](github.com/analogdevicesinc/buildroot). |
7 | 7 |
|
8 | | -``` |
| 8 | +## Getting Started |
| 9 | + |
| 10 | +```sh |
9 | 11 | git clone --recurse-submodules https://github.com/analogdevicesinc/br2-external.git |
10 | 12 | cd br2-external/buildroot |
11 | 13 | make BR2_EXTERNAL="${PWD}/.." adi_sc598_ezkit_defconfig |
| 14 | +``` |
| 15 | + |
| 16 | +Additional configuration is applied using Buildroot fragments: |
| 17 | + |
| 18 | +```sh |
12 | 19 | support/kconfig/merge_config.sh .config \ |
13 | 20 | ../configs/buildroot.fragment \ |
14 | | - ../configs/debug.fragment |
| 21 | + <ADI Configuration fragments> |
15 | 22 | ``` |
16 | 23 |
|
17 | | -Then follow the board specific instructions in `buildroot/board/adi/`. |
18 | | - |
19 | | -## ADI configuration |
| 24 | +## ADI Configuration Fragments |
20 | 25 |
|
21 | 26 | - `configs/buildroot.fragment` |
22 | 27 | - Configure Buildroot to speed up builds |
23 | 28 | - `configs/debug.fragment` |
24 | 29 | - Enable debugging in U-Boot and the kernel |
25 | 30 | - Build the kernel image with an embedded root filesystem to reduce |
26 | 31 | complexity around writing and mounting a root filesystem from storage |
| 32 | +- `configs/bootstrap.fragment` |
| 33 | + - Enable a minimal bootstrap / installer image. |
| 34 | + - Includes only the tools required to program boot media. |
| 35 | + |
| 36 | +## Example Builds |
| 37 | + |
| 38 | +### Debug Image |
| 39 | + |
| 40 | +```sh |
| 41 | +make BR2_EXTERNAL="${PWD}/.." adi_sc598_ezkit_defconfig |
| 42 | +support/kconfig/merge_config.sh .config \ |
| 43 | + ../configs/buildroot.fragment \ |
| 44 | + ../configs/debug.fragment |
| 45 | +make -j$(nproc) |
| 46 | +``` |
| 47 | + |
| 48 | +### Bootstrap Image |
| 49 | + |
| 50 | +```sh |
| 51 | +make BR2_EXTERNAL="${PWD}/.." adi_sc598_ezkit_defconfig |
| 52 | +support/kconfig/merge_config.sh .config \ |
| 53 | + ../configs/buildroot.fragment \ |
| 54 | + ../configs/bootstrap.fragment |
| 55 | +make -j$(nproc) |
| 56 | +``` |
0 commit comments