Matter最新Test Harness工具使用介紹（二）

在之前我們介紹了Matter TestHarness (以下簡(jiǎn)稱(chēng)：TH)工具的安裝步驟，接下來(lái)為大家介紹TH工具的使用方法，該如何使用TH來(lái)對(duì)Matter設(shè)備進(jìn)行測(cè)試。

Matter的測(cè)試項(xiàng)根據(jù)聯(lián)盟的TestPlan目前可以分為五類(lèi)：全自動(dòng)測(cè)試項(xiàng)，半自動(dòng)測(cè)試項(xiàng)，手動(dòng)測(cè)試項(xiàng)，Python in docker測(cè)試項(xiàng)以及UI Python測(cè)試項(xiàng)。

1

建立Project

首先在瀏覽器輸入作為T(mén)H主機(jī)的樹(shù)莓派的IP地址，進(jìn)入到TH的UI界面，點(diǎn)擊左上角的”+ Add Project”新建一個(gè)工程，建立完成后在下面的Project details中可以選擇”Edit”來(lái)對(duì)它進(jìn)行配置。

1、在”thread”一欄可以修改測(cè)試建立的Thread網(wǎng)絡(luò)的信息，如channel、panid、networkkey等。

2、在”dut_config”一欄需要根據(jù)待測(cè)設(shè)備的實(shí)際信息進(jìn)行修改，以下為一個(gè)示例：

3、在”test_parameters”一欄是對(duì)UI Python測(cè)試項(xiàng)的配置，對(duì)于UI Python測(cè)試項(xiàng)，需要提前手動(dòng)建立Thread網(wǎng)絡(luò)，并將對(duì)應(yīng)的dataset填入此欄，以下為一個(gè)示例：

4、在右側(cè)的”PICS”，需要將待測(cè)設(shè)備的pics文件導(dǎo)入。

5、完成配置后，點(diǎn)擊Project details中的箭頭（Go To Test-Run）就可以進(jìn)入測(cè)試頁(yè)面，點(diǎn)擊”Create New Test Run”就可以開(kāi)始選擇測(cè)試項(xiàng)。

6、右側(cè)的Summary可以看到TH根據(jù)你導(dǎo)入的pics文件，自動(dòng)選擇了待測(cè)設(shè)備需要測(cè)試的測(cè)試項(xiàng)（此處已提前導(dǎo)入一個(gè)pics文件），并且已經(jīng)把測(cè)試項(xiàng)分類(lèi)：FirstManualSuite為手動(dòng)測(cè)試項(xiàng)，F(xiàn)irstChipToolSuite包含全自動(dòng)和半自動(dòng)測(cè)試項(xiàng)（semi-automated為半自動(dòng)），Python Testing需要查看TestPlan來(lái)區(qū)分是UI自動(dòng)測(cè)試還是docker自動(dòng)測(cè)試。

2

全自動(dòng)測(cè)試項(xiàng)

全自動(dòng)測(cè)試項(xiàng)在測(cè)試過(guò)程中不需要任何其余操作，以上面的TC-ACL-1.1為例，點(diǎn)擊”Clear Selection”清除全部自動(dòng)勾選，并勾上TC-ACL-1.1，在右上角填寫(xiě)操作者名稱(chēng)，就可以點(diǎn)擊”Start”開(kāi)始測(cè)試。

3

半自動(dòng)測(cè)試項(xiàng)

半自動(dòng)測(cè)試項(xiàng)是在全自動(dòng)測(cè)試項(xiàng)的基礎(chǔ)上，其中的某些測(cè)試步驟需要手動(dòng)進(jìn)行，如重啟設(shè)備、手動(dòng)輸入命令驗(yàn)證等。

需要注意的是，在半自動(dòng)測(cè)試項(xiàng)的手動(dòng)步驟中，我們想要操作設(shè)備需要使用測(cè)試中隨機(jī)生成的NODE ID，并且需要在docker中進(jìn)行操作，因此使用chip-tool的命令示例如下：

$ docker exec -it th-sdk./chip-tool onoff on 0x65499e6daeaf0413 1

在某些舊版本的TH中，需要使用th-chip-tool而不是th-sdk，請(qǐng)注意確認(rèn)。隨機(jī)生成的NODE ID會(huì)在測(cè)試開(kāi)始時(shí)在右側(cè)的日志區(qū)域打印出來(lái)，每次測(cè)試都不相同，需要自行查看并使用正確的NODE ID。

4

手動(dòng)測(cè)試項(xiàng)

手動(dòng)測(cè)試項(xiàng)并不需要用到TH UI界面，所有的測(cè)試步驟都需要手動(dòng)輸入并驗(yàn)證結(jié)果。因此在進(jìn)行手動(dòng)測(cè)試前，需要先建立Thread網(wǎng)絡(luò)，運(yùn)行”certification-tool/scripts/OTBR”目錄下的otbr_start.sh腳本即可建立Thread網(wǎng)絡(luò)，在運(yùn)行前可以在otbr_start.sh腳本里修改合適的channel來(lái)盡量減少干擾。

5

UI Python測(cè)試項(xiàng)

UI Python測(cè)試項(xiàng)和全自動(dòng)測(cè)試項(xiàng)一樣，測(cè)試過(guò)程中不需要手動(dòng)操作，但是在測(cè)試開(kāi)始前需要先自行建立Thread網(wǎng)絡(luò)，并把dataset寫(xiě)入到”test_parameters”一欄，這一步上面的章節(jié)已經(jīng)介紹過(guò)，不再贅述。

6

Python in docker測(cè)試項(xiàng)

除了UI Python測(cè)試以外，還有一部分python測(cè)試項(xiàng)是需要在docker中運(yùn)行python腳本進(jìn)行測(cè)試的，具體步驟如下。

1、使用”docker images”命令查看名為”connectedhomeip/chip-cert-bins”的docker的tag

$ docker images

2、進(jìn)入docker，同時(shí)把測(cè)試腳本和證書(shū)等文件映射進(jìn)docker，示例命令：

$ docker run -v /home/ubuntu/certification-tool/backend/test_collections/matter/sdk_tests/sdk_checkout/python_testing:/root/temp_python_testing -v /home/ubuntu/ci-pics-values.txt:/root/ci-pics-values -v /var/credentials:/credentials -v /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket -v $(pwd):/launch_dir --privileged --network host -it connectedhomeip/chip-cert-bins:9f6d627e0262e1d023986291948bb4e845be803e

3、運(yùn)行/root/temp_python_testing文件夾中的測(cè)試腳本，并添加待測(cè)設(shè)備的參數(shù)以及TestPlan要求的參數(shù)，開(kāi)始測(cè)試，示例命令：

$ rm -f admin_storage.json && python3 temp_python_testing/TC_OPCREDS_3_1.py --discriminator 2562 --passcode 36797971 --commissioning-method ble-thread --paa-trust-store-path /credentials/development/paa-root-certs/ --storage-path admin_storage.json --thread-dataset-hex 0e08000000000001000035060004001fffe00708fd50afc244fc6392041043dd81dbf3fb77bdbdd881c09f04e9e80c0402a0f7f8000300001201025b3502085b35dead5b35beef030435623335051000112233445566778899aabbccddeeff --ble-interface-id 0

審核編輯：劉清