说明
- ping 网络上的远程设备。
用法
WiFi.ping(ip);
WiFi.ping(ip, ttl);
WiFi.ping(host);
WiFi.ping(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 an encrypted WiFi network (WPA/WPA2).
Then it prints the MAC address of the board,
the IP address obtained, and other network details.
Then it continuously pings given host specified by IP Address or name.
Circuit:
* Board with NINA module (Arduino MKR WiFi 1010, MKR VIDOR 4000 and UNO WiFi Rev.2)
created 13 July 2010
by dlf (Metodo2 srl)
modified 09 June 2016
by Petar Georgiev
*/
#include <SPI.h>
#include <WiFiNINA.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 WiFi module:
if (WiFi.status() == WL_NO_MODULE) {
Serial.println("Communication with WiFi module failed!");
// don't continue
while (true);
}
String fv = WiFi.firmwareVersion();
if (fv < WIFI_FIRMWARE_LATEST_VERSION) {
Serial.println("Please upgrade the firmware");
}
// 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 board'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 WiFiNINA - WiFi.config()用法及代码示例
- Arduino WiFiNINA - WiFi.encryptionType()用法及代码示例
- Arduino WiFiNINA - WiFi.gatewayIP()用法及代码示例
- Arduino WiFiNINA - WiFi.BSSID()用法及代码示例
- Arduino WiFiNINA - WiFi.begin()用法及代码示例
- Arduino WiFiNINA - WiFi.RSSI()用法及代码示例
- Arduino WiFiNINA - WiFi.channel()用法及代码示例
- Arduino WiFiNINA - WiFi.setTimeout()用法及代码示例
- Arduino WiFiNINA - WiFi.scanNetworks()用法及代码示例
- Arduino WiFiNINA - WiFi.localIP()用法及代码示例
- Arduino WiFiNINA - WiFi.beginAP()用法及代码示例
- Arduino WiFiNINA - WiFi.setHostname()用法及代码示例
- Arduino WiFiNINA - WiFi.hostByName()用法及代码示例
- Arduino WiFiNINA - WiFi.firmwareVersion()用法及代码示例
- Arduino WiFiNINA - WiFi.reasonCode()用法及代码示例
- Arduino WiFiNINA - WiFi.setDNS()用法及代码示例
- Arduino WiFiNINA - WiFi.status()用法及代码示例
- Arduino WiFiNINA - WiFi.SSID()用法及代码示例
- Arduino WiFiNINA - WiFi.macAddress()用法及代码示例
- Arduino WiFiNINA - WiFi.subnetMask()用法及代码示例
- Arduino WiFiNINA - WiFi.beginEnterprise()用法及代码示例
- Arduino WiFiNINA - WiFiSSLClient用法及代码示例
- Arduino WiFiNINA - WiFiClient()用法及代码示例
- Arduino WiFiNINA - WiFiServer()用法及代码示例
- Arduino WiFiNINA - WiFiUDP.beginMulticast()用法及代码示例
注:本文由纯净天空筛选整理自arduino.cc大神的英文原创作品 WiFiNINA - WiFi.ping()。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。