TI Keystone DSP remoteproc

Keystone 2 DSP subsystem

TI Keystone 2 SoC 계열에는 보통 최대 8개의 TI DSP Core subsystem이 있으며 processor 집약적인 task나 algorithm을 offload합니다.

Subsystem에는 L1/L2 cache 또는 SRAM, interrupt controller, external memory controller, 전용 local power/sleep controller 등이 포함됩니다. Keystone 2 SoC의 DSP processor core는 보통 TMS320C66x CorePac processor입니다.

DSP node와 rproc alias

각 DSP Core subsystem은 하나의 DT node로 표현하고 stem이 `rproc`인 alias도 정의해야 합니다. Required·optional property를 통해 ARM CorePac에서 실행하는 host OS가 remote processor를 관리하고 통신할 수 있습니다.

공통 필수 property

`compatible`은 66AK2H/K에서 `ti,k2hk-dsp`, 66AK2L에서 `ti,k2l-dsp`, 66AK2E에서 `ti,k2e-dsp`, 66AK2G에서 `ti,k2g-dsp`를 사용합니다.

`reg`에는 `reg-names`마다 start address와 size를 parent의 address·size cell 형식으로 넣습니다. `reg-names`는 `l2sram`, `l1pram`, `l1dram`을 이 순서로 포함해야 합니다.

`ti,syscon-dev`는 Keystone Device State Control node phandle과 그 address space 안의 DSP boot address register offset 쌍입니다.

`resets`는 device reset을 관리하는 controller phandle과 reset specifier를 담습니다. 66AK2HK·66AK2L·66AK2E는 `Documentation/devicetree/bindings/reset/ti-syscon-reset.txt`, 66AK2G는 `Documentation/devicetree/bindings/reset/ti,sci-reset.yaml`을 따릅니다.

`interrupts`에는 `interrupt-names`마다 remote processor가 host processor에 보내는 interrupt source 번호를 넣고 `interrupt-parent` 형식을 따릅니다. `interrupt-names`는 virtio IPC의 `vring`과 exception notification의 `exception`입니다.

`kick-gpios`는 virtio IPC stack이 remote processor에 interrupt를 보내는 GPIO device를 지정하며 `Documentation/devicetree/bindings/gpio/gpio-dsp-keystone.txt` binding을 따릅니다.

SoC별 필수 clock 또는 power domain

66AK2HK·66AK2L·66AK2E에서는 `clocks`에 device input clock을 넣고 `Documentation/devicetree/bindings/clock/keystone-gate.txt`를 따릅니다.

66AK2G에서는 `power-domains`에 PM domain provider phandle과 DSP device ID를 담은 args specifier를 넣고 `Documentation/devicetree/bindings/soc/ti/sci-pm-domain.yaml`을 따릅니다.

선택 reserved memory

선택 `memory-region`은 remoteproc device와 연결할 reserved memory node phandle입니다. CMA memory node일 수 있으며 `Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt` binding에 따라 정의합니다.

예제 1: 66AK2H/K DSP

첫 예제는 `rproc0`부터 `rproc7`까지 8개 DSP alias를 만들고 공용 8MiB reusable DMA pool을 정의합니다. `dsp0`은 `ti,k2hk-dsp`, `clkgem0`, `devctrl`, `pscrst`, `vring`·`exception` interrupt, kick GPIO와 공용 memory를 사용합니다.

1.
        /* 66AK2H/K DSP aliases */
        aliases {
                rproc0 = &dsp0;
                rproc1 = &dsp1;
                rproc2 = &dsp2;
                rproc3 = &dsp3;
                rproc4 = &dsp4;
                rproc5 = &dsp5;
                rproc6 = &dsp6;
                rproc7 = &dsp7;
        };

        /* 66AK2H/K DSP memory node */
        reserved-memory {
                #address-cells = <2>;
                #size-cells = <2>;
                ranges;

                dsp_common_memory: dsp-common-memory@81f800000 {
                        compatible = "shared-dma-pool";
                        reg = <0x00000008 0x1f800000 0x00000000 0x800000>;
                        reusable;
                };
        };

        /* 66AK2H/K DSP node */
        soc {
                dsp0: dsp@10800000 {
                        compatible = "ti,k2hk-dsp";
                        reg = <0x10800000 0x00100000>,
                              <0x10e00000 0x00008000>,
                              <0x10f00000 0x00008000>;
                        reg-names = "l2sram", "l1pram", "l1dram";
                        clocks = <&clkgem0>;
                        ti,syscon-dev = <&devctrl 0x40>;
                        resets = <&pscrst 0>;
                        interrupt-parent = <&kirq0>;
                        interrupts = <0 8>;
                        interrupt-names = "vring", "exception";
                        kick-gpios = <&dspgpio0 27 0>;
                        memory-region = <&dsp_common_memory>;
                };

        };

예제 2: 66AK2G DSP

두 번째 예제는 `rproc0` 하나와 같은 크기의 공용 memory를 정의합니다. `dsp0`은 `ti,k2g-dsp`, `k2g_pds` power domain과 `k2g_reset`을 사용하며 나머지 interrupt·kick GPIO·memory 연결은 첫 예제와 같은 구조입니다.

2.
        /* 66AK2G DSP alias */
        aliases {
                rproc0 = &dsp0;
        };

        /* 66AK2G DSP memory node */
        reserved-memory {
                #address-cells = <2>;
                #size-cells = <2>;
                ranges;

                dsp_common_memory: dsp-common-memory@81f800000 {
                        compatible = "shared-dma-pool";
                        reg = <0x00000008 0x1f800000 0x00000000 0x800000>;
                        reusable;
                };
        };

        /* 66AK2G DSP node */
        soc {
                dsp0: dsp@10800000 {
                        compatible = "ti,k2g-dsp";
                        reg = <0x10800000 0x00100000>,
                              <0x10e00000 0x00008000>,
                              <0x10f00000 0x00008000>;
                        reg-names = "l2sram", "l1pram", "l1dram";
                        power-domains = <&k2g_pds 0x0046>;
                        ti,syscon-dev = <&devctrl 0x40>;
                        resets = <&k2g_reset 0x0046 0x1>;
                        interrupt-parent = <&kirq0>;
                        interrupts = <0 8>;
                        interrupt-names = "vring", "exception";
                        kick-gpios = <&dspgpio0 27 0>;
                        memory-region = <&dsp_common_memory>;
                };
        };