文档总览
连接设备、投屏与指针
按 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 提示继续。反复失败时,按照排障指南定位具体链路。