new/docs/cn/Linux/Wifibt/WIFIBT编程接口/最新WIFI接口说明.txt

RK平台WIFI API说明

test/			 测试源码目录
include/		 API头文件目录
librkwifibt.so   WiFi应用依赖库

//test目录说明：
//RK WiFi自测程序，WiFi相关API的使用可参考rk_wifi_test.c
main.c
rk_wifi_test.c

//SOFTAP相关的实现源码
softap/

//编程注意事项：
1. RK_wifi_register_callback：切记不要在WiFi的回调函数里面做任何耗时或阻塞的操作，它仅仅反馈WiFi的状态；
2. RK_wifi_enable(0/1): 打开或关闭时，一定要等待RK_WIFI_State_OPEN/RK_WIFI_State_OFF事件反馈，再做下一步操作；
3. RK_wifi_scan_r/RK_wifi_getSavedInfo 这两个API会返回数据给应用，切记要释放返回的指针，防止内存泄露，参考rk_wifi_test.c
4. RK_wifi_enable之前要注册RK_wifi_register_callback回调，监听连接的状态。
5. RK_wifi_connect是非阻塞函数，返回不等于连接成功，要在callback里面确认上一次的连接结果，否则下一次connect调用不会被执行。

//其它
如果库或程序运行错误请确保buildroot配置确保如下配置打开：
BR2_PACKAGE_WPA_SUPPLICANT_WPA_CLIENT_SO
BR2_PACKAGE_BLUEZ5_UTILS

//错误示范：


API说明:
//EVENT 事件回调函数，事件如下：
typedef enum {
	RK_WIFI_State_IDLE = 0,
	RK_WIFI_State_CONNECTING,
	RK_WIFI_State_CONNECTFAILED,
	RK_WIFI_State_CONNECTFAILED_WRONG_KEY,
	RK_WIFI_State_CONNECTED,
	RK_WIFI_State_DISCONNECTED,
	RK_WIFI_State_OPEN,
	RK_WIFI_State_OFF,
	RK_WIFI_State_SCAN_RESULTS,
	RK_WIFI_State_DHCP_OK,
} RK_WIFI_RUNNING_State_e;
int RK_wifi_register_callback(RK_wifi_state_callback cb);

//获取当前WiFi状态
int RK_wifi_running_getState(RK_WIFI_RUNNING_State_e* pState);

//获取当前WiFi的详细信息：
typedef struct {
	int id;
	char bssid[BSSID_BUF_LEN];
	char ssid[SSID_BUF_LEN];
	int freq;
	char mode[20];
	char wpa_state[20];
	char ip_address[20];
	char mac_address[20];
	int reason;
} RK_WIFI_INFO_Connection_s;
int RK_wifi_running_getConnectionInfo(RK_WIFI_INFO_Connection_s* pInfo);

//打开关闭WIFI
int RK_wifi_enable(int enable);

//发起扫描：
int RK_wifi_scan(void);

//获取扫描结果，以json格式返回
char* RK_wifi_scan_r(void);

//连接WiFi
int RK_wifi_connect(char* ssid, const char* psk);

//连接WEP加密的WiFi
int RK_wifi_connect_wep(char* ssid, const char* psk);

//断开WiFi
int RK_wifi_disconnect_network(void);

//忘记之前连接SSID
int RK_wifi_forget_with_ssid(char *ssid);

//取消正在连接的WiFi
int RK_wifi_cancel(void);

//获取之前连接过的WiFi， ap_cnt为之前连过的个数
typedef struct {
	int id;
	char bssid[BSSID_BUF_LEN];
	char ssid[SSID_BUF_LEN];
	char state[STATE_BUF_LEN];
} RK_WIFI_SAVED_INFO_s;
int RK_wifi_getSavedInfo(RK_WIFI_SAVED_INFO_s **pInfo, int *ap_cnt);

//连接之前连接过的WiFi，参数为SSID
int RK_wifi_connect_with_ssid(char* ssid);

//恢复WiFi出厂设置
int RK_wifi_reset(void);

//SOFTAP模式下获取WIFI扫描结果，以json格式返回
char *RK_wifi_scan_for_softap(void)


//SOFTAP功能开源，源码参考test/softap/softap.c
//回调event
typedef enum {
	RK_SOFTAP_STATE_IDLE=0,
	RK_SOFTAP_STATE_CONNECTTING,
	RK_SOFTAP_STATE_SUCCESS,
	RK_SOFTAP_STATE_FAIL,
	RK_SOFTAP_STATE_DISCONNECT,
} RK_SOFTAP_STATE;
int RK_softap_register_callback(RK_SOFTAP_STATE_CALLBACK cb)

//启动热点，psk为空则为不加密，IP网关地址（暂未使用，softap固定为：10.201.126.1，可以根据实际需求更改）
int wifi_start_hostapd(char *ssid, char *psk, char *ip)

//关闭热点
int wifi_stop_hostapd(void)

//SOFTAP配网DEMO
//启动一个名为name的热点，并开始配网流程，正常情况下手机在setting界面找到并连接上面启动的热点
int RK_softap_start(char *name, RK_SOFTAP_SERVER_TYPE server_type)
{
	//打开WiFi
	RK_wifi_enable(1);
	//启动热点
	wifi_start_hostapd(name, NULL, NULL);
	//启动跟手机数据交互服务，依赖手机APK端的实现，根据实际需求修改
	startTcpServer();

	return 0;
}

//startTcpServer启动一个跟手机交互的线程，端口：#define SOCKET_PORT 8443
static void *threadAccept(void *arg)
{
	... ...
	while (1)
		fd_client = accept(fd_server, (struct sockaddr *)&addr_client, &len_addr_client);
		handleRequest(fd_client);
			if (strstr(buf, REQUEST_WIFI_LIST)) {
				//收到手机侧的获取WiFi列表命令
				sendWifiList(fd_client, buf);
					RK_wifi_scan();
					RK_wifi_scan_for_softap();
					send(fd, send_msg, sizeof(send_msg), 0);
			} else if (strstr(buf, REQUEST_WIFI_SET_UP)) {
				//收到手机侧的获取WiFi列表命令			
				wifiSetup(fd_client, buf);
					//解析手机发来的ssid/psk，然后调用连接API
					RK_wifi_connect(softap_ssid, softap_psk);
			} else if (strstr(buf, REQUEST_IS_WIFI_CONNECTED)) {
				isWifiConnected(fd_client, buf);
					//手机侧循环发送获取WiFi的连接状态	
					if (!RK_wifi_running_getConnectionInfo(&info)) {
						if (strncmp(info.wpa_state, "COMPLETED", 9) == 0) //如果连接成功
							isConn = 1;
					}
					snprintf(msg, sizeof(msg), HTTP_RESPOSE_MESSAGE, 1, isConn ? "1" : "0");
					send(fd, msg, sizeof(msg), 0) //发送成功的信息给手机
			} else if (strstr(buf, REQUEST_POST_CONNECT_RESULT)) {
				//收到手机侧的配网完成指令
				doConnectResult(fd_client, buf);
					wifi_stop_hostapd();//关闭热点
			}
	... ...
}

//关闭配网
int RK_softap_stop(void);