[FL-41] api-hal doxygen documentation (#387)

* targets/api-hal: rework documentation in doxygen style
* core/api-hal: rework documentation in doxygen style
* core/furi: rework documentation in doxygen style
* drivers: rework documentation in doxygen style

Co-authored-by: あく <alleteam@gmail.com>
This commit is contained in:
gornekich
2021-03-24 12:35:33 +03:00
committed by GitHub
parent cc263d743b
commit 610f4f5d73
23 changed files with 325 additions and 161 deletions

View File

@@ -3,32 +3,32 @@
#include <stdbool.h>
#include <stdint.h>
/* Initialize Driver */
/** Initialize Driver */
void bq25896_init();
/* Send device into shipping mode */
/** Send device into shipping mode */
void bq25896_poweroff();
/* Is currently charging */
/** Is currently charging */
bool bq25896_is_charging();
/* Enable otg */
/** Enable otg */
void bq25896_enable_otg();
/* Disable otg */
/** Disable otg */
void bq25896_disable_otg();
/* Get VBUS Voltage in mV */
/** Get VBUS Voltage in mV */
uint16_t bq25896_get_vbus_voltage();
/* Get VSYS Voltage in mV */
/** Get VSYS Voltage in mV */
uint16_t bq25896_get_vsys_voltage();
/* Get VBAT Voltage in mV */
/** Get VBAT Voltage in mV */
uint16_t bq25896_get_vbat_voltage();
/* Get VBAT current in mA */
/** Get VBAT current in mA */
uint16_t bq25896_get_vbat_current();
/* Get NTC voltage in mpct of REGN */
/** Get NTC voltage in mpct of REGN */
uint32_t bq25896_get_ntc_mpct();

View File

@@ -43,32 +43,32 @@ typedef struct {
uint8_t RSVD0 : 5;
} OperationStatus;
/* Initialize Driver */
/** Initialize Driver */
void bq27220_init();
/* Get battery voltage in mV or error */
/** Get battery voltage in mV or error */
uint16_t bq27220_get_voltage();
/* Get current in mA or error*/
/** Get current in mA or error*/
int16_t bq27220_get_current();
/* Get battery status */
/** Get battery status */
uint8_t bq27220_get_battery_status(BatteryStatus* battery_status);
/* Get operation status */
/** Get operation status */
uint8_t bq27220_get_operation_status(OperationStatus* operation_status);
/* Get temperature in units of 0.1°K */
/** Get temperature in units of 0.1°K */
uint16_t bq27220_get_temperature();
/* Get compensated full charge capacity in in mAh */
/** Get compensated full charge capacity in in mAh */
uint16_t bq27220_get_full_charge_capacity();
/* Get remaining capacity in in mAh */
/** Get remaining capacity in in mAh */
uint16_t bq27220_get_remaining_capacity();
/* Get predicted remaining battery capacity in percents */
/** Get predicted remaining battery capacity in percents */
uint16_t bq27220_get_state_of_charge();
/* Get ratio of full charge capacity over design capacity in percents */
/** Get ratio of full charge capacity over design capacity in percents */
uint16_t bq27220_get_state_of_health();

View File

@@ -3,6 +3,7 @@
#include <stdint.h>
#include <stdbool.h>
/** Channel types */
typedef enum {
LP5562ChannelRed,
LP5562ChannelGreen,
@@ -10,13 +11,17 @@ typedef enum {
LP5562ChannelWhite,
} LP5562Channel;
/* Initialize Driver */
/** Initialize Driver */
void lp5562_reset();
/** Configure Driver */
void lp5562_configure();
/** Enable Driver */
void lp5562_enable();
/** Set channel current */
void lp5562_set_channel_current(LP5562Channel channel, uint8_t value);
/** Set channel current */
void lp5562_set_channel_value(LP5562Channel channel, uint8_t value);