# 快速开始

# 安装客户端

  1. 首页点击“下载使用”下载客户端安装包,当前只支持 windows 客户端

  2. 双击安装包进行安装,安装包为一键安装模式,安装过程中无需选择安装路径或其他任何操作

  3. 安装完毕后客户端将自动启动

TIP

鼠标右键点击桌面客户端快捷方式,选择“打开文件所在路径”可以进入软件的安装目录

安装目录默认为 C:\Users\${用户名}\AppData\Local\Programs\aiot-certification-studio

# 安装更新

软件更新 客户端启动时会自动检查更新,如有更新则会弹窗提示用户,点击下载更新会弹出浏览器进行下载。下载完成后请先退出客户端再双击安装包进行安装,否则程序将无法更新。

# 连接中枢网关

TIP

如果待测产品使用 Wi-Fi 模组,测试时不需要使用中枢网关,您可以跳过本小节
如果待测产品使用了 BLE 或 BLE Mesh 模组,请您重点阅读本小节,另外我们也建议您阅读这篇《深入了解中枢网关》文档加深理解。

# 为什么要连接中枢网关

mesh

BLE/BLE Mesh 设备需要通过网关进行协议转换从而实现和米家 app 通信。平台在测试 BLE/BLE Mesh 设备时需要控制设备并监听设备发送的蓝牙广播包,因此我们为小米中枢网关开发了测试专用的固件,平台客户端与烧入了测试固件的中枢网关相互配合才能正常执行测试。

gateway

WARNING

我们当前只针对小米中枢网关开发了测试专用固件,并没有适配其他类型的网关,例如小爱音响、多摸网关等。

需要特别注意的是,测试专用固件阉割了大部分市售版本的功能,例如无法执行自动化场景等;又因为目前平台不支持将中枢网关在测试固件和市售固件间切换,所以开发者在执行蓝牙产品的其他手工用例时可能还需要一台普通的蓝牙或 Mesh 网关。

TIP

不论您是否已有小米中枢网关,我们都建议您再购买一台小米中枢网关 (opens new window),并将其作为测试工具专用的网关。

# 申请使用测试专用固件

网关 打开平台客户端,选择侧边中枢网关菜单,点击申请授权即可跳转到权限申请页面。或者您也可以直接进入小米 IoT 开发者平台>管理>平台资源申请页面 (opens new window)进行申请。 申请 选择蓝牙测试工具权限申请,并按照表单提交合适的资料即可。

TIP

中枢网关 id 建议只填写一个,因为从设计上我们不支持一个用户同时连接多个中枢网关进行测试的场景

WARNING

表单中的中枢网关 id 一定不要填错,否则授权将失败,您依然无法使用自己的中枢网关辅助测试

审核人员会每天定时查看开发者提交的审核并核验相关资料,一旦审核通过您将会收到回复以及相应的授权码。收到授权码后点击客户端的输入授权码按钮打开输入框并保存刚刚收到的授权码。

WARNING

如遇到输入授权码后提示授权码错误或其他信息,请提工单,我们会协助排查问题

# 中枢网关固件升级

ota 授权成功后,可以看到客户端界面显示了已授权的网关信息,此时您需要点击右下角更新固件按钮对网关进行升级。固件升级过程中,网关会闪烁黄灯,当网关再次变为蓝灯常亮时则升级成功。您可以点击检查更新查看网关是否更新成功,或者在米家 app 上查看网关当前固件版本,固件版本是最新版则说明测试专用固件已经烧写成功。

TIP

我们会不定期优化测试专用固件并推送更新,请您及时为网关更新最新固件

# 连接与断开中枢网关

连接 平台客户端和中枢网关需通过局域网连接,连接网关前请先检查电脑是否和中枢网关连接在同一网络下。网关连接的 Wi-Fi 可以在客户端页面右侧网络信息中查看。确认网络连接正常后,点击页面左下角连接网关按钮,几秒后客户端将与网关成功连接。若要断开与中枢网关的连接直接点击断开连接按钮即可。

另外,客户端也会根据您使用的测试工具自行判断是否需要连接中枢网关,当前已实现的 BLE/BLE Mesh 测试工具都需要连接中枢网关,当您打开这些工具时,工具会先自动连接网关。 自动连接

WARNING

客户端一旦与网关建立连接就不会主动断开,请不要频繁连手动接与断开中枢网关,以免中枢网关或后台服务限流从而无法连接网关

WARNING

手动断开连接后请至少等待 5s 左右再重新连接网关,以免触发限流

# 使用测试工具

工具介绍 在前面平台介绍中我们提到,测试平台中的测试工具都是针对一条通用测试用例单独制作的,因此我们约定每个测试工具都会介绍测试的前置条件测试步骤验收标准

  • 前置条件会引导您一步一步配置出合适的测试环境与条件。
  • 测试步骤则详细告诉您测试运行的逻辑,您则需要根据产品自身的特点来更改测试过程中的部分参数(向设备发送的命令)。
  • 验收标准告诉您测试过程中工具会采集哪些指标,指标计算的方法以及指标通过的规则是什么。

我们会尽力降低您的学习成本,另外我们也会优化测试重跑逻辑,尽量避免重跑已通过的部分,让你能更快速的完成自测和验收测试。

# 查看测试报告

您可以根据产品model、产品名、固件版本、测试用例以及测试日期筛选测试报告。 测试报告

每个测试报告都包含了验收所必须的一切信息:测试指标、验收标准、测试数据等。报告中会适当提示超标的指标,并给出验收合格的范围。我们也会不断优化报告,给出更多合理有效的建议,帮助您快速定位和解决问题。 报告

上次更新: 8/24/2023, 8:23:32 PM