HID Sensor Usage Tables - USB.org

84 HID Sensor Usages
Any of these Modifiers can be applied to any Data Field. Below is an example extracted from a HID
Report Descriptor that again uses the single Data Field thermometer example:
.
.
.
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_ENVIRONMENTAL_TEMPERATURE,
HID_USAGE_SENSOR_DATA_MOD_CHANGE_SENSITIVITY_ABS),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_ENVIRONMENTAL_TEMPERATURE,HID_USAGE_SENSOR_DATA_MOD_MAX),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_ENVIRONMENTAL_TEMPERATURE,HID_USAGE_SENSOR_DATA_MOD_MIN),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_ENVIRONMENTAL_TEMPERATURE,HID_USAGE_SENSOR_DATA_MOD_ACCURACY),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_ENVIRONMENTAL_TEMPERATURE,HID_USAGE_SENSOR_DATA_MOD_PRECISION),
.
.
.
Provision has been made for this sytax to apply to those cases where there are multiple Data Fields defined
for the sensor. In each case where multiple Data Fields are defines, a definition has been created that refers
to all of them collectively. Using again the accelerometer as an example, the collective and individual Data
Field defintions are below:
#define HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION 0x0A,0x52,0x04
#define HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION_X_AXIS 0x0A,0x53,0x04
#define HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION_Y_AXIS 0x0A,0x54,0x04
#define HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION_Z_AXIS 0x0A,0x55,0x04
Applying the list of Properties to the collective version of the Data Field would be done as follows:
.
.
.
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION,HID_USAGE_SENSOR_DATA_MOD_CHANGE_SENSITIVITY_ABS),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION,HID_USAGE_SENSOR_DATA_MOD_MAX),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION,HID_USAGE_SENSOR_DATA_MOD_MIN),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION,HID_USAGE_SENSOR_DATA_MOD_ACCURACY),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION,HID_USAGE_SENSOR_DATA_MOD_PRECISION),
.
.
.
Note that in each case the Data Field to which the Modifier applies is specified, and that in each case the
Data Field specified is for the collective version of the Data Field. This is mostly equivalent to the
following definitions presented previously and repeated here for convenience:
.
.
.
HID_USAGE_SENSOR_PROPERTY_CHANGE_SENSITIVITY_ABS,
HID_USAGE_SENSOR_PROPERTY_MAXIMUM,
HID_USAGE_SENSOR_PROPERTY_MINIMUM,
HID_USAGE_SENSOR_PROPERTY_ACCURACY,
HID_USAGE_SENSOR_PROPERTY_RESOLUTION,
.
.
.
In the case of the collective Data Field specification, this will only apply to Data Fields of that type. In the
case of the HID_USAGE_SENSOR_PROPERTY_xxx construction, this would apply to all Data Fields
even if they are not of the same type.
In the case of specifying Properties that are applied per-datafield with the expectation that the Property may
change depending on the Data Field, the following homogenous constructing again using the accelerometer
follows:
.
.
.
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION_X_AXIS,
HID_USAGE_SENSOR_DATA_MOD_CHANGE_SENSITIVITY_ABS),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION_Y_AXIS,
HID_USAGE_SENSOR_DATA_MOD_CHANGE_SENSITIVITY_ABS),
HID_USAGE_SENSOR_DATA(HID_USAGE_SENSOR_DATA_MOTION_ACCELERATION_Z_AXIS,
HID_USAGE_SENSOR_DATA_MOD_CHANGE_SENSITIVITY_ABS),