Samsung S3C/S5P/Exynos SPI controller

Samsung S3C/S5P/Exynos SPI schema

이 GPL-2.0 또는 BSD-2-Clause YAML schema는 Samsung S3C/S5P/Exynos SoC SPI controller를 정의합니다. Schema ID는 `http://devicetree.org/schemas/spi/samsung,spi.yaml#`, maintainer는 Krzysztof Kozlowski입니다.

모든 SPI controller node는 aliases node에 `spi{n}` 형식으로 표시해야 하며 `n`은 alias마다 고유한 번호입니다.

SoC compatible과 fallback

단독 compatible은 `google,gs101-spi`, `samsung,s3c6410-spi`, S5PV210/S5PC110용 `samsung,s5pv210-spi`, `samsung,exynos4210-spi`, `samsung,exynos5433-spi`, `samsung,exynos850-spi`, `samsung,exynosautov9-spi`, `tesla,fsd-spi` 중 하나입니다.

`samsung,exynos8895-spi`와 `samsung,exynosautov920-spi`는 첫 항목에 두고 둘째 항목에 fallback `samsung,exynos850-spi`를 둡니다. 단독 `samsung,exynos7-spi`는 deprecated입니다.

Clock, DMA와 chip-select

`clocks`와 `clock-names`는 최소 두 항목, 최대 세 항목입니다. 실제 항목 수와 이름은 뒤의 SoC별 조건에서 정합니다.

`dmas`는 정확히 두 항목이고 `dma-names`는 `tx`, `rx` 순서입니다. `interrupts`는 최대 한 항목입니다.

Boolean `no-cs-readback`은 CS line이 연결되지 않아 장치가 CS signalling에 기반해 동작하면 안 됨을 나타냅니다. `num-cs` 범위는 1~4이고 기본값은 1입니다.

SPI source clock과 공통 필수 속성

Controller에 SPI bus clock source를 선택하는 internal clock mux가 있으면 `samsung,spi-src-clk`로 구동 clock 번호를 지정할 수 있습니다. 지정하지 않으면 clock 0이 기본값입니다. `reg`는 최대 한 항목입니다.

필수 속성은 `compatible`, `clocks`, `clock-names`, `interrupts`, `reg`입니다.

Exynos5433·AutoV9 세 clock 조건

공통 `spi-controller.yaml#`을 상속합니다. Compatible에 `samsung,exynos5433-spi` 또는 `samsung,exynosautov9-spi`가 포함되면 `clocks`는 정확히 세 항목입니다.

이 두 controller의 `clock-names`는 첫째 `spi`, 둘째 `spi_busclk0`·`spi_busclk1`·`spi_busclk2`·`spi_busclk3` 중 하나, 셋째 `spi_ioclk` 순서입니다.

그 밖의 SoC 두 clock 조건

위 두 compatible이 아니면 `clocks`는 정확히 두 항목입니다. `clock-names`는 첫째 `spi`, 둘째 `spi_busclk0`·`spi_busclk1`·`spi_busclk2`·`spi_busclk3` 중 하나입니다.

`unevaluatedProperties: false`로 이 schema와 공통 SPI schema에서 평가되지 않은 추가 속성을 금지합니다.

Exynos5433 SPI와 WM5110 codec 예제

예제의 `spi@14d30000`은 `samsung,exynos5433-spi`, GIC SPI 433, PDMA0의 TX/RX channel 11·10과 `spi`, `spi_busclk0`, `spi_ioclk` 세 clock을 사용합니다. Source clock은 0이고 chip select 하나를 GPIO active-high로 구동합니다.

Chip select 0의 `wlf,wm5110` audio codec은 최대 20MHz, 두 clock, GPIO·interrupt controller 기능, microphone detection과 headphone 설정, reset·LDO enable GPIO 및 core supply들을 지정합니다. `controller-data`의 `samsung,spi-feedback-delay`는 0입니다.

#include <dt-bindings/clock/exynos5433.h>
#include <dt-bindings/clock/samsung,s2mps11.h>
#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/gpio/gpio.h>

spi@14d30000 {
    compatible = "samsung,exynos5433-spi";
    reg = <0x14d30000 0x100>;
    interrupts = <GIC_SPI 433 IRQ_TYPE_LEVEL_HIGH>;
    dmas = <&pdma0 11>, <&pdma0 10>;
    dma-names = "tx", "rx";
    #address-cells = <1>;
    #size-cells = <0>;
    clocks = <&cmu_peric CLK_PCLK_SPI1>,
             <&cmu_peric CLK_SCLK_SPI1>,
             <&cmu_peric CLK_SCLK_IOCLK_SPI1>;
    clock-names = "spi",
                  "spi_busclk0",
                  "spi_ioclk";
    samsung,spi-src-clk = <0>;
    pinctrl-names = "default";
    pinctrl-0 = <&spi1_bus>;
    num-cs = <1>;

    cs-gpios = <&gpd6 3 GPIO_ACTIVE_HIGH>;

    audio-codec@0 {
        compatible = "wlf,wm5110";
        reg = <0x0>;
        spi-max-frequency = <20000000>;
        interrupt-parent = <&gpa0>;
        interrupts = <4 IRQ_TYPE_NONE>;
        clocks = <&pmu_system_controller 0>,
                 <&s2mps13_osc S2MPS11_CLK_BT>;
        clock-names = "mclk1", "mclk2";

        gpio-controller;
        #gpio-cells = <2>;
        interrupt-controller;
        #interrupt-cells = <2>;

        wlf,micd-detect-debounce = <300>;
        wlf,micd-bias-start-time = <0x1>;
        wlf,micd-rate = <0x7>;
        wlf,micd-dbtime = <0x2>;
        wlf,micd-force-micbias;
        wlf,micd-configs = <0x0 1 0>;
        wlf,hpdet-channel = <1>;
        wlf,gpsw = <0x1>;
        wlf,inmode = <2 0 2 0>;

        wlf,reset = <&gpc0 7 GPIO_ACTIVE_HIGH>;
        wlf,ldoena = <&gpf0 0 GPIO_ACTIVE_HIGH>;

        /* core supplies */
        AVDD-supply = <&ldo18_reg>;
        DBVDD1-supply = <&ldo18_reg>;
        CPVDD-supply = <&ldo18_reg>;
        DBVDD2-supply = <&ldo18_reg>;
        DBVDD3-supply = <&ldo18_reg>;
        SPKVDDL-supply = <&ldo18_reg>;
        SPKVDDR-supply = <&ldo18_reg>;

        controller-data {
            samsung,spi-feedback-delay = <0>;
        };
    };
};