doc/driver-model/remoteproc-framework.txt

1 # SPDX-License-Identifier: GPL-2.0+
4 # Texas Instruments Incorporated - http://www.ti.com/
7 Remote Processor Framework
11 2. How does it work - The driver
18 This is an introduction to driver-model for Remote Processors found
19 on various System on Chip(SoCs). The term remote processor is used to
20 indicate that this is not the processor on which U-Boot is operating
21 on, instead is yet another processing entity that may be controlled by
22 the processor on which we are functional.
24 The simplified model depends on a single UCLASS - UCLASS_REMOTEPROC
27 - drivers/remoteproc/rproc-uclass.c
28 - include/remoteproc.h
31 - common/cmd_remoteproc.c
37 2. How does it work - The driver
42         +-------+
43     +---+ init  |
44     |   |       | <---------------------+
45     |   +-------+                       |
48     |   +--------+                      |
50     |   |        | <----------+         |
51     |   +--------+            |         |
54     |   +----v----+   reset   |         |
55     +-> |         |    (opt)  |         |
56         |  Loaded +-----------+         |
58         +----+----+                     |
60          +---v-----+        (opt)       |
61       +->| Running |        Stop        |
62 Ping  +- |         +--------------------+
63 (opt)    +---------+
68 NOTE: It depends on the remote processor as to the exact behavior
72 allow us to start the processor(image from a EEPROM/OTP) etc.
79 Remote processor can operate on a certain firmware that maybe loaded
92 	{.compatible = "sandbox,test-processor"},
121 Considering that many platforms are yet to move to device-tree model,
135 There can be additional data that may be desired depending on the
154 		compatible = "sandbox,test-processor";
155 		remoteproc-name = "remoteproc-test-dev1";
159 		compatible = "sandbox,test-processor";
160 		internal-memory-mapped;
161 		remoteproc-name = "remoteproc-test-dev2";