Skip to content

Commit

Permalink
net: doc: Reference the Kconfig option that enables app libraries
Browse files Browse the repository at this point in the history
Several application protocol libraries documentation missed information
on how can they be enabled (i. e. missed info about associated Kconfig
symbol). This commit fixes it.

Signed-off-by: Robert Lubos <robert.lubos@nordicsemi.no>
  • Loading branch information
rlubos committed Dec 5, 2023
1 parent c94cd30 commit 2534a09
Show file tree
Hide file tree
Showing 7 changed files with 16 additions and 3 deletions.
3 changes: 2 additions & 1 deletion doc/connectivity/networking/api/coap.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ that support CoAP's features. For more information about the protocol
itself, see `IETF RFC7252 The Constrained Application Protocol <https://tools.ietf.org/html/rfc7252>`_.

Zephyr provides a CoAP library which supports client and server roles.
The library is configurable as per user needs. The Zephyr CoAP library
The library can be enabled with :kconfig:option:`CONFIG_COAP` Kconfig option and
is configurable as per user needs. The Zephyr CoAP library
is implemented using plain buffers. Users of the API create sockets
for communication and pass the buffer to the library for parsing and other
purposes. The library itself doesn't create any sockets for users.
Expand Down
1 change: 1 addition & 0 deletions doc/connectivity/networking/api/coap_client.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ Overview
********

The CoAP client library allows application to send CoAP requests and parse CoAP responses.
The library can be enabled with :kconfig:option:`CONFIG_COAP_CLIENT` Kconfig option.
The application is notified about the response via a callback that is provided to the API
in the request. The CoAP client handles the communication over sockets.
As the CoAP client doesn't create socket it is using, the application is responsible for creating
Expand Down
1 change: 1 addition & 0 deletions doc/connectivity/networking/api/http.rst
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ Overview
The HTTP client library allows you to send HTTP requests and
parse HTTP responses. The library communicates over the sockets
API but it does not create sockets on its own.
It can be enabled with :kconfig:option:`CONFIG_HTTP_CLIENT` Kconfig option.

The application must be responsible for creating a socket and passing it to the library.
Therefore, depending on the application's needs, the library can communicate over
Expand Down
2 changes: 2 additions & 0 deletions doc/connectivity/networking/api/lwm2m.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ REST API to manage various interfaces with the client.
LwM2M uses a simple resource model with the core set of objects and resources
defined in the specification.

The LwM2M library can be enabled with :kconfig:option:`CONFIG_LWM2M` Kconfig option.

Example LwM2M object and resources: Device
******************************************

Expand Down
3 changes: 2 additions & 1 deletion doc/connectivity/networking/api/mqtt.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ publish/subscribe messaging transport for machine-to-machine communication.
For more information about the protocol itself, see http://mqtt.org/.

Zephyr provides an MQTT client library built on top of BSD sockets API. The
library is configurable at a per-client basis, with support for MQTT versions
library can be enabled with :kconfig:option:`CONFIG_MQTT_LIB` Kconfig option and
is configurable at a per-client basis, with support for MQTT versions
3.1.0 and 3.1.1. The Zephyr MQTT implementation can be used with either plain
sockets communicating over TCP, or with secure sockets communicating over
TLS. See :ref:`bsd_sockets_interface` for more information about Zephyr sockets.
Expand Down
3 changes: 2 additions & 1 deletion doc/connectivity/networking/api/mqtt_sn.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,8 @@ over any message-based transport. Originally, it was mainly created with ZigBee
but others like Bluetooth, UDP or even a UART can be used just as well.

Zephyr provides an MQTT-SN client library built on top of BSD sockets API. The
library is configurable at a per-client basis, with support for MQTT-SN version
library can be enabled with :kconfig:option:`CONFIG_MQTT_SN_LIB` Kconfig option
and is configurable at a per-client basis, with support for MQTT-SN version
1.2. The Zephyr MQTT-SN implementation can be used with any message-based transport,
but support for UDP is already built-in.

Expand Down
6 changes: 6 additions & 0 deletions doc/connectivity/networking/api/tftp.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,12 @@
TFTP
####

Zephyr provides a simple TFTP client library that can enabled with
:kconfig:option:`CONFIG_MQTT_SN_LIB` Kconfig option.

See :zephyr:code-sample:`TFTP client sample application <tftp-client>` for
more information about the library usage.

API Reference
*************

Expand Down

0 comments on commit 2534a09

Please sign in to comment.