Find My 接入服务

该蓝牙单点通用模组具备接入 Apple Find My Network 与 Google Find My Device 服务的能力，支持在 iOS 与 Android 操作系统中实现设备定位与查找功能。

简介

适用场景

• 适用于需要定位和查找功能的设备场景。

方案特点

• 提供蓝牙单点配网控制支持，可通过手机和网关进行配网。
• 支持 Apple Find My Network 和 Google Find My Device 服务接入，为用户提供强大的设备定位功能。
• 可灵活选择启用或禁用 iOS Find My 功能。
• 具备涂鸦配网的可选开关，使产品更加灵活，适用于不同场景。
• 低功耗设计，确保设备长时间稳定运行。
• 提供 Apple Find My Network 与 Google Find My Device 认证服务。
• 同时支持 Find My App 和 Tuya App。

Find My 相关协议

该章节协议适用于融合了苹果 Find My 功能的蓝牙 LE 通用固件。目前，该协议仅适用于 GR5513 蓝牙 LE 通用固件。

Find My 广播功能（可选CMD-0xC300）

• Find My 功能作为可选功能，用户可通过该指令来控制 Find My 广播的开关。关闭 Find My 广播即代表关闭 Find My 功能，因此，若需使用 Find My 功能，必须打开 Find My 广播。
• 拥有 Find My 功能的固件默认开启 Find My 广播功能。
  • 当 Find My 设备处于未配网状态时，设备上电将进入配网模式，并启动 Find My 配网广播。该配网广播将在 10 分钟后自动关闭，而重复调用该命令打开 Find My 广播功能会使设备重启，并刷新计时。
  • 当 Find My 设备处于配网状态时，设备上电将启动并持续 Find My 慢速广播。
• 部分固件会强制要求支持 Find My 功能，故关闭 Find My 广播会返回不支持。

MCU 发送：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x00
7	1	Config	0x00：关闭 Find My 广播功能（禁用） 0x01：打开 Find My 广播功能
8	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• 发送指令 55 AA 00 C3 00 02 00 01 C5，开启 Find My 广播功能。
• 发送指令 55 AA 00 C3 00 02 00 00 C4，关闭 Find My 广播功能。

模组回复：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x00
7	1	Status	0x00：成功 0x01：失败 0x02：不支持
8	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• 模组回复 55 AA 00 C3 00 02 00 01 C5，表示设置失败。
• 模组回复 55 AA 00 C3 00 02 00 00 C4，表示设置成功。

Find My 本地解绑（CMD-0xC301）

• 在 Find My App 上进行离线解除设备绑定时，设备端需要执行本地解绑操作，以确保设备能够再次配网。

• Apple Find My Network 在本地解绑后，必须在 Find My App 上也执行解绑后，才能重新绑定到 Apple Find My Network。

• 绑定到 Google Find My Device 的设备，执行 Find My 本地解绑后，可直接在 Google 查询 App 上再次添加。

MCU 发送：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x01
6~6+Len-1	1	SubCmd	0x01
6+Len	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如，MCU 发送指令 55 AA 00 C3 00 01 01 C4，设备端本地解除 Find My 绑定关系。

模组回复：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x01
7	1	Status	0x00：成功 0x01：失败
8	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• 模组回复 55 AA 00 C3 00 02 01 01 C6，表示失败。
• 模组回复 55 AA 00 C3 00 02 01 00 C5，表示成功。

Find My 序列号可读配置（CMD-0xC302）

FMCA App 认证测试需要读取设备的序列号（SN），然而出于安全考虑，设备默认情况下禁止对 SN 的读取。通过该命令可以临时打开设备对 SN 的读取权限，以便在 FMCA App 认证测试期间获取必要的信息，每次打开后 5 分钟，设备会关闭读取权限。

MCU 发送：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x02
7	1	Config	0x01：允许 SN 读取
8	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• MCU 发送指令 55 AA 00 C3 00 02 02 01 C7，临时开启 Find My SN 读取权限。

模组回复：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x02
7	1	Status	0x00：成功 0x01：失败
8	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• 模组回复 55 AA 00 C3 00 02 02 01 C7，表示失败。
• 模组回复 55 AA 00 C3 00 02 02 00 C6，表示成功。

Find My 状态通知（CMD-0xC303）

本命令提供了设备与 Find My 相关的一些状态通知，包括但不限于查找 App 上触发寻找设备和播放音乐动作的通知，设备与 Find My 配网状态的变化，以及绑定状态的变化。

模组发送：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x03
7	1	PlayScene	状态： 0x00：查找 App 呼叫 0x01：查找 App 呼叫停止 0x02：Find My 本地解绑 0x03：Find My 进入配网 0x05：Find My 配网成功 0x06：Find My 配网超时
8	1	Source_Type	状态来源： 0x01：Apple Find My Network 0x02：Google Find My Device 服务 0x03：Apple & Google Find My
9	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• 当 Find My App 上操控 播放声音 打开时，模组将发送指令 55 AA 00 C3 00 02 03 00 C7。
• 当 Find My App 上操控 播放声音 关闭时，模组将发送指令 55 AA 00 C3 00 02 03 01 C8。
• 当 MCU 对 Find My 本地解绑成功时，模组将发送指令 55 AA 00 C3 00 02 03 02 C9。
• 当设备进入 Find My 配网状态时，模组将发送指令 55 AA 00 C3 00 02 03 03 CA。
• 当设备进入 Find My 配网成功时，模组将发送指令 55 AA 00 C3 00 02 03 05 CC。
• 当设备进入 Find My 配网状态超过 10 分钟且未被成功配网时，模组将自动关闭 Find My 广播和退出配网状态。在此情况下，模组将发送指令 55 AA 00 C3 00 02 03 06 CD，以通知设备状态的变化。

MCU回复：

序号	字节数	字段	说明
0 1	2	帧头	0x55 0xAA
2	1	版本号	0x00
3	1	命令字 CMD	0xC3
4 5	2	数据长度 Len	0x00 0x02
6	1	SubCmd	0x03
7	1	Status	0x00：成功 0x01：失败
8	1	CRC8	从帧头开始按字节求和得出的结果对 256 求余

例如：

• MCU 回复 55 AA 00 C3 00 02 03 01 C8，表示失败。
• MCU 回复 55 AA 00 C3 00 02 03 00 C7，表示成功。

常见问题

Q：Find My App 和 Tuya App 可以同时连接控制设备吗？

A：是的，设备 Find My 功能和涂鸦连接控制功能是彼此独立的，并且设备支持多连接，因此可以同时连接 Find My App 和 Tuya App 控制设备。

Q：Find My App 和 Tuya App 连接控制功能可以关闭吗？

A：是的。

• Find My 功能作为可选功能，用户可通过 Find My 广播功能（CMD-0xC300） 来控制 Find My 广播的开关。关闭 Find My 广播将使 Find My 功能失效。
• 涂鸦接入控制功能可通过 蓝牙广播功能（CMD-0xA3） 来控制 Tuya App 广播的开关。关闭 Tuya App 广播将导致设备无法被 Tuya App 添加和连接。

如果在开发过程遇到问题，您可以登录 TuyaOS 开发者论坛 TuyaOS-蓝牙设备开发 版块进行沟通咨询。咨询前，建议首先查阅 官方资料 或参考已有帖子，并认真阅读 发帖规范。