Crate coap_message_demos[−][src]

Expand description

This crate contains demo applications for CoAP on Rust

All demos use the ecosystem around the coap-message crate. They come in two variations:

  • “applications” contain code that would typically be the high-level code that executes business logic.

    They are a mix of standalone resource implementations, collections thereof into a whole-server handler, and possibly client code.

    They reside in the src/ directory, and are available as library modules. This allows integrating them into other demo code, eg. into examples of a coap-message implementation.

  • “examples” are the stand-alone executable binaries using various backends.

    They pick suitable applications, and wrap them with a CoAP implementation of choice into a program that can be run with cargo run --example X.

    Currently, the examples in this crate show the use of:

    • coap-lite, a building block for CoAP-over-UDP libraries, running directly on a socket in the example.

    • the coap crate, which provides a full implementation, and can interface with coap-message by virtue of using coap-lite as a backend.

    • embedded-nal-minimal-coapserver, which implements CoAP-over-UDP on the Embedded Network Abstraction Layer and processes messages through the coap_handler types. For the example, it uses a std implementation of embedded-nal.

    Examples that need larger ecosystem support and can not simply be launched natively by cargo run --example are not included here, but show (maybe even better) what the coap-message ecosystem is capable of providing:

    • verdigris is an implementation of CoAP that runs in the web browser and uses CoAP-over-WebSockets. It includes the demo applications in its color server sub-application, where they can be accessed through a proxying Resource Directory.

    • RIOT is an embedded operating system for the Internet of Things. In the examples of its Rust bindings, the coap_through_embeddednal application runs the no_std part of the demo applications using the same embedded-nal-minimal-coapserver crate as the local example, but using RIOT’s sockets instead of POSIX sockets.

Usage

The examples are all configured to run a selection of the applications; which they are depends on the selected features.

For minimal operation, run the examples as

$ cargo +nightly run --example EXNAME --features example-EXNAME

where EXNAME is substituted with any of the examples – currently coaplite, coap_crate or std_embedded_nal_minicoapserver.

To explore all features, just run with

$ cargo +nightly run --example EXNAME --all-features

which, for example, adds access to a system ::log.

All the same can be accessed, for example, by using aiocoap-client:

$ aiocoap-client coap://localhost/.well-known/core
</>; ct="0"; title="Landing page",
</time>; ct="0"; title="Clock",
</cbor/1>; ct="60",
</cbor/2>; ct="60",
</cbor>; ct="60",
</message/warning>; title="POST warning texts here",
</message/info>; title="POST info texts here"

$ aiocoap-client coap://localhost/cbor
{'hidden': False, 'number': 32, 'label': 'Hello', 'list': [1, 2, 3]}

Modules

cbor

This module demonstrates the use of coap_handler_implementations::SimpleCBORHandler

helloworld

This module contains simple hello-world-ish handlers

log

Logging demo application

Functions

full_application_tree

Build a handler that contains all the demo applications

Type Definitions

FullHandler