3. FindMy 产测工具套件

3.1. 工具简介

FindMy 产测工具套件包含以下两个工具：

1. FindMy Token 导出工具 – 用于生成杰理烧录器和杰理 FindMy 产测工具所需的 Token 文件。

2. FindMy 产测工具 – 用于将 Token 文件更新到 FindMy 设备中，并执行产线测试。

FindMy 产测工具套件下载地址

---

3.2. FindMy Token 导出工具

本工具用于从杰理 MFiTools.exe 导出的 CSV 文件生成 Token 文件（.hex），供烧录和产测使用。

3.2.1. 功能说明

• 输入文件：杰理 MFiTools.exe 工具导出的 CSV 文件。

• 输出文件：.hex 后缀的 Token 文件（请勿更改后缀名）。

• 日志文件：导出后自动生成 .export.log 后缀的日志文件，记录以下信息：

  • 导出时间

  • 起始 SN 号

  • 导出勾选项的值

  • 导出 Token 的起始序号

  • 导出 Token 总数

• 自动记忆：工具启动时，会读取上次的日志文件，自动恢复导出起始序号和导出勾选项。

3.2.2. 使用步骤

1. 双击运行 FindMy Token 导出工具。

2. 工具自动读取上次导出日志（若存在），恢复起始序号和勾选项。

3. 点击“浏览”选择由 MFiTools.exe 导出的 CSV 文件。

4. 根据需要修改 导出起始序号 和 导出勾选项。

5. 点击 导出 按钮，工具将在同一目录下生成：

   • .hex Token 文件

   • .export.log 导出日志文件

6. 检查日志文件，确认导出时间、SN 起始号、Token 个数等是否正确。

3.2.3. 数据格式说明

.hex 文件每一行数据的格式如下（大端字节序）：

字节范围	数据内容	说明
0 ~ 3	固定标识	4A 4C 46 4D（即 ASCII 字符 JLFM）
4 ~ 5	校验码	从第 6 字节开始的所有后续数据的 CRC16
6 ~ 7	总长度	整行数据的总字节数（含固定标识和校验码）
8 ~ 9	数据段数	后续包含的数据段数量
10 ~ 11	格式版本	当前版本为 0x01
12 ~ 13	偏移 1	第一段数据的偏移（从 0 字节开始计算）
14 ~ 15	长度 1	第一段数据的长度
16 ~ 17	数据 ID 1	第一段数据的 ID
18 ~ 19	偏移 2	第二段数据的偏移
20 ~ 21	长度 2	第二段数据的长度
22 ~ 23	数据 ID 2	第二段数据的 ID
…	…	依次类推，每段数据占 6 字节（偏移 + 长度 + ID）

---

3.3. FindMy 产测工具

本工具用于将 FindMy Token 导出工具 生成的 Token 文件更新到 FindMy 设备中，并执行一系列产线测试。

3.3.1. 功能说明

• 支持频偏校准测试，可配置允许的最小/最大值。

• 支持信号强度测试，可配置允许的信号强度范围。

• 支持产品数据校验，将设备上报的数据与预期值进行比对。

• 支持制造商名称校验，确保设备返回的制造商名称符合预期。

• 支持型号校验，验证设备返回的产品型号是否正确。

• 支持SN / UUID / Token 更新，通过导入 Token 导出工具生成的 .hex 文件完成写入。

• 支持产测过程中的固件升级，可指定升级文件。

• 支持SN 信息输出，当前仅支持 TCP 方式，可将 SN 发送至指定服务器。

• 支持配置产测通过后的动作，可选择仅退出产测模式，或退出后执行软关机。

• 支持产测结果日志与调试日志记录，可独立配置日志文件的前缀、大小上限及滚动个数。

3.3.2. 使用步骤

1. 根据产测需求，编辑 findmy_config.ini 配置文件（参考下方配置说明）。

2. 双击运行 FindMy 产测工具，程序将自动加载配置。

3. 插入杰理 FindMy Dongle 设备，等待工具识别。

4. 将待测的 FindMy 设备放置到 FindMy Dongle 上。

5. 工具会自动执行各项测试与更新操作，等待进度完成。

6. 根据界面提示的测试结果（通过/失败）处置FindMy 设备。

7. 重复4-6步骤。

3.3.3. 配置文件说明

工具通过 findmy_config.ini 进行配置，配置内容及说明如下：

#  频偏校准测试
[freq_offset_calib_test]
enable = 1
min_value = -10
max_value = 10

# 信号强度测试
[rssi_test]
enable = 1
min_value = -100
max_value = 100

# 产品数据测试
[product_data_test]
enable = 1
expected_data = f86ae43ac67acc6a

# 制造商测试
[manufacturer_test]
enable = 1
expected_data = "Zhuhai Jieli Technology Co.,Ltd."

# 型号测试
[model_test]
enable = 1
expected_data = JLtag

# 更新 SN / UUID / Token
[sn_uuid_token_update]
enable = 1
file = jieli_test.csv.hex

# FindMy 升级文件配置
[upgrade]
enable = 0
firmware = db_update_data.bin 

# SN 输出（当前仅支持 TCP 方式）
[sn_print]
enable = 0
type = 1
server = 127.0.0.1
port = 8888

# 产测通过后执行的动作
# 0 - 仅退出产测模式
# 1 - 退出产测模式，进入软关机
[post_test_action]
enable = 1
action = 1

# 产测结果日志
[test_log]
enable = 1
file_prefix = production_test_result
max_size = 1M
max_count = 9

# 产测调试日志
[debug_log]
enable = 0
file = debug_log.txt
max_size = 1M
max_count = 9

各配置节功能简述：

• freq_offset_calib_test – 频偏校准测试，可设定允许的最小/最大值。

• rssi_test – 信号强度测试，可设定允许范围。

• product_data_test – 产品数据校验，比对设备上报的数据是否与 expected_data 一致。

• manufacturer_test – 制造商名称校验。

• model_test – 产品型号校验。

• sn_uuid_token_update – SN/UUID/Token 更新，指定由 Token 导出工具生成的 .hex 文件。

• upgrade – 产测时是否进行固件升级，指定升级文件。

• sn_print – 是否通过网络（TCP）输出 SN 信息。

• post_test_action – 产测成功后执行的动作：仅退出产测模式或退出后软关机。

• test_log – 产测结果日志的配置（文件名前缀、大小限制、滚动文件数）。

• debug_log – 调试日志的配置。