Lines Matching +full:dts +full:- +full:bindings

1 .. _devicetree-in-out-files:
7 :ref:`devicetree-scope-purpose` in more detail.
10    :figclass: align-center
14 .. _dt-input-files:
21 - sources (``.dts``)
22 - includes (``.dtsi``)
23 - overlays (``.overlay``)
24 - bindings (``.yaml``)
28 .. code-block:: none
30   boards/<ARCH>/<BOARD>/<BOARD>.dts
31   dts/common/skeleton.dtsi
32   dts/<ARCH>/.../<SOC>.dtsi
33   dts/bindings/.../binding.yaml
35 Generally speaking, every supported board has a :file:`BOARD.dts` file
37 :zephyr_file:`boards/arm/reel_board/reel_board.dts`.
39 :file:`BOARD.dts` includes one or more ``.dtsi`` files. These ``.dtsi`` files
40 describe the CPU or system-on-chip Zephyr runs on, perhaps by including other
42 multiple boards. In addition to these includes, :file:`BOARD.dts` also describes
45 The :file:`dts/common` directory contains :file:`skeleton.dtsi`, a minimal
46 include file for defining a complete devicetree. Architecture-specific
47 subdirectories (:file:`dts/<ARCH>`) contain ``.dtsi`` files for CPUs or SoCs
52 though DTS has a ``/include/ "<filename>"`` syntax.
54 :file:`BOARD.dts` can be extended or modified using *overlays*. Overlays are
55 also DTS files; the :file:`.overlay` extension is just a convention which makes
58 - Zephyr applications can use overlays to enable a peripheral that is disabled
63 - Overlays are also used when defining :ref:`shields`.
68 :ref:`set-devicetree-overlays` for details.
70 The build system combines :file:`BOARD.dts` and any :file:`.overlay` files by
71 concatenating them, with the overlays put last. This relies on DTS syntax which
76 :file:`BOARD.dts`.
78 :ref:`dt-bindings` (which are YAML files) are essentially glue. They describe
81 applications. The :file:`dts/bindings` directory contains bindings.
83 .. _dt-scripts:
88 The following libraries and scripts, located in :zephyr_file:`scripts/dts/`,
92 :zephyr_file:`dtlib.py <scripts/dts/python-devicetree/src/devicetree/dtlib.py>`
93     A low-level DTS parsing library.
95 :zephyr_file:`edtlib.py <scripts/dts/python-devicetree/src/devicetree/edtlib.py>`
96     A library layered on top of dtlib that uses bindings to interpret
97     properties and give a higher-level view of the devicetree. Uses dtlib to do
98     the DTS parsing.
100 :zephyr_file:`gen_defines.py <scripts/dts/python-devicetree/src/devicetree/edtlib.py>`
102     devicetree and bindings.
111 .. code-block:: cmake
113    list(APPEND EXTRA_DTC_FLAGS "-Wno-simple_bus_reg")
115 .. _dt-outputs:
124    Don't include the header files directly. :ref:`dt-from-c` explains
127 :file:`<build>/zephyr/zephyr.dts.pre`
128    The preprocessed DTS source. This is an intermediate output file, which is
129    input to :file:`gen_defines.py` and used to create :file:`zephyr.dts` and
136 :file:`<build>/zephyr/zephyr.dts`