WiFi 장치를 제어하기 위한 클래스 More...

#include <WiFi.hpp>

Classes
struct	event_sta_scan_done_t
struct	event_sta_connected_t
struct	event_sta_disconnected_t
struct	event_sta_authmode_change_t
struct	event_sta_got_ip_t
struct	event_sta_wps_er_pin_t
struct	event_ap_staconnected_t
struct	event_ap_stadisconnected_t
struct	event_ap_probe_req_rx_t

Public Types
enum	mode_t { MODE_NULL = 0b000000 , MODE_STA = 0b000001 , MODE_AP = 0b000010 , MODE_APSTA = 0b000011 , MODE_MAX = 0b000100 }
enum	status_t { STATUS_STOP = 255 , STATUS_IDLE = 0 , STATUS_NO_SSID_AVAIL = 1 , STATUS_SCAN_COMPLETED = 2 , STATUS_CONNECTED = 3 , STATUS_CONNECT_FAILED = 4 , STATUS_CONNECTION_LOST = 5 , STATUS_DISCONNECTED = 6 }
enum	event_id_t { EVENT_READY = 0 , EVENT_SCAN_DONE , EVENT_STA_START , EVENT_STA_STOP , EVENT_STA_CONNECTED , EVENT_STA_DISCONNECTED , EVENT_STA_AUTHMODE_CHANGE , EVENT_STA_GOT_IP , EVENT_STA_LOST_IP , EVENT_STA_WPS_ER_SUCCESS , EVENT_STA_WPS_ER_FAILED , EVENT_STA_WPS_ER_TIMEOUT , EVENT_STA_WPS_ER_PIN , EVENT_AP_START , EVENT_AP_STOP , EVENT_AP_STACONNECTED , EVENT_AP_STADISCONNECTED , EVENT_AP_PROBEREQRECVED , EVENT_MAX }
enum	auth_mode_t { AUTH_OPEN = 0 , AUTH_WEP , AUTH_WPA_PSK , AUTH_WPA2_PSK , AUTH_WPA_WPA2_PSK , AUTH_WPA2_ENTERPRISE , AUTH_MAX }
enum	err_reason_t { REASON_UNSPECIFIED = 1 , REASON_AUTH_EXPIRE = 2 , REASON_AUTH_LEAVE = 3 , REASON_ASSOC_EXPIRE = 4 , REASON_ASSOC_TOOMANY = 5 , REASON_NOT_AUTHED = 6 , REASON_NOT_ASSOCED = 7 , REASON_ASSOC_LEAVE = 8 , REASON_ASSOC_NOT_AUTHED = 9 , REASON_DISASSOC_PWRCAP_BAD = 10 , REASON_DISASSOC_SUPCHAN_BAD = 11 , REASON_IE_INVALID = 13 , REASON_MIC_FAILURE = 14 , REASON_4WAY_HANDSHAKE_TIMEOUT = 15 , REASON_GROUP_KEY_UPDATE_TIMEOUT = 16 , REASON_IE_IN_4WAY_DIFFERS = 17 , REASON_GROUP_CIPHER_INVALID = 18 , REASON_PAIRWISE_CIPHER_INVALID = 19 , REASON_AKMP_INVALID = 20 , REASON_UNSUPP_RSN_IE_VERSION = 21 , REASON_INVALID_RSN_IE_CAP = 22 , REASON_802_1X_AUTH_FAILED = 23 , REASON_CIPHER_SUITE_REJECTED = 24 , REASON_BEACON_TIMEOUT = 200 , REASON_NO_AP_FOUND = 201 , REASON_AUTH_FAIL = 202 , REASON_ASSOC_FAIL = 203 , REASON_HANDSHAKE_TIMEOUT = 204 }
enum	event_sta_wps_fail_reason_t { WPS_FAIL_REASON_NORMAL = 0 , WPS_FAIL_REASON_RECV_M2D , WPS_FAIL_REASON_MAX }
typedef void(*	EventCb) (event_id_t event)
typedef void(*	EventFullCb) (event_id_t event, void *info)

Public Member Functions
virtual void	onEvent (EventCb cbEvent, event_id_t event=EVENT_MAX)
virtual void	onEvent (EventFullCb cbEvent, event_id_t event=EVENT_MAX)
virtual int32_t	channel (void)=0
virtual void	persistent (bool persistent)
virtual bool	mode (mode_t)=0
virtual mode_t	getMode ()=0
virtual bool	enableSTA (bool enable)
virtual bool	enableAP (bool enable)
virtual void	_eventCallback (event_id_t event, void *info)
virtual int	hostByName (const char *aHostname, IPAddress &aResult)=0
virtual status_t	begin (const char ssid, const char passphrase=NULL, int32_t channel=0, const uint8_t *bssid=NULL, bool connect=true)=0
virtual status_t	begin ()=0
virtual bool	config (IPAddress local_ip, IPAddress gateway, IPAddress subnet, IPAddress dns1=(uint32_t) 0x00000000, IPAddress dns2=(uint32_t) 0x00000000)=0
virtual bool	reconnect ()=0
virtual bool	disconnect (bool wifioff=false)=0
virtual bool	isConnected ()
virtual bool	setAutoConnect (bool autoConnect)=0
virtual bool	getAutoConnect ()=0
bool	setAutoReconnect (bool autoReconnect)
bool	getAutoReconnect ()
virtual uint8_t	waitForConnectResult ()
virtual IPAddress	localIP ()=0
virtual uint8_t *	macAddress (uint8_t *mac)=0
virtual IPAddress	subnetMask ()=0
virtual IPAddress	gatewayIP ()=0
virtual IPAddress	dnsIP (uint8_t dns_no=0)=0
virtual bool	enableIpV6 ()=0
virtual IPv6Address	localIPv6 ()=0
virtual const char *	getHostname ()=0
virtual bool	setHostname (const char *hostname)=0
status_t	status ()
virtual const char *	SSID () const =0
virtual const char *	psk () const =0
virtual const uint8_t *	BSSID ()=0
virtual int16_t	RSSI ()=0
void	_setStatus (status_t status)
virtual int8_t	scanNetworks (bool async=false, bool show_hidden=false, bool passive=false, uint32_t max_ms_per_chan=300)=0
virtual int8_t	scanComplete ()
virtual void	scanDelete ()=0
virtual bool	getNetworkInfo (uint8_t i, const char *ssid, auth_mode_t encryptionType, int16_t RSSI, const uint8_t BSSID, int32_t channel)=0
const char *	SSID (uint8_t i)
auth_mode_t	encryptionType (uint8_t i)
int16_t	RSSI (uint8_t i)
const uint8_t *	BSSID (uint8_t i)
int32_t	channel (uint8_t i)

Protected Member Functions
virtual void *	_getScanInfoByIndex (uint8_t i)=0
virtual void	_scanDone ()=0

Protected Attributes
bool	_persistent
mode_t	_forceSleepLastMode
status_t	_status = STATUS_STOP
bool	_autoReconnect = true
bool	_useStaticIp = false
bool	_scanAsync = false
bool	_scanStarted = false
bool	_scanComplete = false
uint16_t	_scanCount = 0
void *	_scanResult = NULL
bool	_dns_busy = false

Detailed Description

WiFi 장치를 제어하기 위한 클래스

Member Enumeration Documentation

◆ auth_mode_t

enum WiFiClass::auth_mode_t

Enumerator
AUTH_OPEN	authenticate mode : open
AUTH_WEP	authenticate mode : WEP
AUTH_WPA_PSK	authenticate mode : WPA_PSK
AUTH_WPA2_PSK	authenticate mode : WPA2_PSK
AUTH_WPA_WPA2_PSK	authenticate mode : WPA_WPA2_PSK
AUTH_WPA2_ENTERPRISE	authenticate mode : WPA2_ENTERPRISE

               {
    AUTH_OPEN = 0,         
    AUTH_WEP,              
    AUTH_WPA_PSK,          
    AUTH_WPA2_PSK,         
    AUTH_WPA_WPA2_PSK,     
    AUTH_WPA2_ENTERPRISE,  
    AUTH_MAX
  } auth_mode_t;

◆ err_reason_t

enum WiFiClass::err_reason_t

               {
    REASON_UNSPECIFIED              = 1,
    REASON_AUTH_EXPIRE              = 2,
    REASON_AUTH_LEAVE               = 3,
    REASON_ASSOC_EXPIRE             = 4,
    REASON_ASSOC_TOOMANY            = 5,
    REASON_NOT_AUTHED               = 6,
    REASON_NOT_ASSOCED              = 7,
    REASON_ASSOC_LEAVE              = 8,
    REASON_ASSOC_NOT_AUTHED         = 9,
    REASON_DISASSOC_PWRCAP_BAD      = 10,
    REASON_DISASSOC_SUPCHAN_BAD     = 11,
    REASON_IE_INVALID               = 13,
    REASON_MIC_FAILURE              = 14,
    REASON_4WAY_HANDSHAKE_TIMEOUT   = 15,
    REASON_GROUP_KEY_UPDATE_TIMEOUT = 16,
    REASON_IE_IN_4WAY_DIFFERS       = 17,
    REASON_GROUP_CIPHER_INVALID     = 18,
    REASON_PAIRWISE_CIPHER_INVALID  = 19,
    REASON_AKMP_INVALID             = 20,
    REASON_UNSUPP_RSN_IE_VERSION    = 21,
    REASON_INVALID_RSN_IE_CAP       = 22,
    REASON_802_1X_AUTH_FAILED       = 23,
    REASON_CIPHER_SUITE_REJECTED    = 24,
 
    REASON_BEACON_TIMEOUT           = 200,
    REASON_NO_AP_FOUND              = 201,
    REASON_AUTH_FAIL                = 202,
    REASON_ASSOC_FAIL               = 203,
    REASON_HANDSHAKE_TIMEOUT        = 204,
  } err_reason_t;

◆ event_id_t

enum WiFiClass::event_id_t

Enumerator
EVENT_READY	WiFi ready
EVENT_SCAN_DONE	WiFi finish scanning AP
EVENT_STA_START	WiFi station start
EVENT_STA_STOP	WiFi station stop
EVENT_STA_CONNECTED	WiFi station connected to AP
EVENT_STA_DISCONNECTED	WiFi station disconnected from AP
EVENT_STA_AUTHMODE_CHANGE	the auth mode of AP connected by WiFi station changed
EVENT_STA_GOT_IP	WiFi station got IP from connected AP
EVENT_STA_LOST_IP	WiFi station lost IP and the IP is reset to 0
EVENT_STA_WPS_ER_SUCCESS	WiFi station wps succeeds in enrollee mode
EVENT_STA_WPS_ER_FAILED	WiFi station wps fails in enrollee mode
EVENT_STA_WPS_ER_TIMEOUT	WiFi station wps timeout in enrollee mode
EVENT_STA_WPS_ER_PIN	WiFi station wps pin code in enrollee mode
EVENT_AP_START	WiFi soft-AP start
EVENT_AP_STOP	WiFi soft-AP stop
EVENT_AP_STACONNECTED	a station connected to WiFi soft-AP
EVENT_AP_STADISCONNECTED	a station disconnected from WiFi soft-AP
EVENT_AP_PROBEREQRECVED	Receive probe request packet in soft-AP interface

               {
    EVENT_READY = 0,                
    EVENT_SCAN_DONE,                
    EVENT_STA_START,                
    EVENT_STA_STOP,                 
    EVENT_STA_CONNECTED,            
    EVENT_STA_DISCONNECTED,         
    EVENT_STA_AUTHMODE_CHANGE,      
    EVENT_STA_GOT_IP,               
    EVENT_STA_LOST_IP,              
    EVENT_STA_WPS_ER_SUCCESS,       
    EVENT_STA_WPS_ER_FAILED,        
    EVENT_STA_WPS_ER_TIMEOUT,       
    EVENT_STA_WPS_ER_PIN,           
    EVENT_AP_START,                 
    EVENT_AP_STOP,                  
    EVENT_AP_STACONNECTED,          
    EVENT_AP_STADISCONNECTED,       
    EVENT_AP_PROBEREQRECVED,        
    //EVENT_GOT_IP6,                  /**< WiFi station or AP IPv6 addr is preferred */
    EVENT_MAX,
  } event_id_t;

◆ event_sta_wps_fail_reason_t

enum WiFiClass::event_sta_wps_fail_reason_t

Enumerator
WPS_FAIL_REASON_NORMAL	WPS normal fail reason
WPS_FAIL_REASON_RECV_M2D	WPS receive M2D frame

               {
    WPS_FAIL_REASON_NORMAL = 0,        
    WPS_FAIL_REASON_RECV_M2D,          
    WPS_FAIL_REASON_MAX
  } event_sta_wps_fail_reason_t;

◆ mode_t

enum WiFiClass::mode_t

Enumerator
MODE_NULL	null mode
MODE_STA	WiFi station mode
MODE_AP	WiFi soft-AP mode
MODE_APSTA	WiFi station + soft-AP mode

               {
    MODE_NULL  = 0b000000,  
    MODE_STA   = 0b000001,  
    MODE_AP    = 0b000010,  
    MODE_APSTA = 0b000011,  
    MODE_MAX   = 0b000100,
  } mode_t;

◆ status_t

enum WiFiClass::status_t

               {
    STATUS_STOP             = 255,
    STATUS_IDLE             = 0,
    STATUS_NO_SSID_AVAIL    = 1,
    STATUS_SCAN_COMPLETED   = 2,
    STATUS_CONNECTED        = 3,
    STATUS_CONNECT_FAILED   = 4,
    STATUS_CONNECTION_LOST  = 5,
    STATUS_DISCONNECTED     = 6
  } status_t;

Member Function Documentation

◆ _eventCallback()

virtual void WiFiClass::_eventCallback	(	event_id_t	event,
		void *	info )

virtual

callback for WiFi events

Parameters

arg

◆ begin() [1/2]

virtual status_t WiFiClass::begin ( )

pure virtual

Start Wifi connection if passphrase is set the most secure supported mode will be automatically selected

Parameters

ssid	const char* Pointer to the SSID string.
passphrase	const char * Optional. Passphrase. Valid characters in a passphrase must be between ASCII 32-126 (decimal).
bssid	uint8_t[6] Optional. BSSID / MAC of AP
channel	Optional. Channel of AP
connect	Optional. call connect

Returns

◆ begin() [2/2]

virtual status_t WiFiClass::begin	(	const char *	ssid,
		const char *	passphrase = NULL,
		int32_t	channel = 0,
		const uint8_t *	bssid = NULL,
		bool	connect = true )

pure virtual

Start Wifi connection if passphrase is set the most secure supported mode will be automatically selected

Parameters

ssid	const char* Pointer to the SSID string.
passphrase	const char * Optional. Passphrase. Valid characters in a passphrase must be between ASCII 32-126 (decimal).
bssid	uint8_t[6] Optional. BSSID / MAC of AP
channel	Optional. Channel of AP
connect	Optional. call connect

Returns

◆ BSSID() [1/2]

virtual const uint8_t * WiFiClass::BSSID ( )

pure virtual

Return the current bssid / mac associated with the network if configured

Returns: bssid uint8_t *

◆ BSSID() [2/2]

const uint8_t * WiFiClass::BSSID ( uint8_t i )

return MAC / BSSID of scanned wifi

Parameters

i	specify from which network item index want to get the information

Returns: uint8_t * MAC / BSSID of scanned wifi. If i is out of bound, NULL is returned.

◆ channel() [1/2]

int32_t WiFiClass::channel ( uint8_t i )

Return the primary channel number of the networks discovered during the scanNetworks

Parameters

i	specify from which network item want to get the information

Returns: Channel number of the specified item on the networks scanned list. If i is out of bound, -1 is returned.

◆ channel() [2/2]

virtual int32_t WiFiClass::channel ( void )

pure virtual

Return the current channel associated with the network

Returns: channel (1-13)

◆ config()

virtual bool WiFiClass::config	(	IPAddress	local_ip,
		IPAddress	gateway,
		IPAddress	subnet,
		IPAddress	dns1 = (uint32_t) 0x00000000,
		IPAddress	dns2 = (uint32_t) 0x00000000 )

pure virtual

Change IP configuration settings disabling the dhcp client

Parameters

local_ip	Static ip configuration
gateway	Static gateway configuration
subnet	Static Subnet mask
dns1	Static DNS server 1
dns2	Static DNS server 2

◆ disconnect()

virtual bool WiFiClass::disconnect ( bool wifioff = false )

pure virtual

Disconnect from the network

Parameters

wifioff

Returns: one value of wl_status_t enum

◆ dnsIP()

virtual IPAddress WiFiClass::dnsIP ( uint8_t dns_no = 0 )

pure virtual

Get the DNS ip address.

Parameters

dns_no

Returns: IPAddress DNS Server IP

◆ enableAP()

virtual bool WiFiClass::enableAP ( bool enable )

virtual

control AP mode

Parameters

enable bool

Returns: ok

◆ enableIpV6()

virtual bool WiFiClass::enableIpV6 ( )

pure virtual

Enable IPv6 on the station interface.

Returns: true on success

◆ enableSTA()

virtual bool WiFiClass::enableSTA ( bool enable )

virtual

control STA mode

Parameters

enable bool

Returns: ok

◆ encryptionType()

auth_mode_t WiFiClass::encryptionType ( uint8_t i )

Return the encryption type of the networks discovered during the scanNetworks

Parameters

i	specify from which network item index want to get the information

Returns: encryption type (enum wl_enc_type) of the specified item on the networks scanned list. If i is out of bound, AUTH_MAX is returned.

◆ gatewayIP()

virtual IPAddress WiFiClass::gatewayIP ( )

pure virtual

Get the gateway ip address.

Returns: IPAddress gatewayIP

◆ getAutoConnect()

virtual bool WiFiClass::getAutoConnect ( )

pure virtual

Checks if the WiFi station mode will connect to AP automatically or not when it is powered on.

Returns: auto connect

◆ getHostname()

virtual const char * WiFiClass::getHostname ( )

pure virtual

Get the station interface Host name.

Returns: char array hostname

◆ getMode()

virtual mode_t WiFiClass::getMode ( )

pure virtual

get WiFi mode

Returns: WiFiMode

◆ getNetworkInfo()

virtual bool WiFiClass::getNetworkInfo	(	uint8_t	i,
		const char **	ssid,
		auth_mode_t *	encryptionType,
		int16_t *	RSSI,
		const uint8_t **	BSSID,
		int32_t *	channel )

pure virtual

loads all infos from a scanned wifi in to the ptr parameters

Parameters

i	uint8_t
ssid	const char**
encryptionType	uint8_t *
RSSI	int32_t *
BSSID	uint8_t **
channel	int32_t *

Returns: (true if ok)

◆ hostByName()

virtual int WiFiClass::hostByName	(	const char *	aHostname,
		IPAddress &	aResult )

pure virtual

Resolve the given hostname to an IP address.

Parameters

aHostname	Name to be resolved
aResult	IPAddress structure to store the returned IP address

Returns: 1 if aIPAddrString was successfully converted to an IP address, else error code

◆ isConnected()

virtual bool WiFiClass::isConnected ( )

virtual

is STA interface connected?

Returns: true if STA is connected to an AD

◆ localIP()

virtual IPAddress WiFiClass::localIP ( )

pure virtual

Get the station interface IP address.

Returns: IPAddress station IP

◆ localIPv6()

virtual IPv6Address WiFiClass::localIPv6 ( )

pure virtual

Get the station interface IPv6 address.

Returns: IPv6Address

◆ macAddress()

virtual uint8_t * WiFiClass::macAddress ( uint8_t * mac )

pure virtual

Get the station interface MAC address.

Parameters

mac	pointer to uint8_t array with length WL_MAC_ADDR_LENGTH

Returns: pointer to uint8_t *

◆ mode()

virtual bool WiFiClass::mode ( mode_t )

pure virtual

set new mode

Parameters

m	WiFiMode_t

◆ onEvent() [1/2]

virtual void WiFiClass::onEvent	(	EventCb	cbEvent,
		event_id_t	event = EVENT_MAX )

virtual

set callback function

Parameters

cbEvent	WiFiEventCb
event	optional filter (WIFI_EVENT_MAX is all events)

◆ onEvent() [2/2]

virtual void WiFiClass::onEvent	(	EventFullCb	cbEvent,
		event_id_t	event = EVENT_MAX )

virtual

set callback function

Parameters

cbEvent	WiFiEventCb
event	optional filter (WIFI_EVENT_MAX is all events)

◆ persistent()

virtual void WiFiClass::persistent ( bool persistent )

virtual

store WiFi config in SDK flash area

Parameters

persistent

◆ psk()

virtual const char * WiFiClass::psk ( ) const

pure virtual

Return the current pre shared key associated with the network

Returns: psk string

◆ reconnect()

virtual bool WiFiClass::reconnect ( )

pure virtual

will force a disconnect an then start reconnecting to AP

Returns: ok

◆ RSSI() [1/2]

virtual int16_t WiFiClass::RSSI ( )

pure virtual

Return the current network RSSI.

Returns: RSSI value

◆ RSSI() [2/2]

int16_t WiFiClass::RSSI ( uint8_t i )

Return the RSSI of the networks discovered during the scanNetworks

Parameters

i	specify from which network item index want to get the information

Returns: signed value of RSSI of the specified item on the networks scanned list. If i is out of bound, SHRT_MIN value is returned.

◆ scanComplete()

virtual int8_t WiFiClass::scanComplete ( )

virtual

called to get the scan state in Async mode

Returns: scan result or status -1 if scan not fin -2 if scan not triggered

◆ scanDelete()

virtual void WiFiClass::scanDelete ( )

pure virtual

delete last scan result from RAM

◆ scanNetworks()

virtual int8_t WiFiClass::scanNetworks	(	bool	async = false,
		bool	show_hidden = false,
		bool	passive = false,
		uint32_t	max_ms_per_chan = 300 )

pure virtual

Start scan WiFi networks available

Parameters

async	run in async mode
show_hidden	show hidden networks

Returns: Number of discovered networks. If failed, WIFI_SCAN_RUNNING or WIFI_SCAN_FAILED will be returned.

◆ setAutoConnect()

virtual bool WiFiClass::setAutoConnect ( bool autoConnect )

pure virtual

Setting the WiFi station to connect to the AP (which is recorded) automatically or not when powered on. Enable auto-connect by default.

Parameters

autoConnect bool

Returns: if saved

◆ setHostname()

virtual bool WiFiClass::setHostname ( const char * hostname )

pure virtual

Set the station interface Host name.

Parameters

hostname pointer to const string

Returns: true on success

◆ SSID() [1/2]

virtual const char * WiFiClass::SSID ( ) const

pure virtual

Return the current SSID associated with the network

Returns: SSID

◆ SSID() [2/2]

const char * WiFiClass::SSID ( uint8_t i )

Return the SSID discovered during the network scan.

Parameters

i	specify from which network item want to get the information

Returns: ssid string of the specified item on the networks scanned list. If i is out of bound, NULL is returned.

◆ status()

status_t WiFiClass::status ( )

Return Connection status.

Returns: one of the value defined in wl_status_t

◆ subnetMask()

virtual IPAddress WiFiClass::subnetMask ( )

pure virtual

Get the interface subnet mask address.

Returns: IPAddress subnetMask

◆ waitForConnectResult()

virtual uint8_t WiFiClass::waitForConnectResult ( )

virtual

Wait for WiFi connection to reach a result returns the status reached or disconnect if STA is off

Returns: wl_status_t

The documentation for this class was generated from the following file:

include/WiFi.hpp

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

◆ auth_mode_t

◆ err_reason_t

◆ event_id_t

◆ event_sta_wps_fail_reason_t

◆ mode_t

◆ status_t

Member Function Documentation

◆ _eventCallback()

◆ begin() [1/2]

◆ begin() [2/2]

◆ BSSID() [1/2]

◆ BSSID() [2/2]

◆ channel() [1/2]

◆ channel() [2/2]

◆ config()

◆ disconnect()

◆ dnsIP()

◆ enableAP()

◆ enableIpV6()

◆ enableSTA()

◆ encryptionType()

◆ gatewayIP()

◆ getAutoConnect()

◆ getHostname()

◆ getMode()

◆ getNetworkInfo()

◆ hostByName()

◆ isConnected()

◆ localIP()

◆ localIPv6()

◆ macAddress()

◆ mode()

◆ onEvent() [1/2]

◆ onEvent() [2/2]

◆ persistent()

◆ psk()

◆ reconnect()

◆ RSSI() [1/2]

◆ RSSI() [2/2]

◆ scanComplete()

◆ scanDelete()

◆ scanNetworks()

◆ setAutoConnect()

◆ setHostname()

◆ SSID() [1/2]

◆ SSID() [2/2]

◆ status()

◆ subnetMask()

◆ waitForConnectResult()