Weblessons.org
Home Page | Language Reference| extended() | SD Reference | Libraries | Comparison | Changes
WiFi101
WiFi.status()
Description
Return the connection status.
Syntax
WiFi.status();
Parameters
none
Returns
- WL_CONNECTED: assigned when connected to a WiFi network;
- WL_NO_SHIELD: assigned when no WiFi shield is present;
- WL_IDLE_STATUS: it is a temporary status assigned when
WiFi.begin() is called and remains active until the number of attempts expires (resulting in WL_CONNECT_FAILED) or a connection is established (resulting in WL_CONNECTED);
- WL_NO_SSID_AVAIL: assigned when no SSID are available;
- WL_SCAN_COMPLETED: assigned when the scan networks is completed;
- WL_CONNECT_FAILED: assigned when the connection fails for all the attempts;
- WL_CONNECTION_LOST: assigned when the connection is lost;
- WL_DISCONNECTED: assigned when disconnected from a network;
Example
#include <SPI.h>
#include <WiFi101.h>
char ssid[
]
=
"yourNetwork"
; ⁄ your network SSID (name)
char key[
]
=
"D0D0DEADF00DABBADEAFBEADED"
; ⁄ ⁄ your network key
int keyIndex =
0
; ⁄ ⁄ your network key Index number
int status = WL_IDLE_STATUS; ⁄ ⁄ the Wifi radio's status
void
setup
(
)
{
⁄ ⁄ Initialize serial and wait for port to open:
Serial.begin
(
9600
)
;
while
(
!
Serial
)
{
;
⁄ ⁄ wait for serial port to connect. Needed for Leonardo only
}
⁄ ⁄ check for the presence of the shield:
if
(WiFi.status
(
)
== WL_NO_SHIELD)
{
Serial.println
(
"WiFi shield not present"
)
;
⁄ ⁄ don't continue:
while
(
true
)
;
}
⁄ ⁄ attempt to connect to Wifi network:
while
( status != WL_CONNECTED)
{
Serial.print
(
"Attempting to connect to WEP network, SSID: "
)
;
Serial.println
(ssid)
;
status = WiFi.begin
(ssid, keyIndex, key)
;
⁄ ⁄ wait 10 seconds for connection:
delay
(
10000
)
;
}
⁄ ⁄ once you are connected :
Serial.print
(
"You're connected to the network"
)
;
}
void
loop
(
)
{
⁄ ⁄ check the network status connection once every 10 seconds:
delay
(
10000
)
;
Serial.println
(WiFi.status
(
)
;
}
Reference Home
The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.