-
Notifications
You must be signed in to change notification settings - Fork 2k
nanocoap Home
nanocoap is a native implementation of CoAP for RIOT. Client messages are processed synchronously: a client waits for the the function that sends the request to return with the response. A CoAP server runs in a dedicated application thread.
| Feature | Description |
|---|---|
| Confirmable message type | Supports piggybacked ACKs |
| Block extension | Provides server implementation for Block1 and Block2; see #10732 for client implementations |
| Observe extension | Not implemented |
See the online API documentation for nanocoap itself, as well as generic CoAP definitions. Also, see the examples/nanocoap_server app.
| Topic | Status |
|---|
See all open 'nanocoap' PRs and Issues. See all CoAP-tagged PRs and Issues.
See #9309 for combined gcoap and nanocoap roadmap for options handling. As of 11/2018, much of this work has been completed.
The blockwise API was completed with #10732. However, some old implementations remain; see candidate list below. Deprecate them and replace usage as appropriate.
- coap_put_option_block1() -- replace with coap_opt_put_block1_control()
- coap_put_block1_ok() -- currently a wrapper around coap_put_option_block1(); still necessary?
- coap_get_blockopt() -- replace with coap_get_block()?
#12074 adds coap_opt_get_next() to the nanocoap interface to iterate over options. Replace use of the nanocoap internal coap_iterate_option(), which only iterates over a single option.
#11093 adds definitions for the new methods FETCH, PATCH, and iPATCH. Add full support for them.
Extend nanocoap_request() to allow sending a request non-confirmably.
| Release | Description |
|---|---|
| 2018.10 | Added Block2 server support (#8932) |
| 2018.10 | Get/Put specific string options based on generic string option functions (#8920). |
| 2018.07 | Generalize nanocoap_get() to nanocoap_request() (#9086). |
| 2018.07 | Use coap_pkt_t to create message, and use this to provide a simpler API for options (#9085). |
| 2018.04 | Added Block1 server support (#8788). |
| 2018.01 | Integrate as RIOT module (#8123). Historically was an external package. |