Arduino WiFiNINA库使用指南：WiFi连接与管理

概述

WiFiNINA库是专为Arduino兼容WiFi模块设计的网络连接库，提供了丰富的WiFi连接和管理功能。本文将详细介绍如何使用该库进行WiFi网络连接、配置和管理。

基础WiFi连接

连接到WiFi网络

WiFi.begin()方法是建立WiFi连接的基础函数，支持多种认证方式：

// 基本连接方式
WiFi.begin(ssid);               // 开放网络
WiFi.begin(ssid, pass);         // WPA/WPA2加密网络
WiFi.begin(ssid, keyIndex, key);// WEP加密网络

参数说明：

• ssid：要连接的WiFi网络名称
• pass：WPA/WPA2网络的密码
• keyIndex：WEP网络密钥索引(1-4)
• key：WEP网络密钥(十六进制字符串)

返回值：

• WL_CONNECTED：连接成功
• WL_IDLE_STATUS：模块已启动但未连接

使用示例：

#include <WiFiNINA.h>

char ssid[] = "yourNetwork";
char pass[] = "yourPassword";

void setup() {
  Serial.begin(9600);
  while (status != WL_CONNECTED) {
    status = WiFi.begin(ssid, pass);
    delay(5000); // 等待5秒再重试
  }
  Serial.println("Connected!");
}

断开WiFi连接

WiFi.disconnect()和WiFi.end()可用于断开当前连接：

WiFi.disconnect(); // 断开当前网络连接
WiFi.end();        // 完全关闭WiFi模块

高级网络配置

静态IP配置

使用WiFi.config()可以设置静态IP地址：

IPAddress ip(192, 168, 1, 177);     // 设备IP
IPAddress gateway(192, 168, 1, 1);   // 网关
IPAddress subnet(255, 255, 255, 0);  // 子网掩码
IPAddress dns(8, 8, 8, 8);           // DNS服务器

void setup() {
  WiFi.config(ip, dns, gateway, subnet);
  WiFi.begin(ssid, pass);
}

DNS服务器设置

单独设置DNS服务器：

WiFi.setDNS(dns_server1);           // 主DNS
WiFi.setDNS(dns_server1, dns_server2); // 主备DNS

主机名设置

为设备设置易识别的主机名：

WiFi.setHostname("MyArduinoDevice");

创建WiFi热点

WiFiNINA库支持将设备配置为AP模式：

WiFi.beginAP(ssid);                  // 开放热点
WiFi.beginAP(ssid, passphrase);      // 加密热点
WiFi.beginAP(ssid, passphrase, 6);   // 指定信道

AP模式示例：

char apSSID[] = "ArduinoAP";
char apPass[] = "arduino123";

void setup() {
  if (WiFi.beginAP(apSSID, apPass) != WL_AP_LISTENING) {
    Serial.println("AP创建失败");
    while(true);
  }
  Serial.print("AP IP: ");
  Serial.println(WiFi.localIP());
}

企业级网络连接

对于WPA2企业网络，需使用特殊连接方式：

WiFi.beginEnterprise(ssid, username, password); // 基本企业认证
WiFi.beginEnterprise(ssid, username, password, identity, caCert); // 完整认证

企业网络示例：

char entSSID[] = "EnterpriseNet";
char username[] = "yourUsername";
char password[] = "yourPassword";

void setup() {
  while (WiFi.beginEnterprise(entSSID, username, password) != WL_CONNECTED) {
    delay(10000); // 10秒重试间隔
  }
}

实用功能

获取网络信息

String ssid = WiFi.SSID();          // 当前连接SSID
int rssi = WiFi.RSSI();             // 信号强度
byte bssid[6]; 
WiFi.BSSID(bssid);                  // 获取BSSID
byte encryption = WiFi.encryptionType(); // 加密类型

超时设置

调整连接超时时间（默认为30秒）：

WiFi.setTimeout(120000); // 设置为2分钟

最佳实践

1. 错误处理：始终检查WiFi操作返回值
2. 固件更新：定期检查并更新模块固件
3. 节能考虑：不需要时使用WiFi.end()关闭模块
4. 网络扫描：先扫描可用网络再尝试连接
5. 异常处理：为关键操作添加重试机制

通过掌握这些功能，您可以充分利用WiFiNINA库为Arduino项目添加可靠的网络连接能力。无论是简单的家庭网络连接，还是复杂的企业级认证，WiFiNINA库都能提供完善的解决方案。