← Documents Documentation/devicetree/bindings/pinctrl/lantiq,pinctrl-falcon.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Lantiq FALCON Pinmux Controller

FALCON mux group과 pull·drive·slew pin configuration binding입니다.

Source pathDocumentation/devicetree/bindings/pinctrl/lantiq,pinctrl-falcon.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

lantiq,pinctrl-falcon.txt:1-83

Content 기반 하위 노드 처리와 ASC·NTR·I2C·reset 기본 상태를 정리합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 Lantiq FALCON pinmux controller
2
3 Required properties:
4 - compatible: "lantiq,pinctrl-falcon"
5 - reg: Should contain the physical address and length of the gpio/pinmux
6 register range
7
8 Please refer to pinctrl-bindings.txt in this directory for details of the
9 common pinctrl bindings used by client devices, including the meaning of the
10 phrase "pin configuration node".
11
12 Lantiq's pin configuration nodes act as a container for an arbitrary number of
13 subnodes. Each of these subnodes represents some desired configuration for a
14 pin, a group, or a list of pins or groups. This configuration can include the
15 mux function to select on those group(s), and two pin configuration parameters:
16 pull-up and open-drain
17
18 The name of each subnode is not important as long as it is unique; all subnodes
19 should be enumerated and processed purely based on their content.
20
21 Each subnode only affects those parameters that are explicitly listed. In
22 other words, a subnode that lists a mux function but no pin configuration
23 parameters implies no information about any pin configuration parameters.
24 Similarly, a pin subnode that describes a pullup parameter implies no
25 information about e.g. the mux function.
26
27 We support 2 types of nodes.
28
29 Definition of mux function groups:
30
31 Required subnode-properties:
32 - lantiq,groups : An array of strings. Each string contains the name of a group.
33 Valid values for these names are listed below.
34 - lantiq,function: A string containing the name of the function to mux to the
35 group. Valid values for function names are listed below.
36
37 Valid values for group and function names:
38
39 mux groups:
40 por, ntr, ntr8k, hrst, mdio, bootled, asc0, spi, spi cs0, spi cs1, i2c,
41 jtag, slic, pcm, asc1
42
43 functions:
44 rst, ntr, mdio, led, asc, spi, i2c, jtag, slic, pcm
45
46
47 Definition of pin configurations:
48
49 Required subnode-properties:
50 - lantiq,pins : An array of strings. Each string contains the name of a pin.
51 Valid values for these names are listed below.
52
53 Optional subnode-properties:
54 - lantiq,pull: Integer, representing the pull-down/up to apply to the pin.
55 0: none, 1: down
56 - lantiq,drive-current: Boolean, enables drive-current
57 - lantiq,slew-rate: Boolean, enables slew-rate
58
59 Example:
60 pinmux0 {
61 compatible = "lantiq,pinctrl-falcon";
62 pinctrl-names = "default";
63 pinctrl-0 = <&state_default>;
64
65 state_default: pinmux {
66 asc0 {
67 lantiq,groups = "asc0";
68 lantiq,function = "asc";
69 };
70 ntr {
71 lantiq,groups = "ntr8k";
72 lantiq,function = "ntr";
73 };
74 i2c {
75 lantiq,groups = "i2c";
76 lantiq,function = "i2c";
77 };
78 hrst {
79 lantiq,groups = "hrst";
80 lantiq,function = "rst";
81 };
82 };
83 };
84

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Lantiq FALCON controller 속성

1-10

Lantiq FALCON pinmux controller의 필수 `compatible` 값은 `lantiq,pinctrl-falcon`입니다. `reg`에는 GPIO/pinmux register 범위의 물리 주소와 길이를 지정합니다.

Client device가 사용하는 공통 pinctrl binding과 `pin configuration node`의 의미는 같은 directory의 `pinctrl-bindings.txt`를 참조합니다.

FALCON configuration container

11-25

Lantiq pin configuration node는 임의 개수의 하위 노드를 담는 container입니다. 각 하위 노드는 pin, group, pin 목록 또는 group 목록에 원하는 configuration을 나타냅니다. 구성에는 group의 mux function과 pull-up, open-drain pin parameter가 포함될 수 있습니다.

하위 노드 이름은 고유하기만 하면 중요하지 않으며 내용만으로 열거하고 처리해야 합니다. 각 하위 노드는 명시한 parameter에만 영향을 줍니다. Mux function만 나열하면 pin configuration parameter는 지정하지 않은 것이고, pull-up만 설명하면 mux function에는 아무 정보도 주지 않은 것입니다.

FALCON mux group과 function

26-45

첫 노드 유형은 mux function group을 정의합니다. 필수 `lantiq,groups`는 group 이름 문자열 배열이고, 필수 `lantiq,function`은 해당 group으로 mux할 function 이름 문자열입니다.

유효한 FALCON mux group과 function의 전체 목록입니다.

mux groups:
  por, ntr, ntr8k, hrst, mdio, bootled, asc0, spi, spi cs0, spi cs1, i2c,
  jtag, slic, pcm, asc1

functions:
  rst, ntr, mdio, led, asc, spi, i2c, jtag, slic, pcm

FALCON pin configuration

46-58

둘째 노드 유형은 pin configuration을 정의합니다. 필수 `lantiq,pins`는 pin 이름 문자열 배열입니다.

선택 `lantiq,pull`은 pin의 pull-down/up을 나타내는 정수로 0은 none, 1은 down입니다. Boolean `lantiq,drive-current`와 `lantiq,slew-rate`는 각각 drive current와 slew rate를 활성화합니다.

FALCON 기본 pinmux 예제

59-83

예제의 기본 상태는 ASC0, NTR 8kHz, I2C, hardware reset group을 각각 `asc`, `ntr`, `i2c`, `rst` function으로 mux합니다.

pinmux0 {
        compatible = "lantiq,pinctrl-falcon";
        pinctrl-names = "default";
        pinctrl-0 = <&state_default>;

        state_default: pinmux {
                asc0 {
                        lantiq,groups = "asc0";
                        lantiq,function = "asc";
                };
                ntr {
                        lantiq,groups = "ntr8k";
                        lantiq,function = "ntr";
                };
                i2c {
                        lantiq,groups = "i2c";
                        lantiq,function = "i2c";
                };
                hrst {
                        lantiq,groups = "hrst";
                        lantiq,function = "rst";
                };
        };
};