Fix Doxygen documentation warnings

- Add documentation for all register macro definitions
- Fix unknown @license command warning

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Limor Fried 2025-08-10 08:22:24 -04:00
parent 9e1786e1f7
commit 3561fca8f1
2 changed files with 53 additions and 37 deletions

View file

@ -0,0 +1,15 @@
{
"permissions": {
"allow": [
"Bash(~/bin/arduino-cli board:*)",
"Bash(~/bin/arduino-cli upload:*)",
"Bash(timeout:*)",
"WebFetch(domain:github.com)",
"Bash(~/bin/arduino-cli compile:*)",
"Bash(git push:*)",
"Bash(~/bin/arduino-cli lib:*)",
"Bash(grep:*)"
],
"deny": []
}
}

View file

@ -15,7 +15,8 @@
* from Adafruit! * from Adafruit!
* *
* @author Limor 'ladyada' Fried with assistance from Claude Code * @author Limor 'ladyada' Fried with assistance from Claude Code
* @license MIT (see license.txt) *
* MIT License (see license.txt)
*/ */
#ifndef _ADAFRUIT_BQ25628E_H #ifndef _ADAFRUIT_BQ25628E_H
@ -229,42 +230,42 @@ typedef enum {
#define BQ25628E_ADC_DIS_VPMID (1 << 0) /*!< Disable VPMID ADC */ #define BQ25628E_ADC_DIS_VPMID (1 << 0) /*!< Disable VPMID ADC */
/*! Register addresses for the BQ25628E */ /*! Register addresses for the BQ25628E */
#define BQ25628E_REG_CHARGE_CURRENT_LIMIT 0x02 #define BQ25628E_REG_CHARGE_CURRENT_LIMIT 0x02 /*!< Charge current limit register */
#define BQ25628E_REG_CHARGE_VOLTAGE_LIMIT 0x04 #define BQ25628E_REG_CHARGE_VOLTAGE_LIMIT 0x04 /*!< Charge voltage limit register */
#define BQ25628E_REG_INPUT_CURRENT_LIMIT 0x06 #define BQ25628E_REG_INPUT_CURRENT_LIMIT 0x06 /*!< Input current limit register */
#define BQ25628E_REG_INPUT_VOLTAGE_LIMIT 0x08 #define BQ25628E_REG_INPUT_VOLTAGE_LIMIT 0x08 /*!< Input voltage limit register */
#define BQ25628E_REG_MINIMAL_SYSTEM_VOLTAGE 0x0E #define BQ25628E_REG_MINIMAL_SYSTEM_VOLTAGE 0x0E /*!< Minimal system voltage register */
#define BQ25628E_REG_PRECHARGE_CONTROL 0x10 #define BQ25628E_REG_PRECHARGE_CONTROL 0x10 /*!< Precharge control register */
#define BQ25628E_REG_TERMINATION_CONTROL 0x12 #define BQ25628E_REG_TERMINATION_CONTROL 0x12 /*!< Termination control register */
#define BQ25628E_REG_CHARGE_CONTROL 0x14 #define BQ25628E_REG_CHARGE_CONTROL 0x14 /*!< Charge control register */
#define BQ25628E_REG_CHARGE_TIMER_CONTROL 0x15 #define BQ25628E_REG_CHARGE_TIMER_CONTROL 0x15 /*!< Charge timer control register */
#define BQ25628E_REG_CHARGER_CONTROL_0 0x16 #define BQ25628E_REG_CHARGER_CONTROL_0 0x16 /*!< Charger control register 0 */
#define BQ25628E_REG_CHARGER_CONTROL_1 0x17 #define BQ25628E_REG_CHARGER_CONTROL_1 0x17 /*!< Charger control register 1 */
#define BQ25628E_REG_CHARGER_CONTROL_2 0x18 #define BQ25628E_REG_CHARGER_CONTROL_2 0x18 /*!< Charger control register 2 */
#define BQ25628E_REG_CHARGER_CONTROL_3 0x19 #define BQ25628E_REG_CHARGER_CONTROL_3 0x19 /*!< Charger control register 3 */
#define BQ25628E_REG_NTC_CONTROL_0 0x1A #define BQ25628E_REG_NTC_CONTROL_0 0x1A /*!< NTC control register 0 */
#define BQ25628E_REG_NTC_CONTROL_1 0x1B #define BQ25628E_REG_NTC_CONTROL_1 0x1B /*!< NTC control register 1 */
#define BQ25628E_REG_NTC_CONTROL_2 0x1C #define BQ25628E_REG_NTC_CONTROL_2 0x1C /*!< NTC control register 2 */
#define BQ25628E_REG_CHARGER_STATUS_0 0x1D #define BQ25628E_REG_CHARGER_STATUS_0 0x1D /*!< Charger status register 0 */
#define BQ25628E_REG_CHARGER_STATUS_1 0x1E #define BQ25628E_REG_CHARGER_STATUS_1 0x1E /*!< Charger status register 1 */
#define BQ25628E_REG_FAULT_STATUS_0 0x1F #define BQ25628E_REG_FAULT_STATUS_0 0x1F /*!< Fault status register 0 */
#define BQ25628E_REG_CHARGER_FLAG_0 0x20 #define BQ25628E_REG_CHARGER_FLAG_0 0x20 /*!< Charger flag register 0 */
#define BQ25628E_REG_CHARGER_FLAG_1 0x21 #define BQ25628E_REG_CHARGER_FLAG_1 0x21 /*!< Charger flag register 1 */
#define BQ25628E_REG_FAULT_FLAG_0 0x22 #define BQ25628E_REG_FAULT_FLAG_0 0x22 /*!< Fault flag register 0 */
#define BQ25628E_REG_CHARGER_MASK_0 0x23 #define BQ25628E_REG_CHARGER_MASK_0 0x23 /*!< Charger mask register 0 */
#define BQ25628E_REG_CHARGER_MASK_1 0x24 #define BQ25628E_REG_CHARGER_MASK_1 0x24 /*!< Charger mask register 1 */
#define BQ25628E_REG_FAULT_MASK_0 0x25 #define BQ25628E_REG_FAULT_MASK_0 0x25 /*!< Fault mask register 0 */
#define BQ25628E_REG_ADC_CONTROL 0x26 #define BQ25628E_REG_ADC_CONTROL 0x26 /*!< ADC control register */
#define BQ25628E_REG_ADC_FUNCTION_DISABLE_0 0x27 #define BQ25628E_REG_ADC_FUNCTION_DISABLE_0 0x27 /*!< ADC function disable register 0 */
#define BQ25628E_REG_IBUS_ADC 0x28 #define BQ25628E_REG_IBUS_ADC 0x28 /*!< Input bus current ADC register */
#define BQ25628E_REG_IBAT_ADC 0x2A #define BQ25628E_REG_IBAT_ADC 0x2A /*!< Battery current ADC register */
#define BQ25628E_REG_VBUS_ADC 0x2C #define BQ25628E_REG_VBUS_ADC 0x2C /*!< Input bus voltage ADC register */
#define BQ25628E_REG_VPMID_ADC 0x2E #define BQ25628E_REG_VPMID_ADC 0x2E /*!< PMID voltage ADC register */
#define BQ25628E_REG_VBAT_ADC 0x30 #define BQ25628E_REG_VBAT_ADC 0x30 /*!< Battery voltage ADC register */
#define BQ25628E_REG_VSYS_ADC 0x32 #define BQ25628E_REG_VSYS_ADC 0x32 /*!< System voltage ADC register */
#define BQ25628E_REG_TS_ADC 0x34 #define BQ25628E_REG_TS_ADC 0x34 /*!< Temperature sensor ADC register */
#define BQ25628E_REG_TDIE_ADC 0x36 #define BQ25628E_REG_TDIE_ADC 0x36 /*!< Die temperature ADC register */
#define BQ25628E_REG_PART_INFORMATION 0x38 #define BQ25628E_REG_PART_INFORMATION 0x38 /*!< Part information register */
/*! /*!
* @brief Class that stores state and functions for interacting with * @brief Class that stores state and functions for interacting with