更新时间:2019-03-15 17:20
void HAL_Free(_IN_ void *ptr);
释放参数ptr
指向的一块堆内存, 当传入的参数为NULL时不执行任何操作
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
ptr | void * | 输入 | 指向将要释放的堆内存的指针 |
void
char *HAL_GetChipID(_OU_ char cid_str[HAL_CID_LEN]);
获取唯一的芯片ID字符串, 字符串长度不能超过HAL_CID_LEN
定义的数值。
注:该HAL只需要芯片商进行适配,如果用户不是芯片商,该HAL返回空字符串即可
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
cid_str | char[] | 输出 | 存放芯片ID的字符串缓冲区 |
指向字符串缓冲区的指针
(在2.3.1及以后版本中不需要实现)
int HAL_GetDeviceID(_OU_ char device_id[DEVICE_ID_LEN]);
获取设备的DeviceID
, 用于标识设备单品的ID
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
device_id | char[] | 输出 | 存放DeviceID 的字符串缓冲区 |
实际获取到的DeviceID
字符串长度
int HAL_GetDeviceName(_OU_ char device_name[DEVICE_NAME_LEN]);
获取设备的DeviceName
, 用于唯一标识单个设备的名字, 三元组之一, 在云端控制台注册得到并烧写到设备中
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
device_name | char[] | 输出 | 存放DeviceName 的字符串缓冲区 |
实际获取到的DeviceName
字符串长度
int HAL_GetDeviceSecret(_OU_ char device_secret[DEVICE_SECRET_LEN]);
获取设备的DeviceSecret
, 用于标识单个设备的密钥, 三元组之一, 在云端控制台注册得到并烧写到设备中
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
device_secret | char[] | 输出 | 存放DeviceSecret 的字符串缓冲区 |
实际获取到的DeviceSecret
字符串长度
int HAL_GetFirmwareVersion(_OU_ char version[FIRMWARE_VERSION_MAXLEN]);
获取设备的固件版本字符串, 此固件版本号将会用于OTA升级的版本上报。如果设备不准备支持OTA,该函数返回空串即可。
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
version | char[] | 输出 | 存放FirmwareVesion 的字符串缓冲区 |
实际获取到的FirmwareVesion
字符串长度
int HAL_GetModuleID(_OU_ char mid_str[MID_STR_MAXLEN]);
获取设备的Module ID
, 仅用于紧密合作伙伴。该函数用于模组商上报模组型号,其它角色的用户返回空串即可。
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
mid_str | char[] | 输出 | 存放Module ID 的字符串缓冲区 |
实际获取到的Module ID
字符串长度
int HAL_GetPartnerID(_OU_ char pid_str[PID_STR_MAXLEN]);
获取设备的Partner ID
, 仅用于紧密合作伙伴。
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
pid_str | char[] | 输出 | 存放Partner ID 的字符串缓冲区 |
实际获取到的Partner ID
字符串长度
int HAL_GetProductKey(_OU_ char product_key[PRODUCT_KEY_LEN]);
获取设备的ProductKey
, 用于标识设备的品类, 三元组之一, 在云端控制台注册得到并烧写到设备中
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
product_key | char[] | 输出 | 存放ProductKey 的字符串缓冲区 |
实际获取到的ProductKey
字符串长度
int HAL_GetProductSecret(_OU_ char product_secret[DEVICE_SECRET_LEN]);
获取设备的ProductSecret
, 用于标识品类的密钥, 在云端控制台注册得到并烧写到设备中, 在一型一密的场景下将会使用到此字符串
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
product_secret | char[] | 输出 | 存放ProductSecret 的字符串缓冲区 |
实际获取到的ProductSecret
字符串长度
(在2.3.1及以后版本中不需要实现)
char *HAL_GetTimeStr(_OU_ char *buf, _IN_ int len);
获取当前时间字符串
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
buf | char * | 输出 | 指向时间字符串缓冲区的指针 |
len | int | 输入 | 字符串缓冲区的字节长度 |
指向时间字符串缓冲区的指针
int HAL_Kv_Del(const char *key);
删除指定KV数据, 删除key
对应的KV对数据, 可以通过擦除Flash或修改文件数据的方式实现持久化数据的删除
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
key | const char * | 输入 | 指向key字符串的指针 |
buffer | void * | 输出 | 指向存放获取数据的指针 |
buffer_len | int * | 输出 | 指向存放获取 |
值 | 说明 |
---|---|
0 | 删除成功 |
-1 | 删除失败 |
int HAL_Kv_Erase_All(void);
擦除所有的KV数据, 可以通过擦除Flash或修改文件数据的方式实现持久化数据的删除
void
值 | 说明 |
---|---|
0 | 操作成功 |
-1 | 操作失败 |
int HAL_Kv_Get(const char *key, void *buffer, int *buffer_len);
获取KV数据, 获取key
对应的KV对数据, 可以通过读取Flash或读取文件的方式实现持久化数据的读取
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
key | const char * | 输入 | 指向key字符串的指针 |
buffer | void * | 输出 | 指向存放获取数据的指针 |
buffer_len | int * | 输出 | 指向存放获取 |
值 | 说明 |
---|---|
0 | 获取成功 |
-1 | 获取失败 |
int HAL_Kv_Set(const char *key, const void *val, int len, int sync);
设置KV数据接口, 可通过写flash或写文件的方式实现数据持久化
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
key | const char * | 输入 | 指向key字符串的指针 |
val | const void * | 输入 | 指向待设置数据的指针 |
len | int | 输入 | 待设置数据的字节长度 |
sync | int | 输入 | 0: 异步接口. 1: 同步接口 |
值 | 说明 |
---|---|
0 | 设置成功 |
-1 | 设置失败 |
void *HAL_Malloc(_IN_ uint32_t size);
申请一块堆内存
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
size | uint32_t | 输入 | 申请的堆内存大小 |
值 | 说明 |
---|---|
NULL | 内存申请失败 |
!NULL | 指向堆内存首地址的指针 |
void HAL_Printf(_IN_ const char *fmt, ...);
打印函数, 用于向串口或其它标准输出打印日志或调试信息, 可参考C99的printf()
函数实现
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
fmt | const char * | 输入 | 格式化字符串 |
… | 可变类型 | 输入 | 可变参数列表 |
void
HAL_Random
uint32_t HAL_Random(_IN_ uint32_t region);
随机数函数, 接受一个无符号数作为范围, 返回0到region范围内的一个随机数
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
region | uint32_t | 输入 | 用于指定随机数范围的无符号数 |
在指定范围的随机数
void HAL_Reboot(void);
设备重启, 调用该接口能实现复位功能
void
void
int HAL_SetDeviceName(_IN_ char *device_name);
设置设备的DeviceName
, 用于标识设备单品的名字, 三元组之一
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
device_name | char * | 输出 | 指向待传入DeviceName 字符串的指针 |
待设置DeviceName
字符串的长度
int HAL_SetDeviceSecret(_IN_ char *device_secret);
设置设备的DeviceSecret
, 用于标识设备单品的密钥, 三元组之一
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
device_secret | char * | 输出 | 指向待传入DeviceSecret 字符串的指针 |
待设置DeviceSecret
字符串的长度
int HAL_SetProductKey(_IN_ char *product_key);
设置设备的ProductKey
, 用于标识设备的品类, 三元组之一
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
product_key | char * | 输入 | 指向待设置ProductKey 字符串的指针 |
待设置ProductKey
字符串的长度
int HAL_SetProductSecret(_IN_ char *product_secret);
设置设备的ProductSecret
, 用于标识品类的密钥, 在一型一密场景中会使用到此字符串
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
product_secret | char * | 输出 | 指向待传入ProductSecret 字符串的指针 |
待设置ProductSecret
字符串的长度
void HAL_SleepMs(_IN_ uint32_t ms);
睡眠函数, 使当前执行线程睡眠指定的毫秒数
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
ms | uint32_t | 输入 | 线程挂起的时间, 单位ms |
void
int HAL_Snprintf(_OU_ char *str, _IN_ const int len, _IN_ const char *fmt, ...);
打印函数, 向内存缓冲区格式化构建一个字符串, 参考C99标准库函数
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
str | char * | 输入 | 指向字符缓冲区的指针 |
len | int | 输入 | 缓冲区的字符长度 |
fmt | const char * | 输入 | 格式化字符串 |
… | 输入 | 可变参数列表 |
实际写入缓冲区的字符串长度
void HAL_Srandom(_IN_ uint32_t seed);
随机数播种函数, 使 HAL_Random 的返回值每个随机序列各不相同, 类似C标准库中的srand
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
seed | uint32_t | 输入 | 用于产生新随机序列的种子 |
void
void HAL_Sys_reboot(void);
系统立即重启
void
void
void *HAL_Timer_Create(const char *name, void (*func)(void *), void *user_data);
创建指定名称的定时器, 同时注册用户回调函数和用户数据
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
name | const char * | 输入 | 定时器名称字符串 |
func | void (func)(void ) | 输入 | 用户回调函数 |
user_data | void * | 输入 | 指向用户数据的指针 |
值 | 说明 |
---|---|
NULL | 创建失败 |
!NULL | 创建成功, 返回定时器句柄 |
int HAL_Timer_Delete(void *timer);
删除由HAL_Timer_Create()
创建的定时器, 释放资源
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
timer | void * | 输入 | 定时器句柄, 此句柄由调用HAL_Timer_Create() 时返回 |
值 | 说明 |
---|---|
0 | 操作成功 |
-1 | 操作失败 |
int HAL_Timer_Start(void *t, int ms);
启动定时器
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
timer | void * | 输入 | 定时器句柄, 此句柄由调用HAL_Timer_Create() 时返回 |
ms | int | 输入 | 定时器定时时间, 单位ms |
值 | 说明 |
---|---|
0 | 操作成功 |
-1 | 操作失败 |
int HAL_Timer_Stop(void *t);
关闭定时器
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
timer | void * | 输入 | 定时器句柄, 此句柄由调用HAL_Timer_Create() 时返回 |
值 | 说明 |
---|---|
0 | 操作成功 |
-1 | 操作失败 |
uint64_t HAL_UptimeMs(void);
获取设备从上电到当前时刻所经过的毫秒数
void
设备从上电到当前时刻所经过的毫秒数
long long HAL_UTC_Get(void);
获取UTC时间, 数值为从Epoch(1970年1月1日00:00:00 UTC)开始所经过的秒数单位
void
单位为ms的UTC时间
void HAL_UTC_Set(long long ms);
设置UTC时间, 设置参数为从Epoch(1970年1月1日00:00:00 UTC)开始所经过的秒数单位
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
ms | long long | 输入 | 单位为ms的UTC时间 |
void
int HAL_Vsnprintf(_OU_ char *str, _IN_ const int len, _IN_ const char *fmt, _IN_ va_list ap);
格式化输出字符串到指定buffer中, 可参考C标准库的vsnprintf()
实现
参数 | 数据类型 | 方向 | 说明 |
---|---|---|---|
str | char * | 输出 | 用于存放写入字符串的buffer |
len | const int | 输入 | 允许写入的最大字符串长度 |
fmt | const char | 输入 | 格式化字符串 |
ap | va_list | 输入 | 可变参数列表 |
成功写入的字符串长
在文档使用中是否遇到以下问题
更多建议
匿名提交