U-Boot · source analysis

device_bind와 장치 객체 생성

driver와 선택적 DT node를 `struct udevice`로 묶고 parent/uclass 목록에 연결하는 bind 단계를 읽습니다.

표의 버전은 소스 분석 기준이며 최신 보안 버전 권고가 아닙니다. 제품 적용 시 사용 플랫폼의 errata를 확인하세요.

Series
09 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
drivers/core/device.c:40-238 (발췌 범위)

device_bind와 장치 객체 생성 단계에서 실제로 바뀌는 상태는 무엇인가?

bind는 레지스터를 만지는 probe가 아니다. 이름, driver, node, parent, uclass와 자동 할당 데이터가 만들어지는 범위를 정확히 구분한다.

udevice는 먼저 부모의 child list에, 다음에 uclass 목록에 연결된다. 이때 bind callback이 아직 끝나지 않았으므로 `DM_FLAG_BOUND`가 설정되는 성공 반환 지점을 별도로 확인해야 한다.

객체와 주소가 놓이는 구조

그림 1. device_bind_common의 입력, 생성, 공개 경계
호출자가 건네는 값bind 내부의 생성·연결성공 시 남는 상태
01 · INPUTdriver·name 필수
parent·ofnode·plat 선택
02 · CREATEuclass_get → udevice calloc
03 · LINKplatdata 준비 → parent child list*
04 · FINISHuclass link → callbacks → BOUND
CONTRACT

입력·실패 조건 · *parent가 없으면 child list 단계는 생략된다. ofnode는 비어 있을 수 있다. BOUND는 callback 성공 뒤에만 설정되며 probe는 이후의 별도 호출이다.

순서는 v2026.07 device_bind_common() 40–191행을 따른다. udevice는 driver match 단계가 아니라 이 함수 안에서 생성된다.

실행 흐름

그림 2. device_bind_common 정상 경로: parent 목록이 uclass 연결보다 먼저
uclass_get
udevice calloc
필드·platdata
parent child list
parent 있을 때
uclass_bind_
device
bind callbacks
있는 경우
BOUND bit
성공 반환

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를 처리한다.

단계별 입력과 출력

아래 순서는 device_bind_common()의 정상 경로를 기준으로 한다. parent·ofnode·platdata·callback은 구성과 호출자에 따라 생략될 수 있다.

#단계진입 시 신뢰할 상태성공 뒤 남는 상태다음 소비자
01uclass_getdriver·name; OF_PLATDATA_NO_BIND/name guard 통과driver의 uclass 확보udevice 할당
02calloc·필드·platdatauclass 확보udevice 생성; parent·driver·uclass·선택적 ofnode와 platdata 설정parent 연결
03parent->child_head초기화된 udeviceparent가 있으면 sibling_node를 child list에 추가uclass 연결
04uclass_bind_deviceparent 연결이 필요한 경우 완료uclass 목록에 연결; 내부 callback은 해당 구현을 확인bind callbacks
05bind callbacks두 목록의 연결 상태driver bind → parent driver child_post_bind → uclass post_bind 성공(각각 있을 때)성공 완료
06DM_FLAG_BOUND모든 적용 callback 성공devp 반환값 설정(있을 때), BOUND bit 설정 후 return 0나중의 device_probe()

bind 성공은 활성화가 아니다. DM_FLAG_ACTIVATED와 hardware 초기화는 이후 probe 경로에서 확인한다.

원본 코드

원문 U-Boot v2026.07 · drivers/core/device.c의 40–238행입니다.

commitece349ade2973e220f524ce59e59711cc919263fanchor · L40static int device_bind_common(struct udevice *parent, const struct driver *drv,
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}

발췌 범위와 읽기 기준

원문 40–238행은 device_bind_common() 전체를 담습니다. 객체 할당, parent·uclass 목록 연결, callback 처리 뒤 189행에서 DM_FLAG_BOUND를 세웁니다. 191행의 성공 반환 뒤에는 실패 시 정리 경로가 이어집니다.

bind는 레지스터를 만지는 probe가 아니다. 이름, driver, node, parent, uclass와 자동 할당 데이터가 만들어지는 범위를 정확히 구분한다.

내부 동작을 더 깊게 읽기

01

진입 조건을 먼저 고정한다

DT 기반 호출자는 ofnode를 건넬 수 있지만, device_bind_by_name()은 ofnode_null()을 건넨다. SPL·relocation 전후에 어떤 호출자가 사용하는지와 그 문맥에서 확보된 heap·driver-model 상태를 따로 확인한다.

bind는 레지스터를 만지는 probe가 아니다. 이름, driver, node, parent, uclass와 자동 할당 데이터가 만들어지는 범위를 정확히 구분한다.

02

중심 객체의 생성과 공개를 나눈다

이 글의 중심 객체는 struct udevice다. 메모리를 확보한 시점, 필드를 채운 시점, 전역 list나 다른 subsystem에 공개한 시점을 구분한다. 공개 뒤 오류가 발생한다면 목록에서 제거하고 child, buffer, reference를 역순으로 정리하는지 확인한다.

빌드 산출물 관점에서는 최종 부트로더 이미지 안에 해당 symbol과 section이 실제로 포함되었는지도 map과 objdump로 검증한다.

03

주소, 크기와 정렬을 계산한다

부트 코드에서는 주소 계산 오류를 주의해야 한다. 원본과 목적지의 주소 범위, 헤더에 기록된 데이터 크기, 블록·페이지 단위를 표로 정리하고 각 구간의 끝 주소를 계산한다. 끝 주소가 start + size - 1처럼 마지막 바이트를 가리키는지, 구간 바로 다음 주소를 가리키는지는 API 규약에서 확인한다.

04

성공 flag와 실제 완료 시점을 맞춘다

device_bind_common()은 udevice를 만든 뒤 parent child list, uclass 순서로 연결한다. 중간에는 BOUND가 없는 부분 초기화 상태가 있다. 적용되는 bind callback이 모두 성공하고 DM_FLAG_BOUND가 설정된 뒤의 반환값을 bind 성공 기준으로 삼는다.

다른 CPU, 인터럽트 처리기, USB 완료 콜백, 셸 명령에서도 이 상태를 읽는다면 메모리 접근 순서와 잠금 범위를 함께 확인한다.

05

제어권을 넘기기 전에 확인할 조건을 정리한다

정상 bind 경로는 child list에서 끝나지 않는다. uclass 연결과 조건부 callback을 거쳐 DM_FLAG_BOUND를 세우고 0을 반환한다. 이후 필요할 때 device_probe()가 parent를 먼저 probe하고 활성화한다.

호출한 함수로 돌아오는 경로라면 오류와 일부 처리만 완료된 상태를 구분하는지 확인한다. 이어서 다음 후보를 시도할지, 복구 절차를 실행할지 살펴본다.

구현을 읽을 때 놓치기 쉬운 부분

01

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 목록 및 자동 할당 데이터의 정리를 점검한다.

02

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를 확인한다.

03

이름과 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의 생성 경로를 모두 추적한다.

객체와 수명

대상만들어지는 시점유효 범위확인할 조건
struct udevicedevice_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를 구분

실패 지점과 증상

#조건관찰되는 증상먼저 볼 단계
01name 누락 또는 uclass 실패udevice 할당 전 오류 반환guard·uclass_get
02udevice/platdata 할당 실패-ENOMEM; 생성된 자료를 실패 경로에서 해제calloc·fail_alloc*
03uclass 연결 또는 bind callback 실패BOUND 미설정; 연결·할당 상태의 정리 필요fail_uclass_bind·fail_bind 이후; CONFIG_DM_DEVICE_REMOVE 조건

parent가 없으면 child list에 넣지 않는다. 실패 지점마다 parent/uclass 목록과 자동 할당 flag의 변화를 함께 확인한다.

소스 밖에서 확인할 증거

소스에서 파악한 동작을 실제 빌드 결과와 대상 보드의 로그로 확인한다. 아래 명령의 보드 이름과 툴체인 접두사는 사용 중인 빌드 환경에 맞게 바꾼다.

#목적명령 또는 계측판정 기준
01전처리 결과make <board>_defconfig && make V=1선택된 CONFIG와 실제 compile/link 명령을 보관한다.
02symbol과 section${CROSS_COMPILE}nm -n u-boot | grep 'device_bind'symbol 주소가 기대한 stage와 image에 들어갔는지 확인한다.
03어셈블리 대조${CROSS_COMPILE}objdump -drS u-bootC 한 줄이 실제 branch, relocation, memory access로 어떻게 바뀌었는지 본다.
04주소 배치bdinforelocaddr, malloc, FDT, stack과 DRAM bank 주소를 한 번에 기록한다.
05runtime 관찰dm tree; dm uclass; printenvdriver model과 환경이 이 단계에서 실제로 공개되었는지 확인한다.

직접 확인할 실험

  1. 01
    udevice 생성 지점 기록

    device_bind_common()의 uclass_get 전후와 calloc 뒤 dev 주소를 기록한다. driver match 이전에 객체가 있다고 가정하지 않는다.

  2. 02
    두 목록의 삽입 순서 관찰

    parent가 있는 장치에서 list_add_tail(&dev->sibling_node, &parent->child_head)와 uclass_bind_device(dev) 직후의 목록을 비교한다.

  3. 03
    BOUND와 probe의 경계 비교

    callback 성공 뒤 DM_FLAG_BOUND를, 나중의 device_probe() 뒤 DM_FLAG_ACTIVATED를 각각 기록한다.

원문과 다음 글