QUESTION
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까지 해제됐다고 할 수 없다.
STRUCTURE
부모 probe와 재진입 경계
↔ 그림을 좌우로 밀어 이어지는 경로를 확인하세요.
device_probe() L493–523. device_of_to_plat()는 별도로 private data와 플랫폼 데이터를 준비할 수 있다. 부모 probe 전후의 ACTIVATED 검사는 중복 진행을 막는다.
CALL PATH
flag 이후에도 남아 있는 일
↔ 그림을 좌우로 밀어 이어지는 경로를 확인하세요.
일반 장치와 pinctrl 장치의 default-state 호출 위치가 다르다. 두 위치 모두 -ENOSYS 이외의 오류를 debug log로 기록할 수 있으나 이 함수는 그 오류만으로 중단하지 않는다.
STATE LEDGER
시점별 상태와 오류 경계
| 소스 | 단계 | 관찰 가능한 상태 | 오류 시 경로 |
|---|---|---|---|
| L490–498 | 입구와 PRE event | NULL은 -EINVAL; 이미 ACTIVATED면 0. event는 아직 flag 전 | event 오류는 즉시 반환 |
| L503–521 | plat 변환·부모 probe | 자동 private data/platdata가 준비될 수 있고 부모가 자식을 활성화했을 수도 있음 | 오류는 fail; 부모 뒤 flag 재검사 참이면 0 |
| L523–564 | ACTIVATED 및 자원 단계 | flag=1, 그러나 driver callback 전. PD·IOMMU는 조건부, DMA 제약은 검사 | PD/IOMMU/DMA 오류는 fail; 일반 pinctrl 오류는 계속 |
| L566–590 | pre callbacks·clock·driver | uclass pre, parent child_pre, 유효 ofnode의 assigned clock 뒤 driver callback | 각 nonzero는 fail |
| L593–608 | post callbacks·event | uclass post, pinctrl 장치 default state, POST event 통과 뒤 0 반환 | uclass post/event 오류는 device_remove() 시도 후 fail |
| L609–620 | 실패 공통부 | ACTIVATED 비트 해제, device_free()로 자동 private data 정리 | 원래 ret 반환; hardware rollback은 별도 검증 |
UPSTREAM SOURCE
원본 코드
아래 코드는 U-Boot v2026.07의 drivers/core/device.c에서 485-619줄을 그대로 가져온 것이다.
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
READING CONTRACT
고정 코드와 동적 주석을 함께 읽기
대표 원문은 drivers/core/device.c:485–619의 함수 시작부터 device_free() 호출까지다. 반환문 L620은 발췌 바로 다음 줄이므로 실패 결과는 원본 전체 함수와 함께 확인한다. 코드는 수정하지 않았다.
if (dev_get_flags(dev) & DM_FLAG_ACTIVATED)부모 probe가 자식을 시작했을 수 있어 두 번째로 검사한다. 참이면 추가 초기화 없이 0을 반환한다.
dev_or_flags(dev, DM_FLAG_ACTIVATED);power-domain·pinctrl·driver callback 전에 재진입 방지 비트를 세운다. 원문 L533–546의 PCI bus/P2SB 주석이 그 이유를 설명한다.
ret = pinctrl_select_state(dev, "default");일반 장치의 default pinctrl은 실패해도 debug log만 남기고 계속한다. pinctrl 장치는 L597–602에서 별도 호출한다.
ret = drv->probe(dev);장치 driver의 실제 probe callback이다. ACTIVATED는 이미 켜져 있으므로 성공 여부는 반환값과 후속 단계까지 확인한다.
device_remove(dev, DM_REMOVE_NORMAL)uclass post 또는 POST event 실패 때만 먼저 remove를 시도한다. remove 실패는 경고를 남긴 뒤 공통 fail로 간다.
dev_bic_flags(dev, DM_FLAG_ACTIVATED);공통 fail에서 flag를 지우고 L618의 device_free()로 자동 private data를 정리한다. 이 코드만으로 모든 하드웨어 복원을 보장하지 않는다.
DETAILS
각 호출이 만드는 상태
bind된 장치에서 출발한다
device_probe()는 이미 존재하는 struct udevice를 받는다. device_of_to_plat()는 부모의 plat 변환, 자동 private data 할당, driver of_to_plat callback과 DM_FLAG_PLATDATA_VALID를 처리한다. probe 자체가 새 장치를 bind하는 단계는 아니다.
부모 호출 뒤 다시 검사한다
부모 probe 과정에서 대상 자식이 간접적으로 probe될 수 있다. L519의 두 번째 flag 검사를 건너뛰면 같은 장치의 초기화를 다시 수행할 수 있다. 이미 활성 상태라면 이 호출은 0을 반환한다.
의존 자원은 모두 필수 단계가 아니다
power domain과 IOMMU는 CONFIG·부모·uclass·driver flag 조건을 만족할 때만 처리한다. 유효한 ofnode가 있는 장치만 assigned clock defaults를 설정한다. reset·regulator를 코어가 모든 장치에 공급한다고 일반화할 수 없다.
pinctrl 오류는 여기서 계속 진행한다
일반 장치는 L548–553, pinctrl 장치는 post-probe L597–602에서 default state를 선택한다. 오류가 -ENOSYS가 아니면 debug log를 남기지만 이 함수는 곧바로 fail로 가지 않는다. 다음 단계 자체의 오류는 별도로 치명적일 수 있다.
새 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를 선택한다.
IMPLEMENTATION NOTES
재진입과 실패 정리의 한계
ACTIVATED는 완료 bit가 아니다
L523에서 먼저 세우는 이유는 원문 주석의 PCI bus → pinctrl/P2SB 재진입 사례처럼 중복 probe를 막기 위해서다. pre-probe resource와 driver callback이 아직 실행 중인 시점에도 1일 수 있다. 일반적인 동시성 완료 신호로 해석해서는 안 된다.
빠른 실패와 late 실패가 다르다
인자 오류와 PRE_PROBE event 오류는 바로 반환한다. device_of_to_plat()부터 driver callback까지의 오류는 공통 fail로 간다. uclass post 또는 POST_PROBE event 오류만 device_remove(..., DM_REMOVE_NORMAL)을 먼저 시도한다. remove 오류는 경고 뒤에도 공통 fail이 이어진다.
정리는 할당과 장치 효과를 구별한다
device_free()는 자동 driver/uclass/parent private data와 probe devres를 정리하고 PLATDATA_VALID를 지운다. 코어의 조기 fail이 driver의 부분 하드웨어 변경을 모두 되돌리는 것은 아니다. post 실패의 remove도 반환 실패 가능성이 있으므로 전원·clock·child 상태는 해당 드라이버와 remove 경로로 검증한다.
OBJECT LIFETIME
필드·객체의 생산자
| 대상 | 설정/할당 지점 | 의미와 실패 후 확인 |
|---|---|---|
struct udevice | 앞선 bind 단계 | 이 함수의 인자. probe 실패가 곧 unbind나 객체 자체 해제를 뜻하지 않는다. |
| driver/uclass/parent private data | device_of_to_plat() → device_alloc_priv() | 자동 할당분은 device_free()가 정리하고 포인터를 NULL로 돌린다. |
DM_FLAG_PLATDATA_VALID | device_of_to_plat() 성공 | plat 변환 완료 표식. device_free()에서 해제된다. |
DM_FLAG_ACTIVATED | device_probe() L523 | callback보다 먼저 켜지는 재진입 방지 비트. 실패 공통부에서 지운다. |
| power/pinctrl/IOMMU/DMA/clock 상태 | 설정·장치 조건별 단계 | 자동 private data와 별개다. 오류 시 실제 하드웨어 복원은 provider·driver·remove 동작에 따름. |
FAILURE PATH
어느 오류가 어느 정리로 가는가?
↔ 그림을 좌우로 밀어 이어지는 경로를 확인하세요.
device_remove()는 모든 실패에 호출되지 않는다. DM_DEVICE_REMOVE가 꺼져 있으면 remove는 성공 반환 stub이고 free는 빈 함수다. 실제 정리 경로에서 remove가 실패해도 원래 ret을 반환하며, 이미 변경된 하드웨어가 완전히 복원됐다는 보장은 없다.
| 지점 | 오류 처리 | 진단 초점 |
|---|---|---|
| PRE_PROBE event | flag 전 즉시 반환 | 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 event | device_remove() 시도 후 fail | remove 실패 경고와 원래 오류를 각각 기록 |
EVIDENCE
빌드 산출물과 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_probe | C 선언문이 아닌 ELF 심벌 이름을 검색. SPL이 DM을 포함하면 spl/u-boot-spl도 별도 확인 |
| 어셈블리/맵 | ${CROSS_COMPILE}objdump -drS u-boot; u-boot.map | 선택한 빌드에서 callback 호출과 flag 분기 확인 |
| 실행 중 분기 | 시험 보드의 단계별 debug log/return code | L519 재진입, pinctrl 로그 후 계속, direct/late fail을 구분 |
| 사후 장치 상태 | U-Boot proper shell의 dm tree, dm uclass | 명령 존재 시 probe 전후 장치 상태 비교. callback 내부 실행 명령으로 취급하지 않음 |
LAB
시험 보드에서 확인할 세 분기
- 01부모 호출 중 자식 재진입
시험용 parent/child에 단계별 로그를 넣어 L519 재검사가 참인 경우 자식 driver callback이 중복 실행되지 않는지 확인한다.
- 02default pinctrl 오류와 후속 진행
격리된 시험 보드에서 pinctrl 오류를 주입하고 debug log 뒤에도 uclass/driver 단계가 호출되는지 기록한다. 그 다음 단계에서 실패했다면 원인을 분리한다.
- 03조기 실패와 post 실패의 정리 비교
driver callback 오류와 uclass post 오류를 각각 재현해
device_remove()호출 여부, flag, 자동 private pointer 및 실제 장치 상태를 비교한다.
PRIMARY REFERENCES