DT: Rename from dts.fixup to dts_fixup.h

The Zephyr configuration system uses many different files in many
different formats. It makes it a lot easier for users to understand
what these files do if when we use the correct file extensions.

To this end we rename the dts.fixup files to the correct file
extension '.h'.

This is a breaking change for out-of-tree fixup files. Such files will
be detected and given an appropriate error message.

Signed-off-by: Sebastian Bøe <sebastian.boe@nordicsemi.no>

cmake/dts.cmake

@@ -42,14 +42,14 @@ foreach(shield_path ${shields_refs_list})
 
   if(${shield_config})
     # if shield config flag is on, add shield overlay to the shield overlays
-    # list and dts.fixup file to the shield fixup file
+    # list and dts_fixup file to the shield fixup file
     list(APPEND
       dts_files
       ${shield_dir}/${shield_path}
       )
     list(APPEND
       dts_fixups
-      ${shield_dir}/${shield}/dts.fixup
+      ${shield_dir}/${shield}/dts_fixup.h
       )
   endif()
 endforeach()
@@ -121,13 +121,13 @@ if(CONFIG_HAS_DTS)
 
   # Run extract_dts_includes.py for the header file
   # generated_dts_board.h
-  set_ifndef(DTS_BOARD_FIXUP_FILE ${BOARD_DIR}/dts.fixup)
-  set_ifndef(DTS_SOC_FIXUP_FILE   ${PROJECT_SOURCE_DIR}/soc/${ARCH}/${SOC_PATH}/dts.fixup)
+  set_ifndef(DTS_BOARD_FIXUP_FILE ${BOARD_DIR}/dts_fixup.h)
+  set_ifndef(DTS_SOC_FIXUP_FILE   ${PROJECT_SOURCE_DIR}/soc/${ARCH}/${SOC_PATH}/dts_fixup.h)
 
   list(APPEND dts_fixups
     ${DTS_BOARD_FIXUP_FILE}
     ${DTS_SOC_FIXUP_FILE}
-    ${APPLICATION_SOURCE_DIR}/dts.fixup
+    ${APPLICATION_SOURCE_DIR}/dts_fixup.h
     )
 
   foreach(fixup ${dts_fixups})

doc/application/application.rst

@@ -447,7 +447,7 @@ Zephyr board, and provide the following files::
     board.h
     CMakeLists.txt
     doc/
-    dts.fixup
+    dts_fixup.h
     Kconfig.board
     Kconfig.defconfig
     pinmux.c

doc/devices/dts/device_tree.rst

@@ -71,8 +71,8 @@ information is placed in a header file that is used by the rest of the code as
 the project is compiled.
 
 A temporary fixup file is required for device tree support on most devices.
-This .fixup file by default resides in the board directory and is named
-dts.fixup.  This fixup file maps the generated include information to the
+This fixup file by default resides in the board directory and is named
+dts_fixup.h.  This fixup file maps the generated include information to the
 current driver/source usage.
 
 .. _dt_vs_kconfig:

doc/porting/shields.rst

@@ -20,7 +20,7 @@ under :file:`/boards/shields`:
    ├── Kconfig.shield
    ├── Kconfig.defconfig
    ├── <shield>.overlay
-   └── dts.fixup
+   └── dts_fixup.h
 
 These files provides shield configuration as follows:
 
@@ -37,7 +37,7 @@ These files provides shield configuration as follows:
   format that is merged with the board's device tree information before
   compilation.
 
-* **dts.fixup**: This is a fixup file to bind board components definitions with
+* **dts_fixup.h**: This is a fixup file to bind board components definitions with
   application in a generic fashion to enable shield compatibility across boards
 
 Board compatibility