AB202X/libs/cpu/api_sys.h

#ifndef _API_SYS_H_
#define _API_SYS_H_

#define CACHE_ADDR          0x70000

typedef uint8_t flash_id_t[16];


/**
  * @brief  Sets whether to call the timer2 interrupt callback function
  * @param  tmr5ms_en: set to true, usr_tmr5ms_thread_callback will be called once in 5ms
  * @param  tmr1ms_en: set to true, usr_tmr1ms_isr_callback will be called once in 1ms
  */
void sys_set_tmr_enable(bool tmr5ms_en, bool tmr1ms_en);

/**
  * @brief  system reset init
  * @param  wk pin 10s reset config
  * @return system reset source
    reset source:   BIT(31):PWRUP_RST
                    BIT(24):SW_RST
                    BIT(19):WK Pin 10S_RST
                    BIT(18):WAKEUP_RST
                    BIT(17):VUSB_RST
                    BIT(16):WDT_RST
                    BIT(20)|BIT(7):LVD_RST
  */
u32 sys_rst_init(bool wko10s_rst);

/**
  * @brief  dump the system reset source info
  * @param  reason: system reset source, can be get by the return value of the function sys_rst_init
  */
void sys_rst_dump(u32 reason);

/**
  * @brief  The system reset can be triggered by software
  * @param  software reset source, it can be define by the user
  */
void sw_reset_kick(u8 source);

/**
  * @brief  Get the software reset source,it must be called as soon as the system is reset
  * @return software reset source
  */
u8 sw_reset_source_get(void);

void xosc_init(void);


/**
  * @brief  Gets a random number between 0 and num
  * @param  number
  */
u16 get_random(u16 num);

/**
  * @brief  get the number of bytes used by the UTF8 character
  * @param  Returns the number of bytes used by the UTF8 character
  */
u8 utf8_char_size_get(u8 code);

/**
  * @brief  utf8 convert to unicode
  * @param  in
  * @param  char_size
  */
u16 utf8_convert_to_unicode(u8 *in, u8 char_size);

int s_abs(int x);

bool bt_get_ft_trim_value(void *rf_param);

void io_sleep(void);

void io_resume(void);

/**
  * @brief  Read data from the chip's built-in flash
  * @param  buf
  * @param  flash address to read
  * @param  len
  */
uint os_spiflash_read(void *buf, u32 addr, uint len);

/**
  * @brief  Program data to the chip's built-in flash
  * @param  buf
  * @param  flash address to program to
  * @param  len, must be less than or equal to 256
  */
void os_spiflash_program(void *buf, u32 addr, uint len);

/**
  * @brief  Erase the chip's built-in flash
  * @param  flash base addresses that need to be erased, erase 4K bytes at a time
  */
void os_spiflash_erase(u32 addr);

/**
  * @brief  Get the chip's built-in flash id
  * @param  flash id buf
  */
void os_spiflash_id_get(flash_id_t id);

#endif // _API_SYS_H_