Skip to content

Buildroot BeaglePlay labs#331

Open
kostyakozko wants to merge 5 commits into
bootlin:masterfrom
kostyakozko:buildroot-beagleplay-labs
Open

Buildroot BeaglePlay labs#331
kostyakozko wants to merge 5 commits into
bootlin:masterfrom
kostyakozko:buildroot-beagleplay-labs

Conversation

@kostyakozko
Copy link
Copy Markdown

Added practical labs and lab data for BeaglePlay
Added BeaglePlay shopping list slide into slides

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 23, 2026

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@kostyakozko
Copy link
Copy Markdown
Author

I have read the CLA Document and I hereby sign the CLA.

@kostyakozko
Copy link
Copy Markdown
Author

recheck

Add Buildroot training labs targeting the BeaglePlay board (TI AM625x,
AArch64/Cortex-A53), following the same pattern as the existing BBB and
STM32MP1 variants.

New files:
- labs/buildroot-basic-beagleplay: Board setup, Buildroot configuration
  (AArch64, Bootlin aarch64 toolchain, kernel defconfig, U-Boot
  am62x_evm_a53, TF-A), build and boot instructions
- labs/buildroot-rootfs-beagleplay: Root filesystem customization using
  Ethernet networking, Nunchuk on I2C3 (mikroBUS connector), kernel
  patches and defconfig management
- common/beagleplay-sdcard-preparation.tex: SD card partitioning for
  the AM62x boot flow (FAT32 boot + ext4 rootfs)
- common/buildroot-beagleplay-labs-vars.tex: Board variables
- lab-data/buildroot-beagleplay/: Pre-built tiboot3.bin, Nunchuk driver
  patch, BeaglePlay DTS patch (I2C3), nInvaders joystick patch, sample
  app

Modified:
- mk/buildroot.mk: Add BUILDROOT_BEAGLEPLAY_LABS chapter list

This enables the following new make targets:
  make full-buildroot-beagleplay-labs.pdf
  make buildroot-beagleplay-labs.tar.xz
- Add buildroot-appdev-beagleplay lab: uses aarch64-linux-gcc/gdb and
  Ethernet IP 192.168.0.100 instead of arm-linux-gcc and USB gadget
- Add buildroot-advanced-beagleplay lab: BR2_EXTERNAL tree references
  board/bootlin/beagleplay/ paths, genimage section adapted for AM62x
  boot images (tiboot3.bin, tispl.bin, u-boot.img, Image, DTB)
- Update BUILDROOT_BEAGLEPLAY_LABS to use all board-specific labs
- Add shopping-list-beagleplay to buildroot slides
- Include buildroot in beagleplay-nunchuk training list for shopping
  list slide
- Add buildroot-new-packages-beagleplay: change "built for ARM" to
  "built for AArch64"
- Add buildroot-advanced-packages-beagleplay: use aarch64-linux-readelf
  instead of arm-linux-readelf
- Update BUILDROOT_BEAGLEPLAY_LABS to use all board-specific lab
  variants (no shared BBB labs remain)
- Rewrite beagleplay-sdcard-preparation.tex to match the style of
  boneblack-sdcard-preparation.tex (enumerate structure, \code macros,
  option explanations)
- Improve DTS patch: use proper node name (joystick@52), realistic
  commit message format, correct arm64 path prefix
- Add buildroot to nunchuk training list in shopping-list-beagleplay
  .tex (LaTeX fallback version)
Instead of having Buildroot build the full TI K3 boot chain (ATF,
OP-TEE, ti-k3-boot-firmware, binman), which requires complex
configuration and TI's downstream U-Boot fork, simplify by:

- Providing both tiboot3.bin and tispl.bin as pre-built binaries
- Only building u-boot.img through Buildroot
- Using BINMAN_ALLOW_MISSING=1 custom make option to let U-Boot
  build complete without the first-stage firmware blobs

This approach is more reliable for students and avoids dependency
on TI-specific firmware that may change between releases. The lab
explains what each binary does and points to the Embedded Linux
course for those who want to build the full chain.

Also fixes: trailing dots on commands, tispl.bin_unsigned references,
and adds tispl.bin to lab-data.
- Add mtools to required packages (needed for genimage)
- Fix bar package version: v1.0 → v1.1, bar-1.0.tar.xz → bar-1.1.tar.gz
- Fix readelf path: output/host/usr/bin → output/host/bin
- Fix DTS patch node name consistency
@kostyakozko kostyakozko force-pushed the buildroot-beagleplay-labs branch from 02082af to 9dbd420 Compare May 25, 2026 10:15
github-actions Bot added a commit that referenced this pull request May 25, 2026
@kostyakozko kostyakozko force-pushed the buildroot-beagleplay-labs branch from 9dbd420 to f83e1c7 Compare May 25, 2026 10:18
@Tropicao Tropicao requested a review from tpetazzoni May 28, 2026 20:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant