wifi develop guide - XradioTech/XR871-OLD GitHub Wiki

目录

demo project

请参考sdk-code/project/wlan_demo

WLAN sys boot

在wlan_demo工程中，网络系统加载流程如下： wlan-sys-boot 网络系统加载过程中依次完成了以下几个重要的过程：

  1. 初始化系统消息队列，创建系统消息处理线程；
  2. 配置网络子系统硬件，加载网络子系统固件；
  3. 初始化DUCC服务，注册回调函数；
  4. 初始化TCP/IP协议栈；
  5. 创建netif网络接口并启动WLAN子系统任务；

Station Mode

  • Start the WLAN in station mode by default / 默认启动Station模式
    Note: in project/common/framework/platform_init.c The function call flow is as follows:
    platform_init()
    ----->platform_init_level1()
    ---------->net_sys_init() + net_sys_start(sysinfo->wlan_mode);
#include "net/wlan/wlan.h"  
#include "net/wlan/wlan_defs.h"  
#include "common/framework/net_ctrl.h"

net_sys_init();               // prepare the lwip
net_sys_start(WLAN_MODE_STA); // start the wlan system
  • Join an AP working in Open mode / 加入工作在开放模式的AP
// ssid of the AP: TEST_AP
// psk of the AP: no psk
uint8_t ssid[] = "TEST_AP";
uint8_t ssid_len = strlen((char *)ssid);

wlan_sta_set(ssid, ssid_len, NULL);
wlan_sta_enable();
  • Join an AP working in WPA/WPA2 mode / 加入工作在WPA/WPA2模式的AP
// ssid of the AP: TEST_AP
// psk of the AP: 12345678
uint8_t ssid[] = "TEST_AP";
uint8_t ssid_len = strlen((char *)ssid);
uint8_t psk[] = "12345678";

wlan_sta_set(ssid, ssid_len, psk);
wlan_sta_enable();
  • Join an AP working in WEP mode / 加入工作在WEP模式的AP
// ssid of the AP: TEST_AP
// the key0 of the AP: 1234567890
uint8_t ssid[] = "TEST_AP";
uint8_t ssid_len = strlen((char *)ssid);
uint8_t psk[] = "1234567890";

wlan_sta_config_t config = {0};

/* ssid */
config.field = WLAN_STA_FIELD_SSID;
memcpy(config.u.ssid.ssid, ssid, ssid_len);
config.u.ssid.ssid_len = ssid_len;
if (wlan_sta_set_config(&config) != 0)
    return -1;

/* WEP key0 */
config.field = WLAN_STA_FIELD_WEP_KEY0;
strlcpy((char *)config.u.wep_key, psk, sizeof(config.u.wep_key));
if (wlan_sta_set_config(&config) != 0)
    return -1;

/* WEP key index */
config.field = WLAN_STA_FIELD_WEP_KEY_INDEX;
config.u.wep_tx_keyidx = 0;
if (wlan_sta_set_config(&config) != 0)
    return -1;

/* auth_alg: SHARED */
config.field = WLAN_STA_FIELD_AUTH_ALG;
config.u.auth_alg = WPA_AUTH_ALG_SHARED;
if (wlan_sta_set_config(&config) != 0)
    return -1;

/* key_mgmt: NONE */
config.field = WLAN_STA_FIELD_KEY_MGMT;
config.u.key_mgmt = WPA_KEY_MGMT_NONE;
if (wlan_sta_set_config(&config) != 0)
    return -1;

if (wlan_sta_enable()!= 0)
    return -1;
  • Get current configuration / 获取当前的配置参数
    • set the configure field
    • get the configuration of this field
    • fields defined in wlan_def.h as follows:
    typedef enum wlan_sta_field {
  WLAN_STA_FIELD_SSID = 0,
  WLAN_STA_FIELD_PSK,
  WLAN_STA_FIELD_WEP_KEY0,
  WLAN_STA_FIELD_WEP_KEY1,
  WLAN_STA_FIELD_WEP_KEY2,
  WLAN_STA_FIELD_WEP_KEY3,
  WLAN_STA_FIELD_WEP_KEY_INDEX,
  WLAN_STA_FIELD_KEY_MGMT,
  WLAN_STA_FIELD_PAIRWISE_CIPHER,
  WLAN_STA_FIELD_GROUP_CIPHER,
  WLAN_STA_FIELD_PROTO,
  WLAN_STA_FIELD_AUTH_ALG,
  WLAN_STA_FIELD_WPA_PTK_REKEY,
  WLAN_STA_FIELD_SCAN_SSID,
  WLAN_STA_FIELD_NUM,
} wlan_sta_field_t;
    the code example:
wlan_sta_config_t config = {0};

config.field = WLAN_STA_FIELD_PSK;
if (wlan_sta_get_config(&config) != 0)
    return -1;

printf("psk: %s\n", config.u.psk);
  • Scan / 扫描
    • the information of AP in scan result
    typedef struct wlan_sta_ap {
  wlan_ssid_t	ssid;
  uint8_t		bssid[6];
  uint8_t		channel;
  uint16_t	beacon_int;
  int		freq;
  int		rssi;
  int		level;
  int		wpa_flags;
  int		wpa_cipher;
  int		wpa_key_mgmt;
  int		wpa2_cipher;
  int		wpa2_key_mgmt;
} wlan_sta_ap_t;
    • do scan once
wlan_sta_scan_once();

// do some delay here, 5s, 10s

wlan_sta_scan_results_t results;
results.size = 10;
results.ap = malloc(results.size * sizeof(wlan_sta_ap_t));
if (results.ap == NULL) {
    ……
}
if (wlan_sta_scan_result(&results) == 0) {
    ……
}
free(results.ap);
  • Connect/Disconnect AP / 连接或断开AP
wlan_sta_disconnect();
wlan_sta_connect();
  • Get the current state of connection
    • wlan_sta_states_t
    typedef enum wlan_sta_states {
  WLAN_STA_STATE_DISCONNECTED = 0,
  WLAN_STA_STATE_CONNECTED = 1,
} wlan_sta_states_t;
    the example code:
wlan_sta_states_t state;
wlan_sta_state(&state);
  • Get the connectted AP information / 获取已连接的AP的信息
wlan_sta_ap_t ap_info = {0};
wlan_sta_ap_info(&ap_info);

HostAP Mode

  • Start the WLAN in HostAP mode / 启动WLAN系统并工作在AP模式
#include "net/wlan/wlan.h"  
#include "net/wlan/wlan_defs.h"  
#include "common/framework/net_ctrl.h"

net_sys_init();                  // prepare the lwip
net_sys_start(WLAN_MODE_HOSTAP); // start the wlan system
  • Start AP in Open Mode / 开放模式
uint8_t ssid[] = "TEST_AP";
uint8_t ssid_len = strlen((char *)ssid);

wlan_ap_set(ssid, ssid_len, NULL);
wlan_ap_disable();
wlan_ap_enable();
  • Start AP in WPA/WPA2 Mode / 加密模式
uint8_t ssid[] = "TEST_AP";
uint8_t ssid_len = strlen((char *)ssid);
uint8_t psk[] = "12345678";

wlan_ap_set(ssid, ssid_len, psk);
wlan_ap_disable();
wlan_ap_enable();
  • Set/Get the work parameters / 设置/获取工作参数
    • Set the work channel
    • Get the work channel
wlan_ap_config_t config = {0};
config.field = WLAN_AP_FIELD_CHANNEL;
config.u.channel = 6;
wlan_ap_set_config(&config);

wlan_ap_config_t config = {0};
config.field = WLAN_AP_FIELD_CHANNEL;
wlan_ap_get_config(&config);
  • Get the number and information of connected stations
int num;
wlan_ap_sta_num(&num);

wlan_ap_stas_t stas;
stas.size = 5;			//最多获取5个已连接Station信息
stas.sta = malloc(stas.size * sizeof(wlan_ap_sta_t));
if (stas.sta == NULL) {
    ……
}

if (wlan_ap_sta_info(&stas) == 0) {
    ……				//处理获取的Station信息，实际获取Station个数为stas.num
}
free(stas.sta);

Monitor Mode

  • Register the data input callback for monitor mode / 注册数据接收回调
#include "smartlink/sc_assistant.h"

int sc_assistant_monitor_register_rx_cb(struct netif *nif, wlan_monitor_rx_cb cb);

the callback prototype as follows:

void monitor_data_callback(uint8_t *data, uint32_t len, void *info);
  • Register the channel switching callback for monitor mode / 注册信道切换回调
int sc_assistant_monitor_register_sw_ch_cb(struct netif *nif,
                                           sc_assistant_monitor_sw_ch_cb cb,
                                           unsigned int sw_ch_by_sca,
                                           unsigned int timerout);
  • Start monitor mode / 启动监听模式
#include "net/wlan/wlan.h"  
#include "net/wlan/wlan_defs.h"  
#include "common/framework/net_ctrl.h"

net_sys_init();                  // prepare the lwip
net_sys_start(WLAN_MODE_MONITOR); // start the wlan system

or calling net_mode_switch() when the wlan subsystem already works

net_switch_mode(WLAN_MODE_MONITOR);

Airkiss & SmartConfig

  • Airkiss demo please refer to project/example/airkiss
  • SmartConfig demo please refer to project/example/smartconfig

Listen for WLAN Events

please refer to the following demo

#include "common/framework/sys_ctrl/sys_ctrl.h"
#include "common/framework/net_ctrl.h"

void net_event_callback(uint32_t event, uint32_t data)
{
	uint16_t type = EVENT_SUBTYPE(event);

	printf("%s msg (%u, %u)\n", __func__, type, data);
	switch (type) {
	case NET_CTRL_MSG_WLAN_CONNECTED:
		printf("NET_CTRL_MSG_WLAN_CONNECTED\n");
		
		break;
	case NET_CTRL_MSG_WLAN_SCAN_SUCCESS:
		printf("NET_CTRL_MSG_WLAN_SCAN_SUCCESS\n");
		
		break;
	case NET_CTRL_MSG_WLAN_CONNECT_FAILED:
		printf("NET_CTRL_MSG_WLAN_CONNECT_FAILED\n");
	
		break;
	case NET_CTRL_MSG_NETWORK_UP:
		printf("NET_CTRL_MSG_NETWORK_UP\n");
	
		break;
	case NET_CTRL_MSG_NETWORK_DOWN:
		printf("NET_CTRL_MSG_NETWORK_DOWN\n");
	
		break;
	case NET_CTRL_MSG_WLAN_DISCONNECTED:
	case NET_CTRL_MSG_WLAN_SCAN_FAILED:
	case NET_CTRL_MSG_WLAN_4WAY_HANDSHAKE_FAILED:
		printf("do nothing msg (%u, %u)\n", type, data);
		break;
	default:
		printf("unknown msg (%u, %u)\n", type, data);
		break;
	}
}

int net_service_init(void)
{
	observer_base *observer;

	printf("foneric_net_service_init, register network observer\n");
	observer = sys_callback_observer_create(CTRL_MSG_TYPE_NETWORK,
						NET_CTRL_MSG_ALL,
						net_event_callback);
	if (observer == NULL)
		return -1;
	if (sys_ctrl_attach(observer) != 0)
		return -1;

	return 0;
}

Reference Documents