include: drivers: usb: bc12: fix doxygen comments

Trivial fixes to doxygen documentation of BC 1.2 header

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

Author: kartben

include/zephyr/drivers/usb/usb_bc12.h

@@ -63,9 +63,9 @@ extern "C" {
 
 /** @brief BC1.2 device role. */
 enum bc12_role {
-	BC12_DISCONNECTED,
-	BC12_PORTABLE_DEVICE,
-	BC12_CHARGING_PORT,
+	BC12_DISCONNECTED,    /**< No BC1.2 device connected */
+	BC12_PORTABLE_DEVICE, /**< BC1.2 device is a portable device */
+	BC12_CHARGING_PORT,   /**< BC1.2 device is a charging port */
 };
 
 /** @brief BC1.2 charging partner type. */
@@ -88,25 +88,33 @@ enum bc12_type {
 
 /**
  * @brief BC1.2 detected partner state.
- *
- * @param bc12_role Current role of the BC1.2 device.
- * @param type Charging partner type. Valid when bc12_role is BC12_PORTABLE_DEVICE.
- * @param current_ma Current, in uA, that the charging partner provides. Valid when bc12_role is
- * BC12_PORTABLE_DEVICE.
- * @param voltage_mv Voltage, in uV, that the charging partner provides. Valid when bc12_role is
- * BC12_PORTABLE_DEVICE.
- * @param pd_partner_connected True if a PD partner is currently connected. Valid when bc12_role is
- * BC12_CHARGING_PORT.
  */
 struct bc12_partner_state {
+	/** Current role of the BC1.2 device. */
 	enum bc12_role bc12_role;
 	union {
 		struct {
+			/**
+			 * Charging partner type.
+			 * Valid when @ref bc12_role is @ref BC12_PORTABLE_DEVICE.
+			 */
 			enum bc12_type type;
+			/**
+			 * Current, in uA, that the charging partner provides.
+			 * Valid when @ref bc12_role is @ref BC12_PORTABLE_DEVICE.
+			 */
 			int current_ua;
+			/**
+			 * Voltage, in uV, that the charging partner provides.
+			 * Valid when @ref bc12_role is @ref BC12_PORTABLE_DEVICE.
+			 */
 			int voltage_uv;
 		};
 		struct {
+			/**
+			 * True if a PD partner is currently connected.
+			 * Valid when @ref bc12_role is @ref BC12_CHARGING_PORT.
+			 */
 			bool pd_partner_connected;
 		};
 	};