Barebox · source analysis

ARM PBL과 barebox_arm_entry

ARM 진입점의 stack 전환부터 PBL의 압축 ELF 적재와 main Barebox로의 handoff를 살펴봅니다.

Series
02 / 19
Baseline
v2026.06.1
Commit
314c679eea2d
Source
arch/arm/cpu/entry.c:15-47 (발췌 범위)

barebox_arm_entry는 어디까지 하고, PBL은 무엇을 넘기는가?

보드별 진입 코드가 membase·memsize·boarddata를 넘긴다. barebox_arm_entry()는 새 stack top을 계산해 저수준 어셈블리에 전달한다. ARM32·ARM64 경로는 SP 설정과 초기 MMU/cache 무효화 뒤 barebox_pbl_start()로 분기한다.

PBL은 압축된 payload를 풀어 ELF를 제자리 적재·재배치하고 handoff data를 옮긴 뒤 ELF entry를 호출한다. linker script의 ELF entry는 barebox_non_pbl_start()이며, 그 함수가 malloc과 handoff를 설정한 뒤 start_barebox()에 진입한다. 두 경계를 하나의 직접 화살표로 줄여 읽으면 stack·메모리·cache 책임을 잘못 배분하게 된다.

진입 wrapper와 PBL payload 처리는 서로 다른 단계

그림 1. SP 전환과 payload 변환의 책임 분리

ENTRY: C wrapper → 어셈블리

  • arm_mem_stack_top(membase + memsize)를 네 번째 인자로 전달
  • ARM32: r3, ARM64: x3를 SP로 설정
  • 인자 보존 후 초기 MMU/cache 무효화, PBL로 분기

PBL: payload → ELF entry

  • piggydata 범위를 relocation 전에 잡고 PBL 자신을 재배치
  • 출력 주소·PBL malloc을 정해 압축 해제와 ELF 제자리 적재
  • handoff 이동·실행 cache 동기화 후 ELF entry 호출

barebox_pbl_entry는 barebox_arm_entry의 alias다. boarddata는 일단 pointer일 뿐이며, PBL의 handoff_data_add_dt()가 인식하는 FDT/압축 FDT일 때 handoff 항목에 추가된다.

PBL에서 main Barebox까지의 실제 호출 경계

그림 2. 고정 소스의 진입·압축 해제·handoff 순서
01 ENTRYbarebox_arm_entry()stack top 계산 → __barebox_arm_entry
02 LOW LEVELentry_ll_32/64.SSP 설정 → 초기 MMU/cache 무효화 → PBL branch
03 PBLbarebox_pbl_start()PBL relocation, 압축 해제, ELF 제자리 적재·MMU 권한
04 MAINELF entry → start_barebox()handoff data와 cache 동기화 후 non-PBL 초기화

마지막 화살표는 PBL에서 start_barebox()를 직접 호출한다는 뜻이 아니다. ELF entry인 barebox_non_pbl_start()가 먼저 실행된다.

어느 단계가 어떤 전제를 만들까?

단계읽는 값다음 단계에 확정되는 상태
보드별 진입보드가 확보한 실행 가능한 RAM 범위와 boarddatamembase·memsize·pointer를 wrapper에 전달
wrapper / entry_llendmem = membase + memsizearm_mem_stack_top(endmem)으로 SP 전환, 초기 MMU/cache 무효화
PBL relocationPC, RAM 범위, piggydata runtime 주소RAM 내부 실행이면 현재 주소에 재배치, 외부면 membase로 복사·재배치
payload 준비압축 데이터 길이와 끝의 비압축 크기handoff 크기를 고려한 barebox_base, PBL malloc, 압축 해제
ELF handoff압축 해제한 ELF·handoffELF 제자리 적재·권한 설정·handoff 이동·cache 동기화 후 ELF entry 호출
main stagemembase·memsize·handoff pointermalloc 영역과 handoff 등록 후 start_barebox()

주소 배치와 payload 변환을 따로 읽기

그림 3. endmem 아래의 helper 기준 예약 영역
높은 주소: endmemmembase + memsize; 보드가 전달한 사용 가능 RAM 끝
선택적 OP-TEE 영역 → scratcharm_mem_optee()와 arm_mem_scratch()가 상단에서 차감
early stack → 선택적 guard pagearm_mem_stack_top()은 stack 위쪽을 SP로 전달
early page table → 선택적 ramoopsarm_mem_ttb()는 ARM_EARLY_PAGETABLE_SIZE=256KiB를 정렬해 예약
barebox image / handoff / PBL malloc비압축 길이·MAX_BSS_SIZE·handoff 크기로 image base 결정; malloc 위치는 ARM32/64별로 다름

이 그림은 arch/arm/include/asm/barebox-arm.h helper의 상대 순서다. source PBL·piggydata의 ROM/SRAM/DRAM 실제 위치는 보드별이며 이 도식에 고정하지 않는다. entry.c 주석의 16KiB page table 설명보다 고정 태그의 256KiB helper를 우선한다.

그림 4. 압축 파일이 실행 가능한 ELF가 되는 경계
SOURCEpiggydata 범위를 먼저 고정runtime_address(input_data[_end])를 PBL relocation 전에 계산한다.
OUTPUT압축 해제 → ELF loadpbl_barebox_uncompress() 뒤 elf_open_binary_into()와 elf_load_inplace()를 수행한다.
HANDOFFboarddata와 메타데이터 이동인식된 DT를 handoff에 추가하고, ELF entry 호출 전에 연속 영역으로 옮긴다.
EXECUTEcache 동기화 → ELF entrysync_caches_for_execution() 뒤 elf.entry를 호출한다. linker ENTRY는 non-PBL 시작 함수다.

압축 해제의 실패는 일반적인 C 오류 반환으로 이어지지 않는다. hash mismatch나 압축 오류, ELF 처리 오류는 panic/hang 경로를 확인해야 한다.

원본 코드

아래 코드는 Barebox v2026.06.1의 arch/arm/cpu/entry.c에서 15-47줄을 그대로 가져온 것이다.

commit314c679eea2d0ca847c64d1b646a1cf91225c0ecanchor · L39void NAKED __noreturn barebox_arm_entry
15 * region. boarddata will be preserved and can be accessed later with
16 * barebox_arm_boarddata().
17 *
18 * -> membase + memsize
19 *   STACK_SIZE              - stack
20 *   16KiB, aligned to 16KiB - First level page table if early MMU support
21 *                             is enabled
22 *   128KiB                  - early memory space
23 * -> maximum end of barebox binary
24 *
25 * Usually a TEXT_BASE of 1MiB below your lowest possible end of memory should
26 * be fine.
27 */
28
29/*
30 * It can be hard to convince GCC to not use old stack pointer after
31 * we modify it with arm_setup_stack() on ARM64, so we implement the
32 * low level details in assembly
33 */
34void __noreturn __barebox_arm_entry(unsigned long membase,
35				    unsigned long memsize,
36				    void *boarddata,
37				    unsigned long sp);
38
39void NAKED __noreturn barebox_arm_entry(unsigned long membase,
40					unsigned long memsize, void *boarddata)
41{
42	__barebox_arm_entry(membase, memsize, boarddata,
43			    arm_mem_stack_top(membase + memsize));
44}
45
46void __noreturn barebox_pbl_entry(ulong, ulong, void *)
47	__alias(barebox_arm_entry);

첫 발췌에서 보이지 않는 실행 단계

원본 발췌 L15–47은 메모리 설명과 barebox_arm_entry() wrapper·PBL alias만 담는다. 여기서 압축 해제, main image 적재 또는 start_barebox() 직접 호출을 읽어낼 수 없다.

실제 SP·초기 cache 처리는 entry_ll_32.S와 entry_ll_64.S, payload 처리는 uncompress.c, 예약 주소는 barebox-arm.h, main stage는 start.c를 함께 확인한다.

main ELF의 진입점은 ARM32와 ARM64의 arch/arm/lib32/barebox.lds.S 및 arch/arm/lib64/barebox.lds.S에서 모두 ENTRY(barebox_non_pbl_start)로 지정된다. PBL 링커 진입점과 혼동하지 않는다.

함께 읽어야 하는 원본 코드

첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.

01. PBL 전용 C entry에서 압축 image를 넘겨받는 경계

arch/arm/cpu/entry.c 36-47줄이다.

filearch/arm/cpu/entry.canchor · L46void __noreturn barebox_pbl_entry
36				    void *boarddata,
37				    unsigned long sp);
38
39void NAKED __noreturn barebox_arm_entry(unsigned long membase,
40					unsigned long memsize, void *boarddata)
41{
42	__barebox_arm_entry(membase, memsize, boarddata,
43			    arm_mem_stack_top(membase + memsize));
44}
45
46void __noreturn barebox_pbl_entry(ulong, ulong, void *)
47	__alias(barebox_arm_entry);

경계마다 source가 실제 수행하는 일

01

SP와 캐시 경계

wrapper가 계산한 stack top을 ARM32 r3 또는 ARM64 x3으로 넘긴다. 어셈블리는 SP를 바꾸고 다른 세 인자를 보존한 채 arm_early_mmu_cache_invalidate()를 호출한 다음 PBL 시작점으로 분기한다.

02

PBL 자신과 piggydata

PBL은 input_data 경계를 runtime_address()로 먼저 얻는다. 현재 PC가 전달된 RAM 범위 안이면 현재 주소에, 밖이면 membase에 PBL을 재배치한다. 이 선택은 payload 출력 주소 계산과 다르다.

03

payload 길이와 메모리

piggydata 마지막 4바이트에서 uncompressed_len을 읽고, handoff data 크기와 MAX_BSS_SIZE를 더한 image base를 계산한다. ARM32/64의 PBL malloc 위치가 다르며 MMU/MPU 설정은 config 분기다.

04

ELF entry와 main 초기화

압축 해제한 ELF를 제자리 적재하고 ELF segment 권한으로 PBL MMU를 설정한다. handoff_data_move(), cache 동기화 후 elf.entry를 호출한다. main 시작점은 malloc·handoff 설정 뒤 start_barebox()로 넘어간다.

그림을 보드에 적용할 때 달라지는 것

01

RAM 범위는 보드 계약

entry.c는 전체 SDRAM일 필요가 없는 사용 가능 영역을 받는다고 명시한다. Boot ROM, SRAM, DDR 초기화의 구체 순서는 보드별 entry 코드를 확인해야 한다.

02

boarddata는 무조건 FDT가 아님

PBL의 handoff_data_add_dt()는 FDT와 압축 FDT를 식별한 경우에만 항목을 만든다. boarddata pointer를 모든 보드에서 동일한 DTB 수명으로 설명하면 과장이다.

03

PBL malloc과 main malloc 구별

PBL은 pbl_malloc_init() 뒤 자체 작은 allocator를 쓸 수 있다. 일반 main-stage malloc은 barebox_non_pbl_start()의 mem_malloc_init() 뒤에 준비된다.

코드·데이터·handoff의 사용 시점

대상생성 / 사용넘어가는 경계
stackarm_mem_stack_top() 계산 후 assembly가 SP 설정PBL 및 main 초기화 동안 예약된 상단 영역 사용
PBL text와 piggydataPBL이 runtime 주소를 잡고 필요하면 자체 relocationcompressed payload는 압축 해제의 source로 소비
main ELFbarebox_base에 해제, elf_load_inplace()로 segment 재배치elf.entry 호출로 main 코드에 제어권 전달
handoff data인식된 FDT 등을 추가하고 크기를 image 배치에 반영handoff_data_move() 후 pointer를 main entry에 전달
mallocPBL에서 pbl_malloc_init(), main에서 mem_malloc_init()둘은 서로 다른 시점·주소 범위의 allocator

정상 반환 대신 중단하는 지점

조건source 경계관찰·해석
전달 RAM 범위가 실제 가용 영역과 불일치보드 entry → arm_mem_*stack·출력·handoff 배치가 겹칠 수 있음; 이 함수의 자동 범위 검사로 가정하지 않음
piggydata hash mismatchpbl_barebox_uncompressCONFIG_PBL_VERIFY_PIGGY 경로에서 panic; ELF load 전 종료
압축 decoder 오류pbl/decomp.c errorfn오류 출력 후 __hang(); 일반 호출자 복귀 아님
ELF open/load 또는 권한 설정 오류barebox_pbl_start각 ret 검사 후 panic; elf.entry 호출 전 종료
ELF entry 뒤 main 설정 실패barebox_non_pbl_startPBL 압축 단계와 구분해 malloc·handoff·start_barebox 전후를 추적

보드에서 main 코드에 못 들어갔다면 마지막으로 관찰한 PC가 PBL relocation, 압축 해제, ELF load, cache sync, ELF entry 중 어디인지 먼저 고정한다.

고정 소스와 보드 로그의 대조 지점

목적증거판정
ELF entryreadelf -h barebox 및 linker ENTRYentry가 barebox_non_pbl_start에 해당하는지 확인
메모리 배치DEBUG 빌드의 print_pbl_mem_layout() 출력endmem, stack, TTB, image base, PBL malloc 범위 대조
PBL 경로DEBUG_LL 출력 또는 early PC traceSP 설정→cache 처리→PBL→ELF entry의 마지막 도달점 확인
payload·handoffpiggydata 길이, uncompressed_len, handoff 크기 기록ELF 출력과 handoff 영역이 보드의 가용 RAM에 드는지 확인

동일 보드에서 경계를 재현

  1. 01
    entry 인자와 stack top 대조

    보드 entry의 membase/memsize와 assembly 진입 후 SP를 기록해 arm_mem_stack_top 계산과 비교한다.

  2. 02
    PBL payload 추적

    pg_start/pg_end, uncompressed_len, barebox_base, ELF entry를 차례대로 기록해 source·output의 위치를 확인한다.

  3. 03
    main 진입 확인

    sync_caches_for_execution() 다음 PC와 barebox_non_pbl_start() 첫 PC, mem_malloc_init() 뒤 start_barebox()를 구분해 관찰한다.

원문과 다음 글