mirror of https://github.com/Qortal/Brooklyn
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
309 lines
8.6 KiB
309 lines
8.6 KiB
=============================================================================== |
|
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>; |
|
}; |
|
};
|
|
|