dmx-web-api v0.2.8

DMX Control directly from your browser

This super tiny lib knows how to talk DMX through browser's Web Serial API. Works with Enttec's Open DMX as well as the Pro version, and Eurolite's USB-DMX512 PRO Interface MK2.

Patches for other devices are most welcome!

Note: the API is supported by Chrome only!

Unfortunately other browsers do not yet support neither the Serial nor USB API's, generally claiming security reasons.

Linux

On linux, the user running the browser needs to be in the dialout group, so make sure you run this line:

sudo usermod -a -G dialout $USER

And then reboot your device.

Install

npm install dmx-web-api

Demo

import {DMX, BufferedBackend} from "dmx-web-api";

let dmxDevice = new DMX();

function initDMX() {
    `The three params passed into init are as follows:
      * onTick - callback that will be executed on every tick
      * backendClass - the class of the backend widget - there seem to be two types - direct communication and buffered.
        Buffered is the pro version and is recommended as it also comes with power isolation and other bits and bobs.
      * requestAccess - default:false, when set to true will ask user to give us access. you can do that only on
        user action. so on init you can call it with false, and then have an interface element that allows user to
        enable access to the device`;
    this.dmxDevice.connect(null, BufferedBackend, true);
}

function updateDMX(data) {
    // data can be either an object of form {channel: value}, or a full 512 element array.
    // set first channel to 255 (say, because you have a simple RGB light listening on address 1)
    this.dmxDevice.update({1: 255, 2: 0, 3: 0});
}

Note on Enttec's Open DMX

Make sure the tab you are sending the signal from is visible at all times, as chrome will spin down the internal timers when the tab is not visible, and you will get flickering lights. A simple way around that is to run a tiny node server and talk sockets to it. Code for doing that is in the github repo.