HID Sensor Usage Tables - USB.org

86 HID Sensor Usages
TEMPERATURE
Usage
0434 NONE 0 0434 TEMPERATURE
TEMPERATURE 0434 CHANGE SENSITIVITY 1 1434 SENSITIVITY_ABS
ABS
(TEMPERATURE)
TEMPERATURE 0434 MAX 2 2434 MAX(TEMPERATURE)
TEMPERATURE 0434 MIN 3 3434 MIN(TEMPERATURE)
TEMPERATURE 0434 THRESHOLD HIGH 6 6434 THRESHOLD_HIGH(TEMPERATURE)
TEMPERATURE 0434 THRESHOLD LOW 7 7434 THRESHOLD_LOW(TEMPERATURE)
TEMPERATURE 0434 CHANGE SENSITIVITY D D434 SENSITIVITY_RANGE_PCT
RANGE PERCENT
(TEMPERATURE)
TEMPERATURE 0434 CHANGE SENSITIVITY E E434 SENSITIVITY_REL_PCT
RELATIVE PERCENT
(TEMPERATURE)
Table 19. Modifier Usage example
If MAX(TEMPERATURE) was defined to be +35.0, and the current temperature rose from a value below
that until the point that it crossed it in an upward direction, then a “Max Temperature Exceeded” event is in
effect.
Whether or not the event is actually reported depends upon the setting of the Reporting State property:
//begin reporting state selectors
#define HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_NO_EVENTS 0x0A,0x40,0x08 // Sel
#define HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_ALL_EVENTS 0x0A,0x41,0x08 // Sel
#define HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_THRESHOLD_EVENTS 0x0A,0x42,0x08 // Sel
#define HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_NO_EVENTS_WAKE 0x0A,0x43,0x08 // Sel
#define HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_ALL_EVENTS_WAKE 0x0A,0x44,0x08 // Sel
#define HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_THRESHOLD_EVENTS_WAKE 0x0A,0x45,0x08 // Sel
//end reporting state selectors
If the Reporting State selector is NO_EVENTS, then the event is not reported, it is discarded.
If the Reporting State selector is ALL_EVENTS, then then the event is always reported.
If the Reporting State selector is THRESHOLD_EVENTS, then the event is reported when it is a
threshold exceeded event.
If the Reporting State selector is one ending in _WAKE, then the sensor is asked to wake the Host
CPU if it is asleep, and then send the event.
The actual event ID that is reported depends upon the threshold event type that occurred:
#define HID_USAGE_SENSOR_EVENT_UNKNOWN 0x00
#define HID_USAGE_SENSOR_EVENT_STATE_CHANGED 0x01
#define HID_USAGE_SENSOR_EVENT_PROPERTY_CHANGED 0x02
#define HID_USAGE_SENSOR_EVENT_DATA_UPDATED 0x03
#define HID_USAGE_SENSOR_EVENT_POLL_RESPONSE 0x04
#define HID_USAGE_SENSOR_EVENT_CHANGE_SENSITIVITY 0x05
#define HID_USAGE_SENSOR_EVENT_MAX_REACHED 0x06
#define HID_USAGE_SENSOR_EVENT_MIN_REACHED 0x07
#define HID_USAGE_SENSOR_EVENT_HIGH_THRESHOLD_CROSS_ABOVE 0x08
#define HID_USAGE_SENSOR_EVENT_HIGH_THRESHOLD_CROSS_BELOW 0x09
#define HID_USAGE_SENSOR_EVENT_LOW_THRESHOLD_CROSS_ABOVE 0x0A
#define HID_USAGE_SENSOR_EVENT_LOW_THRESHOLD_CROSS_BELOW 0x0B
#define HID_USAGE_SENSOR_EVENT_ZERO_THRESHOLD_CROSS_ABOVE 0x0C
#define HID_USAGE_SENSOR_EVENT_ZERO_THRESHOLD_CROSS_BELOW 0x0D
#define HID_USAGE_SENSOR_EVENT_PERIOD_EXCEEDED 0x0E
#define HID_USAGE_SENSOR_EVENT_FREQUENCY_EXCEEDED 0x0F
#define HID_USAGE_SENSOR_EVENT_COMPLEX_TRIGGER 0x10
Examples:
The MAX_REACHED event would be reported if the TEMPERATURE rose to the
MAX(TEMPERATURE) threshold or higher.
The MIN_REACHED event would be reported if the TEMPERATURE dropped to the
MIN(TEMPERATURE) or lower.
The HIGH_THRESHOLD_CROSS_ABOVE event would be reported if the TEMPERATURE
rose from below the “upper threshold” [which could be defined by
THRESHOLD_HIGH(TEMPERATURE), SENSITIVITY_RANGE_PCT(TEMPERATURE), or
SENSITIVITY_REL_PCT(TEMPERATURE)] and crossed it in an upward direction.