LK / classic AOSP aboot · source analysis

classic fastboot command loop

USB online thread의 prefix dispatch와 download: 전용 DATA 수신, handler 응답 경계를 분리해 읽습니다.

AOSP LK commit 9d6e28f의 protocol loop 분석이다. OKAY의 뜻은 선택된 handler의 코드 범위에서 읽어야 하며 저장 완료·재부팅 후 지속성을 일괄 보증하지 않는다.

Series
18 / 20
Baseline
AOSP 9d6e28f
Commit
9d6e28f24ba0
Source
app/aboot/fastboot.c:270-358 (발췌 범위)

한 fastboot 명령은 어떤 순서로 handler에 도착하고 언제 응답하는가?

fastboot_notify()가 USB online event를 신호하면 fastboot_handler thread가 fastboot_command_loop()를 실행한다. loop는 usb_read(buffer, MAX_RSP_SIZE) 뒤 buffer[r] = 0을 쓰고, cmdlist를 첫 prefix match까지 순회한다. 등록 함수가 새 명령을 list 앞에 넣으므로 나중에 등록된 prefix가 먼저 검사된다.

download:도 이 list에서 선택되는 하나의 handler다. 그 handler만 DATA%08x handshake를 보낸 다음 payload를 download_base로 다시 읽는다. 일반 명령에 DATA phase가 있다고 그리거나, OKAY를 storage persistence의 공통 증거로 읽으면 안 된다.

분석 경계

classic AOSP aboot commit 9d6e28f의 app/aboot/fastboot.c다. 현대 fastboot 또는 제품별 flash·boot handler의 보장 범위를 이 loop에 소급하지 않는다.

등록 list와 download/command loop의 고정 소스 부분을 함께 본다.

online event, 명령 list, download state

그림 1. fastboot loop의 객체와 신호 경계
USB 신호thread와 registryhandler 결과
01UDC_EVENT_ONLINE·usb_online
02handler thread·command buffer
03prepend된 cmdlist의 첫 prefix match
04선택 handler·STATE_*·응답
공유 상태

download_base·download_size는 모든 handler 호출에 인자로 전달되지만, DATA handshake와 payload read는 download: handler만 수행한다.

USB completion callback은 txn_done event를 신호한다. 명령 해석은 online event를 기다린 thread의 command loop에서 일어나므로 두 문맥을 한 단계로 묶지 않는다.

일반 명령의 dispatch 경로

그림 2. online 신호부터 첫 matching handler까지
event_wait(usb_online)
usb_read(...,MAX_RSP_SIZE)
buffer[r]=0
새 등록순 첫 prefix match
handler 또는 FAIL 호출·상태 확인

r < 0이면 현재 loop를 빠져나간다. source에는 buffer[r]=0 전에 r < MAX_RSP_SIZE를 검사하는 문장이 없지만, buffer는 별도로 ROUNDUP(4096,CACHE_LINE) byte 할당된다. 따라서 이 한 줄만으로 실제 buffer 밖 쓰기를 단정하지 않는다. matched handler 뒤에는 goto again으로 다음 명령을 읽는다.

loop와 download 전용 phase의 상태

일반 dispatch와 download: handler 내부의 두 번째 usb_read()를 분리해 표시했다.

#조건·함수코드가 변경하는 상태다음 동작
01fastboot_notify(UDC_EVENT_ONLINE)usb_online 신호fastboot_handler()가 loop 실행
02usb_read(buffer,MAX_RSP_SIZE)음수면 break; 그렇지 않으면 buffer[r]=0길이 상한 재검사 없이 prefix 비교
03cmdlist 순회나중 등록된 prefix부터 memcmp(); 첫 match 선택인자 pointer와 download state를 handler에 전달
04matched handler 반환여전히 STATE_COMMAND면 FAIL unknown reasongoto again 후 다음 command read
05match 없음fastboot_fail("unknown command") 호출; COMMAND 설정 없음기존 상태가 COMMAND가 아니면 전송 없이 반환
06download:, 요청 len ≤ maxdownload_size=0 → DATA%08x 송신 → payload usb_read(download_base,len)정확히 len 수신 시 size 갱신·OKAY
07download:, payload short/errorfastboot_state=STATE_ERROR해당 handler에서 OKAY 없이 반환

fastboot_okay() 호출과 호스트 수신은 같은 증거가 아니다. fastboot_ack()는 COMMAND일 때만 COMPLETE로 바꾼 뒤 usb_write()를 호출하고 반환값을 검사하지 않는다. 송신 실패는 ERROR로 바뀔 수 있다. download:는 정확한 payload 수신과 size 설정 뒤 OKAY를 시도하며, flash 기록·영속성을 검사하지 않는다.

공통 dispatcher와 특별한 DATA phase

그림 3은 등록된 handler 모두에 공통인 dispatch다. 그림 4의 DATA 순서는 download:에만 적용된다.

그림 3. command loop의 반복

list의 첫 prefix match만 호출하고, handler가 응답 상태를 끝내지 않으면 FAIL을 보낸다.

01online event 뒤 loop 시작
02command usb_read()
03buffer[r]=0·로그
04cmdlist 첫 prefix match
05handler 또는 FAIL 호출·상태 의존
06다음 command로 반복
그림 4. 일반 handler와 download: handler 비교

둘 다 prefix dispatch를 거치지만, DATA phase는 오른쪽에만 있다.

일반 등록 handler

입력prefix 뒤 argument pointer

상태download_base·download_size 인자 수신

실행선택된 handler마다 실제 작업·응답이 다름

미응답STATE_COMMAND로 돌아오면 FAIL unknown reason

download: 전용

초기화download_size=0; len > max면 FAIL

교섭DATA%08x 송신

수신usb_read(download_base,len) 정확히 len 요구

성공download_size=len 후 OKAY; RAM 수신 의미

원본 코드

아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/fastboot.c에서 270-358줄을 그대로 가져온 것이다.

commit9d6e28f24ba01e563d0b3801c6c6c95d756db623anchor · L294static void fastboot_command_loop(void)
270{
271	STACKBUF_DMA_ALIGN(response, MAX_RSP_SIZE);
272	unsigned len = hex2unsigned(arg);
273	int r;
274
275	download_size = 0;
276	if (len > download_max) {
277		fastboot_fail("data too large");
278		return;
279	}
280
281	snprintf(response, MAX_RSP_SIZE, "DATA%08x", len);
282	if (usb_write(response, strlen(response)) < 0)
283		return;
284
285	r = usb_read(download_base, len);
286	if ((r < 0) || ((unsigned) r != len)) {
287		fastboot_state = STATE_ERROR;
288		return;
289	}
290	download_size = len;
291	fastboot_okay("");
292}
293
294static void fastboot_command_loop(void)
295{
296	struct fastboot_cmd *cmd;
297	int r;
298	dprintf(INFO,"fastboot: processing commands\n");
299
300	uint8_t *buffer = (uint8_t *)memalign(CACHE_LINE, ROUNDUP(4096, CACHE_LINE));
301	if (!buffer)
302	{
303		dprintf(CRITICAL, "Could not allocate memory for fastboot buffer\n.");
304		ASSERT(0);
305	}
306again:
307	while (fastboot_state != STATE_ERROR) {
308		r = usb_read(buffer, MAX_RSP_SIZE);
309		if (r < 0) break;
310		buffer[r] = 0;
311		dprintf(INFO,"fastboot: %s\n", buffer);
312
313		for (cmd = cmdlist; cmd; cmd = cmd->next) {
314			if (memcmp(buffer, cmd->prefix, cmd->prefix_len))
315				continue;
316			fastboot_state = STATE_COMMAND;
317			cmd->handle((const char*) buffer + cmd->prefix_len,
318				    (void*) download_base, download_size);
319			if (fastboot_state == STATE_COMMAND)
320				fastboot_fail("unknown reason");
321			goto again;
322		}
323
324		fastboot_fail("unknown command");
325			
326	}
327	fastboot_state = STATE_OFFLINE;
328	dprintf(INFO,"fastboot: oops!\n");
329	free(buffer);
330}
331
332static int fastboot_handler(void *arg)
333{
334	for (;;) {
335		event_wait(&usb_online);
336		fastboot_command_loop();
337	}
338	return 0;
339}
340
341static void fastboot_notify(struct udc_gadget *gadget, unsigned event)
342{
343	if (event == UDC_EVENT_ONLINE) {
344		event_signal(&usb_online, 0);
345	}
346}
347
348static struct udc_endpoint *fastboot_endpoints[2];
349
350static struct udc_gadget fastboot_gadget = {
351	.notify		= fastboot_notify,
352	.ifc_class	= 0xff,
353	.ifc_subclass	= 0x42,
354	.ifc_protocol	= 0x03,
355	.ifc_endpoints	= 2,
356	.ifc_string	= "fastboot",
357	.ept		= fastboot_endpoints,
358};

발췌 범위와 읽기 기준

원문 270–358줄은 download: handler의 끝, L294의 fastboot_command_loop(), USB online thread와 notify callback을 함께 포함한다. 발췌 첫 줄을 command loop 시작으로 읽지 않는다.

prefix list의 head insertion은 아래 등록 함수 L87–99에 있다. buffer[r]=0 앞의 범위 검사 부재는 기록하되, 실제 할당 크기와 MAX_RSP_SIZE를 구별한다.

함께 읽어야 하는 원본 코드

같은 commit의 등록 함수는 새 command를 cmdlist 앞에 넣는다. USB completion callback은 txn_done을 신호하고, command loop는 별도 online thread에서 돈다. 아래 발췌와 첫 code block을 이어 읽는다.

01. command prefix와 handler를 fastboot table에 등록

app/aboot/fastboot.c 77-145줄이다.

fileapp/aboot/fastboot.canchor · L87void fastboot_register
77};
78
79struct fastboot_var {
80	struct fastboot_var *next;
81	const char *name;
82	const char *value;
83};
84	
85static struct fastboot_cmd *cmdlist;
86
87void fastboot_register(const char *prefix,
88		       void (*handle)(const char *arg, void *data, unsigned sz))
89{
90	struct fastboot_cmd *cmd;
91	cmd = malloc(sizeof(*cmd));
92	if (cmd) {
93		cmd->prefix = prefix;
94		cmd->prefix_len = strlen(prefix);
95		cmd->handle = handle;
96		cmd->next = cmdlist;
97		cmdlist = cmd;
98	}
99}
100
101static struct fastboot_var *varlist;
102
103void fastboot_publish(const char *name, const char *value)
104{
105	struct fastboot_var *var;
106	var = malloc(sizeof(*var));
107	if (var) {
108		var->name = name;
109		var->value = value;
110		var->next = varlist;
111		varlist = var;
112	}
113}
114
115
116static event_t usb_online;
117static event_t txn_done;
118static struct udc_endpoint *in, *out;
119static struct udc_request *req;
120int txn_status;
121
122static void *download_base;
123static unsigned download_max;
124static unsigned download_size;
125
126#define STATE_OFFLINE	0
127#define STATE_COMMAND	1
128#define STATE_COMPLETE	2
129#define STATE_ERROR	3
130
131static unsigned fastboot_state = STATE_OFFLINE;
132
133static void req_complete(struct udc_request *req, unsigned actual, int status)
134{
135	txn_status = status;
136	req->length = actual;
137
138	event_signal(&txn_done, 0);
139}
140
141static int usb_read(void *_buf, unsigned len)
142{
143	int r;
144	unsigned xfer;
145	unsigned char *buf = _buf;

thread, list, handler 결과를 분리하기

01

online event 뒤 thread가 loop를 실행한다

fastboot_notify()는 UDC_EVENT_ONLINE에서 usb_online을 신호한다. fastboot_handler()는 그 event를 기다리고 command loop를 호출한다. req_complete()가 기록하는 USB transaction의 txn_done 신호와 command parsing의 문맥은 구분해야 한다.

02

등록은 head insertion, dispatch는 첫 match다

fastboot_register()는 cmd->next = cmdlist; cmdlist = cmd로 추가한다. loop는 head부터 memcmp(buffer, prefix, prefix_len)를 하고 첫 match에서 handler를 호출한다. 등록 순서와 prefix 충돌이 어느 handler에 닿는지 결정한다.

03

문자열 경계는 코드 그대로 평가한다

loop는 usb_read()가 음수가 아니면 곧바로 buffer[r]=0을 쓴다. r < MAX_RSP_SIZE나 prefix_len <= r를 이 자리에서 검사하지 않는다. 별도 4096-byte 정렬 할당이 있으므로 r == MAX_RSP_SIZE만으로 메모리 밖 쓰기라고 단정하지 않는다.

04

download:에는 두 번째 read가 있다

handler는 download_size=0으로 시작하고 최대 길이를 검사한다. DATA%08x를 보내고 usb_read(download_base,len)가 정확히 len을 돌려줄 때만 download_size=len과 fastboot_okay("")로 진행한다. 짧은 read나 오류는 STATE_ERROR로 간다.

05

FAIL 호출도 상태 guard를 통과해야 한다

match된 경우에만 handler 앞에서 STATE_COMMAND로 바꾼다. handler가 그 상태로 돌아오면 unknown reason FAIL을 시도한다. match가 없는 분기는 COMMAND로 바꾸지 않고 unknown command FAIL을 호출하므로, 초기 OFFLINE 또는 앞선 COMPLETE 상태에서는 fastboot_ack() guard에 막혀 응답을 보내지 않는다.

고정 구현에서 확인해야 할 상태와 길이 조건

01

prefix가 같은 시작 부분을 공유하면 최신 등록이 먼저다

memcmp()은 prefix_len byte만 비교하고 loop는 첫 match 뒤 goto again으로 빠진다. 따라서 flash:와 다른 더 구체적인 prefix가 겹치면 길이만으로 자동 우선순위를 보장하지 않는다. 실제 fastboot_register() 호출 순서가 판단 기준이다.

02

command buffer와 download buffer는 다른 수명이다

command loop의 buffer는 online session의 loop가 끝날 때 free된다. matched handler는 이 buffer 안의 prefix 뒤 pointer와, 별도로 보관된 download_base/download_size를 함께 받는다. download size는 새 download: handler가 시작될 때 0으로 리셋된다.

03

short DATA read는 보통 FAIL path가 아니다

download:의 payload read가 음수거나 요청 len과 다르면 fastboot_state=STATE_ERROR로 설정하고 반환한다. 같은 handler에서 fastboot_fail()을 호출하는 초과 길이 경로와 다르다. protocol trace에서는 DATA 전송, payload 길이와 이후 state를 따로 기록한다.

command와 payload의 다른 객체

대상생성·설정사용자수명·조건
cmdlist nodefastboot_register()에서 malloc·head insertionprefix 비교 loop최신 등록 node부터 첫 match; 이 excerpt에 remove path 없음
command buffermemalign(CACHE_LINE,ROUNDUP(4096,...))usb_read(), memcmp(), handler argloop 종료 시 free; handler arg는 buffer 내부
download_basecommand buffer와 별도로 보관된 전역 주소모든 handler 인자, DATA read 목적지download 크기와 함께 전달
download_sizedownload: 시작 시 0, 성공 시 len후속 handler의 sz 인자payload short/error에서는 성공 크기 갱신 없음
fastboot_stateoffline/command/complete/error 상태loop·handler·응답STATE_ERROR면 loop 종료·offline 전환

고정 코드에 있는 응답·오류 분기

#조건코드의 동작구분할 점
01command usb_read() 음수loop break, state offline, buffer freehandler 호출 전 종료
02등록 prefix와 match 없음FAIL unknown commandCOMMAND 설정 없이 호출하므로 이전 상태에 따라 실제 송신 없음
03handler 뒤 STATE_COMMAND 유지FAIL unknown reason선택 handler가 응답을 끝내지 않음
04download len > maxFAIL data too largeDATA handshake 전 반환
05download payload short/errorSTATE_ERROR 설정·반환같은 handler에서 OKAY 없음

hex2unsigned()는 잘못된 문자를 만나면 그때까지의 누적값을 반환하고 unsigned overflow를 별도로 검출하지 않는다. 따라서 최대 download 크기 비교가 문자열 형식 전체를 엄격하게 검사한다는 뜻은 아니다. buffer[r]=0의 실제 범위도 4096-byte 정렬 할당과 usb_read() 반환 계약으로 평가한다. 등록용 malloc 실패는 명령을 추가하지 않고 반환한다.

원문 발췌와 대조할 지점

이 페이지의 번호 있는 두 원문 조각과 고정 Gitiles 파일에서 아래 조건을 대조한다.

#질문고정 원문확인할 식·호출
01등록 순서fastboot.c:87–99cmd->next=cmdlist; cmdlist=cmd
02online·completion 구분fastboot.c:116–145,332–345txn_done vs usb_online
03DATA 수신fastboot.c:270–292DATA%08x, exact read, size 갱신
04일반 dispatch·bufferfastboot.c:294–330buffer[r]=0, prefix, FAIL·goto
05USB online threadfastboot.c:332–345event_wait(), notify event

분기를 따로 확인할 실험

  1. 01
    prefix 등록 순서 대조

    고정 코드의 fastboot_register() 호출을 순서대로 적고 실제 cmdlist 순회를 역순으로 펼친다. 겹치는 prefix라면 첫 match handler를 기록한다.

  2. 02
    DATA phase와 일반 명령 trace 분리

    복구 가능한 시험 환경에서 download:만 DATA%08x 뒤 payload read가 있는지, 길이 초과와 short read가 각각 FAIL·ERROR 중 어디로 가는지 확인한다.

  3. 03
    command 길이 경계의 source-only 검토

    MAX_RSP_SIZE, 실제 할당 크기, 가능한 r 값과 prefix_len을 표로 둔다. 명시적 검사가 없는 조건을 표시하고, 실장치에 비정상 명령을 보내지 않고 코드와 제어 가능한 harness로 확인한다.

원문과 다음 글