Personal tools
The Open Lighting Project has moved!

We've launched our new site at www.openlighting.org. This wiki will remain and be updated with more technical information.

Difference between revisions of "USB Protocol Extensions"

From wiki.openlighting.org

Jump to: navigation, search
(Created page with 'This documents the additional message types added to the Enttec DMX USB Pro protocol to support multiple device types. As the number of devices supporting the protocol gr…')
 
Line 1: Line 1:
This documents the additional message types added to the [[Enttec]] [[DMX USB Pro]] protocol to support multiple device types. As the number of devices supporting the protocol grows, it becomes difficult for software like [[OLA]] to differentiate the device types.
+
This documents the additional message types added to the [[Enttec]] [[DMX USB Pro]] protocol to support multiple device types. As the number of devices supporting the protocol grows, it becomes difficult for software like [[OLA]] to differentiate the device types. The ''Device Manufacturer'' & ''Device Name'' messages allow the host software to determine the device and know which set of messages it supports.
  
 +
== Other Solutions ==
  
== Device Manufacturer ==
+
=== USB Serial Number ===
  
 +
Enttec USB Pro devices have only started programming the serial numbers recently (>2008?).
 +
When using the standard USB Serial drivers on Mac & Linux, the host application doesn't have access to the serial numbers. This would require us to write our own USB drivers using libusb to expose this information.
  
== Device Name ==
+
=== Use the User Addressable EEPROM ===
  
 +
Some devices don't support the ''Set Widget Parameters'' message so this isn't an option. Also it suffers from the bootstrapping issue, we need to know what device it is before we can write the information about what device it is...
 +
 +
== Device Manufacturer, Label = 77, no data ==
 +
 +
This message requests the device manufacturer information from the widget.
 +
 +
{| border=1
 +
! '''Size in Bytes'''!! Description
 +
|-
 +
|| 2  || ESTA ID
 +
|-
 +
|| 32 || Up to 32 bytes containing the manufacturer name. Not null terminated.
 +
|}
 +
 +
== Device Name, Label = 78, no data ==
 +
 +
This message requests the device name information from the widget.
 +
 +
{| border=1
 +
! '''Size in Bytes'''!! Description
 +
|-
 +
|| 2  || Device Type ID, Manufacturer assigned.
 +
|-
 +
|| 32 || Up to 32 bytes containing the device type. Not null terminated.
 +
|}
  
 
== Devices Supporting these Message Types ==
 
== Devices Supporting these Message Types ==
  
* [[DMX-TRI]]
+
* [[Arduino RGB Mixer]] , ESTA ID: 0x7a70, Device ID: 0x1
* [[Arduino RGB Mixer]]
+
* [[DMX-TRI]], ESTA ID: 0x6864, Device ID:
 +
 
 +
== External References ==
 +
 
 +
* [http://www.enttec.com/docs/dmx_usb_pro_api_spec.pdf DMX Pro API]
 +
* [http://www.esta.org/tsp/working_groups/CP/mfctrIDs.php ESTA IDs]

Revision as of 11:00, 2 March 2010

This documents the additional message types added to the Enttec DMX USB Pro protocol to support multiple device types. As the number of devices supporting the protocol grows, it becomes difficult for software like OLA to differentiate the device types. The Device Manufacturer & Device Name messages allow the host software to determine the device and know which set of messages it supports.

Other Solutions

USB Serial Number

Enttec USB Pro devices have only started programming the serial numbers recently (>2008?). When using the standard USB Serial drivers on Mac & Linux, the host application doesn't have access to the serial numbers. This would require us to write our own USB drivers using libusb to expose this information.

Use the User Addressable EEPROM

Some devices don't support the Set Widget Parameters message so this isn't an option. Also it suffers from the bootstrapping issue, we need to know what device it is before we can write the information about what device it is...

Device Manufacturer, Label = 77, no data

This message requests the device manufacturer information from the widget.

Size in Bytes Description
2 ESTA ID
32 Up to 32 bytes containing the manufacturer name. Not null terminated.

Device Name, Label = 78, no data

This message requests the device name information from the widget.

Size in Bytes Description
2 Device Type ID, Manufacturer assigned.
32 Up to 32 bytes containing the device type. Not null terminated.

Devices Supporting these Message Types

External References