产测上位机使用指南

本文描述当前 Zigbee 产测需要使用到的 生产解决方案 中的 云模组 工具，包含一些设置及相关选项的介绍。

工具获取

关于产测工具软件，参考 产测授权指导文档的前置准备章节。

云模组框架

进入 生产解决方案 后，单击 生产测试，并单击 云模组 进入云模组界面。

云模组初始界面如下：

云模组框架如下图：

• 1 工具名称及版本：云模组烧录授权平台名称和版本号。
• 2 工具参数配置栏：设置产测参数，切换作业模式，查看测试报表，查看日志，激活高级定制功能等。
• 3 产测信息显示栏：根据生产凭证或者工单号，显示当前产测类型、工序和运行模式等信息，可切换测试工序。
• 4 确定及运行按键：通过 确定 按键锁定当前配置内容，单击 运行 开始启动程序烧录授权或者其他流程。
• 5 产测监控窗口：显示当前产测路数和测试状态。

云模组界面

填写 生产凭证 并单击 确定，锁定产品信息后才能更改参数设置。

当 生产凭证 未填写时，无法选择 参数设置 下拉菜单中的 参数设置。

拷贝 生产凭证 并回车，云模组会自动识别生产凭证对应信息。下图以 ZSU 模组为例。

配置信息

产品烧录授权前，需要确认以下信息是否正确：

• 产品型号：涂鸦模组型号，当前为 ZSU-IPEX。
• 固件归属：表示固件为涂鸦开发固件还是其他固件。
• PID 标识：在涂鸦 IoT 开发平台创建的产品的 PID 信息。
• 固件版本：当前生产凭证或者固件版本。
• 测试工序：选择测试类型。
• 运行模式：烧录授权运行模式，当前模式为 手动运行。如果需要切换到自动运行，请在参数设置中勾选 自动运行。
• 通讯类型：模组通讯类型，包括 Zigbee，蓝牙 LE 和 Wi-Fi 等。
• 凭证数量：当前生产凭证对应的可授权设备的总数量。
• 已授权数：当前生产凭证已经授权的设备的数量。
• 授权速率：Zigbee 默认授权速率为 115200。

注意事项

测试工序包含烧录授权、二次检测、预烧录和拼版烧录，根据需要选择相应工序：

• 烧录授权：固件烧录并且对模组接入涂鸦网关合法性进行授权。
• 二次检测：不烧录固件，仅检测当前模组授权数据是否正确。
• 预烧录：预先烧录固件。
• 拼版烧录：多模组同时烧录固件。

云模组界面需要选择填写的数据如下：

• 端口：设备通过 USB Dongle 连接到电脑，该 USB Dongle 对应的端口号。

  如果无法确认端口号，可以右键单击 我的电脑 > 管理。

  ​

  单击 设备管理器 > 端口，通过拔插 USB 串口设备确认端口号。

  

• DSR：DSR（Data Set Ready，数据准备就绪）。当连接了带有 DSR 功能的治具时，上位机自动识别。

• JLink：仅针对 ZS 系列模组，需要选择 JLink，设备连接电脑后自动能识别到，选择即可。

  

• SN：产品的 SN 号。如果 参数设置 中勾选了 检测 SN，则此处需要填写 SN 号，否则烧录授权会失败。

  

  若 参数设置 中勾选了 RSSI 测试，则需要选择 RSSI Dongle 串口号，RSSI Dongle 串口可通过拔插 Dongle 确定。

  

• 信道：设备 RSSI 测试的信道。如果参数设置中勾选了 RSSI 测试，则此处需要填写测试信道。

  

确认后，单击 运行。

烧录成功后，出现如下界面：

参数设置

左上角 参数设置 中，单击 参数设置。

参数设置包含基础设置、测试项设置、自动化设置和射频设置四个部分。

基础设置

• 烧录波特率：烧录固件的波特率。
• 通道数量：需要与实际产测路数设置一致。例如，如果实际产测 4 路，可以配置为 2*2。
• 自动运行：在使用测架且测架带有 DSR（Data Set Ready，数据准备就绪）功能时，勾选开启。有关 DSR 功能的电路说明，请参考 模组测试治具制作指南 内自动模式触发开关。
• 扫码触发：勾选生效，可以通过带回车功能的扫码枪扫码触发程序测试。
• 单独授权：勾选生效，在无需烧录固件只做授权的情况下，勾选开启。注意，空模组未烧录固件不可直接使用。
• 光标跳转：勾选生效，手动多路产测模式输入 SN 后回车即可跳转到下一路，无需单击选取。

测试项设置

• 检测 SN：勾选生效，配置是否输入 SN 产测。工单模式默认开启，生产凭证模式根据实际需求配置。
• GPIO 测试：工具首次使用默认开启测试，如无需测试可以取消勾选。测试模组 IO 口，需要配合特定的工装治具，不同模组有默认测试组。
• 音频测试：收费项目。
• RSSI 测试：首次使用默认开启测试，如无需测试可以取消勾选。

自动化设置

• 服务地址：输入自动化对接地址。
• 治具时间：输入自动化设备强制抬起时间。
• 测试连接：配置完成后，单击 测试连接 确认自动化连接是否成功。
• 自动模式：下拉菜单选择自动化对接模式。
• 自动设备：勾选生效，配置是否进入自动化测试模式。
• 下位机板：下拉选择下位机底板。

射频设置

• 射频测试：勾选生效，配置是否进行射频测试。
• 下位机板：勾选生效，配置是否需要从云端拉取射频配置文件。
• 射频模式：下拉菜单选择测试仪器类型，根据使用仪器选择。
• 测试对象：下拉菜单选择待测物类型。
  • 校准产测环境线损时，选择金版。
  • 正常测试时，选择非金版。
  • 无金版时，选择二级非金版。
• 仪器设置：根据平台 RF 测试说明进行设置。

超时设置

单击 参数设置 中的 超时设置。

在 超时设置通讯类型 处，选择 zigbee。

Zigbee 测试中的超时包含如下选项，可分别设置不同测试项目的超时时间。

作业模式

选择 作业模式。

当 作业模式 为 凭证模式 时，需要输入生产凭证。

当 作业模式 为 工单模式 时，需要输入工单号。

• 生产凭证/生产工单：输入生产凭证/生产工单后回车，工具自动获取生产凭证/生产工单对应信息。
• 产品型号：生产凭证/生产工单对应产品型号。
• 芯片平台：生产凭证/生产工单对应芯片平台。
• PID 标识：生产凭证对应 PID。
• 固件版本：生产凭证/生产工单对应固件版本。
• 测试工序：输入生产凭证/生产工单回车后，下拉菜单选择测试工序。工单模式里，需要在建工单前，提前维护生产工序。
• 运行模式：当前设置的测试模式。
  • 手动模式：单击 运行 按键触发流程。
  • 扫码触发：扫码后回车触发程序测试。
  • 自动运行：侦测测架对应的 DSR 信号触发程序测试。
• 通讯类型：当前产品通讯类型。
• 凭证数量/工单数量：显示当前生产凭证/生产工单总数。
• 已授权数：生产凭证模式下已授权数量。
• 工序产出：生产工单当前工序过站数量。
• 授权速率：授权波特率。Zigbee 默认 115200，可配置。
• 热点名称：当前生产凭证/生产工单热点名称。

测试报表

测试报表 中包含 直通率 选项。

单击 测试报表 > 直通率，查看直通率数据，可以看到设备烧录授权通过率。

日志功能

日志功能包含 工具日志、云端日志 和 日志导出。

• 工具日志：单击查看当前工具产测日志。
• 云端日志：单击查看工具与云端的交互日志。
• 日志导出：单击导入整个工具产测日志。
• 日志上报：如果产测失败无法自行定位问题，可以单击上报产测工具日志，供研发人员分析。

帮助

帮助界面包含 定制服务 和 操作文档，包含涂鸦高级定制功能及相关操作文档。