Bronze

Bronze is a CoAP framework generally
aimed at making high performance CoAP servers. It’s not currently intended for
use on especially resource constrained devices, but that is a long-term goal.

Bronze is written using mio for all network requests, this means that it has
very low overheads and it should be possible to make it into a very fast and
efficient system.

Status

Bronze is incomplete and you likely shouldn’t use it.

Currently it is possible to create servers that directly deal with incoming
CoAP packets, but there is not yet any automatic handling of retries or
multi-packet messages.

There is not yet any implementation of client requests.

No benchmarks have been done to determine if Bronze in it’s current state is as
fast as it could be.

Getting Started

To use Bronze, add the following to your Cargo.toml:

[dependencies]
bronze = "0.1"

Then you’ll need to create a run the server, a simple example of this would be:

extern crate bronze;
use bronze::endpoint::Endpoint;
use bronze::nullhandler::NullHandler;
fn main() {
    let local_addr = "127.0.0.1:5683".parse().unwrap();
    println!("CoAP Server Listening on {}", local_addr);
    Endpoint::new(local_addr).run(NullHandler);
}

This example uses the included NullHandler which is an example of how to write
a message handler. NullHandler simply replies to any valid CoAP packets that
would expect a response with a RST message.