본문으로 건너뛰기
Modern Embedded Recipes · 88/152

루트 파일시스템 구축 — Buildroot 기초·Package·Toolchain

· Hawk · 5분 읽기
recipes linux buildroot rootfs

#한 줄 요약

“Buildroot = make 한 번으로 cross toolchain + kernel + rootfs를 통째로 생성하는 빌드 시스템입니다.” 단순한 device에 가장 빠르게 적용할 수 있습니다.

#어떤 상황에서 쓰나

100 MB 이내의 small footprint device, BLE gateway, IIoT sensor, kiosk처럼 수십 개 package면 충분한 시스템에 Buildroot가 가장 잘 맞습니다. 단일 binary로 모든 것을 정의하고 reproducible build가 가능하며, 6시간 안에 cross toolchain부터 SD image까지 만들어줍니다.

반대로 수백 package + multi-recipe + 다중 image type + 회사 전역 layer 공유가 필요한 환경에서는 Yocto가 더 적합합니다. 둘은 경쟁이 아니라 크기 기반의 선택입니다.

#핵심 개념

Buildroot 구조
buildroot/
  configs/<board>_defconfig    board별 기본 config
  board/<vendor>/<board>/      board-specific files
  package/                      ~3000개 package recipe
  output/                       build 결과
    images/                     rootfs.tar, sdcard.img, kernel
    target/                     install된 rootfs (실 파일)
    host/                       cross toolchain

기본 build cycle입니다.

  1. make <board>_defconfig
  2. make menuconfig (필요 시)
  3. make -jN
  4. dd if=output/images/sdcard.img of=/dev/sdX

한 줄로 정리하면 Buildroot 한 디렉터리가 BSP의 single source입니다.

Buildroot vs Yocto:

항목BuildrootYocto
크기~수십 MB~수 GB
빌드 시간 (첫 빌드)1~3시간6~12시간
학습 곡선완만가파름
package 수~3000~10000
multi-image, layer제한적강력
적합 규모small footprintenterprise BSP

#코드 / 실제 사용 예

#시작하기

Terminal window
git clone --depth 1 git://git.buildroot.net/buildroot
cd buildroot


# 사용 가능한 defconfig 보기
ls configs/


# 예시 — Raspberry Pi 4 64-bit
make raspberrypi4_64_defconfig
make menuconfig          # 옵션 조정
make -j$(nproc)


# 결과
ls output/images/
# bcm2711-rpi-4-b.dtb  Image  rootfs.tar  sdcard.img

make 한 번에 toolchain download → cross compile → rootfs 조립 → SD image 생성까지 끝납니다.

make menuconfig


Target packages →
  Networking applications → [*] dropbear (SSH)
  System tools           → [*] htop
  Hardware handling      → [*] i2c-tools
  Text editors          → [*] vim

각 package에는 dependency가 자동 해결됩니다. 변경 후 make 다시 실행하면 추가 package만 빌드합니다.

#Custom defconfig 추출

Terminal window
make savedefconfig
# 결과: defconfig (변경 사항만 적힌 minimal config)


cp defconfig configs/myboard_defconfig

board별 defconfig을 commit하면 다른 사람이 make myboard_defconfig로 같은 config을 재현할 수 있습니다.

#Toolchain 선택

make menuconfig의 Toolchain 메뉴에서 두 가지를 고릅니다. 먼저 toolchain 자체를 어디서 가져올지 정합니다.

Toolchain type설명
Buildroot toolchainsource부터 빌드해 재현성이 가장 높습니다 (기본 선택)
External toolchainARM, Linaro 등 prebuilt를 가져다 씁니다

그다음 C library를 고릅니다.

C library설명
glibc일반 distro와 호환
musl작고 깨끗
uclibc-ng최소

External toolchain은 빌드 시간을 크게 줄이지만 reproducibility가 낮아집니다. 양산은 Buildroot toolchain이 표준입니다.

#Board-specific overlay

board/vendor/myboard/
├── overlay/              # rootfs에 그대로 복사할 파일
│   ├── etc/init.d/S99myapp
│   └── etc/network/interfaces
├── post-build.sh         # build 직전 hook
├── post-image.sh         # image 생성 직전 hook
└── genimage.cfg          # SD image partition layout
post-build.sh
#!/bin/sh
TARGET_DIR=$1
echo "myboard v1.0" > $TARGET_DIR/etc/board_info
chmod 755 $TARGET_DIR/etc/init.d/S99myapp

config에 다음을 추가합니다.

BR2_ROOTFS_OVERLAY="board/vendor/myboard/overlay"
BR2_ROOTFS_POST_BUILD_SCRIPT="board/vendor/myboard/post-build.sh"

#Custom package 만들기

package/myapp/
  Config.in
  myapp.mk
Config.in
config BR2_PACKAGE_MYAPP
    bool "myapp"
    help
      My custom application.
myapp.mk
MYAPP_VERSION = 1.0
MYAPP_SITE = $(call github,myorg,myapp,v$(MYAPP_VERSION))
MYAPP_LICENSE = MIT
MYAPP_DEPENDENCIES = libcurl


define MYAPP_BUILD_CMDS
    $(MAKE) CC="$(TARGET_CC)" -C $(@D)
endef


define MYAPP_INSTALL_TARGET_CMDS
    $(INSTALL) -m 0755 $(@D)/myapp $(TARGET_DIR)/usr/bin/
endef


$(eval $(generic-package))

Config.in을 package/Config.in에 source로 추가하면 menuconfig에 노출됩니다.

#Init 시스템 선택

make menuconfig의 System configuration → Init system에서 다섯 가지 중 하나를 고릅니다.

Init system특성
BusyBox기본 선택입니다. 작고 빠릅니다
systemV전통적인 방식입니다
systemd풀스택이라 RAM 비용이 큽니다
OpenRCgentoo 스타일입니다
Nonecustom init을 직접 넣습니다

작은 device는 BusyBox init이 가장 단순합니다. systemd는 ~30 MB 이상의 RAM을 추가로 씁니다.

#Reproducible build

BR2_REPRODUCIBLE=y
BR2_DL_DIR=$(HOME)/buildroot-dl     # source tarball cache
BR2_CCACHE=y

같은 source + 같은 toolchain으로 bit-identical 결과가 나오게 만들 수 있습니다. 양산기 인증과 supply chain 점검에 필수입니다.

#측정 / 성능 비교

지표BuildrootYocto (poky)
첫 빌드 (16 코어)~90분~6시간
재빌드 (1 package 추가)~5분~15분
disk 사용량~5 GB~50 GB
rootfs 최소 크기~2 MB (busybox)~50 MB (core-image-minimal)
package 수~3000~10000

부팅 시간 (i.MX8M Mini + rootfs.ext4):

Init시간
busybox + dropbear1.8 s
systemd minimal6.2 s

부팅 시간을 우선시한다면 BusyBox init이 결정적으로 유리합니다.

#자주 보는 함정

빌드 도중 download 실패

make: *** failed to download tar

회사 방화벽이나 sourceforge mirror 변경이 흔한 원인입니다. BR2_DL_DIR을 별도 서버에 두고 미리 받아두는 패턴이 양산에서 표준입니다.

Toolchain 변경 후 부분 rebuild

make foo-rebuild       # 잘못된 결과

Toolchain 변경 시 반드시 make clean을 합니다. Buildroot는 toolchain 변경 추적이 약합니다.

Host system 의존성

You must install m4 ...

make prepare나 support/dependencies/dependencies.sh로 host 요구사항을 확인합니다. CI는 Docker container로 통일하는 것이 안전합니다.

Overlay 권한 누락

rootfs에 파일은 올라가 있는데 실행이 되지 않는 증상이 나옵니다. overlay/의 파일은 git에서 mode가 보존되지 않습니다. post-build.sh에서 chmod로 명시합니다.

rootfs.tar 크기 초과

ext4 image creation failed: not enough space

BR2_TARGET_ROOTFS_EXT2_SIZE를 늘리거나 불필요한 package를 끕니다.

#정리

  • Buildroot는 small footprint Linux의 단일 source build tool입니다.
  • make <board>_defconfig와 make -jN 두 줄로 SD image까지 완성됩니다.
  • Custom defconfig을 commit해 board별 BSP를 공유합니다.
  • Overlay와 post-build hook으로 board-specific 파일을 끼웁니다.
  • Custom package는 Config.in과 mk 파일 두 개로 정의합니다.
  • BusyBox init이 작고 빠르고, systemd는 30 MB 이상의 RAM을 더 씁니다.
  • Yocto는 enterprise 규모 BSP, Buildroot는 작은 device에 맞습니다.

다음 편부터 Part 8 동적 메모리로 넘어갑니다.

#관련 항목

Modern Embedded Recipes · 89 of 152

  1. 1 Modern Embedded Recipes — 모던 임베디드 실전 레시피 시리즈 소개
  2. 2 디지털 신호 기초 — Voltage Level·Edge·Setup/Hold 분석
  3. 3 임베디드 클럭과 타이밍 — Skew·Jitter·PLL·MMCM 분석
  4. 4 GPIO 내부 구조 분해 — Push-Pull·Open-Drain·Schmitt Trigger
  5. 5 UART 하드웨어 동작 분석 — Baud Rate·Framing·FIFO
  6. 6 SPI 하드웨어 분석 — Clock Mode·MOSI/MISO·Chip Select
  7. 7 I2C 하드웨어 분석 — Open-Drain·Clock Stretching·Arbitration
  8. 8 ADC 동작 원리 — SAR·Sigma-Delta·Pipelined 비교
  9. 9 DAC 동작 원리 — R-2R Ladder·Sigma-Delta·Settling Time
  10. 10 PWM 신호 생성 분석 — Duty·Frequency·Dead Time·Center-Aligned
  11. 11 CAN 버스 전기적 특성 — Differential·Termination·Dominant/Recessive
  12. 12 RS-485·RS-422 차동 신호 분석 — Termination·Biasing·Topology
  13. 13 LVDS 차동 신호 분석 — Common-Mode·Impedance·Eye Pattern
  14. 14 ARM Cortex-M 시리즈 비교 — M0·M3·M4·M7·M33·M55 분석
  15. 15 ARM Cortex-A 시리즈 비교 — A53·A55·A72·A78·X1 분석
  16. 16 ARM 레지스터 구조 분석 — R0~R15·CPSR·SPSR·Banked Registers
  17. 17 Cortex-M 예외 처리 — Vector Table·NVIC·Tail-Chaining 추적
  18. 18 ARM 메모리 맵 분석 — Normal·Device·Strongly-Ordered Region
  19. 19 ARM L1·L2 캐시 분석 — Set Associative·Inclusive·Maintenance
  20. 20 ARM MPU 활용 — Region·Attribute·Privilege Separation
  21. 21 ARM MMU 기초 분석 — Translation Table·TLB·ASID
  22. 22 ARM TrustZone-M 기초 — Secure/Non-Secure·NSC·MPC
  23. 23 ARM Memory Barrier 실전 — DMB·DSB·ISB·DMA·MMIO
  24. 24 임베디드 크로스 컴파일러 분석 — GCC·Clang·Sysroot 구성
  25. 25 C 컴파일 4단계 — Preprocess·Compile·Assemble·Link 추적
  26. 26 ELF 파일 구조 분석 — Section·Segment·Symbol Table·DWARF
  27. 27 링커 스크립트 기초 — SECTIONS·MEMORY·entry point
  28. 28 링커 스크립트 고급 — Overlay·BSS·init_array·LMA/VMA
  29. 29 임베디드 스타트업 코드 분석 — Reset_Handler·Vector Table·SystemInit
  30. 30 C 런타임 crt0 분석 — Stack·BSS Zero·Data Copy·atexit
  31. 31 임베디드 메모리 레이아웃 — .text·.rodata·.data·.bss·.heap·.stack
  32. 32 임베디드 컴파일러 최적화 분석 — -O0~-O3·-Os·-LTO 비교
  33. 33 Map 파일 분석 — Symbol·Section·Size 추적으로 코드 크기 진단
  34. 34 Make·CMake 크로스 컴파일 — Toolchain File·Sysroot 통합
  35. 35 임베디드 Bootloader 체인 — BootROM·SPL·U-Boot·Kernel·Secure Boot
  36. 36 첫 bare-metal 프로그램 작성 — Linker·Startup·main의 최소 구성
  37. 37 MMIO 레지스터 직접 접근 — volatile·Memory Map·Aliasing 분석
  38. 38 GPIO 드라이버 직접 구현 — STM32 HAL 없이 레지스터로
  39. 39 임베디드 클럭 설정 분석 — HSE·PLL·SYSCLK·AHB/APB 분주
  40. 40 Cortex-M 인터럽트 핸들링 — NVIC·Priority·Vector·EXTI
  41. 41 SysTick 타이머 활용 — 24-bit Counter·1ms Tick·delay 구현
  42. 42 UART 드라이버 구현 — polling·interrupt·DMA 3가지 방식 비교
  43. 43 SPI 드라이버 구현 — Master·Slave·CRC·DMA
  44. 44 I2C 드라이버 구현 — Master·7-bit/10-bit·Clock Stretching 처리
  45. 45 임베디드 DMA 기초 — Memory-to-Memory·Peripheral·Circular Mode
  46. 46 저전력 모드 분석 — Sleep·Stop·Standby·Wake-up Source
  47. 47 IWDG·WWDG 워치독 구현 — Independent vs Window 비교
  48. 48 임베디드 Flash 프로그래밍 — Erase·Program·Read While Write
  49. 49 DDR 초기화 실패 진단 — Timing·Calibration·Walking Bit Test
  50. 50 PWM 출력 실전 — LED 밝기·모터 속도 제어
  51. 51 DC 모터 제어 — H-Bridge·PWM Duty·Encoder Feedback
  52. 52 스테퍼 모터 제어 — Full Step·Half Step·Microstepping
  53. 53 서보 모터 제어 — PWM 1ms~2ms·Closed Loop·PID
  54. 54 Character LCD 제어 — HD44780·4-bit Mode·Custom Char
  55. 55 SPI OLED 제어 — SSD1306·Frame Buffer·Page 단위 갱신
  56. 56 TFT 디스플레이 구동 — RGB565·FSMC·LTDC·DMA2D
  57. 57 환경 센서 활용 — BME280 온습압·SHT3x·BMP180 비교
  58. 58 IMU 센서 활용 — MPU6050·LSM6DSO·Sensor Fusion
  59. 59 CAN 통신 구현 — bxCAN·Filter·Mailbox·CAN-FD
  60. 60 USB Device 기초 — Descriptor·Enumeration·Endpoint·HID/CDC
  61. 61 Ethernet MAC+PHY 통합 — RMII·lwIP·DMA Descriptor
  62. 62 SD Card + FatFs 구현 — SPI/SDIO 모드·CSD/CID·Wear
  63. 63 RTC 활용 — Calendar·Alarm·Wake-up Timer·Backup Domain
  64. 64 RTOS 도입 결정 분석 — Super Loop vs RTOS 트레이드오프
  65. 65 RTOS Task 설계 패턴 — 우선순위·스택·State Machine
  66. 66 RTOS Scheduler 동작 분석 — Tick·Context Switch·Yield
  67. 67 RTOS Semaphore 활용 — Binary·Counting·ISR Give
  68. 68 RTOS Mutex 활용 — Recursive·Priority Inheritance 적용
  69. 69 RTOS Queue 활용 — By-Value·By-Reference·Timeout 패턴
  70. 70 RTOS Event Group 활용 — Bit Wait·Sync·Notify
  71. 71 RTOS Software Timer 활용 — One-shot·Auto-reload·Daemon Task
  72. 72 ISR-Safe API 설계 — Reentrant·Atomic·Defer 패턴
  73. 73 Priority Inversion 진단·예방 — Mars Pathfinder Lesson 추적
  74. 74 Timer Wheel 분석 — Hashed·Hierarchical·O(1) Tick
  75. 75 RTOS 디버깅 기법 — Tracealyzer·SystemView·Stack 추적
  76. 76 임베디드 Linux 부팅 흐름 분석 — BootROM·U-Boot·Kernel·init
  77. 77 U-Boot 활용 — bootcmd·env·tftp·boot.scr 분석
  78. 78 Device Tree 실전 — DTS·DTB·Overlay·Phandle 추적
  79. 79 Device Tree Overlay 적용 — Runtime fragment·dtoverlay
  80. 80 임베디드 커널 빌드 — defconfig·menuconfig·Image·zImage
  81. 81 커널 모듈 기초 — init/exit·Parameter·KBuild·DKMS
  82. 82 캐릭터 드라이버 작성 — file_operations·cdev·register_chrdev
  83. 83 Platform 드라이버 작성 — probe·remove·of_match·DT 바인딩
  84. 84 mmap 4가지 모드 — Anonymous·File·Shared·Huge Page
  85. 85 epoll 실전 — LT·ET·ONESHOT·EXCLUSIVE 비교
  86. 86 UIO·VFIO 분석 — User-Space Driver와 IOMMU 격리
  87. 87 sysfs·configfs 활용 — kobject 기반 User 인터페이스
  88. 88 IRQ Affinity 튜닝 — smp_affinity·isolcpus·irqbalance
  89. 89 루트 파일시스템 구축 — Buildroot 기초·Package·Toolchain
  90. 90 임베디드 동적 메모리 — malloc 위험·결정성·대안 분석
  91. 91 메모리 정렬과 패딩 분석 — Natural·Strict Alignment·Trap
  92. 92 Cache Line Alignment — alignas·Padding·SoA 적용
  93. 93 DMA-Friendly Allocator — dma_alloc_coherent·IOMMU·Pool
  94. 94 Zero-Copy Pipeline — DMA-BUF·sendfile·io_uring·splice
  95. 95 NUMA Memory Topology — numactl·numa_alloc·HBM 적용
  96. 96 SIMD 활용 분석 — Intrinsics·Auto-Vectorization·OpenMP SIMD
  97. 97 ARM NEON 심화 — Matrix Multiply·FFT·Image Filter 적용
  98. 98 임베디드 스택 분석 — high-water·overflow 탐지
  99. 99 임베디드 코드 크기 최적화 — -Os·LTO·Section Garbage Collection
  100. 100 임베디드 전력 최적화 — Sleep Mode·Clock Gating·DVFS
  101. 101 WCET 분석 기법 — Static·Measurement·Hybrid 방법론
  102. 102 Lock-Free Ring Buffer 구현 — SPSC·Power-of-2·Memory Order
  103. 103 Wait-Free Signaling — Atomic Flag·Sequence·Latest-Value
  104. 104 RCU (Read-Copy-Update) 기초 — Quiescent State·Grace Period
  105. 105 Hazard Pointer 분석 — Lock-Free Memory Reclamation
  106. 106 Compare-And-Swap 패턴 — Stack·Counter·Linked List 적용
  107. 107 Atomic Operation 비용 분석 — Fence·Cache Line·Contention
  108. 108 Spinlock vs Mutex 결정 가이드 — Context Switch·Hold Time
  109. 109 ABA 문제 회피 — Tagged Pointer·Hazard·Generation Counter
  110. 110 False Sharing 해결 — Cache Line Padding·SoA 적용
  111. 111 MPMC Queue 구현 — Multi-producer Multi-consumer Lock-Free
  112. 112 임베디드 디버깅 마인드셋 — 가설·격리·재현·이분탐색
  113. 113 JTAG·SWD 안 붙을 때 — 핀·전압·속도·세션 진단
  114. 114 GDB 원격 디버깅 — OpenOCD·J-Link·target remote 구성
  115. 115 Cortex-M 하드폴트 분석 — Stacked Frame·CFSR 읽기
  116. 116 UART 안 찍힐 때 — Bare-metal 체크리스트
  117. 117 임베디드 부팅 실패 진단 — 단계별 Isolation
  118. 118 인터럽트 누락·중복 진단 — Priority·Pending·Re-entry 추적
  119. 119 메모리 오버플로우·오염 진단 — Canary·MPU·Pattern 분석
  120. 120 타이밍·Race 진단 — Heisenbug 잡는 법
  121. 121 통신 프로토콜 분석 — Logic Analyzer와 Protocol Decoder
  122. 122 임베디드 로깅 시스템 설계 — 레벨·버퍼·SWO·Deferred
  123. 123 임베디드 포스트모템 분석 — Core Dump와 Field Crash
  124. 124 FPGA 기초 분석 — LUT·FF·BRAM·DSP 자원 구조
  125. 125 Vivado 사용법 — Project·Constraint·Synth·Impl·Bitstream
  126. 126 PCIe BAR 매핑 분석 — Config Space·Enumeration·MMIO 접근
  127. 127 AXI 인터페이스 — AXI4·AXI4-Lite·AXI-Stream 비교
  128. 128 Zynq PS-PL 통신 — GP·HP·ACP 인터페이스 선택
  129. 129 Mailbox Protocol 분석 — Host와 Accelerator를 잇는 Doorbell
  130. 130 Command Queue·Submission Queue — NVMe·XDMA 공통 패턴
  131. 131 DMA Completion 메커니즘 — Interrupt·Polling·Completion Ring
  132. 132 PCIe Streaming 분석 — BAR Type·MSI-X·Kernel Bypass
  133. 133 Vitis HLS 분석 — Pragma·Pipeline II·Dataflow 실전 감각
  134. 134 HLS 최적화 기법 — Pipeline·Unroll·Partition·Dataflow
  135. 135 Vitis AI 분석 — DPU·xmodel·VART
  136. 136 OpenCL on FPGA — Kernel·Channel·Burst Memory 분석
  137. 137 Intel Quartus 사용법 — Platform Designer·Nios II·HLS
  138. 138 Edge Inference 분석 — Cloud vs Edge·Latency·Privacy
  139. 139 NPU 아키텍처 분석 — Ethos·Hexagon·Systolic Array 비교
  140. 140 딥러닝 Quantization 분석 — PTQ·QAT·INT8·INT4·Calibration
  141. 141 TensorRT 분석 — ONNX→Engine·FP16·INT8·DLA·Multi-Stream
  142. 142 TFLite Micro 분석 — Op Resolver·Tensor Arena·Cortex-M
  143. 143 ONNX Runtime 분석 — Execution Provider와 Cross-Platform 배포
  144. 144 Edge Thermal Management — Throttling·DVFS·Fan Curve·Sustained
  145. 145 NVIDIA Jetson 분석 — Nano·Xavier·Orin·Thor·JetPack·DLA·VPI
  146. 146 Zero-Copy Camera Pipeline — V4L2·DMA-BUF·GPU Import·NPU 직결
  147. 147 온디바이스 LLM 추론 — llama.cpp·GGUF·MLX·KV Cache·NPU Backend
  148. 148 Cortex-M33 TF-M·TrustZone — Secure Firmware·PSA·MCUboot
  149. 149 Matter·Thread 분석 — IoT 통합 표준·Commissioning·Multi-Fabric
  150. 150 PCIe → CXL 진화 — 같은 PHY 위 cache-coherent 프로토콜 추가
  151. 151 QEMU CXL Type 3 디바이스 에뮬레이션 — 노트북에서 CXL 개발 환경 구축
  152. 152 Linux CXL 드라이버 분석 — cxl_pci·cxl_core·region·DAX

관련 글

Linux CXL 드라이버 분석 — cxl_pci·cxl_core·region·DAX

CXL 디바이스가 메모리로 안 올라올 때 모듈 체인·sysfs·mailbox 중 어디서 끊겼는지 좁혀 가는 절차.

· recipes

같은 시리즈에서 이어 읽기

Platform 드라이버 작성 — probe·remove·of_match·DT 바인딩

platform_driver_register, of_match_table, probe/remove, devm_* 자원 관리, IRQ와 MMIO 획득까지 platform driver의 표준 패턴을 정리합니다.

· recipes

같은 시리즈에서 이어 읽기

캐릭터 드라이버 작성 — file_operations·cdev·register_chrdev

file_operations, cdev, minor 번호, copy_to/from_user, blocking I/O, misc device 단축 경로까지 character driver의 표준 패턴을 정리합니다.

· recipes

같은 시리즈에서 이어 읽기

이 글을 참조하는 글 (3)