xref: /rk3399_ARM-atf/docs/components/fconf/fconf_properties.rst (revision b80e751d99e8a0774662b516c57ff815d025fadb)
14874793dSLouis MayencourtDTB binding for FCONF properties
24874793dSLouis Mayencourt================================
34874793dSLouis Mayencourt
44874793dSLouis MayencourtThis document describes the device tree format of |FCONF| properties. These
54874793dSLouis Mayencourtproperties are not related to a specific platform and can be queried from
64874793dSLouis Mayencourtcommon code.
74874793dSLouis Mayencourt
84874793dSLouis MayencourtDynamic configuration
94874793dSLouis Mayencourt~~~~~~~~~~~~~~~~~~~~~
104874793dSLouis Mayencourt
114874793dSLouis MayencourtThe |FCONF| framework expects a *dtb-registry* node with the following field:
124874793dSLouis Mayencourt
134874793dSLouis Mayencourt- compatible [mandatory]
144874793dSLouis Mayencourt   - value type: <string>
154874793dSLouis Mayencourt   - Must be the string "fconf,dyn_cfg-dtb_registry".
164874793dSLouis Mayencourt
174874793dSLouis MayencourtThen a list of subnodes representing a configuration |DTB|, which can be used
184874793dSLouis Mayencourtby |FCONF|. Each subnode should be named according to the information it
194874793dSLouis Mayencourtcontains, and must be formed with the following fields:
204874793dSLouis Mayencourt
214874793dSLouis Mayencourt- load-address [mandatory]
224874793dSLouis Mayencourt    - value type: <u64>
234874793dSLouis Mayencourt    - Physical loading base address of the configuration.
244874793dSLouis Mayencourt
254874793dSLouis Mayencourt- max-size [mandatory]
264874793dSLouis Mayencourt    - value type: <u32>
274874793dSLouis Mayencourt    - Maximum size of the configuration.
284874793dSLouis Mayencourt
294874793dSLouis Mayencourt- id [mandatory]
304874793dSLouis Mayencourt    - value type: <u32>
314874793dSLouis Mayencourt    - Image ID of the configuration.
324874793dSLouis Mayencourt
33*b80e751dSManish V Badarkhe- ns-load-address [optional]
34*b80e751dSManish V Badarkhe    - value type: <u64>
35*b80e751dSManish V Badarkhe    - Physical loading base address of the configuration in the non-secure
36*b80e751dSManish V Badarkhe      memory.
37*b80e751dSManish V Badarkhe      Only needed by those configuration files which require being loaded
38*b80e751dSManish V Badarkhe      in secure memory (at load-address) as well as in non-secure memory
39*b80e751dSManish V Badarkhe      e.g. HW_CONFIG
40