QUESTION
한 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의 고정 소스 부분을 함께 본다.
STRUCTURE
online event, 명령 list, download state
UDC_EVENT_ONLINE·usb_onlinecmdlist의 첫 prefix matchSTATE_*·응답download_base·download_size는 모든 handler 호출에 인자로 전달되지만, DATA handshake와 payload read는 download: handler만 수행한다.
USB completion callback은 txn_done event를 신호한다. 명령 해석은 online event를 기다린 thread의 command loop에서 일어나므로 두 문맥을 한 단계로 묶지 않는다.
CALL PATH
일반 명령의 dispatch 경로
event_wait(usb_online)usb_read(...,MAX_RSP_SIZE)buffer[r]=0r < 0이면 현재 loop를 빠져나간다. source에는 buffer[r]=0 전에 r < MAX_RSP_SIZE를 검사하는 문장이 없지만, buffer는 별도로 ROUNDUP(4096,CACHE_LINE) byte 할당된다. 따라서 이 한 줄만으로 실제 buffer 밖 쓰기를 단정하지 않는다. matched handler 뒤에는 goto again으로 다음 명령을 읽는다.
STATE LEDGER
loop와 download 전용 phase의 상태
일반 dispatch와 download: handler 내부의 두 번째 usb_read()를 분리해 표시했다.
| # | 조건·함수 | 코드가 변경하는 상태 | 다음 동작 |
|---|---|---|---|
| 01 | fastboot_notify(UDC_EVENT_ONLINE) | usb_online 신호 | fastboot_handler()가 loop 실행 |
| 02 | usb_read(buffer,MAX_RSP_SIZE) | 음수면 break; 그렇지 않으면 buffer[r]=0 | 길이 상한 재검사 없이 prefix 비교 |
| 03 | cmdlist 순회 | 나중 등록된 prefix부터 memcmp(); 첫 match 선택 | 인자 pointer와 download state를 handler에 전달 |
| 04 | matched handler 반환 | 여전히 STATE_COMMAND면 FAIL unknown reason | goto again 후 다음 command read |
| 05 | match 없음 | fastboot_fail("unknown command") 호출; COMMAND 설정 없음 | 기존 상태가 COMMAND가 아니면 전송 없이 반환 |
| 06 | download:, 요청 len ≤ max | download_size=0 → DATA%08x 송신 → payload usb_read(download_base,len) | 정확히 len 수신 시 size 갱신·OKAY |
| 07 | download:, payload short/error | fastboot_state=STATE_ERROR | 해당 handler에서 OKAY 없이 반환 |
fastboot_okay() 호출과 호스트 수신은 같은 증거가 아니다. fastboot_ack()는 COMMAND일 때만 COMPLETE로 바꾼 뒤 usb_write()를 호출하고 반환값을 검사하지 않는다. 송신 실패는 ERROR로 바뀔 수 있다. download:는 정확한 payload 수신과 size 설정 뒤 OKAY를 시도하며, flash 기록·영속성을 검사하지 않는다.
VISUAL WALKTHROUGH
공통 dispatcher와 특별한 DATA phase
그림 3은 등록된 handler 모두에 공통인 dispatch다. 그림 4의 DATA 순서는 download:에만 적용된다.
list의 첫 prefix match만 호출하고, handler가 응답 상태를 끝내지 않으면 FAIL을 보낸다.
usb_read()buffer[r]=0·로그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 수신 의미
UPSTREAM SOURCE
원본 코드
아래 코드는 LK / classic AOSP aboot AOSP 9d6e28f의 app/aboot/fastboot.c에서 270-358줄을 그대로 가져온 것이다.
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};
READING CONTRACT
발췌 범위와 읽기 기준
원문 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를 구별한다.
RELATED SOURCE
함께 읽어야 하는 원본 코드
같은 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줄이다.
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;
DETAILS
thread, list, handler 결과를 분리하기
online event 뒤 thread가 loop를 실행한다
fastboot_notify()는 UDC_EVENT_ONLINE에서 usb_online을 신호한다. fastboot_handler()는 그 event를 기다리고 command loop를 호출한다. req_complete()가 기록하는 USB transaction의 txn_done 신호와 command parsing의 문맥은 구분해야 한다.
등록은 head insertion, dispatch는 첫 match다
fastboot_register()는 cmd->next = cmdlist; cmdlist = cmd로 추가한다. loop는 head부터 memcmp(buffer, prefix, prefix_len)를 하고 첫 match에서 handler를 호출한다. 등록 순서와 prefix 충돌이 어느 handler에 닿는지 결정한다.
문자열 경계는 코드 그대로 평가한다
loop는 usb_read()가 음수가 아니면 곧바로 buffer[r]=0을 쓴다. r < MAX_RSP_SIZE나 prefix_len <= r를 이 자리에서 검사하지 않는다. 별도 4096-byte 정렬 할당이 있으므로 r == MAX_RSP_SIZE만으로 메모리 밖 쓰기라고 단정하지 않는다.
download:에는 두 번째 read가 있다
handler는 download_size=0으로 시작하고 최대 길이를 검사한다. DATA%08x를 보내고 usb_read(download_base,len)가 정확히 len을 돌려줄 때만 download_size=len과 fastboot_okay("")로 진행한다. 짧은 read나 오류는 STATE_ERROR로 간다.
FAIL 호출도 상태 guard를 통과해야 한다
match된 경우에만 handler 앞에서 STATE_COMMAND로 바꾼다. handler가 그 상태로 돌아오면 unknown reason FAIL을 시도한다. match가 없는 분기는 COMMAND로 바꾸지 않고 unknown command FAIL을 호출하므로, 초기 OFFLINE 또는 앞선 COMPLETE 상태에서는 fastboot_ack() guard에 막혀 응답을 보내지 않는다.
IMPLEMENTATION NOTES
고정 구현에서 확인해야 할 상태와 길이 조건
prefix가 같은 시작 부분을 공유하면 최신 등록이 먼저다
memcmp()은 prefix_len byte만 비교하고 loop는 첫 match 뒤 goto again으로 빠진다. 따라서 flash:와 다른 더 구체적인 prefix가 겹치면 길이만으로 자동 우선순위를 보장하지 않는다. 실제 fastboot_register() 호출 순서가 판단 기준이다.
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으로 리셋된다.
short DATA read는 보통 FAIL path가 아니다
download:의 payload read가 음수거나 요청 len과 다르면 fastboot_state=STATE_ERROR로 설정하고 반환한다. 같은 handler에서 fastboot_fail()을 호출하는 초과 길이 경로와 다르다. protocol trace에서는 DATA 전송, payload 길이와 이후 state를 따로 기록한다.
OBJECT LIFETIME
command와 payload의 다른 객체
| 대상 | 생성·설정 | 사용자 | 수명·조건 |
|---|---|---|---|
cmdlist node | fastboot_register()에서 malloc·head insertion | prefix 비교 loop | 최신 등록 node부터 첫 match; 이 excerpt에 remove path 없음 |
command buffer | memalign(CACHE_LINE,ROUNDUP(4096,...)) | usb_read(), memcmp(), handler arg | loop 종료 시 free; handler arg는 buffer 내부 |
download_base | command buffer와 별도로 보관된 전역 주소 | 모든 handler 인자, DATA read 목적지 | download 크기와 함께 전달 |
download_size | download: 시작 시 0, 성공 시 len | 후속 handler의 sz 인자 | payload short/error에서는 성공 크기 갱신 없음 |
fastboot_state | offline/command/complete/error 상태 | loop·handler·응답 | STATE_ERROR면 loop 종료·offline 전환 |
FAILURE PATH
고정 코드에 있는 응답·오류 분기
| # | 조건 | 코드의 동작 | 구분할 점 |
|---|---|---|---|
| 01 | command usb_read() 음수 | loop break, state offline, buffer free | handler 호출 전 종료 |
| 02 | 등록 prefix와 match 없음 | FAIL unknown command | COMMAND 설정 없이 호출하므로 이전 상태에 따라 실제 송신 없음 |
| 03 | handler 뒤 STATE_COMMAND 유지 | FAIL unknown reason | 선택 handler가 응답을 끝내지 않음 |
| 04 | download len > max | FAIL data too large | DATA handshake 전 반환 |
| 05 | download payload short/error | STATE_ERROR 설정·반환 | 같은 handler에서 OKAY 없음 |
hex2unsigned()는 잘못된 문자를 만나면 그때까지의 누적값을 반환하고 unsigned overflow를 별도로 검출하지 않는다. 따라서 최대 download 크기 비교가 문자열 형식 전체를 엄격하게 검사한다는 뜻은 아니다. buffer[r]=0의 실제 범위도 4096-byte 정렬 할당과 usb_read() 반환 계약으로 평가한다. 등록용 malloc 실패는 명령을 추가하지 않고 반환한다.
EVIDENCE
원문 발췌와 대조할 지점
이 페이지의 번호 있는 두 원문 조각과 고정 Gitiles 파일에서 아래 조건을 대조한다.
| # | 질문 | 고정 원문 | 확인할 식·호출 |
|---|---|---|---|
| 01 | 등록 순서 | fastboot.c:87–99 | cmd->next=cmdlist; cmdlist=cmd |
| 02 | online·completion 구분 | fastboot.c:116–145,332–345 | txn_done vs usb_online |
| 03 | DATA 수신 | fastboot.c:270–292 | DATA%08x, exact read, size 갱신 |
| 04 | 일반 dispatch·buffer | fastboot.c:294–330 | buffer[r]=0, prefix, FAIL·goto |
| 05 | USB online thread | fastboot.c:332–345 | event_wait(), notify event |
LAB
분기를 따로 확인할 실험
- 01prefix 등록 순서 대조
고정 코드의
fastboot_register()호출을 순서대로 적고 실제cmdlist순회를 역순으로 펼친다. 겹치는 prefix라면 첫 match handler를 기록한다. - 02DATA phase와 일반 명령 trace 분리
복구 가능한 시험 환경에서
download:만DATA%08x뒤 payload read가 있는지, 길이 초과와 short read가 각각 FAIL·ERROR 중 어디로 가는지 확인한다. - 03command 길이 경계의 source-only 검토
MAX_RSP_SIZE, 실제 할당 크기, 가능한r값과prefix_len을 표로 둔다. 명시적 검사가 없는 조건을 표시하고, 실장치에 비정상 명령을 보내지 않고 코드와 제어 가능한 harness로 확인한다.
PRIMARY REFERENCES