RockChip DeviceIo WIFI Interface Documentation

---

发布版本：1.0

作者：Jacky.Ge

日期：2019.3.29

文件密级：公开资料

---

概述

该文档旨在介绍RockChip DeviceIo库中WiFi相关接口。

读者对象

本文档（本指南）主要适用于以下工程师：

技术支持工程师

软件开发工程师

修订记录

日期	版本	作者	修改说明
2019-3-29	V1.0	Jacky.Ge	初始版本

---

[TOC]

---

1、概述

​ 该代码模块集成在libDeviceIo.so动态库里面，基于wpa封装的wifi操作接口。

2、接口说明

• RK_WIFI_RUNNING_State_e

WIFI的几种状态定义
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_RUNNING_State_e;

• RK_WIFI_CONNECTION_Encryp_e

WIFI加密类型，包括无密码、WPA和WEP三种方式

typedef enum { NONE = 0, WPA, WEP } RK_WIFI_CONNECTION_Encryp_e;

• RK_WIFI_INFO_Connection_s

WIFI状态信息，参考wpa_cli -iwlan0 status
typedef struct { int id; char bssid[20]; char ssid[64]; int freq; char mode[20]; char wpa_state[20]; char ip_address[20]; char mac_address[20]; } RK_WIFI_INFO_Connection_s;

• int RK_wifi_register_callback(RK_wifi_state_callback cb)

注册WIFI状态回调接口，在WIFI状态改变是回调

• int RK_wifi_ble_register_callback(RK_wifi_state_callback cb)

ble wifi回调接口，用于ble配网时回调状态

• int RK_wifi_running_getState(RK_WIFI_RUNNING_State_e* pState)

获取当前WIFI状态，成功返回0

• int RK_wifi_running_getConnectionInfo(RK_WIFI_INFO_Connection_s* pInfo)

获取当前WIFI连接信息，

• int RK_wifi_enable_ap(const char* ssid, const char* psk, const char* ip)

根据传入的ssid、psk和ip开启softAp

• int RK_wifi_disable_ap()

关闭softAp

• int RK_wifi_scan(void)

执行WIFI sacn操作, 参见wpa_cli -iwlan0 scan

• char* RK_wifi_scan_r(void)

获取WIFI scan结果，返回JSON。参见wpa_cli -iwlan0 scan_r

• char* RK_wifi_scan_r_sec(const unsigned int cols)

获取WIFI scan结果指定列，返回JSON。参见RK_wifi_scan_r(void)

bssid / frequency / signal level / flags / ssid

使用5位二进制从左到右依次代表上述数据，例如RK_wifi_scan_r_sec(0x01)获取bssid数据，RK_wifi_scan_r_sec(0x10）获取ssid数据，RK_wifi_scan_r_sec(0x1F)获取所有数据

• int RK_wifi_connect(const char* ssid, const char* psk)

以默认WPA加密方式连接指定热点

• int RK_wifi_connect1(const char* ssid, const char* psk, const RK_WIFI_CONNECTION_Encryp_e encryp, const int hide)

参见RK_wifi_connect接口，拓展加密类型，ssid隐藏性参数

• int RK_wifi_disconnect_network(void)

断开WIFI连接

• int RK_wifi_set_hostname(const char* name)

设置hostname

• int RK_wifi_get_hostname(char* name, int len)

获取hostname

• int RK_wifi_get_mac(char *wifi_mac)

获取mac地址

• int RK_wifi_has_config(void)

网络是否配置过

• int RK_wifi_ping(void)

以ping的方式判断网络是否连接

3、使用示例

#include <stdio.h>
#include <string.h>
#include <DeviceIo/Rk_wifi.h>

int _RK_wifi_state_callback(RK_WIFI_RUNNING_State_e state)
{
	printf("_RK_wifi_state_callback state:%d\n", state);
	return 0;
}

int main(int argc, char **argv)
{
	// 注册WIFI状态回调
	RK_wifi_register_callback(_RK_wifi_state_callback);

	// 设置hostname后获取打印
	char hostname[16];
	RK_wifi_set_hostname("RKWIFI");
	memset(hostname, 0, sizeof(hostname));
	RK_wifi_get_hostname(hostname, sizeof(hostname));
	printf("hostname:%s\n", hostname);

	// 获取MAC地址并打印
	char mac[32];
	memset(mac, 0, sizeof(mac));
	RK_wifi_get_mac(mac);
	printf("mac:%s\n", mac);

	// 如果有配置过WIFI，enable wifi自动连接到配置的WIFI
	// 否则连接到指定WIFI
	if (RK_wifi_has_config()) {
		RK_wifi_enable(1);
	} else {
		RK_wifi_enable(1);
		RK_wifi_connect("TP-LINK_C734BC", "12345678");
	}

	for (;;);
	// 断开WIFI并关闭WIFI模块
	RK_wifi_enable(0);

	return 0;
}