mirror of
https://github.com/brain-hackers/buildbrain
synced 2024-11-14 22:38:01 +09:00
144 lines
4.0 KiB
Markdown
144 lines
4.0 KiB
Markdown
buildbrain
|
|
==========
|
|
|
|
This repository includes:
|
|
|
|
- linux-brain, u-boot-brain, nkbin_maker and boot4u as submodules
|
|
- Useful build targets in Makefile
|
|
- r3build.toml to watch changes that occur in submodules
|
|
|
|
|
|
Confirmed environments
|
|
----------------------
|
|
|
|
- Debian 10 (buster) amd64
|
|
- Debian 11 (bullseye) amd64
|
|
|
|
|
|
Getting Started
|
|
---------------
|
|
|
|
1. Install dependencies.
|
|
|
|
```
|
|
$ sudo apt install build-essential bison flex libncurses5-dev gcc-arm-linux-gnueabi gcc-arm-linux-gnueabihf libssl-dev bc lzop qemu-user-static debootstrap kpartx libyaml-dev python3-pyelftools
|
|
```
|
|
|
|
1. Clone this repository with recursive clone enabled.
|
|
|
|
```
|
|
$ git clone --recursive git@github.com:brain-hackers/buildbrain.git
|
|
```
|
|
|
|
- If you've cloned it without `--recursive`, run following command:
|
|
|
|
```
|
|
$ git submodule update --init --recursive
|
|
```
|
|
|
|
1. Install uuu.
|
|
|
|
- Follow [the instruction](https://github.com/NXPmicro/mfgtools#linux) and build `uuu` executable.
|
|
- Put `uuu` where the PATH executable points to.
|
|
|
|
|
|
Build U-Boot
|
|
-----------------------
|
|
|
|
1. Run `make udefconfig-sh*` to generate `.config`.
|
|
|
|
- For Sx1: `make udefconfig-sh1`
|
|
- For Sx6: `make udefconfig-sh6`
|
|
- For x1: `make udefconfig-h1`
|
|
|
|
2. Run `make ubuild` to build whole repository and generate `u-boot.sb` or `u-boot.bin`.
|
|
|
|
- i.MX283 loads a packed U-Boot executable called `u-boot.sb`.
|
|
|
|
|
|
Inject U-Boot into i.MX283 in recovery mode
|
|
-----------------------
|
|
1. Follow `Build U-Boot` procedure to make U-Boot binary.
|
|
|
|
1. Run `make uuu`
|
|
|
|
Build and make NK.bin
|
|
-----------------------
|
|
|
|
1. Follow `Build U-Boot` procedure to make U-Boot binary.
|
|
|
|
1. Run `make nkbin-maker`.
|
|
|
|
1. To make `nk.bin`, run `make nk.bin`.
|
|
|
|
- nkbin_maker packs `u-boot.bin` into `nk.bin`.
|
|
|
|
Build and deploy boot4u
|
|
-----------------------
|
|
|
|
1. Run `make boot4u`
|
|
|
|
1. Create index.din and copy AppMain.bin
|
|
- `mkdir /path/to/your/sd/1st/partition/App/boot4u`
|
|
- `touch /path/to/your/sd/1st/partition/App/boot4u/index.din`
|
|
- `cp boot4u/AppMain.bin /path/to/your/sd/1st/partition/App/boot4u/`
|
|
|
|
|
|
Build Linux
|
|
-----------
|
|
|
|
1. Run `make ldefconfig` to generate `.config`.
|
|
|
|
1. Run `make lbuild` to generate `zImage`.
|
|
|
|
1. Confirm that `linux-brain/arch/arm/boot/zImage` exists.
|
|
|
|
|
|
Build a Debian rootfs
|
|
---------------------
|
|
|
|
1. Run `make ldefconfig lbuild`.
|
|
|
|
1. Run APT cache in background (mandatory): `make aptcache`.
|
|
|
|
1. Run `make brainux`.
|
|
|
|
1. Run `make image/sd.img`
|
|
|
|
1. Confirm that `image/sd.img` is built and burn it to an SD card.
|
|
|
|
|
|
Build a Buildroot rootfs
|
|
------------------------
|
|
|
|
Buildroot rootfs aims to be the most lightweight rootfs for experimental use. `make buildroot_rootfs` runs the defconfig target for rootfs-only build and then builds the rootfs tarball and a CPIO archive for initramfs. `make image/sd_buildroot.img` makes a bootable SD image in `image` directory like the typical Brainux SD image.
|
|
|
|
If you want to customize the build of Buildroot, `cd` into `buildroot` and use the following targets:
|
|
|
|
- `make menuconfig` to change the configuration
|
|
- `make` to build the rootfs (`-j` option might give you extra speed)
|
|
|
|
`image/sd_buildroot.img` target expects presence of the tarball at `buildroot/output/images/rootfs.tar`. You'll have to `clean` and rebuild every time you change the Buildroot's config before making the SD image.
|
|
|
|
|
|
Known issues
|
|
----------------------------------------
|
|
If you use GCC 10 for the host compiler, `make ubuild` may fail.
|
|
To complete build, open `/u-boot-brain/scripts/dtc/dtc-lexer.lex.c` or `/u-boot-brain/scripts/dtc/dtc-parser.tab.c` then comment out `YYLTYPE yylloc;`
|
|
|
|
Watch changes in submodules & auto-build
|
|
----------------------------------------
|
|
|
|
1. Run `make setup-dev` to prepare a Python venv to watch code changes. Namely;
|
|
|
|
- Python 3 venv in `env`
|
|
- r3build command in the env
|
|
|
|
1. Run `r3build`. It'll detect the changes you make and builds the corresponding executable automatically.
|
|
|
|
|
|
What's r3build?
|
|
---------------
|
|
|
|
[r3build](https://github.com/puhitaku/r3build) is a smart file watcher that aims to provide hot-reloading feature like Web frontend development.
|