.github/workflows | ||
boot4u@3f916a0cf7 | ||
brainlilo@c826f2581e | ||
cache | ||
image | ||
linux-brain@09cc34a56d | ||
nkbin_maker@4a97a4e807 | ||
os-brainux | ||
tools | ||
u-boot-brain@2696eb4b8d | ||
.clang-format | ||
.gitchangelog.rc | ||
.gitignore | ||
.gitmodules | ||
LICENSE | ||
Makefile | ||
r3build.toml | ||
README.md |
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
-
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
-
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
- If you've cloned it without
-
Install uuu.
- Follow the instruction and build
uuu
executable. - Put
uuu
where the PATH executable points to.
- Follow the instruction and build
Build U-Boot
-
Run
make udefconfig-sh*
to generate.config
.- For Sx1:
make udefconfig-sh1
- For Sx6:
make udefconfig-sh6
- For x1:
make udefconfig-h1
- For Sx1:
-
Run
make ubuild
to build whole repository and generateu-boot.sb
oru-boot.bin
.- i.MX283 loads a packed U-Boot executable called
u-boot.sb
.
- i.MX283 loads a packed U-Boot executable called
Inject U-Boot into i.MX283 in recovery mode
-
Follow
Build U-Boot
procedure to make U-Boot binary. -
Run
make uuu
Build and make NK.bin
-
Follow
Build U-Boot
procedure to make U-Boot binary. -
Run
make nkbin-maker
. -
To make
nk.bin
, runmake nk.bin
.- nkbin_maker packs
u-boot.bin
intonk.bin
.
- nkbin_maker packs
Build and deploy boot4u
-
Run
make boot4u
-
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
-
Run
make ldefconfig
to generate.config
. -
Run
make lbuild
to generatezImage
. -
Confirm that
linux-brain/arch/arm/boot/zImage
exists.
Bootstrap Debian 11 (bullseye)
-
Run
make ldefconfig lbuild
. -
Run APT cache in background (mandatory):
make aptcache
. -
Run
make brainux
. -
Run
make image/sd.img
-
Confirm that
image/sd.img
is built and burn it to an SD card.
Known issues
If you using gcc 10 for 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
-
Run
make setup-dev
to prepare a Python venv to watch code changes. Namely;- Python 3 venv in
env
- r3build command in the env
- Python 3 venv in
-
Run
r3build
. It'll detect the changes you make and builds the corresponding executable automatically.
What's r3build?
r3build is a smart file watcher that aims to provide hot-reloading feature like Web frontend development.