MCU SDK快速接入
更新时间:2020-11-24T09:01:25Z
MCU SDK是根据立达信开发平台定义的产品功能。为了减少使用立达信通用串口协议的对接成本,MCU SDK上完成了与WiFi模组之间的通信协议解析,并提欧共相关的通信调用接口、用户层处理接口,使用户无需关注通信协议部分,可以专注开发mcu相关的功能部分。方便用户快速完成功能开发。
1-mcu选型
立达信MCU SDK代码对MCU要求如下,资源不足的用户,可自行对接串口协议,SDK包中的函数可以作为使用参考。
- Flash: 10kbyte
- Ram: 2kbyte
- Mcu支持2组uart,一组用于与wifi模组通信(必须),一组用于输出调试信息(可选)。
2-文件结构
目录 | 文件 | 描述 |
---|---|---|
mcu_sdk/lds_lib | lds_std.clds_std.hlds_utils.clds_utils.hxstdlib.cxstdlib.hxstddef.clds_types.h | 通用类型、函数等定义 |
mcu_sdk/lds_binary | lds_binary_dev_attr.clds_binary_dev_attr.hlds_binary_handle.clds_binary_handle.h | 协议数据字段的解析、封包 |
mcu_sdk/lds_include | lds_log.hlds_mcu_sdk_config.hlds_sdk_err_code.h | SDK宏定义、错误码 |
mcu_sdk/lds_uart | lds_uart_common.hlds_wifi_uart_protocol.clds_wifi_uart_protocol.hlds_wifi_uart_handle.clds_wifi_uart_handle.h | 串口协议定义、解析、封包、接口提供 |
mcu_sdk/lds_ota | lds_ota_handler.clds_ota_handler.h | OTA解析 |
mcu_sdk/ | lds_arnoo_config.clds_arnoo_config.h | 产品功能属性定义 |
mcu_sdk/ | lds_dev_status.clds_dev_status.hlds_mcu_sdk_include.h | 设备信息、属性、状态维护 |
mcu_sdk/ | lds_user_ctrl.clds_user_ctrl.h | SDK上的提供给用户实现的接口,WiFi下发的控制,都会回调对应的接口。 |
mcu_sdk/ | lds_user_config.h | 用户宏定义:固件版本号 |
mcu_sdk/ | lds_led_ctrl.clds_led_ctrl.h | led指示灯控制(可选) |
3-移植步骤
31-创建mcu基础功能
用户需自己创建工程或者已有工程中,完成MCU的相关外设初始化,如:IO口、串口、定时器、PWM(调光灯)等。
32-移植mcu-sdk
-
把SDK文件放置在工程目录下,并添加到工程编译器。
-
在编译器中添加.h文件的引用路径。需添加的路径如下:
mcu_sdk/lds_include
mcu_sdk/lds_binary
mcu_sdk/lds_lib
mcu_sdk/lds_ota
mcu_sdk/lds_uart
mcu_sdk
例子,以keil编译器为例,如下图
-
编译器上选择“C99 Mode”
例子,以keil编译器为例,如下图:
-
设置heap size:合适的大小,推荐至少2K。
例子,以keil编译器为例,如下图:
33-设置sdk调试信息输出
-
在“lds_user_ctrl.h”中修改,如下图:
若需要使用uart debug口,则需定义”#define UART_DEBUG_ENABLE”,并且重新定义user_printf,指向自己单片机平台支持的printf。
若不需要使用uart debug口,则注释定义”// #define UART_DEBUG_ENABLE”。
-
在“lds_log.h”中修改log输出等级。
34-设置sdk串口发送
在lds_user_ctrl.c中重新修改LdsUserMcuWifiUartSend,在该函数中实现uart发送函数。
35-关键接口函数使用
-
串口数据处理接口,当MCU收到一包完整的wifi uart指令信息时,调用LdsWifiUartCmdHandle接口进行处理。
-
led处理接口,若需要使用SDK上的led状态控制接口,主要为配网led状态接口;则需要把LdsLedPollingHandle放在循环处理函数中,并传入ms级的计数参数。
-
ota超时处理:需要把LdsOtaFlashTimeoutHandle放在循环处理函数中,并传入ms级的计数参数。
36-用户回调接口处理
所有wifi下发的串口指令都会在lds_user_ctrl.c对应的函数中实现:
-
设备复位处理函数:LdsUserResetCtrl
-
设备属性控制处理函数:LdsUserDevAttrCtrl,在该回调函数中处理下发的属性控制。
-
设备方法事件处理函数:LdsUserDevActionCtrl,在该回调函数中处理下发的方法事件控制。
-
设备状态信息更新:ldsUserDeviceStatusCheck
-
设备信息更新处理:LdsUserWifiMsgUpdate
-
OTA处理接口:
Ota开始:LdsUserMcuOtaEraseDataAreaCb
Ota收包:LdsUserMcuOtaSaveDataCb
Ota结束:LdsUserMcuOtaCompleteCb
-
遥控器处理接口:
处理函数:LdsUserRemoteCtrl
4-接口说明
41-uart协议接口
411-uart接收处理接口
列表 | 描述 |
---|---|
函数 | ERR_CODE_E LdsWifiUartCmdHandle(xt_u8 *buf, xt_u16 len) |
功能 | 处理mcu接收到的wifi uart数据 |
参数 | Buf:串口数据bufferLen:串口数据长度 |
返回值 | ERR_CODE_E定义 |
使用说明 | Mcu在接收完串口数据后,直接调用该接口,并传入数据buffer和数据长度。 |
412-uart发送请求接口
- 获取wifi信息请求,WiFi信息参考xt_wifi_msg_t结构体。
列表 | 描述 |
---|---|
函数 | void LdsUartCmdWifiMsgRequest(void) |
功能 | 发送请求wifi信息 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该接口,会发送更新设备信息请求包。 |
- 获取wifi连接状态,wifi连接状态参考xt_wifi_status_e枚举。
列表 | 描述 |
---|---|
函数 | void ldsUartCmdConnectStatusRequest(void) |
功能 | 发送请求wifi连接状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该接口,会发送读取wifi连接状态请求包。 |
- 获取产品信息,产品信息参考xt_product_info_t结构体。
列表 | 描述 |
---|---|
函数 | void LdsUartCmdQueryMsgRequest (void) |
功能 | 发送请求读取产品信息 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该接口,会发送更新产品信息请求包。 |
- 获取wifi版本信息:
列表 | 描述 |
---|---|
函数 | void LdsUartCmdWifiVersionRequest (void) |
功能 | 发送请求读取wifi版本信息 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该接口,会发送读取wifi版本信息请求包。 |
- 获取wifi时间:
列表 | 描述 |
---|---|
函数 | void ldsUartCmdTimeRequest (void) |
功能 | 发送请求读取时间信息 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该接口,会发送读取时间请求包。 |
- 请求复位
列表 | 描述 |
---|---|
函数 | void ldsUartCmdResetRequest (void) |
功能 | 发送请求wifi复位 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该接口,会发送复位wifi模块请求包。 |
- 设备属性上报
列表 | 描述 |
---|---|
函数 | void LdsUartCmdAttrNotify(xt_attr_t *attr, xt_s32 count, xt_u8 ep) |
功能 | 设备属性变化上报 |
参数 | Attr: 上报的设备属性结构体指针。Count:上报的属性个数Ep:上报的endpoint |
返回值 | 无 |
使用说明 | 直接调用该接口,并传入上报的设备属性值结构体指针和属性上报个数。 |
- 设备方法事件上报
列表 | 描述 |
---|---|
函数 | void LdsUartCmdActionNotify(xt_action_t *attr, xt_s32 count, xt_u8 ep) |
功能 | 设备方法事件上报 |
参数 | Attr: 上报的设备方法事件结构体指针。Count:上报的属性个数Ep:上报的endpoint |
返回值 | 无 |
使用说明 | 直接调用该接口,并传入上报的设备方法事件值结构体指针和方法事件上报个数。 |
- 设备属性上报
列表 | 描述 |
---|---|
函数 | void LdsUartCmdFtmRequest(xt_rostring ssid, xt_rostring password, xt_wifi_mode_e mode) |
功能 | Mcu请求wifi模块进入厂测 |
参数 | Ssid:wifi路由ssidPassword:wifi路由器密码Mode:wifi模组工作模式 |
返回值 | 无 |
使用说明 | 直接调用该接口,并传入上报的wifi参数。 |
42-用户层回调接口
Uart协议处理回调接口层,用户在该层修改设备功能。
421-功能处理接口
lds_user_ctrl.c中函数接口:
- 复位处理函数:
列表 | 描述 |
---|---|
函数 | void LdsUserResetCtrl(xt_wifi_rst_type_e type, xt_wifi_rst_status_e status) |
功能 | Wifi复位处理接口 |
参数 | Type:Wifi请求的复位RESET_TYPE_WIFI_REQMcu请求的复位RESET_TYPE_MCU_REQStatus:成功WIFI_RESET_SUCC失败WIFI_RESET_FAIL |
返回值 | 无 |
使用说明 | 一旦wifi/mcu发送复位请求,该函数会被回调处理,用户需要在该函数中实现自己的复位逻辑功能。 |
- 设备属性控制处理函数
列表 | 描述 |
---|---|
函数 | void LdsUserDevAttrCtrl(xt_attr_t *new_attr, xt_u8 count, xt_u8 ep) |
功能 | wifi控制时,设备属性处理回调函数 |
参数 | New_attr: 输入属性结构体数据指针Count:输入属性个数Ep:输入endpoint |
返回值 | 无 |
使用说明 | 一旦发生wifi属性控制时,该函数会被回调处理,用户需要在该函数中实现自己的设备控制。 |
- wifi信息更新处理函数
列表 | 描述 |
---|---|
函数 | void LdsUserWifiMsgUpdate(void) |
功能 | Wifi信息更新处理回调函数 |
参数 | 无 |
返回值 | 无 |
使用说明 | 一旦发生wifi信息变更时,该函数会被回调处理,用户需要在该函数中实现自己的信息变更处理。 |
- 设备方法事件控制处理函数
列表 | 描述 |
---|---|
函数 | void LdsUserDevActionCtrl(xt_action_t *new_attr, xt_u8 count, xt_u8 ep) |
功能 | wifi控制时,设备方法事件处理回调函数 |
参数 | New_attr: 输入方法事件结构体数据指针Count:输入属性个数Ep:输入endpoint |
返回值 | 无 |
使用说明 | 一旦发生wifi方法控制时,该函数会被回调处理,用户需要在该函数中实现自己的设备控制。 |
- 遥控器时间处理接口
列表 | 描述 |
---|---|
函数 | ERR_CODE_E LdsUserRemoteCtrl(xt_u8 *data, xt_u16 len) |
功能 | 遥控器事件处理函数 |
参数 | Data:遥控器事件参数值 |
返回值 | Len:遥控器事件参数长度 |
使用说明 | 当用户通过解析data,来处理遥控事件 |
422-ota处理接口
lds_ota_handler.c函数中接口:
- ota准备处理函数
列表 | 描述 |
---|---|
函数 | ERR_CODE_E LdsUserMcuOtaEraseDataAreaCb(xt_u32 image_size) |
功能 | ota前开始准备动作处理,比如flash擦除等。 |
参数 | image_size: ota包大小 |
返回值 | ERR_CODE_E |
使用说明 | 查询到版本变更时,开始ota前,该函数会被调用处理一次,用于用户做ota的准备工作,比如设置ota包长度、擦除flash、显示提示等。 |
- ota收包处理函数
列表 | 描述 |
---|---|
函数 | ERR_CODE_E LdsUserMcuOtaSaveDataCb(xt_u8 *data, xt_u16 len) |
功能 | Ota收数据包处理 |
参数 | Data:ota 数据包Len:ota数据包大小 |
返回值 | ERR_CODE_E |
使用说明 | Ota过程中的收包处理,比如包头校验、数据保存在buffer中、写到flash等操作。 |
- ota结束处理函数
列表 | 描述 |
---|---|
函数 | ERR_CODE_E LdsUserMcuOtaCompleteCb(xt_u8 type, xt_u32 rev_len) |
功能 | Ota结束处理 |
参数 | Type:未开始OTA_STATUS_IDLE进行中OTA_STATUS_START收包完成OTA_STATUS_RECEIVE_OVER超时OTA_STATUS_TIMEOUTRev_len: 总收包长度 |
返回值 | ERR_CODE_E |
使用说明 | Ota结束处理,根据type判断结束类型,做相应的处理 |
- ota数据包长度设置接口
列表 | 描述 |
---|---|
函数 | static ERR_CODE_E LdsOtaDataLenSet(xt_u16 len); |
功能 | Ota数据包长度设置 |
参数 | Len:设置数据包长度(4 – 1024) |
返回值 | ERR_CODE_E |
使用说明 | 可以在LdsUserMcuOtaEraseDataAreaCb中设置每包ota数据长度,也可以不设置,不设置默认每包长度为512byte |
- ota失败请求结束接口
列表 | 描述 |
---|---|
函数 | void LdsOtaErrorSetFailComplete(void); |
功能 | Ota失败结束请求函数 |
参数 | 无 |
返回值 | 无 |
使用说明 | 当用户发现ota错误时,可以调用该函数,结束ota过程。 |
- ota超时处理接口
列表 | 描述 |
---|---|
函数 | void LdsOtaFlashTimeoutHandle(xt_u32 time_diff); |
功能 | Ota超时处理函数 |
参数 | Time_diff: 时间参数,时间变化值,单位ms |
返回值 | 无 |
使用说明 | 当用户需要启用ota超时及重传机制时,把该函数放在循环处理位置,并传入时间变化参数。默认超过5s未接收到ota数据,则重新请求ota数据,最多重传3s。 |
423-属性控制接口
列表 | 描述 |
---|---|
函数 | void LdsUserDevAttrCtrl(xt_attr_t *new_attr, xt_u8 count, xt_u8 ep) |
功能 | 用户处理控制属性回调接口 |
参数 | new_attr:控制属性结构体参数count:控制属性结构体个数ep:endpoint号 |
返回值 | 无 |
使用说明 | 用户根据自己的endpoint及属性id实现设备端的处理。属性id根据枚举类型DEV_ATTR_E定义。 |
如下图:根据属性id判断对应的控制属性,并根据属性值得类型做设备端的控制;处理完设备控制属性后,调用LdsUartCmdAttrNotify上报设备状态。
424-方法事件控制接口
列表 | 描述 |
---|---|
函数 | void LdsUserDevActionCtrl (xt_action_t *new_attr, xt_u8 count, xt_u8 ep) |
功能 | 用户处理控制方法回调接口 |
参数 | new_attr:控制属性结构体参数count:控制属性结构体个数ep:endpoint号 |
返回值 | 无 |
使用说明 | 用户根据自己的endpoint及方法id实现设备端的处理,方法id根据设备支持的方法做定义。 |
如下图:根据属性id判断对应的控制属性,并根据方法参数值的类型做设备端的控制;处理完设备控制方法后,调用LdsUartCmdActionNotify上报设备状态。
425-wifi信息更新回调接口
列表 | 描述 |
---|---|
函数 | LdsUserWifiMsgUpdate (void) |
功能 | WiFi状态信息更新回调处理 |
参数 | 无 |
返回值 | 无 |
使用说明 | 当更新wifi信息时,该函数会被回调,用户可以在自己的设备端做用户信息更新处理。 |
如下图:
43-用户led控制接口
431-led循环处理接口
- 循环处理函数:
列表 | 描述 |
---|---|
函数 | void LdsLedPollingHandle(xt_u32 time_diff) |
功能 | 循环处理led的状态 |
参数 | Time_diff:单位ms循环处理中的时间变化参数,用于led做时间判断。 |
返回值 | 无 |
使用说明 | 把该函数放在以ms级的循环处理中执行,并传入时间变化参数。 |
432-led设置接口
- 设置未配网led指示状态
函数 | void LdsLedSetForUnpair(void); |
---|---|
功能 | 设置未配网led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。未配网状态led以0.667hz频率持续闪烁1min。 |
- 设置配网过程中led指示状态
函数 | void LdsLedSetForPairing (void); |
---|---|
功能 | 设置配网过程中led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。配网过程中led以2.5hz频率持续闪烁最长闪烁3min。 |
- 设置配网成功led指示状态
函数 | void LdsLedSetForPairedSucc (void); |
---|---|
功能 | 设置配网成功led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。配网成功led常亮3s。 |
- 设置配网失败led指示状态
函数 | void LdsLedSetForPairedFail (void); |
---|---|
功能 | 设置配网失败led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。配网失败led灭。 |
- 设置设备离线led指示状态
函数 | void LdsLedSetForOffLine (void); |
---|---|
功能 | 设置设备离线led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备离线led以2.5hz频率持续闪烁1min。 |
- 设置设备上线led指示状态
函数 | void LdsLedSetForOnLine (void); |
---|---|
功能 | 设置设备上线led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备上线led常亮3s。 |
- 设置设备ota开始led指示状态
函数 | void LdsLedSetForOtaStart (void); |
---|---|
功能 | 设置设备ota开始led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备ota开始led以2.5hz频率持续闪烁。 |
- 设置设备ota成功led指示状态
函数 | void LdsLedSetForOtaSucc (void); |
---|---|
功能 | 设置设备ota成功led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备ota成功led常亮3s。 |
- 设置设备ota失败led指示状态
函数 | void LdsLedSetForOtaFail (void); |
---|---|
功能 | 设置设备ota成功led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备ota失败led灭。 |
- 设置设备复位开始led指示状态
函数 | void LdsLedSetForResetStart (void); |
---|---|
功能 | 设置设备复位开始led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备复位开始led以2.5hz频率闪烁。 |
- 设置设备复位开始led指示状态
函数 | void LdsLedSetForResetSucc (void); |
---|---|
功能 | 设置设备复位成功led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备复位成功led常亮5s。 |
- 设置设备复位失败led指示状态
函数 | void LdsLedSetForResetFail (void); |
---|---|
功能 | 设置设备复位失败led指示状态 |
参数 | 无 |
返回值 | 无 |
使用说明 | 直接调用该函数。设备复位失败led灭。 |
5-设备状态
Lds_dev_status.c / lds_dev_status.h中定义了设备的状态信息。
51-设备信息
- wifi信息
列表 | 描述 |
---|---|
变量 | static xt_wifi_msg_t sg_wifi_msg; |
定义 | typedef struct{ xt_u8 ip[4]; xt_u8 mac[6]; xt_u8 ssid[MAX_SSID_LEN]; xt_u8 mode;} xt_wifi_msg_t; |
Ip | Wifi ip地址4byte |
Mac | Wifi mac地址6byte |
Ssid | Wifi rssi最长32byte |
Mode | 枚举类型typedef enum{ WIFI_MODE_UNKNOW = 0, WIFI_MODE_AP = 1, // ap WIFI_MODE_STATION = 2, // station WIFI_MODE_AP_STATION = 3 // ap/station} xt_wifi_mode_e; |
- wifi连接状态
列表 | 描述 |
---|---|
变量 | static xt_wifi_status_e sg_wifi_connect_status |
状态值 | 参考“外接mcu串口协议”中定义描述typedef enum{ WIFI_STATUS_AP_START = 0, WIFI_STATUS_AP_STOP = 1, WIFI_STATUS_STA_START = 102, WIFI_STATUS_STA_STOP = 103, WIFI_STATUS_STA_CONNECT_TO_AP = 104, WIFI_STATUS_STA_DISCONNECT_FORM_AP = 105, WIFI_STATUS_MQTT_ADDR_SUCC = 201, WIFI_STATUS_MQTT_ADDR_FAIL = 202, WIFI_STATUS_MQTT_JSON_ERR = 203, WIFI_STATUS_MQTT_CONNECT_SUCC = 204, WIFI_STATUS_MQTT_DNS_FAIL = 205, WIFI_STATUS_MQTT_CONNECT_ERR = 206, WIFI_STATUS_MQTT_SSL_ERR = 207, WIFI_STATUS_MQTT_CONNECT_FAIL = 208, WIFI_STATUS_SUBSCRIBE_FAIL = 209, WIFI_STATUS_SYNC_FAIL = 210, WIFI_STATUS_BOUND_SUCC = 211, WIFI_STATUS_BOUND_FAIL = 212, WIFI_STATUS_SUBCRIBE_APP_FAIL = 213, WIFI_STATUS_MQTT_LOGIN = 214, WIFI_STATUS_DEVICE_BOUNDING = 215, WIFI_STATUS_DEVICE_BOUND_SUCC = 216, WIFI_STATUS_UNKNOW = 255} xt_wifi_status_e; |
- wifi版本信息
列表 | 描述 |
---|---|
变量 | static xt_u8 sg_wifi_version[WIFI_VER_LEN] |
版本号 | Byte0为主版本号,byte1为次版本号。 |
- wifi时间信息
列表 | 描述 |
---|---|
变量 | static xt_rtc_t sg_wifi_time |
时间结构 | typedef struct{ xt_u16 year; xt_u8 month; xt_u8 day; xt_u8 hour; xt_u8 min; xt_u8 second;} xt_rtc_t; |
- wifi产品信息
列表 | 描述 |
---|---|
变量 | static xt_product_info_t sg_prod_msg |
定义 | #define MODEL_ID_LEN (32 + 1)#define UUID_LEN (32 + 1) typedef struct{ xt_u8 model_id[MODEL_ID_LEN]; xt_u8 uuid[UUID_LEN];} xt_product_info_t; |
Model id | 字符串,32byte |
Uuid | 字符串,32byte |
- 设备属性信息
列表 | 描述 |
---|---|
变量 | Static xt_attr_t sg_dev_attr[DEV_EP_COUNT][DEV_ATTR_COUNT] |
定义 | /* device attribute type /typedef struct xt_attr { xt_u8 id; / attribute type:INTER_ATTR_E / DATA_TYPE_E type; xt_u8 len; / attribute string value len / union { xt_s32 valueint; xt_double valuedouble; xt_u8 valuestring[ATTR_STRING_LEN]; } value; / dev attribute */} xt_attr_t; |
id | 属性类型,在lds_arnoo_config.h中定义 |
Type | 数据类型:typedef enum { DATA_TYPE_INT = 1, /* int / DATA_TYPE_STRING, / string / DATA_TYPE_ENUM, / enum / DATA_TYPE_DOUBLE, / double */ DATA_TYPE_MAX} DATA_TYPE_E; |
Len | 当type为DATA_TYPE_STRING时定义字符串长度。 |
Value | 属性值 |
52-设备信息接口
- 设备信息初始化
列表 | 描述 |
---|---|
函数 | void LdsDevStatusInit(void) |
功能 | 设备信息初始化 |
参数 | 无 |
返回值 | 无 |
使用说明 | 用户在初始化程序段中调用该函数,初始化设备状态。用户可以实际使用情况修改函数中的代码。 |
- 属性信息更新
列表 | 描述 |
---|---|
函数 | void LdsDevAttrUpdate(xt_attr_t *new_attr, xt_u8 count) |
功能 | 设备属性信息更新 |
参数 | 无 |
返回值 | 无 |
使用说明 | 1、当用户设备端控制属性信息更新时,可以调用该函数更新设备当前属性。2、app设置属性时,会自动调用该接口,进行属性更新。 |
- 获取设备属性接口
列表 | 描述 |
---|---|
函数 | xt_attr_t * LdsDevAttrGet(void) |
功能 | 获取设备属性 |
参数 | 无 |
返回值 | 设备属性结构体指针 |
使用说明 | 调用该函数,获取设备属性指针 |
- 获取wifi版本信息接口
列表 | 描述 |
---|---|
函数 | xt_u8 * LdsWifiVersionGet(void) |
功能 | 获取wifi版本信息 |
参数 | 无 |
返回值 | Wifi版本信息字符串指针 |
使用说明 | 调用该函数,获取wifi版本信息指针 |
- 获取wifi信息接口
列表 | 描述 |
---|---|
函数 | xt_wifi_msg_t * LdsWifiMsgGet(void) |
功能 | 获取wifi信息 |
参数 | 无 |
返回值 | Wifi信息结构体指针 |
使用说明 | 调用该函数,获取wifi信息结构体指针 |
- 获取wifi连接状态接口
列表 | 描述 |
---|---|
函数 | xt_u8 * LdsWifiConnectStatusGet(void) |
功能 | 获取wifi连接状态 |
参数 | 无 |
返回值 | Wifi连接状态指针 |
使用说明 | 调用该函数,获取wifi连接状态指针 |
- 获取wifi时间接口
列表 | 描述 |
---|---|
函数 | xt_rtc_t * LdsWifiTimeGet(void) |
功能 | 获取wifi时间 |
参数 | 无 |
返回值 | Wifi时间结构体指针 |
使用说明 | 调用该函数,获取wifi时间结构体指针 |
- 获取wifi产品信息接口
函数 | xt_product_info_t * LdsWifiProductMsgGet(void) |
---|---|
功能 | 获取wifi产品信息 |
参数 | 无 |
返回值 | Wifi产品信息结构体指针 |
使用说明 | 调用该函数,获取wifi产品信息结构体指针 |
- 获取设备信息更新标志
函数 | xt_bool LdsWifiMsgUpdateFlag(void) |
---|---|
功能 | 获取wifi信息更新标志位 |
参数 | 无 |
返回值 | Wifi信息更新标志位 |
使用说明 | 调用该函数,获取wifi信息更新标志位 |
- 清除wifi信息更新标志位
函数 | void LdsWifiMsgUpdateFlagClear(void) |
---|---|
功能 | 清除wifi信息更新标志位 |
参数 | 无 |
返回值 | 无 |
使用说明 | 调用该函数,清除wifi信息更新标志位 |
- 设置wifi信息更新标志位
函数 | void LdsWifiMsgUpdateFlagSet(void) |
---|---|
功能 | 设置wifi信息更新标志位 |
参数 | 无 |
返回值 | 无 |
使用说明 | 调用该函数,设置wifi信息更新标志位 |
- 获取指定endpoint的列表索引位置
函数 | xt_u8 LdsDevEpIndexGet(xt_u8 ep) |
---|---|
功能 | 获取endpoint的列表索引位置 |
参数 | Ep: endpoint值 |
返回值 | 无 |
使用说明 | 调用该函数,获取endpoint的列表索引位置 |
- 根据索引位置获取endpoint值
函数 | xt_u8 LdsGetDevEpForIndex(xt_u8 index) |
---|---|
功能 | 根据索引位置获取endpoint值 |
参数 | Ep: endpoint值 |
返回值 | 无 |
使用说明 | 调用该函数,获取endpoint的值 |