Barebox · source analysis

device_probe와 Linux식 driver binding

bus match 뒤 callback 선택, active 목록의 선삽입, deferred probe의 조건부 재시도를 읽습니다.

Series
07 / 19
Baseline
v2026.06.1
Commit
314c679eea2d
Source
drivers/base/driver.c:97-185 (발췌 범위)

매칭 뒤 callback과 defer는 어떻게 갈라지는가?

match()가 후보 driver를 임시로 붙여 bus match를 확인한 뒤 device_probe()를 호출한다. 이 경로는 device 등록 또는 driver 등록 중에도 실행될 수 있다.

device_probe()는 feature gate를 확인하고 pinctrl·clock 기본 설정 함수를 호출한 뒤, callback 실행 전에 active 목록에 넣는다. callback 결과에 따라 남거나 deferred로 옮기거나 목록에서 뺀다.

match와 probe가 건드리는 객체

그림 1. 후보 driver, device와 active 목록
match(drv, dev)후보 driver를 넣고 bus match를 검사. 실패하면 dev->driver를 NULL로 되돌린다(L223–242).
feature check→오류/FEATCTRL_GATED면 callback 전 반환 · L126–132
active list←pinctrl·clock 호출 뒤 callback 전 삽입 · L138–141
callback→bus->probe 우선, 아니면 driver->probe, 둘 다 없으면 0 · L143–148

플랫폼 bus callback은 power domain attach 뒤 driver probe를 호출한다(platform.c L14–23). 모든 bus가 같은 준비 절차를 갖지는 않는다.

callback 이전까지의 실행 순서

그림 2. driver 후보에서 callback까지
match()driver 후보 설정 → bus match 검사 · L223–234
feature gate오류/차단이면 조기 반환 · L126–132
기본 설정·activepinctrl/clock 호출; active 선삽입 · L138–141
조건부 callbackbus probe 우선 → driver probe → 없으면 0 · L143–148

pinctrl_select_state_default()와 of_clk_set_defaults()의 반환값은 여기서 검사하지 않는다. provider 확보와 child/cdev 생성은 해당 callback의 일이다.

callback 결과별 목록·driver 상태

결과device_probe 내부match 이후
feature 오류 / gatedactive 삽입 전 오류 또는 -ENODEV 반환 · L126–132driver 포인터 NULL; 다음 후보 가능
callback 0active에 남고 0 반환 · L141, L153–154driver 유지, 후보 검색 중단
-EPROBE_DEFER, 일반active node를 deferred로 이동 · L165–168driver NULL; late initcall 재시도 대상
-EPROBE_DEFER, deep-probe 지원즉시 영구 defer 보고, active에서 제거 · L160–162, L178driver NULL; deferred 목록에 추가 안 됨
그 밖의 실패-ENODEV/-ENXIO는 debug, 나머지는 error 로그; active 분리 · L169–180driver NULL; 다음 후보 가능

active·deferred 목록의 상태 변화

그림 3. active는 callback 완료 표시가 아니다
BEFORE CALLBACKactive에 먼저 추가L141에서 넣고 L143–148에서 callback을 호출한다.
SUCCESSactive에 계속 남음0 반환이면 L154에서 곧바로 반환한다.
DEFERdeferred 이동 또는 분리일반 경로는 L165에서 이동, deep-probe는 L178에서 분리.
OTHER ERRORactive에서 분리L178의 list_del_init 뒤 오류 반환, match는 driver 포인터를 비움.

active 목록에서 관찰된 순간만으로 callback 완료나 private state 유효성을 단정하지 않는다.

그림 4. late initcall의 deferred 재시도 고리
QUEUE-EPROBE_DEFER일반 경로에서 active node를 deferred 목록으로 옮긴다(L155–168).
PASS각 device를 다시 matchdevice_probe_deferred가 bus driver 후보를 재시도한다(L385–407).
PROGRESS성공이 있으면 재순회한 pass에 성공이 있으면 다시 순회한다(L391–409).
REMAINDER남은 defer 보고성공 없는 pass 뒤 남은 device를 보고하고 0 반환(L411–416).

provider 등록 이벤트마다 즉시 독립 재시도하는 일반 Linux식 정책으로 설명하지 않는다.

원본 코드

아래 코드는 Barebox v2026.06.1의 drivers/base/driver.c에서 97-185줄을 그대로 가져온 것이다.

commit314c679eea2d0ca847c64d1b646a1cf91225c0ecanchor · L121int device_probe(struct device *dev)
97
98	free(str);
99
100	return dev;
101}
102
103int get_free_deviceid_from(const char *name_template, int id_from)
104{
105	while (1) {
106		if (!get_device_by_name_id(name_template, id_from))
107			return id_from;
108		id_from++;
109	};
110}
111
112static void dev_report_permanent_probe_deferral(struct device *dev)
113{
114	if (dev->deferred_probe_reason)
115		dev_err(dev, "probe permanently deferred (%s)\n",
116			dev->deferred_probe_reason);
117	else
118		dev_err(dev, "probe permanently deferred\n");
119}
120
121int device_probe(struct device *dev)
122{
123	static int depth = 0;
124	int ret;
125
126	ret = of_feature_controller_check(dev->of_node);
127	if (ret < 0)
128		return ret;
129	if (ret == FEATCTRL_GATED) {
130		dev_dbg(dev, "feature gated, skipping probe\n");
131		return -ENODEV;
132	}
133
134	depth++;
135
136	pr_report_probe("%*sprobe-> %s\n", depth * 4, "", dev_name(dev));
137
138	pinctrl_select_state_default(dev);
139	of_clk_set_defaults(dev->of_node, false);
140
141	list_add(&dev->active, &active_device_list);
142
143	if (dev->bus->probe)
144		ret = dev->bus->probe(dev);
145	else if (dev->driver->probe)
146		ret = dev->driver->probe(dev);
147	else
148		ret = 0;
149
150	depth--;
151
152	switch (ret) {
153	case 0:
154		return 0;
155	case -EPROBE_DEFER:
156		/*
157		 * -EPROBE_DEFER should never appear on a deep-probe machine so
158		 * inform the user immediately.
159		 */
160		if (deep_probe_is_supported()) {
161			dev_report_permanent_probe_deferral(dev);
162			break;
163		}
164
165		list_move(&dev->active, &deferred);
166
167		dev_dbg(dev, "probe deferred\n");
168		return -EPROBE_DEFER;
169	case -ENODEV:
170	case -ENXIO:
171		dev_dbg(dev, "probe failed: %pe\n", ERR_PTR(ret));
172		break;
173	default:
174		dev_err(dev, "probe failed: %pe\n", ERR_PTR(ret));
175		break;
176	}
177
178	list_del_init(&dev->active);
179
180	return ret;
181}
182
183int device_detect(struct device *dev)
184{
185	if (!dev->detect)

발췌 범위와 읽기 기준

원본 코드 97–185줄은 앞 문맥, device_probe() L121–181, device_detect() 시작을 포함한다. 보충 발췌 375–455줄에는 late deferred worker와 driver 등록이 함께 있다.

match() L223–242가 probe 오류를 -1로 접고 후보 driver를 비운다. 플랫폼 bus callback은 platform.c L14–23을 참조한다.

함께 읽어야 하는 원본 코드

첫 코드 조각만으로 동작이 완성되지 않는 경우 호출 매크로, 객체 정의와 실제 실행 목록을 같은 페이지에 묶었다. 각 조각은 같은 기준 commit에서 가져왔다.

01. late initcall의 deferred 재시도와 driver 등록 경로

drivers/base/driver.c 375-455줄이다.

filedrivers/base/driver.canchor · L385static int device_probe_deferred(void)
375}
376EXPORT_SYMBOL(free_device);
377
378/*
379 * Loop over list of deferred devices as long as at least one
380 * device is successfully probed. Devices that again request
381 * deferral are re-added to deferred list in device_probe().
382 * For devices finally left in deferred list -EPROBE_DEFER
383 * becomes a fatal error.
384 */
385static int device_probe_deferred(void)
386{
387	struct device *dev, *tmp;
388	struct driver *drv;
389	bool success;
390
391	do {
392		success = false;
393
394		if (list_empty(&deferred))
395			return 0;
396
397		list_for_each_entry_safe(dev, tmp, &deferred, active) {
398			list_del(&dev->active);
399			INIT_LIST_HEAD(&dev->active);
400
401			dev_dbg(dev, "re-probe device\n");
402			bus_for_each_driver(dev->bus, drv) {
403				if (match(drv, dev))
404					continue;
405				success = true;
406				break;
407			}
408		}
409	} while (success);
410
411	list_for_each_entry(dev, &deferred, active)
412		dev_report_permanent_probe_deferral(dev);
413
414	return 0;
415}
416late_initcall(device_probe_deferred);
417
418struct driver *get_driver_by_name(const char *name)
419{
420	struct driver *drv;
421
422	for_each_driver(drv) {
423		if(!strcmp(name, drv->name))
424			return drv;
425	}
426
427	return NULL;
428}
429
430int register_driver(struct driver *drv)
431{
432	struct device *dev = NULL;
433
434	if (!drv->name)
435		return -EINVAL;
436
437	debug("register_driver: %s\n", drv->name);
438
439	BUG_ON(!drv->bus);
440
441	list_add_tail(&drv->list, &driver_list);
442	list_add_tail(&drv->bus_list, &drv->bus->driver_list);
443
444	bus_for_each_device(drv->bus, dev)
445		match(drv, dev);
446
447	return 0;
448}
449EXPORT_SYMBOL(register_driver);
450
451void unregister_driver(struct driver *drv)
452{
453	struct device *dev;
454
455	list_del(&drv->list);

고정 소스의 probe 순서

01

feature gate가 active보다 앞섬

of_feature_controller_check의 음수 오류는 그대로, FEATCTRL_GATED는 -ENODEV로 반환한다(L126–132). 두 경우 callback 실행과 active 연결이 없다.

02

기본 설정과 callback은 다른 단계

pinctrl_select_state_default와 of_clk_set_defaults는 호출만 하고 반환값을 검사하지 않는다(L138–139). active 삽입 뒤 bus callback이 있으면 우선 실행한다.

03

defer는 deep-probe 여부로 분기

일반 경로는 deferred 목록으로 이동한다. deep-probe 지원 경로는 즉시 영구 defer를 보고하고 active에서 분리한다(L155–178).

callback 책임과 재시도 범위

01

bus callback이 driver callback보다 우선

L143–148은 bus->probe, driver->probe, callback 없음의 세 갈래다. 플랫폼 bus는 power domain attach 뒤 driver callback을 호출하지만 모든 bus의 공통 절차는 아니다.

02

core 오류 정리는 목록과 포인터 중심

device_probe는 오류 시 active node를 분리하고 match는 driver 포인터를 비운다. callback에서 만든 child/cdev/clock을 이 두 함수가 일괄 역순 해제하지는 않는다.

03

late deferred pass는 진행이 멈출 때 끝남

device_probe_deferred는 한 pass에서 성공이 있으면 다시 순회한다(L391–409). 성공 없는 pass 뒤 남은 device를 보고한다(L411–416).

probe 동안 바뀌는 참조와 목록

대상진입/변화성공/실패 후
dev->drivermatch가 후보를 먼저 대입 · L230성공 유지; 실패 NULL · L239–241
dev->activecallback 전에 active 목록 연결 · L141성공 유지; 일반 defer는 이동; 기타 실패는 분리
private statebus/driver callback 구현에 따름core가 일괄 생성·해제하지 않음
deferred 목록일반 -EPROBE_DEFER에서 추가late initcall 재시도 뒤 남은 항목 보고

실패 종류별 관찰점

조건core 동작조사 범위
feature 오류/차단callback 전 반환; active 변화 없음of_node와 feature controller
일반 -EPROBE_DEFERdeferred 이동, match에서 driver NULLprovider와 late 재시도
deep-probe에서 defer즉시 영구 defer 보고, active 분리deep-probe 의존성
다른 callback 오류active 분리, driver NULLdriver별 부분 초기화 정리

-ENODEV/-ENXIO는 debug, 다른 오류는 error 로그를 남긴다(L169–175). 로그 수준을 callback 실행 여부와 혼동하지 않는다.

빌드와 기기에서 볼 증거

목적읽기 전용 확인판정
심벌${CROSS_COMPILE}nm -n barebox | grep -E ' (device_probe|device_probe_deferred)$'정적 함수 심벌은 빌드 옵션·최적화에 따라 다를 수 있다.
device/driverdevinfo; drvinfo등록, driver 결합, callback 성공을 로그와 대조.
defer 원인probe 로그 및 dev_err_probe 이유late pass 전후 결과를 분리.

분기를 구별하는 관찰

  1. 01
    callback 전후 active 기록

    L141과 L152에서 dev->active 연결 상태를 비교한다.

  2. 02
    defer와 일반 오류 분리

    callback 반환값, deep-probe 지원 여부, deferred 이동과 driver 포인터를 한 줄로 기록한다.

  3. 03
    late deferred pass 수 확인

    한 pass의 성공 여부와 남은 항목 수를 기록한다.

원문과 다음 글