Using the Mattertool (chip-tool)#

The following commands show how to start a new Thread network from the local OTBR, commission an EFR32 Matter End Device (Matter Accessory Device), and then send the on/off commands with the mattertool automated script. The mattertool script provides an interface into various chip-tool and otbr commands used to create and interact with a Matter network

Basic Mattertool Commands#

You can also use the full chip-tool command set (still using mattertool)

$ mattertool levelcontrol read current-level 106 1

Advanced Information on the Matter Hub#

Image tree#

• home

  • ubuntu (you are here)

    • connectedhomeip (git repo: https://github.com/project-chip/connectedhomeip.git)

    • ot-br-posix (git repo: https://github.com/openthread/ot-br-posix.git)

    • scripts (in-house scripts)

      • configurations.sh

      • matterTool.sh

      • setupOTBR.sh

Open Thread Border Router (OTBR)#

For information on what commits to use for the OTBR and RCP, consult the Matter Repositories and Commit Hashes page

The pre-installed OTBR is configured for the infrastructure interface eth0.

Bash script to modify, reinstall or update the OTBR:

$ otbrsetup

This bash script centralizes and simplifies the local OTBR installation.

Available commands:

Usage:#

Change infrastructure to wlan0: $ otbrsetup -if wlan0 -s

Rerun full install for eth0 interface: $ otbrsetup -i

Upgrading the OpenThread Border Router (OTBR)#

Change OTBR commit reference/version

$ cd /home/ubuntu/ot-br-posix

$ git fetch

$ git checkout <SHA>

$ otbrsetup -u

Upgrading the Matter - Chip-tool#

For more information on the commit hashes used for this demo please consult the following page: Matter Repositories and Commit Hashes

To change the chip-tool commit reference/version, follow these steps:

$ cd /home/ubuntu/connectedhomeip

$ git fetch

$ git checkout <SHA>

$ mattertool buildCT

The mattertool script centralizes and simplifies the use of chip-tool and starting a clean thread network.

Available commands:

Some options/arguments can be added to the command to update the values of the variables used by the script.

Available commands:

These configurations are held until overwritten, cleared with cleanVars or when Raspberry Pi reboots.

Active variables used by mattertool:

You can preset them with export X=Y before running the script or use some available options to change some of them.

In most cases, MATTER_ROOT, CHIPTOOL_PATH, PINCODE, and DISCRIMINATOR should remain at the default set value.

For commissioning commands (bleThread, bleWifi) NODE_ID will be randomized if it is the same as the last pairing

When the startThread command is used, THREAD_DATA_SET will be assigned with the right operation dataset for the created Thread Network.

Scripts Alias#

The commands presented above are linked to scripts. You can edit .bashrc and rename the following alias to your liking.

$ alias mattertool=‘source $HOME/scripts/matterTool.sh’

$ alias otbrsetup=‘source $HOME/scripts/setupOTBR.sh'