patrick/zephyr
1
0
Fork 0
Code Issues Pull requests Actions 8 Packages Projects Releases Wiki Activity

doc: build: dts: add CONFIG_COMPILER_TRACK_MACRO_EXPANSION

Browse source 
When debugging devicetree related issues, it may be useful to turn macro
expansion tracking off. Let's document this in the troubleshooting
section.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
This commit is contained in:
Gerard Marull-Paretas 2023-05-05 10:16:18 +02:00 committed by Carles Cufí
parent 99ebe39289
commit d45946c65d
1 changed files with 15 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

15
doc/build/dts/troubleshooting.rst vendored
View file

@ -289,6 +289,21 @@ them. For example, to use ``clang-format`` to reformat the file in place:
You can then open the file in your favorite editor to view the final C results
after preprocessing.
Do not track macro expansion
****************************
The compiler error message chain can quickly grow when making a mistake and
using devicetree macros. In some situations, the number of compiler error
messages can be overwhelming, specially because many not relevant internals are
exposed. This happens because of long macro expansion chains. You may disable
the :kconfig:option:`CONFIG_COMPILER_TRACK_MACRO_EXPANSION` option to skip macro
expansion, typically reducing the error messages to one line. For example, to
build :ref:`hello_world` with west and this option set, use:
.. code-block:: sh
west build -b BOARD samples/hello_world -- -DCONFIG_COMPILER_TRACK_MACRO_EXPANSION=n
Validate properties
*******************