| =============================================================================== |
| Freescale Interlaken Look-Aside Controller Device Bindings |
| Copyright 2012 Freescale Semiconductor Inc. |
| |
| CONTENTS |
| - Interlaken Look-Aside Controller (LAC) Node |
| - Example LAC Node |
| - Interlaken Look-Aside Controller (LAC) Software Portal Node |
| - Interlaken Look-Aside Controller (LAC) Software Portal Child Nodes |
| - Example LAC SWP Node with Child Nodes |
| |
| ============================================================================== |
| Interlaken Look-Aside Controller (LAC) Node |
| |
| DESCRIPTION |
| |
| The Interlaken is a narrow, high speed channelized chip-to-chip interface. To |
| facilitate interoperability between a data path device and a look-aside |
| co-processor, the Interlaken Look-Aside protocol is defined for short |
| transaction-related transfers. Although based on the Interlaken protocol, |
| Interlaken Look-Aside is not directly compatible with Interlaken and can be |
| considered a different operation mode. |
| |
| The Interlaken LA controller connects internal platform to Interlaken serial |
| interface. It accepts LA command through software portals, which are system |
| memory mapped 4KB spaces. The LA commands are then translated into the |
| Interlaken control words and data words, which are sent on TX side to TCAM |
| through SerDes lanes. |
| |
| There are two 4KiB spaces defined within the LAC global register memory map. |
| There is a full register set at 0x0000-0x0FFF (also known as the "hypervisor" |
| version), and a subset at 0x1000-0x1FFF. The former is a superset of the |
| latter, and includes certain registers that should not be accessible to |
| partitioned software. Separate nodes are used for each region, with a phandle |
| linking the hypervisor node to the normal operating node. |
| |
| PROPERTIES |
| |
| - compatible |
| Usage: required |
| Value type: <string> |
| Definition: Must include "fsl,interlaken-lac". This represents only |
| those LAC CCSR registers not protected in partitioned |
| software. The version of the device is determined by the LAC |
| IP Block Revision Register (IPBRR0) at offset 0x0BF8. |
| |
| Table of correspondences between IPBRR0 values and example |
| chips: |
| Value Device |
| ----------- ------- |
| 0x02000100 T4240 |
| |
| The Hypervisor node has a different compatible. It must include |
| "fsl,interlaken-lac-hv". This node represents the protected |
| LAC register space and is required except inside a partition |
| where access to the hypervisor node is to be denied. |
| |
| - fsl,non-hv-node |
| Usage: required in "fsl,interlaken-lac-hv" |
| Value type: <phandle> |
| Definition: Points to the non-protected LAC CCSR mapped register space |
| node. |
| |
| - reg |
| Usage: required |
| Value type: <prop-encoded-array> |
| Definition: A standard property. The first resource represents the |
| Interlaken LAC configuration registers. |
| |
| - interrupts: |
| Usage: required in non-hv node only |
| Value type: <prop-encoded-array> |
| Definition: Interrupt mapping for Interlaken LAC error IRQ. |
| |
| EXAMPLE |
| 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>; |
| }; |
| |
| =============================================================================== |
| Interlaken Look-Aside Controller (LAC) Software Portal Container Node |
| |
| DESCRIPTION |
| The Interlaken Look-Aside Controller (LAC) utilizes Software Portals to accept |
| Interlaken Look-Aside (ILA) commands. The Interlaken LAC software portal |
| memory map occupies 128KB of memory space. The software portal memory space is |
| intended to be cache-enabled. WIMG for each software space is required to be |
| 0010 if stashing is enabled; otherwise, WIMG can be 0000 or 0010. |
| |
| PROPERTIES |
| |
| - #address-cells |
| Usage: required |
| Value type: <u32> |
| Definition: A standard property. Must have a value of 1. |
| |
| - #size-cells |
| Usage: required |
| Value type: <u32> |
| Definition: A standard property. Must have a value of 1. |
| |
| - compatible |
| Usage: required |
| Value type: <string> |
| Definition: Must include "fsl,interlaken-lac-portals" |
| |
| - ranges |
| Usage: required |
| Value type: <prop-encoded-array> |
| Definition: A standard property. Specifies the address and length |
| of the LAC portal memory space. |
| |
| =============================================================================== |
| Interlaken Look-Aside Controller (LAC) Software Portals Child Nodes |
| |
| DESCRIPTION |
| There are up to 24 available software portals with each software portal |
| requiring 4KB of consecutive memory within the software portal memory mapped |
| space. |
| |
| PROPERTIES |
| |
| - compatible |
| Usage: required |
| Value type: <string> |
| Definition: Must include "fsl,interlaken-lac-portal-vX.Y" where X is |
| the Major version (IP_MJ) found in the LAC IP Block Revision |
| Register (IPBRR0), at offset 0x0BF8, and Y is the Minor version |
| (IP_MN). |
| |
| Table of correspondences between version values and example chips: |
| Value Device |
| ------ ------- |
| 1.0 T4240 |
| |
| - reg |
| Usage: required |
| Value type: <prop-encoded-array> |
| Definition: A standard property. The first resource represents the |
| Interlaken LAC software portal registers. |
| |
| - fsl,liodn |
| Value type: <u32> |
| Definition: The logical I/O device number (LIODN) for this device. The |
| LIODN is a number expressed by this device and used to perform |
| look-ups in the IOMMU (PAMU) address table when performing |
| DMAs. This property is automatically added by u-boot. |
| |
| =============================================================================== |
| EXAMPLE |
| |
| 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>; |
| }; |
| |
| 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>; |
| }; |
| |
| 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>; |
| }; |
| }; |
