The sACN (streaming ACN) protocol is supported in Artistic Licence ethernet products. The differences between Art-Net and sACN lead to some minor clashes which this document seeks to clarify.
In Art-Net, universes are called Port-Address and number from 0 to 32,767. There are 32,768 unique numbers.
In sACN, universes number from 1 to 63,999. There are 64,000 unique numbers. The standard reserves the values of 0 and 64,000 to 65,535 for future expansion.
Clearly there is the potential for confusion over the number ‘0’. If a universe is set to ‘0’ and the sACN protocol is selected, Artistic Licence products will use a universe value of ‘1’ instead.
Merging and arbitration
The sACN protocol uses a concept called Component Identifier (CID) as a method to optionally distinguish unique streams of data, and a concept called Priority as a method to define the priority of a stream.
The following table defines how sACN packets A & B are arbitrated or merged when directed to same universe.
Numerous of the Art-Net packets contain Version numbers.
These can be either the version number of Art-Net or the Node’s version number. The terms ProtVerHi / ProtVerLo are used to describe the Art-Net protocol version number. This has never been changed and is set at:
- ProtVerHi = 0
- ProtVerLo = 14
The terms VersInfoH / VersInfoL are used to describe the Node’s version number. This field is defined by the manufacturer and usually contains the firmware revision number. The ArtPollReply message contains this information.
Art-Net allows and supports multiple controllers on a network. When there are multiple controllers, Nodes will receive ArtPolls from different controllers which may contain conflicting diagnostics requirements. This is resolved as follows:
- If any controller requests diagnostics, the node will send diagnostics. (ArtPoll->Flags->2).
- If there are multiple controllers requesting diagnostics, diagnostics shall be broadcast. (Ignore ArtPoll->Flags->3).
- The lowest minimum value of Priority shall be used. (Ignore ArtPoll->Priority).
A Node must respond to an ArtPoll with an ArtPollReply within 3 seconds. If the Controller does not receive a response in this time it should consider the Node to have disconnected. It is a requirement of Art-Net that all controllers broadcast an ArtPoll every 2.5 to 3 seconds. This ensures that any network devices can easily detect a disconnect.
In order to make a product visible in DMX-Workshop, the product must reply to an ArtPoll with one or more ArtPollReply. The screenshot below shows a Wire Shark capture of the ArtPollReply packets from a Data-Lynx IOP.
Common errors in formatting ArtPollReply are:
1) The text signature at the top of the packet is “Art-Net”. It is case sensitive.
2) DMX-Workshop only listens on Port 6454 (decimal).
If you have difficulty making your product visible in DMX-Workshop then submit a Wire Shark capture on a support ticket and we will try to help.
To apply for an OEM code please follow the instructions here.
Please be aware that OEM code requests are processed once per month.
Applications which include product names containing “Art”, “Art-Net”, “Artistic”, “Licence” and similar will not be accepted.
Our gateway products, which include artLynx uno, artLynx duo, artLynx quad, artLynx RJ45, netLynx quad, rackLynx octo and dataLynx II all have a factory reset switch. To reset to factory defaults, hold down the switch and cycle the power. Once you have reset to the factory default, the IP address will change. See Gateway: Finding the IP Address of a product.
The IP address of legacy Artistic Licence network products can be reset to factory default using the front panel controls as described below:
IP reset procedure (legacy products)
A: Set Sub-Net wheel and both Universe wheels to F, power off, power on.
B: Set Sub-Net wheel to 9, power off, power on, power off, set Sub-Net wheel to F, power on.
|Product||IP reset procedure|
|Multichrome E1 & E2||A|
There are three methods for finding the IP address of an Art-Net product:
- Connect using DMX-Workshop, this will display the product in a network list along with its IP address. DMX-Workshop can be downloaded from here. DMX-Workshop provides a gateway recovery system that uses the RDMnet – LLRP protocol. This allows a gateway to be recovered even when it is on a totally different IP range to DMX-Workshop. The LSI article HelpDesk17-Low-level-recovery-Oct2018 explains this in more detail.
- Ping: Open a command line window and use the ping command. If the products are on the normal Art-Net address range, type: “ping 126.96.36.199”. This approach is best on a Mac as Macs do not support net-bios.
- Perform a net-bios search (Windows only). To do this, connect the product to your laptop’s network, open browser and type in the net-bios name of the product you are using (see below). Occasionally the net-bios cache in the browser gets out of date. To flush the cache and restart, type “nbtstat -R” in the browser window.
Current Products (product code – net-bios name)
- oemGate quad – oemGatequad
- rackLynx octo – rackLynx
- daliGate quad – daliGatequad
- netLynx quad – netLynxquad
- dataLynx II – dataLynxII
- artLynx duo – artLynxduo
- artLynx quad – artLynxquad
- artLynx RJ45 – artLynxRJ45
- versaSplit EthB – VersaEtherB
Legacy Products (product code – net-bios name)
- Data-Lynx O/P – DATALYNXOP
- Data-Lynx I/P – DATALYNXIP
- Data-Lynx I/OP – DATALYNXIO
- Down-Lynx – DownLynx
- Up-Lynx – UpLynx
- Net-Lynx O/P – NetLynxOp
- Net-Lynx I/P – NetLynxIp
- Cata-Lynx I/P – CataLynxIp
- Cata-Lynx O/P – CataLynxOp
- Ether-Lynx II – EtherLynxII
- Art-Lynx O/P – ArtLynxOp
- Art-Lynx I/P – ArtLynxIp
- Art-Pipe – ArtPipe
- Art-Relay – ArtRelay
- Multichrome E2 – E2MultiChrome
- Eaton / Cooper Controls EN2RDM – EN2RDM
- Eaton / Cooper Controls EN8RDM – EN8RDM
- Thorn SensaDMX – SENSAEDMX
- Lex Products LexNet – LEXNET