213 lines
6.2 KiB
C
213 lines
6.2 KiB
C
#ifndef __SDK_H
|
||
#define __SDK_H
|
||
|
||
/*
|
||
* 0. implement all callback's of this SDK
|
||
* 1. read wifi probe frame from driver
|
||
* 2. feed wifi probe frame to sdk_pkt_process
|
||
* 3. this sdk depends on no thirdparty libraries, and there is no internet connection with net.
|
||
*/
|
||
|
||
|
||
typedef unsigned char uint8;
|
||
typedef unsigned short int uint16;
|
||
typedef unsigned int uint32;
|
||
|
||
typedef char int8;
|
||
typedef short int int16;
|
||
typedef int int32;
|
||
|
||
#define SDK_SUCCESS (0)
|
||
#define SDK_FAIL (1)
|
||
#define SDK_NULL (0)
|
||
#define OUI_LEN (3)
|
||
#define OUI_TYPE (0)
|
||
#define OUI_TYPE_LEN (1)
|
||
#define MAC_LEN (6)
|
||
#define SSID_MAX_LEN (32)
|
||
#define PASSWORD_MAX_LEN (32)
|
||
#define SDK_SHAREDKEY_LEN (32)
|
||
#define SDK_FRAME_MAX_LEN (1460)
|
||
#define FASTCON_MASTER_ID_LEN (4)
|
||
|
||
#define SDK_PACKED __attribute__((packed))
|
||
|
||
|
||
typedef void* (*sdk_memset_t) (
|
||
void* ptr,
|
||
int32 value,
|
||
uint32 num);
|
||
typedef void* (*sdk_memcpy_t) (
|
||
void* dst,
|
||
const void* src,
|
||
uint32 num);
|
||
typedef int32 (*sdk_memcmp_t) (
|
||
const void* ptr1,
|
||
const void* ptr2,
|
||
uint32 num);
|
||
typedef int32 (*sdk_printf_t) (
|
||
const char* format,
|
||
...);
|
||
|
||
typedef struct sdk_device_info_t {
|
||
uint32 vendor_id;
|
||
uint32 product_id;
|
||
uint8 mac[MAC_LEN];
|
||
uint8 * device_info;
|
||
uint16 device_info_len;
|
||
uint8 * device_id;
|
||
uint16 device_id_len;
|
||
}sdk_product_info_t;
|
||
|
||
//发现设备
|
||
typedef int32 (*sdk_found_device_t) (sdk_product_info_t *product_info);
|
||
//对应2.1 云端身份校验接口请求
|
||
typedef int32 (*sdk_challenge_post_t)(
|
||
sdk_product_info_t *product_info,
|
||
uint8 * challenge,
|
||
uint16 challenge_len);
|
||
//对应2.2 设备身份声明接口请求
|
||
typedef int32 (*sdk_signature_post_t)(
|
||
sdk_product_info_t *product_info,
|
||
uint8 * signature,
|
||
uint16 signature_len);
|
||
//sdk将设备控制token传给上层
|
||
typedef int32 (*sdk_device_token_post_t)(
|
||
sdk_product_info_t *product_info,
|
||
uint8 * token,
|
||
uint16 token_len);
|
||
//上报配置结果
|
||
//目前只支持失败结果上报。
|
||
//成功的结果是由云端推送上线通知
|
||
//result 0:成功 -1:失败
|
||
typedef int32 (*sdk_config_result_post_t) (
|
||
sdk_product_info_t *product_info,
|
||
int8 result);
|
||
//发送802.11原始报文接口
|
||
typedef int32 (*sdk_raw_pkt_send_t)(
|
||
uint8 * frame,
|
||
uint16 frame_len);
|
||
|
||
|
||
|
||
|
||
typedef struct {
|
||
sdk_memset_t memset;
|
||
sdk_memcpy_t memcpy;
|
||
sdk_memcmp_t memcmp;
|
||
sdk_printf_t printf;
|
||
|
||
sdk_found_device_t found_device;
|
||
sdk_challenge_post_t challenge_post;
|
||
sdk_signature_post_t signature_post;
|
||
sdk_device_token_post_t device_token_post;
|
||
sdk_config_result_post_t config_result_post;
|
||
|
||
sdk_raw_pkt_send_t send_raw_pkt;
|
||
|
||
} sdk_config_t;
|
||
|
||
typedef struct {
|
||
|
||
//gateway信息
|
||
//包括当前路由器信道，gateway mac，bssid
|
||
uint8 channel; //cur channel
|
||
|
||
//若mac地址为00-11-22-33-44-55，则device_mac[] = {0x00,0x11,0x22,0x33,0x44,0x55};
|
||
uint8 device_mac[MAC_LEN];
|
||
//AP的mac地址，格式等同device_mac
|
||
uint8 bssid[MAC_LEN];
|
||
|
||
//由dnakit后台分配，用于区分不同平台，固定4个字节
|
||
uint8 fastcon_master_id[FASTCON_MASTER_ID_LEN];
|
||
|
||
//0:probe req,1:probe rsp,2:action
|
||
//报文选择，根据gateway 能力自行设置
|
||
uint8 send_wlan_type;
|
||
//回调接口注册
|
||
sdk_config_t sdk_config;
|
||
} SDK_PACKED sdk_user_init_t;
|
||
|
||
typedef enum {
|
||
SDK_STATE_PROBE_DEVICE,
|
||
SDK_STATE_LOCK_CHANNEL,
|
||
SDK_STATE_CONFIG,
|
||
SDK_STATE_CONNECTING,
|
||
SDK_STATE_DONE, //Finish
|
||
SDK_STATE_FAIL,
|
||
} sdk_state_e;
|
||
|
||
/**
|
||
* @brief 打印sdk编译时间
|
||
* @return 0 打印成功
|
||
* SDK_E_INIT_FAIL sdk未初始化
|
||
*/
|
||
extern int32 sdk_version(void);
|
||
/**
|
||
* @brief 初始化sdk
|
||
* @param init
|
||
* @return 0 初始化成功
|
||
* SDK_E_INIT_FAIL
|
||
*/
|
||
extern int32 sdk_init(sdk_user_init_t *init);
|
||
/**
|
||
* @brief 处理接收的802.11报文
|
||
* @param frame 802.11标准报文格式
|
||
* @param frame_len
|
||
* @return sdk_state_e
|
||
SDK_E_INIT_FAIL
|
||
*/
|
||
extern int32 sdk_pkt_process(uint8 *frame, int16 frame_len);
|
||
/**
|
||
* @brief 发送token bind成功报文
|
||
* @return 0 成功
|
||
* SDK_E_INIT_FAIL
|
||
* SDK_E_STATE
|
||
*/
|
||
extern int32 sdk_device_token_bind_success(void);
|
||
/**
|
||
* @brief ssid和password信息发送
|
||
* @param sharedkey 二进制数组，云端返回的是十六进制字符串，需要进行转换
|
||
* @param ssid
|
||
* @param ssid_len
|
||
* @param password
|
||
* @param password_len
|
||
* @return 0 成功
|
||
* SDK_E_INIT_FAIL
|
||
* SDK_E_STATE
|
||
* @example 路由器ssid为"ssid"，password为"password"
|
||
* 代码如下：
|
||
* @code
|
||
* uint8 ssid[] = "ssid";
|
||
* uint8 password[] = "password";
|
||
* sdk_wlan_params_set(sharedkey,ssid,strlen(ssid),password,strlen(password));
|
||
* @endcode
|
||
*/
|
||
extern int32 sdk_wlan_params_set(uint8 sharedkey[SDK_SHAREDKEY_LEN],uint8 *ssid,uint16 ssid_len,uint8 *password,uint16 password_len);
|
||
/**
|
||
* @brief challenge和signature信息发送
|
||
* @param challenge 二进制数组，云端返回的是十六进制字符串，需要进行转换
|
||
* @param challenge_len
|
||
* @param signature 二进制数组，云端返回的是十六进制字符串，需要进行转换
|
||
* @param signature_len
|
||
* @return 0 成功
|
||
* SDK_E_INIT_FAIL
|
||
* SDK_E_STATE
|
||
*/
|
||
extern int32 sdk_challenge_and_signature_set(uint8 *challenge,uint16 challenge_len, uint8 *signature, uint16 signature_len);
|
||
/**
|
||
* @brief 用户确认开始配网
|
||
* @return 0 成功
|
||
* SDK_E_INIT_FAIL
|
||
* SDK_E_STATE
|
||
*/
|
||
extern int32 sdk_user_auth_to_start_config(void);
|
||
/**
|
||
* @brief 清除sdk状态
|
||
* @return 0 成功
|
||
* SDK_E_INIT_FAIL
|
||
*/
|
||
extern int32 sdk_deinit(void);
|
||
|
||
#endif
|