Output#

Functions#

disable_output#

Disable the output of a specified protocol from the controller. Propagates to all controllers in a project.

disable_output(params, callback)

params is expected to be an object with the following attributes:

Attribute

Value Type

Description

Value Example

protocol

string

Protocol to disable. Options: dmx, pathport, sacn, art-net, kinet, rio-dmx, edn, edn-spi.

"parthport"

enable_output#

Enable the output of a specified protocol from the controller. Propagates to all controllers in a project.

enable_output(params, callback)

params is expected to be an object with the following attributes:

Attribute

Value Type

Description

Value Example

protocol

string

Protocol to enable. Options: dmx, pathport, sacn, art-net, kinet, rio-dmx, edn, edn-spi.

"parthport"

get_output#

Returns the lighting levels being output by the queried controller.

get_output(universeKey, callback)

Returns an object with the same attributes as in the HTTP GET response.

universeKey can be a string (see Universe Key String Format) or it can be an object with the following attributes:

Attribute

Value Type

Description

protocol

integer

Constants defined in query.js are: DMX (1), PATHPORT (2), ARTNET (4), KINET (8), SACN (16), DVI (32), RIO_DMX (64), EDN (128)

index

integer

Required unless protocol is KINET, RIO_DMX or EDN

kinet_power_supply_num

integer

Only required if protocol is KINET

kinet_port

integer

Only required if protocol is KINET

remote_device_type

integer

Only required if protocol is RIO_DMX or EDN

remote_device_num

integer

Only required if protocol is RIO_DMX or EDN

port

integer

Only required if protocol is EDN

For example:

Query.get_output({
    protocol: KINET,
    kinet_port: 1,
    kinet_power_supply_num: 1
  }, u => {
  console.log(u)
  }
)

Query.get_output({
    protocol: DMX,
    index: 1
  }, u => {
    console.log(u)
  }
)

Query.get_output("dmx:1", u => {
  console.log(u)
})

Universe Key String Format#

A universe key string takes the form:

  • protocol:index for protocols dmx, pathport, sacn, art-net;

  • protocol:kinetPowerSupplyNum:kinetPort for protocol kinet;

  • protocol:remoteDeviceType:remoteDeviceNum for protocol rio-dmx;

  • protocol:remoteDeviceType:remoteDeviceNum:port for protocols edn, edn-spi.

Where:

  • kinetPowerSupplyNum is an integer;

  • kinetPort is an integer;

  • remoteDeviceType can be rio08, rio44 or rio80, edn10 or edn20;

  • remoteDeviceNum is an integer;

  • port is an integer.

For example:

  • "dmx:1"

  • "rio-dmx:rio44:1"