Lines Matching full:devicetree

3 Devicetree HOWTOs
6 This page has step-by-step advice for getting things done with devicetree.
10 .. _get-devicetree-outputs:
12 Get your devicetree and generated header
15 A board's devicetree (:ref:`BOARD.dts <devicetree-in-out-files>`) pulls in
17 includes the SoC's ``.dtsi``. One way to figure out the devicetree's contents
21 If you just want to see the "final" devicetree for your board, build an
26    You can build :ref:`hello_world` to see the "base" devicetree for your board
47 The :file:`zephyr.dts` file is the final devicetree in DTS format.
51 See :ref:`devicetree-in-out-files` for details about these files.
55 Get a struct device from a devicetree node
59 :ref:`struct device <device_model_api>` corresponding to a devicetree node.
61 For example, with this devicetree fragment, you might want the struct device
64 .. code-block:: devicetree
151 devicetree. In some situations your code will compile but it will fail to link
177 Find a devicetree binding
184 If you don't have them already, :ref:`get-devicetree-outputs`. To find a node's
209     * Devicetree node:
219 .. _set-devicetree-overlays:
221 Set devicetree overlays
224 Devicetree overlays are explained in :ref:`devicetree-intro`. The CMake
238 use as devicetree overlays:
251 Extra devicetree overlays may be provided using ``EXTRA_DTC_OVERLAY_FILE`` which
252 will still allow the build system to automatically use devicetree overlays
256 to the overlays in ``DTC_OVERLAY_FILE`` when processing devicetree overlays.
267 Using :ref:`shields` will also add devicetree overlay files.
272 The :ref:`build system <build_overview>` prints all the devicetree overlays it
277    -- Found devicetree overlay: .../some/file.overlay
281 Use devicetree overlays
284 See :ref:`set-devicetree-overlays` for how to add an overlay to the build.
289 .. code-block:: devicetree
319 You can add aliases to your devicetree using overlays: an alias is just a
322 .. code-block:: devicetree
332 .. code-block:: devicetree
343 .. code-block:: devicetree
352 .. code-block:: devicetree
395 Write device drivers using devicetree APIs
398 "Devicetree-aware" :ref:`device drivers <device_model_api>` should create a
399 ``struct device`` for each ``status = "okay"`` devicetree node with a
403 Writing a devicetree-aware driver begins by defining a :ref:`devicetree binding
416 After writing your binding, your driver C file can then use the devicetree API
423 - Each ``struct device``\ 's name should be set to its devicetree node's
427 - Each device's initial configuration should use values from devicetree
429   using :ref:`devicetree overlays <use-dt-overlays>`.
461 Use this option, which uses :ref:`devicetree-inst-apis`, if possible. However,
462 they only work when devicetree nodes for your driver's ``compatible`` are all
468 devicetree, you would define ``DT_DRV_COMPAT`` to ``vnd_my_device`` in your
514 :c:func:`DEVICE_DT_INST_DEFINE` to access devicetree node data. These
515 APIs retrieve data from the devicetree for instance number ``inst`` of
537 :c:func:`DT_NODELABEL` to refer to individual nodes in the devicetree
538 representing the supported peripherals on the SoC. The devicetree.h
539 :ref:`devicetree-generic-apis` can then be used to access node data.
543 your driver supports. The resulting devicetree usually looks something like
546 .. code-block:: devicetree
560 devicetree to operate on specific device nodes:
591 :c:func:`DEVICE_DT_DEFINE` to access devicetree node data.
593 Finally, manually detect each enabled devicetree node and use
619 - Write your devicetree binding in a way that permits use of
620   :ref:`devicetree-hw-api` from devicetree.h if possible.
635 supporting a devicetree alias to specify the hardware specific portions, as is
637 :ref:`BOARD.dts <devicetree-in-out-files>` files or via :ref:`devicetree