FDT scan과 ofnode

QUESTION

FDT scan과 ofnode 단계에서 실제로 바뀌는 상태는 무엇인가?

STRUCTURE

객체와 주소가 놓이는 구조

CALL PATH

실행 흐름

STATE LEDGER

단계별 입력과 출력

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

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

UPSTREAM SOURCE

원본 코드

아래 코드는 U-Boot v2026.07의 drivers/core/root.c에서 172-260줄을 그대로 가져온 것이다. 설명을 위해 실제 코드를 가짜 의사 코드로 바꾸지 않았다.

172	}
173
174	ret = lists_bind_drivers(DM_ROOT_NON_CONST, pre_reloc_only);
175	if (ret == -ENOENT) {
176		dm_warn("Some drivers were not found\n");
177		ret = 0;
178	}
179
180	return ret;
181}
182
183#if CONFIG_IS_ENABLED(OF_REAL)
184/**
185 * dm_scan_fdt_node() - Scan the device tree and bind drivers for a node
186 *
187 * This scans the subnodes of a device tree node and and creates a driver
188 * for each one.
189 *
190 * @parent: Parent device for the devices that will be created
191 * @node: Node to scan
192 * @pre_reloc_only: If true, bind only drivers with the DM_FLAG_PRE_RELOC
193 * flag. If false bind all drivers.
194 * Return: 0 if OK, -ve on error
195 */
196static int dm_scan_fdt_node(struct udevice *parent, ofnode parent_node,
197			    bool pre_reloc_only)
198{
199	int ret = 0, err = 0;
200	ofnode node;
201
202	if (!ofnode_valid(parent_node))
203		return 0;
204
205	for (node = ofnode_first_subnode(parent_node);
206	     ofnode_valid(node);
207	     node = ofnode_next_subnode(node)) {
208		const char *node_name = ofnode_get_name(node);
209
210		if (!ofnode_is_enabled(node)) {
211			pr_debug("   - ignoring disabled device\n");
212			continue;
213		}
214		err = lists_bind_fdt(parent, node, NULL, NULL, pre_reloc_only);
215		if (err && !ret) {
216			ret = err;
217			dm_warn("%s: ret=%d\n", node_name, ret);
218		}
219	}
220
221	if (ret)
222		dm_warn("Some drivers failed to bind\n");
223
224	return ret;
225}
226
227int dm_scan_fdt_dev(struct udevice *dev)
228{
229	return dm_scan_fdt_node(dev, dev_ofnode(dev),
230				gd->flags & GD_FLG_RELOC ? false : true);
231}
232
233int dm_scan_fdt(bool pre_reloc_only)
234{
235	return dm_scan_fdt_node(gd->dm_root, ofnode_root(), pre_reloc_only);
236}
237
238static int dm_scan_fdt_ofnode_path(const char *path, bool pre_reloc_only)
239{
240	ofnode node;
241
242	node = ofnode_path(path);
243
244	return dm_scan_fdt_node(gd->dm_root, node, pre_reloc_only);
245}
246
247int dm_extended_scan(bool pre_reloc_only)
248{
249	int ret, i;
250	const char * const nodes[] = {
251		"/chosen",
252		"/clocks",
253		"/firmware",
254		"/reserved-memory",
255	};
256
257	ret = dm_scan_fdt(pre_reloc_only);
258	if (ret) {
259		dm_warn("dm_scan_fdt() failed: %d\n", ret);
260		return ret;

READING CONTRACT

발췌 범위와 읽기 기준

원문 172-260줄에는 앞뒤 문맥이 포함됩니다. 기준 구문 static int dm_scan_fdt_node(struct udevice *parent은 L196에 있습니다. 발췌 첫 줄을 함수 정의의 시작으로 해석하지 않습니다.

kernel에 넘길 working FDT와 U-Boot 자체 설정용 control FDT를 구분한다. SPL에서는 pre-reloc property와 빌드 옵션 때문에 보이는 node 집합도 달라진다.

DETAILS

내부 동작을 더 깊게 읽기

IMPLEMENTATION NOTES

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

OBJECT LIFETIME

객체와 수명

FAILURE PATH

실패 지점과 증상

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

EVIDENCE

소스 밖에서 확인할 증거

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

LAB

직접 확인할 실험

1. 01
   fdt print와 dm tree node 수 비교

   ofnode iteration 진입 전후에 flat/live tree의 주소·크기·반환값과 timestamp를 함께 남긴다.

2. 02
   compatible 한 글자 변경 후 bind 차이 확인

   compatible match 진입 전후에 node properties의 주소·크기·반환값과 timestamp를 함께 남긴다.

3. 03
   SPL DT와 proper DT 크기·node 목록 diff

   lists_bind_fdt 진입 전후에 driver match table의 주소·크기·반환값과 timestamp를 함께 남긴다.

PRIMARY REFERENCES

원문과 다음 글