Confusion between configuration files NrfConnect SDK: KConfig vs KConfig.defaults vs KConfig interactive gui vs prj.conf

RE: Confusion between configuration files NrfConnect SDK: KConfig vs KConfig.defaults vs KConfig interactive gui vs prj.conf

uzer123 — Mon, 30 Jan 2023 08:22:37 GMT

Yes, these sources are very good addition to more understanding or/and better modification of available settings..

RE: Confusion between configuration files NrfConnect SDK: KConfig vs KConfig.defaults vs KConfig interactive gui vs prj.conf

Raoul — Mon, 30 Jan 2023 07:42:55 GMT

That is entirely correct! This is a good TL;DR for a majority of your Kconfig needs. To add to your understanding, you could also look at the role of _defconfig files that define the default prj.conf settings for a particular board, and at the ability to use different .conf files for different build targets.

What I also find very useful sometimes is to look at autoconf.h, located in the build/zephyr/include folder (after building) - it is the end result of all the merged configuration files and helps make clear exactly what is and isn't enabled at any particular time for the application you've compiled.

In general Kconfig is quite well documented in NCS/Zephyr. I'll leave you with the following two articles:

Setting Kconfig configuration values

Kconfig - Tips and Best Practices

Best regards,

Raoul

RE: Confusion between configuration files NrfConnect SDK: KConfig vs KConfig.defaults vs KConfig interactive gui vs prj.conf

uzer123 — Thu, 26 Jan 2023 10:46:32 GMT

Thanks for your answer. It adds value to my understanding and agrees with what i've seen so far dealing with Nrf Connect.

So, in a nutshell the TL;DR answer is:

You can use Kconfig gui/guiconfig/menuconfig GUIs to take ideas about the possible configurations but if you want to try or have a permanent configuration find the appropriate name from the GUIs (or the Kconfig search engine you sent) and add it to prj.conf. Then make a build or if you are afraid that your configuration didn't work, try a pristine build. IF you want to add your own options for configuration (for example include your own library/src file with default values) you can make your own Kconfig file (no file extension) in apps root folder as nicely described in nRF Connect SDK Fundamentals course Lesson 3, exercise 2.

RE: Confusion between configuration files NrfConnect SDK: KConfig vs KConfig.defaults vs KConfig interactive gui vs prj.conf

Raoul — Thu, 26 Jan 2023 09:03:10 GMT

Hi Uzer, sounds like you've understood just about everything correctly.

I should point out that prj.conf is by far the file you'll be dealing with the most often - it is not only used to configure your own user-defined Kconfig options, but to configure any of the thousands of options that NCS exposes. When you experiment with kconfig options through an interactive interface, prj.conf is where you'll set them permanently (and I personally just forego the interactive interfaces and experiment by changing prj.conf directly).

It shouldn't always be necessary to do a pristine build when changing prj.conf, the build system should figure out what to rebuild. But it doesn't always get things right, so if you encounter issues, pristine builds could definitely be necessary. But as you might have noticed, they take longer to complete.

Note that instead of the KConfig interactive GUI in the VS Code extension, you can also opt to use the guiconfig or menuconfig interfaces: https://developer.nordicsemi.com/nRF_Connect_SDK/doc/latest/zephyr/build/kconfig/menuconfig.html

The VS Code extension lets you select which interactive interface you want to use, in a dropdown menu.

Just to be clear, building and flashing are completely independent steps, flashing is not related to the Zephyr build process and so these configuration files are not affected by flashing, just building.

kconfig.defaults is actually something I haven't encountered before. So outside of the audio dk, it's not something you'll usually have to worry about.

I hope this adds to your understanding.

Best regards,

Raoul