Implementation of the Device trait for USB connected lights.
The identifiers used to discover the device using the HID API are as follows:
- The vendor identifier (VID) is
0x04D8.
- The product identifier (PID) is
0xF372.
The following command groups exist for controlling the lights. Note that byte 0, the USB HID report
identifier, must always be set to 0x00. Also, trailing 0x00 values need not be written.
| Command Group | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 |
|---|
| Simple | 0x00 | 0x00 | COLOR* | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 |
| Solid | 0x00 | 0x01 | LED | RED | GREEN | BLUE | 0x00 | 0x00 | 0x00 |
| Fade | 0x00 | 0x02 | LED | RED | GREEN | BLUE | TIME | 0x00 | 0x00 |
| Strobe | 0x00 | 0x03 | LED | RED | GREEN | BLUE | SPEED | 0x00 | REPEAT |
| Wave | 0x00 | 0x04 | WTYPE | RED | GREEN | BLUE | 0x00 | REPEAT | SPEED |
| Pattern | 0x00 | 0x06 | PTYPE | REPEAT | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 |
| Productivity | 0x00 | 0x0A | COLOR | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 |
| Get Ver/Serial | 0x00 | 0x80 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 | 0x00 |
- The values for LED, COLOR, WTYPE, and PTYPE, are shown in the corresponding tables below.
- The values for RED, GREEN, BLUE, are
0..255 and correspond to standard RGB color.
- The value for TIME is the number of seconds to fade from the current color to the new color specified.
- The value for SPEED is the time to cycle through the change.
- The value of REPEAT is the number of times to repeat the wave or pattern.
- The response data for the get version and serial number command group is described below.
| Value | Addressed LED |
|---|
0x01..0x06 | Specific LED |
0x41 | all back LEDs |
0x42 | all front LEDs |
0xFF | all LEDs one color |
The addressable LEDs on the Flag USB product are as follows, shown in vertical orientation:
- For the command group Productivity all the values below are valid.
- For the command group Simple the values 'E' and 'D' are not valid.
| Letter | Value | Color |
|---|
| 'E' | 0x45 | Enable |
| 'D' | 0x44 | Disable |
| 'R' | 0x52 | Red |
| 'G' | 0x47 | Green |
| 'B' | 0x42 | Blue |
| 'C' | 0x43 | Cyan |
| 'M' | 0x4D | Magenta |
| 'Y' | 0x59 | Yellow |
| 'W' | 0x57 | White |
| 'O' | 0x4F | Off |
| Value | Pattern |
|---|
0x01 | Short |
0x02 | Long |
0x03 | Overlapping Short |
0x04 | Overlapping Long |
0x05 | ? |
- Luxafor describe wave type as a value
0x01..0x05 and yet there seems to be no description of 0x05 anywhere.
| Value | Pattern | Windows Only |
|---|
0x00 | ? | Unknown |
0x01 | Luxafor/Traffic Lights | No |
0x02 | Random 1 | No |
0x03 | Random 2 | No |
0x04 | Random 3 | No |
0x05 | Police | No |
0x06 | Random 4 | No |
0x07 | Random 5 | No |
0x08 | Rainbow Wave | Yes |
- Luxafor describe pattern type as a value
0x00..0x08 and yet there seems to be no description of 0x00 anywhere.
| 0 | 1 | 2 | 3 |
|---|
0x80 | FW Version | Serial High | Serial Low |
The serial number is returned as a pair, (high,low) bytes.
| USBDevice | The device implementation for a USB connected light.
|
| USBDeviceDiscovery | This enables the discovery of the device using the USB HID descriptor.
|