QUESTION
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 책임을 잘못 배분하게 된다.
STRUCTURE
진입 wrapper와 PBL 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 항목에 추가된다.
CALL PATH
PBL에서 main Barebox까지의 실제 호출 경계
마지막 화살표는 PBL에서 start_barebox()를 직접 호출한다는 뜻이 아니다. ELF entry인 barebox_non_pbl_start()가 먼저 실행된다.
STATE LEDGER
어느 단계가 어떤 전제를 만들까?
| 단계 | 읽는 값 | 다음 단계에 확정되는 상태 |
|---|---|---|
| 보드별 진입 | 보드가 확보한 실행 가능한 RAM 범위와 boarddata | membase·memsize·pointer를 wrapper에 전달 |
| wrapper / entry_ll | endmem = membase + memsize | arm_mem_stack_top(endmem)으로 SP 전환, 초기 MMU/cache 무효화 |
| PBL relocation | PC, RAM 범위, piggydata runtime 주소 | RAM 내부 실행이면 현재 주소에 재배치, 외부면 membase로 복사·재배치 |
| payload 준비 | 압축 데이터 길이와 끝의 비압축 크기 | handoff 크기를 고려한 barebox_base, PBL malloc, 압축 해제 |
| ELF handoff | 압축 해제한 ELF·handoff | ELF 제자리 적재·권한 설정·handoff 이동·cache 동기화 후 ELF entry 호출 |
| main stage | membase·memsize·handoff pointer | malloc 영역과 handoff 등록 후 start_barebox() |
VISUAL WALKTHROUGH
주소 배치와 payload 변환을 따로 읽기
이 그림은 arch/arm/include/asm/barebox-arm.h helper의 상대 순서다. source PBL·piggydata의 ROM/SRAM/DRAM 실제 위치는 보드별이며 이 도식에 고정하지 않는다. entry.c 주석의 16KiB page table 설명보다 고정 태그의 256KiB helper를 우선한다.
runtime_address(input_data[_end])를 PBL relocation 전에 계산한다.pbl_barebox_uncompress() 뒤 elf_open_binary_into()와 elf_load_inplace()를 수행한다.sync_caches_for_execution() 뒤 elf.entry를 호출한다. linker ENTRY는 non-PBL 시작 함수다.압축 해제의 실패는 일반적인 C 오류 반환으로 이어지지 않는다. hash mismatch나 압축 오류, ELF 처리 오류는 panic/hang 경로를 확인해야 한다.
UPSTREAM SOURCE
원본 코드
아래 코드는 Barebox v2026.06.1의 arch/arm/cpu/entry.c에서 15-47줄을 그대로 가져온 것이다.
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);
READING CONTRACT
첫 발췌에서 보이지 않는 실행 단계
원본 발췌 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 링커 진입점과 혼동하지 않는다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.
01. PBL 전용 C entry에서 압축 image를 넘겨받는 경계
arch/arm/cpu/entry.c 36-47줄이다.
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);
DETAILS
경계마다 source가 실제 수행하는 일
SP와 캐시 경계
wrapper가 계산한 stack top을 ARM32 r3 또는 ARM64 x3으로 넘긴다. 어셈블리는 SP를 바꾸고 다른 세 인자를 보존한 채 arm_early_mmu_cache_invalidate()를 호출한 다음 PBL 시작점으로 분기한다.
PBL 자신과 piggydata
PBL은 input_data 경계를 runtime_address()로 먼저 얻는다. 현재 PC가 전달된 RAM 범위 안이면 현재 주소에, 밖이면 membase에 PBL을 재배치한다. 이 선택은 payload 출력 주소 계산과 다르다.
payload 길이와 메모리
piggydata 마지막 4바이트에서 uncompressed_len을 읽고, handoff data 크기와 MAX_BSS_SIZE를 더한 image base를 계산한다. ARM32/64의 PBL malloc 위치가 다르며 MMU/MPU 설정은 config 분기다.
ELF entry와 main 초기화
압축 해제한 ELF를 제자리 적재하고 ELF segment 권한으로 PBL MMU를 설정한다. handoff_data_move(), cache 동기화 후 elf.entry를 호출한다. main 시작점은 malloc·handoff 설정 뒤 start_barebox()로 넘어간다.
IMPLEMENTATION NOTES
그림을 보드에 적용할 때 달라지는 것
RAM 범위는 보드 계약
entry.c는 전체 SDRAM일 필요가 없는 사용 가능 영역을 받는다고 명시한다. Boot ROM, SRAM, DDR 초기화의 구체 순서는 보드별 entry 코드를 확인해야 한다.
boarddata는 무조건 FDT가 아님
PBL의 handoff_data_add_dt()는 FDT와 압축 FDT를 식별한 경우에만 항목을 만든다. boarddata pointer를 모든 보드에서 동일한 DTB 수명으로 설명하면 과장이다.
PBL malloc과 main malloc 구별
PBL은 pbl_malloc_init() 뒤 자체 작은 allocator를 쓸 수 있다. 일반 main-stage malloc은 barebox_non_pbl_start()의 mem_malloc_init() 뒤에 준비된다.
OBJECT LIFETIME
코드·데이터·handoff의 사용 시점
| 대상 | 생성 / 사용 | 넘어가는 경계 |
|---|---|---|
| stack | arm_mem_stack_top() 계산 후 assembly가 SP 설정 | PBL 및 main 초기화 동안 예약된 상단 영역 사용 |
| PBL text와 piggydata | PBL이 runtime 주소를 잡고 필요하면 자체 relocation | compressed payload는 압축 해제의 source로 소비 |
| main ELF | barebox_base에 해제, elf_load_inplace()로 segment 재배치 | elf.entry 호출로 main 코드에 제어권 전달 |
| handoff data | 인식된 FDT 등을 추가하고 크기를 image 배치에 반영 | handoff_data_move() 후 pointer를 main entry에 전달 |
| malloc | PBL에서 pbl_malloc_init(), main에서 mem_malloc_init() | 둘은 서로 다른 시점·주소 범위의 allocator |
FAILURE PATH
정상 반환 대신 중단하는 지점
| 조건 | source 경계 | 관찰·해석 |
|---|---|---|
| 전달 RAM 범위가 실제 가용 영역과 불일치 | 보드 entry → arm_mem_* | stack·출력·handoff 배치가 겹칠 수 있음; 이 함수의 자동 범위 검사로 가정하지 않음 |
| piggydata hash mismatch | pbl_barebox_uncompress | CONFIG_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_start | PBL 압축 단계와 구분해 malloc·handoff·start_barebox 전후를 추적 |
보드에서 main 코드에 못 들어갔다면 마지막으로 관찰한 PC가 PBL relocation, 압축 해제, ELF load, cache sync, ELF entry 중 어디인지 먼저 고정한다.
EVIDENCE
고정 소스와 보드 로그의 대조 지점
| 목적 | 증거 | 판정 |
|---|---|---|
| ELF entry | readelf -h barebox 및 linker ENTRY | entry가 barebox_non_pbl_start에 해당하는지 확인 |
| 메모리 배치 | DEBUG 빌드의 print_pbl_mem_layout() 출력 | endmem, stack, TTB, image base, PBL malloc 범위 대조 |
| PBL 경로 | DEBUG_LL 출력 또는 early PC trace | SP 설정→cache 처리→PBL→ELF entry의 마지막 도달점 확인 |
| payload·handoff | piggydata 길이, uncompressed_len, handoff 크기 기록 | ELF 출력과 handoff 영역이 보드의 가용 RAM에 드는지 확인 |
LAB
동일 보드에서 경계를 재현
- 01entry 인자와 stack top 대조
보드 entry의 membase/memsize와 assembly 진입 후 SP를 기록해 arm_mem_stack_top 계산과 비교한다.
- 02PBL payload 추적
pg_start/pg_end, uncompressed_len, barebox_base, ELF entry를 차례대로 기록해 source·output의 위치를 확인한다.
- 03main 진입 확인
sync_caches_for_execution() 다음 PC와 barebox_non_pbl_start() 첫 PC, mem_malloc_init() 뒤 start_barebox()를 구분해 관찰한다.
PRIMARY REFERENCES