doc: develop: application: Fix missed HWMv2 changes

Fixes outdated information that was missed with the HWMv2 migration

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>
This commit is contained in:
Jamie McCrae 2024-04-11 13:35:17 +01:00 committed by Carles Cufí
commit 3d48ad90c9
2 changed files with 26 additions and 32 deletions

View file

@ -128,7 +128,7 @@ The initial configuration for an application comes from merging configuration
settings from three sources: settings from three sources:
1. A ``BOARD``-specific configuration file stored in 1. A ``BOARD``-specific configuration file stored in
:file:`boards/<architecture>/<BOARD>/<BOARD>_defconfig` :file:`boards/<VENDOR>/<BOARD>/<BOARD>_defconfig`
2. Any CMake cache entries prefix with ``CONFIG_`` 2. Any CMake cache entries prefix with ``CONFIG_``
@ -155,9 +155,6 @@ used.
:file:`prj_<build>.conf`, the result of merging :file:`prj_<build>.conf` and :file:`prj_<build>.conf`, the result of merging :file:`prj_<build>.conf` and
:file:`boards/<BOARD>_<build>.conf` is used. :file:`boards/<BOARD>_<build>.conf` is used.
#. Otherwise, :file:`prj_<BOARD>.conf` is used if it exists in the application
configuration directory.
#. Otherwise, if :file:`boards/<BOARD>.conf` exists in the application #. Otherwise, if :file:`boards/<BOARD>.conf` exists in the application
configuration directory, the result of merging it with :file:`prj.conf` is configuration directory, the result of merging it with :file:`prj.conf` is
used. used.
@ -200,7 +197,7 @@ Configuring invisible Kconfig symbols
When making changes to the default configuration for a board, you might have to When making changes to the default configuration for a board, you might have to
configure invisible symbols. This is done in configure invisible symbols. This is done in
:file:`boards/<architecture>/<BOARD>/Kconfig.defconfig`, which is a regular :file:`boards/<VENDOR>/<BOARD>/Kconfig.defconfig`, which is a regular
:file:`Kconfig` file. :file:`Kconfig` file.
.. note:: .. note::

View file

@ -494,13 +494,11 @@ Make sure to follow these steps in order.
as described in this step, this value will be used. as described in this step, this value will be used.
#. If your application uses a configuration file or files other than #. If your application uses a configuration file or files other than
the usual :file:`prj.conf` (or :file:`prj_YOUR_BOARD.conf`, where the usual :file:`prj.conf`, add lines setting the :makevar:`CONF_FILE`
``YOUR_BOARD`` is a board name), add lines setting the variable to these files appropriately. If multiple filenames are given,
:makevar:`CONF_FILE` variable to these files appropriately. separate them by a single space or semicolon. CMake lists can be used to
If multiple filenames are given, separate them by a single space or build up configuration fragment files in a modular way when you want to
semicolon. CMake lists can be used to build up configuration fragment avoid setting :makevar:`CONF_FILE` in a single place. For example:
files in a modular way when you want to avoid setting :makevar:`CONF_FILE`
in a single place. For example:
.. code-block:: cmake .. code-block:: cmake
@ -1144,7 +1142,7 @@ where the ``boards`` directory hosts the board you are building for:
. .
├── boards ├── boards
│ └── x86 │ └── vendor
│ └── my_custom_board │ └── my_custom_board
│ ├── doc │ ├── doc
│ │ └── img │ │ └── img
@ -1157,9 +1155,9 @@ supported by a SOC that is available in the Zephyr tree.
Boards Boards
====== ======
Use the proper architecture folder name (e.g., ``x86``, ``arm``, etc.) Use the vendor name as the folder name (which must match the vendor prefix in
under ``boards`` for ``my_custom_board``. (See :ref:`boards` for a :zephyr_file:`dts/bindings/vendor-prefixes.txt` if submitting upstream to Zephyr, or be
list of board architectures.) ``others`` if it is not a vendor board) under ``boards`` for ``my_custom_board``.
Documentation (under ``doc/``) and support files (under ``support/``) are optional, but Documentation (under ``doc/``) and support files (under ``support/``) are optional, but
will be needed when submitting to Zephyr. will be needed when submitting to Zephyr.
@ -1174,9 +1172,8 @@ Zephyr board, and provide the following files::
board.h board.h
CMakeLists.txt CMakeLists.txt
doc/ doc/
Kconfig.board Kconfig.my_custom_board
Kconfig.defconfig Kconfig.defconfig
pinmux.c
support/ support/
@ -1215,11 +1212,10 @@ the Zephyr tree, for example:
.. code-block:: none .. code-block:: none
soc soc
└── arm └── st
└── st_stm32 └── stm32
├── common ├── common
└── stm32l0 └── stm32l0x
The file :zephyr_file:`soc/Kconfig` will create the top-level The file :zephyr_file:`soc/Kconfig` will create the top-level
@ -1235,8 +1231,9 @@ more SoCs into the menu.
.. code-block:: none .. code-block:: none
soc soc
└── arm └── st
└── st_stm32 └── stm32
└── stm32l0x
├── Kconfig ├── Kconfig
├── Kconfig.soc ├── Kconfig.soc
└── Kconfig.defconfig └── Kconfig.defconfig
@ -1248,17 +1245,17 @@ An example of loading ``stm31l0`` specific Kconfig files in this structure:
.. code-block:: none .. code-block:: none
soc soc
└── arm └── st
└── st_stm32 └── stm32
├── Kconfig.soc ├── Kconfig.soc
└── stm32l0 └── stm32l0x
└── Kconfig.series └── Kconfig.soc
can be done with the following content in ``st_stm32/Kconfig.soc``: can be done with the following content in ``st/stm32/Kconfig.soc``:
.. code-block:: none .. code-block:: none
rsource "*/Kconfig.series" rsource "*/Kconfig.soc"
Once the SOC structure is in place, you can build your application Once the SOC structure is in place, you can build your application
targeting this platform by specifying the location of your custom platform targeting this platform by specifying the location of your custom platform