Barebox · source analysis

ARM memory area와 MMU 초기화

PBL의 선행 매핑과 Barebox mmu_init의 RAM bank remap 순서를 ARM32·ARM64 경로와 함께 읽습니다.

Series
05 / 19
Baseline
v2026.06.1
Commit
314c679eea2d
Source
arch/arm/cpu/mmu-common.c:141-194 (발췌 범위)

ARM memory area와 MMU 초기화에서 실제로 바뀌는 상태는 무엇인가?

CONFIG_MMU인 일반 PBL 경로는 압축을 풀기 전 mmu_early_enable을 거치고 ELF load 뒤 pbl_mmu_setup_from_elf로 text·data·rodata 권한을 설정한다. mmu_init()은 이 선행 상태를 새로 만드는 단계가 아니다.

EFI payload는 mmu_init()에서 조기 반환한다. 그 밖의 경로는 memory bank를 확인하고 __mmu_init(get_cr() & CR_M) 다음에 reserved/image를 건너뛴 RAM 구간을 MAP_CACHED로 remap한다.

객체와 주소가 놓이는 구조

그림 1. ARM memory area와 MMU 초기화에서 입력, 내부 상태, 출력의 경계
입력과 전제내부 상태외부로 공개되는 결과
01RAM banks
02resource reservations
03translation tables
04DMA/MMIO attributes

RAM bank·reserved resource·translation table·DMA/MMIO attribute를 역할별로 놓은 그림이다. 네 블록을 모두 새로 생성하는 직렬 순서로 읽지 않는다.

PBL 선행 작업과 mmu initcall

그림 2. PBL의 초기·ELF 매핑과 이후 mmu_init()의 bank remap

PBL · CONFIG_MMU 경로

  1. mmu_early_enable(membase, memsize)로 초기 mapping·cache 준비.
  2. ELF 압축 해제·load 뒤 pbl_mmu_setup_from_elf로 segment별 권한 설정.
  3. ELF entry로 이동.

ARM32와 ARM64의 초기 table, register, OP-TEE 처리는 서로 다르다.

Barebox · mmu_initcall

  1. EFI payload면 반환; bank가 없으면 초기 메모리 bank 등록 시도.
  2. __mmu_init(get_cr() & CR_M) 호출.
  3. reserved/image를 제외한 bank 구간 remap 후 trap page 설정.

여기서 공통 함수를 ‘TTBR·MAIR·TCR → SCTLR enable’ 순서로 읽지 않는다.

PBL caller · CONFIG_MMU guard · 공통 initcall. ELF helper 호출 자체는 무조건이지만 MMU가 꺼진 빌드에서는 inline 0 반환이다. 대상 image의 caller도 확인한다.

선행 매핑과 공통 remap의 상태

행의 조건을 먼저 확인한다. EFI payload는 공통 remap을 건너뛰고, 이미 MMU가 켜진 arch early 함수도 초기 설정을 건너뛴다.

#경로·조건실제 처리남는 상태근거
P1PBL · CONFIG_MMUARM32/ARM64별 mmu_early_enable초기 identity mapping과 cache 사용; 세부 속성은 arch별PBL
P2PBL · ELF load 뒤pbl_mmu_setup_from_elf 호출CONFIG_MMU면 ELF segment 권한; 아니면 inline 0guard
M0EFI payloadmmu_init 조기 반환공통 bank remap 실행 안 함guard
M1일반 · bank 목록 비었음initmem bank 등록 시도; 실패 시 panicbank 목록이 준비됨fallback
M2일반 · bank 준비 뒤__mmu_init(get_cr() & CR_M)ARM32/64 구현에서 기존 TTB 영역 예약 시도call
M3일반 · 각 bankreserved/image를 건너뛰고 나머지 MAP_CACHED remap선택 구간의 mapping 갱신 후 trap pagesremap

__mmu_init(bool mmu_on)의 ARM32/ARM64 구현은 이 버전에서 TTB 영역을 예약한다. MMU enable은 PBL의 별도 arch 경로에 있다.

주소·권한과 실행 순서를 분리해 읽기

그림 3은 주소의 상하 배치를 뜻하지 않는 역할 지도다. 실제 주소는 보드의 bank·reserved resource·ELF segment를 대입한다.

그림 3. PBL이 먼저 정한 image 권한과 이후 bank remap 대상

한 연속 공간의 위·아래 순서가 아니다. 겹치는 범위의 attribute를 다시 덮어쓰지 않도록 구분한 집합이다.

PBL · IMAGEtext · data · rodata

CONFIG_MMU에서 ELF segment flag로 권한 설정. 공통 bank remap은 __image_start..__image_end를 건너뛴다.

INITCALL · BANK일반 RAM 구간

bank 안에서 reserved region과 image를 제외한 구간만 MAP_CACHED.

EXCLUSIONreserved region

for_each_reserved_region에서 건너뛴다. 여기서 일괄 cacheable remap하지 않는다.

SEPARATETTB · trap pages

TTB 영역 예약 시도는 bank remap 전, setup_trap_pages는 remap 후. 세부 trap 처리도 arch별이다.

그림 4. mmu_init() 내부 순서와 arch별 선행 경로

왼쪽 PBL 경로는 일반 CONFIG_MMU image의 선행 작업이다. 오른쪽은 mmu_initcall 함수 내부 순서다.

선행 · PBL / arch

  1. ARM32: TTBR·domain, flat/DRAM·OP-TEE mapping 후 __mmu_cache_on.
  2. ARM64: 현재 EL의 TTBR·TCR·MAIR, flat/DRAM·OP-TEE mapping 후 mmu_enable.
  3. ELF load 뒤 image segment 권한 설정.

OP-TEE 영역도 ARM32는 uncached, ARM64는 fault mapping으로 다르다.

후속 · 공통 mmu_init()

  1. EFI payload면 0; bank가 비면 initmem 등록.
  2. __mmu_init(get_cr() & CR_M): TTB 영역 예약 시도.
  3. 각 bank에서 reserved·image 제외 구간 cacheable remap.
  4. setup_trap_pages() 후 0.

공통 initcall에서 TTBR/MAIR/TCR/SCTLR을 일괄 설정하지 않는다.

원본 코드

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

commit314c679eea2d0ca847c64d1b646a1cf91225c0ecanchor · L165static int mmu_init(void)
141	 * those here.
142	 *
143	 * This code will become much less complex once we switch over to using
144	 * CONFIG_MEMORY_ATTRIBUTES for MMU as well.
145	 */
146	for_each_memory_bank(bank) {
147		struct resource *rsv;
148		resource_size_t pos;
149
150		pos = bank->res->start;
151
152		/* Skip reserved regions */
153		for_each_reserved_region(bank, rsv) {
154			if (pos != rsv->start)
155				remap_range_end_sans_image(pos, rsv->start, MAP_CACHED);
156			pos = rsv->end + 1;
157		}
158
159		remap_range_end_sans_image(pos, bank->res->end + 1, MAP_CACHED);
160	}
161
162	setup_trap_pages();
163}
164
165static int mmu_init(void)
166{
167	if (efi_is_payload())
168		return 0;
169
170	if (list_empty(&memory_banks)) {
171		resource_size_t start;
172		int ret;
173
174		/*
175		 * If you see this it means you have no memory registered.
176		 * This can be done either with arm_add_mem_device() in an
177		 * initcall prior to mmu_initcall or via devicetree in the
178		 * memory node.
179		 */
180		pr_emerg("No memory bank registered. Limping along with initial memory\n");
181
182		start = arm_mem_membase_get();
183		ret = barebox_add_memory_bank("initmem", start,
184					      arm_mem_endmem_get() - start);
185		if (ret)
186			panic("");
187	}
188
189	__mmu_init(get_cr() & CR_M);
190	mmu_remap_memory_banks();
191
192	return 0;
193}
194mmu_initcall(mmu_init);

발췌 범위와 읽기 기준

원문 141-194줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 static int mmu_init(void)은 L165에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.

이 발췌에서는 PBL이 이미 지정한 image 권한과 reserved memory를 건너뛰고 bank의 나머지를 MAP_CACHED로 remap한다. DMA/MMIO 매핑은 별도 호출 경로를 확인한다.

함께 읽어야 하는 원본 코드

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

01. RAM bank를 cacheable mapping으로 다시 만드는 코드

arch/arm/cpu/mmu-common.c 119-189줄이다.

filearch/arm/cpu/mmu-common.canchor · L129static void mmu_remap_memory_banks(void)
119		remap_range_end(start, image_start, MAP_CACHED);
120		/* skip barebox segments here, PBL has already mapped them */
121		start = image_end;
122	}
123
124	start = ALIGN(start, PAGE_SIZE);
125
126	remap_range_end(start, end, MAP_CACHED);
127}
128
129static void mmu_remap_memory_banks(void)
130{
131	struct memory_bank *bank;
132
133	/*
134	 * Early mmu init will have mapped everything but the initial memory area
135	 * (excluding final OPTEE_SIZE bytes) uncached. We have now discovered
136	 * all memory banks, so let's map all pages, excluding reserved memory areas
137	 * and barebox text area cacheable.
138	 *
139	 * PBL has already set up the MMU with proper permissions for text, data
140	 * and rodata based on ELF segment information, so we don't need to remap
141	 * those here.
142	 *
143	 * This code will become much less complex once we switch over to using
144	 * CONFIG_MEMORY_ATTRIBUTES for MMU as well.
145	 */
146	for_each_memory_bank(bank) {
147		struct resource *rsv;
148		resource_size_t pos;
149
150		pos = bank->res->start;
151
152		/* Skip reserved regions */
153		for_each_reserved_region(bank, rsv) {
154			if (pos != rsv->start)
155				remap_range_end_sans_image(pos, rsv->start, MAP_CACHED);
156			pos = rsv->end + 1;
157		}
158
159		remap_range_end_sans_image(pos, bank->res->end + 1, MAP_CACHED);
160	}
161
162	setup_trap_pages();
163}
164
165static int mmu_init(void)
166{
167	if (efi_is_payload())
168		return 0;
169
170	if (list_empty(&memory_banks)) {
171		resource_size_t start;
172		int ret;
173
174		/*
175		 * If you see this it means you have no memory registered.
176		 * This can be done either with arm_add_mem_device() in an
177		 * initcall prior to mmu_initcall or via devicetree in the
178		 * memory node.
179		 */
180		pr_emerg("No memory bank registered. Limping along with initial memory\n");
181
182		start = arm_mem_membase_get();
183		ret = barebox_add_memory_bank("initmem", start,
184					      arm_mem_endmem_get() - start);
185		if (ret)
186			panic("");
187	}
188
189	__mmu_init(get_cr() & CR_M);

소스가 보장하는 경계

01

PBL 선행 매핑을 확인한다

barebox_pbl_start는 CONFIG_MMU일 때 압축 해제 전에 mmu_early_enable을 부른다. ELF load 뒤 pbl_mmu_setup_from_elf 호출은 무조건이지만 MMU 미설정 빌드에서는 inline 0 반환이다.

보드·설정별 다른 진입 경로가 있으므로 대상 image의 caller도 확인한다.

02

EFI와 비어 있는 bank 목록을 나눈다

efi_is_payload()면 공통 mmu_init은 작업 없이 0을 반환한다. 일반 경로에서 bank 목록이 비면 arm_mem_membase_get()부터 initmem을 등록하고 실패 시 panic한다.

03

TTB 예약과 remap의 순서를 지킨다

bank가 준비되면 먼저 __mmu_init(get_cr() & CR_M)을 호출한다. ARM32/ARM64 구현은 기존 TTB 주소의 resource를 예약 시도하며, 이 함수에서 공통 레지스터 enable 시퀀스를 실행하지 않는다.

그 다음 mmu_remap_memory_banks가 bank별 구간을 순회한다.

04

reserved와 image를 건너뛴다

각 bank의 for_each_reserved_region 전후 범위만 MAP_CACHED로 remap한다. remap_range_end_sans_image는 image와 겹치면 PBL이 설정한 segment를 건너뛴다.

끝 경계는 rsv->end + 1, bank->res->end + 1의 exclusive end로 넘긴다.

05

arch별 trap page와 관찰점을 구분한다

bank remap 뒤 setup_trap_pages가 실행된다. ARM32는 vector 주소 조건과 stack guard 설정을, ARM64는 zero page fault와 선택적 stack guard를 처리한다.

이 initcall 반환을 새로운 MMU enable 시점으로 해석하지 않는다.

ARM32와 ARM64의 서로 다른 구현

01

초기 enable은 PBL의 arch 코드다

ARM32 mmu_early_enable은 CR_M이 켜져 있으면 반환하고, 그렇지 않으면 TTBR·domain, flat mapping, DRAM·OP-TEE mapping 뒤 __mmu_cache_on을 호출한다.

ARM64는 현재 EL의 TTBR·TCR·MAIR을 설정하고 OP-TEE 범위를 fault mapping한 뒤 mmu_enable을 호출한다. ARM32 · ARM64.

02

공통 함수는 기존 TTB를 예약한다

__mmu_init(bool mmu_on)의 이 버전 ARM32/ARM64 본문은 get_ttb 주소의 ARM_EARLY_PAGETABLE_SIZE를 request_barebox_region으로 예약 시도한다. 실패하면 critical log를 남긴다.

전달된 get_cr() & CR_M은 호출 시점 상태를 보여 주지만, 두 구현에서 이 인자를 이용한 enable 분기는 없다.

03

bank remap은 기존 image 권한을 보존한다

reserved region을 제외한 RAM은 cacheable로 바꾸되 __image_start..__image_end를 건너뛴다. 이는 PBL이 ELF flag로 정한 text·data·rodata 권한을 덮지 않기 위해서다.

ARM32/ARM64의 arch_remap_range는 각자 table entry와 TLB를 갱신한다. 공통 구간.

bank·reservation·mapping의 역할

대상준비/갱신 시점이 코드의 처리근거
memory_banksmmu_initcall 전 등록 또는 initmem fallback비어 있으면 초기 bank 등록 시도bank guard
bank->res / reserved resourcebank 순회 시 참조reserved 구간을 건너뛰고 양옆 범위만 remaprange walk
barebox image segmentCONFIG_MMU PBL의 ELF load 뒤 권한 설정공통 bank remap에서 image overlap 제외image skip
TTB resource__mmu_init에서 기존 table 주소 예약 시도실패 시 critical log; 공통 단계에서 새 table 생성 단정 금지ARM64 / ARM32
zero / guard pagesbank remap 뒤 setup_trap_pagesarch·CONFIG_STACK_GUARD_PAGE 조건 반영call site

조기 반환과 오류 관찰점

#조건소스의 결과먼저 확인할 곳
01EFI payloadmmu_init 즉시 0, bank remap 없음efi_is_payload()
02bank 목록 비고 initmem 등록 실패panic("")초기 membase/endmem·bank resource
03TTB resource 예약 실패ARM32/64 pr_crit; 이후 remap 경로 계속TTB 주소와 기존 resource 겹침
04reserved/image 경계 오판잘못된 구간의 attribute 가능bank·reserved·image 시작/끝과 table entry
05선행 MMU 상태가 예상과 다름arch early path의 CR_M guard·mapping 확인 필요PBL caller, ARM32/ARM64 선택

초기 MMU enable 문제는 PBL arch 경로에서, runtime RAM remap 문제는 mmu_remap_memory_banks에서 추적한다. __mmu_init 예약 실패 로그만으로 MMU enable 단계가 실패했다고 단정하지 않는다.

빌드와 보드에서 확인할 증거

대상 보드와 설정의 실제 PBL caller를 먼저 고른다. 아래 계측은 해당 경로에만 적용한다.

#목적명령 또는 계측판정 기준
01구성 분기make <board>_defconfig && make V=1CONFIG_MMU, ARM32/ARM64, EFI payload 여부와 PBL image를 기록한다.
02symbolnm -n barebox | grep -E 'mmu_init|mmu_remap_memory_banks'image에 포함된 MMU init 경로를 확인한다. static symbol 유무는 빌드 최적화에 좌우될 수 있다.
03RAM resourceiomembank, reserved region, TTB, image 주소 범위를 대조한다.
04arch registerGDB/JTAG: CR_M·TTBR; ARM64는 TCR·MAIRPBL early enable 전후와 initcall 진입 시 값을 분리해 기록한다.
05mappingpage-table dump / remap traceimage segment 권한 보존, reserved skip, 일반 bank MAP_CACHED를 확인한다.

직접 확인할 실험

  1. 01
    PBL과 initcall의 시간축 분리

    대상 보드에서 mmu_early_enable, pbl_mmu_setup_from_elf, mmu_init의 호출 여부와 순서를 기록한다. EFI payload와 CONFIG_MMU 분기를 표시한다.

  2. 02
    bank·reserved·image 경계 대조

    iomem과 linker symbol의 시작/끝을 표로 만들고, remap_range_end_sans_image가 어느 구간에 MAP_CACHED를 요청하는지 trace와 비교한다.

  3. 03
    ARM32/ARM64 초기 매핑 비교

    선택한 arch의 PBL early path에서 TTBR와 control register를 확인한다. ARM64만 TCR·MAIR을, ARM32는 domain과 cache-on 호출을 함께 점검한다.

원문과 다음 글