From 72b00b3f5850c37e26f05725a2688779eba10976 Mon Sep 17 00:00:00 2001 From: Cem Aksoylar Date: Sat, 25 Jan 2025 13:04:50 -0800 Subject: [PATCH] docs: Add pointers to final Kconfig/devicetree files (#2796) docs: Add diagnosis pointers for Kconfig/devicetree outputs docs: Add tip boxes for diagnosing config/devicetree changes --- .../building/devicetree-step.png | Bin 0 -> 10939 bytes .../troubleshooting/building/kconfig-step.png | Bin 0 -> 8659 bytes docs/docs/config/index.md | 12 +++++ docs/docs/troubleshooting/building-issues.md | 44 ++++++++++++++++++ 4 files changed, 56 insertions(+) create mode 100755 docs/docs/assets/troubleshooting/building/devicetree-step.png create mode 100755 docs/docs/assets/troubleshooting/building/kconfig-step.png diff --git a/docs/docs/assets/troubleshooting/building/devicetree-step.png b/docs/docs/assets/troubleshooting/building/devicetree-step.png new file mode 100755 index 0000000000000000000000000000000000000000..f2f75764dab0b5aa4ca56e17980a05647db5e139 GIT binary patch literal 10939 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 literal 0 HcmV?d00001 diff --git a/docs/docs/assets/troubleshooting/building/kconfig-step.png b/docs/docs/assets/troubleshooting/building/kconfig-step.png new file mode 100755 index 0000000000000000000000000000000000000000..34bbdd22f7ad3ac6bf922013233b87dc2bb01e28 GIT binary patch literal 8659 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 Kconfig file" step in your build job: + +![](../assets/troubleshooting/building/kconfig-step.png) + +If you are building locally, this file can be found inside the build folder at `/zephyr/.config`. + +Additionally, the build command (in "West Build (``)" step in GitHub Actions) logs what configuration files were found and used in the build: + +``` ++ west build -s zmk/app -d /tmp/tmp.8cJefinXCb -b corneish_zen_v2_left -- -DZMK_CONFIG=/tmp/zmk-config/config -DZMK_EXTRA_MODULES=/__w/zmk-config/zmk-config +... +-- ZMK Config Kconfig: /tmp/zmk-config/config/corneish_zen.conf +... +``` + +### Devicetree-related Issues + +If you want to ensure that your [devicetree files](../config/index.md#devicetree-files) are processed as you expect, you can check the final compiled devicetree file that the firmware build process produces. +This file will contain a single devicetree that combines all of user, board, and shield (if used in build) devicetree files. +Note that while it will include your keymap contents in it, [keycodes](../keymaps/list-of-keycodes.mdx) like `SPACE` will be displayed instead as hexadecimal numbers like `0x7002a`. + +When using GitHub Actions to build your firmware, the contents of this file are displayed in the "`` Devicetree file" step in your build job: + +![](../assets/troubleshooting/building/devicetree-step.png) + +If you are building locally, this file can be found inside the build folder at `/zephyr/zephyr.dts`. + +Additionally, the build command (in "West Build (``)" step in GitHub Actions) logs what devicetree files were found and used in the build: + +``` ++ west build -s zmk/app -d /tmp/tmp.8cJefinXCb -b corneish_zen_v2_left -- -DZMK_CONFIG=/tmp/zmk-config/config -DZMK_EXTRA_MODULES=/__w/zmk-config/zmk-config +... +-- Found BOARD.dts: /tmp/zmk-config/zmk/app/boards/arm/corneish_zen/corneish_zen_v2_left.dts +-- Found devicetree overlay: /tmp/zmk-config/config/corneish_zen.keymap +... +```