.. zephyr:code-sample:: coap-server
:name: CoAP service
:relevant-api: coap coap_service
Use the CoAP server subsystem to register CoAP resources.
Overview
********
This sample shows how to register CoAP resources to a main CoAP service.
The CoAP server implementation expects all services and resources to be
available at compile time, as they are put into dedicated sections.
The resource is placed into the correct linker section based on the owning
service's name. A linker file is required, see ``sections-ram.ld`` for an example.
This demo assumes that the platform of choice has networking support,
some adjustments to the configuration may be needed.
The sample will listen for requests on the default CoAP UDP port
(5683 or 5684 for secure CoAP) in the site-local IPv6 multicast address reserved
for CoAP nodes.
The sample exports the following resources:
.. code-block:: none
/test
/seg1/seg2/seg3
/query
/separate
/large
/location-query
/large-update
These resources allow a good part of the ETSI test cases to be run
against coap-server.
Building And Running
********************
Build the CoAP server sample application like this:
.. zephyr-app-commands::
:zephyr-app: samples/net/sockets/coap_server
:board: <board to use>
:goals: build
:compact:
Use :zephyr_file:`overlay-dtls.conf <samples/net/sockets/coap_server/overlay-dtls.conf>`
to build the sample with CoAP secure resources instead.
This project has no output in case of success, the correct
functionality can be verified by using some external tool such as tcpdump
or wireshark.
See the `net-tools`_ project for more details
This sample can be built and executed on QEMU or native_sim board as
described in :ref:`networking_with_host`.
Use this command on the host to run the `libcoap`_ implementation of
the ETSI test cases:
.. code-block:: console
sudo ./examples/etsi_coaptest.sh -i tap0 2001:db8::1
To build the version supporting the TI CC2520 radio, use the supplied
prj_cc2520.conf configuration file enabling IEEE 802.15.4.
.. _`net-tools`: https://github.com/zephyrproject-rtos/net-tools
.. _`libcoap`: https://github.com/obgm/libcoap
Wi-Fi
=====
The IPv4 Wi-Fi support can be enabled in the sample with
:ref:`Wi-Fi snippet <snippet-wifi-ipv4>`.
97f96afbd7