blob: 9e3919df3e42aa8e19e9b754343e11b0409e6479 [file] [log] [blame]
Olivier Deprez9938c132021-04-21 11:22:23 +02001FF-A manifest binding to device tree
J-Alves2672cde2020-05-07 18:42:25 +01002========================================
Louis Mayencourt5f0fc152019-11-29 15:05:14 +00003
4This document defines the nodes and properties used to define a partition,
Olivier Deprez9938c132021-04-21 11:22:23 +02005according to the FF-A specification.
Louis Mayencourt5f0fc152019-11-29 15:05:14 +00006
7Version 1.0
8-----------
9
Louis Mayencourt31030e52020-04-08 13:04:33 +010010Partition Properties
11^^^^^^^^^^^^^^^^^^^^
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000012
13- compatible [mandatory]
14 - value type: <string>
J-Alves2672cde2020-05-07 18:42:25 +010015 - Must be the string "arm,ffa-manifest-X.Y" which specifies the major and
David Horstmann051fd6d2020-11-12 15:19:04 +000016 minor versions of the device tree binding for the FFA manifest represented
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000017 by this node. The minor number is incremented if the binding changes in a
18 backwards compatible manner.
Louis Mayencourt950ef2f2020-03-27 11:49:20 +000019
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000020 - X is an integer representing the major version number of this document.
21 - Y is an integer representing the minor version number of this document.
22
J-Alves2672cde2020-05-07 18:42:25 +010023- ffa-version [mandatory]
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000024 - value type: <u32>
25 - Must be two 16 bits values (X, Y), concatenated as 31:16 -> X,
26 15:0 -> Y, where:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +000027
Olivier Deprez9938c132021-04-21 11:22:23 +020028 - X is the major version of FF-A expected by the partition at the FFA
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000029 instance it will execute.
Olivier Deprez9938c132021-04-21 11:22:23 +020030 - Y is the minor version of FF-A expected by the partition at the FFA
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000031 instance it will execute.
32
33- uuid [mandatory]
34 - value type: <prop-encoded-array>
35 - An array consisting of 4 <u32> values, identifying the UUID of the service
36 implemented by this partition. The UUID format is described in RFC 4122.
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000037
38- id
39 - value type: <u32>
40 - Pre-allocated partition ID.
41
42- auxiliary-id
43 - value type: <u32>
44 - Pre-allocated ID that could be used in memory management transactions.
45
46- description
47 - value type: <string>
48 - Name of the partition e.g. for debugging purposes.
49
50- execution-ctx-count [mandatory]
51 - value type: <u32>
52 - Number of vCPUs that a VM or SP wants to instantiate.
Louis Mayencourt950ef2f2020-03-27 11:49:20 +000053
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000054 - In the absence of virtualization, this is the number of execution
55 contexts that a partition implements.
56 - If value of this field = 1 and number of PEs > 1 then the partition is
57 treated as UP & migrate capable.
58 - If the value of this field > 1 then the partition is treated as a MP
59 capable partition irrespective of the number of PEs.
60
61- exception-level [mandatory]
62 - value type: <u32>
63 - The target exception level for the partition:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +000064
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000065 - 0x0: EL1
66 - 0x1: S_EL0
67 - 0x2: S_EL1
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000068
69- execution-state [mandatory]
70 - value type: <u32>
71 - The target execution state of the partition:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +000072
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000073 - 0: AArch64
74 - 1: AArch32
75
76- load-address
77 - value type: <u64>
78 - Physical base address of the partition in memory. Absence of this field
79 indicates that the partition is position independent and can be loaded at
80 any address chosen at boot time.
81
82- entrypoint-offset
83 - value type: <u64>
84 - Offset from the base of the partition's binary image to the entry point of
85 the partition. Absence of this field indicates that the entry point is at
86 offset 0x0 from the base of the partition's binary.
87
88- xlat-granule [mandatory]
89 - value type: <u32>
90 - Translation granule used with the partition:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +000091
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000092 - 0x0: 4k
93 - 0x1: 16k
Louis Mayencourt31030e52020-04-08 13:04:33 +010094 - 0x2: 64k
Louis Mayencourt5f0fc152019-11-29 15:05:14 +000095
96- boot-order
97 - value type: <u32>
98 - A unique number amongst all partitions that specifies if this partition
99 must be booted before others. The partition with the smaller number will be
100 booted first.
101
102- rx-tx-buffer
103 - value type: "memory-regions" node
104 - Specific "memory-regions" nodes that describe the RX/TX buffers expected
105 by the partition.
J-Alves2672cde2020-05-07 18:42:25 +0100106 The "compatible" must be the string "arm,ffa-manifest-rx_tx-buffer".
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000107
108- messaging-method [mandatory]
109 - value type: <u32>
110 - Specifies which messaging methods are supported by the partition:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +0000111
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000112 - 0x0: direct messaging method
113 - 0x1: indirect messaging method
114 - 0x2: both direct and indirect messaging methods
Manish Pandeyd3dc3a02020-09-25 09:50:31 +0100115 - 0x3: direct messaging method with managed exit support
116 - 0x4: both messaging methods with managed exit support
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000117
118- has-primary-scheduler
119 - value type: <empty>
120 - Presence of this field indicates that the partition implements the primary
121 scheduler. If so, run-time EL must be EL1.
122
123- run-time-model
124 - value type: <u32>
125 - Run time model that the SPM must enforce for this SP:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +0000126
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000127 - 0x0: Run to completion
128 - 0x1: Preemptible
129
130- time-slice-mem
131 - value type: <empty>
132 - Presence of this field indicates that the partition doesn't expect the
133 partition manager to time slice long running memory management functions.
134
135- gp-register-num
136 - value type: <u32>
137 - Presence of this field indicates that the partition expects the
J-Alves2672cde2020-05-07 18:42:25 +0100138 ffa_init_info structure to be passed in via the specified general purpose
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000139 register.
140 The field specifies the general purpose register number but not its width.
141 The width is derived from the partition's execution state, as specified in
142 the partition properties. For example, if the number value is 1 then the
143 general-purpose register used will be x1 in AArch64 state and w1 in AArch32
144 state.
145
146- stream-endpoint-ids
147 - value type: <prop-encoded-array>
148 - List of <u32> tuples, identifying the IDs this partition is acting as
149 proxy for.
150
Louis Mayencourt31030e52020-04-08 13:04:33 +0100151Memory Regions
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000152--------------
153
154- compatible [mandatory]
155 - value type: <string>
J-Alves2672cde2020-05-07 18:42:25 +0100156 - Must be the string "arm,ffa-manifest-memory-regions".
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000157
158- description
159 - value type: <string>
160 - Name of the memory region e.g. for debugging purposes.
161
162- pages-count [mandatory]
163 - value type: <u32>
164 - Count of pages of memory region as a multiple of the translation granule
165 size
166
167- attributes [mandatory]
168 - value type: <u32>
Louis Mayencourt31030e52020-04-08 13:04:33 +0100169 - Mapping modes: ORed to get required permission
170
171 - 0x1: Read
172 - 0x2: Write
173 - 0x4: Execute
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000174
175- base-address
176 - value type: <u64>
177 - Base address of the region. The address must be aligned to the translation
178 granule size.
179 The address given may be a Physical Address (PA), Virtual Address (VA), or
J-Alves2672cde2020-05-07 18:42:25 +0100180 Intermediate Physical Address (IPA). Refer to the FFA specification for
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000181 more information on the restrictions around the address type.
182 If the base address is omitted then the partition manager must map a memory
183 region of the specified size into the partition's translation regime and
184 then communicate the region properties (including the base address chosen
185 by the partition manager) to the partition.
186
Louis Mayencourt31030e52020-04-08 13:04:33 +0100187Device Regions
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000188--------------
189
190- compatible [mandatory]
191 - value type: <string>
J-Alves2672cde2020-05-07 18:42:25 +0100192 - Must be the string "arm,ffa-manifest-device-regions".
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000193
194- description
195 - value type: <string>
196 - Name of the device region e.g. for debugging purposes.
197
198- reg [mandatory]
199 - value type: <prop-encoded-array>
200 - A (address, num-pages) pair describing the device, where:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +0000201
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000202 - address: The physical base address <u64> value of the device MMIO
203 region.
204 - num-pages: The <u32> number of pages of the region. The total size of
205 the region is this value multiplied by the translation granule size.
206
207- attributes [mandatory]
208 - value type: <u32>
Louis Mayencourt31030e52020-04-08 13:04:33 +0100209 - Mapping modes: ORed to get required permission
210
211 - 0x1: Read
212 - 0x2: Write
213 - 0x4: Execute
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000214
215- smmu-id
216 - value type: <u32>
217 - On systems with multiple System Memory Management Units (SMMUs) this
218 identifier is used to inform the partition manager which SMMU the device is
219 upstream of. If the field is omitted then it is assumed that the device is
220 not upstream of any SMMU.
221
Louis Mayencourt31030e52020-04-08 13:04:33 +0100222- stream-ids
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000223 - value type: <prop-encoded-array>
224 - A list of (id, mem-manage) pair, where:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +0000225
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000226 - id: A unique <u32> value amongst all devices assigned to the partition.
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000227
228- interrupts [mandatory]
229 - value type: <prop-encoded-array>
230 - A list of (id, attributes) pair describing the device interrupts, where:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +0000231
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000232 - id: The <u32> interrupt IDs.
Louis Mayencourt31030e52020-04-08 13:04:33 +0100233 - attributes: A <u32> value,
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000234 containing the attributes for each interrupt ID:
Louis Mayencourt950ef2f2020-03-27 11:49:20 +0000235
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000236 - Interrupt type: SPI, PPI, SGI
237 - Interrupt configuration: Edge triggered, Level triggered
238 - Interrupt security state: Secure, Non-secure
239 - Interrupt priority value
240 - Target execution context/vCPU for each SPI
241
242- exclusive-access
243 - value type: <empty>
244 - Presence of this field implies that this endpoint must be granted exclusive
David Horstmann051fd6d2020-11-12 15:19:04 +0000245 access and ownership of this device's MMIO region.
Louis Mayencourt5f0fc152019-11-29 15:05:14 +0000246
247--------------
248
Manish Pandeyd3dc3a02020-09-25 09:50:31 +0100249*Copyright (c) 2019-2021, Arm Limited and Contributors. All rights reserved.*