Zhihe a210

.gitignore

@@ -3,3 +3,11 @@ target/
 k230-build*.log
 *.log
 Cargo.lock
+
+# Vendor closed firmware blobs (NOT redistributable, see firmware/README.md)
+boards/*/firmware/vendor/
+boards/zhihe-a210/firmware/*.bin
+
+# Build artifacts staged into bundle
+boards/*/uboot_env.img
+boards/*/gpt.img

README.md

@@ -120,12 +120,29 @@ eselect repository create crossdev
 Each board lives in `boards/<name>/` with:
 - `board.conf` -- variables read by Rust and bash scripts
 - `genimage.cfg` -- disk image layout
+- `sandbox-packages.txt` -- extra host packages for the sandbox (optional)
+- `sandbox-packages.use` -- USE flags for those packages (optional)
+- `target-packages.txt` -- extra packages cross-emerged into the image (optional)
 - `pre-{step}.sh` -- runs before Rust default (optional)
 - `post-{step}.sh` -- runs after Rust default (optional)
 - `override-{step}.sh` -- replaces Rust default entirely (optional)
 
 Steps: `deps`, `checkout`, `bootloader`, `kernel`, `assemble`, `pack`
 
+Package lists in `defaults/` apply to every sandbox
+(`defaults/sandbox-packages.txt`) and every image
+(`defaults/target-packages.txt`).  The effective target set is
+`defaults/target-packages.txt` UNION `boards/<name>/target-packages.txt`
+MINUS the board's `-atom` lines (e.g. `-app-misc/fastfetch` drops a
+default) -- every part is a plain file.  Subtracting an atom not in the
+set warns and does nothing; `-atom` lines in the defaults file itself
+are an error.  Heavy extras (mold, go, cmake, rust, iw, wpa_supplicant)
+stay out of the defaults -- boards opt in via their own list.
+List lines are `atom [keywords]` -- a keyword override (e.g.
+`sys-boot/syslinux **`) lands in `etc/portage/package.accept_keywords/`.
+Portage config files under `defaults/portage/` are overlaid onto the
+sandbox's `etc/portage/` during prepare.
+
 ### Build step execution
 
 ```

boards/k3/target-packages.txt

@@ -1,26 +1,14 @@
-# Packages to cross-install into the target sysroot for the K3 image
+# K3 extras on top of defaults/target-packages.txt
 
-# Services
-net-misc/openssh
-app-admin/metalog
-net-misc/ntp
-
-# Initramfs / boot
-sys-apps/busybox
-
-# Dev tools
-app-editors/vim
-dev-vcs/git
+# Dev tools (git is in defaults)
 dev-debug/strace
 dev-debug/gdb
 net-misc/curl
 net-misc/wget
 
 # System tools
-sys-process/htop
 sys-process/lsof
 sys-apps/file
-app-misc/fastfetch
 app-misc/screen
 
 # Build systems

boards/pentium-mmx/target-packages.txt

@@ -1,12 +1,7 @@
-# Packages cross-installed into the i586 target sysroot
+# pentium-mmx extras on top of defaults/target-packages.txt
 
-# Network & remote access (services enabled in BOOT_SERVICES)
-net-misc/openssh
+# Network (service enabled in BOOT_SERVICES)
 net-misc/dhcpcd
 
 # Disk utilities required by the grow-rootfs first-boot service
-sys-block/parted
 sys-fs/e2fsprogs
-
-# Minimal shell utilities
-sys-apps/busybox