Outputting DMX

Initialization

To initialize pySimpleDMX, initialize a pysimpledmx.DMXConnection() object, using the com port number of your enttec DMX USB Pro as an argument. For example, if our DMX USB Pro is on com port 3, we would initialize our dmx connection using dmx = pysimpledmx.DMXConnection(3)

If for any reason the dmx connection fails to initialize on the provided com port, pysimpledmx will let you know via the console and close.

Usage

DMX output through pySimpleDMX is managed using a local list of size 512 in the DMXConnection() object, which represents the values for all 512 dmx channels in a single universe. When initialized, the default value for each channel is zero. to push the current list of values out over the dmx network, or 'update' the network, you must call the .render() method on your DMXConnection() object.

to change the value for a channel, use the setChannel() method on your DMXConnection() object. setChannel() requires chan (channel) and val (value) arguments, as well as an optional autorender argument, which should be set to True if you wish to have PySimpleDMX automatically update the dmx output immediately upon changing the specified channel value.

the chan and val arguments should be between 1 and 512 and between 0 and 256, respectively.

unless the autorender argument is specified True, the .render() method must be called to update the dmx output. because of the serial communication with the DMX USB Pro, this is a relatively slow operation, and thus rendering should be done sparingly to avoid bottlenecking.