147 Commits

Author SHA1 Message Date
Benjamin Cabé
72a1c9e43e doc: _scripts: gen_devicetree_rest: ensure blank lines around transition
Transition markers ("----") require blank lines before and after, so
this ensures that is always the case.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2026-01-23 10:45:39 +01:00
Ren Chen
7b81e406d6 board: ite: it515xx_evb: rename it515xx_evb to it51xxx_evb
This change accommodates support for next-generation
soc(it51600).

Tested with:
west build -p always -b it51xxx_evb/it51526aw samples/hello_world/

Signed-off-by: Ren Chen <Ren.Chen@ite.com.tw>
2026-01-20 15:28:09 +00:00
Andrej Butok
32823f39fb boards: mikroe: move the hexiwear board
- The vendor of the hexiwear board is mikroe (not nxp)
  https://www.mikroe.com/hexiwear.
- Move the board files from 'nxp' to 'mikroe'.
- Delete hexiwear from the nxp maintained board list.
- Update paths in the documentation.

Signed-off-by: Andrej Butok <andrey.butok@nxp.com>
2026-01-15 16:42:24 +00:00
James Roy
4c8cb73198 doc: Generate documentation for the binding examples
Generate an rst document with an `Examples` section
from the sample nodes written in the examples of the
binding.

Signed-off-by: James Roy <rruuaanng@outlook.com>
2026-01-14 13:02:02 -06:00
James Roy
077e23482c doc: scripts: Add a language parameter to the to_code_block()
Introduce a `language` parameter in `to_code_block()` for syntax
highlighting support (default: None).

Signed-off-by: James Roy <rruuaanng@outlook.com>
2026-01-14 13:02:02 -06:00
Lyle Zhu
8dca624355 doc: bluetooth: reorganize Classic API documentation into subdirectory
Reorganize Bluetooth Classic API documentation by moving existing files
(SDP, RFCOMM, A2DP, HFP) into a new `classic/` subdirectory and adding
new documentation files for L2CAP BR/EDR, AVRCP, GOEP, and BIP.

Changes include:
- Move existing Classic API docs to subdirectory `classic/`
- Add new L2CAP BR/EDR documentation
- Add AVRCP, GOEP, and BIP API reference documentation
- Update HFP documentation to include both HFP Unit and HFP-AG sections
- Update index.rst to reflect new directory structure
- Add Doxygen group documentation to AVRCP header
- Update AVRCP Cover Art to be a subgroup of AVRCP
- Fix L2CAP BR/EDR Doxygen group name and description

Signed-off-by: Lyle Zhu <lyle.zhu@nxp.com>
2026-01-14 09:57:38 +01:00
Benjamin Cabé
4ee5499f67 doc: storage: nvmem: move nvmem docs under storage
This moves nvmem docs to a better suited home since we already have
a section for all things storage.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-12-01 08:27:52 +01:00
Benjamin Cabé
bd62f24893 doc: storage: fs: move file system docs under storage
This moves fs docs to a better suited home since we already have
a section for all things storage.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-12-01 08:27:52 +01:00
Benjamin Cabé
8c6c350138 doc: storage: retention: move retention docs under storage
This moves retention into a better suited home since we already have
a section for all things storage.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-12-01 08:27:52 +01:00
Benjamin Cabé
afa7b8c9e6 doc: _scripts: fix SIM905 linter rule in gen_devicetree_rest.py
replace str.split() with an actual set of strings

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-10-28 17:41:38 +02:00
Benjamin Cabé
be7c2e81cd scripts: gen_boards_catalog.py: add verbose flag to Twister
Pass verbose flag to Twister to get better insights into what boards are
being built and see progress.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-10-28 11:47:40 +02:00
Benjamin Cabé
ef818fecc1 doc: scripts: gen_devicetree_rest: add link to board catalog in sidebar
This adds a link to the board catalog in the sidebar of each binding
page, directing users to boards using the compatible.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-10-22 18:14:12 -04:00
Benjamin Cabé
9e081a7ca9 doc: _scripts: capture boards' compatibles in board catalog
This commits adds a `compatibles` field to each board entry in the board
catalog, similar to the `supported_features` field.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-10-22 18:14:12 -04:00
Stanley Huang
a78bf4f180 board: Rename raytac_an54l15q_db to raytac_an54lq_db_15
Renamed raytac_an54l15q_db to raytac_an54lq_db_15.

Signed-off-by: Stanley Huang <stanley@raytac.com>
2025-10-22 08:52:18 +02:00
Benjamin Cabé
405d187fa5 ci: doc-build.yml: do not tweak manifest.project-filter unnecessarily
The documentation build shouldn't need to pull in anything beyond what's
active by default in the west.yml manifest. In fact, due to the way the
manifest_projects_table.py script currently works, it is important that
have a local west config that's "vanilla" so that the table of
active/inactive projects is correct.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-10-17 21:06:24 -04:00
Anas Nashif
55af38cdbf samples: move pmci samples into samples/subsys/pmci
Move pmci samples under samples/subsys/pmci, given that pmci is a
subsystem in zephyr.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2025-10-08 18:24:27 -07:00
Etienne Carriere
c7b31f3957 samples: boards: st: power_mgmt remove standby_shutdown sample
Remove samples/boards/st/power_mgmt/standby_shutdown.

Sample standby_shutdown in boards/st/power_mgmt includes 2 examples.
One demonstrates wakeup from shutdown using a wakeup pin which is already
implemented in samples/boards/st/power_mgmt/wkup_pins. The other
demonstrates wakeup from SoC STANDBY mode using a wakeup pin. However
it enters SoC STANDBY mode through pm_state_force() whereas
STANDBY mode is not a PM standby or idle state, it is rather a shutdown
with possibly only a unique small SRAM retention, not allowing retention
of the system as expected from Zephyr standby or idle state flavors.
Therefore this second scenario is not applicable and can be removed.

Update doc redirection to link removed sample documentation to ST board
power management related samples documentation.

Signed-off-by: Etienne Carriere <etienne.carriere@st.com>
2025-09-25 14:19:44 -04:00
Benjamin Cabé
d87c98978c doc: west: drop "Moving to West" doc page
Converting a "pre-west" Zephyr setup is not something we officially
support anymore so drop associated documentation.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-22 17:52:27 -04:00
Benjamin Cabé
d0b31db64c doc: _scripts: gen_boards_catalog.py: prefer webp over png over jpg
The heuristics for guessing "best" image file for a given board will now
prefer webp over png over jpg as there is a good chance that when we
need to fall back to _any_ image for the lack of a better match, a webp
image, if one exists, will be the best image to use.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-22 13:31:51 -04:00
Benjamin Cabé
7586db6e46 doc: _scripts: gen_boards_catalog.py: improve image guessing heuristics
When a board or shield is named boardfoo_is_awesome, we now explicitly
look for images with a name that starts with one of the segments of the
board/shield name ; i.e.: boardfoo_is_awesome.imgext, then
boardfoo_is.imgext, then boardfoo.imgext.

Fixes: zephyrproject-rtos/zephyr#96144

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-22 13:31:51 -04:00
Benjamin Cabé
9f181b6711 doc: _scripts: ensure twister.yaml file is considered in board catalog
Boards may use twister.yaml file to define Twister platforms, so
board catalog should also parse them.

Fixes: zephyrproject-rtos/zephyr#95721.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-11 18:10:21 +01:00
Benjamin Cabé
4da532c38f boards: doc: arm: fvp_baser_aemv8r: documentation cleanup
Consolidate board documentation into a single page to avoid duplication
and, more importantly, ensure the board documentation is properly
displayed in the documentation website.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-09 17:27:38 +02:00
Benjamin Cabé
6de7702910 boards: doc: native_sim: adopt zephyr-board directive
Update documentation of native_sim to leverage zephyr-board Shinx magic,
in particular the ability to generate the table of supported HW
features.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-09 10:12:00 -04:00
Benjamin Cabé
6132640d08 doc: samples: shields: fix doc build warnings
Ensure all RST files only ever belong to one single toctree by means of
cleaning up existing in globs used in nested folders.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-04 21:04:42 +02:00
Benjamin Cabé
5f5e31134b doc: display: consolidate MIPI docs in Display section
Move MIPI-DBI and MIPI-DSI docs from top-level Peripherals section to
under Display section.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-03 21:21:18 +02:00
Benjamin Cabé
aedd23f7ad doc: modbus: connectivity: move Modbus docs to Connectivity
The Modbus subsystem belongs to the Connectivity category rather than
OS Services.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-09-03 13:49:43 +03:00
Steffen Jahnke
455b0eeb7f boards: panasonic: Update naming PAN B611 Evaluation Board
The PAN B511 evaluation board is a development tool for the
nRF54L15 from Nordic Semiconductor. Due to marketing reasons
the naming was adjusted from panb511 to panb611.

Signed-off-by: Steffen Jahnke <steffen.jahnke@eu.panasonic.com>
2025-08-28 11:32:23 +02:00
Benjamin Cabé
12c4d7661a doc: _scripts: use tuple instead of list for html_redirects
Changed the REDIRECTS variable from a list to a tuple in the
redirects.py scripts since it's an immutable sequence.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-07-29 22:55:04 -04:00
Benjamin Cabé
a74f222b73 doc: _scripts: use tuple instead of list for gen_boards_catalog
Changed a bunch of immutable sequences from being lists to tuples.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-07-29 22:55:04 -04:00
Sergei Ovchinnikov
f0f2b941f0 boards: shields: add npm1304_ek shield
Add an nPM1304 EK shield, update samples/shields/npm1300_ek to support
both shields, improve the sample description.

Signed-off-by: Sergei Ovchinnikov <sergei.ovchinnikov@nordicsemi.no>
2025-07-28 08:47:49 -04:00
Sebastian Głąb
878ddbe2f6 boards: nordic: nrf54l20pdk: Remove obsolete board
Board nrf54l20pdk was renamed to nrf54lm20dk.
Remove obsolete board definition.

Signed-off-by: Sebastian Głąb <sebastian.glab@nordicsemi.no>
2025-07-24 17:00:33 +01:00
Anas Nashif
fec22fd85b crypto: remove deprecated tinycrypt
Remove tinycrypt, it was deprecated in 4.0.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2025-07-24 02:48:32 -04:00
Lyle Zhu
14eba9d2d9 Samples: Bluetooth: HF: Move handsfree and handsfree_ag to './classic'
Move `handsfree` and `handsfree_ag` to sub-folder './classic'.

Signed-off-by: Lyle Zhu <lyle.zhu@nxp.com>
2025-06-10 12:25:46 +02:00
Benjamin Cabé
8c6b2c8c88 doc: _extensions: boards: retrieve archs info dynamically
Rather than hardcoding the human readable full names of the archs in the
board catalog, we now retrieve them dynamically from the archs.yml file.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-06-06 10:29:44 +02:00
Benjamin Cabé
804915841a shields: doc: allow to indicate supported hw features
Shield authors can now indicate an optional list of hardware features
that the shield supports, in the form of the same kind of "binding type"
already used for boards.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-05-28 15:33:50 +02:00
Benjamin Cabé
79e3ecb7a9 doc: boards: catalog: add shields to board catalog
Populate board catalog with shields as well and have them show up in the
boards/index page.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-05-23 17:19:58 +02:00
Benjamin Cabé
928472b4c7 Revert "doc: boards: catalog: add shields to board catalog"
This reverts commit 11fea40a40.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-05-21 09:30:30 +02:00
Benjamin Cabé
11fea40a40 doc: boards: catalog: add shields to board catalog
Populate board catalog with shields as well and have them show up in the
boards/index page.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-05-20 15:23:34 +02:00
Aksel Skauge Mellbye
3cf4e2f933 doc: Add vendor filter for hw feature generation
The hw feature generation takes a long time. The HW_FEATURES_TURBO_MODE
option completely disables hw feature generation. Add a new option
HW_FEATURES_VENDOR_FILTER to be able to selectively enable hw feature
generation only for a given list of vendors. This option is useful
when working on board documentation pages.

Signed-off-by: Aksel Skauge Mellbye <aksel.mellbye@silabs.com>
2025-05-07 21:20:42 +02:00
Aksel Skauge Mellbye
21022462be doc: Regenerate board doc if supported hardware data changes
Declare the dts and binding files used for the supported hardware
directive as dependencies of doc pages that use them.

Signed-off-by: Aksel Skauge Mellbye <aksel.mellbye@silabs.com>
2025-05-07 17:45:27 +02:00
Benjamin Cabé
268e0f5c88 samples: Remove MAX44009 sensor sample
Delete the MAX44009 sensor sample as it's fully generic and does nothing
that's not already in light_polling sample.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-05-02 15:21:28 +02:00
Aksel Skauge Mellbye
2e442e0ad5 doc: _scripts: Expose title from dt binding in board catalog
Make the recently added `title` attribute in dt bindings available
in the board catalog used by the board supported hardware directive.

Signed-off-by: Aksel Skauge Mellbye <aksel.mellbye@silabs.com>
2025-05-02 09:15:50 +02:00
Benjamin Cabé
6e27d38a4d doc: _scripts: simplify vendor determination in board catalog generation
Use the board's vendor from board.yml as the source of truth.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-04-29 02:41:53 +02:00
Benjamin Cabé
3c2d2a6ee5 doc: _scripts: boards: fix for boards without revisions
Commit 38b8790 introduced a pretty bad regression for boards without
revisions. Fix by correctly checking for actually undefined revisions

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-04-15 15:33:51 +02:00
Jordan Yates
6061deba55 doc: gen_boards_catalog: fix crash for OOT boards
Fix a crash when `list_boards.find_v2_boards` finds boards not under
`ZEPHYR_BASE`.

Signed-off-by: Jordan Yates <jordan@embeint.com>
2025-04-09 09:03:37 +02:00
Benjamin Cabé
f06c26a6d0 doc: extensions: boards: add zephyr:board-supported-runners directive
Use runners.yaml from build metadata to gather info regarding board
supported runners, store the info in the board catalog, and allow
to display it as a table in a board's doc page using the
.. zephyr:board-supported-runner:: directive.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-04-03 21:05:39 +02:00
James Roy
ee17657ad3 edtlib: binding: Add a title keyword
Add a 'title' keyword to the binding to provide a short
description of the binding, while 'description' serves as
the long description.

Signed-off-by: James Roy <rruuaanng@outlook.com>
2025-04-02 12:54:24 +02:00
Benjamin Cabé
bb710309ef doc: _scripts: update gen_boards_catalog.py to support sysbuild
Boards that have sysbuild enabled in Twister will have the build folder
for the hello_world sample in a subfolder, so update the code
accordingly.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-03-31 22:00:02 +02:00
Benjamin Cabé
f6d11a51e8 doc: _extensions: add board target selector for supported HW features
This show a nice widget to switch between the various board targets and
see their respective list of supported features.

The original HTML content of the page is preserved and JavaScript code
"patches" the page on-the-fly. This is so that the actual HTML content
(that e.g. search engines see) is complete and indexable (as well as to
provide useful information for folks who might have JavaScript disabled
altogether).

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-03-31 21:59:18 +02:00
Benjamin Cabé
38b87905ba doc: _scripts: boards: fix condition for revision
Revision might be `0` so update the condition to not inadvertently
exclude boards with such revision number.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2025-03-31 21:59:18 +02:00