Part 1
요약·해설
Binding의 검증·semantic 역할과 Zephyr 자체 YAML 형식, 세 하위 문서의 읽기 순서를 설명합니다.
Format
Zephyr YAML
Role
요구 사항 · 의미
Linux
dt-schema 미사용
Pages
3개 안내
Part 2
접을 수 있는 영어 원문 전체
영어 원문 전체 펼치기
원문 SHA-256
C0AD91CDA44A6364722B0B7F3F1931AA381EDF0CED94EF6F65B51EB098D978B8
.. _dt-bindings:
Devicetree bindings
###################
A devicetree on its own is only half the story for describing hardware, as it
is a relatively unstructured format. *Devicetree bindings* provide the other
half.
A devicetree binding declares requirements on the contents of nodes, and
provides semantic information about the contents of valid nodes. Zephyr
devicetree bindings are YAML files in a custom format (Zephyr does not use the
dt-schema tools used by the Linux kernel).
These pages introduce bindings, describe what they do, note where they are
found, and explain their data format.
.. note::
See the :ref:`devicetree_binding_index` for reference information on
bindings built in to Zephyr.
.. toctree::
:maxdepth: 2
bindings-intro.rst
bindings-syntax.rst
bindings-upstream.rst
Part 3
한국어 전문 번역
Devicetree binding이 필요한 이유
Devicetree는 비교적 비정형적인 hardware 기술 형식이므로 그것만으로는 설명의 절반에 불과합니다. 나머지 절반을 채우는 것이 Devicetree binding입니다.
Binding은 node 내용이 만족해야 할 요구 사항을 선언하고 유효한 node의 각 값이 무엇을 뜻하는지 semantic information을 제공합니다. Zephyr binding은 자체 형식의 YAML 파일이며 Linux kernel이 사용하는 dt-schema tooling을 사용하지 않습니다.
이 문서 묶음은 binding의 개념과 역할, 검색 위치, YAML data 형식을 설명합니다. Zephyr에 내장된 개별 binding의 reference는 Devicetree binding index에서 확인합니다.
문서 순서
- Binding 소개: compatible matching, node 검증, macro 생성, 검색 경로
- Binding 문법: YAML key, property type, bus·child·include 규칙
- Upstream binding 규칙: 제출용 naming, vendor prefix, default 기준
Source
출처
원문 파일의 단락, directive, 표, 코드, symbol, 경로는 영어 원문 영역에 그대로 보존했습니다.