iPhone 连到家里 Wi-Fi 而不是 ESP32 Agent 热点怎么办

默认情况下，板子会开启自己的 Wi-Fi 热点，iPhone 加入这个热点。如果找不到这个热点、iPhone 一直连着家里的 Wi-Fi，板子很可能处于 station 模式。按下面任一方法切回即可。

两种 Wi-Fi 模式

模式	板子做什么	iPhone 连到哪里
热点（默认）	开启自己的网络，名称是 `ESP32Agent-…`，有自己的密码，没有外网。	板子的热点。上网继续走蜂窝数据。
Station	不开热点，而是加入已有的 Wi-Fi，例如家里或办公室的网络。	同一个网络。没有 `ESP32Agent-…` 热点。

Station 模式用于开发，例如配合开发者 Harness。日常使用需要热点模式。

板子会记住它的模式。切回之前，station 模式在板子重启、App 内更新固件之后都会保留。

怎么判断是哪种模式

热点：iPhone 的设置 → 无线局域网里能看到 ESP32Agent-…；通过 USB 串口发送 0 netinfo，回复里是 "mode":"ap"。
Station：看不到 ESP32Agent-…；0 netinfo 回复里是 "mode":"sta"（见常见问题）。

切回热点模式

任选一种。

在克隆的仓库里，通过蓝牙。先在 iPhone 上退出 App，让电脑能连上板子，然后运行：

uv run harness/board.py net ap

没和板子配对过的电脑，只能在板子上电后的三分钟内配对，所以先重新插拔板子。

通过 USB 串口。把板子从 iPhone 上拔下，接到电脑。以 115200 波特率打开它的串口，发送一行：

0 net {"mode":"ap"}

板子回复 0 ok，并重新开启热点。如果电脑上没有出现串口，用下一种方法。

用网页安装器重新安装。在 handsy.tech/install 重新安装固件。找不到板子时，按住 BOOT 键再插上。这会清除板子的所有设置：Wi-Fi 模式、热点密码和蓝牙配对。装好后，在 iPhone 的设置 → 蓝牙里忽略旧的 ESP32 Agent 设备，再在 App 里重新配对。见更新 ESP32 Agent 固件。

然后把板子插回 iPhone，加入 ESP32Agent-…，重新开启屏幕镜像。

iPhone 总是跳回家里的 Wi-Fi

在热点模式下，iOS 也可能切回已知的网络。加入板子热点前：

关闭 iPhone 的个人热点。
在设置 → 无线局域网里加入 ESP32Agent-…，或在 App 的设置 → 开发板 → 加入小板的 Wi-Fi里加入。
如果手机还是跳回去，运行任务期间把家里网络的自动加入关掉。
让板子靠近手机。板子热点的发射功率较低。

画面很慢：「本地网络」权限

App 通过 Wi-Fi 从板子获取画面，这需要 iOS 允许 ESP32 Agent 访问本地网络。第一次需要时，iOS 会询问一次。

如果当时点了不允许，画面会退回走蓝牙。任务仍能运行，但会变慢：画面有延迟，动画不连贯。重新开启：

打开 iPhone 的设置 → 隐私与安全性 → 本地网络。
打开 ESP32 Agent。
退出并重新打开 App，再开启屏幕镜像。

还是不行？看常见问题，或写信到 [email protected]。