U-Boot · source analysis

Driver Model root와 uclass

driver model의 root device와 uclass 목록이 만들어지고 FDT scan의 부모가 되는 과정을 읽습니다.

U-Boot v2026.07은 이 글의 DM 소스 분석 기준이다. 실제 root 생성과 FDT scan 경로는 보드의 CONFIG_OF_*·CONFIG_DM_* 설정에 따라 확인한다.

Series
08 / 22
Baseline
v2026.07
Commit
ece349ade297
Source
drivers/core/root.c:70-158 (발췌 범위)

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를 한 단계로 합치지 않는다.

생성 전제와 공개되는 포인터

그림 1. dm_init() 내부에서 root보다 먼저 준비되는 uclass head
진입 전제초기화성공 결과
01gd->dm_root == NULL
02gd->uclass_root 선택·필요 시 list head 초기화
03dm_setup_inst() 또는 root bind·probe
04root pointer와 dmtag_list 준비
진입 검사

이미 root가 있으면 두 번째 tree를 만들지 않고 -EINVAL로 반환한다.

root는 dm_init()의 선행 입력이 아니다. 고정 root.c의 순서대로 head 설정과 root 준비를 나누었다.

root 초기화와 자식 scan은 다른 함수

그림 2. dm_init()의 실제 순서와 이후 scan 경계
root 중복 검사
uclass_root 설정
inst 또는 bind·probe
dmtag_list 초기화·return
일반 경로만: 별도 dm_scan()에서 자식 bind

마지막 칸은 dm_init() 내부가 아니다. dm_init_and_scan()은 dm_init() 성공 뒤, OF_PLATDATA_INST가 꺼져 있을 때만 dm_scan()을 호출한다. OF_REAL이면 그 안의 dm_extended_scan()이 FDT 자식을 탐색한다.

분기별 입력과 성공 뒤 상태

좁은 화면에서는 표를 좌우로 밀어 설정별 결과를 확인한다.

지점전제·조건코드가 하는 일이후 보장 범위
중복 검사gd->dm_root != NULL-EINVAL 반환새 root 또는 uclass list를 만들지 않음
uclass headroot가 비어 있음OF_PLATDATA_INST면 uclass_head, 아니면 DM_UCLASS_ROOT_S_NON_CONST 선택·list head 초기화head pointer 준비; 모든 uclass device가 생긴 것은 아님
정적 instanceOF_PLATDATA_INST 켬dm_setup_inst()가 DM_DEVICE_GET(root)를 root에 연결이 분기에서 일반 root bind·probe를 호출하지 않음
일반 rootOF_PLATDATA_INST 끔device_bind_by_name() → 조건부 dev_set_ofnode() → device_probe()root 준비; FDT 자식은 아직 scan하지 않음
후속 scandm_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으로 진행하지 않는다.

설정 분기와 scan의 시간 경계

그림 3. root 생성의 두 설정 분기

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)

그림 4. root 준비와 자식 bind·probe를 분리

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는 후속 경로

원본 코드

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

commitece349ade2973e220f524ce59e59711cc919263fanchor · L94int dm_init(bool of_live)
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

발췌 범위와 읽기 기준

원본 발췌는 dm_setup_inst()의 끝과 dm_init() 전체, 뒤의 remove 함수 시작을 포함한다. 먼저 중복 root 검사, uclass head 설정, 두 root 분기의 순서를 비교한다.

FDT 자식 bind는 이 발췌 뒤의 dm_scan_fdt()와 dm_init_and_scan()까지 읽어야 한다. 발췌 첫 줄을 dm_init() 시작으로 해석하지 않는다.

root pointer가 유효해지는 시점

01

기존 root를 입력으로 받지 않는다

dm_init()은 gd->dm_root가 이미 있으면 경고를 내고 -EINVAL을 반환한다. 함수 이름 앞에 root pointer를 선행 단계로 놓으면 진입 조건이 반대로 보인다.

02

uclass head를 먼저 선택한다

정적 instance 설정에서는 uclass_head를 가리키고, 일반 경로에서는 DM_UCLASS_ROOT_S_NON_CONST를 가리킨 뒤 list head를 초기화한다. 이 head를 준비했다고 모든 uclass 객체나 자식 장치가 생성된 것은 아니다.

03

root 구성은 두 갈래다

OF_PLATDATA_INST는 dm_setup_inst()에서 정적 root device를 연결한다. 일반 경로는 device_bind_by_name()이 root를 만들고, OF_CONTROL이면 root ofnode를 붙인 뒤 device_probe()한다.

04

FDT scan은 별도 호출이다

dm_init_and_scan()은 root 초기화 성공 후 정적 instance 설정이 아닐 때 dm_scan()을 호출한다. 그 안의 platform table scan과 조건부 dm_extended_scan()이 자식을 bind한다. dm_scan_fdt()는 이미 준비된 gd->dm_root를 부모로 받는다.

05

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 오류 역시 반환될 수 있다.

uclass·relocation·오류 경계

01

root tree와 uclass list는 별개 색인

root는 parent-child 관계의 출발점이고 uclass head는 기능별 장치 목록의 출발점이다. head가 준비된 뒤에도 각 uclass와 child는 해당 bind 경로에서 생긴다. 부모 연결과 uclass 연결은 장치별 bind/unbind 코드에서 확인한다.

02

pre-relocation scan은 대상이 제한된다

dm_scan(pre_reloc_only)은 platform table, 조건부 FDT, other scan에 flag를 전달한다. relocation 전후 어떤 driver/node가 bind되는지는 이 flag와 해당 빌드 설정에 달려 있다. root 초기화가 모든 자식의 출현을 뜻하지 않는다.

03

오류 반환과 정리 범위를 구분한다

dm_setup_inst(), root bind 또는 root probe 오류는 dm_init()에서 그대로 반환한다. 이 함수 안에 모든 중간 상태를 되돌리는 공통 cleanup 경로는 없다. dm_uninit()은 별도 호출로 device remove·unbind 뒤 gd->dm_root = NULL을 만든다.

초기화와 scan에서 만나는 객체

대상설정 시점역할검증할 조건
gd->uclass_rootdm_init()의 root 구성 전uclass head pointerOF_PLATDATA_INST에 따른 두 선택
gd->dm_root정적 instance 연결 또는 root binddriver model tree의 부모중복 진입 거부, root bind/probe 반환값
root ofnode일반 경로의 OF_CONTROL 조건부root와 DT node 연결ofnode 연결과 자식 FDT scan을 구분
gd->dmtag_listroot 분기 성공 뒤DM tag list head앞 단계 오류면 초기화 줄까지 오지 않음
child udevice후속 platform/FDT/other scanroot 아래 bound devicebind와 실제 probe의 시점 차이

순서를 잘못 읽으면 놓치는 실패 지점

조건고정 코드의 결과먼저 볼 지점
진입 때 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 조건으로 추적한다.

빌드와 실행 상태의 읽기 전용 확인

동일한 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 uclassroot 및 child/uclass 목록을 관찰한다. 출력만으로 probe 완료를 단정하지 않는다.
고정 호출 순서root.c의 dm_init_and_scan(), dm_scan(), dm_scan_fdt()root 생성과 FDT bind의 함수 경계를 확인한다.

초기화와 자식 scan을 분리해 관찰

  1. 01
    중복 init 진입 기록

    dm_init() 진입 직전의 gd->dm_root와 반환값을 계측한다. root가 있으면 -EINVAL인지 확인하고 의도 없이 두 번째 tree가 생성됐다고 해석하지 않는다.

  2. 02
    설정별 root 준비 경로 대조

    정적 instance 빌드와 일반 bind 빌드의 uclass_root 선택, root pointer 설정, 일반 분기의 probe 호출을 소스와 로그로 비교한다.

  3. 03
    scan 전후 child 수 비교

    일반 경로에서 dm_init() 직후와 dm_scan() 직후의 child bind 수를 구분해 기록한다. pre_reloc_only와 OF_REAL 설정을 함께 표시한다.

원문과 다음 글