CircuitPython WiFi连接问题分析与解决方案

问题背景

在CircuitPython开发环境中，当使用wifi模块连接无线网络时，开发者可能会遇到一个常见问题：如果目标无线接入点(AP)不可用，程序会直接抛出ConnectionError异常并终止，而不会自动重试连接。这种情况在实际应用中会带来不便，因为无线网络环境本身就存在不稳定性。

问题现象

当运行以下典型连接代码时：

import wifi

SSID = "potato"
PASSWORD = "123123123"

print("connecting wifi...")
wifi.radio.connect(SSID,PASSWORD)

如果目标SSID("potato")对应的接入点不可用，程序会立即抛出"ConnectionError: No network with that ssid"错误并终止，不会进行任何重试尝试。

问题分析

1. 异常处理误区：开发者最初尝试使用RuntimeError捕获异常，但ConnectionError实际上是不同的异常类型，这导致异常处理机制失效。

2. 自动重试机制：实际上，wifi.radio.connect()方法内部已经实现了扫描和多次重试机制，但最终仍会抛出异常给上层应用。

3. 连接状态检测：开发者需要正确检测连接状态并实现自己的重试逻辑，以应对更复杂的网络环境。

解决方案

基础解决方案

最简单的修复方式是正确捕获ConnectionError异常：

import wifi
import time

SSID = "potato"
PASSWORD = "123123123"

def connect_to_wifi():
    print("Connecting to AP...")
    wifi.radio.connect(SSID, PASSWORD)

while not wifi.radio.connected:
    try:
        connect_to_wifi()
    except ConnectionError as e:
        print(f"Connection failed: {e}")
        print("Retrying in 5 seconds...")
        time.sleep(5)

增强版解决方案

对于更稳定的网络连接，可以结合网络扫描和连接状态检测：

import wifi
import time

SSID = "potato"
PASSWORD = "123123123"

def scan_for_wifi():
    networks = []
    for network in wifi.radio.start_scanning_networks():
        networks.append(network)
    wifi.radio.stop_scanning_networks()
    networks = sorted(networks, key=lambda net: net.rssi, reverse=False)
    for network in networks:
        if network.ssid == SSID:
            return True
    return False
        
def connect_to_wifi():
    print("connecting wifi...")
    wifi.radio.connect(SSID,PASSWORD)

while True:
    if wifi.radio.connected:
        gateway_address = wifi.radio.ipv4_gateway
        ping = wifi.radio.ping(ip=gateway_address)
        if ping is None:
            print(f"Couldn't ping gateway successfully")
        else:
            print(f"Pinging gateway took: {ping * 1000} ms")
        time.sleep(1)
    else:
        print(f"scanning for wifi...")
        if scan_for_wifi():
            try:
                connect_to_wifi()
            except ConnectionError:
                pass
        time.sleep(1)

技术要点

1. 异常处理：在CircuitPython中，需要明确捕获ConnectionError而非RuntimeError。

2. 网络扫描：主动扫描可以确认目标网络是否在范围内，避免盲目尝试连接。

3. 连接状态检测：持续监测连接状态，并在断开时自动重连。

4. 网络质量检测：通过ping测试验证网络连接质量。

最佳实践建议

1. 实现指数退避算法，逐渐增加重试间隔时间。

2. 添加最大重试次数限制，避免无限循环。

3. 考虑实现网络切换逻辑，当首选网络不可用时连接备用网络。

4. 对于关键应用，建议记录连接日志以便故障排查。

通过以上方法，开发者可以构建更健壮的WiFi连接机制，适应各种不稳定的网络环境。