Re: [U-Boot] [PATCH 08/25] dt-bindings: remoteproc: Add bindings for R5F subsystem on TI K3 SoCs

29 Aug 2019

Hi Lokes, Suman
On 28/08/2019 2:55 PM, Lokesh Vutla wrote:
...
From: Suman Anna s-anna@ti.com
The Texas Instruments K3 family of SoCs have one of more dual-core
Arm Cortex R5F processor subsystems/clusters (R5FSS). Add the device
tree bindings document for these R5F subsystem devices. These R5F
processors do not have an MMU, and so require fixed memory carveout
regions matching the firmware image addresses. The nodes require more
than one memory region, with the first memory region used for DMA
allocations at runtime. The remaining memory regions are reserved
and are used for the loading and running of the R5F remote processors.
The added example illustrates the DT nodes for the single R5FSS device
present on K3 AM65x family of SoCs.
Signed-off-by: Suman Anna s-anna@ti.com
Signed-off-by: Lokesh Vutla lokeshvutla@ti.com

.../remoteproc/ti,k3-r5f-rproc.txt            | 164 ++++++++++++++++++
  1 file changed, 164 insertions(+)
  create mode 100644 doc/device-tree-bindings/remoteproc/ti,k3-r5f-rproc.txt

diff --git a/doc/device-tree-bindings/remoteproc/ti,k3-r5f-rproc.txt b/doc/device-tree-bindings/remoteproc/ti,k3-r5f-rproc.txt
new file mode 100644
index 0000000000..c2fa6e8344
--- /dev/null
+++ b/doc/device-tree-bindings/remoteproc/ti,k3-r5f-rproc.txt
@@ -0,0 +1,164 @@
+TI K3 R5F processor subsystems
+==============================



+The TI K3 family of SoCs usually have one or more dual-core Arm Cortex
+R5F processor subsystems/clusters (R5FSS). The dual core cluster can be
+used either in a LockStep mode providing safety/fault tolerance features
+or in a Split mode providing two individual compute cores for doubling
+the compute capacity. These are used together with other processors
+present on the SoC to achieve various system level goals.



+R5F Sub-System Device Node:
+===========================
+Each Dual-Core R5F sub-system is represented as a single DTS node representing
+the cluster, with a pair of child DT nodes representing the individual R5F
+cores. Each node has a number of required or optional properties that enable
+the OS running on the host processor to perform the device management of the
+remote processor and to communicate with the remote processor.



+Required properties:
+--------------------
+The following are the mandatory properties:



+- compatible:		Should be one of the following,

	    "ti,am654-r5fss" for R5F clusters/subsystems on


	                       K3 AM65x SoCs


	    "ti,j721e-r5fss" for R5F clusters/subsystems on


	                       K3 J721E SoCs



+- power-domains:	Should contain a phandle to a PM domain provider node

	and an args specifier containing the R5FSS device id


	value. This property is as per the binding,


	Documentation/devicetree/bindings/soc/ti/sci-pm-domain.txt



+- #address-cells:	Should be 1
+- #size-cells:		Should be 1
+- ranges:		Standard ranges definition providing translations for

	R5F TCM address spaces



Maybe dma-ranges is more appropriated here : you can find more details 
here: https://lkml.org/lkml/2019/4/3/1261
BR
Fabien
...



+Optional properties:
+--------------------
+- lockstep-mode:	Configuration Mode for the Dual R5F cores within the R5F

	cluster. Should be either a value of 1 (LockStep mode) or


	0 (Split mode), default is LockStep mode if omitted.





+R5F Processor Child Nodes:
+==========================
+The R5F Sub-System device node should define two R5F child nodes, each node
+representing a TI instantiation of the Arm Cortex R5F core. There are some
+specific integration differences for the IP like the usage of a Region Address
+Translator (RAT) for translating the larger SoC bus addresses into a 32-bit
+address space for the processor.



+Required properties:
+--------------------
+The following are the mandatory properties:



+- compatible:		Should be one of the following,

	    "ti,am654-r5f" for the R5F cores in K3 AM65x SoCs


	    "ti,j721e-r5f" for the R5F cores in K3 J721E SOCs



+- reg:			Should contain an entry for each value in 'reg-names'.

	Each entry should have the memory region's start address


	and the size of the region, the representation matching


	the parent node's '#address-cells' and '#size-cells' values.



+- reg-names:		Should contain strings with the following names, each

	representing a specific internal memory region, and


	should be defined in this order,


	     "atcm", "btcm"



+- ti,sci:		Should be a phandle to the TI-SCI System Controller node
+- ti,sci-dev-id:	Should contain the TI-SCI device id corresponding to the

	R5F Core. Please refer to the corresponding System


	Controller documentation for valid values for the R5F


	cores.



+- ti,sci-proc-ids:	Should contain 2 integer values. The first cell should

	contain the TI-SCI processor id for the R5F core device


	and the second cell should contain the TI-SCI host id to


	which the processor control ownership should be


	transferred to.



+- resets:		Should contain the phandle to the reset controller node

	managing the resets for this device, and a reset


	specifier. Please refer to the following reset bindings


	for the reset argument specifier,


	Documentation/devicetree/bindings/reset/ti,sci-reset.txt


	    for AM65x and J721E SoCs




+Optional properties:
+--------------------
+The following properties are optional properties for each of the R5F cores:



+- atcm-enable:		R5F core configuration mode dictating if ATCM should be

	enabled. Should be either a value of 1 (enabled) or


	0 (disabled), default is disabled if omitted. R5F view


	of ATCM dictated by loczrama property.



+- btcm-enable:		R5F core configuration mode dictating if BTCM should be

	enabled. Should be either a value of 1 (enabled) or


	0 (disabled), default is enabled if omitted. R5F view


	of BTCM dictated by loczrama property.



+- loczrama:		R5F core configuration mode dictating which TCM should

	appear at address 0 (from core's view). Should be either


	a value of 1 (ATCM at 0x0) or 0 (BTCM at 0x0), default


	value is 1 if omitted.




+Example:
+--------
+1. AM654 SoC

/* AM65x remoteproc alias */
aliases {
remoteproc0 = &mcu_r5fss0_core0;


};

cbass_main: interconnect@100000 {
compatible = "simple-bus";


#address-cells = <2>;


#size-cells = <2>;


ranges = <0x00 0x41000000 0x00 0x41000000 0x00 0x00020000>,


	 <0x00 0x41400000 0x00 0x41400000 0x00 0x00020000>,


	 <0x00 0x41c00000 0x00 0x41c00000 0x00 0x00080000>;



cbass_mcu: interconnect@28380000 {


	compatible = "simple-bus";


	#address-cells = <2>;


	#size-cells = <2>;


	ranges = <0x00 0x41000000 0x00 0x41000000 0x00 0x00020000>, /* MCU R5F Core0 */


		 <0x00 0x41400000 0x00 0x41400000 0x00 0x00020000>, /* MCU R5F Core1 */


		 <0x00 0x41c00000 0x00 0x41c00000 0x00 0x00080000>; /* MCU SRAM */



	/* AM65x MCU R5FSS node */


	mcu_r5fss0: r5fss@41000000 {


		compatible = "ti,am654-r5fss";


		power-domains = <&k3_pds 129>;


		lockstep-mode = <1>;


		#address-cells = <1>;


		#size-cells = <1>;


		ranges = <0x41000000 0x00 0x41000000 0x20000>,


			 <0x41400000 0x00 0x41400000 0x20000>;



		mcu_r5f0: r5f@41000000 {


			compatible = "ti,am654-r5f";


			reg = <0x41000000 0x00008000>,


			      <0x41010000 0x00008000>;


			reg-names = "atcm", "btcm";


			ti,sci = <&dmsc>;


			ti,sci-dev-id = <159>;


			ti,sci-proc-ids = <0x01 0xFF>;


			resets = <&k3_reset 159 1>;


			atcm-enable = <1>;


			btcm-enable = <1>;


			loczrama = <1>;


		};



		mcu_r5f1: r5f@41400000 {


			compatible = "ti,am654-r5f";


			reg = <0x41400000 0x00008000>,


			      <0x41410000 0x00008000>;


			reg-names = "atcm", "btcm";


			ti,sci = <&dmsc>;


			ti,sci-dev-id = <245>;


			ti,sci-proc-ids = <0x02 0xFF>;


			resets = <&k3_reset 245 1>;


			atcm-enable = <1>;


			btcm-enable = <1>;


			loczrama = <1>;


		};


	};


};


};


    

Re: [U-Boot] [PATCH 08/25] dt-bindings: remoteproc: Add bindings for R5F subsystem on TI K3 SoCs

Fabien DESSENNE