TslaMouse v0.3.3 蓝牙鼠标遥控完整使用指南

本指南面向没有嵌入式开发经验的普通用户，说明如何从购买指定硬件开始，依次完成固件下载、文件校验、固件烧录、iPhone 蓝牙配对、TslaMirror 设置和首次实际使用。

本文只介绍 iPhone 上的 TslaMirror“蓝牙鼠标遥控”功能，不需要编程，也不需要为 AtomS3-Lite 配置 Wi-Fi。

英文版：TslaMouse v0.3.3 Bluetooth Mouse Remote — Complete User Guide

重要
本指南适用的硬件只能是 M5Stack AtomS3-Lite（SKU:C124）。不要把本固件烧录到老款 Atom Lite、AtomS3、AtomS3R 或其他型号。

注意
请在安全停车后完成设置和测试。驾驶员不得在车辆行驶期间操作手机、车载浏览器或调试鼠标遥控功能。

1. 这个功能需要什么

“蓝牙鼠标遥控”不是只靠一个 App 就能完成的功能。完整组合包括：

当前 TslaMirror 工程的最低系统版本为 iOS 18.0。本指南针对 iPhone；不要据此推断 iPad 已受到同等支持。

2. 开始前总检查表

准备好下列项目后再开始：

• 一块正品 M5Stack AtomS3-Lite（SKU:C124）。
• 一根能够传输数据的 USB-C 线；只有充电功能的线不能烧录。
• 一台 Windows、macOS 或 Linux 电脑。
• 电脑上安装最新版 Chrome 或 Microsoft Edge。网页烧录方式不支持 Safari。
• iPhone 已安装支持“蓝牙鼠标遥控”的最新版 TslaMirror，系统为 iOS 18 或更高版本。
• iPhone 蓝牙已开启，并允许 TslaMirror 使用蓝牙。
• 已从 TslaMirror 官方网站下载本页指定的 v0.3.3 固件。
• 已核对固件 SHA-256。
• 首次连接时可以手持 iPhone，使其保持正常竖放或横放，而不是平放不动。
• 已了解 iPhone 控制中心中“竖排方向锁定”的当前状态。

3. 固件下载资料

3.1 官方固件

AtomS3-Lite（SKU:C124）固件下载：
https://teslamirror.com/TslaMouse-v0.3.3.bin

这是提供给 AtomS3-Lite（SKU:C124）使用的 TslaMouse v0.3.3 固件。此固件会把 AtomS3-Lite（SKU:C124）变成一个蓝牙鼠标设备，供 TslaMirror iOS App 的“蓝牙鼠标遥控”功能使用。

• 文件名：TslaMouse-v0.3.3.bin
• 固件版本：0.3.3
• 蓝牙设备名：TslaMouse
• 蓝牙配对密码：123456
• 文件大小：597760 字节
• SHA-256：44a9ed7606df3fb036d3a51229038438c3a866f428b887ef7ecdd69d6cbff9bd

任何旧版本升级到 v0.3.3 都必须重新配对：本版本修改了 HID 报告描述符，让按住状态与绝对坐标移动位于同一报告。请先在 iPhone AssistiveTouch 中忽略 TslaMouse，长按 AtomS3-Lite 按键约 5 秒清除设备端绑定，烧录后再重新配对。保留旧配对可能导致滑动修复没有生效。

只使用上面的 TslaMirror 官方网站下载地址。不要烧录聊天群、网盘、论坛、二手卖家或不明网站提供的同名文件。

3.2 硬件官方资料

• M5Stack 官方说明书：AtomS3-Lite（SKU:C124）官方说明
• M5Stack 官方商店：购买 AtomS3-Lite（SKU:C124）
• Amazon 商店：M5Stack Official AtomS3-Lite

第三方商店的库存、卖家和页面标题可能变化。下单前仍需亲自确认商品标注了 AtomS3-Lite 和 SKU:C124。

4. 购买时怎样避免买错

4.1 商品页面必须能确认的内容

下单前检查：

1. 产品名称是 AtomS3-Lite，其中包含 S3 和 Lite。
2. SKU 是 C124。
3. 主芯片属于 ESP32-S3，官方规格为 ESP32-S3FN8。
4. Flash 容量为 8 MB。
5. 设备有 USB-C 接口。

4.2 容易混淆但不能替代的产品

以下名称看起来相似，但不要购买来烧录本固件：

• Atom Lite（老款 ESP32，不是 ESP32-S3）
• AtomS3（带屏版本）
• AtomS3R、AtomS3R-CAM、AtomS3U
• Atom Matrix、Atom Echo
• 其他厂商的 ESP32-S3 开发板或未明确标注 C124 的兼容板

4.3 建议一起准备的配件

• USB-C 数据线一根。包装中即使附送线，也要确认它可以传输数据。
• 用于日常供电的稳定 USB 电源，例如合格的 USB 充电器、移动电源或车辆 USB 电源。
• 如果电脑只有 USB-C 接口，准备支持数据的 USB-C 转接器或 USB-C 对 USB-C 数据线。

AtomS3-Lite 没有需要用户操作的显示屏。固件状态通过内部彩色 LED 表示，这是正常设计。

5. 下载并校验固件

校验 SHA-256 可以确认下载文件没有损坏，并帮助排除下载到错误文件的情况。只有校验值完全相同才继续烧录。 大小写不影响比较，但每个十六进制字符都必须一致。

5.1 下载

1. 在电脑上打开官方固件链接。
2. 把文件保存到“下载”文件夹。
3. 确认文件名为 TslaMouse-v0.3.3.bin。
4. 如果浏览器因为重复下载而把文件命名为 TslaMouse-v0.3.3 (1).bin，校验命令中应使用实际文件名。

5.2 macOS 校验方法

1. 打开“终端”App。
2. 输入下面的命令并按回车：

shasum -a 256 "$HOME/Downloads/TslaMouse-v0.3.3.bin"

如果文件不在默认“下载”文件夹，可以先输入 shasum -a 256 ，再把文件从 Finder 拖到终端窗口中，最后按回车。

5.3 Windows PowerShell 校验方法

1. 打开 PowerShell。
2. 输入下面的命令并按回车：

Get-FileHash "$env:USERPROFILE\Downloads\TslaMouse-v0.3.3.bin" -Algorithm SHA256

查看输出中的 Hash 一栏。

5.4 Linux 校验方法

sha256sum "$HOME/Downloads/TslaMouse-v0.3.3.bin"

5.5 正确结果

三个系统的正确结果都应为：

44a9ed7606df3fb036d3a51229038438c3a866f428b887ef7ecdd69d6cbff9bd

如果结果不一致：

1. 不要烧录该文件。
2. 确认校验的是刚才下载的 v0.3.3 文件，而不是同目录中的旧版本或重复文件。
3. 重新从官方链接下载。
4. 再次校验；仍不一致时停止操作并联系 TslaMirror 支持。

6. 烧录固件：推荐的网页方式

这是普通用户的推荐方法，不需要安装开发环境。

6.1 浏览器要求

使用电脑上的最新版：

• Google Chrome；或
• Microsoft Edge。

不要使用 Safari。官方 ESP Tool 会在 Safari 中直接提示不支持。iPhone 上的浏览器也不能代替电脑完成本步骤。

官方网页烧录工具：
Espressif ESP Tool

6.2 烧录会改变什么

下载的 .bin 是从地址 0x0 写入的完整合并固件，内含启动程序、分区表和 TslaMouse 应用。

点击网页中的 Erase Flash 只会清除 AtomS3-Lite 自身的 Flash 存储，不会删除电脑或 iPhone 上的文件。它也会清除硬件中原有的蓝牙绑定，因此烧录完成后需要在 iPhone 上重新配对。

6.3 连接前准备

1. 关闭 Arduino IDE、串口终端、其他烧录软件，以及可能占用设备串口的其他浏览器标签页。
2. 如有多个 USB 串口设备，先暂时拔掉无关设备，便于识别 AtomS3-Lite。
3. 用 USB-C 数据线把 AtomS3-Lite 连接到电脑。
4. 不要经过不稳定的 USB 集线器；首次尝试优先直接连接电脑。

6.4 让 AtomS3-Lite 进入下载模式

按照 M5Stack 官方说明：

1. 保持 AtomS3-Lite 已通过 USB 连接电脑。
2. 按住设备上的复位按钮约 2 秒。
3. 看到内部绿色 LED 亮起后松开按钮。
4. 绿色 LED 熄灭后，设备已经进入等待烧录的下载模式。

如果电脑仍然看不到设备，拔下 USB，重新插入，再重复上面的按住复位按钮步骤。

6.5 在 ESP Tool 中连接设备

1. 用 Chrome 或 Edge 打开 Espressif ESP Tool。
2. 在页面的 Program 部分，把 Baudrate 设为 460800。这是速度和稳定性的推荐平衡值。
3. 点击 Connect。
4. 浏览器会弹出串口选择窗口。选择刚才连接的 AtomS3-Lite，然后点击允许或连接。
5. 页面应显示已连接到 ESP32-S3 类设备，并出现 Erase Flash、文件表格和烧录参数。

串口名称会随系统不同而变化，可能包含 USB、JTAG、Serial、usbmodem 或类似文字。如果无法判断，可取消窗口，拔下 AtomS3-Lite 后再次点击 Connect 观察哪个项目消失，再插回设备确认。

6.6 先擦除 AtomS3-Lite

1. 点击红色的 Erase Flash。
2. 等待页面下方终端显示擦除完成。
3. 擦除期间不要拔线、关闭页面或让电脑休眠。

这是全新安装 v0.3.3 的正常步骤。擦除后旧固件和旧蓝牙绑定不再保留。

6.7 选择文件并填写正确参数

连接成功后，网页会自动建立第一行文件。只使用这一行，不需要点击 Add File。

按下表设置：

特别注意：

• 地址是 0x0，不是 0x1000、0x8000 或 0x10000。
• 这里只有一个合并固件文件，不要添加第二行、第三行。
• 文件名、版本和 SHA-256 都应与第 3 节一致。

6.8 开始烧录

1. 再检查一遍五个字段。
2. 点击 Program。
3. 等待进度完成。页面可能在终端中显示写入和校验信息。
4. 在完成前不要拔掉 USB 线、刷新网页、关闭浏览器或让电脑休眠。
5. 如果页面没有显示错误，并且进度完成，即可点击 Disconnect。
6. 拔下 AtomS3-Lite，再重新接上 USB 电源；也可以按一下复位按钮让它正常启动。

6.9 烧录成功的初步判断

正常启动后，AtomS3-Lite 应以蓝色闪烁，表示等待蓝牙连接或配对。此时下一步是在 iPhone 上添加 TslaMouse。

如果不是蓝色闪烁，先查看第 13 节的故障排除，不要反复随意更改烧录地址或 Flash 参数。

7. 备用烧录方法：命令行 esptool

只有网页方式不能使用时才需要本节。第一次使用命令行的用户可优先请熟悉电脑操作的人协助。

7.1 安装 esptool

Espressif 当前的 esptool 需要 Python 3.10 或更高版本。

macOS 或 Linux：

python3 -m pip install esptool

Windows PowerShell：

py -m pip install esptool

7.2 找到串口名称

• macOS 通常类似 /dev/cu.usbmodem101。
• Linux 通常类似 /dev/ttyACM0。
• Windows 在“设备管理器”→“端口（COM 和 LPT）”中查看，通常类似 COM5。

可以在插入设备前后对比串口列表。设备仍需按第 6.4 节进入下载模式。

7.3 macOS/Linux 命令示例

先把终端当前目录切换到固件所在目录，然后把示例串口替换为电脑上的实际串口：

python3 -m esptool --chip esp32s3 --port /dev/cu.usbmodem101 erase-flash

python3 -m esptool \
  --chip esp32s3 \
  --port /dev/cu.usbmodem101 \
  --baud 460800 \
  write-flash \
  --flash-mode dio \
  --flash-freq 80m \
  --flash-size 8MB \
  0x0 TslaMouse-v0.3.3.bin

Linux 用户要把 /dev/cu.usbmodem101 换成实际的 /dev/ttyACM* 设备。

7.4 Windows PowerShell 命令示例

先进入固件所在目录，并把 COM5 换成实际端口：

py -m esptool --chip esp32s3 --port COM5 erase-flash

py -m esptool --chip esp32s3 --port COM5 --baud 460800 write-flash --flash-mode dio --flash-freq 80m --flash-size 8MB 0x0 TslaMouse-v0.3.3.bin

如果 460800 写入不稳定，把命令中的 460800 改为 115200 后重试。速度会降低，但通常更稳定。

命令结束时应看到写入校验成功，而不是错误信息。完成后拔下设备并重新接通电源。

8. 在 iPhone 上开启 AssistiveTouch

AssistiveTouch 是 iPhone 接受这个蓝牙鼠标输入的必要前提。使用蓝牙鼠标遥控期间必须保持开启。

1. 打开 iPhone 的“设置”。
2. 进入“辅助功能”。
3. 进入“触控”。
4. 进入“辅助触控（AssistiveTouch）”。
5. 打开页面顶部的“辅助触控”开关。

开启后，屏幕上可能出现 AssistiveTouch 浮动按钮。这是 iOS 的正常界面，不代表 TslaMirror 出错。

9. 把 TslaMouse 添加为 iPhone 蓝牙鼠标

9.1 配对前确认

• AtomS3-Lite 已烧录 v0.3.3，并通过 USB 获得稳定供电。
• LED 正在蓝色闪烁。
• iPhone 蓝牙和 AssistiveTouch 均已开启。
• AtomS3-Lite 靠近 iPhone。

9.2 配对步骤

1. 保持在 iPhone 的“设置”→“辅助功能”→“触控”→“辅助触控”页面。
2. 进入“设备”。
3. 进入“蓝牙设备”。
4. 等待设备列表中出现 TslaMouse。
5. 轻点 TslaMouse。
6. 如果 iPhone 要求输入配对密码，输入：123456。
7. 点击“配对”或确认。
8. 等待 TslaMouse 显示为“已连接”。

部分 iOS 版本在以前成功配对过同一设备时不会再次询问密码，这是正常情况。

9.3 成功标志

• TslaMouse 在 iPhone 中显示已连接。
• AtomS3-Lite LED 从蓝色闪烁进入青色或绿色状态。
• iPhone 屏幕上可能显示鼠标指针。

不要在完成配对后关闭 AssistiveTouch。AtomS3-Lite 只需要电源和蓝牙，不需要加入 iPhone 热点，也不需要配置 Wi-Fi。

10. 在 TslaMirror 中完成设置

10.1 保持正确的手机姿态

首次连接和首次开始投屏时：

1. 手持 iPhone。
2. 按准备使用的方向正常竖放或横放。
3. 不要把 iPhone 平放在桌面上并保持完全不动。

这是为了让 App 正确确认屏幕方向。看到 TslaMouse 已就绪并确认控制方向正确后，可以把 iPhone 平放、固定或按需要摆放。

10.2 开启功能并允许蓝牙权限

1. 打开 TslaMirror。
2. 点击 App 的设置按钮。
3. 进入“蓝牙鼠标遥控”。英文界面的设置入口可能显示为较短的 Bluetooth Mouse…。
4. 确认前面各项准备已经完成。
5. 打开“开启蓝牙鼠标遥控”开关。
6. iOS 首次询问蓝牙权限时，选择允许。

如果以前拒绝过权限，可根据 iOS 版本从以下位置重新开启：

• “设置”→“隐私与安全性”→“蓝牙”→开启 TslaMirror；或
• “设置”→TslaMirror→开启蓝牙权限。

10.3 让“系统方向锁”与 iPhone 一致

1. 打开 iPhone 控制中心。
2. 查看“竖排方向锁定”按钮是否亮起。
3. 回到 TslaMirror 的“蓝牙鼠标遥控”页面。
4. 如果控制中心的竖排方向锁定已开启，本页“系统方向锁”也要开启。
5. 如果控制中心的竖排方向锁定已关闭，本页“系统方向锁”也要关闭。

对应关系只有两种：

以后只要改变了 iPhone 的方向锁状态，也要同步修改 TslaMirror 中的这个开关。两者不一致时，远程点击的位置或移动方向可能不正确。

10.4 扫描并绑定

1. 确认 TslaMouse 仍在 AssistiveTouch 中显示已连接。
2. 在 TslaMirror 中点击“扫描并绑定 TslaMouse”。
3. 保持 AtomS3-Lite 通电并靠近 iPhone。
4. 等待 App 完成查找、检查固件和建立连接。

正常情况下最终应看到类似信息：

• 设备：TslaMouse
• 固件版本：0.3.3
• 状态：TslaMouse 已就绪（精确控制）

v0.3.3 使用精确的绝对坐标控制。正常情况下不需要“测试鼠标移动”，也不需要额外的“设置鼠标指针”校准步骤。若页面仍要求兼容模式的指针设置，优先按照第 13 节清除旧配对并重新配对，确认 App 识别到的固件确实是 0.3.3。

11. 第一次实际使用

11.1 开始投屏

在安全停车状态下：

1. 确保 Tesla 车辆的 Wi-Fi 已连接到 iPhone 个人热点。
2. 在车辆 Wi-Fi 设置中按需要启用“行驶期间保持连接”。
3. 确认 iPhone 未开启“低电量模式”。
4. 确认 TslaMirror 主页面的“代理”开关已开启。
5. 确认 AtomS3-Lite 持续供电，AssistiveTouch 仍开启，蓝牙鼠标遥控页面显示 TslaMouse 已就绪。
6. 手持 iPhone，保持正常竖屏或横屏姿态。
7. 点击 TslaMirror 主页面绿色的“启动”按钮开始投屏。
8. 在 Tesla 车载浏览器中访问“启动”按钮下方显示的黄色网址。
9. 等画面稳定显示后，再开始测试遥控。

11.2 建议的首次测试顺序

按下面顺序逐项测试，便于发现具体问题：

1. 在画面中央轻点一次，确认单击位置正确。
2. 分别点击画面的左上、右上、左下、右下附近，确认边缘位置可到达。
3. 连续轻点两次，确认快速点击可识别。
4. 在可滚动页面上上下滑动，确认滚动方向正确。
5. 按住一个可拖动物体并缓慢拖动，确认按下、移动和松开均正常。
6. 把 iPhone 从竖屏切换到横屏，或反向切换，再确认点击方向与位置。
7. 如使用画面 Fit/Fill 显示选项，分别确认切换后的点击位置。

当上述操作都正常后，可以不再手持 iPhone，把它平放或固定在合适位置。AtomS3-Lite 在整个使用过程中必须保持供电。

11.3 自定网页上的两个 iPhone 系统操作按钮

MJPEG、H.264 和 H.265 三种浏览器画面模式的控制面板中，都有两个可以自定的 iPhone 系统操作按钮。这两个网页按钮不会直接调用 iOS 私有指令，而是通过 TslaMouse 发送标准蓝牙鼠标附加按键；iPhone 最终执行什么操作，由 AssistiveTouch（辅助触控）中为该鼠标按键选择的操作决定。

重要
“主屏幕”和“App 切换器”只是建议的按键分配，并不是网页写死的 iOS 指令。例如，把第 2 键分配为“截屏”后，点击网页上的房屋图标就会截屏。网页图标和名称不会跟随 iOS 中选定的操作而改变。

一次性准备

请在安全停车后完成以下设置：

1. 保持 AtomS3-Lite 通电，打开 AssistiveTouch，并确认 TslaMouse 已连接。
2. 在 TslaMirror 中打开“开启蓝牙鼠标遥控”；需要时扫描并绑定 TslaMouse，等待页面显示 TslaMouse 已就绪。
3. 开始投屏，并在 Tesla 车载浏览器中打开 App 显示的网址。只有浏览器网页当前能够向 TslaMirror 发送遥控输入时，iOS 才能捕获这两个按键。
4. 在 Tesla 浏览器中先让网页控制按钮显示出来，再点击左下角半透明的菜单按钮将它们展开。继续之前，先找到房屋图标和叠放窗口/最近 App 图标。控制按钮在一段时间无操作后会自动隐藏，因此每次捕获按键前都应先把它们展开。
5. 保持投屏运行。在 iPhone 上打开“设置”→“辅助功能”→“触控”→“辅助触控”，确认“辅助触控”已打开，然后进入“设备”→TslaMouse。

分配“主屏幕”按钮

1. 先在 iPhone 的 TslaMouse 设备页面查找是否已有“按钮 2”或 Button 2。如果已有，直接轻点这一项，选择“主屏幕”，然后跳到下面的验证步骤。
2. 如果没有“按钮 2”，轻点“自定额外按钮…”；英文系统中显示为 Customize Additional Buttons...。
3. iOS 会显示“自定按钮”提示，要求按下指针设备上的一个按钮。保持这个提示打开，不要轻点“取消”。
4. 在 Tesla 浏览器中，只点击一次真正的房屋控制按钮。不要点击投屏的 iPhone 画面：画面区域发送的是普通主按键点击，独立的房屋控制按钮才会发送鼠标第 2 键。
5. iOS 识别到输入并显示操作列表后，选择“主屏幕”。
6. 返回 TslaMouse 设备页面，确认“按钮 2”已经列出，并且对应“主屏幕”。

分配“App 切换器”按钮

1. 开始第二次捕获前，先确认浏览器控制按钮仍然显示并处于展开状态。如果已经隐藏，应先重新显示并展开。
2. 在 iPhone 的 TslaMouse 设备页面，如果已有“按钮 3”或 Button 3，轻点它并选择“App 切换器”；如果没有，再次轻点“自定额外按钮…”。
3. 当“自定按钮”提示正在等待输入时，在 Tesla 浏览器中只点击一次真正的叠放窗口/最近 App 控制按钮。网页会发送鼠标第 3 键。
4. 在 iOS 操作列表中选择“App 切换器”。
5. 返回设备页面，确认“按钮 3”已经列出，并且对应“App 切换器”。

如果“自定按钮”提示等待期间网页控制按钮隐藏了，应先取消本次捕获，重新显示并展开网页控制按钮，然后再次开始捕获。不要在 iOS 等待按键时通过点击投屏画面来唤出控制按钮，否则 iOS 可能捕获到普通鼠标主按键。

还可以选择的其它操作

也可以有意把任一网页按钮分配给其它 AssistiveTouch 操作。Apple 官方资料列出了下列 AssistiveTouch 操作类型；按键分配列表中的实际名称和可选项目，会随 iOS 版本、iPhone 机型、系统语言、地区、已启用的辅助功能以及已保存的自定手势而不同：

网页只提供两个附加按键，每个按键同时只能分配一个 iOS 操作。选择其它操作，就会替换该网页按钮原来的“主屏幕”或“App 切换器”功能。除非确实需要，否则不要分配 SOS 紧急联络、重新启动、锁定屏幕或支付相关操作，以免误触发。

验证或更改分配

1. 退出“设置”，但不要关闭 AssistiveTouch。
2. 点击一次浏览器中的房屋控制按钮，确认 iPhone 回到主屏幕。
3. 点击一次浏览器中的最近 App 控制按钮，确认 iPhone 调出 App 切换器。
4. 如果任一按钮执行了错误操作，返回“设置”→“辅助功能”→“触控”→“辅助触控”→“设备”→TslaMouse，轻点对应的“按钮 2”或“按钮 3”，重新选择所需操作。通常不需要重新配对。
5. 如果两个按钮都没有反应，重新确认四项状态：AssistiveTouch 已打开、TslaMouse 已连接、TslaMirror 的蓝牙鼠标遥控显示已就绪，以及浏览器网页仍与正在运行的投屏连接。

如果移除后重新配对了 TslaMouse、重设了 AssistiveTouch，或者安装了 iOS 大版本更新，而按钮不再执行预期操作，请再次检查这两个按键分配。

Apple 官方参考：如何在 iPhone 上将指针设备与辅助触控搭配使用

12. LED 状态说明

LED 在状态切换过程中短暂变化通常是正常的。判断是否可用时，还应同时查看 iPhone 的 AssistiveTouch 连接状态和 TslaMirror 页面状态。

13. 常见问题排查

13.1 电脑完全看不到 AtomS3-Lite

按顺序检查：

1. 更换一根明确支持数据传输的 USB-C 线。
2. 换用电脑上的另一个 USB 接口，避免无供电集线器。
3. 拔下并重新插入设备。
4. 按住复位按钮约 2 秒，看到绿色 LED 后松开，让设备进入下载模式。
5. 关闭可能占用串口的软件和其他浏览器标签页。
6. 重新打开 Chrome 或 Edge，再点击 Connect。

13.2 ESP Tool 提示不支持 Safari

这是工具限制，不是固件问题。复制链接到最新版 Chrome 或 Microsoft Edge 中打开。

13.3 点击 Connect 后连接失败

1. 确认选择的是 AtomS3-Lite 对应串口，不是其他设备。
2. 重新进入下载模式。
3. 关闭串口软件。
4. 把 Baudrate 从 460800 降到 115200。
5. 更换数据线或 USB 接口后重试。

13.4 Erase Flash 或 Program 中途失败

1. 保持设备连接，不要连续快速点击按钮。
2. 重新进入下载模式并重新连接。
3. 把 Baudrate 改为 115200。
4. 再次执行 Erase Flash。
5. 确认地址为 0x0、模式为 dio、频率为 80m、容量为 8MB 后重新 Program。

13.5 烧录完成后没有蓝色闪烁，也找不到 TslaMouse

1. 点击 Disconnect 后拔下设备，再重新供电。
2. 按一下复位按钮尝试正常启动。
3. 再次核对固件 SHA-256。
4. 确认没有把网页默认地址 0x1000 留在输入框中。
5. 按正确的 0x0 / dio / 80m / 8MB 参数重新擦除并烧录。
6. 再确认硬件标签确实为 AtomS3-Lite（SKU:C124）。

13.6 iPhone 搜索不到 TslaMouse

1. 确认设备仍在供电且蓝色闪烁。
2. 把 AtomS3-Lite 放到 iPhone 附近。
3. 确认 iPhone 蓝牙已开启。
4. 从 AssistiveTouch 的“设备”→“蓝牙设备”中搜索，而不是只看控制中心。
5. 重新给 AtomS3-Lite 供电。
6. 如果它可能仍绑定旧 iPhone，按第 14 节清除全部绑定。

13.7 配对密码错误或反复配对失败

正确密码是：

123456

如果仍失败，先在 iPhone 中移除旧的 TslaMouse，再长按 AtomS3-Lite 按钮 5 秒清除设备端绑定，然后重新配对。

13.8 TslaMouse 已配对，但看不到鼠标指针

1. 确认 AssistiveTouch 仍是开启状态。
2. 在 AssistiveTouch 的蓝牙设备列表中确认 TslaMouse 显示已连接，而不只是已配对。
3. 重新给 AtomS3-Lite 供电。
4. 关闭再开启 AssistiveTouch。
5. 仍无效时清除双方旧绑定并重新配对。

13.9 TslaMirror 一直显示“正在等待 TslaMouse 在 AssistiveTouch 中连接”

这表示 App 能处理控制连接，但 iPhone 的鼠标连接尚未就绪。返回 iPhone“设置”中的 AssistiveTouch 蓝牙设备列表，连接 TslaMouse，然后再回到 TslaMirror。

13.10 TslaMirror 找不到设备或一直扫描

1. 先确认 AssistiveTouch 中已连接。
2. 确认 TslaMirror 获得蓝牙权限。
3. 确认蓝牙鼠标遥控总开关已开启。
4. 保持 App 在前台，点击“扫描并绑定 TslaMouse”。
5. 重新给 AtomS3-Lite 供电后再扫描。
6. 如曾绑定另一块设备，先点“忘记当前 TslaMouse”，再重新扫描。

13.11 显示固件未知、不兼容或要求 0.3.3 以上版本

1. 确认烧录文件名和 SHA-256。
2. 在 App 中点“忘记当前 TslaMouse”。
3. 在 iPhone 中移除 TslaMouse。
4. 长按 AtomS3-Lite 按钮 5 秒清除设备端绑定。
5. 重新配对并重新扫描绑定。
6. 仍不正确时，重新擦除并从 0x0 烧录已校验的 v0.3.3 文件。

13.12 指针能移动，但点击、拖动或精确位置不正常

这通常与旧配对保存的鼠标描述信息、错误固件或方向设置有关：

1. 确认 App 显示固件版本 0.3.3 和“精确控制”。
2. 让 TslaMirror“系统方向锁”与 iPhone 控制中心的竖排方向锁定一致。
3. 手持 iPhone，重新开始投屏。
4. 清除 iPhone、TslaMirror 和 AtomS3-Lite 三处绑定后重新配对。

13.13 点击位置方向错误、旋转后错位或无法确认屏幕方向

1. 检查两个方向锁设置是否一致。
2. 手持 iPhone，使它处于清晰的正常竖屏或横屏姿态。
3. 回到 TslaMirror 前台。
4. 停止并重新开始投屏。
5. 画面稳定后再测试四角位置。

13.14 LED 变红或设备频繁断开

1. 停止遥控，拔下再接上 AtomS3-Lite 电源。
2. 换用稳定电源和数据/供电线。
3. 把设备放在 iPhone 附近，远离明显的无线干扰源。
4. 确认 iPhone 未关闭蓝牙，TslaMirror 仍有蓝牙权限。
5. 仍持续变红时，执行完整清除和重新配对；必要时重新烧录。

13.15 AssistiveTouch 已开启，但虚拟光标表现与预期不符

如果 AssistiveTouch 已经开启，但虚拟光标的位置、移动范围或屏幕边界仍与预期不一致，可先按下面步骤排查 iPhone / AssistiveTouch 本身，再考虑重新烧录固件。

快速排查

1. 重新启动 iPhone。 普通重启可以清除一些会影响外接蓝牙指针设备的临时 iOS 状态。
2. 关闭再开启蓝牙。 先断开 TslaMouse，进入“设置”→“蓝牙”，关闭蓝牙，等待约 5 秒，再重新开启并连接 TslaMouse。
3. 关闭再开启 AssistiveTouch。 进入“设置”→“辅助功能”→“触控”→“辅助触控”，关闭 AssistiveTouch，然后重新开启。

调整 AssistiveTouch 与显示设置

1. 检查“跟踪灵敏度（Tracking Sensitivity）”。 进入“设置”→“辅助功能”→“触控”→“辅助触控”，调整“跟踪灵敏度”滑块。如果光标行为异常，可先把灵敏度调到中间附近再重新测试。过高或过低的灵敏度会让问题更难判断，尤其是在同时使用显示缩放时。
2. 切换“始终显示菜单（Always Show Menu）”或重置相关指针设置。 如果当前 iOS 版本提供“始终显示菜单”选项，可以关闭再重新开启。也可以在“设置”→“辅助功能”→“触控”→“辅助触控”中重置与指针相关的设置，以刷新当前的指针状态和屏幕边界。
3. 临时关闭“放大显示（Display Zoom）”或辅助功能“缩放（Zoom）”。 如果在“设置”→“显示与亮度”→“显示缩放”中启用了放大显示，或者在“设置”→“辅助功能”→“缩放”中启用了辅助功能缩放，可先临时关闭再测试。这些功能会改变有效显示缩放比例；当虚拟光标边界出现截断或偏移时，尤其是在较小屏幕的 iPhone 上，应优先排除这些设置的影响。

完成上述任一设置修改后，重新连接 TslaMouse，手持 iPhone 保持明确的正常竖屏或横屏姿态，重新开始投屏，并再次测试画面中心和四个角落。如果问题仍然存在，继续按第 13.12～13.13 节排查；必要时按第 14 节完整清除绑定后重新配对。

14. 完整清除绑定并重新配对

蓝牙鼠标连接和 TslaMirror 控制连接是两项相关但不同的记录。更换 iPhone、更换 AtomS3-Lite、完整烧录合并固件或旧配对异常时，建议三处一起清除。

1. 打开 TslaMirror“蓝牙鼠标遥控”页面。
2. 点击“忘记当前 TslaMouse”。
3. 到 iPhone“设置”→“辅助功能”→“触控”→“辅助触控”→“设备”→“蓝牙设备”，移除或忽略 TslaMouse。不同 iOS 版本也可能需要从“设置”→“蓝牙”中点设备信息按钮后选择“忽略此设备”。
4. 保持 AtomS3-Lite 通电，长按设备按钮约 5 秒。
5. 看到橙色 LED 后松开，等待设备重启并变为蓝色闪烁。
6. 按第 9 节重新输入密码 123456 完成配对。
7. 回到 TslaMirror，按第 10 节重新扫描并绑定。

如果怀疑鼠标按键处于卡住状态，长按 5 秒的清除过程也会先释放按键再清除绑定。

15. 以后每天怎样使用

完成第一次设置后，正常情况下不需要每天重新烧录或重新配对：

1. 给 AtomS3-Lite 接通稳定 USB 电源。
2. 在 iPhone 上开启蓝牙和 AssistiveTouch。
3. 打开 TslaMirror。
4. 确认蓝牙鼠标遥控已开启并自动连接到保存的 TslaMouse。
5. 检查“系统方向锁”是否仍与控制中心一致。
6. 首次开始投屏时手持 iPhone，确认方向和状态。
7. 看到 TslaMouse 已就绪（精确控制） 后开始投屏和遥控。
8. 确认工作正常后，可以把 iPhone 平放或固定。

使用结束后可以：

• 停止 TslaMirror 投屏；
• 不再需要鼠标时关闭“蓝牙鼠标遥控”；
• 拔下 AtomS3-Lite 电源；
• 如果 AssistiveTouch 浮动按钮影响日常使用，可在不使用蓝牙鼠标遥控时关闭 AssistiveTouch。下次使用前必须重新开启。

16. 固件升级说明

• 本文下载链接指向 v0.3.3；它已经满足 App 要求的“0.3.3 或更高版本”。
• 不要仅因为出现普通连接问题就反复擦写固件，先按故障排除步骤检查蓝牙、权限、AssistiveTouch 和方向设置。
• 以后升级时只从 TslaMirror 官方网站 获取固件，并按照新版本对应的说明操作。
• 使用完整合并 .bin 从 0x0 烧录会覆盖设备端蓝牙绑定；升级完成后应准备重新配对和重新绑定。
• TslaMouse 不使用 Wi-Fi，也没有面向普通用户的无线自动升级流程；固件升级需要重新通过 USB 完成。

17. 最终成功检查表

• 硬件确认为 AtomS3-Lite（SKU:C124）。
• 固件来自 https://teslamirror.com/TslaMouse-v0.3.3.bin。
• SHA-256 完全匹配。
• 固件从 0x0 写入，参数为 dio / 80m / 8MB。
• iPhone 系统为 iOS 18 或更高版本，并已开启蓝牙。
• AssistiveTouch 已开启。
• TslaMouse 已用密码 123456 配对并显示已连接。
• TslaMirror 已获得蓝牙权限。
• TslaMirror 已扫描并绑定 TslaMouse。
• App 显示固件版本 0.3.3 和“精确控制”。
• TslaMirror“系统方向锁”与 iPhone 控制中心一致。
• 首次开始投屏时手持 iPhone，而不是平放不动。
• 单击、拖动、滚动、四角位置和横竖屏方向均已测试正常。

完成以上项目后，蓝牙鼠标遥控即已从硬件购买、固件安装到实际使用全部配置完成。