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

Space shortcuts

Page tree