README
1Example of libcoap running on RIOT
2==================================
3
4To build the examples, do
5
6 $ make
7
8This will
9
10* download RIOT from the upstream git sources
11* update the RIOT environment with pkg/libcoap, examples/libcoap-client
12 and examples/libcoap-server taken from pkg_libcoap/, examples_client/
13 and examples_server respectively/.
14 (updates RIOT's libcoap code to the latest commited version in your
15 environment).
16* build the client application
17* build the server application
18
19To run (and/or rebuild) the server application
20
21* cd RIOT/examples-libcoap-server
22* make RIOT_CI_BUILD=1
23* make term
24* (at the shell prompt) coaps start
25
26The server creates a resource for 'time' with a query 'ticks'. This is
27reported for `.well-known/core`. The work flow for adding more resources does
28not differ from regular libcoap usage.
29
30To run (and/or rebuild) the client application
31
32* cd RIOT/examples-libcoap-client
33* make RIOT_CI_BUILD=1
34* make term
35* (at the shell prompt) coapc
36
37The client will try to connect to the URI defined in app.config named
38CONFIG_LIBCOAP_CLIENT_URI (unless overridden by running 'make menuconfig').
39
40Note to developers
41==================
42
43PKG_VERSION= in pkg_libcoap/Makefile needs updating if you need a different
44version of libcoap to get initially installed into RIOT/pkg/libcoap.
45
46Kconfig support is available. Running make in the libcoap distribution
47examples/riot directory will try to add in a 'rsource "libcoap/Kconfig"'
48entry into RIOT/pkg/Kconfig
49