diff options
author | Petr Kubizňák <kubiznak@2n.com> | 2023-05-09 16:03:58 +0200 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2023-05-26 17:32:50 +0100 |
commit | 4417a30196b0cac1d9dc83b23e7fd5719b8ebc2d (patch) | |
tree | 6ef1f651e33d31f5cbadd16a1467f8ce324f9418 /documentation/ref-manual/variables.rst | |
parent | fd567483808bca68048bcba098703cf7c51b9946 (diff) | |
download | poky-4417a30196b0cac1d9dc83b23e7fd5719b8ebc2d.tar.gz |
ref-manual: document devicetree class variables
Document the newly added DT_FILES variable and closely related
DT_FILES_PATH. Also add DT_PADDING_SIZE to the glossary.
(From yocto-docs rev: 8f3f187e2353c718c6fb4e224d13ba559ad2f85b)
Signed-off-by: Petr Kubizňák <kubiznak@2n.com>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/variables.rst')
-rw-r--r-- | documentation/ref-manual/variables.rst | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 6ee65e1788..4b69843d4d 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -2247,6 +2247,28 @@ system and gives an overview of their function and contents. | |||
2247 | For information on policies and on how to use this variable, see the | 2247 | For information on policies and on how to use this variable, see the |
2248 | comments in the ``meta/classes-recipe/compress_doc.bbclass`` file. | 2248 | comments in the ``meta/classes-recipe/compress_doc.bbclass`` file. |
2249 | 2249 | ||
2250 | :term:`DT_FILES` | ||
2251 | Space-separated list of device tree source files to compile using | ||
2252 | a recipe that inherits the :ref:`ref-classes-devicetree` class. These | ||
2253 | are relative to the :term:`DT_FILES_PATH`. | ||
2254 | |||
2255 | For convenience, both ``.dts`` and ``.dtb`` extensions can be used. | ||
2256 | |||
2257 | Use an empty string (default) to build all device tree sources within | ||
2258 | the :term:`DT_FILES_PATH` directory. | ||
2259 | |||
2260 | :term:`DT_FILES_PATH` | ||
2261 | When compiling out-of-tree device tree sources using a recipe that | ||
2262 | inherits the :ref:`ref-classes-devicetree` class, this variable specifies | ||
2263 | the path to the directory containing dts files to build. | ||
2264 | |||
2265 | Defaults to the :term:`S` directory. | ||
2266 | |||
2267 | :term:`DT_PADDING_SIZE` | ||
2268 | When inheriting the :ref:`ref-classes-devicetree` class, this variable | ||
2269 | specifies the size of padding appended to the device tree blob, used as | ||
2270 | extra space typically for additional properties during boot. | ||
2271 | |||
2250 | :term:`EFI_PROVIDER` | 2272 | :term:`EFI_PROVIDER` |
2251 | When building bootable images (i.e. where ``hddimg``, ``iso``, or | 2273 | When building bootable images (i.e. where ``hddimg``, ``iso``, or |
2252 | ``wic.vmdk`` is in :term:`IMAGE_FSTYPES`), the | 2274 | ``wic.vmdk`` is in :term:`IMAGE_FSTYPES`), the |