U-Boot · source analysis

device_probe와 의존 장치 활성화

device_probe에서 부모 재진입, 조기 ACTIVATED 표시, 조건부 의존 단계와 실패 정리 경로를 읽습니다.

Series
10 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
drivers/core/device.c:485-619 (발췌 범위)

v2026.07은 이 글의 소스 분석 기준이며 보안 업데이트 권고 버전이 아닙니다. 제품 적용 시 U-Boot 보안 정책과 사용 보드의 패치·드라이버 변경 기록을 확인하세요.

ACTIVATED는 언제 켜지고 언제 유효한가?

device_probe()는 이미 활성화된 장치면 바로 0을 반환한다. 비활성 장치는 PRE_PROBE 알림·device_of_to_plat()·부모 probe를 거친 뒤 한 번 더 활성 상태를 검사한다. 부모 호출이 자식을 probe했을 수 있기 때문이다.

여전히 비활성일 때 DM_FLAG_ACTIVATED를 driver callback보다 먼저 세운다. 이 비트는 재진입 방지에 쓰이므로 단독으로 hardware와 모든 후속 callback의 완료를 증명하지 않는다. 성공 반환 또는 실패 경로까지 함께 봐야 한다.

이 글에서 device_free() 호출과 실제 해제는 구분한다. CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)가 거짓이면 free는 빈 함수이며, 실패 시 ACTIVATED 해제만으로 자동 private data까지 해제됐다고 할 수 없다.

부모 probe와 재진입 경계

그림 1. 부모가 자식을 시작할 수 있는 분기
dpv-parentPRE_PROBE 알림과 of_to_plat 뒤 부모를 probe한다. 그 과정에서 자식이 이미 probe됐을 수 있어 ACTIVATED를 재검사한다. 이미 활성화됐다면 반환하고 아니면 driver callback 전에 flag를 세운다.PRE_PROBE 알림오류면 즉시 returndevice_of_to_platprivate data / platdataparent probe부모가 있으면 재귀 호출ACTIVATED 재검사부모 호출 뒤 L519이미 활성: return 0중복 초기화 방지아직 비활성: flag 설정L523, callback 이전예: 부모 probe가 자식까지 시작아니오첫 ACTIVATED 검사(L493)가 참이면 위 흐름에 들어오기 전에 return 0.flag는 재진입 방지 표식이다. 이 시점에 driver probe와 후처리는 아직 끝나지 않았다.

↔ 그림을 좌우로 밀어 이어지는 경로를 확인하세요.

device_probe() L493–523. device_of_to_plat()는 별도로 private data와 플랫폼 데이터를 준비할 수 있다. 부모 probe 전후의 ACTIVATED 검사는 중복 진행을 막는다.

flag 이후에도 남아 있는 일

그림 2. 활성 표시 뒤 driver callback과 post 단계까지
dpv-mainDM_FLAG_ACTIVATED를 먼저 설정한다. 이후 조건부 power domain, 비치명적 default pinctrl, 조건부 IOMMU와 DMA 제약, uclass와 parent callback, assigned clocks, driver probe, post-probe 및 post event를 수행한다.DM_FLAG_ACTIVATEDL523: 먼저 설정power domain조건부 · 오류는 faildefault pinctrl일반 장치 · 오류 계속IOMMU / DMA조건부 enable / constraintsuclass preuclass + parent uclassparent child_predriver callback 있으면clock defaults유효 ofnode인 경우driver probecallback 있으면 L587–591uclass post실패면 fail_uclasspinctrl devicedefault 오류는 계속POST_PROBE event실패면 fail_eventreturn 0모든 후속 단계 통과driver callback 전에도 ACTIVATED=1 · default pinctrl 오류만으로는 이 함수가 fail로 이동하지 않는다.

↔ 그림을 좌우로 밀어 이어지는 경로를 확인하세요.

일반 장치와 pinctrl 장치의 default-state 호출 위치가 다르다. 두 위치 모두 -ENOSYS 이외의 오류를 debug log로 기록할 수 있으나 이 함수는 그 오류만으로 중단하지 않는다.

시점별 상태와 오류 경계

소스단계관찰 가능한 상태오류 시 경로
L490–498입구와 PRE eventNULL은 -EINVAL; 이미 ACTIVATED면 0. event는 아직 flag 전event 오류는 즉시 반환
L503–521plat 변환·부모 probe자동 private data/platdata가 준비될 수 있고 부모가 자식을 활성화했을 수도 있음오류는 fail; 부모 뒤 flag 재검사 참이면 0
L523–564ACTIVATED 및 자원 단계flag=1, 그러나 driver callback 전. PD·IOMMU는 조건부, DMA 제약은 검사PD/IOMMU/DMA 오류는 fail; 일반 pinctrl 오류는 계속
L566–590pre callbacks·clock·driveruclass pre, parent child_pre, 유효 ofnode의 assigned clock 뒤 driver callback각 nonzero는 fail
L593–608post callbacks·eventuclass post, pinctrl 장치 default state, POST event 통과 뒤 0 반환uclass post/event 오류는 device_remove() 시도 후 fail
L609–620실패 공통부ACTIVATED 비트 해제, device_free()로 자동 private data 정리원래 ret 반환; hardware rollback은 별도 검증

원본 코드

아래 코드는 U-Boot v2026.07의 drivers/core/device.c에서 485-619줄을 그대로 가져온 것이다.

commitece349ade2973e220f524ce59e59711cc919263fanchor · L485int device_probe(struct udevice *dev)
485int device_probe(struct udevice *dev)
486{
487	const struct driver *drv;
488	int ret;
489
490	if (!dev)
491		return -EINVAL;
492
493	if (dev_get_flags(dev) & DM_FLAG_ACTIVATED)
494		return 0;
495
496	ret = device_notify(dev, EVT_DM_PRE_PROBE);
497	if (ret)
498		return ret;
499
500	drv = dev->driver;
501	assert(drv);
502
503	ret = device_of_to_plat(dev);
504	if (ret)
505		goto fail;
506
507	/* Ensure all parents are probed */
508	if (dev->parent) {
509		ret = device_probe(dev->parent);
510		if (ret)
511			goto fail;
512
513		/*
514		 * The device might have already been probed during
515		 * the call to device_probe() on its parent device
516		 * (e.g. PCI bridge devices). Test the flags again
517		 * so that we don't mess up the device.
518		 */
519		if (dev_get_flags(dev) & DM_FLAG_ACTIVATED)
520			return 0;
521	}
522
523	dev_or_flags(dev, DM_FLAG_ACTIVATED);
524
525	if (CONFIG_IS_ENABLED(POWER_DOMAIN) && dev->parent &&
526	    (device_get_uclass_id(dev) != UCLASS_POWER_DOMAIN) &&
527	    !(drv->flags & DM_FLAG_DEFAULT_PD_CTRL_OFF)) {
528		ret = dev_power_domain_on(dev);
529		if (ret)
530			goto fail;
531	}
532
533	/*
534	 * Process pinctrl for everything except the root device, and
535	 * continue regardless of the result of pinctrl. Don't process pinctrl
536	 * settings for pinctrl devices since the device may not yet be
537	 * probed.
538	 *
539	 * This call can produce some non-intuitive results. For example, on an
540	 * x86 device where dev is the main PCI bus, the pinctrl device may be
541	 * child or grandchild of that bus, meaning that the child will be
542	 * probed here. If the child happens to be the P2SB and the pinctrl
543	 * device is a child of that, then both the pinctrl and P2SB will be
544	 * probed by this call. This works because the DM_FLAG_ACTIVATED flag
545	 * is set just above. However, the PCI bus' probe() method and
546	 * associated uclass methods have not yet been called.
547	 */
548	if (dev->parent && device_get_uclass_id(dev) != UCLASS_PINCTRL) {
549		ret = pinctrl_select_state(dev, "default");
550		if (ret && ret != -ENOSYS)
551			log_debug("Device '%s' failed to configure default pinctrl: %d (%s)\n",
552				  dev->name, ret, errno_str(ret));
553	}
554
555	if (CONFIG_IS_ENABLED(IOMMU) && dev->parent &&
556	    (device_get_uclass_id(dev) != UCLASS_IOMMU)) {
557		ret = dev_iommu_enable(dev);
558		if (ret)
559			goto fail;
560	}
561
562	ret = device_get_dma_constraints(dev);
563	if (ret)
564		goto fail;
565
566	ret = uclass_pre_probe_device(dev);
567	if (ret)
568		goto fail;
569
570	if (dev->parent && dev->parent->driver->child_pre_probe) {
571		ret = dev->parent->driver->child_pre_probe(dev);
572		if (ret)
573			goto fail;
574	}
575
576	/* Only handle devices that have a valid ofnode */
577	if (dev_has_ofnode(dev)) {
578		/*
579		 * Process 'assigned-{clocks/clock-parents/clock-rates}'
580		 * properties
581		 */
582		ret = clk_set_defaults(dev, CLK_DEFAULTS_PRE);
583		if (ret)
584			goto fail;
585	}
586
587	if (drv->probe) {
588		ret = drv->probe(dev);
589		if (ret)
590			goto fail;
591	}
592
593	ret = uclass_post_probe_device(dev);
594	if (ret)
595		goto fail_uclass;
596
597	if (dev->parent && device_get_uclass_id(dev) == UCLASS_PINCTRL) {
598		ret = pinctrl_select_state(dev, "default");
599		if (ret && ret != -ENOSYS)
600			log_debug("Device '%s' failed to configure default pinctrl: %d (%s)\n",
601				  dev->name, ret, errno_str(ret));
602	}
603
604	ret = device_notify(dev, EVT_DM_POST_PROBE);
605	if (ret)
606		goto fail_event;
607
608	return 0;
609fail_event:
610fail_uclass:
611	if (device_remove(dev, DM_REMOVE_NORMAL)) {
612		dm_warn("%s: Device '%s' failed to remove on error path\n",
613			__func__, dev->name);
614	}
615fail:
616	dev_bic_flags(dev, DM_FLAG_ACTIVATED);
617
618	device_free(dev);
619

고정 코드와 동적 주석을 함께 읽기

대표 원문은 drivers/core/device.c:485–619의 함수 시작부터 device_free() 호출까지다. 반환문 L620은 발췌 바로 다음 줄이므로 실패 결과는 원본 전체 함수와 함께 확인한다. 코드는 수정하지 않았다.

519if (dev_get_flags(dev) & DM_FLAG_ACTIVATED)

부모 probe가 자식을 시작했을 수 있어 두 번째로 검사한다. 참이면 추가 초기화 없이 0을 반환한다.

523dev_or_flags(dev, DM_FLAG_ACTIVATED);

power-domain·pinctrl·driver callback 전에 재진입 방지 비트를 세운다. 원문 L533–546의 PCI bus/P2SB 주석이 그 이유를 설명한다.

549ret = pinctrl_select_state(dev, "default");

일반 장치의 default pinctrl은 실패해도 debug log만 남기고 계속한다. pinctrl 장치는 L597–602에서 별도 호출한다.

588ret = drv->probe(dev);

장치 driver의 실제 probe callback이다. ACTIVATED는 이미 켜져 있으므로 성공 여부는 반환값과 후속 단계까지 확인한다.

611device_remove(dev, DM_REMOVE_NORMAL)

uclass post 또는 POST event 실패 때만 먼저 remove를 시도한다. remove 실패는 경고를 남긴 뒤 공통 fail로 간다.

616dev_bic_flags(dev, DM_FLAG_ACTIVATED);

공통 fail에서 flag를 지우고 L618의 device_free()로 자동 private data를 정리한다. 이 코드만으로 모든 하드웨어 복원을 보장하지 않는다.

각 호출이 만드는 상태

01

bind된 장치에서 출발한다

device_probe()는 이미 존재하는 struct udevice를 받는다. device_of_to_plat()는 부모의 plat 변환, 자동 private data 할당, driver of_to_plat callback과 DM_FLAG_PLATDATA_VALID를 처리한다. probe 자체가 새 장치를 bind하는 단계는 아니다.

02

부모 호출 뒤 다시 검사한다

부모 probe 과정에서 대상 자식이 간접적으로 probe될 수 있다. L519의 두 번째 flag 검사를 건너뛰면 같은 장치의 초기화를 다시 수행할 수 있다. 이미 활성 상태라면 이 호출은 0을 반환한다.

03

의존 자원은 모두 필수 단계가 아니다

power domain과 IOMMU는 CONFIG·부모·uclass·driver flag 조건을 만족할 때만 처리한다. 유효한 ofnode가 있는 장치만 assigned clock defaults를 설정한다. reset·regulator를 코어가 모든 장치에 공급한다고 일반화할 수 없다.

04

pinctrl 오류는 여기서 계속 진행한다

일반 장치는 L548–553, pinctrl 장치는 post-probe L597–602에서 default state를 선택한다. 오류가 -ENOSYS가 아니면 debug log를 남기지만 이 함수는 곧바로 fail로 가지 않는다. 다음 단계 자체의 오류는 별도로 치명적일 수 있다.

05

새 probe 경로의 정상 완료는 마지막 event 뒤다

이미 활성화된 장치의 조기 반환을 제외한 새 probe 경로는 uclass pre, 부모 driver child_pre, clock defaults, driver probe, uclass post와 POST_PROBE event를 통과해 0을 반환한다. ACTIVATED는 이 전 과정 동안 켜져 있으므로 외부 관찰에서는 진행 중 상태와 완료 상태를 혼동하지 않아야 한다.

설정에 따른 정리 한계: 아래의 자동 private data 해제·PLATDATA_VALID 해제 설명은 CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)가 참인 빌드에 해당한다. 같은 고정 버전의 include/dm/device-internal.h L207–230에서 이 설정이 꺼지면 device_remove()는 0을 반환하는 stub, device_free()는 빈 함수다. 이때 probe의 공통 fail은 ACTIVATED를 지우지만 private data와 PLATDATA_VALID까지 정리되었다고 볼 수 없다. drivers/core/Makefile도 해당 설정으로 device-remove.o를 선택한다.

재진입과 실패 정리의 한계

01

ACTIVATED는 완료 bit가 아니다

L523에서 먼저 세우는 이유는 원문 주석의 PCI bus → pinctrl/P2SB 재진입 사례처럼 중복 probe를 막기 위해서다. pre-probe resource와 driver callback이 아직 실행 중인 시점에도 1일 수 있다. 일반적인 동시성 완료 신호로 해석해서는 안 된다.

02

빠른 실패와 late 실패가 다르다

인자 오류와 PRE_PROBE event 오류는 바로 반환한다. device_of_to_plat()부터 driver callback까지의 오류는 공통 fail로 간다. uclass post 또는 POST_PROBE event 오류만 device_remove(..., DM_REMOVE_NORMAL)을 먼저 시도한다. remove 오류는 경고 뒤에도 공통 fail이 이어진다.

03

정리는 할당과 장치 효과를 구별한다

device_free()는 자동 driver/uclass/parent private data와 probe devres를 정리하고 PLATDATA_VALID를 지운다. 코어의 조기 fail이 driver의 부분 하드웨어 변경을 모두 되돌리는 것은 아니다. post 실패의 remove도 반환 실패 가능성이 있으므로 전원·clock·child 상태는 해당 드라이버와 remove 경로로 검증한다.

필드·객체의 생산자

대상설정/할당 지점의미와 실패 후 확인
struct udevice앞선 bind 단계이 함수의 인자. probe 실패가 곧 unbind나 객체 자체 해제를 뜻하지 않는다.
driver/uclass/parent private datadevice_of_to_plat() → device_alloc_priv()자동 할당분은 device_free()가 정리하고 포인터를 NULL로 돌린다.
DM_FLAG_PLATDATA_VALIDdevice_of_to_plat() 성공plat 변환 완료 표식. device_free()에서 해제된다.
DM_FLAG_ACTIVATEDdevice_probe() L523callback보다 먼저 켜지는 재진입 방지 비트. 실패 공통부에서 지운다.
power/pinctrl/IOMMU/DMA/clock 상태설정·장치 조건별 단계자동 private data와 별개다. 오류 시 실제 하드웨어 복원은 provider·driver·remove 동작에 따름.

어느 오류가 어느 정리로 가는가?

그림 3. 직접 반환·공통 fail·remove 선행 경로
dpv-fail인자 오류와 PRE_PROBE 실패는 즉시 반환한다. of_to_plat부터 driver callback까지의 오류는 공통 fail로 바로 간다. uclass post와 POST_PROBE 오류는 먼저 device_remove를 시도한 뒤 공통 fail로 간다.즉시 반환NULL / 활성 / PRE event직접 failof_to_plat ~ driver probe후속 오류uclass post / POST eventdevice_remove() 시도실패해도 경고 후 계속fail 공통부flag 해제 + device_freereturn ret오류 원인 유지즉시 반환은 이 함수의 공통 fail을 거치지 않는다.late 오류만 remove 단계 포함flag 해제 ≠ 하드웨어 복원

↔ 그림을 좌우로 밀어 이어지는 경로를 확인하세요.

device_remove()는 모든 실패에 호출되지 않는다. DM_DEVICE_REMOVE가 꺼져 있으면 remove는 성공 반환 stub이고 free는 빈 함수다. 실제 정리 경로에서 remove가 실패해도 원래 ret을 반환하며, 이미 변경된 하드웨어가 완전히 복원됐다는 보장은 없다.

지점오류 처리진단 초점
PRE_PROBE eventflag 전 즉시 반환event callback과 반환 코드
of_to_plat / parent / PD / IOMMU / DMA / pre / clock / driver바로 fail: flag 해제, device_free()어느 callback이 nonzero를 냈고 자원을 일부 바꾸었는지
default pinctrl-ENOSYS 외 오류를 debug log로만 기록하고 계속후속 단계가 따로 실패했는지 구분
uclass post / POST_PROBE eventdevice_remove() 시도 후 failremove 실패 경고와 원래 오류를 각각 기록

빌드 산출물과 runtime의 증거

실제 보드와 빌드에 따라 DM이 SPL에 포함되는지는 다르다. 아래는 호스트 산출물 확인과 U-Boot proper shell의 사후 관찰을 구분한 예시다.

목적명령/계측 예판정 기준
설정grep -E '^CONFIG_(DM|SPL_DM|POWER_DOMAIN|IOMMU|PINCTRL|CLK)=' .config분기와 대상 stage의 사용 여부 확인
symbol${CROSS_COMPILE}nm -n u-boot | grep -w device_probeC 선언문이 아닌 ELF 심벌 이름을 검색. SPL이 DM을 포함하면 spl/u-boot-spl도 별도 확인
어셈블리/맵${CROSS_COMPILE}objdump -drS u-boot; u-boot.map선택한 빌드에서 callback 호출과 flag 분기 확인
실행 중 분기시험 보드의 단계별 debug log/return codeL519 재진입, pinctrl 로그 후 계속, direct/late fail을 구분
사후 장치 상태U-Boot proper shell의 dm tree, dm uclass명령 존재 시 probe 전후 장치 상태 비교. callback 내부 실행 명령으로 취급하지 않음

시험 보드에서 확인할 세 분기

  1. 01
    부모 호출 중 자식 재진입

    시험용 parent/child에 단계별 로그를 넣어 L519 재검사가 참인 경우 자식 driver callback이 중복 실행되지 않는지 확인한다.

  2. 02
    default pinctrl 오류와 후속 진행

    격리된 시험 보드에서 pinctrl 오류를 주입하고 debug log 뒤에도 uclass/driver 단계가 호출되는지 기록한다. 그 다음 단계에서 실패했다면 원인을 분리한다.

  3. 03
    조기 실패와 post 실패의 정리 비교

    driver callback 오류와 uclass post 오류를 각각 재현해 device_remove() 호출 여부, flag, 자동 private pointer 및 실제 장치 상태를 비교한다.

고정 소스와 공식 문서