# Library for E1.31 sACN
## `Lightweight streaming protocol for transport of DMX512 using ACN`

## Top level include

Include `sacn.h` for full protocol support.

> ```#include "sacn.h"```

### Requirements
Expects the parent directory to contain the `acn` and `dmx` libraries.

## Logical components

### Protocol Handling
* `sacn.h`: [`SACN`] protocol constants.
* `data.h`: [`SACN::DATA`] protocol support for `VECTOR_ROOT_E131_DATA` packets.
* `extended.h`: [`SACN::EXTENDED`] protocol support for `VECTOR_ROOT_E131_EXTENDED` packets

### Data Classes
* `universe.h`: [`SACN::Universe`]  A set of up to 512 data slots identified by universe number. Note: In E1.31 there may be multiple sources for a universe.
> For protocol agnostic universe refer to the base class, `DMX::Universe`

* `receiver.h`: [`SACN::Receiver`] A receiver is the intended target of information from a source. A receiver may listen on multiple universes.
* `receiver-esp.h`: [`SACN::EspReceiver`] A referance implimention, derived from `SACN::Receiver` for use with ESP devices and Arduino.

## Usage with Arduino

Include `receiver-esp.h` at the top of your sketch.
> ```
> #include "src/lib/sacn/receiver-esp.h"
> ```

Create a receiver object.
> ```
> EspReceiver * e131 = new EspReceiver();
> ```

In `setup`, subscribe to a universe an register a callback for data activity.
> ```
setup() {
  e131->subscribe(1);
  e131->universe(1)->onData(std::bind(&universeHandler,
                                      std::placeholders::_1));
}
>```

Write a handler function with the follow signature (returns `void`, requires 1 argument, a `Universe` pointer):
> ```
void universeHandler(Universe * universe) {
  do something...
}
> ```