Art-Net Plugin
==============

This plugin creates a single device with four input and four output ports
and supports Art-Net, Art-Net 2 and Art-Net 3.

Art-Net limits a single device (identified by a unique IP) to four input and
four output ports, each bound to a separate Art-Net Port Address (see the
Art-Net spec for more details). The Art-Net Port Address is a 16 bits int,
defined as follows:

| Bit 15 | Bits 14 - 8 | Bits 7 - 4 | Bits 3 - 0 |
| ------ | ----------- | ---------- | ---------- |
| 0      | Net         | Sub-Net    | Universe   |

For OLA, the Net and Sub-Net values can be controlled by the config file.
The Universe bits are the `OLA Universe number modulo 16`.

| Art-Net Net | Art-Net Subnet | OLA Universe | Art-Net Port Address |
| ----------- | -------------- | ------------ | -------------------- |
| 0           | 0              | 0            | 0                    |
| 0           | 0              | 1            | 1                    |
| 0           | 0              | 15           | 15                   |
| 0           | 0              | 16           | 0                    |
| 0           | 0              | 17           | 1                    |
| 0           | 1              | 0            | 16                   |
| 0           | 1              | 1            | 17                   |
| 0           | 15             | 0            | 240                  |
| 0           | 15             | 15           | 255                  |
| 1           | 0              | 0            | 256                  |
| 1           | 0              | 1            | 257                  |
| 1           | 0              | 15           | 271                  |
| 1           | 1              | 0            | 272                  |
| 1           | 15             | 0            | 496                  |
| 1           | 15             | 15           | 511                  |

That is `Port Address = (Net << 8) + (Subnet << 4) + (Universe % 16)`


## Config file: `ola-artnet.conf`

`always_broadcast = [true|false]`  
Use Art-Net v1 and always broadcast the DMX data. Turn this on if you have
devices that don't respond to ArtPoll messages.

`ip = [a.b.c.d|<interface_name>]`  
The ip address or interface name to bind to. If not specified it will use
the first non-loopback interface.

`long_name = ola - Art-Net node`  
The long name of the node.

`net = 0`  
The Art-Net Net to use (0-127).

`output_ports = 4`  
The number of output ports (Send Art-Net) to create. Only the first 4 will
appear in ArtPoll messages

`short_name = ola - Art-Net node`  
The short name of the node (first 17 chars will be used).

`subnet = 0`  
The Art-Net subnet to use (0-15).

`use_limited_broadcast = [true|false]`  
When broadcasting, use the limited broadcast address `255.255.255.255`
rather than the subnet directed broadcast address. Some devices which don't
follow the Art-Net spec require this. This only affects ArtDMX packets.

`use_loopback = [true|false]`  
Enable use of the loopback device.