요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
* palmas device tree bindings
The TI palmas family current members :-
twl6035 (palmas)
twl6037 (palmas)
tps65913 (palmas)
tps65914 (palmas)
tps659038
tps65917
Required properties:
- compatible : Should be from the list
ti,twl6035
ti,twl6036
ti,twl6037
ti,tps65913
ti,tps65914
ti,tps80036
ti,tps659038
ti,tps65917
and also the generic series names
ti,palmas
- interrupt-controller : palmas has its own internal IRQs
- #interrupt-cells : should be set to 2 for IRQ number and flags
The first cell is the IRQ number.
The second cell is the flags, encoded as the trigger masks from
Documentation/devicetree/bindings/interrupt-controller/interrupts.txt
Optional properties:
ti,mux-padX : set the pad register X (1-2) to the correct muxing for the
hardware, if not set will use muxing in OTP.
Example:
palmas {
compatible = "ti,twl6035", "ti,palmas";
reg = <0x48>
interrupt-parent = <&intc>;
interrupt-controller;
#interrupt-cells = <2>;
ti,mux-pad1 = <0>;
ti,mux-pad2 = <0>;
#address-cells = <1>;
#size-cells = <0>;
pmic {
compatible = "ti,twl6035-pmic", "ti,palmas-pmic";
....
};
}
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
TI Palmas 계열
1-10TI Palmas 계열의 현재 구성원은 TWL6035(Palmas), TWL6037(Palmas), TPS65913(Palmas), TPS65914(Palmas), TPS659038, TPS65917입니다.
호환 문자열과 IRQ controller
11-28`compatible`은 `ti,twl6035`, `ti,twl6036`, `ti,twl6037`, `ti,tps65913`, `ti,tps65914`, `ti,tps80036`, `ti,tps659038`, `ti,tps65917` 중 하나와 generic series 이름 `ti,palmas`를 사용할 수 있습니다. 원문의 계열 구성원 목록에는 없지만 호환 목록에는 `ti,twl6036`과 `ti,tps80036`도 포함됩니다.
Palmas는 내부 IRQ를 가지므로 `interrupt-controller`가 필요합니다. `#interrupt-cells`는 IRQ 번호와 flags를 위한 2이며 첫 cell은 IRQ 번호, 둘째 cell은 `Documentation/devicetree/bindings/interrupt-controller/interrupts.txt`의 trigger mask로 인코딩한 flags입니다.
두 cell interrupt specifier의 의미입니다.
Pad mux 선택 속성
29-32선택 속성 `ti,mux-padX`는 X가 1 또는 2인 pad register를 하드웨어에 맞게 muxing합니다. 지정하지 않으면 OTP에 저장된 muxing을 사용합니다.
Palmas PMIC 예제
33-52예제는 `ti,twl6035`와 `ti,palmas`를 함께 지정하고 I2C 주소 `0x48`, 상위 interrupt controller, 두 cell IRQ domain, 두 pad mux 값을 구성합니다. PMIC 자식은 `ti,twl6035-pmic`과 `ti,palmas-pmic`에 호환됩니다.
palmas {
compatible = "ti,twl6035", "ti,palmas";
reg = <0x48>
interrupt-parent = <&intc>;
interrupt-controller;
#interrupt-cells = <2>;
ti,mux-pad1 = <0>;
ti,mux-pad2 = <0>;
#address-cells = <1>;
#size-cells = <0>;
pmic {
compatible = "ti,twl6035-pmic", "ti,palmas-pmic";
....
};
}
요약과 해설
palmas.txt:1-52계열 이름과 generic `ti,palmas`, 두 cell IRQ, OTP pad mux fallback을 설명합니다.