QUESTION
고정 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을 함께 확인해야 한다.
STRUCTURE
정적 선언과 실행 중 상태의 경계
.init = aboot_init
serial → keys · reboot
또는 fastboot
정적 descriptor와 runtime 변수는 생성 시점이 다르다. device 정보는 target_use_signed_kernel()일 때 키 검사 전에 읽지만, recovery/fastboot를 고르는 조건은 키·trigger·reboot mode에 있다.
CALL PATH
init callback 안의 공통 순서와 분기
.init 지정
첫 화살표는 descriptor가 실행 중 생성된다는 뜻이 아니다. .init callback에 진입하면 page size를 설정하고 signed-kernel일 때만 read_device_info()를 호출한 다음 serial을 설정한다. 키와 reboot mode가 fastboot를 고르면 boot image 경로를 건너뛴다. boot 함수가 반환하면 아래 fastboot: label로 떨어진다.
STATE LEDGER
aboot_init의 단계별 조건과 소비자
표의 순서는 고정 app/aboot/aboot.c L1792–1917이다. 조건부 경로를 모두 실행되는 단일 직선 경로로 읽지 않는다.
| # | 소스 단계 | 조건·입력 | 바뀌는 상태 또는 호출 | 다음 경계 |
|---|---|---|---|---|
| 01 | APP_START(aboot) | 정적 descriptor | .init = aboot_init; aboot .entry 없음 | app init callback |
| 02 | aboot_init L1798–1808 | target_is_emmc_boot() | eMMC는 2048, 그 밖에는 flash_page_size(); page_mask 설정 | 조건부 device 정보 → serial |
| 03 | device info L1810–1814 | target_use_signed_kernel()일 때만 | read_device_info(&device) | serial·키 검사 전; mode 선택에는 직접 사용 안 함 |
| 04 | serial L1816–1818 | target serial | sn_buf와 UDC serial 설정 | 키·trigger·reboot mode |
| 05 | 키·trigger L1820–1836 | HOME/VOLUP, 그 밖에 BACK/VOLDOWN; 조건부 NO_KEYPAD_DRIVER | recovery flag 또는 즉시 goto fastboot | fastboot면 boot 경로 생략 |
| 06 | reboot mode L1838–1843 | RECOVERY_MODE / FASTBOOT_MODE | recovery flag 설정 또는 goto fastboot | storage 분기 또는 fastboot |
| 07 | boot attempt L1845–1871 | target_is_emmc_boot() | boot_linux_from_mmc() 또는 boot_linux_from_flash() | 반환하면 fastboot label |
| 08 | fastboot: L1875–1912 | mode jump 또는 boot 함수 반환 | target/UDC 준비, 명령 등록, fastboot_init(), udc_start() | USB fastboot |
unlock/tamper flag는 signed-kernel 관련 처리에 등장하지만, 이 함수의 HOME/BACK/reboot mode 분기 조건에는 들어가지 않는다.
VISUAL WALKTHROUGH
upstream LK와 고정 aboot의 범위·분기 읽기
두 그림은 계보의 범위와 aboot_init()의 실제 조건 분기를 구분한다. 이 고정 소스에 없는 현대 slot/AVB 단계를 실행 흐름으로 끼워 넣지 않는다.
왼쪽은 일반 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 조건부 처리
device info를 읽는 조건과 boot mode를 선택하는 조건은 다르다.
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
UPSTREAM SOURCE
원본 코드
아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/aboot.c의 실제 L1768–1856에 해당한다. 기존 발췌의 코드 본문과 왼쪽 줄 번호는 공식 원문과 일치한다.
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
READING CONTRACT
발췌 범위와 읽기 기준
보존한 첫 코드 발췌는 고정 원문 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 함수 내부의 이미지 검증 동작은 별도 원문에 따라 읽어야 한다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
이 발췌의 read_device_info()는 eMMC와 flash helper 중 하나를 호출한다. aboot_init()에서는 signed-kernel 조건이 참일 때만 이 함수를 키 검사 전에 부른다.
01. signed-kernel 경로에서 읽는 device 정보
app/aboot/aboot.c 실제 L1142–1222에 해당한다. 보존한 발췌의 왼쪽 번호는 원문과 일치한다.
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
DETAILS
init callback의 판단 순서를 더 깊게 읽기
descriptor는 호출 단계가 아니다
파일 끝의 APP_START(aboot)는 .init = aboot_init을 지정한다. 이 descriptor에 aboot .entry 함수가 없으므로 그림의 mode 선택을 독립 aboot thread 실행으로 묘사하지 않는다.
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를 고르는 조건은 아니다.
키의 우선순위와 reboot mode를 분리한다
HOME 또는 VOLUP은 recovery flag를 설정한다. 그 flag가 거짓일 때에만 BACK/VOLDOWN이 즉시 fastboot로 간다. NO_KEYPAD_DRIVER의 trigger 검사 뒤 check_reboot_mode()가 RECOVERY_MODE 또는 FASTBOOT_MODE를 처리한다.
boot 시도와 fastboot label은 조건부다
fastboot jump가 없으면 eMMC는 emmc_recovery_init() 뒤 boot_linux_from_mmc(), 다른 storage는 recovery_init() 뒤 boot_linux_from_flash()를 부른다. boot 함수가 반환한 경우 오류 로그 뒤 같은 fastboot label로 흐른다.
fastboot 준비를 호출 순서대로 본다
label에서는 target_fastboot_init(), 조건부 udc_init(), 명령 등록과 getvar 공개, fastboot_init(), udc_start()가 이어진다. eMMC와 flash의 flash/erase callback이 서로 다르며, unlock은 이곳에서 등록되는 oem unlock 명령으로 따로 다룬다.
IMPLEMENTATION NOTES
계보와 조건부 기능의 경계
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 단계를 이 함수에 추가하지 않는다.
boot header 처리는 호출된 함수 내부에 있다
aboot_init()은 mode와 storage 경로를 고른다. 이미지 header, address, DT 처리와 signature 결과는 선택된 boot_linux_from_mmc() 또는 boot_linux_from_flash()의 내부 조건을 별도로 확인해야 한다. 모든 mode가 이미지 적재·검증을 통과한다고 도식화하면 fastboot jump를 놓친다.
unlock 정보와 mode 입력을 혼동하지 않는다
device.is_unlocked/is_tampered는 signed-kernel·tamper 관련 조건에서 쓰인다. 이 함수의 mode 결정은 키, 조건부 trigger, reboot reason에 있다. 특정 vendor fork의 보안 정책이나 현대 verified boot 보장까지 이 고정 commit으로 단정하지 않는다.
OBJECT LIFETIME
선언·읽기·변경되는 상태
| 대상 | 설정·읽기 시점 | 이 함수에서의 역할 | 근거 |
|---|---|---|---|
| aboot app descriptor | 정적 APP_START(aboot) | .init = aboot_init; 동적 mode state 아님 | L1915–1917 |
page_size/page_mask | aboot_init() 시작 | eMMC 또는 flash page 단위 | L1798–1808 |
device | signed-kernel일 때 키 검사 전 읽기 | unlock/tamper 후속 조건; mode 입력 아님 | L1810–1814, L1849–1869 |
boot_into_recovery | HOME/VOLUP 또는 RECOVERY_MODE | boot 함수가 사용할 recovery 선택 | L1820–1843 |
sn_buf / UDC serial | mode 검사 전 target serial 읽기 | USB serial과 fastboot getvar | L1816–1818, L1903–1905 |
| fastboot 명령·getvar | fastboot: label에서 등록 | eMMC/flash별 callback 뒤 protocol 시작 | L1875–1912 |
FAILURE PATH
분기 해석이 어긋나는 지점
| # | 조건 | 실제 경로 | 먼저 볼 소스 |
|---|---|---|---|
| 01 | recovery key와 fastboot key가 함께 눌림 | recovery flag가 먼저 서면 BACK/VOLDOWN 분기는 실행하지 않음 | L1820–1831 |
| 02 | signed-kernel 사용 안 함 | read_device_info()를 건너뛰고 키 검사로 진행 | L1810–1820 |
| 03 | FASTBOOT_MODE 또는 조건부 trigger | eMMC/flash boot 함수 호출 전 fastboot:로 이동 | L1833–1845, L1875 |
| 04 | boot 함수가 반환 | 오류 로그 뒤 fastboot label로 fallthrough | L1861–1875 |
emmc_recovery_init()의 반환값은 로그만 남기며 바로 fastboot로 전환하지 않는다. fastboot label에서도 fastboot_init()의 반환값을 검사하지 않고 udc_start()를 호출한다. 초기화 함수 호출 자체를 USB service의 준비 완료나 호스트 응답 확인으로 세지 않는다.
EVIDENCE
고정 source와 보드 로그에서 볼 증거
같은 commit의 source line과 대상 보드 로그를 짝지어 본다. 계측은 사용 중인 fork에 맞춰 최소한으로 넣고, mode 선택 자체를 변경하지 않는다.
| # | 목적 | 명령 또는 계측 | 판정 기준 |
|---|---|---|---|
| 01 | 정적 callback 확인 | rg -n 'APP_START\(aboot\)|\.init = aboot_init' app/aboot/aboot.c | descriptor에 .entry가 없는지 확인 |
| 02 | signed device 정보 | target_use_signed_kernel() 반환값과 read_device_info() 진입 기록 | 키 검사 전에 조건부로 읽는지 확인 |
| 03 | mode 분기 | HOME/VOLUP, BACK/VOLDOWN, check_reboot_mode() 결과 기록 | fastboot jump가 boot 함수 전에 발생하는지 확인 |
| 04 | storage 경로 | target_is_emmc_boot()와 호출된 boot 함수 기록 | MMC 또는 flash 중 하나만 실행되는지 확인 |
| 05 | fastboot 준비 | fastboot getvar product (해당 mode 진입 후) | 명령·getvar 등록 및 udc_start() 뒤 응답 확인 |
LAB
소스 순서를 직접 확인할 읽기 실험
- 01descriptor와 mode 선택 위치 표시
고정
aboot.cL1915–1917의.init과 L1792의 함수 시작을 표시한다. descriptor를 runtime의 별도 boot stage로 세지 않는다. - 02키·reboot reason의 우선순위 표 만들기
L1820–1843에서 recovery flag, fastboot jump, 조건부 trigger를 순서대로 따라간다. HOME+BACK처럼 동시 입력일 때
!boot_into_recoveryguard를 확인한다. - 03두 storage 경로와 fallback 추적
L1845–1912에서 eMMC/flash boot 호출을 나눠 표시하고, 어느 호출이 반환하면 오류 로그와 fastboot label에 도달하는지 확인한다. fastboot 직접 jump는 boot 함수를 거치지 않는다.
PRIMARY REFERENCES