Index:
This article contains the USB HID commands that are supported by Snom headsets and conference phones. This documentation helps PBX and softphone vendors to enhance their application, let it be native or written in Javascript using Web HID, to control and be controlled by the Snom device connected via USB port.
In order to not limit the use of our devices only to certain applications, and provide the best possible interoperability options "on-board", all of them are mode compatible with the USB HID Specification. However, we do use some proprietary commands which are not described neither in the consumer nor in other sections. These are mainly used for some device related actions, like firmware upgrade.
A100, A330, C300
Our Vendor ID (VID) is 0x251c. This can be used to determine if a Snom device is connected to the USB.
If a device does not support an input or output report it is marked directly at the command. As you can see below, Snom devices are supporting not only the Telephony Page (0x0B) of the USB HID specification, but also the Consumer Page (0x0C), enabling the products to be used as a "normal" headset or speaker.
Input is considered as a button press, or basically a signal which is initiated by the device, or by the person using the device. These signals are encoded within reports, according to the USB Specification, accessible on https://www.usb.org/hid.
0x0c Consumer Page
These are effective on the operating system level. Typically for standard media player.
| Hex | Command | Description | Supported |
|---|---|---|---|
0xE9 | Volume Increment | RTC: Sent from the device to the host to signalise the volume increment | A330, C300 |
| 0xEA | Volume Decrement | RTC: Sent from the device to the host to signalise the volume decrement | A330, C300 |
0x09 Button
| Hex | Command | Description | Supported |
|---|---|---|---|
| 0x01 | Button 1 | Sent from the device to the host to reject an incoming call | A330, C300 |
0x0b Telephony
These commands should be supported by the telephony application running on the host.
| Hex | Command | Description | Supported |
|---|---|---|---|
| 0x2F | Mute / UnMute | OOC: Sent from the device to the host to enable / disable Mute | A330, C300 |
| 0x20 | Hook Switch | OOC: Sent from the device for hook switch | A330, C300 |
| 0x72 | DND | OOC: Turns DND on/off | A330, C300 |
Output, among audio or video is considered also as representation of a status. This is mainly done using LEDs, or any other representation of a status change.
0x08 Led
LED control will enable or disable the LEDs on the headset and on its controller, to show if the headset (the user) participates in a call.
| Hex | Led | Description | Supported |
|---|---|---|---|
| 0x17 | Hook | OOC: Turn on / off Hook LED | A330, C300 |
| 0x18 | Ring | OOC: This signalizes ringing to the headset | A330, C300 |
| 0x09 | Mute | OOC: Host to Headset to turn on Mute | A330, C300 |
Diagrams were made with https://sequencediagram.org/ |