summaryrefslogtreecommitdiffstats
path: root/Documentation
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@linux-foundation.org>2015-07-03 17:57:50 -0400
committerLinus Torvalds <torvalds@linux-foundation.org>2015-07-03 17:57:50 -0400
commit2fee94b74b45681a09b1dac54cb615e02b7b30d0 (patch)
tree4388829b19e5222579c8c1aff76f9d9a2a9961cc /Documentation
parentd033ed9eeafc3bf33ce2de286ea2fb2c63e1c183 (diff)
parent8de3dbd0895bebe52d069a82feae8e3fb51c1bdf (diff)
Merge tag 'remoteproc-4.2' of git://git.kernel.org/pub/scm/linux/kernel/git/ohad/remoteproc
Pull remoteproc updates from Ohad Ben-Cohen: - remoteproc fixes/cleanups from Suman Anna - new remoteproc TI Wakeup M3 driver from Dave Gerlach - remoteproc core support for TI's Wakeup M3 driver from both Dave and Suman - tiny remoteproc build fix from myself * tag 'remoteproc-4.2' of git://git.kernel.org/pub/scm/linux/kernel/git/ohad/remoteproc: remoteproc: fix !CONFIG_OF build breakage remoteproc/wkup_m3: add a remoteproc driver for TI Wakeup M3 Documentation: dt: add bindings for TI Wakeup M3 processor remoteproc: add a rproc ops for performing address translation remoteproc: introduce rproc_get_by_phandle API remoteproc: fix various checkpatch warnings remoteproc/davinci: fix quoted split string checkpatch warning remoteproc/ste: add blank lines after declarations
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/devicetree/bindings/remoteproc/wkup_m3_rproc.txt52
-rw-r--r--Documentation/remoteproc.txt6
2 files changed, 58 insertions, 0 deletions
diff --git a/Documentation/devicetree/bindings/remoteproc/wkup_m3_rproc.txt b/Documentation/devicetree/bindings/remoteproc/wkup_m3_rproc.txt
new file mode 100644
index 000000000000..3a70073797eb
--- /dev/null
+++ b/Documentation/devicetree/bindings/remoteproc/wkup_m3_rproc.txt
@@ -0,0 +1,52 @@
1TI Wakeup M3 Remoteproc Driver
2==============================
3
4The TI AM33xx and AM43xx family of devices use a small Cortex M3 co-processor
5(commonly referred to as Wakeup M3 or CM3) to help with various low power tasks
6that cannot be controlled from the MPU. This CM3 processor requires a firmware
7binary to accomplish this. The wkup_m3 remoteproc driver handles the loading of
8the firmware and booting of the CM3.
9
10Wkup M3 Device Node:
11====================
12A wkup_m3 device node is used to represent the Wakeup M3 processor instance
13within the SoC. It is added as a child node of the parent interconnect bus
14(l4_wkup) through which it is accessible to the MPU.
15
16Required properties:
17--------------------
18- compatible: Should be one of,
19 "ti,am3352-wkup-m3" for AM33xx SoCs
20 "ti,am4372-wkup-m3" for AM43xx SoCs
21- reg: Should contain the address ranges for the two internal
22 memory regions, UMEM and DMEM. The parent node should
23 provide an appropriate ranges property for properly
24 translating these into bus addresses.
25- reg-names: Contains the corresponding names for the two memory
26 regions. These should be named "umem" & "dmem".
27- ti,hwmods: Name of the hwmod associated with the wkupm3 device.
28- ti,pm-firmware: Name of firmware file to be used for loading and
29 booting the wkup_m3 remote processor.
30
31Example:
32--------
33/* AM33xx */
34ocp {
35 l4_wkup: l4_wkup@44c00000 {
36 compatible = "am335-l4-wkup", "simple-bus";
37 ranges = <0 0x44c00000 0x400000>;
38 #address-cells = <1>;
39 #size-cells = <1>;
40
41 wkup_m3: wkup_m3@100000 {
42 compatible = "ti,am3352-wkup-m3";
43 reg = <0x100000 0x4000>,
44 <0x180000 0x2000>;
45 reg-names = "umem", "dmem";
46 ti,hwmods = "wkup_m3";
47 ti,pm-firmware = "am335x-pm-firmware.elf";
48 };
49 };
50
51 ...
52};
diff --git a/Documentation/remoteproc.txt b/Documentation/remoteproc.txt
index e6469fdcf89a..ef0219fa4bb4 100644
--- a/Documentation/remoteproc.txt
+++ b/Documentation/remoteproc.txt
@@ -51,6 +51,12 @@ cost.
51 rproc_shutdown() returns, and users can still use it with a subsequent 51 rproc_shutdown() returns, and users can still use it with a subsequent
52 rproc_boot(), if needed. 52 rproc_boot(), if needed.
53 53
54 struct rproc *rproc_get_by_phandle(phandle phandle)
55 - Find an rproc handle using a device tree phandle. Returns the rproc
56 handle on success, and NULL on failure. This function increments
57 the remote processor's refcount, so always use rproc_put() to
58 decrement it back once rproc isn't needed anymore.
59
543. Typical usage 603. Typical usage
55 61
56#include <linux/remoteproc.h> 62#include <linux/remoteproc.h>