Commit Graph

5243 Commits

Author SHA1 Message Date
Daniel DeGrasse
8a686cac53 docs: flash_debug: host_tools: Fix reference to jlink host tools
Fix reference to JLink host tools to be located in correct section, so
that output documentation fills in the correct header name when this
section is referenced.

Signed-off-by: Daniel DeGrasse <daniel.degrasse@nxp.com>
2023-07-11 13:15:06 -04:00
Chaitanya Tata
521e129528 doc: net: Add an entry about Wi-Fi Network managers
Add the entry to convey support for Wi-Fi Network Managers in Zephyr.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
2023-07-11 14:55:30 +02:00
Chaitanya Tata
ea0084bfb9 doc: net: Add an entry for Wi-Fi Management
This was missing all along.

Signed-off-by: Chaitanya Tata <Chaitanya.Tata@nordicsemi.no>
2023-07-11 14:55:30 +02:00
Jamie McCrae
c81f8d7721 doc: mgmt: mcumgr: Fix double maps
Fixes an issue where double maps were shown for some items,
and one whereby there was excess text.

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>
2023-07-10 15:27:25 +02:00
Jamie McCrae
7fa4570d10 doc: mgmt: mcumgr: Fix date typo
Fixes an issue where data was used instead of date

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>
2023-07-10 12:05:14 +02:00
Jamie McCrae
d98656f081 doc: kernel: code-relocation: Remove erroneous note
The note about required position for the function is not valid.

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>
2023-07-10 10:01:42 +00:00
Kirill Kobelev
4a8d61248a doc: introduction: Improve style and grammar across the chapter
The changes are cosmetic and they do not change the meaning of the docs.

Signed-off-by: Kirill Kobelev <kobelev17@cdsan.com>
2023-07-10 10:01:08 +00:00
Yong Cong Sin
4580708f54 posix: implement uname
Add implementation for posix uname.

Signed-off-by: Yong Cong Sin <ycsin@meta.com>
2023-07-09 16:57:16 -04:00
Jakub Duchniewicz
adc36315b0 doc: Fix typos in zbus documentation
Fixes a few typos.

Signed-off-by: Jakub Duchniewicz <j.duchniewicz@gmail.com>
2023-07-09 19:58:59 +00:00
Harshil Bhatt
322cd468db docs: update posix docs with pthread_barrierattr
add pthread_barrierattr to supported api list

Signed-off-by: Harshil Bhatt <harshilbhatt2001@gmail.com>
2023-07-09 10:40:57 -04:00
Aaron Massey
e1401fcf5e emul: Add SBS Gauge emulator backend_api
In order to support easier setup of test scenarios with fuel gauge
emulators, we should expose an API that can change internal emulator state.

Add a minimal fuel gauge emulator backend API for setting the charging
current and voltage with a sample implementation in the emul_sbs_gauge with
an associated driver test.

Signed-off-by: Aaron Massey <aaronmassey@google.com>
2023-07-07 09:22:20 +02:00
Aleksandr Khromykh
9b4d080419 Bluetooth: Mesh: add shell statistic commands
Commit adds commands to get and to clear
the frame statistic.

Signed-off-by: Aleksandr Khromykh <aleksandr.khromykh@nordicsemi.no>
2023-07-07 09:20:33 +02:00
Aleksandr Khromykh
7199425792 Bluetooth: Mesh: add statistic module
PR adds the statistic module to estimate frame handling.
The module helps to understand the ratio of
the received\relayed\dropped\transmited frames.
That shows the efficiency of the current configuration\implementation.

Signed-off-by: Aleksandr Khromykh <aleksandr.khromykh@nordicsemi.no>
2023-07-07 09:20:33 +02:00
Piotr Golyzniak
65d0216f1d doc: bsim: fix typo in build link
Fix typo in link to BabbleSim build page.

Signed-off-by: Piotr Golyzniak <piotr.golyzniak@nordicsemi.no>
2023-07-06 17:07:20 +02:00
Christopher Friedt
1f8d2e492e doc: services: portability: posix: support for POSIX_SPIN_LOCKS
Ensure `POSIX_SPIN_LOCKS` are documented as part of the
mandatory option requirements according to IEEE Std 1003.1-2017.

Additionally, list the functions implemented according to the
standard.

Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2023-07-05 21:06:55 -04:00
Michael Jones
34e50037f0 doc: Log unused log filter patterns
This allows us to identify any patterns that we can remove or that
we didn't realise are no longer in use. This might happen if issues
within doxygen or docleaf are resolved.

This allows us to remove the pattern:

  .*Duplicate C declaration.*\n.*'\.\. c:.*:: uint16_t id'.*

which does not match anything in the current set up.

We also split the filter patterns in known-warnings out into different
sections depending on their cause.

Also extend the pattern parser to ignore empty lines so that we can
have some formatting in the known-warnings file.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
3127d7b54c doc: Add more known-warnings
We should probably clear out the old warnings and see what still
applies for docleaf now that we have that instead of breathe.

However for this moment, these are new duplication declarations that
we're seeing errors for and so we'd like to silence them.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
56d7afeac9 doc: Make sure message is a string before regexing it
There are times when the log message is an exception object and that
causes the regex to fail with a TypeError. Here we work around that
by converting the input to a string.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
88c1519414 doc: Remove :members: on doxygengroup directives
As that is not supported by docleaf. We get everything by default.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
a3b7102273 doc: Adjust docleaf configuration as needed
We make sure that we have the 'root' and 'xml' defined for the project
which is necessary at the moment for docleaf though the 'root' is only
really used for the 'linkcode' integration.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
10cb87dc2b doc: Replace instances of 'Breathe' with 'Docleaf'
Where valid.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
30c3ce4a92 doc: Update requirements-doc.txt to use docleaf
Instead of breathe.

I'm not sure of the best version comparison to use. There is no
intention to break the API for docleaf but it is also still young
in some ways and there might be adjustments to the configuration values
that would need to be reflected in the version number as it is still
pre-1.0 that would only be a minor version change.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Michael Jones
20986ec45d doc: Switch to using docleaf for doxygen entities
This switches the Sphinx conf.py file over to using the
'docleaf.doxygen' module and the associated docleaf configuration
entries, replacing the breathe module and config.

Signed-off-by: Michael Jones <m.pricejones@gmail.com>
2023-07-03 10:05:52 +00:00
Emil Gydesen
49a70aa1bb Bluetooth: TMAP: Add TMAP shell module
Add simple TMAP shell module that supports the TMAP
discovery.

Signed-off-by: Emil Gydesen <emil.gydesen@nordicsemi.no>
2023-06-30 16:10:51 +02:00
Florian Grandel
5fa5534afc doc: kernel: clocks: define "current time"
Scheduling relative timeouts from within timer callbacks (=sys clock ISR
context) differs from scheduling relative timeouts from an application
context.

This change documents and explains the rationale of this distinction.

Signed-off-by: Florian Grandel <fgrandel@code-for-humans.de>
2023-06-30 16:07:26 +02:00
Pavel Vasilyev
737afd31fe doc: bluetooth: mesh: Add dfu cli cancel command to doc
Add description of the `mesh model dfu cli cancel` shell command.

Signed-off-by: Pavel Vasilyev <pavel.vasilyev@nordicsemi.no>
2023-06-29 21:07:16 +02:00
Ajay Parida
f1ebbb6c1f doc: release-notes: add passive scan support release notes
Added Wi-Fi passive scan support related info.

Signed-off-by: Ajay Parida <ajay.parida@nordicsemi.no>
2023-06-29 21:05:41 +02:00
Pavel Vasilyev
5572a27468 docs: bluetooth: mesh: Add note about storing runtime configuration
All public API declared in cfg.h won't schedule storing of the change
persistently if BT_MESH_VALID flag is not set. The flag is set after the
node is provisioned.

Signed-off-by: Pavel Vasilyev <pavel.vasilyev@nordicsemi.no>
2023-06-29 21:04:55 +02:00
Dawid Niedzwiecki
c8c149dce8 mgmt: ec_host_cmd: add logging system
Add a native way to log Host Command communication.

Use Zephyr logging system to do it. Use debug and normal levels.

Signed-off-by: Dawid Niedzwiecki <dawidn@google.com>
2023-06-26 16:13:42 +02:00
Seppo Takalo
55451c6d6e doc: Document various LwM2M security modes
Add documentation regarding various LwM2M security modes.

Signed-off-by: Seppo Takalo <seppo.takalo@nordicsemi.no>
2023-06-26 12:35:29 +00:00
Benjamin Cabé
e7414495fa doc: release: add Zephyr 3.4 as supported release
Add Zephyr 3.4 as a supported release until end of Feb 2024.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2023-06-25 17:18:18 +02:00
Benjamin Cabé
89f15cb2f3 doc: release: update dates to ISO 8601
Write dates as ISO 8601 as previous notation could be confusing.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
2023-06-25 17:18:18 +02:00
Christopher Friedt
b416a90672 doc: services: posix: pthread_mutexattr_destroy init supported
The functions pthread_mutexattr_destroy()
and pthread_mutexattr_init() are implemented (they just do nothing).

Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2023-06-25 02:47:47 -04:00
Christopher Friedt
64a477342d doc: services: posix: pthread_condattr_destroy and init supported
The functions pthread_condattr_destroy()
and pthread_condattr_init() are implemented (they just do nothing).

Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2023-06-25 02:47:47 -04:00
Christopher Friedt
675a660727 doc: services: posix: _POSIX_THREAD_PRIO_INHERIT unsupported
_POSIX_THREAD_PRIO_INHERIT was mistakenly marked supported in
commit a07774eada presumably because we have prototypes for the
functions below.

pthread_mutexattr_getprotocol()
pthread_mutexattr_setprotocol()

However, the functions are not actually implemented in Zephyr.

Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2023-06-25 02:47:47 -04:00
Christopher Friedt
88dd32c38c doc: services: posix: fix setvbuf typo
Fix a typo in the spelling of `setvbuf()`.

Signed-off-by: Christopher Friedt <cfriedt@meta.com>
2023-06-25 02:47:47 -04:00
Alberto Escolar Piedras
eccefc4dcc doc: contribute external: Fix link and add if not Apache2
The link to the zephyr_licensing page was broken
=> fix it.

Also add a relatively evident if to the list:
There is no need to add an entry to the licensing
list if the integrated code is Apache 2.

Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-06-25 02:46:42 -04:00
Alberto Escolar Piedras
a64499dae1 doc licensing: Remove get_maintainers.pl
There is no get_maintainers.pl in the tree, and
hasn't been for as long as the git history lasts.

Remove its mentiona as a GPL component.

get_maintainers.py is Apache 2.

Signed-off-by: Alberto Escolar Piedras <alberto.escolar.piedras@nordicsemi.no>
2023-06-25 02:46:42 -04:00
Evgeniy Paltsev
daa5057800 ARC: MWDT: update docs to reflect recent changes
Update docs to reflect recent changes:
 * ARCMWDT_TOOLCHAIN_PATH auto detecting
 * Usage GNU helper tools from Zephyr SDK

Signed-off-by: Eugeniy Paltsev <Eugeniy.Paltsev@synopsys.com>
Signed-off-by: Evgeniy Paltsev <PaltsevEvgeniy@gmail.com>
2023-06-25 02:45:56 -04:00
Anas Nashif
d6ce537be8 doc: kernel: update thread priorities diagram
cooperative priorities are negative, 0 is not a cooperative priority.
Looks like the docs are showing an outdated diagram for some reason, try
to update that with a refresh.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-06-23 14:27:22 -04:00
Anas Nashif
54fcffb2c7 doc: twister: adapt docs for --enable-slow-only
Minor modification to accomodate for --enable-slow-only.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-06-22 17:14:02 -04:00
Simon Hein
e908f88920 docs: safety: Add safety documentation
Add the safety documentation to the Zephyr documentation tree.
Starts with the safety overview which describes the general goals
for the safety in zephyr and introduces a process overview how a safety
certification can be achieved in the zephyr project.

Signed-off-by: Simon Hein <Shein@baumer.com>
2023-06-22 06:01:39 -04:00
Huifeng Zhang
b789a019e7 doc: release-notes: Add TF-A v3.5.0 notes
Add release notes for TF-A for the 3.5.0 release.

Signed-off-by: Huifeng Zhang <Huifeng.Zhang@arm.com>
2023-06-22 10:47:25 +02:00
Lucas Tamborrino
9ae80aabd9 doc: services: debug: coredump: add flash partition
Add flash partition guide to coredump documentation.

Signed-off-by: Lucas Tamborrino <lucas.tamborrino@espressif.com>
2023-06-21 16:06:06 -04:00
Peter Mitsis
4c7aeb252d doc: Correct msgq data item size discrepancy
Updates the data passing summary table to indicate that the size of
a message queue data item must be a multiple of its data alignment.
This brings the documentation in both the summary table and the
message queue documentation into alignment.

Signed-off-by: Peter Mitsis <peter.mitsis@intel.com>
2023-06-21 13:57:15 -04:00
Jamie McCrae
eff9f731b1 doc: release: 3.5: Add note on MGMT_EVT_OP_CMD_RECV
Adds a note that this MCUmgr notification hook can now be used
to reject commands and send an error back to the client.

Signed-off-by: Jamie McCrae <jamie.mccrae@nordicsemi.no>
2023-06-21 13:24:12 +02:00
Gerard Marull-Paretas
92707866d1 device: s/gen_handles/gen_device_deps
Rename the gen_handles script and all of its references/associated files
to gen_device_deps. The new new makes things more clear, because the
script just take care of generating, for each device, an array of device
dependencies. While device handles are used internally to store this
information, it is in reality an implementation detail.

Signed-off-by: Gerard Marull-Paretas <gerard.marull@nordicsemi.no>
2023-06-21 09:32:05 +02:00
Grzegorz Chwierut
732dd4843d twister: pytest: Simplify interface to pytest-twister-harness
Add DeviceAbstract class to default imports from pytest-twister-harness
package to simplify importing DUT package, when creating tests.

Signed-off-by: Grzegorz Chwierut <grzegorz.chwierut@nordicsemi.no>
2023-06-20 14:46:55 -04:00
Aleksandr Khromykh
cd4bfc8c43 doc: Bluetooth: Mesh: add link to adv id subclause
PR adds link to advertisement identity coexistence subclause.

Signed-off-by: Aleksandr Khromykh <aleksandr.khromykh@nordicsemi.no>
2023-06-20 09:27:23 +02:00
Anas Nashif
9fd9c9dd4f doc: sensing: fix structure and remove top doxygen reference
Move sections out of the Overview section and put API documentation in
one section without bullets, which was causing duplication in headers
and text.

This also fixes the issue with PDF generation which is currently
blocking publication of HTML pages on docs.zephyrproject.org.

Signed-off-by: Anas Nashif <anas.nashif@intel.com>
2023-06-19 22:09:47 -04:00