Driver Model root와 uclass

QUESTION

Driver Model root와 uclass 단계에서 실제로 바뀌는 상태는 무엇인가?

STRUCTURE

객체와 주소가 놓이는 구조

CALL PATH

실행 흐름

STATE LEDGER

단계별 입력과 출력

각 단계의 입력과 처리 후 바뀌는 상태를 정리한 표다. 사용 중인 소스 버전에서 다른 필드를 변경한다면 그에 맞춰 표도 수정한다.

분석 범위의 전제와 비교해, 다음 단계에 잘못된 입력을 넘긴 부분부터 조사한다.

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

발췌 범위와 읽기 기준

원문 70-158줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 int dm_init(bool of_live)은 L94에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.

struct udevice와 하드웨어의 동작 시작 시점은 같지 않다. 루트 생성, 드라이버 연결(bind), 초기화(probe)를 구분해 객체가 언제 만들어지고 사용되는지 확인한다.

DETAILS

내부 동작을 더 깊게 읽기

IMPLEMENTATION NOTES

구현을 읽을 때 놓치기 쉬운 부분

OBJECT LIFETIME

객체와 수명

FAILURE PATH

실패 지점과 증상

로그가 끊긴 함수뿐 아니라 그 함수에 주소, 크기, 플래그를 전달한 앞 단계도 조사한다. 오류 처리 후 등록된 객체나 하드웨어 설정이 그대로 남아 있는지도 확인한다.

EVIDENCE

소스 밖에서 확인할 증거

소스에서 파악한 동작을 실제 빌드 결과와 대상 보드의 로그로 확인한다. 아래 명령의 보드 이름과 툴체인 접두사는 사용 중인 빌드 환경에 맞게 바꾼다.

LAB

직접 확인할 실험

1. 01
   dm tree 명령으로 bind/probe 상태 비교

   dm_init 진입 전후에 DM root의 주소·크기·반환값과 timestamp를 함께 남긴다.

2. 02
   dm_init 전후 gd 포인터 출력

   root device 진입 전후에 uclass registry의 주소·크기·반환값과 timestamp를 함께 남긴다.

3. 03
   OF_LIVE on/off에서 node 경로 대조

   uclass list 진입 전후에 device tree nodes의 주소·크기·반환값과 timestamp를 함께 남긴다.

PRIMARY REFERENCES

원문과 다음 글