Freescale PAMU

PAMU 개요

Freescale Peripheral Management Access Unit(PAMU)은 device-to-memory 접근 제어와 address translation 기능을 제공하는 I/O MMU입니다.

PAMU 필수 property

필수 string `compatible`의 첫 항목은 `fsl,pamu-v1.0` 같은 version-specific string이고 두 번째 항목은 `fsl,pamu`입니다.

필수 encoded array `ranges`는 controller가 사용하는 memory-mapped I/O 공간을 기술합니다. Size는 물리적으로 존재하는 모든 PAMU controller의 전체 register 공간 크기로 설정합니다. PAMU v1.0 device가 다섯 개인 SoC에서는 0x5000입니다.

필수 encoded array `interrupts`의 첫 tuple은 access violation 보고에 사용하는 일반 PAMU interrupt이고, 두 번째 tuple은 PAMU operation error와 ECC error 같은 hardware error용입니다.

필수 u32 `#address-cells`와 `#size-cells`는 표준 property입니다.

PAMU 선택 property

선택 encoded array `reg`는 모든 child PAMU의 CCSR register를 합친 영역을 나타냅니다. Legacy driver 지원이 필요하면 포함합니다.

선택 u32 `fsl,portid-mapping`은 PAMU를 snoop해야 할 때 설정할 CoreNet Coherency fabric(CCF) mapping-register bit를 고르는 bitmask입니다. Coherency Subdomain ID Port Mapping Register와 Snoop ID Port Mapping Register는 CoreNet Coherency Subdomain ID 또는 CoreNet Snoop ID를 PAMU에 mapping합니다.

PAMU controller child node

각 child node는 PAMU controller 하나를 나타냅니다. 특정 PAMU에 연결된 각 SoC device에는 해당 child controller로 연결하는 `fsl,pamu-phandle` property가 있어야 합니다.

Child의 표준 encoded array `reg`는 parent `ranges`에 상대적인 PAMU configuration register의 physical address와 length를 지정합니다. Size는 해당 PAMU controller register 공간 크기이며 PAMU v1.0에서는 0x1000입니다.

`fsl,primary-cache-geometry`는 primary PAMU cache geometry를 두 cell로 지정합니다. 첫 cell은 cache line 수, 두 번째 cell은 way 수입니다. Direct-mapped cache는 way를 1로 지정합니다.

`fsl,secondary-cache-geometry`도 같은 두-cell 형식으로 secondary PAMU cache의 line 수와 way 수를 지정하며 direct-mapped cache는 way 1을 사용합니다.

LIODN device node

LIODN을 가진 device는 연결된 실제 parent PAMU controller의 link와, 해당하는 경우 LIODN register pointer를 지정해야 합니다.

`fsl,iommu-parent`는 device가 연결된 단일 PAMU controller node를 가리키는 phandle입니다. Device tree의 PAMU topology는 PAMU cache thrashing을 최소화할 최적 LIODN 값을 code가 동적으로 결정하는 데 도움을 줍니다.

`fsl,liodn-reg`는 이 device의 LIODN register 위치를 두 cell로 지정하며 LIODN이 하나인 device에 필요합니다. 첫 cell은 LIODN을 설정할 register가 있는 node의 phandle이고, 두 번째 cell은 그 node의 첫 `reg` resource에서 특정 LIODN register까지의 offset입니다.

다섯 PAMU controller 예제

예제의 PAMU v1.0 container는 0x5000 register 공간과 normal·hardware-error interrupt 두 개를 선언합니다. 다섯 child PAMU는 각각 0x1000 register window, 32-line direct-mapped primary cache와 128-line 2-way secondary cache를 가집니다.

iommu@20000 {
        compatible = "fsl,pamu-v1.0", "fsl,pamu";
        reg = <0x20000 0x5000>;
        ranges = <0 0x20000 0x5000>;
        fsl,portid-mapping = <0xf80000>;
        #address-cells = <1>;
        #size-cells = <1>;
        interrupts = <
                24 2 0 0
                16 2 1 30>;

        pamu0: pamu@0 {
                reg = <0 0x1000>;
                fsl,primary-cache-geometry = <32 1>;
                fsl,secondary-cache-geometry = <128 2>;
        };

        pamu1: pamu@1000 {
                reg = <0x1000 0x1000>;
                fsl,primary-cache-geometry = <32 1>;
                fsl,secondary-cache-geometry = <128 2>;
        };

        pamu2: pamu@2000 {
                reg = <0x2000 0x1000>;
                fsl,primary-cache-geometry = <32 1>;
                fsl,secondary-cache-geometry = <128 2>;
        };

        pamu3: pamu@3000 {
                reg = <0x3000 0x1000>;
                fsl,primary-cache-geometry = <32 1>;
                fsl,secondary-cache-geometry = <128 2>;
        };

        pamu4: pamu@4000 {
                reg = <0x4000 0x1000>;
                fsl,primary-cache-geometry = <32 1>;
                fsl,secondary-cache-geometry = <128 2>;
        };
};

DMA device LIODN 예제

`global-utilities` node는 LIODN register를 포함합니다. DMA device는 `pamu0`을 IOMMU parent로 선택하고 `guts`의 첫 register resource에서 offset 0x584에 있는 `DMA2LIODNR`를 `fsl,liodn-reg`로 가리킵니다.

        guts: global-utilities@e0000 {
                compatible = "fsl,qoriq-device-config-1.0";
                reg = <0xe0000 0xe00>;
                fsl,has-rstcr;
                #sleep-cells = <1>;
                fsl,liodn-bits = <12>;
        };

/include/ "qoriq-dma-0.dtsi"
        dma@100300 {
                fsl,iommu-parent = <&pamu0>;
                fsl,liodn-reg = <&guts 0x584>; /* DMA2LIODNR */
        };