Matter CYW30739 Thermostat Example

An example showing the use of Matter on the Infineon CYW30739 platform.

Table of Contents

• Matter CYW30739 Thermostat Example
  • Table of Contents
  • Introduction
  • Installing ModusToolbox™ Software
    • ModusToolbox™ tools package
      • Note for WSL (Windows Subsystem for Linux)
    • Checkout Submodules
  • Building
  • Factory Data
    • Commissionable Data
    • Device Information
    • DAC / DAC Key / PAI Certificate / Certificate Declaration
  • Flashing the Application
    • Enter Recovery Mode
    • Run Flash Script
  • Running the Complete Example

Introduction

The CYW30739 thermostat example provides a baseline demonstration of a thermostat device, built using Matter and the Infineon Modustoolbox SDK. It can be controlled by a Matter controller over Openthread network.

The CYW30739 device can be commissioned over Bluetooth Low Energy where the device and the Matter controller will exchange security information with the Rendez-vous procedure. Target Thread Network information including the active dataset and CASE credentials are then provided.

Installing ModusToolbox™ Software

Follow the Installation Guide to download and install the ModusToolbox™ Software.

ModusToolbox™ tools package

ModusToolbox™ tools package should be automatically installed in the default location if you followed the Installation Guide. Please refer to the Installation Guide for the default location for different operating systems.

If you need to install the ModusToolbox™ tools package in a custom location, you must set the environment variable CY_TOOLS_PATHS to the /path/to/ModusToolbox/tools_x.x to specify the location of tools.

export CY_TOOLS_PATHS="/path/to/ModusToolbox/tools_x.x"

Note for WSL (Windows Subsystem for Linux)

If you are using WSL, please ensure you have installed the ModusToolbox™ Software for Linux. Running Windows tools directly from the WSL command line would cause path resolution failure in the build process.

Checkout Submodules

Before building the example, check out the Matter repository and sync submodules using the following command:

$ cd ~/connectedhomeip
$ scripts/checkout_submodules.py --platform infineon

Building

• Build the example application:

  $ cd ~/connectedhomeip
  $ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat
  

• OR use GN/Ninja directly

  $ cd ~/connectedhomeip
  $ source scripts/activate.sh
  $ gn gen --root=examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat
  $ ninja -C out/cyw30739-thermostat [thermostat-BOARD_NAME]
  

• To delete generated executable, libraries and object files use:

  $ cd ~/connectedhomeip
  $ rm -rf out/cyw30739-thermostat
  

Factory Data

Commissionable Data

Infineon CYW30739 examples use test passcode, discriminator and PAKE parameters by default. For a production build, manufacturers should override commissionable data by the following arguments:

• matter_passcode, matter_discriminator, matter_pake_iteration_count, matter_pake_salt

  $ cd ~/connectedhomeip
  $ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
  'matter_passcode=20202021' \
  'matter_discriminator=3840' \
  'matter_pake_iteration_count=1000' \
  'matter_pake_salt="U1BBS0UyUCBLZXkgU2FsdA=="'
  

Device Information

Infineon CYW30739 examples support overriding the default device information by the following arguments:

• matter_vendor_name
• matter_vendor_id
• matter_product_name
• matter_product_id
• matter_serial_number
• matter_hardware_version
• matter_hardware_version_string

To override the default device information, pass the desired values to the gn_build_example.sh script as arguments.

```bash
$ cd ~/connectedhomeip
$ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
'matter_vendor_name="Infineon"' \
'matter_vendor_id="0x1388"' \
'matter_product_name="TEST_PRODUCT"' \
'matter_product_id="0x0001"' \
'matter_serial_number="TEST_SN"' \
'matter_hardware_version=30739' \
'matter_hardware_version_string="30739"'
```

DAC / DAC Key / PAI Certificate / Certificate Declaration

Infineon CYW30739 examples use development certifications, keys, and CD by default. For a production build, manufacturers can provision certifications, keys, and CD by the following arguments:

• matter_att_cert, matter_att_cert_password, matter_cd

  $ cd ~/connectedhomeip
  $ scripts/examples/gn_build_example.sh examples/thermostat/infineon/cyw30739 out/cyw30739-thermostat \
  'matter_att_cert="/path/to/att_cert.p12"' \
  'matter_att_cert_password="password"' \
  'matter_cd="/path/to/cd.der"'
  

Flashing the Application

Enter Recovery Mode

Put the CYW30739 in to the recovery mode before running the flash script.

1. Press and hold the RECOVERY button on the board.
2. Press and hold the RESET button on the board.
3. Release the RESET button.
4. After one second, release the RECOVERY button.

Run Flash Script

• On the command line:

  $ cd ~/connectedhomeip
  $ out/cyw30739-thermostat/thermostat-BOARD_NAME.flash.py --port <port>
  

Running the Complete Example

• It is assumed here that you already have an OpenThread border router configured and running. If not see the following guide Openthread_border_router for more information on how to setup a border router on a raspberryPi.

• For this example to work, it is necessary to have a second CYW30739 device running the thermostat example commissioned on the same OpenThread network