unleashed-firmware/firmware/targets/api-hal-include/api-hal-power.h
あく 616b7325c6
[FL-952] I2C: correctly handle STOP flags. Apps: increase cli_app stack size. (#408)
* I2C: correctly handle STOP flags. Apps: increase cli_app stack size.
* API HAL Power: simplify api_hal_power_dump_state. Format sources.
2021-04-12 21:09:38 +03:00

101 lines
2.3 KiB
C

#pragma once
#include <stdint.h>
#include <stdbool.h>
#include <m-string.h>
#ifdef __cplusplus
extern "C" {
#endif
/** Power IC type */
typedef enum {
ApiHalPowerICCharger,
ApiHalPowerICFuelGauge,
} ApiHalPowerIC;
/** Initialize drivers */
void api_hal_power_init();
/**
* Get current insomnia level
* @return insomnia level: 0 - no insomnia, >0 - insomnia, bearer count.
*/
uint16_t api_hal_power_insomnia_level();
/**
* Enter insomnia mode
* Prevents device from going to sleep
* @warning Internally increases insomnia level
* Must be paired with api_hal_power_insomnia_exit
*/
void api_hal_power_insomnia_enter();
/**
* Exit insomnia mode
* Allow device to go to sleep
* @warning Internally decreases insomnia level.
* Must be paired with api_hal_power_insomnia_enter
*/
void api_hal_power_insomnia_exit();
/** Check if sleep availble */
bool api_hal_power_sleep_available();
/** Check if deep sleep availble */
bool api_hal_power_deep_sleep_available();
/** Go to sleep */
void api_hal_power_sleep();
/** Get predicted remaining battery capacity in percents */
uint8_t api_hal_power_get_pct();
/** Get battery health state in percents */
uint8_t api_hal_power_get_bat_health_pct();
/** Get charging status */
bool api_hal_power_is_charging();
/** Poweroff system */
void api_hal_power_off();
/** OTG enable */
void api_hal_power_enable_otg();
/** OTG disable */
void api_hal_power_disable_otg();
/** Get remaining battery battery capacity in mAh */
uint32_t api_hal_power_get_battery_remaining_capacity();
/** Get full charge battery capacity in mAh */
uint32_t api_hal_power_get_battery_full_capacity();
/** Get battery voltage in V */
float api_hal_power_get_battery_voltage(ApiHalPowerIC ic);
/** Get battery current in A */
float api_hal_power_get_battery_current(ApiHalPowerIC ic);
/** Get temperature in C */
float api_hal_power_get_battery_temperature(ApiHalPowerIC ic);
/** Get System voltage in V */
float api_hal_power_get_system_voltage();
/** Get USB voltage in V */
float api_hal_power_get_usb_voltage();
/** Get power system component state */
void api_hal_power_dump_state();
/** Enable 3.3v on external gpio and sd card */
void api_hal_power_enable_external_3_3v();
/** Disable 3.3v on external gpio and sd card */
void api_hal_power_disable_external_3_3v();
#ifdef __cplusplus
}
#endif