跳到主要内容

如何更改设备上的 Wi-Fi 凭证?

将设备复位到配网模式,然后通过手机应用重新配网。可以使用以下任一方法:

  1. 物理按键(BOOT 键) – 如果使用的是标准 RainMaker 示例,按住 BOOT 键超过 3 秒后松开。设备进入配网模式(Wi-Fi 凭证会被清除;RainMaker 关联会保留)。

  2. 系统服务(手机应用) – 如果固件已启用系统服务并包含 Wi-Fi-Reset 参数,在 ESP RainMaker 手机应用中打开设备,进入 Settings,使用 Wi-Fi Reset 选项。设备将清除 Wi-Fi 凭证并重启进入配网模式。

  3. RainMaker CLI – 如果设备在线且已启用系统服务,可远程触发 Wi-Fi 重置:

    esp-rainmaker-cli setparams <node_id> --data '{"System":{"Wi-Fi-Reset":true}}'

    参见 RainMaker CLI 用户指南和参数管理。

可选(仅用于测试): 如果已启用串口控制台,可通过 UART 连接(例如 idf.py monitor)并运行 wifi-prov <ssid> [<passphrase>],直接配网新的 Wi-Fi 凭证。这对开发很方便,但不适合终端用户。