include: drivers: sensor: enhance Doxygen documentation for PAT9136

Complete the Doxygen documentation for this sensor driver,
put in sensor_interface_ext group.

Signed-off-by: Benjamin Cabé <[email protected]>

Author: kartben

include/zephyr/drivers/sensor/pat9136.h

@@ -5,16 +5,32 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @brief Header file for extended sensor API of PAT9136 sensor
+ * @ingroup pat9136_interface
+ */
+
 #ifndef ZEPHYR_INCLUDE_DRIVERS_SENSOR_PAT9136_H_
 #define ZEPHYR_INCLUDE_DRIVERS_SENSOR_PAT9136_H_
 
+/**
+ * @brief Pixart PAT9136 optical flow sensor
+ * @defgroup pat9136_interface PAT9136
+ * @ingroup sensor_interface_ext
+ * @{
+ */
+
 #include <zephyr/drivers/sensor.h>
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
-/** This sensor does have the ability to provide DXY in meaningful units, and
+/**
+ * Custom sensor channels for PAT9136
+ *
+ * This sensor does have the ability to provide DXY in meaningful units, and
  * since the standard channels' unit is in points (SENSOR_CHAN_POS_DX,
  * SENSOR_CHAN_POS_DY, SENSOR_CHAN_POS_DXYZ), we've captured the following
  * channels to provide an alternative for this sensor.
@@ -35,4 +51,8 @@ enum sensor_channel_pat9136 {
 }
 #endif
 
+/**
+ * @}
+ */
+
 #endif /* ZEPHYR_INCLUDE_DRIVERS_SENSOR_PAT9136_H_ */