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.