Buildroot Practical · 10/20

Buildroot 실전 — BeagleBone Black 시스템 처음부터 끝까지

2026년 5월 19일 · Hawk · 8분 읽기

#한 줄 요약

“앞 아홉 장의 모든 개념을 하나의 SD 카드에 응축한다.” — BeagleBone Black을 켜 부팅 메시지가 흐르는 그 순간까지가 이 장의 목표입니다.

지금까지 다룬 것을 정리하면 다음과 같습니다. Buildroot의 위치(Ch 1), 디렉터리 구조(Ch 2), Kconfig(Ch 3), 첫 QEMU 빌드(Ch 4), 패키지 시스템(Ch 5), 외부 트리(Ch 6), 보드 customize(Ch 7), 파일시스템 포맷(Ch 8), 새 패키지 작성(Ch 9).

이 장에서는 그 전체를 실제 보드에 적용합니다. BeagleBone Black을 고른 이유는 Buildroot 본체에 defconfig가 있고, MMC 부팅이 단순하고, 시리얼 콘솔이 USB-TTL 어댑터 하나로 잡히고, 전 세계적으로 구하기 쉽기 때문입니다. 같은 흐름이 Raspberry Pi, BeaglePlay, Variscite, Olimex 보드에 거의 그대로 적용됩니다.

#무엇을 만들 것인가

부트로더: U-Boot (MLO + u-boot.img)
커널: linux-am335x with am335x-boneblack.dtb
rootfs: squashfs (read-only) + ext4 data partition
내 패키지: acme-led-blink — 보드 LED를 깜빡이는 데몬 (Ch 9 자작)
내 overlay: /etc/hostname을 acme-bbb로 설정 (Ch 7)
결과물: sdcard.img 하나. dd로 SD 카드에 굽고 보드에 꽂으면 부팅.

이 장의 전체 흐름은 다음과 같습니다.

defconfig → make → dd → 부팅 전체 흐름

#준비물

항목	사양
BeagleBone Black	rev C 권장. eMMC 4GB 내장
MicroSD 카드	8GB 이상, class 10
USB-TTL 어댑터	3.3V level. FTDI 또는 CP2102
Jumper wires	F-F 3가닥 (GND, RX, TX)
Host PC	Ubuntu 24.04 또는 동급. ~10GB 디스크 여유

호스트 의존성을 먼저 설치합니다.

1
sudo apt install -y \
2
    build-essential bc bison flex libssl-dev libncurses-dev \
3
    git wget cpio rsync unzip file python3 \
4
    parted dosfstools mtools

#Step 1: Buildroot 가져오기 + 외부 트리 준비

1
$ cd ~/work
2
$ git clone https://gitlab.com/buildroot.org/buildroot.git
3
$ cd buildroot
4
$ git checkout 2026.02      # LTS branch

외부 트리를 만듭니다. Ch 6의 패턴을 따릅니다.

1
$ mkdir -p ~/work/br2-acme/{package,board/acme/bbb,configs}
2
$ cd ~/work/br2-acme
3

4
$ cat > external.desc <<'EOF'
5
name: ACME
6
desc: ACME corporation Buildroot tree
7
EOF
8

9
$ cat > external.mk <<'EOF'
10
include $(sort $(wildcard $(BR2_EXTERNAL_ACME_PATH)/package/*/*.mk))
11
EOF
12

13
$ cat > Config.in <<'EOF'
14
menu "ACME packages"
15
    source "$BR2_EXTERNAL_ACME_PATH/package/acme-led-blink/Config.in"
16
endmenu
17
EOF

#Step 2: defconfig 베이스 — beaglebone_defconfig 복사

Buildroot 본체에 beaglebone_defconfig가 이미 있습니다. 이걸 외부 트리의 시작점으로 복사합니다.

1
$ cd ~/work/buildroot
2
$ make BR2_EXTERNAL=~/work/br2-acme beaglebone_defconfig
3
$ make savedefconfig BR2_DEFCONFIG=~/work/br2-acme/configs/acme_bbb_defconfig

이제 ~/work/br2-acme/configs/acme_bbb_defconfig가 최소 형태로 정규화된 defconfig입니다. 한번 열어 보면 핵심만 남아 있습니다.

1
BR2_arm=y
2
BR2_cortex_a8=y
3
BR2_ARM_FPU_VFPV3=y
4
BR2_TOOLCHAIN_EXTERNAL=y
5
BR2_LINUX_KERNEL=y
6
BR2_LINUX_KERNEL_CUSTOM_VERSION=y
7
BR2_LINUX_KERNEL_CUSTOM_VERSION_VALUE="6.6.21"
8
BR2_LINUX_KERNEL_DEFCONFIG="multi_v7"
9
BR2_LINUX_KERNEL_DTS_SUPPORT=y
10
BR2_LINUX_KERNEL_INTREE_DTS_NAME="am335x-boneblack"
11
BR2_TARGET_ROOTFS_EXT2=y
12
BR2_TARGET_ROOTFS_EXT2_4=y
13
BR2_TARGET_ROOTFS_EXT2_SIZE="120M"
14
BR2_TARGET_UBOOT=y
15
BR2_TARGET_UBOOT_BOARD_DEFCONFIG="am335x_evm"
16
BR2_TARGET_UBOOT_FORMAT_IMG=y
17
BR2_TARGET_UBOOT_SPL=y
18
BR2_TARGET_UBOOT_SPL_NAME="MLO"
19
BR2_PACKAGE_HOST_GENIMAGE=y
20
BR2_ROOTFS_POST_IMAGE_SCRIPT="board/beaglebone/post-image.sh"

#Step 3: 우리 식으로 defconfig 수정

acme_bbb_defconfig를 우리 요구에 맞춥니다.

1
# Read-only squashfs + data partition pattern (Ch 8)
2
BR2_TARGET_ROOTFS_SQUASHFS=y
3
BR2_TARGET_ROOTFS_SQUASHFS4_ZSTD=y
4
# ext4도 유지 — data partition 용도
5
BR2_TARGET_ROOTFS_EXT2=y
6
BR2_TARGET_ROOTFS_EXT2_4=y
7
BR2_TARGET_ROOTFS_EXT2_SIZE="120M"
8

9
# 외부 트리의 overlay + post-build + post-image (Ch 7)
10
BR2_ROOTFS_OVERLAY="$(BR2_EXTERNAL_ACME_PATH)/board/acme/bbb/rootfs-overlay"
11
BR2_ROOTFS_POST_BUILD_SCRIPT="$(BR2_EXTERNAL_ACME_PATH)/board/acme/bbb/post-build.sh"
12
BR2_ROOTFS_POST_IMAGE_SCRIPT="$(BR2_EXTERNAL_ACME_PATH)/board/acme/bbb/post-image.sh"
13
BR2_ROOTFS_POST_SCRIPT_ARGS="acme-bbb"
14

15
# 우리 패키지 (Ch 9)
16
BR2_PACKAGE_ACME_LED_BLINK=y
17

18
# 유용한 디버깅 도구
19
BR2_PACKAGE_DROPBEAR=y
20
BR2_PACKAGE_HTOP=y
21
BR2_PACKAGE_STRACE=y
22
BR2_PACKAGE_NANO=y

수정 후 다시 적용합니다.

1
$ make BR2_EXTERNAL=~/work/br2-acme acme_bbb_defconfig

#Step 4: acme-led-blink 패키지 작성

Ch 9의 패턴을 적용한 사례 패키지입니다.

1
br2-acme/package/acme-led-blink/
2
├── Config.in
3
├── acme-led-blink.mk
4
├── acme-led-blink.hash
5
└── src/
6
    ├── Makefile
7
    └── led-blink.c

src/led-blink.c:

1
#include <stdio.h>
2
#include <unistd.h>
3
#include <fcntl.h>
4
#include <string.h>
5

6
static const char *LED = "/sys/class/leds/beaglebone:green:usr0/brightness";
7

8
int main(void) {
9
    int fd = open(LED, O_WRONLY);
10
    if (fd < 0) { perror("open"); return 1; }
11
    for (;;) {
12
        write(fd, "1", 1);
13
        sleep(1);
14
        write(fd, "0", 1);
15
        sleep(1);
16
    }
17
    return 0;
18
}

src/Makefile:

1
CC ?= gcc
2
CFLAGS ?= -O2 -Wall
3

4
led-blink: led-blink.c
5
  $(CC) $(CFLAGS) -o $@ $<
6

7
install: led-blink
8
  install -D -m 0755 led-blink $(DESTDIR)/usr/sbin/led-blink
9

10
clean:
11
  rm -f led-blink
12

13
.PHONY: install clean

Config.in:

1
config BR2_PACKAGE_ACME_LED_BLINK
2
    bool "acme-led-blink"
3
    help
4
      Blinks the on-board USER0 LED of BeagleBone Black.

acme-led-blink.mk:

1
################################################################################
2
#
3
# acme-led-blink
4
#
5
################################################################################
6

7
ACME_LED_BLINK_VERSION = 1.0
8
ACME_LED_BLINK_SITE = $(BR2_EXTERNAL_ACME_PATH)/package/acme-led-blink/src
9
ACME_LED_BLINK_SITE_METHOD = local
10
ACME_LED_BLINK_LICENSE = Proprietary
11

12
define ACME_LED_BLINK_BUILD_CMDS
13
  $(MAKE) CC="$(TARGET_CC)" CFLAGS="$(TARGET_CFLAGS)" -C $(@D)
14
endef
15

16
define ACME_LED_BLINK_INSTALL_TARGET_CMDS
17
  $(MAKE) -C $(@D) DESTDIR=$(TARGET_DIR) install
18
endef
19

20
$(eval $(generic-package))

SITE_METHOD = local은 외부 트리 안의 디렉터리를 source로 사용합니다. tarball을 만들 필요가 없습니다. .hash 파일은 local 패키지면 생략 가능하지만, production에서는 별도 git tag로 받게 바꾸는 게 좋습니다.

빈 hash 파일을 만들어 둡니다.

1
$ touch ~/work/br2-acme/package/acme-led-blink/acme-led-blink.hash

#Step 5: rootfs-overlay 작성

Ch 7의 패턴입니다.

1
$ mkdir -p ~/work/br2-acme/board/acme/bbb/rootfs-overlay/etc/init.d
2
$ cd ~/work/br2-acme/board/acme/bbb/rootfs-overlay
3

4
$ cat > etc/hostname <<'EOF'
5
acme-bbb
6
EOF
7

8
$ cat > etc/issue <<'EOF'
9
ACME BeagleBone Black system
10
Built: @BUILDDATE@
11
EOF
12

13
$ cat > etc/init.d/S99led-blink <<'EOF'
14
#!/bin/sh
15
case "$1" in
16
    start)
17
        echo "Starting led-blink"
18
        /usr/sbin/led-blink &
19
        ;;
20
    stop)
21
        killall led-blink 2>/dev/null
22
        ;;
23
esac
24
EOF
25
$ chmod +x etc/init.d/S99led-blink

#Step 6: post-build.sh, post-image.sh, genimage.cfg

board/acme/bbb/post-build.sh:

1
#!/bin/sh
2
set -e
3
TARGET_DIR="$1"
4

5
# Stamp build date into /etc/issue
6
sed -i "s/@BUILDDATE@/$(date +%Y-%m-%d)/" "$TARGET_DIR/etc/issue"

board/acme/bbb/post-image.sh:

1
#!/bin/sh
2
set -e
3

4
BINARIES_DIR="$1"
5
BOARD=$2
6

7
GENIMAGE_CFG="$BR2_EXTERNAL_ACME_PATH/board/acme/bbb/genimage.cfg"
8
GENIMAGE_TMP="$BINARIES_DIR/genimage.tmp"
9

10
rm -rf "$GENIMAGE_TMP"
11
genimage \
12
    --rootpath "$TARGET_DIR" \
13
    --tmppath "$GENIMAGE_TMP" \
14
    --inputpath "$BINARIES_DIR" \
15
    --outputpath "$BINARIES_DIR" \
16
    --config "$GENIMAGE_CFG"
17

18
echo "[post-image] sdcard.img ready: $(du -h "$BINARIES_DIR/sdcard.img" | cut -f1)"

board/acme/bbb/genimage.cfg:

1
image boot.vfat {
2
    vfat {
3
        files = {
4
            "MLO",
5
            "u-boot.img",
6
            "zImage",
7
            "am335x-boneblack.dtb",
8
            "uEnv.txt"
9
        }
10
    }
11
    size = 16M
12
}
13

14
image sdcard.img {
15
    hdimage {}
16

17
    partition u-boot {
18
        partition-type = 0xC
19
        bootable = "true"
20
        image = "boot.vfat"
21
    }
22

23
    partition rootfs {
24
        partition-type = 0x83
25
        image = "rootfs.squashfs"
26
        size = 256M
27
    }
28

29
    partition data {
30
        partition-type = 0x83
31
        image = "rootfs.ext4"
32
        size = 128M
33
    }
34
}

스크립트에 실행 권한을 줍니다.

1
$ chmod +x ~/work/br2-acme/board/acme/bbb/post-build.sh
2
$ chmod +x ~/work/br2-acme/board/acme/bbb/post-image.sh

이 genimage.cfg가 만들어 내는 SD 카드 layout을 그림으로 보면 다음과 같습니다.

sdcard.img 3-파티션 layout

#Step 7: uEnv.txt — U-Boot 환경

U-Boot이 SD 카드 부팅 시점에 읽는 환경 파일입니다. 부트 명령을 외부에 두는 흐름의 핵심입니다.

rootfs-overlay가 아니라 board/acme/bbb/에 uEnv.txt를 직접 둡니다. genimage.cfg가 boot 파티션에 포함시킵니다. 그러나 우리 genimage는 binaries_dir 안의 파일만 vfat에 넣을 수 있으므로, post-image에서 미리 복사합니다.

post-image.sh 시작 부분에 추가:

1
cp "$BR2_EXTERNAL_ACME_PATH/board/acme/bbb/uEnv.txt" "$BINARIES_DIR/"

board/acme/bbb/uEnv.txt:

1
# BeagleBone Black boot env
2

3
bootdir=/
4
bootfile=zImage
5
dtbfile=am335x-boneblack.dtb
6

7
# console + read-only rootfs on p2 (squashfs)
8
optargs=console=ttyO0,115200n8 root=/dev/mmcblk0p2 rootfstype=squashfs ro rootwait quiet
9

10
uenvcmd=load mmc 0:1 ${loadaddr} ${bootdir}/${bootfile}; \
11
        load mmc 0:1 ${fdtaddr} ${bootdir}/${dtbfile}; \
12
        setenv bootargs ${optargs}; \
13
        bootz ${loadaddr} - ${fdtaddr}

핵심 라인입니다.

console=ttyO0,115200n8 — AM335x의 UART0. BeagleBone Black의 J1 헤더가 여기 연결됩니다.
root=/dev/mmcblk0p2 rootfstype=squashfs ro — 두 번째 파티션이 squashfs rootfs.
bootz — zImage 부팅 명령. ARM 32-bit.

#Step 8: 빌드

이제 모든 게 준비됐습니다. 빌드합니다.

1
$ cd ~/work/buildroot
2
$ make

첫 빌드는 30~60분이 걸립니다. host에 toolchain·cross 도구·U-Boot·linux 커널·BusyBox·우리 패키지를 모두 빌드합니다. 빌드 진행은 단계별로 출력됩니다.

1
>>> host-tar 1.34 Downloading
2
>>> linux-headers 6.6.21 Configuring
3
>>> uclibc 1.0.50 Building
4
>>> uboot 2024.04 Configuring
5
>>> linux 6.6.21 Building (35%)
6
>>> busybox 1.36.1 Installing to target
7
>>> acme-led-blink 1.0 Building
8
>>> Generating root filesystems common tables
9
>>> Generating filesystem image rootfs.squashfs
10
>>> Generating filesystem image rootfs.ext4
11
>>> Executing post-image script board/acme/bbb/post-image.sh
12
[post-image] sdcard.img ready: 401M

완료 후 output/images/를 봅니다.

1
$ ls -lh output/images/
2
-rw-r--r-- 1 user user  16M ...  MLO
3
-rw-r--r-- 1 user user  580K ... u-boot.img
4
-rw-r--r-- 1 user user  6.2M ... zImage
5
-rw-r--r-- 1 user user   62K ... am335x-boneblack.dtb
6
-rw-r--r-- 1 user user  43M ...  rootfs.squashfs
7
-rw-r--r-- 1 user user 120M ...  rootfs.ext4
8
-rw-r--r-- 1 user user 401M ...  sdcard.img
9
-rw-r--r-- 1 user user  16M ...  boot.vfat

#Step 9: SD 카드에 굽기

SD 카드를 USB reader에 꽂고 어떤 장치인지 정확히 확인합니다.

1
$ lsblk
2
NAME        SIZE TYPE
3
sda         500G disk
4
├─sda1      500G part
5
sdb         8G   disk     ← 이것이 SD
6
├─sdb1      ...
7
$ sudo umount /dev/sdb*

잘못된 장치를 고르면 호스트 디스크가 날아갑니다. lsblk의 SIZE를 두 번 확인합니다.

1
$ sudo dd if=output/images/sdcard.img of=/dev/sdb bs=4M conv=fsync status=progress
2
401MB transferred in 38s
3
$ sync

bs=4M은 큰 블록으로 빨리 굽기 위함입니다. conv=fsync는 마지막에 디스크에 flush합니다.

빨리 굽고 싶다면 bmap-tools를 씁니다. genimage는 .bmap 파일을 함께 만들 수 있어 비어 있는 블록을 건너뜁니다. 큰 ext4 파티션에서 시간 절약이 큽니다.

1
$ sudo bmaptool copy --bmap output/images/sdcard.bmap \
2
                     output/images/sdcard.img /dev/sdb

#Step 10: 시리얼 콘솔 연결

BeagleBone Black의 J1 헤더가 시리얼 콘솔입니다. 6핀 헤더이고, USB-TTL 어댑터를 다음처럼 연결합니다.

1
J1 pin 1  (GND, 보드 바깥쪽)  ── 어댑터 GND
2
J1 pin 4  (RX,  보드 TX)      ── 어댑터 RX
3
J1 pin 5  (TX,  보드 RX)      ── 어댑터 TX

어댑터의 VCC 핀은 연결하지 마세요. BeagleBone은 자체 전원으로 동작합니다.

호스트에서 minicom 또는 picocom을 띄웁니다.

1
$ sudo picocom -b 115200 /dev/ttyUSB0

#Step 11: 첫 부팅

SD 카드를 BeagleBone Black에 꽂습니다. 그런데 그냥 끼우면 eMMC가 우선입니다. SD 부팅을 강제하려면 USER 버튼을 누른 채로 전원을 인가해야 합니다.

전원을 빼고 SD를 슬롯에 꽂습니다.
보드 위 USER 버튼(S2)을 누르고 유지합니다.
전원을 인가합니다. 5초 후 USER 버튼을 놓습니다.

시리얼에 다음과 같은 흐름이 나타납니다.

1
U-Boot SPL 2024.04 ...
2
Trying to boot from MMC1
3
U-Boot 2024.04 ...
4
DRAM:  512 MiB
5
MMC:   OMAP SD/MMC: 0
6
Loading Environment from FAT... OK
7
Importing environment from mmc 0 ...
8
=>
9
Hit any key to stop autoboot:  0
10
switch to partitions #0, OK
11
mmc0(part 0) is current device
12
SD/MMC found on device 0
13
reading /uEnv.txt
14
541 bytes read in 4 ms (132 KiB/s)
15
Loaded environment from /uEnv.txt
16
Importing environment from mmc0 ...
17
Running uenvcmd ...
18
6238208 bytes read in 421 ms (14.1 MiB/s)
19
62236 bytes read in 11 ms (5.4 MiB/s)
20
Kernel image @ 0x82000000 [ 0x000000 - 0x5f2400 ]
21
## Flattened Device Tree blob at 88000000
22
   Booting using the fdt blob at 0x88000000
23
Starting kernel ...
24
[    0.000000] Booting Linux on physical CPU 0x0
25
[    0.000000] Linux version 6.6.21 ...
26
...
27
[    3.421855] Run /sbin/init as init process
28
Starting syslogd: OK
29
Starting klogd: OK
30
...
31
Starting dropbear sshd: OK
32
Starting led-blink
33

34
ACME BeagleBone Black system
35
Built: 2026-05-19
36

37
acme-bbb login:

root로 로그인합니다 (defconfig에서 비밀번호를 안 설정했으면 빈 비밀번호).

1
acme-bbb login: root
2
# uname -a
3
Linux acme-bbb 6.6.21 #1 SMP PREEMPT ... armv7l GNU/Linux
4
# cat /etc/issue
5
ACME BeagleBone Black system
6
Built: 2026-05-19
7
# df -h
8
Filesystem                Size      Used Available Use% Mounted on
9
/dev/root                43.0M     43.0M         0 100% /
10
tmpfs                   244.6M         0    244.6M   0% /tmp
11
# mount | grep mmcblk
12
/dev/mmcblk0p2 on / type squashfs (ro,relatime)
13
# ls -la /sys/class/leds/
14
beaglebone:green:usr0
15
beaglebone:green:usr1
16
beaglebone:green:usr2
17
beaglebone:green:usr3

USER0 LED가 1초 간격으로 깜빡이고 있을 겁니다. acme-led-blink가 동작 중입니다.

#Troubleshooting

#시리얼에 아무것도 안 나온다

세 가지를 의심합니다.

USB-TTL의 TX/RX 교차. 보드 TX(pin 5)가 어댑터 RX에 가야 합니다.
GND 안 연결. 시그널 wire만 있고 GND가 없으면 신호가 떠다닙니다.
baud rate 다름. picocom에 -b 115200을 명시했는지.

#`Bad Magic Number` U-Boot 에러

uEnv.txt가 vfat에 들어가지 않았거나, genimage.cfg에 파일이 안 적힌 경우입니다. mtools로 boot.vfat을 열어 확인합니다.

1
$ mdir -i output/images/boot.vfat ::

#Kernel panic — `Cannot mount root`

uEnv.txt의 root= 경로가 틀린 경우입니다. SD의 두 번째 파티션이 mmcblk0p2인지, rootfstype이 squashfs인지 확인합니다. 또는 커널에 squashfs 모듈이 안 들어간 경우. CONFIG_SQUASHFS=y + CONFIG_SQUASHFS_ZSTD=y를 linux fragment에 추가합니다.

#USER 버튼 효과가 없다

BeagleBone Black의 SYSBOOT 설정은 USER 버튼이 high일 때 SD를 먼저 보게 됩니다. 어떤 rev의 보드는 button polarity가 다를 수 있습니다. 대안으로 eMMC를 지우는 방법이 있습니다. eMMC가 비어 있으면 ROM이 자동으로 SD를 fallback으로 시도합니다.

1
# (eMMC를 마운트한 상태에서)
2
sudo dd if=/dev/zero of=/dev/mmcblk1 bs=1M count=10

(eMMC 와이프는 되돌릴 수 없습니다. 신중히 하십시오.)

#squashfs는 떠 있는데 `acme-led-blink`가 없다

BR2_PACKAGE_ACME_LED_BLINK=y가 defconfig에 없거나, Config.in이 외부 트리 최상위 Config.in에서 source되지 않은 경우입니다. make printvars VARS=BR2_PACKAGE_ACME_LED_BLINK로 확인합니다.

#시리즈 마무리

여기까지 따라온 분이라면 이제 Buildroot를 도구로 다룰 수 있습니다. 회사·팀의 보드를 받아 한두 주 안에 부팅하는 rootfs를 만들고, 그 위에서 application 개발에 집중할 수 있는 상태입니다.

이 시리즈가 의도적으로 다루지 않은 것들이 있습니다.

A/B 슬롯 OTA 업데이트 — RAUC, Mender, swupdate 같은 framework. squashfs base 위에 자연스럽게 얹힙니다.
Secure boot 체인 — TI HS device, OP-TEE, dm-verity 같은 보안 부팅.
부트로더 자체 customize — U-Boot의 board-specific 코드, SPL 단계 수정.
커널 디바이스 트리 작성 — 새 보드의 DTS를 처음부터 적기.
BSP 전체 통합 — 부트로더 + 커널 + DTB + rootfs를 제품 라인 수준에서 묶기.

이 마지막 항목이 바로 다음 시리즈의 주제입니다.

#다음 시리즈 — Embedded BSP

Buildroot가 rootfs를 책임진다면, BSP는 모든 것의 통합을 책임집니다.

부트로더 포트, 커널 컨피그, 디바이스 트리, 전원 시퀀스, factory provisioning, OTA 흐름까지를 한 보드의 일관된 패키지로 묶는 작업이 BSP입니다. Buildroot는 BSP의 rootfs 컴포넌트에 해당합니다. 다음 시리즈에서는 이 위에 부트로더 작성, 커널 보드 포팅, 디바이스 트리 작성, production provisioning을 차례로 다룹니다.

#정리

BeagleBone Black은 defconfig·시리얼 콘솔·MMC 부팅이 모두 단순해 첫 실전 보드로 적합합니다.
beaglebone_defconfig를 베이스로 외부 트리에 acme_bbb_defconfig로 정착시키는 흐름이 표준입니다.
내 패키지 한 개(acme-led-blink)와 내 overlay 한 줄(/etc/hostname)을 추가하는 절차가 외부 트리의 가장 작은 살아 있는 사례입니다.
squashfs base + ext4 data partition 구성은 production의 사실상 표준입니다.
genimage가 SD 카드 layout을 선언적으로 만들어 줍니다.
dd 굽기 전 lsblk로 장치 식별을 반드시 두 번 확인합니다.
BeagleBone Black의 USER 버튼 + 전원이 SD 부팅 강제 트릭입니다.
부팅 메시지에서 Starting led-blink가 보이고 LED가 깜빡이면 전 시리즈의 모든 개념이 동시에 동작한 것입니다.

수고하셨습니다. 다음 시리즈는 Embedded BSP — 부트로더부터 OTA까지.

Buildroot 실전 — BeagleBone Black 시스템 처음부터 끝까지

#한 줄 요약

#무엇을 만들 것인가

#준비물

#Step 1: Buildroot 가져오기 + 외부 트리 준비

#Step 2: defconfig 베이스 — beaglebone_defconfig 복사

#Step 3: 우리 식으로 defconfig 수정

#Step 4: acme-led-blink 패키지 작성

#Step 5: rootfs-overlay 작성

#Step 6: post-build.sh, post-image.sh, genimage.cfg

#Step 7: uEnv.txt — U-Boot 환경

#Step 8: 빌드

#Step 9: SD 카드에 굽기

#Step 10: 시리얼 콘솔 연결

#Step 11: 첫 부팅

#Troubleshooting

#시리얼에 아무것도 안 나온다

#`Bad Magic Number` U-Boot 에러

#Kernel panic — `Cannot mount root`

#USER 버튼 효과가 없다

#squashfs는 떠 있는데 `acme-led-blink`가 없다

#시리즈 마무리

#다음 시리즈 — Embedded BSP

#정리

#관련 항목

Buildroot Practical · 10 of 20

관련 글

Buildroot → Yocto 마이그레이션 — 언제·어떻게 옮길까

Buildroot CI/CD 구축 — Container Build와 Cache 공유

Buildroot Security·CVE 추적 — pkg-stats와 Reproducible Builds

이 글을 참조하는 글 (7)

#한 줄 요약

#무엇을 만들 것인가

#준비물

#Step 1: Buildroot 가져오기 + 외부 트리 준비

#Step 2: defconfig 베이스 — beaglebone_defconfig 복사

#Step 3: 우리 식으로 defconfig 수정

#Step 4: acme-led-blink 패키지 작성

#Step 5: rootfs-overlay 작성

#Step 6: post-build.sh, post-image.sh, genimage.cfg

#Step 7: uEnv.txt — U-Boot 환경

#Step 8: 빌드

#Step 9: SD 카드에 굽기

#Step 10: 시리얼 콘솔 연결

#Step 11: 첫 부팅

#Troubleshooting

#시리얼에 아무것도 안 나온다

#Bad Magic Number U-Boot 에러

#Kernel panic — Cannot mount root

#USER 버튼 효과가 없다

#squashfs는 떠 있는데 acme-led-blink가 없다

#시리즈 마무리

#다음 시리즈 — Embedded BSP

#정리

#관련 항목

Buildroot Practical · 10 of 20

관련 글

Buildroot → Yocto 마이그레이션 — 언제·어떻게 옮길까

Buildroot CI/CD 구축 — Container Build와 Cache 공유

Buildroot Security·CVE 추적 — pkg-stats와 Reproducible Builds

이 글을 참조하는 글 (7)

#`Bad Magic Number` U-Boot 에러

#Kernel panic — `Cannot mount root`

#squashfs는 떠 있는데 `acme-led-blink`가 없다