riot-ci/RIOT
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Merge pull request #7097 from haukepetersen/opt_gcoap_moveimplstatus

Browse Source 
net/gcoap: moved implemenation status to gcoap.h
This commit is contained in:
Hauke Petersen 2017-06-01 10:36:20 +02:00 committed by GitHub
commit 9d3abe0d12
2 changed files with 12 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
examples/gcoap/README.md
View File

@ -11,18 +11,6 @@ Build with the standard `Makefile`. Follow the setup [instructions][2] for the g
Build with `Makefile.slip`. Follow the setup instructions in README-slip.md, which are based on the [SLIP instructions][3] for the gnrc_border_router example. We also plan to provide or reference the ethos/UHCP instructions, but we don't have it working yet. Build with `Makefile.slip`. Follow the setup instructions in README-slip.md, which are based on the [SLIP instructions][3] for the gnrc_border_router example. We also plan to provide or reference the ethos/UHCP instructions, but we don't have it working yet.
## Current Status
gcoap includes server and client capability. Available features include:
* Message Type: Supports non-confirmable (NON) messaging. Additionally provides a callback on timeout.
* Observe extension: Provides server-side registration and notifications.
* Server and Client provide helper functions for writing the response/request. See the CoAP topic in the source documentation for details. See the gcoap example for sample implementations.
* Server allows an application to register a 'listener', which includes an array of endpoint paths and function callbacks used to write a response.
* Server listens on a port at startup; defaults to 5683.
* Client operates asynchronously; sends request and then handles response in a user provided callback.
* Client generates token; length defined at compile time.
* Options: Supports Content-Format for payload.
## Example Use ## Example Use
This example uses gcoap as a server on RIOT native. Then we send a request from a libcoap example client on the Linux host. This example uses gcoap as a server on RIOT native. Then we send a request from a libcoap example client on the Linux host.

12
sys/include/net/gcoap.h
View File

@ -171,6 +171,18 @@
* times out. We track the response with an entry in the * times out. We track the response with an entry in the
* `_coap_state.open_reqs` array. * `_coap_state.open_reqs` array.
* *
* ## Implementation Status ##
* gcoap includes server and client capability. Available features include:
*
* - Message Type: Supports non-confirmable (NON) messaging. Additionally provides a callback on timeout.
* - Observe extension: Provides server-side registration and notifications.
* - Server and Client provide helper functions for writing the response/request. See the CoAP topic in the source documentation for details. See the gcoap example for sample implementations.
* - Server allows an application to register a 'listener', which includes an array of endpoint paths and function callbacks used to write a response.
* - Server listens on a port at startup; defaults to 5683.
* - Client operates asynchronously; sends request and then handles response in a user provided callback.
* - Client generates token; length defined at compile time.
* - Options: Supports Content-Format for payload.
*
* @{ * @{
* *
* @file * @file