Commit graph

7222 commits

Author SHA1 Message Date
Marc Herbert
fe9bfe5335 doc: sign: minor rimage update following imgtool removal
Fixes commit 1df078158f ("doc: build: Add signing page") that removed
the `imgtool` section from the `sign.rst` page.

rimage configuration was designed in a very different way from imgtool
configuration. The rimage doc section was following the imgtool doc
section and constrating the two approaches. Now that the previous
imgtool doc section has just been removed, some words like "different"
and "instead" don't make sense anymore. Drop them.

Signed-off-by: Marc Herbert <marc.herbert@intel.com>
2024-10-22 18:28:29 -04:00
Jilay Pandya
bb0891431b doc: release notes: added stepper release notes
Added stepper controller support to release notes for release 4.0

Signed-off-by: Jilay Pandya <jilay.pandya@zeiss.com>
2024-10-22 20:38:30 +02:00
Jilay Pandya
87f85e4296 doc: stepper: update stepper documentation
This commit adds documentation about stepper api along
with some minor cleanups

Signed-off-by: Jilay Pandya <jilay.pandya@zeiss.com>
2024-10-22 20:38:30 +02:00
Benjamin Cabé
b58b8964d3 boards: seeed: adopt new zephyr:board directive and role
This updates the documentation of all the Seeed Studio boards to use
the new `zephyr:board::` directive.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
ecb7c875dd doc: boards: extensions: introduce zephyr:board role and directive
A new zephyr:board:: Sphinx directive allows  to flag a documentation
page as being the documentation for a specific board, allowing to
auto-populate some of the contents, ex. by adding a board overview a la
Wikipedia, and later things like supported HW features, etc.

A corresponding :zephyr:board: role allows to link to a board doc page.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
534990249d doc: boards: extensions: store board_catalog in Sphinx domain
Load the board catalog only once at build-inited time so that
it's cached and enabled things like boards, vendors, and socs
to eventually become first class Sphinx objects.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
f75f2bf5d9 doc: release: 3.7: sphinxlint fixes
Fixes typos in Sphinx roles

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
42354ccfce doc: scripts: boards: don't init pykwalify logging
This might be a leftover from a previous version but this is basically
silencing all Sphinx logs when generating the catalog from Sphinx -- not
good!

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
329f411196 doc: boards: extensions: add board name to catalog for convenience
This makes dictionary entries from the boards catalog more
self-contained as the name of the board is now included in the entry.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
15f0894b0f doc: boards: extensions: remove unused import
Make all Zephyr directives inherit from SphinxDirective

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Benjamin Cabé
04e6406edb doc: boards: extensions: store "raw" image path
Small change to the way image are stored in the catalog so that we know
where the source image is rather than anticipating on the final path
after build has happened. This allows to potentially reference the
source image from e.g. directives.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-22 14:11:27 +02:00
Wajdi ELMuhtadi
fb45c6d93a drivers: sensor: wsen_hids_2525020210002: add sensor driver
Add wsen_hids_2525020210002 driver with
the corrected name and compatibility with
the hal update as well as added new features.

Signed-off-by: Wajdi ELMuhtadi <wajdi.elmuhtadi@we-online.com>
2024-10-22 14:03:08 +02:00
Benjamin Cabé
c7f1f32ebe doc: css: fix styling of signatures
Sync the section of the custom.css dedicated to object
signatures with Godot custom CSS.

Fixes #80005.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-21 18:39:18 -05:00
Reto Schneider
7ba0ee6bca doc: blobs: Document startup notification
Due to the (potentially) hard to understand effects of blobs, it seems
prudent to make their presence more noticeable.

Hopefully, this will make it easier to identify issues (such as those
reported on GitHub) that have been observed on devices running a tainted
build.

Signed-off-by: Reto Schneider <reto.schneider@husqvarnagroup.com>
2024-10-21 15:58:27 +02:00
Reto Schneider
d5559ff82b doc: blobs: Add missing period
A full sentence should be ended by a period.

Signed-off-by: Reto Schneider <reto.schneider@husqvarnagroup.com>
2024-10-21 15:58:27 +02:00
Reto Schneider
bdea85c9cf doc: blobs: Remove superfluous spaces
While not visible in the rendered documentation, double spaces look bad
when reading plaintext file.

Signed-off-by: Reto Schneider <reto.schneider@husqvarnagroup.com>
2024-10-21 15:58:27 +02:00
Tomi Fontanilles
d6348cd22a mbedtls: update to 3.6.2
https://github.com/Mbed-TLS/mbedtls/releases/tag/mbedtls-3.6.2
Signed-off-by: Tomi Fontanilles <tomi.fontanilles@nordicsemi.no>
2024-10-21 12:34:51 +02:00
Andrej Butok
6857a37d19 doc: Use EXTRA_CONF_FILE in .rst/.md files
Use EXTRA_CONF_FILE in documentation .rst/.md files,
that replaced deprecated OVERLAY_CONFIG since the Zephyr v3.4 release.

Signed-off-by: Andrej Butok <andrey.butok@nxp.com>
2024-10-21 12:34:38 +02:00
Carles Cufi
cb47c62259 boards: nordic: Remove nRF54L15 PDK
The nRF54L15 Development Kit is now available, so remove the Preview
Development Kit (PDK).

Signed-off-by: Carles Cufi <carles.cufi@nordicsemi.no>
2024-10-21 01:46:39 +01:00
Reto Schneider
7b65bbe52e doc: pytest: Fix spelling of unlaunched
unlauched_dut is written wrongly - unlaunched_dut is correct.

Signed-off-by: Reto Schneider <reto.schneider@husqvarnagroup.com>
2024-10-21 01:45:49 +01:00
Erik Brockhoff
b590c0b1f6 doc: connectivity: Bluetooth: add LLCP fly-in
Adding a brief fly-in of the main concepts of the
implementation of link layer control procedures handling

Signed-off-by: Erik Brockhoff <erbr@oticon.com>
2024-10-18 17:46:55 +01:00
Pavel Vasilyev
8acb1cc577 bluetooth: host: conn: Check if *conn is not NULL
This commit adds a warning and a Kconfig option to `bt_conn_le_create`
and `bt_conn_le_create_synced` functions which are meant to warn a user
of a potential leakage of an active connection object.

This change is implemented due to frequent incorrect use of the
connection pointer where a pointer to an existing connection object
is overwritten by `bt_conn_le_create` and `bt_conn_le_create_synced`
functions which in turns leads to sporadic critical bugs. See
https://github.com/zephyrproject-rtos/zephyr/pull/78284#discussion_r1754304535
for more details.

The Kconfig option is introduced instead of always returning the error
to not affect current implementations. However, it is recommended to
keep this option enabled to avoid potential bugs.

Signed-off-by: Pavel Vasilyev <pavel.vasilyev@nordicsemi.no>
2024-10-18 17:46:04 +01:00
Gerard Marull-Paretas
4ab766cafc doc: migration-guide: inform about power-domains[-names]
The new property replaces the old power-domain.

Signed-off-by: Gerard Marull-Paretas <gerard@teslabs.com>
2024-10-18 17:45:21 +01:00
Gerard Marull-Paretas
f989711a60 pm: s/power-domain/power-domains and add power-domain-names
Some devices may belong to >1 power domain, so with the current design
this is something not possible to describe. It's worth to note that
Linux also uses the `power-domains` naming scheme, not `power-domain`.
This patch also introduces `power-domain-names` so that each entry in
`power-domains` can be given a name if needed. `#power-domain-cells`
is now required as well.

Signed-off-by: Gerard Marull-Paretas <gerard@teslabs.com>
2024-10-18 17:45:21 +01:00
Peter Mitsis
1d07e565fc arch: arc: add support for lock/unlock VPX
Adds support for cooperative locking/unlocking the VPX vector registers.
Provided that all VPX enabled threads use these routines to control
access to the VPX vector registers, it will allow multiple threads to
safely use them without the need for saving/restoring them upon each
context switch.

Signed-off-by: Peter Mitsis <peter.mitsis@intel.com>
2024-10-17 15:49:49 -04:00
Benedikt Schmidt
acbc14e767 drivers: gpio: implement parallel mode in TLE9104
Implement the parallel mode in the powertrain switch TLE9104.
This allows that OUT1 and OUT2 are controlled together, as well
as OUT3 and OUT4.

Signed-off-by: Benedikt Schmidt <benedikt.schmidt@embedded-solutions.at>
2024-10-17 15:38:45 -04:00
Johan Hedberg
6517bab502 doc: migration-guide-4.0: Add a note about updated HCI DT properties
Add a note for the updated bt-hci-quirks and bt-hci-bus DT properties.

Signed-off-by: Johan Hedberg <johan.hedberg@silabs.com>
2024-10-17 15:36:49 -04:00
Benjamin Cabé
239f4308be doc: boards: extensions: board catalog is only available in HTML
Although boards/index.rst is not included in the PDF toc, it seems as if
Sphinx tries to build the page anyway, which fails because the board
catalog directive is not outputting any node on non-HTML builders.

This commit fixes it by returning a "Board catalog is only available in
HTML." paragraph. In the future, we might want to output some kind of
static table or bullet list for non-HTML builders.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-17 10:49:57 -04:00
Benjamin Lemouzy
6203261ea8 doc: retention: fix retention area address
Fix retainedmem address to not overlap sram0.

Signed-off-by: Benjamin Lemouzy <blemouzy@centralp.fr>
2024-10-17 10:49:41 -04:00
Daniel DeGrasse
87180f40ac doc: services: document sys_trace_user_event
Document availability of sys_trace_user_event, for users who are trying
to add custom trace events to their application.

Signed-off-by: Daniel DeGrasse <daniel.degrasse@nxp.com>
2024-10-17 10:46:52 -04:00
Rex Chen
be151908d8 net: wifi: shell: add enterprise support for station
Add EAP-TLS, EAP-PEAP-MSCHAPv2, EAP-PEAP-GTC, EAP-TTLS-MSCHAPv2,
EAP-PEAP-TLS, EAP-TLS-SHA256  enterprise wpa2 and wpa3 suiteb
support for station.

Signed-off-by: Rex Chen <rex.chen_1@nxp.com>
2024-10-17 09:46:02 +02:00
Valerio Setti
5e225e0c8b tinycrypt: deprecate the library
Since we now have PSA Crypto APIs/Mbed TLS alternatives for crypto
operations in all Zephyr's codebase we can start the deprecation
of the TinyCrypt libary (as planned from #43712).
This commit is only the inital step: updates documentation and
add the DEPRECATED Kconfig option to the TINYCRYPT one.

Signed-off-by: Valerio Setti <vsetti@baylibre.com>
2024-10-17 09:44:53 +02:00
Benjamin Cabé
9beb82f971 doc: vulnerabilities: use :cve: role to link to CVEs
This is a new role available in Sphinx 8.1 and it very useful to avoid
typos and to provide a consistent way to link to CVEs.
This commit actually fixes some such typos :)

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 16:34:46 +01:00
Benjamin Cabé
e0ee9f1ac6 doc: vulnerabilities: fix typo in JIRA urls
Some JIRA urls had a triple s in "...atlassian..."

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 16:34:46 +01:00
Benjamin Cabé
dd1f51148b doc: enable three-way dark-mode switch
dark-mode-toggle now allows to also set current mode to "system", which
allows people to use the system-wide dark mode setting rather than
having to definitively choose between light and dark mode once they've
used the button once.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 16:33:24 +01:00
Benjamin Cabé
dbf3c8f5cd doc: fix dark mode "flashing" on page load
This hooks up the dark-mode-toggle-stylesheets-loader so that the dark
mode styles are loaded immediately, rather than waiting for the page to
load and then switching to dark mode. This prevents the "flashing" of
light mode styles on page load.

Fixes #79791

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 16:33:24 +01:00
Benjamin Cabé
7aa6222835 doc: update dark-mode-toggle to 0.16.1
Updates the minified JS resources corresponding to latest
dark-mode-toggle (0.16.1) release.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 16:33:24 +01:00
Benjamin Cabé
ede954c098 doc: extensions: boards: add search tips admonition
As the search form is becoming richer, provide some guidance on how to
filter the list of supported boards and what to do when no results are
found.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 12:26:27 +02:00
Benjamin Cabé
282a6c5a98 doc: boards: allow filtering by SoC
This introduces the ability to filter boards by soc (family / series /
soc).

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 12:26:27 +02:00
Benjamin Cabé
86b72ee6e2 doc: extensions: boards: extract socs information
Store soc(s) information for each board in the catalog, as
well as populate a tree structure for the full list of
family->series->soc.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 12:26:27 +02:00
Benjamin Cabé
c5529309f1 doc: extensions: boards: don't guess board full name anymore
Now that we have full_name available in board.yml, stop trying
to "guess" full/commercial name of the board based on its
documentation.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-16 12:26:27 +02:00
JP Hutchins
c81e36091d doc: mcumgr: Add smp and smpclient
The smp library implements de/serialization of SMP messages.
The smpclient library implements the serial, BLE, and UDP
transport layers for Windows, Linux, and macOS.

Signed-off-by: JP Hutchins <jp@intercreate.io>
2024-10-16 09:56:52 +02:00
Benjamin Cabé
d5bcfc764c doc: extensions: boards: suppress extra blank lines in Jinja templates
Ensure Jinja templates don't have extra blank lines in the output by
using the {% -%} syntax to suppress them.
This is not incredibly important but this helps keeps the HTML output
more readable.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-15 19:01:56 +01:00
Benjamin Cabé
29798f0ebd doc: extensions: boards: add labels to search form fields
Add proper labels to the form fields for better UX/accessibility
Updated the placeholder for the "board name" field to be more
informative.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-15 19:01:56 +01:00
Chaitanya Tata
b643070557 doc: wifi: Update build command for Enterprise mode
Now, Enterprise mode has a separate overlay.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
2024-10-15 13:53:30 +02:00
Chaitanya Tata
6cac9540ec doc: wifi: Update enumeration for EAP-TLS
EAP-TLS enumeration is now changed due to recent SAE additions.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
2024-10-15 13:53:30 +02:00
Hake Huang
c05e4802fb document: twister: update documents for extra_args
now extra_args can support domain settings, add in doc.

Signed-off-by: Hake Huang <hake.huang@oss.nxp.com>
2024-10-15 04:09:16 -04:00
Jordan Yates
fec7156b03 adc: current_sense_amplifier: reduce valid scaling range
Reduce the valid scaling range for the gain multipliers and dividers to
provide more headroom on int64_t overflows in the calculations. Take
advantage of this headroom to perform all multiplications before
divisions.

Signed-off-by: Jordan Yates <jordan@embeint.com>
2024-10-14 13:05:07 +02:00
Jordan Yates
4361c96c48 adc: current_sense_amplifier: resistance in milli-ohms
Change the unit of the sense resistor in the devicetree binding from
micro-ohms to milli-ohms. This is done for three reasons.

Firstly, the maximum value resistor that can currently be represented
is 4.2 kOhms, due to the limitation of devicetree properties to 32 bits.

Secondly, storing the resistance at such a high resolution makes
overflows much more likely when the desired output unit is micro-amps,
not milli-amps.

Finally, micro-ohms, are an unnecessarily precise unit for the purpose
of these calculations, and a resolution that is not realistic to
achieve. The high resistor resolution results in large divisors that
reduce the resolution of outputs. Unlike resistors characterised down to
the micro-ohm, devices wanting to measure micro-amps are actually
realistic.

Signed-off-by: Jordan Yates <jordan@embeint.com>
2024-10-14 13:05:07 +02:00
Benjamin Cabé
8595a0cf79 doc: requirements: Update to Sphinx RTD Theme 3.0
Update to latest Sphinx RTD Theme version.
Main benefit will be to be able to leverage Sphinx 8.0 since previous
version of the theme was depending on 'sphinx < 8.0'.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-14 13:02:20 +02:00