mirror of
https://github.com/edk2-porting/linux-next.git
synced 2024-12-23 12:43:55 +08:00
c98be0c96d
Fixed multiple spelling errors. Acked-by: Randy Dunlap <rdunlap@infradead.org> Signed-off-by: Carlos E. Garcia <carlos@cgarcia.org> Signed-off-by: Jiri Kosina <jkosina@suse.cz>
396 lines
11 KiB
Plaintext
396 lines
11 KiB
Plaintext
===================================================================
|
|
Debug Control and Status Register (DCSR) Binding
|
|
Copyright 2011 Freescale Semiconductor Inc.
|
|
|
|
NOTE: The bindings described in this document are preliminary and subject
|
|
to change. Some of the compatible strings that contain only generic names
|
|
may turn out to be inappropriate, or need additional properties to describe
|
|
the integration of the block with the rest of the chip.
|
|
|
|
=====================================================================
|
|
Debug Control and Status Register Memory Map
|
|
|
|
Description
|
|
|
|
This node defines the base address and range for the
|
|
defined DCSR Memory Map. Child nodes will describe the individual
|
|
debug blocks defined within this memory space.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include "fsl,dcsr" and "simple-bus".
|
|
The DCSR space exists in the memory-mapped bus.
|
|
|
|
- #address-cells
|
|
Usage: required
|
|
Value type: <u32>
|
|
Definition: A standard property. Defines the number of cells
|
|
or representing physical addresses in child nodes.
|
|
|
|
- #size-cells
|
|
Usage: required
|
|
Value type: <u32>
|
|
Definition: A standard property. Defines the number of cells
|
|
or representing the size of physical addresses in
|
|
child nodes.
|
|
|
|
- ranges
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
range of the DCSR space.
|
|
|
|
EXAMPLE
|
|
dcsr: dcsr@f00000000 {
|
|
#address-cells = <1>;
|
|
#size-cells = <1>;
|
|
compatible = "fsl,dcsr", "simple-bus";
|
|
ranges = <0x00000000 0xf 0x00000000 0x01008000>;
|
|
};
|
|
|
|
=====================================================================
|
|
Event Processing Unit
|
|
|
|
This node represents the region of DCSR space allocated to the EPU
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include "fsl,dcsr-epu"
|
|
|
|
- interrupts
|
|
Usage: required
|
|
Value type: <prop_encoded-array>
|
|
Definition: Specifies the interrupts generated by the EPU.
|
|
The value of the interrupts property consists of three
|
|
interrupt specifiers. The format of the specifier is defined
|
|
by the binding document describing the node's interrupt parent.
|
|
|
|
The EPU counters can be configured to assert the performance
|
|
monitor interrupt signal based on either counter overflow or value
|
|
match. Which counter asserted the interrupt is captured in an EPU
|
|
Counter Interrupt Status Register (EPCPUISR).
|
|
|
|
The EPU unit can also be configured to assert either or both of
|
|
two interrupt signals based on debug event sources within the SoC.
|
|
The interrupt signals are epu_xt_int0 and epu_xt_int1.
|
|
Which event source asserted the interrupt is captured in an EPU
|
|
Interrupt Status Register (EPISR0,EPISR1).
|
|
|
|
Interrupt numbers are listed in order (perfmon, event0, event1).
|
|
|
|
- interrupt-parent
|
|
Usage: required
|
|
Value type: <phandle>
|
|
Definition: A single <phandle> value that points
|
|
to the interrupt parent to which the child domain
|
|
is being mapped. Value must be "&mpic"
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-epu@0 {
|
|
compatible = "fsl,dcsr-epu";
|
|
interrupts = <52 2 0 0
|
|
84 2 0 0
|
|
85 2 0 0>;
|
|
interrupt-parent = <&mpic>;
|
|
reg = <0x0 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|
|
Nexus Port Controller
|
|
|
|
This node represents the region of DCSR space allocated to the NPC
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include "fsl,dcsr-npc"
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
The Nexus Port controller occupies two regions in the DCSR space
|
|
with distinct functionality.
|
|
|
|
The first register range describes the Nexus Port Controller
|
|
control and status registers.
|
|
|
|
The second register range describes the Nexus Port Controller
|
|
internal trace buffer. The NPC trace buffer is a small memory buffer
|
|
which stages the nexus trace data for transmission via the Aurora port
|
|
or to a DDR based trace buffer. In some configurations the NPC trace
|
|
buffer can be the only trace buffer used.
|
|
|
|
|
|
EXAMPLE
|
|
dcsr-npc {
|
|
compatible = "fsl,dcsr-npc";
|
|
reg = <0x1000 0x1000 0x1000000 0x8000>;
|
|
};
|
|
|
|
=======================================================================
|
|
Nexus Concentrator
|
|
|
|
This node represents the region of DCSR space allocated to the NXC
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include "fsl,dcsr-nxc"
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-nxc@2000 {
|
|
compatible = "fsl,dcsr-nxc";
|
|
reg = <0x2000 0x1000>;
|
|
};
|
|
=======================================================================
|
|
CoreNet Debug Controller
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the CoreNet Debug controller.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include "fsl,dcsr-corenet"
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
The CoreNet Debug controller occupies two regions in the DCSR space
|
|
with distinct functionality.
|
|
|
|
The first register range describes the CoreNet Debug Controller
|
|
functionalty to perform transaction and transaction attribute matches.
|
|
|
|
The second register range describes the CoreNet Debug Controller
|
|
functionalty to trigger event notifications and debug traces.
|
|
|
|
EXAMPLE
|
|
dcsr-corenet {
|
|
compatible = "fsl,dcsr-corenet";
|
|
reg = <0x8000 0x1000 0xB0000 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|
|
Data Path Debug controller
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the DPAA Debug Controller. This controller controls debug configuration
|
|
for the QMAN and FMAN blocks.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include both an identifier specific to the SoC
|
|
or Debug IP of the form "fsl,<soc>-dcsr-dpaa" in addition to the
|
|
generic compatible string "fsl,dcsr-dpaa".
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-dpaa@9000 {
|
|
compatible = "fsl,p4080-dcsr-dpaa", "fsl,dcsr-dpaa";
|
|
reg = <0x9000 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|
|
OCeaN Debug controller
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the OCN Debug Controller.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include both an identifier specific to the SoC
|
|
or Debug IP of the form "fsl,<soc>-dcsr-ocn" in addition to the
|
|
generic compatible string "fsl,dcsr-ocn".
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-ocn@11000 {
|
|
compatible = "fsl,p4080-dcsr-ocn", "fsl,dcsr-ocn";
|
|
reg = <0x11000 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|
|
DDR Controller Debug controller
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the OCN Debug Controller.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include "fsl,dcsr-ddr"
|
|
|
|
- dev-handle
|
|
Usage: required
|
|
Definition: A phandle to associate this debug node with its
|
|
component controller.
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-ddr@12000 {
|
|
compatible = "fsl,dcsr-ddr";
|
|
dev-handle = <&ddr1>;
|
|
reg = <0x12000 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|
|
Nexus Aurora Link Controller
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the NAL Controller.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include both an identifier specific to the SoC
|
|
or Debug IP of the form "fsl,<soc>-dcsr-nal" in addition to the
|
|
generic compatible string "fsl,dcsr-nal".
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-nal@18000 {
|
|
compatible = "fsl,p4080-dcsr-nal", "fsl,dcsr-nal";
|
|
reg = <0x18000 0x1000>;
|
|
};
|
|
|
|
|
|
=======================================================================
|
|
Run Control and Power Management
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the RCPM Debug Controller. This functionlity is limited to the
|
|
control the debug operations of the SoC and cores.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include both an identifier specific to the SoC
|
|
or Debug IP of the form "fsl,<soc>-dcsr-rcpm" in addition to the
|
|
generic compatible string "fsl,dcsr-rcpm".
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-rcpm@22000 {
|
|
compatible = "fsl,p4080-dcsr-rcpm", "fsl,dcsr-rcpm";
|
|
reg = <0x22000 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|
|
Core Service Bridge Proxy
|
|
|
|
This node represents the region of DCSR space allocated to
|
|
the Core Service Bridge Proxies.
|
|
There is one Core Service Bridge Proxy device for each CPU in the system.
|
|
This functionlity provides access to the debug operations of the CPU.
|
|
|
|
PROPERTIES
|
|
|
|
- compatible
|
|
Usage: required
|
|
Value type: <string>
|
|
Definition: Must include both an identifier specific to the cpu
|
|
of the form "fsl,dcsr-<cpu>-sb-proxy" in addition to the
|
|
generic compatible string "fsl,dcsr-cpu-sb-proxy".
|
|
|
|
- cpu-handle
|
|
Usage: required
|
|
Definition: A phandle to associate this debug node with its cpu.
|
|
|
|
- reg
|
|
Usage: required
|
|
Value type: <prop-encoded-array>
|
|
Definition: A standard property. Specifies the physical address
|
|
offset and length of the DCSR space registers of the device
|
|
configuration block.
|
|
|
|
EXAMPLE
|
|
dcsr-cpu-sb-proxy@40000 {
|
|
compatible = "fsl,dcsr-e500mc-sb-proxy",
|
|
"fsl,dcsr-cpu-sb-proxy";
|
|
cpu-handle = <&cpu0>;
|
|
reg = <0x40000 0x1000>;
|
|
};
|
|
dcsr-cpu-sb-proxy@41000 {
|
|
compatible = "fsl,dcsr-e500mc-sb-proxy",
|
|
"fsl,dcsr-cpu-sb-proxy";
|
|
cpu-handle = <&cpu1>;
|
|
reg = <0x41000 0x1000>;
|
|
};
|
|
|
|
=======================================================================
|