文档总览

连接设备、投屏与指针

按 App 的设置顺序,逐项确认连接已经可用。

完成固件刷写和 App 安装后,将板子连接到 iPhone,由手机给板子供电。设置与运行期间保持手机解锁。

1. 蓝牙配对

打开 ESP32 Agent,跟随 Plug Me In 步骤,允许蓝牙权限、选择板子并完成配对。

等待 App 确认连接成功。板子通电、USB 能识别,不代表加密蓝牙连接已建立。扫描或配对超时时,将手机与板子靠近,用 App 的重试入口重新检查。

2. 加入板子的 Wi-Fi 热点

进入 Let Me See the Screen。启用并获准使用 Hotspot Configuration 时,App 可以请求加入热点;否则去 iOS「设置 → 无线局域网」,按 App 显示的名称和密码手动连接。

使用你这块板子的实际凭据,不要照搬别人的密码。板子热点显示「无互联网连接」是预期情况,模型调用需要蜂窝数据。

3. 开启屏幕镜像

打开「控制中心 → 屏幕镜像 → ESP32 Agent」。板子接收 AirPlay 码流,再通过 BLE 传回手机 App。

列表里找不到接收端时,先确认手机仍连着板子热点,并检查板子是否在线。连接到另一个家庭 Wi-Fi,不能替代这条投屏链路。

4. 开启辅助触控并校准

进入「设置 → 辅助功能 → 触控 → 辅助触控」,打开辅助触控。回到 App,继续 Let Me Use the Pointer。

校准期间先不要触摸屏幕,等待自动流程结束。系统通过鼠标指针操作,而不是直接调用触摸坐标,小目标能否点准与校准有关。先使用竖屏,当前还不支持横屏 App。

5. 连接模型

在 Give Me a Brain 中填写接口地址、密钥和模型。按照模型设置指南确认所选模型确实支持图片输入。

开始运行与恢复连接

先让 Agent 打开无线局域网页面,观察过程。需要停止时,可使用支持设备上的灵动岛入口,或返回 App。

板子、热点或镜像连接丢失时,Agent 会暂停。先恢复相应连接,再按 App 提示继续。反复失败时,按照排障指南定位具体链路。

项目来源

README.md