include: drivers: add Doxygen @file tag

Ensure all top-level device driver headers have a Doxygen @file tag and
put the @file in the same group as the driver API.

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

Author: kartben

include/zephyr/drivers/adc.h

@@ -1,15 +1,16 @@
-/**
- * @file
- * @brief ADC public API header file.
- */
-
 /*
  * Copyright (c) 2018 Nordic Semiconductor ASA
  * Copyright (c) 2015 Intel Corporation
  *
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @ingroup adc_interface
+ * @brief Main header file for ADC (Analog-to-Digital Converter) driver API.
+ */
+
 #ifndef ZEPHYR_INCLUDE_DRIVERS_ADC_H_
 #define ZEPHYR_INCLUDE_DRIVERS_ADC_H_
 

include/zephyr/drivers/auxdisplay.h

@@ -6,7 +6,8 @@
 
 /**
  * @file
- * @brief Public API for auxiliary (textual/non-graphical) display drivers
+ * @ingroup auxdisplay_interface
+ * @brief Main header file for auxiliary (textual/non-graphical) display driver API.
  */
 
 #ifndef ZEPHYR_INCLUDE_DRIVERS_AUXDISPLAY_H_

include/zephyr/drivers/bbram.h

@@ -4,6 +4,12 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
+/**
+ * @file
+ * @ingroup bbram_interface
+ * @brief Main header file for Battery-Backed RAM (BBRAM) driver API.
+ */
+
 #ifndef ZEPHYR_INCLUDE_DRIVERS_BBRAM_H
 #define ZEPHYR_INCLUDE_DRIVERS_BBRAM_H
 

include/zephyr/drivers/bluetooth.h

@@ -5,6 +5,13 @@
  *
  *  SPDX-License-Identifier: Apache-2.0
  */
+
+/**
+ * @file
+ * @ingroup bt_hci_api
+ * @brief Main header file for Bluetooth HCI driver API.
+ */
+
 #ifndef ZEPHYR_INCLUDE_DRIVERS_BLUETOOTH_H_
 #define ZEPHYR_INCLUDE_DRIVERS_BLUETOOTH_H_
 

include/zephyr/drivers/cache.h

@@ -6,7 +6,8 @@
 
 /**
  * @file
- * Public APIs for external cache controller drivers
+ * @ingroup cache_external_interface
+ * @brief Main header file for external cache controller driver API.
  */
 
 #ifndef ZEPHYR_INCLUDE_DRIVERS_CACHE_H_

include/zephyr/drivers/can.h

@@ -8,7 +8,7 @@
 
 /**
  * @file
- * @brief Main header file for Controller Area Network (CAN) driver API.
+ * @brief Header file for Controller Area Network (CAN) controller driver API.
  * @ingroup can_controller
  */
 

include/zephyr/drivers/cellular.h

@@ -6,8 +6,9 @@
  */
 
 /**
- * @file drivers/cellular.h
- * @brief Public cellular network API
+ * @file
+ * @ingroup cellular_interface
+ * @brief Main header file for cellular modem driver API.
  */
 
 #ifndef ZEPHYR_INCLUDE_DRIVERS_CELLULAR_H_

include/zephyr/drivers/charger.h

@@ -6,7 +6,8 @@
 
 /**
  * @file
- * @brief Charger APIs
+ * @ingroup charger_interface
+ * @brief Main header file for battery charger driver API.
  */
 
 #ifndef ZEPHYR_INCLUDE_DRIVERS_CHARGER_H_

include/zephyr/drivers/clock_control.h

@@ -8,7 +8,8 @@
 
 /**
  * @file
- * @brief Public Clock Control APIs
+ * @ingroup clock_control_interface
+ * @brief Main header file for clock control driver API.
  */
 
 #ifndef ZEPHYR_INCLUDE_DRIVERS_CLOCK_CONTROL_H_

include/zephyr/drivers/comparator.h

@@ -7,6 +7,12 @@
 #ifndef ZEPHYR_INCLUDE_DRIVERS_COMPARATOR_H_
 #define ZEPHYR_INCLUDE_DRIVERS_COMPARATOR_H_
 
+/**
+ * @file
+ * @ingroup comparator_interface
+ * @brief Main header file for comparator driver API.
+ */
+
 /**
  * @brief Comparator Interface
  * @defgroup comparator_interface Comparator Interface