Komut
beginProvision()
Açıklama
WiFi101 kitaplıklarını hazırlık modunda başlatır. Bu mod, kartı bilinen AP'lere bağlamak veya bilinen hiçbir şeye ulaşılamıyorsa yenilerini seçmek için gereken davranışı uygular.
Çağrıldığında, işlev önceden ilişkilendirilmiş bir erişim noktasına bağlanmaya çalışır.
Bu başarısız olursa, "wifi101-XXXX" adlı bir erişim noktası oluşturulur; burada XXXX, pano MAC adresinin son 4 hanesidir. Oluşturulan erişim noktasına bağlanmanız ve ardından http: // wifi101 / adresini ziyaret etmeniz ve erişilebilecek bir AP'nin SSID'sini ve şifresini yapılandırmanız gerekir. Yeni ilişkilendirme tamamlandığında, bir sonraki bağlantı söz konusu AP ile olur.
Sözdizimi
WiFi .beginProvision ();
WiFi .beginProvision (kanal);
Parametreler
kanal : isteğe bağlı parametre, sağlama modu için kullanılacak kanalı belirtmek için kanal 1 varsayılan olarak kullanılır
İadeler
- Bir ağa bağlandığında WL_CONNECTED
- Önceden ilişkilendirilmiş erişim noktasına bağlanırken WL_PROVISIONING başarısız oluyor
Misal
/*
WiFi Web Server
A simple web server that shows the value of the analog input pins.
using a WiFi shield.
This example is written to configure the WiFi settings using provisioning mode.
It also sets up an mDNS server so the IP address of the board doesn't have to
be obtained via the serial monitor.
Circuit:
WiFi shield attached
Analog inputs attached to pins A0 through A5 (optional)
created 13 July 2010
by dlf (Metodo2 srl)
modified 31 May 2012
by Tom Igoe
*/
#include <SPI.h>
#include <WiFi101.h>
#include <WiFiMDNSResponder.h>
const int ledPin = 6; // LED pin for connectivity status indicator
char mdnsName[] = "wifi101"; // the MDNS name that the board will respond to
// after WiFi settings have been provisioned
// Note that the actual MDNS name will have '.local' after
// the name above, so "wifi101" will be accessible on
// the MDNS name "wifi101.local".
WiFiServer server(80);
// Create a MDNS responder to listen and respond to MDNS name requests.
WiFiMDNSResponder mdnsResponder;
void setup() {
//Initialize serial:
Serial.begin(9600);
// check for the presence of the shield:
if (WiFi.status() == WL_NO_SHIELD) {
Serial.println("WiFi shield not present");
// don't continue:
while (true);
}
// configure the LED pin for output mode
pinMode(ledPin, OUTPUT);
// Start in provisioning mode:
// 1) This will try to connect to a previously associated access point.
// 2) If this fails, an access point named "wifi101-XXXX" will be created, where XXXX
// is the last 4 digits of the boards MAC address. Once you are connected to the access point,
// you can configure an SSID and password by visiting http://wifi101/
WiFi.beginProvision();
while (WiFi.status() != WL_CONNECTED) {
// wait while not connected
// blink the led to show an unconnected status
digitalWrite(ledPin, HIGH);
delay(500);
digitalWrite(ledPin, LOW);
delay(500);
}
// connected, make the LED stay on
digitalWrite(ledPin, HIGH);
server.begin();
// Setup the MDNS responder to listen to the configured name.
// NOTE: You _must_ call this _after_ connecting to the WiFi network and
// being assigned an IP address.
if (!mdnsResponder.begin(mdnsName)) {
Serial.println("Failed to start MDNS responder!");
while(1);
}
Serial.print("Server listening at http://");
Serial.print(mdnsName);
Serial.println(".local/");
// you're connected now, so print out the status:
printWiFiStatus();
}
void loop() {
// Call the update() function on the MDNS responder every loop iteration to
// make sure it can detect and respond to name requests.
mdnsResponder.poll();
// listen for incoming clients
WiFiClient client = server.available();
if (client) {
Serial.println("new client");
// an http request ends with a blank line
bool currentLineIsBlank = true;
while (client.connected()) {
if (client.available()) {
char c = client.read();
Serial.write(c);
// if you've gotten to the end of the line (received a newline
// character) and the line is blank, the http request has ended,
// so you can send a reply
if (c == '\n' && currentLineIsBlank) {
// send a standard http response header
client.println("HTTP/1.1 200 OK");
client.println("Content-Type: text/html");
client.println("Connection: close"); // the connection will be closed after completion of the response
client.println("Refresh: 5"); // refresh the page automatically every 5 sec
client.println();
client.println("<!DOCTYPE HTML>");
client.println("<html>");
// output the value of each analog input pin
for (int analogChannel = 0; analogChannel < 6; analogChannel++) {
int sensorReading = analogRead(analogChannel);
client.print("analog input ");
client.print(analogChannel);
client.print(" is ");
client.print(sensorReading);
client.println("<br />");
}
client.println("</html>");
break;
}
if (c == '\n') {
// you're starting a new line
currentLineIsBlank = true;
}
else if (c != '\r') {
// you've gotten a character on the current line
currentLineIsBlank = false;
}
}
}
// give the web browser time to receive the data
delay(1);
// close the connection:
client.stop();
Serial.println("client disonnected");
}
}
void printWiFiStatus() {
// print the SSID of the network you're attached to:
Serial.print("SSID: ");
Serial.println(WiFi.SSID());
// print your WiFi shield's IP address:
IPAddress ip = WiFi.localIP();
Serial.print("IP Address: ");
Serial.println(ip);
// print the received signal strength:
long rssi = WiFi.RSSI();
Serial.print("signal strength (RSSI):");
Serial.print(rssi);
Serial.println(" dBm");
}
WiFi Web Server
A simple web server that shows the value of the analog input pins.
using a WiFi shield.
This example is written to configure the WiFi settings using provisioning mode.
It also sets up an mDNS server so the IP address of the board doesn't have to
be obtained via the serial monitor.
Circuit:
WiFi shield attached
Analog inputs attached to pins A0 through A5 (optional)
created 13 July 2010
by dlf (Metodo2 srl)
modified 31 May 2012
by Tom Igoe
*/
#include <SPI.h>
#include <WiFi101.h>
#include <WiFiMDNSResponder.h>
const int ledPin = 6; // LED pin for connectivity status indicator
char mdnsName[] = "wifi101"; // the MDNS name that the board will respond to
// after WiFi settings have been provisioned
// Note that the actual MDNS name will have '.local' after
// the name above, so "wifi101" will be accessible on
// the MDNS name "wifi101.local".
WiFiServer server(80);
// Create a MDNS responder to listen and respond to MDNS name requests.
WiFiMDNSResponder mdnsResponder;
void setup() {
//Initialize serial:
Serial.begin(9600);
// check for the presence of the shield:
if (WiFi.status() == WL_NO_SHIELD) {
Serial.println("WiFi shield not present");
// don't continue:
while (true);
}
// configure the LED pin for output mode
pinMode(ledPin, OUTPUT);
// Start in provisioning mode:
// 1) This will try to connect to a previously associated access point.
// 2) If this fails, an access point named "wifi101-XXXX" will be created, where XXXX
// is the last 4 digits of the boards MAC address. Once you are connected to the access point,
// you can configure an SSID and password by visiting http://wifi101/
WiFi.beginProvision();
while (WiFi.status() != WL_CONNECTED) {
// wait while not connected
// blink the led to show an unconnected status
digitalWrite(ledPin, HIGH);
delay(500);
digitalWrite(ledPin, LOW);
delay(500);
}
// connected, make the LED stay on
digitalWrite(ledPin, HIGH);
server.begin();
// Setup the MDNS responder to listen to the configured name.
// NOTE: You _must_ call this _after_ connecting to the WiFi network and
// being assigned an IP address.
if (!mdnsResponder.begin(mdnsName)) {
Serial.println("Failed to start MDNS responder!");
while(1);
}
Serial.print("Server listening at http://");
Serial.print(mdnsName);
Serial.println(".local/");
// you're connected now, so print out the status:
printWiFiStatus();
}
void loop() {
// Call the update() function on the MDNS responder every loop iteration to
// make sure it can detect and respond to name requests.
mdnsResponder.poll();
// listen for incoming clients
WiFiClient client = server.available();
if (client) {
Serial.println("new client");
// an http request ends with a blank line
bool currentLineIsBlank = true;
while (client.connected()) {
if (client.available()) {
char c = client.read();
Serial.write(c);
// if you've gotten to the end of the line (received a newline
// character) and the line is blank, the http request has ended,
// so you can send a reply
if (c == '\n' && currentLineIsBlank) {
// send a standard http response header
client.println("HTTP/1.1 200 OK");
client.println("Content-Type: text/html");
client.println("Connection: close"); // the connection will be closed after completion of the response
client.println("Refresh: 5"); // refresh the page automatically every 5 sec
client.println();
client.println("<!DOCTYPE HTML>");
client.println("<html>");
// output the value of each analog input pin
for (int analogChannel = 0; analogChannel < 6; analogChannel++) {
int sensorReading = analogRead(analogChannel);
client.print("analog input ");
client.print(analogChannel);
client.print(" is ");
client.print(sensorReading);
client.println("<br />");
}
client.println("</html>");
break;
}
if (c == '\n') {
// you're starting a new line
currentLineIsBlank = true;
}
else if (c != '\r') {
// you've gotten a character on the current line
currentLineIsBlank = false;
}
}
}
// give the web browser time to receive the data
delay(1);
// close the connection:
client.stop();
Serial.println("client disonnected");
}
}
void printWiFiStatus() {
// print the SSID of the network you're attached to:
Serial.print("SSID: ");
Serial.println(WiFi.SSID());
// print your WiFi shield's IP address:
IPAddress ip = WiFi.localIP();
Serial.print("IP Address: ");
Serial.println(ip);
// print the received signal strength:
long rssi = WiFi.RSSI();
Serial.print("signal strength (RSSI):");
Serial.print(rssi);
Serial.println(" dBm");
}