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
(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 == | ||
| − | == | + | === 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. | ||
| + | |||
| + | {| 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 |
| − | * [[ | + | * [[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 10: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.
Contents
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
- Arduino RGB Mixer , ESTA ID: 0x7a70, Device ID: 0x1
- DMX-TRI, ESTA ID: 0x6864, Device ID:
