dt-bindings: soc/fsl: Update reserved memory binding for QBMan

Updates the QMan and BMan device tree bindings for reserved memory
nodes. This makes the reserved memory allocation compatible with
the shared-dma-pool usage.

Signed-off-by: Roy Pledge <roy.pledge@nxp.com>
Acked-by: Rob Herring <robh@kernel.org>
Signed-off-by: Li Yang <leoyang.li@nxp.com>
This commit is contained in:
Roy Pledge 2017-09-18 16:39:39 -04:00 committed by Li Yang
parent 07f86917a4
commit d21010789c
2 changed files with 26 additions and 12 deletions

View File

@ -65,8 +65,8 @@ to the respective BMan instance
BMan Private Memory Node BMan Private Memory Node
BMan requires a contiguous range of physical memory used for the backing store BMan requires a contiguous range of physical memory used for the backing store
for BMan Free Buffer Proxy Records (FBPR). This memory is reserved/allocated as a for BMan Free Buffer Proxy Records (FBPR). This memory is reserved/allocated as
node under the /reserved-memory node a node under the /reserved-memory node.
The BMan FBPR memory node must be named "bman-fbpr" The BMan FBPR memory node must be named "bman-fbpr"
@ -75,7 +75,9 @@ PROPERTIES
- compatible - compatible
Usage: required Usage: required
Value type: <stringlist> Value type: <stringlist>
Definition: Must inclide "fsl,bman-fbpr" Definition: PPC platforms: Must include "fsl,bman-fbpr"
ARM platforms: Must include "shared-dma-pool"
as well as the "no-map" property
The following constraints are relevant to the FBPR private memory: The following constraints are relevant to the FBPR private memory:
- The size must be 2^(size + 1), with size = 11..33. That is 4 KiB to - The size must be 2^(size + 1), with size = 11..33. That is 4 KiB to
@ -100,10 +102,10 @@ The example below shows a BMan FBPR dynamic allocation memory node
ranges; ranges;
bman_fbpr: bman-fbpr { bman_fbpr: bman-fbpr {
compatible = "fsl,bman-fbpr"; compatible = "shared-mem-pool";
alloc-ranges = <0 0 0x10 0>;
size = <0 0x1000000>; size = <0 0x1000000>;
alignment = <0 0x1000000>; alignment = <0 0x1000000>;
no-map;
}; };
}; };

View File

@ -60,6 +60,12 @@ are located at offsets 0xbf8 and 0xbfc
Value type: <prop-encoded-array> Value type: <prop-encoded-array>
Definition: Reference input clock. Its frequency is half of the Definition: Reference input clock. Its frequency is half of the
platform clock platform clock
- memory-regions
Usage: Required for ARM
Value type: <phandle array>
Definition: List of phandles referencing the QMan private memory
nodes (described below). The qman-fqd node must be
first followed by qman-pfdr node. Only used on ARM
Devices connected to a QMan instance via Direct Connect Portals (DCP) must link Devices connected to a QMan instance via Direct Connect Portals (DCP) must link
to the respective QMan instance to the respective QMan instance
@ -74,7 +80,9 @@ QMan Private Memory Nodes
QMan requires two contiguous range of physical memory used for the backing store QMan requires two contiguous range of physical memory used for the backing store
for QMan Frame Queue Descriptor (FQD) and Packed Frame Descriptor Record (PFDR). for QMan Frame Queue Descriptor (FQD) and Packed Frame Descriptor Record (PFDR).
This memory is reserved/allocated as a nodes under the /reserved-memory node This memory is reserved/allocated as a node under the /reserved-memory node.
For additional details about reserved memory regions see reserved-memory.txt
The QMan FQD memory node must be named "qman-fqd" The QMan FQD memory node must be named "qman-fqd"
@ -83,7 +91,9 @@ PROPERTIES
- compatible - compatible
Usage: required Usage: required
Value type: <stringlist> Value type: <stringlist>
Definition: Must inclide "fsl,qman-fqd" Definition: PPC platforms: Must include "fsl,qman-fqd"
ARM platforms: Must include "shared-dma-pool"
as well as the "no-map" property
The QMan PFDR memory node must be named "qman-pfdr" The QMan PFDR memory node must be named "qman-pfdr"
@ -92,7 +102,9 @@ PROPERTIES
- compatible - compatible
Usage: required Usage: required
Value type: <stringlist> Value type: <stringlist>
Definition: Must inclide "fsl,qman-pfdr" Definition: PPC platforms: Must include "fsl,qman-pfdr"
ARM platforms: Must include "shared-dma-pool"
as well as the "no-map" property
The following constraints are relevant to the FQD and PFDR private memory: The following constraints are relevant to the FQD and PFDR private memory:
- The size must be 2^(size + 1), with size = 11..29. That is 4 KiB to - The size must be 2^(size + 1), with size = 11..29. That is 4 KiB to
@ -117,16 +129,16 @@ The example below shows a QMan FQD and a PFDR dynamic allocation memory nodes
ranges; ranges;
qman_fqd: qman-fqd { qman_fqd: qman-fqd {
compatible = "fsl,qman-fqd"; compatible = "shared-dma-pool";
alloc-ranges = <0 0 0x10 0>;
size = <0 0x400000>; size = <0 0x400000>;
alignment = <0 0x400000>; alignment = <0 0x400000>;
no-map;
}; };
qman_pfdr: qman-pfdr { qman_pfdr: qman-pfdr {
compatible = "fsl,qman-pfdr"; compatible = "shared-dma-pool";
alloc-ranges = <0 0 0x10 0>;
size = <0 0x2000000>; size = <0 0x2000000>;
alignment = <0 0x2000000>; alignment = <0 0x2000000>;
no-map;
}; };
}; };