Technologic Systems NBUS | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

ts-nbus.txt:1-50

GPIO로 구성한 NBUS data/control line과 주소별 peripheral child 노드를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Technologic Systems NBUS

3 The NBUS is a bus used to interface with peripherals in the Technologic

4 Systems FPGA on the TS-4600 SoM.

6 Required properties :

7 - compatible : "technologic,ts-nbus"

8 - #address-cells : must be 1

9 - #size-cells : must be 0

10 - pwms : The PWM bound to the FPGA

11 - ts,data-gpios : The 8 GPIO pins connected to the data lines on the FPGA

12 - ts,csn-gpios : The GPIO pin connected to the csn line on the FPGA

13 - ts,txrx-gpios : The GPIO pin connected to the txrx line on the FPGA

14 - ts,strobe-gpios : The GPIO pin connected to the stobe line on the FPGA

15 - ts,ale-gpios : The GPIO pin connected to the ale line on the FPGA

16 - ts,rdy-gpios : The GPIO pin connected to the rdy line on the FPGA

18 Child nodes:

20 The NBUS node can contain zero or more child nodes representing peripherals

21 on the bus.

23 Example:

25 nbus {

26 compatible = "technologic,ts-nbus";

27 pinctrl-0 = <&nbus_pins>;

28 #address-cells = <1>;

29 #size-cells = <0>;

30 pwms = <&pwm 2 83>;

31 ts,data-gpios = <&gpio0 0 GPIO_ACTIVE_HIGH

32 &gpio0 1 GPIO_ACTIVE_HIGH

33 &gpio0 2 GPIO_ACTIVE_HIGH

34 &gpio0 3 GPIO_ACTIVE_HIGH

35 &gpio0 4 GPIO_ACTIVE_HIGH

36 &gpio0 5 GPIO_ACTIVE_HIGH

37 &gpio0 6 GPIO_ACTIVE_HIGH

38 &gpio0 7 GPIO_ACTIVE_HIGH>;

39 ts,csn-gpios = <&gpio0 16 GPIO_ACTIVE_HIGH>;

40 ts,txrx-gpios = <&gpio0 24 GPIO_ACTIVE_HIGH>;

41 ts,strobe-gpios = <&gpio0 25 GPIO_ACTIVE_HIGH>;

42 ts,ale-gpios = <&gpio0 26 GPIO_ACTIVE_HIGH>;

43 ts,rdy-gpios = <&gpio0 21 GPIO_ACTIVE_HIGH>;

45 watchdog@2a {

46 compatible = "...";

48 /* ... */

49 };

50 };

3. 한국어 전문 번역

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

Technologic Systems NBUS 속성

1-22

Technologic Systems NBUS

NBUS는 TS-4600 SoM의 Technologic Systems FPGA 안에 있는 peripheral과 interface하기 위한 bus입니다.

필수 `compatible`은 `technologic,ts-nbus`, `#address-cells`는 1, `#size-cells`는 0입니다. `pwms`는 FPGA에 연결된 PWM을 지정합니다.

`ts,data-gpios`는 FPGA data line에 연결된 GPIO 8개를 지정합니다. `ts,csn-gpios`, `ts,txrx-gpios`, `ts,strobe-gpios`, `ts,ale-gpios`, `ts,rdy-gpios`는 각각 FPGA의 csn, txrx, strobe, ale, rdy line에 연결된 GPIO를 지정합니다.

NBUS 노드는 bus의 peripheral을 나타내는 child node를 0개 이상 포함할 수 있습니다.

NBUS FPGA 신호 연결

PWMFPGA timing source

8 data GPIOs8-bit data bus

csn + txrxChip select와 방향

strobe + ale + rdy전송 제어 신호

NBUS childFPGA peripheral address

PWM과 GPIO 묶음이 NBUS transaction 신호를 구성합니다.

NBUS GPIO와 watchdog 예

23-50

예제는 GPIO0의 0-7번 line을 data bus로 사용하고 별도 GPIO를 csn, txrx, strobe, ale, rdy 신호에 연결한 뒤 주소 0x2a의 watchdog child를 배치합니다.

nbus {
        compatible = "technologic,ts-nbus";
        pinctrl-0 = <&nbus_pins>;
        #address-cells = <1>;
        #size-cells = <0>;
        pwms = <&pwm 2 83>;
        ts,data-gpios   = <&gpio0 0 GPIO_ACTIVE_HIGH
                           &gpio0 1 GPIO_ACTIVE_HIGH
                           &gpio0 2 GPIO_ACTIVE_HIGH
                           &gpio0 3 GPIO_ACTIVE_HIGH
                           &gpio0 4 GPIO_ACTIVE_HIGH
                           &gpio0 5 GPIO_ACTIVE_HIGH
                           &gpio0 6 GPIO_ACTIVE_HIGH
                           &gpio0 7 GPIO_ACTIVE_HIGH>;
        ts,csn-gpios    = <&gpio0 16 GPIO_ACTIVE_HIGH>;
        ts,txrx-gpios   = <&gpio0 24 GPIO_ACTIVE_HIGH>;
        ts,strobe-gpios = <&gpio0 25 GPIO_ACTIVE_HIGH>;
        ts,ale-gpios    = <&gpio0 26 GPIO_ACTIVE_HIGH>;
        ts,rdy-gpios    = <&gpio0 21 GPIO_ACTIVE_HIGH>;

        watchdog@2a {
                compatible = "...";

                /* ... */
        };
};