QUESTION
dm_init()에서 root와 uclass는 어떤 순서로 준비되는가?
진입 시 gd->dm_root가 이미 있으면 -EINVAL로 끝난다. 비어 있으면 gd->uclass_root를 먼저 설정하고, 설정에 따라 정적 device instance를 연결하거나 root driver를 bind·probe한다.
FDT 자식 scan은 이 함수 내부가 아니라 이후 dm_init_and_scan()이 호출하는 별도 scan 경로다. root device의 생성, root에 ofnode 연결, 자식 bind, 장치 probe를 한 단계로 합치지 않는다.
STRUCTURE
생성 전제와 공개되는 포인터
dm_init() 내부에서 root보다 먼저 준비되는 uclass headgd->dm_root == NULLgd->uclass_root 선택·필요 시 list head 초기화dm_setup_inst() 또는 root bind·probedmtag_list 준비이미 root가 있으면 두 번째 tree를 만들지 않고 -EINVAL로 반환한다.
root는 dm_init()의 선행 입력이 아니다. 고정 root.c의 순서대로 head 설정과 root 준비를 나누었다.
CALL PATH
root 초기화와 자식 scan은 다른 함수
dm_init()의 실제 순서와 이후 scan 경계uclass_root 설정dmtag_list 초기화·returndm_scan()에서 자식 bind마지막 칸은 dm_init() 내부가 아니다. dm_init_and_scan()은 dm_init() 성공 뒤, OF_PLATDATA_INST가 꺼져 있을 때만 dm_scan()을 호출한다. OF_REAL이면 그 안의 dm_extended_scan()이 FDT 자식을 탐색한다.
STATE LEDGER
분기별 입력과 성공 뒤 상태
좁은 화면에서는 표를 좌우로 밀어 설정별 결과를 확인한다.
| 지점 | 전제·조건 | 코드가 하는 일 | 이후 보장 범위 |
|---|---|---|---|
| 중복 검사 | gd->dm_root != NULL | -EINVAL 반환 | 새 root 또는 uclass list를 만들지 않음 |
| uclass head | root가 비어 있음 | OF_PLATDATA_INST면 uclass_head, 아니면 DM_UCLASS_ROOT_S_NON_CONST 선택·list head 초기화 | head pointer 준비; 모든 uclass device가 생긴 것은 아님 |
| 정적 instance | OF_PLATDATA_INST 켬 | dm_setup_inst()가 DM_DEVICE_GET(root)를 root에 연결 | 이 분기에서 일반 root bind·probe를 호출하지 않음 |
| 일반 root | OF_PLATDATA_INST 끔 | device_bind_by_name() → 조건부 dev_set_ofnode() → device_probe() | root 준비; FDT 자식은 아직 scan하지 않음 |
| 후속 scan | dm_init_and_scan()의 일반 분기 | dm_scan_plat(), 조건부 FDT extended scan, dm_scan_other() | 선택된 driver·node를 bind; 일반적으로 각 자식 probe와 별개 |
OF_PLATDATA_INST 경로와 일반 bind 경로를 동시에 실행한다고 읽지 않는다. root 준비 중 오류가 나면 dm_init()은 해당 오류를 반환하며 FDT scan으로 진행하지 않는다.
VISUAL WALKTHROUGH
설정 분기와 scan의 시간 경계
gd->uclass_root를 설정한 다음 한쪽 분기만 실행한다.
OF_PLATDATA_INST=y
01gd->uclass_root = &uclass_head
02dm_setup_inst()
03DM_DEVICE_GET(root)를 root pointer에 연결
04실패하면 그 오류 반환
일반 bind 경로
01uclass list head 선택·초기화
02device_bind_by_name(NULL, root_info, …)
03OF_CONTROL이면 root ofnode 연결
04device_probe(root)
dm_init_and_scan()이 두 작업의 호출 경계를 만든다.
dm_init() 안
01중복 root 거부
02uclass head와 root pointer 준비
03일반 분기에서 root 자체를 probe
일반 경로의 dm_scan() 이후
01일반 분기에서 platform table bind
02OF_REAL이면 FDT node bind
03다른 special device scan
04필요한 child probe는 후속 경로
UPSTREAM SOURCE
원본 코드
아래 코드는 U-Boot v2026.07의 drivers/core/root.c에서 70-158줄을 그대로 가져온 것이다.
70 /* Allocate the udevice_rt table */
71 each_size = dm_udevice_size();
72 start = ll_entry_start(struct udevice, udevice);
73 end = ll_entry_end(struct udevice, udevice);
74 size = end - start;
75 n_ents = size / each_size;
76 urt = calloc(n_ents, sizeof(struct udevice_rt));
77 if (!urt)
78 return log_msg_ret("urt", -ENOMEM);
79 gd_set_dm_udevice_rt(urt);
80
81 /* Now allocate space for the priv/plat data, and copy it in */
82 size = __priv_data_end - __priv_data_start;
83
84 base = calloc(1, size);
85 if (!base)
86 return log_msg_ret("priv", -ENOMEM);
87 memcpy(base, __priv_data_start, size);
88 gd_set_dm_priv_base(base);
89 }
90
91 return 0;
92}
93
94int dm_init(bool of_live)
95{
96 int ret;
97
98 if (gd->dm_root) {
99 dm_warn("Virtual root driver already exists!\n");
100 return -EINVAL;
101 }
102 if (CONFIG_IS_ENABLED(OF_PLATDATA_INST)) {
103 gd->uclass_root = &uclass_head;
104 } else {
105 gd->uclass_root = &DM_UCLASS_ROOT_S_NON_CONST;
106 INIT_LIST_HEAD(DM_UCLASS_ROOT_NON_CONST);
107 }
108
109 if (CONFIG_IS_ENABLED(OF_PLATDATA_INST)) {
110 ret = dm_setup_inst();
111 if (ret) {
112 log_debug("dm_setup_inst() failed: %d\n", ret);
113 return ret;
114 }
115 } else {
116 ret = device_bind_by_name(NULL, false, &root_info,
117 &DM_ROOT_NON_CONST);
118 if (ret)
119 return ret;
120 if (CONFIG_IS_ENABLED(OF_CONTROL))
121 dev_set_ofnode(DM_ROOT_NON_CONST, ofnode_root());
122 ret = device_probe(DM_ROOT_NON_CONST);
123 if (ret)
124 return ret;
125 }
126
127 INIT_LIST_HEAD((struct list_head *)&gd->dmtag_list);
128
129 return 0;
130}
131
132int dm_uninit(void)
133{
134 /* Remove non-vital devices first */
135 device_remove(dm_root(), DM_REMOVE_NON_VITAL);
136 device_remove(dm_root(), DM_REMOVE_NORMAL);
137 device_unbind(dm_root());
138 gd->dm_root = NULL;
139
140 return 0;
141}
142
143#if CONFIG_IS_ENABLED(DM_DEVICE_REMOVE)
144int dm_remove_devices_flags(uint flags)
145{
146 device_remove(dm_root(), flags);
147
148 return 0;
149}
150
151void dm_remove_devices_active(void)
152{
153 /* Remove non-vital devices first */
154 device_remove(dm_root(), DM_REMOVE_ACTIVE_ALL | DM_REMOVE_NON_VITAL);
155 device_remove(dm_root(), DM_REMOVE_ACTIVE_ALL);
156}
157#endif
158
READING CONTRACT
발췌 범위와 읽기 기준
원본 발췌는 dm_setup_inst()의 끝과 dm_init() 전체, 뒤의 remove 함수 시작을 포함한다. 먼저 중복 root 검사, uclass head 설정, 두 root 분기의 순서를 비교한다.
FDT 자식 bind는 이 발췌 뒤의 dm_scan_fdt()와 dm_init_and_scan()까지 읽어야 한다. 발췌 첫 줄을 dm_init() 시작으로 해석하지 않는다.
DETAILS
root pointer가 유효해지는 시점
기존 root를 입력으로 받지 않는다
dm_init()은 gd->dm_root가 이미 있으면 경고를 내고 -EINVAL을 반환한다. 함수 이름 앞에 root pointer를 선행 단계로 놓으면 진입 조건이 반대로 보인다.
uclass head를 먼저 선택한다
정적 instance 설정에서는 uclass_head를 가리키고, 일반 경로에서는 DM_UCLASS_ROOT_S_NON_CONST를 가리킨 뒤 list head를 초기화한다. 이 head를 준비했다고 모든 uclass 객체나 자식 장치가 생성된 것은 아니다.
root 구성은 두 갈래다
OF_PLATDATA_INST는 dm_setup_inst()에서 정적 root device를 연결한다. 일반 경로는 device_bind_by_name()이 root를 만들고, OF_CONTROL이면 root ofnode를 붙인 뒤 device_probe()한다.
FDT scan은 별도 호출이다
dm_init_and_scan()은 root 초기화 성공 후 정적 instance 설정이 아닐 때 dm_scan()을 호출한다. 그 안의 platform table scan과 조건부 dm_extended_scan()이 자식을 bind한다. dm_scan_fdt()는 이미 준비된 gd->dm_root를 부모로 받는다.
bind와 probe를 따로 관찰한다
일반 경로에서 root 자체는 dm_init() 안에서 probe하지만, FDT 자식 scan은 먼저 장치를 bind한다. 모든 자식이 이 지점에서 하드웨어 초기화까지 끝났다고 해석하지 않는다.
오류 후 잔존 상태: dm_setup_inst()는 root pointer를 먼저 연결한 뒤 조건부 runtime table·private 영역을 할당한다. 뒤의 할당 실패가 root 연결까지 자동 취소하지 않는다. dm_uninit()은 remove/unbind의 반환값을 검사하지 않고 root를 NULL로 만든다. 또한 DM_DEVICE_REMOVE가 꺼지면 두 함수는 stub이므로 root 포인터 초기화만 보고 모든 자원이 해제됐다고 판단하지 않는다.
dm_init_and_scan()의 마지막에는 DM_EVENT 설정 시 POST_INIT_F 또는 POST_INIT_R 알림이 있다. 정적 instance 경로가 scan을 건너뛰어도 이 알림은 별개이며, event 오류 역시 반환될 수 있다.
IMPLEMENTATION NOTES
uclass·relocation·오류 경계
root tree와 uclass list는 별개 색인
root는 parent-child 관계의 출발점이고 uclass head는 기능별 장치 목록의 출발점이다. head가 준비된 뒤에도 각 uclass와 child는 해당 bind 경로에서 생긴다. 부모 연결과 uclass 연결은 장치별 bind/unbind 코드에서 확인한다.
pre-relocation scan은 대상이 제한된다
dm_scan(pre_reloc_only)은 platform table, 조건부 FDT, other scan에 flag를 전달한다. relocation 전후 어떤 driver/node가 bind되는지는 이 flag와 해당 빌드 설정에 달려 있다. root 초기화가 모든 자식의 출현을 뜻하지 않는다.
오류 반환과 정리 범위를 구분한다
dm_setup_inst(), root bind 또는 root probe 오류는 dm_init()에서 그대로 반환한다. 이 함수 안에 모든 중간 상태를 되돌리는 공통 cleanup 경로는 없다. dm_uninit()은 별도 호출로 device remove·unbind 뒤 gd->dm_root = NULL을 만든다.
OBJECT LIFETIME
초기화와 scan에서 만나는 객체
| 대상 | 설정 시점 | 역할 | 검증할 조건 |
|---|---|---|---|
gd->uclass_root | dm_init()의 root 구성 전 | uclass head pointer | OF_PLATDATA_INST에 따른 두 선택 |
gd->dm_root | 정적 instance 연결 또는 root bind | driver model tree의 부모 | 중복 진입 거부, root bind/probe 반환값 |
| root ofnode | 일반 경로의 OF_CONTROL 조건부 | root와 DT node 연결 | ofnode 연결과 자식 FDT scan을 구분 |
gd->dmtag_list | root 분기 성공 뒤 | DM tag list head | 앞 단계 오류면 초기화 줄까지 오지 않음 |
child udevice | 후속 platform/FDT/other scan | root 아래 bound device | bind와 실제 probe의 시점 차이 |
FAILURE PATH
순서를 잘못 읽으면 놓치는 실패 지점
| 조건 | 고정 코드의 결과 | 먼저 볼 지점 |
|---|---|---|
진입 때 gd->dm_root가 이미 있음 | -EINVAL; 두 번째 root를 bind하지 않음 | dm_init() 첫 검사 |
| 정적 instance 준비 실패 | dm_setup_inst() 오류 반환 | instance/RT allocation 설정 |
| 일반 root bind 또는 probe 실패 | 해당 오류를 반환; 자식 scan 전 중단 | device_bind_by_name()/device_probe() |
| root 성공 뒤 platform/FDT scan 실패 | dm_init_and_scan()이 scan 오류 반환 | dm_scan_plat()/dm_extended_scan() |
of_live 매개변수가 있다는 이유만으로 이 함수 안에 OF_LIVE 선택 분기가 있다고 가정하지 않는다. 실제 ofnode 연결은 OF_CONTROL 조건, FDT scan은 OF_REAL 조건으로 추적한다.
EVIDENCE
빌드와 실행 상태의 읽기 전용 확인
동일한 v2026.07 소스와 실제 보드 설정을 대조한다. 다음 명령은 driver model을 수정하지 않는다.
| 목적 | 명령 또는 자료 | 판정 기준 |
|---|---|---|
| 빌드 설정 | 빌드 호스트의 .config에서 CONFIG_OF_PLATDATA_INST, CONFIG_OF_CONTROL, CONFIG_OF_REAL을 확인 | 실제로 택한 root·scan 분기를 판별한다. |
| ELF 함수명 | ${CROSS_COMPILE}nm -n u-boot | grep -E ' dm_init$| dm_init_and_scan$' | C 선언 문자열 대신 symbol 이름의 존재와 주소를 확인한다. |
| 런타임 tree | 해당 명령이 포함된 보드에서 dm tree와 dm uclass | root 및 child/uclass 목록을 관찰한다. 출력만으로 probe 완료를 단정하지 않는다. |
| 고정 호출 순서 | root.c의 dm_init_and_scan(), dm_scan(), dm_scan_fdt() | root 생성과 FDT bind의 함수 경계를 확인한다. |
LAB
초기화와 자식 scan을 분리해 관찰
- 01중복 init 진입 기록
dm_init()진입 직전의gd->dm_root와 반환값을 계측한다. root가 있으면-EINVAL인지 확인하고 의도 없이 두 번째 tree가 생성됐다고 해석하지 않는다. - 02설정별 root 준비 경로 대조
정적 instance 빌드와 일반 bind 빌드의
uclass_root선택, root pointer 설정, 일반 분기의 probe 호출을 소스와 로그로 비교한다. - 03scan 전후 child 수 비교
일반 경로에서
dm_init()직후와dm_scan()직후의 child bind 수를 구분해 기록한다.pre_reloc_only와OF_REAL설정을 함께 표시한다.
PRIMARY REFERENCES