Commit Graph

7209 Commits

Author SHA1 Message Date
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
Robert Lubos
c4803752a8 net: Deprecate CONFIG_NET_SOCKETS_POLL_MAX
CONFIG_ZVFS_POLL_MAX is now used to control the maximum number of poll()
entires. Thereby, CONFIG_NET_SOCKETS_POLL_MAX is redundant and shall
be deprecated.

Modify the defaults for NET_SOCKETS_POLL_MAX and ZVS_POLL_MAX so that
the deprecation actually makes sense instead of symbol removal. In case
the application still sets the old config, it will modify the
ZVS_POLL_MAX default.

Signed-off-by: Robert Lubos <robert.lubos@nordicsemi.no>
Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-10-14 13:01:51 +02:00
Chris Friedt
d9398cd203 doc: posix: mark posix device io as complete
Mark the POSIX_DEVICE_IO Option Group as commplete. This Option
Group is required for PSE51, PSE52, PSE53, PSE54, and most of
the interesting applications involving file descriptors and
sockets.

Signed-off-by: Chris Friedt <cfriedt@tenstorrent.com>
2024-10-14 13:01:51 +02:00
Yonatan Schachter
41e1c436e5 doc: bindesc: Add documentation for bindesc read
Added documentation for reading binary descriptors.

Signed-off-by: Yonatan Schachter <yonatan.schachter@gmail.com>
2024-10-11 13:20:49 -04:00
Yonatan Schachter
5da7ba55aa west: bindesc: Added get_offset command
Add `west bindesc get_offset` command to print the offset of
the descriptors inside the given image.

Signed-off-by: Yonatan Schachter <yonatan.schachter@gmail.com>
2024-10-11 13:20:49 -04:00
Yonatan Schachter
c8c25b5c52 bindesc: Fix placing of the descriptors end tag
Prior to this fix the descriptors end tag was placed in the binary
using LONG. This was wrong because the tag is of type short, and
the size of the descriptor (0), should have also been placed.
It so happened that on little endian machines the incorrect linker
script yielded correct results, as the extra zeros added to make
the value a long ended up as the correct byte sequence
(FF FF 00 00). On big endian machines however, the wrong sequence
is generated (00 00 FF FF).
This patch correct this issue.

Signed-off-by: Yonatan Schachter <yonatan.schachter@gmail.com>
2024-10-11 13:20:49 -04:00
Marek Pieta
bc5f1c8186 doc: releases: Add note for CONFIG_BT_CONN_TX_NOTIFY_WQ
Change adds a release note informing about the newly introduced Kconfig
option for Bluetooth stack.

Signed-off-by: Marek Pieta <Marek.Pieta@nordicsemi.no>
2024-10-11 13:16:26 -04:00
Benjamin Cabé
3af51ddce1 doc: boards: extensions: fix vendor selection from URL
Apply selection from the hash URL *after* having sorted the vendors
alphabetically.
Remove the initial call to updateBoardCount() as it is useless to
have one this early.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-11 13:14:29 -04:00
Benjamin Cabé
a1261773db doc: boards: extensions: fix CSS rule
Fix a regression introduced at the last minute when cleaning up
the stylesheet. The rule as it was made no sense.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-11 13:14:29 -04:00
Benjamin Cabé
a5ecd339d7 doc: boards: extensions: update code comment for consistency
Very minor fix for having consistent style in the coment

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2024-10-11 13:14:29 -04:00
Bjarki Arge Andreasen
43f88ca8e1 doc: release notes: added comparator release notes
Added comparator support to release notes for release 4.0

Signed-off-by: Bjarki Arge Andreasen <bjarki.andreasen@nordicsemi.no>
2024-10-10 20:24:52 -04:00
Bjarki Arge Andreasen
183e58b190 docs: hardware: peripherals: add comparator docs
Add documentation for the comparator peripheral and shell.

Signed-off-by: Bjarki Arge Andreasen <bjarki.andreasen@nordicsemi.no>
2024-10-10 20:24:52 -04:00
Bjarki Arge Andreasen
3b08a08c7f doc: releases: migration-guide: deprecated nxp,kinetis-acmp props
Add entyr mentioning the deprecation of the nxp, prefixed properties
in the nxp,kinetis-acmp dts binding.

Signed-off-by: Bjarki Arge Andreasen <bjarki.andreasen@nordicsemi.no>
2024-10-10 20:24:52 -04:00
Nerijus Bendžiūnas
c591994b4f docs: settings: clarify conditions for csi_save_start and csi_save_end
Clarify that the actual calls to these backend functions are made
from `settings_save_subtree()`, which is called by `settings_save()`
or can be used directly.

Signed-off-by: Nerijus Bendžiūnas <nerijus.bendziunas@astrolightspace.com>
2024-10-10 20:24:21 -04:00