176 lines
5.8 KiB
C
176 lines
5.8 KiB
C
/*
|
|
* RT-Thread Wi-Fi Device
|
|
*
|
|
* COPYRIGHT (C) 2014 - 2015, Shanghai Real-Thread Technology Co., Ltd
|
|
*
|
|
* This file is part of RT-Thread (http://www.rt-thread.org)
|
|
*
|
|
* All rights reserved.
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Change Logs:
|
|
* Date Author Notes
|
|
* 2014-09-11 Bernard the first verion
|
|
*/
|
|
#ifndef WIFI_DEVICE_H__
|
|
#define WIFI_DEVICE_H__
|
|
|
|
#include <stdint.h>
|
|
#include <netif/ethernetif.h>
|
|
|
|
typedef enum
|
|
{
|
|
WIFI_STATION,
|
|
WIFI_AP,
|
|
} rt_wlan_mode_t;
|
|
|
|
typedef enum
|
|
{
|
|
WIFI_INIT = 0x10,
|
|
WIFI_SCAN, /* trigger scanning (list cells) */
|
|
WIFI_JOIN,
|
|
WIFI_EASYJOIN, /* join network with less information */
|
|
WIFI_SOFTAP, /* start soft-AP */
|
|
WIFI_DISCONNECT,
|
|
WIFI_GET_RSSI, /* get sensitivity (dBm) */
|
|
WIFI_ENTER_POWERSAVE,
|
|
} rt_wlan_cmd_t;
|
|
|
|
typedef enum
|
|
{
|
|
WIFI_PWR_OFF,
|
|
WIFI_PWR_SLEEP,
|
|
WIFI_PWR_NORMAL
|
|
} rt_wlan_powersave_t;
|
|
|
|
#define SHARED_ENABLED 0x00008000
|
|
#define WPA_SECURITY 0x00200000
|
|
#define WPA2_SECURITY 0x00400000
|
|
#define WPS_ENABLED 0x10000000
|
|
#define WEP_ENABLED 0x0001
|
|
#define TKIP_ENABLED 0x0002
|
|
#define AES_ENABLED 0x0004
|
|
#define WSEC_SWFLAG 0x0008
|
|
|
|
#define KEY_ARRAY_SIZE 32
|
|
|
|
/**
|
|
* Enumeration of Wi-Fi security modes
|
|
*/
|
|
typedef enum
|
|
{
|
|
SECURITY_OPEN = 0, /**< Open security */
|
|
SECURITY_WEP_PSK = WEP_ENABLED, /**< WEP Security with open authentication */
|
|
SECURITY_WEP_SHARED = ( WEP_ENABLED | SHARED_ENABLED ), /**< WEP Security with shared authentication */
|
|
SECURITY_WPA_TKIP_PSK = ( WPA_SECURITY | TKIP_ENABLED ), /**< WPA Security with TKIP */
|
|
SECURITY_WPA_AES_PSK = ( WPA_SECURITY | AES_ENABLED ), /**< WPA Security with AES */
|
|
SECURITY_WPA2_AES_PSK = ( WPA2_SECURITY | AES_ENABLED ), /**< WPA2 Security with AES */
|
|
SECURITY_WPA2_TKIP_PSK = ( WPA2_SECURITY | TKIP_ENABLED ), /**< WPA2 Security with TKIP */
|
|
SECURITY_WPA2_MIXED_PSK = ( WPA2_SECURITY | AES_ENABLED | TKIP_ENABLED ), /**< WPA2 Security with AES & TKIP */
|
|
SECURITY_WPS_OPEN = WPS_ENABLED, /**< WPS with open security */
|
|
SECURITY_WPS_SECURE = (WPS_ENABLED | AES_ENABLED), /**< WPS with AES security */
|
|
SECURITY_UNKNOWN = -1, /**< May be returned by scan function if security is unknown.
|
|
Do not pass this to the join function! */
|
|
} rt_wlan_security_t;
|
|
|
|
typedef enum
|
|
{
|
|
WIFI_EVT_LINK_DOWN,
|
|
WIFI_EVT_LINK_UP,
|
|
}rt_wlan_event_t;
|
|
|
|
/* wifi network information */
|
|
struct rt_wlan_info
|
|
{
|
|
rt_wlan_mode_t mode; /* wifi mode */
|
|
rt_wlan_security_t security;
|
|
|
|
char *ssid;
|
|
uint8_t bssid[6];
|
|
|
|
/* maximal data rate */
|
|
uint32_t datarate;
|
|
/* radio channel */
|
|
uint16_t channel;
|
|
/* signal strength */
|
|
int16_t rssi;
|
|
};
|
|
|
|
struct rt_wlan_info_request
|
|
{
|
|
uint16_t req_number; /* the number of information item for request */
|
|
uint16_t rsp_number; /* the number of information item for response */
|
|
|
|
struct rt_wlan_info *infos;/* the array of information to save response */
|
|
};
|
|
|
|
struct rt_wlan_device;
|
|
typedef void (*rt_wlan_event_handler)(struct rt_wlan_device* device, rt_wlan_event_t event, void* user_data);
|
|
|
|
struct rt_wlan_device
|
|
{
|
|
struct eth_device parent;
|
|
|
|
struct rt_wlan_info* info;
|
|
char key[KEY_ARRAY_SIZE + 1];
|
|
|
|
rt_wlan_event_handler handler;
|
|
void* user_data;
|
|
int interface;
|
|
};
|
|
|
|
/*
|
|
* Wi-Fi Information APIs
|
|
*/
|
|
void rt_wlan_info_init(struct rt_wlan_info* info, rt_wlan_mode_t mode, rt_wlan_security_t security,
|
|
char *ssid);
|
|
void rt_wlan_info_deinit(struct rt_wlan_info* info);
|
|
|
|
/*
|
|
* Wi-Fi Manager APIs
|
|
*/
|
|
int rt_wlan_init(struct rt_wlan_device* device, rt_wlan_mode_t mode);
|
|
|
|
int rt_wlan_connect(struct rt_wlan_device* device, struct rt_wlan_info* info,
|
|
char *password);
|
|
int rt_wlan_disconnect(struct rt_wlan_device* device);
|
|
|
|
int rt_wlan_softap(struct rt_wlan_device* device, struct rt_wlan_info* info,
|
|
char *password);
|
|
|
|
/* set wifi information for AP */
|
|
int rt_wlan_set_info(struct rt_wlan_device* device, struct rt_wlan_info* info);
|
|
/* get wifi information for AP */
|
|
struct rt_wlan_info *rt_wlan_get_info(struct rt_wlan_device* device);
|
|
|
|
/* get the AP result which were scaned in station */
|
|
int rt_wlan_scan(struct rt_wlan_device* device, struct rt_wlan_info *infos, int item_sz);
|
|
|
|
/* get rssi */
|
|
int rt_wlan_get_rssi(struct rt_wlan_device* device);
|
|
/* Get/Set MAC */
|
|
int rt_wlan_get_mac(struct rt_wlan_device* device,rt_uint8_t hwaddr[6]);
|
|
int rt_wlan_set_mac(struct rt_wlan_device* device,rt_uint8_t hwaddr[6]);
|
|
|
|
/* enter power save level */
|
|
int rt_wlan_enter_powersave(struct rt_wlan_device* device, int level);
|
|
|
|
void rt_wlan_set_event_callback(struct rt_wlan_device* device, rt_wlan_event_handler handler,
|
|
void *user_data);
|
|
|
|
#endif
|
|
|