基础HAL

释放参数ptr指向的一块堆内存, 当传入的参数为NULL时不执行任何操作

原型

void HAL_Free(_IN_ void *ptr);
            

接口说明

参数说明

返回值说明

void

HAL_GetChipID

原型

char *HAL_GetChipID(_OU_ char cid_str[HAL_CID_LEN]);
            

接口说明

获取唯一的芯片ID字符串, 字符串长度不能超过HAL_CID_LEN定义的数值。

注：该HAL只需要芯片商进行适配，如果用户不是芯片商，该HAL返回空字符串即可

参数说明

返回值说明

指向字符串缓冲区的指针

HAL_GetDeviceID

（在2.3.1及以后版本中不需要实现）

原型

int HAL_GetDeviceID(_OU_ char device_id[DEVICE_ID_LEN]);
            

接口说明

获取设备的DeviceID, 用于标识设备单品的ID

参数说明

返回值说明

实际获取到的DeviceID字符串长度

HAL_GetDeviceName

原型

int HAL_GetDeviceName(_OU_ char device_name[DEVICE_NAME_LEN]);
            

接口说明

获取设备的DeviceName，用于唯一标识单个设备的名字，在云端控制台注册得到并烧写到设备中。

参数说明

返回值说明

实际获取到的DeviceName字符串长度

HAL_GetDeviceSecret

原型

int HAL_GetDeviceSecret(_OU_ char device_secret[DEVICE_SECRET_LEN]);
            

接口说明

获取设备的DeviceSecret，用于标识单个设备的密钥，在云端控制台注册得到并烧写到设备中。

参数说明

返回值说明

实际获取到的DeviceSecret字符串长度

HAL_GetFirmwareVersion

原型

int HAL_GetFirmwareVersion(_OU_ char version[FIRMWARE_VERSION_MAXLEN]);
            

接口说明

获取设备的固件版本字符串, 此固件版本号将会用于OTA升级的版本上报。如果设备不准备支持OTA，该函数返回空串即可。

参数说明

返回值说明

实际获取到的FirmwareVesion字符串长度

HAL_GetModuleID

原型

int HAL_GetModuleID(_OU_ char mid_str[MID_STR_MAXLEN]);
            

接口说明

获取设备的Module ID, 仅用于紧密合作伙伴。该函数用于模组商上报模组型号，其它角色的用户返回空串即可。

参数说明

返回值说明

实际获取到的Module ID字符串长度

HAL_GetPartnerID

原型

int HAL_GetPartnerID(_OU_ char pid_str[PID_STR_MAXLEN]);
            

接口说明

获取设备的Partner ID, 仅用于紧密合作伙伴。

参数说明

返回值说明

实际获取到的Partner ID字符串长度

HAL_GetProductKey

原型

int HAL_GetProductKey(_OU_ char product_key[PRODUCT_KEY_LEN]);
            

接口说明

获取设备的ProductKey，用于标识设备的品类，在云端控制台注册得到并烧写到设备中。

参数说明

返回值说明

实际获取到的ProductKey字符串长度

HAL_GetProductSecret

原型

int HAL_GetProductSecret(_OU_ char product_secret[DEVICE_SECRET_LEN]);
            

接口说明

获取设备的ProductSecret, 用于标识品类的密钥, 在云端控制台注册得到并烧写到设备中, 在一型一密的场景下将会使用到此字符串

参数说明

返回值说明

实际获取到的ProductSecret字符串长度

HAL_GetTimeStr

（在2.3.1及以后版本中不需要实现）原型

char *HAL_GetTimeStr(_OU_ char *buf, _IN_ int len);
            

接口说明

获取当前时间字符串

参数说明

返回值说明

指向时间字符串缓冲区的指针

HAL_Kv_Del

原型

int HAL_Kv_Del(const char *key);
            

接口说明

删除指定KV数据, 删除key对应的KV对数据, 可以通过擦除Flash或修改文件数据的方式实现持久化数据的删除

参数说明

返回值说明

HAL_Kv_Erase_All

原型

int HAL_Kv_Erase_All(void);
            

接口说明

擦除所有的KV数据, 可以通过擦除Flash或修改文件数据的方式实现持久化数据的删除

参数说明

void

返回值说明

HAL_Kv_Get

原型

int HAL_Kv_Get(const char *key, void *buffer, int *buffer_len);
            

接口说明

获取KV数据, 获取key对应的KV对数据, 可以通过读取Flash或读取文件的方式实现持久化数据的读取

参数说明

返回值说明

HAL_Kv_Set

原型

int HAL_Kv_Set(const char *key, const void *val, int len, int sync);
            

接口说明

设置KV数据接口, 可通过写flash或写文件的方式实现数据持久化

参数说明

返回值说明

HAL_Malloc

原型

void *HAL_Malloc(_IN_ uint32_t size);
            

接口说明

申请一块堆内存

参数说明

返回值说明

HAL_Printf

原型

void HAL_Printf(_IN_ const char *fmt, ...);
            

接口说明

打印函数, 用于向串口或其它标准输出打印日志或调试信息, 可参考C99的printf()函数实现

参数说明

返回值说明

void

HAL_Random

HAL_Random 原型

uint32_t HAL_Random(_IN_ uint32_t region);
            

接口说明

随机数函数, 接受一个无符号数作为范围, 返回0到region范围内的一个随机数

参数说明

返回值说明

在指定范围的随机数

HAL_Reboot

原型

void HAL_Reboot(void);
            

接口说明

设备重启, 调用该接口能实现复位功能

参数说明

void

返回值说明

void

HAL_SetDeviceName

原型

int HAL_SetDeviceName(_IN_ char *device_name);
            

接口说明

设置设备的DeviceName，用于标识设备单品的名字。

参数说明

返回值说明

待设置DeviceName字符串的长度

HAL_SetDeviceSecret

原型

int HAL_SetDeviceSecret(_IN_ char *device_secret);
            

接口说明

设置设备的DeviceSecret，用于标识设备单品的密钥。

参数说明

返回值说明

待设置DeviceSecret字符串的长度

HAL_SetProductKey

原型

int HAL_SetProductKey(_IN_ char *product_key);
            

接口说明

设置设备的ProductKey，用于标识设备的品类。

参数说明

返回值说明

待设置ProductKey字符串的长度

HAL_SetProductSecret

原型

int HAL_SetProductSecret(_IN_ char *product_secret);
            

接口说明

设置设备的ProductSecret, 用于标识品类的密钥, 在一型一密场景中会使用到此字符串

参数说明

返回值说明

待设置ProductSecret字符串的长度

HAL_SleepMs

原型

void HAL_SleepMs(_IN_ uint32_t ms);
            

接口说明

睡眠函数, 使当前执行线程睡眠指定的毫秒数

参数说明

返回值说明

void

HAL_Snprintf

原型

int HAL_Snprintf(_OU_ char *str, _IN_ const int len, _IN_ const char *fmt, ...);
            

接口说明

打印函数, 向内存缓冲区格式化构建一个字符串, 参考C99标准库函数

参数说明

返回值说明

实际写入缓冲区的字符串长度

HAL_Srandom

原型

void HAL_Srandom(_IN_ uint32_t seed);
            

接口说明

随机数播种函数，使HAL Random的返回值每个随机序列各不相同，类似C标准库中的srand。

参数说明

返回值说明

void

HAL_Sys_reboot

原型

void HAL_Sys_reboot(void);
            

接口说明

系统立即重启

参数说明

void

返回值说明

void

HAL_Timer_Create

原型

void *HAL_Timer_Create(const char *name, void (*func)(void *), void *user_data);
            

接口说明

创建指定名称的定时器, 同时注册用户回调函数和用户数据

参数说明

返回值说明

HAL_Timer_Delete

原型

int HAL_Timer_Delete(void *timer);
            

接口说明

删除由HAL_Timer_Create()创建的定时器, 释放资源

参数说明

返回值说明

HAL_Timer_Start

原型

int HAL_Timer_Start(void *t, int ms);
            

接口说明

启动定时器

参数说明

返回值说明

HAL_Timer_Stop

原型

int HAL_Timer_Stop(void *t);
            

接口说明

关闭定时器

参数说明

返回值说明

HAL_UptimeMs

原型

uint64_t HAL_UptimeMs(void);
            

接口说明

获取设备从上电到当前时刻所经过的毫秒数

参数说明

void

返回值说明

设备从上电到当前时刻所经过的毫秒数

HAL_UTC_Get

原型

long long HAL_UTC_Get(void);
            

接口说明

获取UTC时间, 数值为从Epoch(1970年1月1日00:00:00 UTC)开始所经过的秒数单位

参数说明

void

返回值说明

单位为ms的UTC时间

HAL_UTC_Set

原型

void HAL_UTC_Set(long long ms);
            

接口说明

设置UTC时间, 设置参数为从Epoch(1970年1月1日00:00:00 UTC)开始所经过的秒数单位

参数说明

返回值说明

void

HAL_Vsnprintf

原型

int HAL_Vsnprintf(_OU_ char *str, _IN_ const int len, _IN_ const char *fmt, _IN_ va_list ap);
            

接口说明

格式化输出字符串到指定buffer中, 可参考C标准库的vsnprintf()实现

参数说明

返回值说明

成功写入的字符串长