power.h

Go to the documentation of this file.

#pragma once
 
#include "esp_err.h"
#include <stdbool.h>
#include <stdint.h>


typedef enum {
    POWER_LEVEL_NORMAL = 0,  
    POWER_LEVEL_LOW,         
    POWER_LEVEL_CRITICAL,    
} power_level_t;

typedef enum {
    POWER_USB_DATA = 0,  
    POWER_USB_CHARGE,    
} power_usb_route_t;

typedef void (*power_shutdown_hook_t)(void);

typedef struct {
    bool          valid;          
    float         soc_pct;        
    float         voltage_v;      
    float         current_ma;     
    bool          charging;       
    bool          external_power; 
    float         tte_s;          
    power_level_t level;          
} power_state_t;

void power_self_hold(void);

void power_tick(void);

void power_get_state(power_state_t *out);

void power_set_usb_route(power_usb_route_t route);

power_usb_route_t power_get_usb_route(void);

void power_usb_autoroute_start(void);

void power_set_low_batt_shutdown(bool enable);

bool power_soc_at_shutdown(float soc_pct);

void power_set_shutdown_hook(power_shutdown_hook_t hook);

void power_shutdown(void) __attribute__((noreturn));

typedef enum {
    POWER_OFF_POWER_LOSS = 0,  
    POWER_OFF_CLEAN,           
    POWER_OFF_CRASH,           
} power_off_cause_t;

void power_boot_off_check(void);

void power_coredump_export(void);

power_off_cause_t power_last_off_cause(void);

const char *power_last_crash_task(void);

uint32_t power_last_crash_pc(void);


uint32_t power_get_sleep_ms(void);
void     power_set_sleep_ms(uint32_t ms);

uint32_t power_get_poweroff_ms(void);
void     power_set_poweroff_ms(uint32_t ms);