Freescale Interlaken Look-Aside Controller

문서 구성

이 문서는 Freescale Interlaken Look-Aside Controller(LAC)의 device binding을 정의합니다. Copyright는 2012 Freescale Semiconductor Inc.에 있습니다.

• Interlaken Look-Aside Controller(LAC) node
• LAC node 예제
• LAC software portal node
• LAC software portal child node
• child node를 포함한 LAC SWP node 예제

LAC 전역 node

Interlaken은 폭이 좁고 속도가 빠른 channelized chip-to-chip interface입니다. Data-path device와 look-aside co-processor 사이의 상호 운용을 위해 짧은 transaction 관련 전송용 Interlaken Look-Aside protocol이 정의되었습니다. 이 protocol은 Interlaken에 기반하지만 직접 호환되지는 않으며, 별도의 동작 mode로 볼 수 있습니다.

Interlaken LA controller는 내부 platform을 Interlaken serial interface에 연결합니다. System memory에 mapping된 4KB software portal을 통해 LA command를 받아 Interlaken control word와 data word로 변환하고, TX 쪽에서 SerDes lane을 거쳐 TCAM으로 보냅니다.

LAC global register memory map에는 두 개의 4KiB 공간이 있습니다. 0x0000-0x0FFF에는 전체 register set, 즉 hypervisor version이 있고 0x1000-0x1FFF에는 그 subset이 있습니다. 앞 영역은 뒤 영역을 모두 포함하면서 partitioned software가 접근해서는 안 되는 register도 포함합니다. 두 영역은 별도 node로 표현하고, hypervisor node가 phandle로 일반 동작 node를 가리킵니다.

일반 node의 필수 string `compatible`에는 `fsl,interlaken-lac`가 들어가야 합니다. 이 node는 partitioned software에서 보호되지 않는 LAC CCSR register만 나타냅니다. Device version은 offset 0x0BF8의 LAC IP Block Revision Register `IPBRR0`로 판별합니다.

Hypervisor node의 필수 `compatible`에는 `fsl,interlaken-lac-hv`가 들어가야 합니다. 이 node는 보호된 LAC register 공간을 나타내며, hypervisor node 접근을 거부하는 partition 내부를 제외하면 필요합니다.

`fsl,non-hv-node`는 `fsl,interlaken-lac-hv` node에 필요한 phandle이며 보호되지 않은 LAC CCSR mapped register-space node를 가리킵니다. 필수 `reg`의 첫 resource는 Interlaken LAC configuration register를 나타냅니다. `interrupts`는 non-hv node에만 필요하며 Interlaken LAC error IRQ mapping을 기술합니다.

lac: lac@229000 {
        compatible = "fsl,interlaken-lac"
        reg = <0x229000 0x1000>;
        interrupts = <16 2 1 18>;
};

lac-hv@228000 {
        compatible = "fsl,interlaken-lac-hv"
        reg = <0x228000 0x1000>;
        fsl,non-hv-node = <&lac>;
};

Software portal container node

LAC는 Software Portal을 사용해 Interlaken Look-Aside(ILA) command를 받습니다. Software portal memory map은 128KB를 차지하며 cache-enabled로 사용하는 것을 전제로 합니다.

Stashing을 활성화한 경우 각 software 공간의 WIMG는 0010이어야 합니다. Stashing을 사용하지 않으면 WIMG는 0000 또는 0010일 수 있습니다.

필수 u32 `#address-cells`와 `#size-cells`는 모두 1이어야 합니다. 필수 string `compatible`에는 `fsl,interlaken-lac-portals`가 들어가야 합니다. 필수 encoded array `ranges`는 LAC portal memory 공간의 address와 length를 지정합니다.

Software portal child node

사용할 수 있는 software portal은 최대 24개이며, 각 portal에는 software portal memory-mapped 공간 안의 연속된 4KB가 필요합니다.

필수 string `compatible`에는 `fsl,interlaken-lac-portal-vX.Y`가 들어가야 합니다. X는 offset 0x0BF8의 LAC IP Block Revision Register `IPBRR0`에서 읽은 major version `IP_MJ`, Y는 minor version `IP_MN`입니다.

필수 encoded array `reg`의 첫 resource는 Interlaken LAC software portal register를 나타냅니다.

u32 `fsl,liodn`은 이 device의 logical I/O device number(LIODN)입니다. Device가 DMA를 수행할 때 IOMMU(PAMU) address table lookup에 사용하는 번호이며, u-boot가 이 property를 자동으로 추가합니다.

Software portal 예제: portal 0-9

예제는 `lac-portals` container의 cell 크기와 128KB `ranges`를 선언하고, 4KB 간격의 portal 0번부터 9번까지 각기 다른 LIODN을 배정합니다.

lac-portals {
        #address-cells = <0x1>;
        #size-cells = <0x1>;
        compatible = "fsl,interlaken-lac-portals";
        ranges = <0x0 0xf 0xf4400000 0x20000>;

        lportal0: lac-portal@0 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x204>;
                reg = <0x0 0x1000>;
        };

        lportal1: lac-portal@1000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x205>;
                reg = <0x1000 0x1000>;
        };

        lportal2: lac-portal@2000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x206>;
                reg = <0x2000 0x1000>;
        };

        lportal3: lac-portal@3000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x207>;
                reg = <0x3000 0x1000>;
        };

        lportal4: lac-portal@4000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x208>;
                reg = <0x4000 0x1000>;
        };

        lportal5: lac-portal@5000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x209>;
                reg = <0x5000 0x1000>;
        };

        lportal6: lac-portal@6000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x20A>;
                reg = <0x6000 0x1000>;
        };

        lportal7: lac-portal@7000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x20B>;
                reg = <0x7000 0x1000>;
        };

        lportal8: lac-portal@8000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x20C>;
                reg = <0x8000 0x1000>;
        };

        lportal9: lac-portal@9000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x20D>;
                reg = <0x9000 0x1000>;
        };

Software portal 예제: portal 10-17

Portal 10번부터 17번까지도 동일한 `fsl,interlaken-lac-portal-v1.0` compatible을 사용하며 register offset과 LIODN이 차례로 증가합니다.

lportal10: lac-portal@a000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x20E>;
        reg = <0xA000 0x1000>;
};

lportal11: lac-portal@b000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x20F>;
        reg = <0xB000 0x1000>;
};

lportal12: lac-portal@c000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x210>;
        reg = <0xC000 0x1000>;
};

lportal13: lac-portal@d000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x211>;
        reg = <0xD000 0x1000>;
};

lportal14: lac-portal@e000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x212>;
        reg = <0xE000 0x1000>;
};

lportal15: lac-portal@f000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x213>;
        reg = <0xF000 0x1000>;
};

lportal16: lac-portal@10000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x214>;
        reg = <0x10000 0x1000>;
};

lportal17: lac-portal@11000 {
        compatible = "fsl,interlaken-lac-portal-v1.0";
        fsl,liodn = <0x215>;
        reg = <0x11000 0x1000>;
};

Software portal 예제: 나머지 portal

마지막 부분은 0x12000부터 0x17000까지의 portal register window와 LIODN 0x216-0x21B를 선언하고 container를 닫습니다.

        lportal8: lac-portal@1200 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x216>;
                reg = <0x12000 0x1000>;
        };

        lportal19: lac-portal@13000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x217>;
                reg = <0x13000 0x1000>;
        };

        lportal20: lac-portal@14000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x218>;
                reg = <0x14000 0x1000>;
        };

        lportal21: lac-portal@15000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x219>;
                reg = <0x15000 0x1000>;
        };

        lportal22: lac-portal@16000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x21A>;
                reg = <0x16000 0x1000>;
        };

        lportal23: lac-portal@17000 {
                compatible = "fsl,interlaken-lac-portal-v1.0";
                fsl,liodn = <0x21B>;
                reg = <0x17000 0x1000>;
        };
};