Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 33 additions & 5 deletions docs/Matter_TH_User_Guide/Matter_TH_User_Guide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -139,6 +139,7 @@ endif::[]
| 53 | 19-Jan-2026 | [Apple]Romulo Quidute | * Adding Troubleshooting for the hanging with ModuleNotFoundError issue. +
* Added Container Logging Configuration section.
| 54 | 22-Jan-2026 | [Apple]Romulo Quidute | * Added OTA Image Build Procedure section with manual workflow for generating OTA requestor images.
| 55 | 05-Feb-2026 | [Apple]Romulo Quidute | * Added Thread Pairing Mode section.
|===

<<<
Expand Down Expand Up @@ -1224,11 +1225,12 @@ When the DUT is a client, refer to <<simulated-tests>>. The TH brings up the exa

In the case where the DUT is a server, the TH spins up the controller, the DUT bring-up procedure should be completed and has to be paired with the controller.

Depending on the DUTs network transport, any one of the appropriate pairing modes can be opted:
Depending on the DUT's network transport, any one of the appropriate pairing modes can be opted:

* *‘ble-wifi* ’ to complete the pairing for the DUT using BLE Wi-Fi
* *‘onnetwork’* to complete the pairing for the DUT that is already on the operational network (e.g., the device is already present on the same Ethernet network of the TH) connection
* *‘ble-thread’* to complete the pairing for the Thread Device
* *'ble-wifi'* to complete the pairing for the DUT using BLE Wi-Fi
* *'onnetwork'* to complete the pairing for the DUT that is already on the operational network (e.g., the device is already present on the same Ethernet network of the TH) connection
* *'ble-thread'* to complete the pairing for the Thread Device using BLE
* *'thread'* to complete the pairing for the Thread Device using Border Agent (without BLE)

Follow the sections below for the project configuration and test execution.

Expand Down Expand Up @@ -1306,7 +1308,7 @@ image:images/img_15.png[]
}
----

===== On Network Mode
==== On Network Mode
.. If the DUT is already present on the operational network (e.g., connected to the same network as the controller via Ethernet) then the user can select this mode.
.. Configure the DUT by providing details like discriminator, setup_code and set the *pairing_mode as "onnetwork"*.
+
Expand Down Expand Up @@ -1370,6 +1372,32 @@ NOTE: _The OTBR docker is contained in the TH and runs automatically upon the st
+
WARNING: _OTBR needs to be configured and running. TH will not start any OTBR docker containers._

==== Thread Pairing Mode (using Border Agent)
.. Input the DUT configuration details like discriminator: "3840", setup_code:"20202021", and *pairing_mode as "thread"*.
+
[source,xml]
----
"dut_config": {
"discriminator": "3840",
"setup_code": "20202021",
"pairing_mode": "thread",
"chip_timeout": null,
"chip_use_paa_certs": false,
"trace_log": true
}
----

.. For Thread pairing mode, Border Agent parameters `operational_dataset_hex`, `ba_host` and `ba_port` are mandatory.
+
[source,xml]
----
"thread": {
"operational_dataset_hex": "0e08000000000001000035060004001fffe00708fd5270f26ee4c02c041064dc641d7195508d7cd17ce22db711420c0402a0f7f8000300000f0102123402081111111122222222030444454d4f051000112233445566778899aabbccddeeff",
"ba_host": "192.168.1.100",
"ba_port": 5684
}
----

==== PAA Certificates
For the case that the DUT requires a PAA certificate to perform a pairing operation, input "true" for the flag "chip_tool_use_paa_certs" to configure the Test-Harness to use them.
[source,xml]
Expand Down
Binary file modified docs/Matter_TH_User_Guide/Matter_TH_User_Guide.pdf
Binary file not shown.