最新Matter Test Harness使用指南（一）

本文由CMGC Matter TIG小组供稿

作者：泰凌微电子于金邈、DEKRA贺伟

为了简化Matter设备的测试和认证过程，连接标准联盟开发了一套标准化的测试工具，即Matter Test Harness。随着Matter发展至V1.3版本，Matter的测试工具Test Harness也在同步更新。

目前联盟已经不再提供完整的最新Test Harness镜像文件，而是完全开源，可以在GitHub上获取代码自行安装，本文将着重介绍最新Test Harness（以下简称TH）工具的安装步骤。

TH所需硬件介绍

* 一个树莓派4B作为TH的主机（4GB RAM及以上）

* 一张64GB（及以上）的SD卡给树莓派使用

* 一个Nordic 52840 Dongle作为RCP

TH工具安装

目前TH工具的代码已经完全开源，仓库地址如下：

https://github.com/project-chip/certification-tool/

切换分支和标签可以查看TH各版本情况，我们以最近一次Matter V1.3 SVE测试活动使用的v2.10-beta3+spring2024版本为例。

1. 在树莓派上安装Ubuntu Server

在电脑上插入SD卡，选择UBUNTU SERVER 22.04.4 LTS(64-BIT)，并设置好用户名和密码，开启SSH服务，允许使用密码登录，开始镜像烧录。

2. SSH远程登录树莓派

完成Ubuntu Server镜像烧录后，将SD卡插入树莓派并上电启动，待启动完成后，可以通过SSH远程登录树莓派。

3. 在树莓派上获取certification-tool仓库

注意：请确保您的网络环境稳定并且可以访问GitHub等外部网址，否则后续的所有步骤都会非常容易失败。

本文以v2.10-beta3+spring2024为例，直接指定拉取v2.10-beta3+spring2024分支，在home目录下直接拉取certification-tool仓库：

$ git clone -b v2.10-beta3+spring2024 https://github.com/project-chip/certification-tool.git

4. 获取submodule

进入certification-tool目录，开始下载子模块。

$ cd certification-tool/

$ git submodule update –init –recursive

5. 安装TH依赖项

直接运行auto-install.sh脚本来进行配置和安装。

$ ./scripts/pi-setup/auto-install.sh

脚本运行至最后，系统提示输入“1”，重启树莓派。

6. 等待树莓派重新启动后，在浏览器中输入树莓派的IP地址，显示TH的UI界面，至此TH工具安装完毕。

7. 将作为RCP的Dongle（需提前烧录好RCP固件）插入树莓派，两者组成边界路由（OTBR），启动OTBR，建立Thread网络。

$ ./certification-tool/scripts/OTBR/otbr_start.sh

升级已有TH镜像

如果您已经安装旧版TH镜像，想要升级到最新版本，只需要先关闭所有docker，把certification-tool仓库拉取到想要升级的分支，然后同样拉取submodule并执行auto-update.sh脚本即可，在执行完成后运行start.sh脚本重新启动docker。

$ cd ~/certification-tool

$ ./scripts/stop.sh

$ git fetch

$ git checkout

$ git pull

$ git submodule update –init –recursive

$ ./scripts/ubuntu/auto-update.sh

$ ./scripts/start.sh

以上内容就是安装最新版TestHarness工具的步骤，下一次将介绍如何使用TestHarness工具来进行Matter测试。

访问联盟网站