LK / classic AOSP aboot · source analysis

현재 LK와 classic AOSP aboot의 범위

Android aboot가 존재하던 고정 AOSP LK snapshot의 app descriptor와 초기화 위치를 현재 upstream과 구분합니다.

Series
15 / 20
Baseline
AOSP 9d6e28f
Commit
9d6e28f24ba0
Source
app/aboot/aboot.c:1772-1860 (원문 해당 범위)

고정 classic aboot에서 부팅 모드는 어디서 갈리는가?

APP_START(aboot)는 고정 AOSP LK의 정적 app descriptor이며 .init = aboot_init만 설정한다. 이 페이지의 mode 선택과 fastboot 준비는 별도 aboot entry thread의 단계가 아니라 aboot_init() 안의 분기다.

대상은 commit 9d6e28f의 classic aboot다. 현대 Android A/B, AVB, vendor_boot, GKI의 정책이나 현재 upstream LK 전체에 이 순서를 일반화하지 않는다.

읽기 경계

보존한 발췌는 원문의 L1856에서 끝나며 왼쪽 줄 번호는 원문과 일치한다. eMMC/flash boot 호출, fastboot label, app descriptor는 같은 고정 원문의 L1845–1917을 함께 확인해야 한다.

정적 선언과 실행 중 상태의 경계

그림 1. aboot descriptor, init callback, mode 입력과 선택 결과
정적 선언init에서 읽는 상태분기 결과
01APP_START(aboot)
.init = aboot_init
02page size
03signed? device info
serial → keys · reboot
04eMMC / flash boot
또는 fastboot

정적 descriptor와 runtime 변수는 생성 시점이 다르다. device 정보는 target_use_signed_kernel()일 때 키 검사 전에 읽지만, recovery/fastboot를 고르는 조건은 키·trigger·reboot mode에 있다.

init callback 안의 공통 순서와 분기

그림 2. 정적 app 등록에서 boot 또는 fastboot까지
APP_START(aboot)
.init 지정
aboot_init()
page size → signed? device info
serial → keys · trigger · reboot
boot attempt 또는 fastboot label

첫 화살표는 descriptor가 실행 중 생성된다는 뜻이 아니다. .init callback에 진입하면 page size를 설정하고 signed-kernel일 때만 read_device_info()를 호출한 다음 serial을 설정한다. 키와 reboot mode가 fastboot를 고르면 boot image 경로를 건너뛴다. boot 함수가 반환하면 아래 fastboot: label로 떨어진다.

aboot_init의 단계별 조건과 소비자

표의 순서는 고정 app/aboot/aboot.c L1792–1917이다. 조건부 경로를 모두 실행되는 단일 직선 경로로 읽지 않는다.

#소스 단계조건·입력바뀌는 상태 또는 호출다음 경계
01APP_START(aboot)정적 descriptor.init = aboot_init; aboot .entry 없음app init callback
02aboot_init L1798–1808target_is_emmc_boot()eMMC는 2048, 그 밖에는 flash_page_size(); page_mask 설정조건부 device 정보 → serial
03device info L1810–1814target_use_signed_kernel()일 때만read_device_info(&device)serial·키 검사 전; mode 선택에는 직접 사용 안 함
04serial L1816–1818target serialsn_buf와 UDC serial 설정키·trigger·reboot mode
05키·trigger L1820–1836HOME/VOLUP, 그 밖에 BACK/VOLDOWN; 조건부 NO_KEYPAD_DRIVERrecovery flag 또는 즉시 goto fastbootfastboot면 boot 경로 생략
06reboot mode L1838–1843RECOVERY_MODE / FASTBOOT_MODErecovery flag 설정 또는 goto fastbootstorage 분기 또는 fastboot
07boot attempt L1845–1871target_is_emmc_boot()boot_linux_from_mmc() 또는 boot_linux_from_flash()반환하면 fastboot label
08fastboot: L1875–1912mode jump 또는 boot 함수 반환target/UDC 준비, 명령 등록, fastboot_init(), udc_start()USB fastboot

unlock/tamper flag는 signed-kernel 관련 처리에 등장하지만, 이 함수의 HOME/BACK/reboot mode 분기 조건에는 들어가지 않는다.

upstream LK와 고정 aboot의 범위·분기 읽기

두 그림은 계보의 범위와 aboot_init()의 실제 조건 분기를 구분한다. 이 고정 소스에 없는 현대 slot/AVB 단계를 실행 흐름으로 끼워 넣지 않는다.

그림 3. 현재 upstream LK와 고정 classic aboot의 범위

왼쪽은 일반 LK 계열, 오른쪽은 이 AOSP commit의 Android 부팅 정책이다.

Upstream LK

01작은 kernel core

02일반 app framework

03project/module build

04platform 독립 API

05Android 제품 정책은 이 비교의 범위 밖

Classic aboot

01Android boot image

02boot/recovery 선택

03fastboot protocol

04partition flashing

05signed-kernel 조건부 처리

그림 4. aboot_init의 공통 준비 뒤 갈라지는 두 경로

device info를 읽는 조건과 boot mode를 선택하는 조건은 다르다.

01정적 .init → aboot_init
02page size 설정
03signed? device info 선행
04serial → keys · trigger · reboot

fastboot 선택

ABACK/VOLDOWN (recovery 아닐 때)

B조건부 trigger 또는 FASTBOOT_MODE

Cboot 함수 생략 → fastboot label

boot 시도

AHOME/VOLUP·RECOVERY_MODE는 recovery flag

BeMMC면 MMC, 아니면 flash boot

Cboot 함수 반환 시 fastboot label

원본 코드

아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/aboot.c의 실제 L1768–1856에 해당한다. 기존 발췌의 코드 본문과 왼쪽 줄 번호는 공식 원문과 일치한다.

commit9d6e28f24ba01e563d0b3801c6c6c95d756db623anchor · L1792void aboot_init(const struct app_descriptor *app)
1768static void publish_getvar_partition_info(struct getvar_partition_info *info, uint8_t num_parts)
1769{
1770	uint8_t i;
1771
1772	for (i = 0; i < num_parts; i++) {
1773		get_partition_size(info[i].part_name, info[i].size_response);
1774
1775		if (strlcat(info[i].getvar_size, info[i].part_name, MAX_GET_VAR_NAME_SIZE) >= MAX_GET_VAR_NAME_SIZE)
1776		{
1777			dprintf(CRITICAL, "partition size name truncated\n");
1778			return;
1779		}
1780		if (strlcat(info[i].getvar_type, info[i].part_name, MAX_GET_VAR_NAME_SIZE) >= MAX_GET_VAR_NAME_SIZE)
1781		{
1782			dprintf(CRITICAL, "partition type name truncated\n");
1783			return;
1784		}
1785
1786		/* publish partition size & type info */
1787		fastboot_publish((const char *) info[i].getvar_size, (const char *) info[i].size_response);
1788		fastboot_publish((const char *) info[i].getvar_type, (const char *) info[i].type_response);
1789	}
1790}
1791
1792void aboot_init(const struct app_descriptor *app)
1793{
1794	unsigned reboot_mode = 0;
1795	unsigned usb_init = 0;
1796	unsigned sz = 0;
1797
1798	/* Setup page size information for nand/emmc reads */
1799	if (target_is_emmc_boot())
1800	{
1801		page_size = 2048;
1802		page_mask = page_size - 1;
1803	}
1804	else
1805	{
1806		page_size = flash_page_size();
1807		page_mask = page_size - 1;
1808	}
1809
1810	if(target_use_signed_kernel())
1811	{
1812		read_device_info(&device);
1813
1814	}
1815
1816	target_serialno((unsigned char *) sn_buf);
1817	dprintf(SPEW,"serial number: %s\n",sn_buf);
1818	surf_udc_device.serialno = sn_buf;
1819
1820	/* Check if we should do something other than booting up */
1821	if (keys_get_state(KEY_HOME) != 0)
1822		boot_into_recovery = 1;
1823	if (keys_get_state(KEY_VOLUMEUP) != 0)
1824		boot_into_recovery = 1;
1825	if(!boot_into_recovery)
1826	{
1827		if (keys_get_state(KEY_BACK) != 0)
1828			goto fastboot;
1829		if (keys_get_state(KEY_VOLUMEDOWN) != 0)
1830			goto fastboot;
1831	}
1832
1833	#if NO_KEYPAD_DRIVER
1834	if (fastboot_trigger())
1835		goto fastboot;
1836	#endif
1837
1838	reboot_mode = check_reboot_mode();
1839	if (reboot_mode == RECOVERY_MODE) {
1840		boot_into_recovery = 1;
1841	} else if(reboot_mode == FASTBOOT_MODE) {
1842		goto fastboot;
1843	}
1844
1845	if (target_is_emmc_boot())
1846	{
1847		if(emmc_recovery_init())
1848			dprintf(ALWAYS,"error in emmc_recovery_init\n");
1849		if(target_use_signed_kernel())
1850		{
1851			if((device.is_unlocked) || (device.is_tampered))
1852			{
1853			#ifdef TZ_TAMPER_FUSE
1854				set_tamper_fuse_cmd();
1855			#endif
1856			#if USE_PCOM_SECBOOT

발췌 범위와 읽기 기준

보존한 첫 코드 발췌는 고정 원문 L1768–1856에 해당하며 HTML의 왼쪽 줄 번호도 해당 원문 번호와 일치한다. void aboot_init(const struct app_descriptor *app)의 실제 시작은 L1792이다. 키 선택 뒤의 eMMC/flash 호출·fastboot label·APP_START(aboot)는 고정 원문 L1845–1917을 확인한다.

signed-kernel 조건부 read_device_info()는 키 검사 앞에 있으며, unlock flag는 이 함수의 mode 선택 조건이 아니다. 각 boot 함수 내부의 이미지 검증 동작은 별도 원문에 따라 읽어야 한다.

함께 읽어야 하는 원본 코드

이 발췌의 read_device_info()는 eMMC와 flash helper 중 하나를 호출한다. aboot_init()에서는 signed-kernel 조건이 참일 때만 이 함수를 키 검사 전에 부른다.

01. signed-kernel 경로에서 읽는 device 정보

app/aboot/aboot.c 실제 L1142–1222에 해당한다. 보존한 발췌의 왼쪽 번호는 원문과 일치한다.

fileapp/aboot/aboot.canchor · L1152void read_device_info(device_info *dev)
1142	if(target_is_emmc_boot())
1143	{
1144		write_device_info_mmc(dev);
1145	}
1146	else
1147	{
1148		write_device_info_flash(dev);
1149	}
1150}
1151
1152void read_device_info(device_info *dev)
1153{
1154	if(target_is_emmc_boot())
1155	{
1156		read_device_info_mmc(dev);
1157	}
1158	else
1159	{
1160		read_device_info_flash(dev);
1161	}
1162}
1163
1164void reset_device_info()
1165{
1166	dprintf(ALWAYS, "reset_device_info called.");
1167	device.is_tampered = 0;
1168	write_device_info(&device);
1169}
1170
1171void set_device_root()
1172{
1173	dprintf(ALWAYS, "set_device_root called.");
1174	device.is_tampered = 1;
1175	write_device_info(&device);
1176}
1177
1178#if DEVICE_TREE
1179int copy_dtb(uint8_t *boot_image_start)
1180{
1181	uint32 dt_image_offset = 0;
1182	uint32_t n;
1183	struct dt_table *table;
1184	struct dt_entry *dt_entry_ptr;
1185
1186	struct boot_img_hdr *hdr = (struct boot_img_hdr *) (boot_image_start);
1187
1188	if(hdr->dt_size != 0) {
1189
1190		/* add kernel offset */
1191		dt_image_offset += page_size;
1192		n = ROUND_TO_PAGE(hdr->kernel_size, page_mask);
1193		dt_image_offset += n;
1194
1195		/* add ramdisk offset */
1196		n = ROUND_TO_PAGE(hdr->ramdisk_size, page_mask);
1197		dt_image_offset += n;
1198
1199		/* add second offset */
1200		if(hdr->second_size != 0) {
1201			n = ROUND_TO_PAGE(hdr->second_size, page_mask);
1202			dt_image_offset += n;
1203		}
1204
1205		/* offset now point to start of dt.img */
1206		table = (struct dt_table*)(boot_image_start + dt_image_offset);
1207
1208		/* Restriction that the device tree entry table should be less than a page*/
1209		ASSERT(((table->num_entries * sizeof(struct dt_entry))+ DEV_TREE_HEADER_SIZE) < hdr->page_size);
1210
1211		/* Validate the device tree table header */
1212		if((table->magic != DEV_TREE_MAGIC) && (table->version != DEV_TREE_VERSION)) {
1213			dprintf(CRITICAL, "ERROR: Cannot validate Device Tree Table \n");
1214			return -1;
1215		}
1216
1217		/* Calculate the offset of device tree within device tree table */
1218		if((dt_entry_ptr = dev_tree_get_entry_ptr(table)) == NULL){
1219			dprintf(CRITICAL, "ERROR: Getting device tree address failed\n");
1220			return -1;
1221		}
1222

init callback의 판단 순서를 더 깊게 읽기

01

descriptor는 호출 단계가 아니다

파일 끝의 APP_START(aboot)는 .init = aboot_init을 지정한다. 이 descriptor에 aboot .entry 함수가 없으므로 그림의 mode 선택을 독립 aboot thread 실행으로 묘사하지 않는다.

02

storage 종류와 signed-kernel 조건을 먼저 읽는다

target_is_emmc_boot()가 page size와 뒤의 boot 함수 및 fastboot flash/erase 명령을 갈라놓는다. target_use_signed_kernel()이 참이면 read_device_info(&device)를 키 검사 전에 부른다. unlock flag가 normal/recovery/fastboot mode를 고르는 조건은 아니다.

03

키의 우선순위와 reboot mode를 분리한다

HOME 또는 VOLUP은 recovery flag를 설정한다. 그 flag가 거짓일 때에만 BACK/VOLDOWN이 즉시 fastboot로 간다. NO_KEYPAD_DRIVER의 trigger 검사 뒤 check_reboot_mode()가 RECOVERY_MODE 또는 FASTBOOT_MODE를 처리한다.

04

boot 시도와 fastboot label은 조건부다

fastboot jump가 없으면 eMMC는 emmc_recovery_init() 뒤 boot_linux_from_mmc(), 다른 storage는 recovery_init() 뒤 boot_linux_from_flash()를 부른다. boot 함수가 반환한 경우 오류 로그 뒤 같은 fastboot label로 흐른다.

05

fastboot 준비를 호출 순서대로 본다

label에서는 target_fastboot_init(), 조건부 udc_init(), 명령 등록과 getvar 공개, fastboot_init(), udc_start()가 이어진다. eMMC와 flash의 flash/erase callback이 서로 다르며, unlock은 이곳에서 등록되는 oem unlock 명령으로 따로 다룬다.

계보와 조건부 기능의 경계

01

classic aboot는 현재 upstream LK의 일반 boot policy가 아니다

이 AOSP snapshot의 app/aboot/aboot.c는 Android boot image, recovery, fastboot와 partition 동작을 담는다. 현재 upstream LK의 app framework를 이 제품 boot policy와 동일시하거나 현대 A/B slot, AVB 2.0, vendor_boot 단계를 이 함수에 추가하지 않는다.

02

boot header 처리는 호출된 함수 내부에 있다

aboot_init()은 mode와 storage 경로를 고른다. 이미지 header, address, DT 처리와 signature 결과는 선택된 boot_linux_from_mmc() 또는 boot_linux_from_flash()의 내부 조건을 별도로 확인해야 한다. 모든 mode가 이미지 적재·검증을 통과한다고 도식화하면 fastboot jump를 놓친다.

03

unlock 정보와 mode 입력을 혼동하지 않는다

device.is_unlocked/is_tampered는 signed-kernel·tamper 관련 조건에서 쓰인다. 이 함수의 mode 결정은 키, 조건부 trigger, reboot reason에 있다. 특정 vendor fork의 보안 정책이나 현대 verified boot 보장까지 이 고정 commit으로 단정하지 않는다.

선언·읽기·변경되는 상태

대상설정·읽기 시점이 함수에서의 역할근거
aboot app descriptor정적 APP_START(aboot).init = aboot_init; 동적 mode state 아님L1915–1917
page_size/page_maskaboot_init() 시작eMMC 또는 flash page 단위L1798–1808
devicesigned-kernel일 때 키 검사 전 읽기unlock/tamper 후속 조건; mode 입력 아님L1810–1814, L1849–1869
boot_into_recoveryHOME/VOLUP 또는 RECOVERY_MODEboot 함수가 사용할 recovery 선택L1820–1843
sn_buf / UDC serialmode 검사 전 target serial 읽기USB serial과 fastboot getvarL1816–1818, L1903–1905
fastboot 명령·getvarfastboot: label에서 등록eMMC/flash별 callback 뒤 protocol 시작L1875–1912

분기 해석이 어긋나는 지점

#조건실제 경로먼저 볼 소스
01recovery key와 fastboot key가 함께 눌림recovery flag가 먼저 서면 BACK/VOLDOWN 분기는 실행하지 않음L1820–1831
02signed-kernel 사용 안 함read_device_info()를 건너뛰고 키 검사로 진행L1810–1820
03FASTBOOT_MODE 또는 조건부 triggereMMC/flash boot 함수 호출 전 fastboot:로 이동L1833–1845, L1875
04boot 함수가 반환오류 로그 뒤 fastboot label로 fallthroughL1861–1875

emmc_recovery_init()의 반환값은 로그만 남기며 바로 fastboot로 전환하지 않는다. fastboot label에서도 fastboot_init()의 반환값을 검사하지 않고 udc_start()를 호출한다. 초기화 함수 호출 자체를 USB service의 준비 완료나 호스트 응답 확인으로 세지 않는다.

고정 source와 보드 로그에서 볼 증거

같은 commit의 source line과 대상 보드 로그를 짝지어 본다. 계측은 사용 중인 fork에 맞춰 최소한으로 넣고, mode 선택 자체를 변경하지 않는다.

#목적명령 또는 계측판정 기준
01정적 callback 확인rg -n 'APP_START\(aboot\)|\.init = aboot_init' app/aboot/aboot.cdescriptor에 .entry가 없는지 확인
02signed device 정보target_use_signed_kernel() 반환값과 read_device_info() 진입 기록키 검사 전에 조건부로 읽는지 확인
03mode 분기HOME/VOLUP, BACK/VOLDOWN, check_reboot_mode() 결과 기록fastboot jump가 boot 함수 전에 발생하는지 확인
04storage 경로target_is_emmc_boot()와 호출된 boot 함수 기록MMC 또는 flash 중 하나만 실행되는지 확인
05fastboot 준비fastboot getvar product (해당 mode 진입 후)명령·getvar 등록 및 udc_start() 뒤 응답 확인

소스 순서를 직접 확인할 읽기 실험

  1. 01
    descriptor와 mode 선택 위치 표시

    고정 aboot.c L1915–1917의 .init과 L1792의 함수 시작을 표시한다. descriptor를 runtime의 별도 boot stage로 세지 않는다.

  2. 02
    키·reboot reason의 우선순위 표 만들기

    L1820–1843에서 recovery flag, fastboot jump, 조건부 trigger를 순서대로 따라간다. HOME+BACK처럼 동시 입력일 때 !boot_into_recovery guard를 확인한다.

  3. 03
    두 storage 경로와 fallback 추적

    L1845–1912에서 eMMC/flash boot 호출을 나눠 표시하고, 어느 호출이 반환하면 오류 로그와 fastboot label에 도달하는지 확인한다. fastboot 직접 jump는 boot 함수를 거치지 않는다.

원문과 다음 글