说明
ping 网络上的远程设备。
用法
WiFi.ping(ip);
WiFi.begin(ip, ttl);
WiFi.begin(host);
WiFi.begin(host, ttl);
参数
ip:要 ping 的 IP 地址(4 个字节的数组)
主机:要 ping 的主机(字符串)
ttl:生存时间(可选,默认为 128)。请求可以转发到的最大路由器数。
返回
WL_PING_SUCCESS 当 ping 成功时 WL_PING_DEST_UNREACHABLE 当目标(IP 或主机不可达)时 WL_PING_TIMEOUT 当 ping 超时时 WL_PING_UNKNOWN_HOST 当主机无法通过 DNS 解析时 WL_PING_ERROR 当发生错误时
示例
/*
This example connects to a encrypted WiFi network (WPA/WPA2).
Then it prints the MAC address of the WiFi 101 Shield,
the IP address obtained, and other network details.
Then it continuously pings given host specified by IP Address or name.
Circuit:
WiFi 101 Shield attached / MKR1000
created 13 July 2010
by dlf (Metodo2 srl)
modified 09 June 2016
by Petar Georgiev
*/
#include <SPI.h>
#include <WiFi101.h>
#include "arduino_secrets.h"
///////please enter your sensitive data in the Secret tab/arduino_secrets.h
char ssid[] = SECRET_SSID; // your network SSID (name)
char pass[] = SECRET_PASS; // your network password (use for WPA, or use as key for WEP)
int status = WL_IDLE_STATUS; // the WiFi radio's status
// Specify IP address or hostname
String hostName = "www.google.com";
int pingResult;
void setup() {
// Initialize serial and wait for port to open:
Serial.begin(9600);
while (!Serial) {
; // wait for serial port to connect. Needed for native USB port only
}
// 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);
}
// attempt to connect to WiFi network:
while ( status != WL_CONNECTED) {
Serial.print("Attempting to connect to WPA SSID: ");
Serial.println(ssid);
// Connect to WPA/WPA2 network:
status = WiFi.begin(ssid, pass);
// wait 5 seconds for connection:
delay(5000);
}
// you're connected now, so print out the data:
Serial.println("You're connected to the network");
printCurrentNet();
printWiFiData();
}
void loop() {
Serial.print("Pinging ");
Serial.print(hostName);
Serial.print(": ");
pingResult = WiFi.ping(hostName);
if (pingResult >= 0) {
Serial.print("SUCCESS! RTT = ");
Serial.print(pingResult);
Serial.println(" ms");
} else {
Serial.print("FAILED! Error code: ");
Serial.println(pingResult);
}
delay(5000);
}
void printWiFiData() {
// print your WiFi 101 Shield's IP address:
IPAddress ip = WiFi.localIP();
Serial.print("IP address : ");
Serial.println(ip);
Serial.print("Subnet mask: ");
Serial.println((IPAddress)WiFi.subnetMask());
Serial.print("Gateway IP : ");
Serial.println((IPAddress)WiFi.gatewayIP());
// print your MAC address:
byte mac[6];
WiFi.macAddress(mac);
Serial.print("MAC address: ");
printMacAddress(mac);
}
void printCurrentNet() {
// print the SSID of the network you're attached to:
Serial.print("SSID: ");
Serial.println(WiFi.SSID());
// print the MAC address of the router you're attached to:
byte bssid[6];
WiFi.BSSID(bssid);
Serial.print("BSSID: ");
printMacAddress(bssid);
// print the received signal strength:
long rssi = WiFi.RSSI();
Serial.print("signal strength (RSSI): ");
Serial.println(rssi);
// print the encryption type:
byte encryption = WiFi.encryptionType();
Serial.print("Encryption Type: ");
Serial.println(encryption, HEX);
Serial.println();
}
void printMacAddress(byte mac[]) {
for (int i = 5; i >= 0; i--) {
if (mac[i] < 16) {
Serial.print("0");
}
Serial.print(mac[i], HEX);
if (i > 0) {
Serial.print(":");
}
}
Serial.println();
}
相关用法
- 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.beginAP()用法及代码示例
- Arduino WiFi101 - WiFi.RSSI()用法及代码示例
- Arduino WiFi101 - WiFi.beginProvision()用法及代码示例
- Arduino WiFi101 - WiFi.scanNetworks()用法及代码示例
- Arduino WiFi101 - WiFi.BSSID()用法及代码示例
- Arduino WiFi101 - WiFi.begin()用法及代码示例
- Arduino WiFi101 - WiFi.gatewayIP()用法及代码示例
- 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.ping()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。