요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
dtbs_check와 dtc warning
maintainer-soc-clean-dts.rst:14-27해당 architecture와 platform의 dtbs, dt_binding_check와 dtbs_check를 실행해 DT schema error를 없애고 dtc warning도 남기지 않는다. Binding, SoC dtsi와 board dts를 같은 series에서 일관되게 갱신하고 known warning을 새 file로 복제하지 않는다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
.. SPDX-License-Identifier: GPL-2.0
==============================================
SoC Platforms with DTS Compliance Requirements
==============================================
Overview
--------
SoC platforms or subarchitectures should follow all the rules from
Documentation/process/maintainer-soc.rst. This document referenced in
MAINTAINERS impose additional requirements listed below.
Strict DTS DT Schema and dtc Compliance
---------------------------------------
No changes to the SoC platform Devicetree sources (DTS files) should introduce
new ``make dtbs_check W=1`` warnings. Warnings in a new board DTS, which are
results of issues in an included DTSI file, are considered existing, not new
warnings. For series split between different trees (DT bindings go via driver
subsystem tree), warnings on linux-next are decisive. The platform maintainers
have automation in place which should point out any new warnings.
If a commit introducing new warnings gets accepted somehow, the resulting
issues shall be fixed in reasonable time (e.g. within one release) or the
commit reverted.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
DTS 정합성 요구 사항이 있는 SoC platform
1-12SoC platform 또는 subarchitecture는 Documentation/process/maintainer-soc.rst의 모든 규칙을 따라야 한다. MAINTAINERS에서 이 문서를 참조하는 경우에는 아래에 나열된 추가 요구 사항도 적용된다.
엄격한 DTS DT Schema 및 dtc 정합성
14-26SoC platform Devicetree source, 즉 DTS 파일의 변경으로 새로운 make dtbs_check W=1 warning이 생겨서는 안 된다. 새 board DTS에서 발생한 warning이 include한 DTSI 파일의 기존 문제 때문에 생긴 것이라면 새로운 warning이 아니라 기존 warning으로 간주한다.
Patch series가 서로 다른 tree로 나뉘는 경우, 예를 들어 DT binding이 driver subsystem tree를 통해 들어가는 경우에는 linux-next에서 나타나는 warning을 기준으로 판단한다. Platform maintainer는 새 warning을 지적하는 자동화 절차를 운용한다.
새 warning을 만드는 commit이 어떤 이유로든 받아들여졌다면, 그 문제는 합리적인 기간 안에, 예를 들어 release 하나가 지나기 전에 수정해야 한다. 그렇지 않으면 해당 commit을 revert해야 한다.
새 platform은 깨끗한 DTS에서 시작한다
maintainer-soc-clean-dts.rst:4-13오래된 platform의 기존 warning을 이유로 새 SoC에 schema violation을 추가하지 않는다. 새 platform과 board DTS는 merge 시점부터 current binding을 따르고 warning 없이 validation되는 기준을 목표로 한다.