rstephan / ArtnetWifi

Arduino library for Art-Net (artnet) over WiFi, send and receive DMX data. Runs on ESP8266, ESP32, Pi Pico W, WiFi101 and WiFiNINA devices.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ArtnetWifi

arduino-library-badge

An Art-Net library for Wifi-Arduino's. Tested on ESP8266, ESP32, Pi Pico W, WiFi101 (e.g. MKR1000) and WiFiNINA (e.g. NANO 33 IoT) devices.

Note: this library assumes you are using a wifi module.

Based on https://github.com/natcl/Artnet master

Installation

Arduino IDE

Navigate to Sketch -> Include Library -> Manage Libraries..., then search for ArtnetWifi and the library will show up. Click Install and the library is ready to use.

PlatformIO Core (CLI)

$ pio init --board nodemcuv2
$ pio lib install artnetwifi

Manual

Place this in your ~/Documents/Arduino/libraries folder.

Examples

Different examples are provided, here is a summary of what each example does.

ArtnetWifiDebug

Simple test for WiFi, serial and Art-Net.

Example output (Serial Monitor, 115200 Baud):

DMX: Univ: 0, Seq: 0, Data (48): 17 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 ...

If this example is not working, don't try anything else!

ArtnetWifiDebug2 (ArtnetWifiDebug with C++11 style)

See ArtnetWifiDebug.

Note: Not all controllers support this type of code!

ArtnetWifiFastLED

This example will receive multiple universes via Art-Net and control a strip of WS2812 LEDs via the FastLED library. It is similar to the NeoPixel example but it will work on the ESP32 and the ESP8266 controller as well.

ArtnetWifiNeoPixel

This example will receive multiple universes via Art-Net and control a strip of WS2811 LEDs via Adafruit's NeoPixel library.

ArtnetWifiTransmit

This is a simple transmitter. Send 3 byte over into the Art-Net, to make a RGB light ramp-up in white.

Notes

The examples FastLED and NeoPixel can utilize many universes to light up hundreds of LEDs. Normaly Art-Net frame can handle 512 bytes. Divide this by 3 colors, so a single universe can have 170.66 LEDs. For easy access, only 170 LEDs are used. The last 2 byte per universe are "lost".

Example: 240 LEDs, 720 Byte, 2 Universes

Universe "1"

Byte 1 2 3 ... 508 509 510 511 512
Color R G B ... R G B x x
LED 1 1 1 ... 170 170 170

Universe "2"

Byte 1 2 3 ... 208 209 210
Color R G B ... R G B
LED 171 171 171 ... 240 240 240

You only have to send 510 byte DMX-data per frame. Extra byte(s) at the end will be ignored!

Art-Net

Art-Net(tm) is a trademark of Artistic Licence Holdings Ltd. The Art-Net protocol and associated documentation is copyright Artistic Licence Holdings Ltd.

Art-Net

About

Arduino library for Art-Net (artnet) over WiFi, send and receive DMX data. Runs on ESP8266, ESP32, Pi Pico W, WiFi101 and WiFiNINA devices.

License:Other


Languages

Language:C++ 100.0%