701N_WATCH_findmy开发说明

📎 原始文档：https://www.kdocs.cn/l/cqGqZSkNR69g

701N WATCH

FINDMY开发说明

珠海市杰理科技股份有限公司

Zhuhai Jieli Technology Co.,LTD

版权所有，未经许可，禁止外传
http://www.zh-jieli.com/

修改记录

目录
一、 概述.............................................................................................................. 4
二、 规格.............................................................................................................. 5
（一） 资源................................................................................................................................................. 5
（二） 功耗................................................................................................................................................. 5
1． 待机功耗.................................................................................................................................... 5
三、 工程配置...................................................................................................... 6
（一） 功能宏定义..................................................................................................................................... 6
（二） 芯片算法鉴权................................................................................................................................. 6
（三） T。ken烧录...................................................................................................................................... 6
四、 控制.............................................................................................................. 7
（一） 功能控制......................................................................................................................................... 7
（二） 配对广播控制................................................................................................................................. 7
五、 播放声音...................................................................................................... 8
六、 事件回调...................................................................................................... 8

一、概述

http://www.zh-jieli.com/

一、概述

1. Find My 是苹果公司提供的一种寻找丢失设备的服务和协议。 它可以帮助用户定位并追踪丢失的苹果设备，如AirTag 和 AirPods 等。findmy协议依托庞大的findmy network 网络，即使本身没有 GPS 模块，也能利用它周围的苹果设备（iPhone， iPad，Mac）来帮助其定位。
   2.在findmy协议中主要可以分为以下角色：
   1.拥有者设备（Owner device）：拥有者设备是用户的苹果设备，如iPhone 或iPad，通过使用Find My应用程序与外设进行连接和配对。拥有者设备与用户的Apple ID关联，并成为Find My 网络的拥有者设备角色
2. Find My服务器（findmy apple server）： Find My功能涉及到苹果的服务器，用于处理设备的定位和数据传输。这些服务器经过IOS设备通过网络协议接收来自支持Find My功能的设备发送的定位数据，并将其提供给用户的Find My应用程序进行显示和处理。
   3.外设（Accessory）：外设是实现了Find My 网络协议的设备，如AirTag 或其他支持Find My功能的设备（使用烧录JL FindMy SDK 的芯片的产品）。外设可以通过与拥有者设备进行BLE协议连接和配对数据交互，加入Find My 网络
   

二、规格

http://www.zh-jieli.com/

二、规格

（一）资源

空间统计包含findmy代码及应用（UI）；
RAM空间统计方法：开启findmy模块后跑到app_main()函数中的RAM大小差异；
代码空间统计方法：开启findmy模块后编译生成的app.bin大小差异；

（二）功耗

1．待机功耗

APP:宜动健康
同一手机：APP和findmy均用苹果手机连接
不同手机：APP用安卓手机连接 findmy绑定苹果手机功耗测试为整机环境，包含杰理芯片端功耗及外设功耗；

三、工程配置

http://www.zh-jieli.com/

三、工程配置

（一）功能宏定义

打开FINDMY_EN使能， 以使用findmy模块。
#define FINDMY_EN 1

（二）芯片算法鉴权

Findmy对于授权数据的烧录参考《多算法授权使用说明》

（三）Token烧录

Findmy功能在与设备绑定的过程中需要token与苹果服务器进行绑定。 Token 的存放地址在ble_fmy_cfg.h
Token有两种格式:
1.base64格式：
把数据填入到下面两个数组中
static const char fmy_token_uuid_char[]
static const char fmy_token_auth_char[]
2.Hex格式
把数据填入到下面两个数组中
static const uint8_t fmy_token_uuid_hex[ 16]
static const uint8_t fmy_token_auth_hex[]

四、控制

http://www.zh-jieli.com/

四、控制

（一）功能控制

Findmy广播可通过函数fmy_enable(bool en)来控制。

（二）配对广播控制

Findmy 配对需要开启 Findmy 的配对广播来进行配对，通过函数 fmy_open_close_pairing_mode(bool en)控制广播的开关。

五、播放声音

http://www.zh-jieli.com/

五、播放声音

在设备端接收到来 自手机下发播放声音的命令时则会最终调用 ble_fmy_fmna.c 里面fmy_sound_control 函数来进行蜂鸣器或者播放音频来实现设备端声音的发出。

六、事件回调

Findmy相关事件的回调在ble_fmy_fmna.c的fmy_state_callback 函数中处理