Content
Index:
Introduction
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.
Supported USB devices
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.
USB HID Input
Considering input
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.
Control
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
Considering output
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
External Links
Further Information
Related articles