This repo is my practical documentation for building and debugging a custom Yocto Linux image for the Avnet MaaXBoard from scratch inside an Ubuntu 22.04 VirtualBox VM. It covers environment setup, BitBake builds, SD flashing, and the most common bring-up issues (serial console, HDMI, Weston/terminal debugging).
The Avnet MaaXBoard is an embedded development board. It is commonly used for:
- embedded Linux development
- Yocto/Buildroot workflows
- hardware bring-up and debugging
- serial/UART and display pipeline debugging
- learning real boot chains (U-Boot → kernel → userspace)
This repo treats the MaaXBoard as a real embedded target, not a desktop Linux system.
- 00_index.md — start here (table of contents + summary)
- 01_environment_setup.md — VM setup + dependencies + swap
- 02_building_bitbake.md — Yocto build environment + BitBake workflow
- 03_flashing_sdcard.md — writing the
.wicimage to an SD card - 04_serial_connection.md — UART serial connection + troubleshooting
- 05_hdmi_and_display_fix.md — display/overlay fixes
- 06_weston_and_terminal_debug.md — disabling Weston / console boot
- 07_testing_common_issues.md — common failures + fixes
- 08_gallery.md — build + hardware photos (see note below)
Figure 1: Complete MaaXBoard development setup including HDMI display, USB peripherals, serial connection, and host machine.
Figure 2: Avnet MaaXBoard hardware showing HDMI, Ethernet, USB ports, microSD slot, and serial header.
Start with 00_index.md, then follow the sections in order. Each file is written as a “do this → expect this → if it breaks, try this” checklist.
Author: Eric Huang