Device Tree: compatible 목록에서 드라이버가 고르는 정보

이 코드는 어떤 문제를 푸나요?

Device Tree는 보드에 어떤 장치가 있고 어떤 주소·인터럽트·전원 자원을 사용하는지 설명합니다. 드라이버는 compatible 등으로 자신이 다룰 수 있는 장치를 찾습니다. __of_match_node 전체를 보면 단순히 이름이 같은 첫 항목을 반환하는 것이 아니라 호환성 점수를 비교해 가장 적합한 항목을 고릅니다.

읽을 범위: v6.18.37 · drivers/of/base.c · __of_match_node 1072–1092행입니다. 아래에 이 범위의 원문과 각 줄의 설명을 실었습니다. 주제 전체의 흐름과 다른 경로는 기존 분석에서 함께 읽으실 수 있습니다.

먼저 알아둘 개념

노드와 장치

device_node는 하드웨어 설명의 한 노드입니다. 모든 노드가 독립된 실행 중 드라이버 객체와 일대일로 대응하는 것은 아닙니다.

compatible

하드웨어 호환성을 나타내는 문자열 목록입니다. 더 구체적인 모델과 그보다 일반적인 호환 모델을 함께 표현할 수 있습니다.

매칭 표

드라이버의 of_device_id 배열은 지원하는 장치 정보를 담습니다. 끝은 name·type·compatible이 모두 비어 있는 항목으로 표시합니다.

match data

선택된 표 항목의 data 포인터에는 모델별 설정을 연결할 수 있습니다. 매칭 함수가 돌려주는 항목 자체를 보존하는 이유입니다.

처음 읽을 때

Device Tree를 실행 코드로 보지 말고 장치 설명으로 읽으십시오. compatible 매칭은 드라이버 후보를 정하는 과정이며 전원을 켜거나 레지스터를 설정하는 probe가 이미 실행됐다는 뜻은 아닙니다.

더 깊이 살펴볼 때

점수가 더 클 때만 best_match를 바꾸므로 동점에서 기존 선택이 유지됩니다. 이 내부 함수의 호출자는 트리 접근 보호 조건을 갖춰야 하며 공개 of_match_node의 잠금 처리와 나누어 읽는 것이 좋습니다.

그림으로 보는 변화

GIF 재생1단계 · 멈춰 보기2단계 · 멈춰 보기3단계 · 멈춰 보기

1단계 고정

GIF 원본 열기

1. 장치 설명을 읽습니다

노드의 compatible 등과 드라이버의 매칭 표가 준비됩니다.

화살표는 노드의 설명을 매칭 함수가 읽는 참조 관계입니다.

2. 후보를 비교합니다

표의 끝 표시까지 각 항목의 호환성 점수를 계산합니다.

화살표는 배열 항목을 순회하는 순서이며 MMIO 접근 순서가 아닙니다.

3. 가장 적합한 항목을 반환합니다

점수가 가장 높은 항목을 반환하고, 호환 항목이 없으면 NULL입니다.

화살표는 선택한 설정 항목이 드라이버 매칭 경로에 전달되는 방향입니다.

__of_match_node를 한 줄씩 읽기

줄 번호는 v6.18.37 원문 기준입니다. 주석·빈 줄을 포함한 함수 전체를 먼저 보고, 그 아래에서 각 줄을 설명합니다.

static
const struct of_device_id *__of_match_node(const struct of_device_id *matches,
					   const struct device_node *node)
{
	const struct of_device_id *best_match = NULL;
	int score, best_score = 0;

	if (!matches)
		return NULL;

	for (; matches->name[0] || matches->type[0] || matches->compatible[0]; matches++) {
		score = __of_device_is_compatible(node, matches->compatible,
						  matches->type, matches->name);
		if (score > best_score) {
			best_match = matches;
			best_score = score;
		}
	}

	return best_match;
}

static

const struct of_device_id *__of_match_node(const struct of_device_id *matches,

					   const struct device_node *node)

	const struct of_device_id *best_match = NULL;

	int score, best_score = 0;

	if (!matches)

		return NULL;

	for (; matches->name[0] || matches->type[0] || matches->compatible[0]; matches++) {

		score = __of_device_is_compatible(node, matches->compatible,

						  matches->type, matches->name);

		if (score > best_score) {

			best_match = matches;

			best_score = score;

	return best_match;

함께 생각해 볼 질문

출처와 읽은 범위

Linux stable v6.18.37 · drivers/of/base.c

해당 버전 원본 파일 · 기존 코드 분석 · 설명 원고