Arduino Opta Wifi无法连接WiFi网络问题排查求助

代码中的明显问题 #

• connectWifi函数里存在参数误用：digitalWrite(LED_D1, OUTPUT);，OUTPUT是pinMode的配置参数，不能用于digitalWrite，此处应该改为HIGH来标记已连接状态。
• 缺少串口输出初始化，无法获取WiFi连接失败的具体错误码，这是定位问题的核心依据。
• 没有设置连接超时逻辑，无限循环闪烁LED既无法终止无效尝试，也无法反馈错误信息。

修改后的代码（带错误排查功能） #

//WiFi
const char SSID[] = "<insert ssid here>";
const char PASSWORD[] = "<insert password here>";
WiFiClient wifiClient;

int wifiWaiting = 0;

void setup() {
  pinMode(LED_D0, OUTPUT);
  pinMode(LED_D1, OUTPUT);
  pinMode(LED_D2, OUTPUT);
  pinMode(LED_D3, OUTPUT);
  digitalWrite(LED_D0, HIGH);
  
  Serial.begin(115200); // 初始化串口用于输出错误信息
  while (!Serial); // 等待USB串口连接
  
  connectWifi();
}

void loop() {
  delay(100);
}

void connectWifi() {
  if (WiFi.status() == WL_CONNECTED) {
    digitalWrite(LED_D1, HIGH); // 修正为HIGH，标记已连接
    Serial.println("已连接到WiFi");
    return;
  }

  Serial.print("正在连接WiFi: ");
  Serial.println(SSID);
  WiFi.begin(SSID, PASSWORD);
  
  int attempts = 0;
  const int MAX_ATTEMPTS = 20; // 最大尝试次数（对应10秒超时）
  
  while (WiFi.status() != WL_CONNECTED && attempts < MAX_ATTEMPTS) {
      wifiWaiting = 1 - wifiWaiting;
      digitalWrite(LED_D3, wifiWaiting);
      delay(500);
      attempts++;
      Serial.print("连接中... 当前状态码: ");
      Serial.println(WiFi.status());
  }
  
  if (WiFi.status() == WL_CONNECTED) {
    digitalWrite(LED_D1, HIGH);
    digitalWrite(LED_D3, LOW);
    Serial.println("WiFi连接成功！");
    Serial.print("IP地址: ");
    Serial.println(WiFi.localIP());
  } else {
    digitalWrite(LED_D3, HIGH); // 常亮表示连接失败
    Serial.print("连接失败，最终状态码: ");
    Serial.println(WiFi.status());
    Serial.println("常见状态码说明：");
    Serial.println("WL_CONNECT_FAILED = 4 （密码错误/网络拒绝）");
    Serial.println("WL_NO_SSID_AVAIL = 2 （无法找到指定SSID）");
    Serial.println("WL_DISCONNECTED = 6 （WiFi模块未初始化）");
  }
}

额外排查步骤 #

• 确认WiFi频段：Arduino Opta WiFi仅支持2.4GHz频段，双频路由器需连接带"2.4G"后缀的SSID，5G频段无法兼容。
• 解析串口状态码：上传代码后打开Arduino IDE串口监视器（波特率115200），根据状态码定位问题：
  • 状态码2：检查SSID拼写（注意大小写、特殊字符）
  • 状态码4：确认密码无特殊字符兼容性问题，或路由器是否临时限制接入
  • 状态码6：重启Opta或重新烧录WiFi库
• 重置WiFi模块：长按Opta上的RESET按钮5秒，重置模块后重试连接。
• 检查路由器设置：确认AP隔离、MAC地址过滤功能未限制Opta接入。

内容的提问来源于stack exchange，提问作者blank_yield