说明
在配置模式下初始化 WiFi101 库。此模式实现将板连接到已知 AP 或在无法到达任何已知 AP 时选择新 AP 所需的行为。
调用时,该函数将尝试连接到先前关联的接入点。如果失败,将创建一个名为“wifi101-XXXX” 的接入点,其中 XXXX 是主板 MAC 地址的最后 4 位数字。您需要连接到创建的接入点,然后访问 http://wifi101/并配置触手可及的 AP 的 SSID 和密码。新关联完成后,下一个连接将是到该 AP。
用法
WiFi.beginProvision();
WiFi.beginProvision(channel);
参数
channel:可选参数,指定用于配置模式的通道,默认使用通道1
返回
WL_CONNECTED 当连接到网络时 WL_PROVISIONING 当连接到先前关联的接入点失败时
示例
/*
WiFi Web Server
A simple web server that shows the value of the analog input pins.
using a WiFi 101 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 101 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 101 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 disconnected");
}
}
void printWiFiStatus() {
// print the SSID of the network you're attached to:
Serial.print("SSID: ");
Serial.println(WiFi.SSID());
// print your WiFi 101 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");
}
相关用法
- Arduino WiFi101 - WiFi.beginAP()用法及代码示例
- Arduino WiFi101 - WiFi.begin()用法及代码示例
- Arduino WiFi101 - WiFi.subnetMask()用法及代码示例
- Arduino WiFi101 - WiFi.status()用法及代码示例
- Arduino WiFi101 - WiFi.config()用法及代码示例
- Arduino WiFi101 - WiFi.localIP()用法及代码示例
- Arduino WiFi101 - WiFi.setDNS()用法及代码示例
- Arduino WiFi101 - WiFi.SSID()用法及代码示例
- Arduino WiFi101 - WiFi.macAddress()用法及代码示例
- Arduino WiFi101 - WiFi.RSSI()用法及代码示例
- Arduino WiFi101 - WiFi.scanNetworks()用法及代码示例
- Arduino WiFi101 - WiFi.BSSID()用法及代码示例
- Arduino WiFi101 - WiFi.gatewayIP()用法及代码示例
- Arduino WiFi101 - WiFi.ping()用法及代码示例
- Arduino WiFi101 - WiFi.encryptionType()用法及代码示例
- Arduino WiFi101 - WiFiSSLClient()用法及代码示例
- Arduino WiFi101 - WiFiClient用法及代码示例
- Arduino WiFi101 - WiFiServer()用法及代码示例
- Arduino WiFi101 - ConnectSSL()用法及代码示例
- Arduino WiFi101 - connect()用法及代码示例
- Arduino WiFi101 - connected()用法及代码示例
- Arduino WiFi101OTA - WiFiOTA.begin()用法及代码示例
- Arduino WiFi101OTA - WiFiOTA.poll()用法及代码示例
- Arduino WiFiNINA - WiFi.config()用法及代码示例
- Arduino WiFiNINA - server.status()用法及代码示例
注:本文由纯净天空筛选整理自arduino.cc大神的英文原创作品 WiFi101 - WiFi.beginProvision()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。