QUESTION
device_bind와 장치 객체 생성 단계에서 실제로 바뀌는 상태는 무엇인가?
bind는 레지스터를 만지는 probe가 아니다. 이름, driver, node, parent, uclass와 자동 할당 데이터가 만들어지는 범위를 정확히 구분한다.
udevice는 먼저 부모의 child list에, 다음에 uclass 목록에 연결된다. 이때 bind callback이 아직 끝나지 않았으므로 `DM_FLAG_BOUND`가 설정되는 성공 반환 지점을 별도로 확인해야 한다.
STRUCTURE
객체와 주소가 놓이는 구조
parent·ofnode·plat 선택
입력·실패 조건 · *parent가 없으면 child list 단계는 생략된다. ofnode는 비어 있을 수 있다. BOUND는 callback 성공 뒤에만 설정되며 probe는 이후의 별도 호출이다.
순서는 v2026.07 device_bind_common() 40–191행을 따른다. udevice는 driver match 단계가 아니라 이 함수 안에서 생성된다.
CALL PATH
실행 흐름
필드·platdata
parent 있을 때
device
있는 경우
성공 반환
callback 순서는 driver bind → parent driver child_post_bind → uclass post_bind이며, 없는 callback은 건너뛴다. 오류가 나면 fail_* 경로로 되돌아가며 DM_FLAG_BOUND까지 진행하지 않는다. 목록 해제·platdata 정리는 CONFIG_DM_DEVICE_REMOVE 조건을 따른다.
이 그림은 bind까지만 나타낸다. device_probe()는 나중에 호출되어 활성화와 driver probe를 처리한다.
STATE LEDGER
단계별 입력과 출력
아래 순서는 device_bind_common()의 정상 경로를 기준으로 한다. parent·ofnode·platdata·callback은 구성과 호출자에 따라 생략될 수 있다.
| # | 단계 | 진입 시 신뢰할 상태 | 성공 뒤 남는 상태 | 다음 소비자 |
|---|---|---|---|---|
| 01 | uclass_get | driver·name; OF_PLATDATA_NO_BIND/name guard 통과 | driver의 uclass 확보 | udevice 할당 |
| 02 | calloc·필드·platdata | uclass 확보 | udevice 생성; parent·driver·uclass·선택적 ofnode와 platdata 설정 | parent 연결 |
| 03 | parent->child_head | 초기화된 udevice | parent가 있으면 sibling_node를 child list에 추가 | uclass 연결 |
| 04 | uclass_bind_device | parent 연결이 필요한 경우 완료 | uclass 목록에 연결; 내부 callback은 해당 구현을 확인 | bind callbacks |
| 05 | bind callbacks | 두 목록의 연결 상태 | driver bind → parent driver child_post_bind → uclass post_bind 성공(각각 있을 때) | 성공 완료 |
| 06 | DM_FLAG_BOUND | 모든 적용 callback 성공 | devp 반환값 설정(있을 때), BOUND bit 설정 후 return 0 | 나중의 device_probe() |
bind 성공은 활성화가 아니다. DM_FLAG_ACTIVATED와 hardware 초기화는 이후 probe 경로에서 확인한다.
UPSTREAM SOURCE
원본 코드
원문 U-Boot v2026.07 · drivers/core/device.c의 40–238행입니다.
40static int device_bind_common(struct udevice *parent, const struct driver *drv,
41 const char *name, void *plat,
42 ulong driver_data, ofnode node,
43 uint of_plat_size, struct udevice **devp)
44{
45 struct udevice *dev;
46 struct uclass *uc;
47 int size, ret = 0;
48 bool auto_seq = true;
49 void *ptr;
50
51 if (CONFIG_IS_ENABLED(OF_PLATDATA_NO_BIND))
52 return -ENOSYS;
53
54 if (devp)
55 *devp = NULL;
56 if (!name)
57 return -EINVAL;
58
59 ret = uclass_get(drv->id, &uc);
60 if (ret) {
61 dm_warn("Missing uclass for driver %s\n", drv->name);
62 return ret;
63 }
64
65 dev = calloc(1, sizeof(struct udevice));
66 if (!dev)
67 return -ENOMEM;
68
69 INIT_LIST_HEAD(&dev->sibling_node);
70 INIT_LIST_HEAD(&dev->child_head);
71 INIT_LIST_HEAD(&dev->uclass_node);
72#if CONFIG_IS_ENABLED(DEVRES)
73 INIT_LIST_HEAD(&dev->devres_head);
74#endif
75 dev_set_plat(dev, plat);
76 dev->driver_data = driver_data;
77 dev->name = name;
78 dev_set_ofnode(dev, node);
79 dev->parent = parent;
80 dev->driver = drv;
81 dev->uclass = uc;
82
83 dev->seq_ = -1;
84 if (CONFIG_IS_ENABLED(DM_SEQ_ALIAS) &&
85 (uc->uc_drv->flags & DM_UC_FLAG_SEQ_ALIAS)) {
86 /*
87 * Some devices, such as a SPI bus, I2C bus and serial ports
88 * are numbered using aliases.
89 */
90 if (CONFIG_IS_ENABLED(OF_CONTROL) &&
91 !CONFIG_IS_ENABLED(OF_PLATDATA)) {
92 if (uc->uc_drv->name && ofnode_valid(node)) {
93 if (!dev_read_alias_seq(dev, &dev->seq_)) {
94 auto_seq = false;
95 log_debug(" - seq=%d\n", dev->seq_);
96 }
97 }
98 }
99 }
100 if (auto_seq && !(uc->uc_drv->flags & DM_UC_FLAG_NO_AUTO_SEQ))
101 dev->seq_ = uclass_find_next_free_seq(uc);
102
103 /* Check if we need to allocate plat */
104 if (drv->plat_auto) {
105 bool alloc = !plat;
106
107 /*
108 * For of-platdata, we try use the existing data, but if
109 * plat_auto is larger, we must allocate a new space
110 */
111 if (CONFIG_IS_ENABLED(OF_PLATDATA)) {
112 if (of_plat_size)
113 dev_or_flags(dev, DM_FLAG_OF_PLATDATA);
114 if (of_plat_size < drv->plat_auto)
115 alloc = true;
116 }
117 if (alloc) {
118 dev_or_flags(dev, DM_FLAG_ALLOC_PDATA);
119 ptr = calloc(1, drv->plat_auto);
120 if (!ptr) {
121 ret = -ENOMEM;
122 goto fail_alloc1;
123 }
124
125 /*
126 * For of-platdata, copy the old plat into the new
127 * space
128 */
129 if (CONFIG_IS_ENABLED(OF_PLATDATA) && plat)
130 memcpy(ptr, plat, of_plat_size);
131 dev_set_plat(dev, ptr);
132 }
133 }
134
135 size = uc->uc_drv->per_device_plat_auto;
136 if (size) {
137 dev_or_flags(dev, DM_FLAG_ALLOC_UCLASS_PDATA);
138 ptr = calloc(1, size);
139 if (!ptr) {
140 ret = -ENOMEM;
141 goto fail_alloc2;
142 }
143 dev_set_uclass_plat(dev, ptr);
144 }
145
146 if (parent) {
147 size = parent->driver->per_child_plat_auto;
148 if (!size)
149 size = parent->uclass->uc_drv->per_child_plat_auto;
150 if (size) {
151 dev_or_flags(dev, DM_FLAG_ALLOC_PARENT_PDATA);
152 ptr = calloc(1, size);
153 if (!ptr) {
154 ret = -ENOMEM;
155 goto fail_alloc3;
156 }
157 dev_set_parent_plat(dev, ptr);
158 }
159 /* put dev into parent's successor list */
160 list_add_tail(&dev->sibling_node, &parent->child_head);
161 }
162
163 ret = uclass_bind_device(dev);
164 if (ret)
165 goto fail_uclass_bind;
166
167 /* if we fail to bind we remove device from successors and free it */
168 if (drv->bind) {
169 ret = drv->bind(dev);
170 if (ret)
171 goto fail_bind;
172 }
173 if (parent && parent->driver->child_post_bind) {
174 ret = parent->driver->child_post_bind(dev);
175 if (ret)
176 goto fail_child_post_bind;
177 }
178 if (uc->uc_drv->post_bind) {
179 ret = uc->uc_drv->post_bind(dev);
180 if (ret)
181 goto fail_uclass_post_bind;
182 }
183
184 if (parent)
185 pr_debug("Bound device %s to %s\n", dev->name, parent->name);
186 if (devp)
187 *devp = dev;
188
189 dev_or_flags(dev, DM_FLAG_BOUND);
190
191 return 0;
192
193fail_uclass_post_bind:
194 /* There is no child unbind() method, so no clean-up required */
195fail_child_post_bind:
196 if (CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)) {
197 if (drv->unbind && drv->unbind(dev)) {
198 dm_warn("unbind() method failed on dev '%s' on error path\n",
199 dev->name);
200 }
201 }
202
203fail_bind:
204 if (CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)) {
205 if (uclass_unbind_device(dev)) {
206 dm_warn("Failed to unbind dev '%s' on error path\n",
207 dev->name);
208 }
209 }
210fail_uclass_bind:
211 if (CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)) {
212 list_del(&dev->sibling_node);
213 if (dev_get_flags(dev) & DM_FLAG_ALLOC_PARENT_PDATA) {
214 free(dev_get_parent_plat(dev));
215 dev_set_parent_plat(dev, NULL);
216 }
217 }
218fail_alloc3:
219 if (CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)) {
220 if (dev_get_flags(dev) & DM_FLAG_ALLOC_UCLASS_PDATA) {
221 free(dev_get_uclass_plat(dev));
222 dev_set_uclass_plat(dev, NULL);
223 }
224 }
225fail_alloc2:
226 if (CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)) {
227 if (dev_get_flags(dev) & DM_FLAG_ALLOC_PDATA) {
228 free(dev_get_plat(dev));
229 dev_set_plat(dev, NULL);
230 }
231 }
232fail_alloc1:
233 devres_release_all(dev);
234
235 free(dev);
236
237 return ret;
238}
READING CONTRACT
발췌 범위와 읽기 기준
원문 40–238행은 device_bind_common() 전체를 담습니다. 객체 할당, parent·uclass 목록 연결, callback 처리 뒤 189행에서 DM_FLAG_BOUND를 세웁니다. 191행의 성공 반환 뒤에는 실패 시 정리 경로가 이어집니다.
bind는 레지스터를 만지는 probe가 아니다. 이름, driver, node, parent, uclass와 자동 할당 데이터가 만들어지는 범위를 정확히 구분한다.
DETAILS
내부 동작을 더 깊게 읽기
진입 조건을 먼저 고정한다
DT 기반 호출자는 ofnode를 건넬 수 있지만, device_bind_by_name()은 ofnode_null()을 건넨다. SPL·relocation 전후에 어떤 호출자가 사용하는지와 그 문맥에서 확보된 heap·driver-model 상태를 따로 확인한다.
bind는 레지스터를 만지는 probe가 아니다. 이름, driver, node, parent, uclass와 자동 할당 데이터가 만들어지는 범위를 정확히 구분한다.
중심 객체의 생성과 공개를 나눈다
이 글의 중심 객체는 struct udevice다. 메모리를 확보한 시점, 필드를 채운 시점, 전역 list나 다른 subsystem에 공개한 시점을 구분한다. 공개 뒤 오류가 발생한다면 목록에서 제거하고 child, buffer, reference를 역순으로 정리하는지 확인한다.
빌드 산출물 관점에서는 최종 부트로더 이미지 안에 해당 symbol과 section이 실제로 포함되었는지도 map과 objdump로 검증한다.
주소, 크기와 정렬을 계산한다
부트 코드에서는 주소 계산 오류를 주의해야 한다. 원본과 목적지의 주소 범위, 헤더에 기록된 데이터 크기, 블록·페이지 단위를 표로 정리하고 각 구간의 끝 주소를 계산한다. 끝 주소가 start + size - 1처럼 마지막 바이트를 가리키는지, 구간 바로 다음 주소를 가리키는지는 API 규약에서 확인한다.
성공 flag와 실제 완료 시점을 맞춘다
device_bind_common()은 udevice를 만든 뒤 parent child list, uclass 순서로 연결한다. 중간에는 BOUND가 없는 부분 초기화 상태가 있다. 적용되는 bind callback이 모두 성공하고 DM_FLAG_BOUND가 설정된 뒤의 반환값을 bind 성공 기준으로 삼는다.
다른 CPU, 인터럽트 처리기, USB 완료 콜백, 셸 명령에서도 이 상태를 읽는다면 메모리 접근 순서와 잠금 범위를 함께 확인한다.
제어권을 넘기기 전에 확인할 조건을 정리한다
정상 bind 경로는 child list에서 끝나지 않는다. uclass 연결과 조건부 callback을 거쳐 DM_FLAG_BOUND를 세우고 0을 반환한다. 이후 필요할 때 device_probe()가 parent를 먼저 probe하고 활성화한다.
호출한 함수로 돌아오는 경로라면 오류와 일부 처리만 완료된 상태를 구분하는지 확인한다. 이어서 다음 후보를 시도할지, 복구 절차를 실행할지 살펴본다.
IMPLEMENTATION NOTES
구현을 읽을 때 놓치기 쉬운 부분
bind는 객체를 만들지만 hardware를 켜지 않는다
device_bind()는 driver, parent, uclass, ofnode를 연결하고 platform data와 이름을 준비한다. MMIO access, clock enable, reset 해제는 일반적으로 probe의 책임이므로 bind 성공을 장치 사용 가능 상태로 해석하면 안 된다.
driver의 bind() callback은 child device를 추가할 수 있다. 이후 callback이 실패하면 fail_* 경로와 CONFIG_DM_DEVICE_REMOVE 조건을 확인해 uclass·parent 목록 및 자동 할당 데이터의 정리를 점검한다.
ofnode와 plat data의 소유권을 구분한다
flat tree offset은 FDT blob이 유지되는 동안만 의미가 있고 live tree node는 별도 객체 수명을 가진다. relocation이나 control FDT 교체 뒤에도 저장한 ofnode가 유효한지 abstraction이 보장하는 범위를 본다.
자동 할당된 plat_ 영역과 board가 넘긴 static data는 해제 책임이 다르다. bind 재시도와 unbind에서 double free가 생기지 않도록 allocation flag를 확인한다.
이름과 sequence는 외부 인터페이스가 된다
device name, alias sequence와 uclass index는 command, environment, bootstd가 장치를 찾는 기준으로 쓰일 수 있다. DT alias가 빠지거나 중복되면 probe는 성공해도 mmc 0 같은 사용자-visible 번호가 달라진다.
bind 로그에는 driver name뿐 아니라 parent path, ofnode path, requested/assigned sequence를 함께 남긴다. 이름 충돌 오류는 두 device의 생성 경로를 모두 추적한다.
OBJECT LIFETIME
객체와 수명
| 대상 | 만들어지는 시점 | 유효 범위 | 확인할 조건 |
|---|---|---|---|
struct udevice | device_bind_common()의 calloc | 성공 시 unbind까지; 실패 시 fail_*에서 해제 | 입력·실패 조건과 BOUND 여부 |
| driver·name·plat·ofnode 입력 | 호출자가 준비 | 소유권은 입력 종류와 호출자에 따름 | name 필수; ofnode와 plat는 없어도 됨 |
| parent child list 연결 | parent가 있을 때, uclass 연결 전에 | bind 성공 뒤 unbind까지; 실패 시 조건부 정리 | sibling_node와 parent->child_head |
| uclass 목록 연결 | uclass_bind_device() | bind 성공 뒤 unbind까지; 실패 시 조건부 정리 | uclass_node와 BOUND 설정 전 callback 실패 |
| hardware 활성화 | 이후 device_probe() | probe/remove 수명 | BOUND와 ACTIVATED를 구분 |
FAILURE PATH
실패 지점과 증상
| # | 조건 | 관찰되는 증상 | 먼저 볼 단계 |
|---|---|---|---|
| 01 | name 누락 또는 uclass 실패 | udevice 할당 전 오류 반환 | guard·uclass_get |
| 02 | udevice/platdata 할당 실패 | -ENOMEM; 생성된 자료를 실패 경로에서 해제 | calloc·fail_alloc* |
| 03 | uclass 연결 또는 bind callback 실패 | BOUND 미설정; 연결·할당 상태의 정리 필요 | fail_uclass_bind·fail_bind 이후; CONFIG_DM_DEVICE_REMOVE 조건 |
parent가 없으면 child list에 넣지 않는다. 실패 지점마다 parent/uclass 목록과 자동 할당 flag의 변화를 함께 확인한다.
EVIDENCE
소스 밖에서 확인할 증거
소스에서 파악한 동작을 실제 빌드 결과와 대상 보드의 로그로 확인한다. 아래 명령의 보드 이름과 툴체인 접두사는 사용 중인 빌드 환경에 맞게 바꾼다.
| # | 목적 | 명령 또는 계측 | 판정 기준 |
|---|---|---|---|
| 01 | 전처리 결과 | make <board>_defconfig && make V=1 | 선택된 CONFIG와 실제 compile/link 명령을 보관한다. |
| 02 | symbol과 section | ${CROSS_COMPILE}nm -n u-boot | grep 'device_bind' | symbol 주소가 기대한 stage와 image에 들어갔는지 확인한다. |
| 03 | 어셈블리 대조 | ${CROSS_COMPILE}objdump -drS u-boot | C 한 줄이 실제 branch, relocation, memory access로 어떻게 바뀌었는지 본다. |
| 04 | 주소 배치 | bdinfo | relocaddr, malloc, FDT, stack과 DRAM bank 주소를 한 번에 기록한다. |
| 05 | runtime 관찰 | dm tree; dm uclass; printenv | driver model과 환경이 이 단계에서 실제로 공개되었는지 확인한다. |
LAB
직접 확인할 실험
- 01udevice 생성 지점 기록
device_bind_common()의uclass_get전후와calloc뒤 dev 주소를 기록한다. driver match 이전에 객체가 있다고 가정하지 않는다. - 02두 목록의 삽입 순서 관찰
parent가 있는 장치에서
list_add_tail(&dev->sibling_node, &parent->child_head)와uclass_bind_device(dev)직후의 목록을 비교한다. - 03BOUND와 probe의 경계 비교
callback 성공 뒤
DM_FLAG_BOUND를, 나중의device_probe()뒤DM_FLAG_ACTIVATED를 각각 기록한다.
PRIMARY REFERENCES