usb: hid: Define sensor page usages IDs

This commit adds the following:
    * A subset of usage IDs defined in the Sensors' page of the HID standard.
    * A HID usage macro that works with IDs of 2 bytes.
    * A macro to define the exponent in a report descriptor.

The values and naming came from the following document: https://www.usb.org/sites/default/files/hutrr39b_0.pdf

Signed-off-by: Zak Essadaoui [email protected]

Author: zessadaoui

include/zephyr/usb/class/hid.h

@@ -141,6 +141,8 @@ extern "C" {
 #define HID_USAGE_GEN_LEDS		0x08
 /** HID Button Usage page */
 #define HID_USAGE_GEN_BUTTON		0x09
+/** HID Sensors Usage page */
+#define HID_USAGE_SENSORS		0x20
 
 /** HID Generic Desktop Undefined Usage ID */
 #define HID_USAGE_GEN_DESKTOP_UNDEFINED	0x00
@@ -163,6 +165,19 @@ extern "C" {
 /** HID Generic Desktop Wheel Usage ID */
 #define HID_USAGE_GEN_DESKTOP_WHEEL	0x38
 
+/** HID Sensors Collection Usage ID */
+#define HID_USAGE_SENSOR_TYPE_COLLECTION		 0x001
+/** HID Sensors Environmental Temperature Type Usage ID */
+#define HID_USAGE_SENSORS_TYPE_ENVIRONMENTAL_TEMPERATURE 0x033
+/** HID Sensors Event Sensor State Usage ID */
+#define HID_USAGE_SENSORS_EVENT_SENSOR_STATE		 0x201
+/** HID Sensors Friendly Name Property Usage ID */
+#define HID_USAGE_SENSORS_PROPERTY_FRIENDLY_NAME	 0x301
+/** HID Sensors Enviromental Temperature Data Usage ID */
+#define HID_USAGE_SENSORS_DATA_ENVIRONMENTAL_TEMPERATURE 0x434
+/** HID Sensors Timestamp Property Usage ID */
+#define HID_USAGE_SENSORS_PROPERTY_TIMESTAMP		 0x529
+
 /**
  * @}
  */
@@ -357,12 +372,21 @@ extern "C" {
  * For usage examples, see @ref HID_MOUSE_REPORT_DESC(),
  * @ref HID_KEYBOARD_REPORT_DESC()
  *
- * @param idx Number of data fields included in the report
+ * @param idx HID Usage ID per the HID Usage Table
  * @return    HID Usage Index item
  */
 #define HID_USAGE(idx)			\
 	HID_ITEM(HID_ITEM_TAG_USAGE, HID_ITEM_TYPE_LOCAL, 1), idx
 
+/**
+ * @brief Define HID Usage Index item with the data length of two bytes.
+ *
+ * @param idx HID Usage ID per the HID Usage Table
+ * @return    HID Usage Index item
+ */
+#define HID_USAGE16(idx)		\
+	HID_ITEM(HID_ITEM_TAG_USAGE, HID_ITEM_TYPE_LOCAL, 2), ((0xFF) & idx), ((0xFF) & (idx >> 8))
+
 /**
  * @brief Define HID Usage Minimum item with the data length of one byte.
  *
@@ -413,6 +437,16 @@ extern "C" {
 #define HID_USAGE_MAX16(a, b)		\
 	HID_ITEM(HID_ITEM_TAG_USAGE_MAX, HID_ITEM_TYPE_LOCAL, 2), a, b
 
+/**
+ * @brief Define HID Unit Exponent item.
+ *
+ * @param  exp Unit exponent, refer to the HID Unit Exponent table
+ *             in the specification for usage
+ * @return  HID Unit Exponent item
+ */
+#define HID_UNIT_EXPONENT(exp)		\
+	HID_ITEM(HID_ITEM_TAG_UNIT_EXPONENT, HID_ITEM_TYPE_GLOBAL, 1), exp
+
 /**
  * @}
  */