[FAQ] CC3551E: Matter -- Getting Started Guide

Tool/software:

CC3551E Matter Getting Started Guide

Overview

This FAQ provides instructions on how to get started with Matter on the TI CC35XX LaunchPad.

The TI CC35XX currently supports the lighting-app example demonstrating the use of the OnOff cluster (see in {connectedhomeip-root}/examples/lighting-app/ti/cc35xx/). The On/Off operations are emulated through the status of red LED on the LaunchPad. The CC35XX currently needs to be on the same target network as the Matter Controller. The SSID, Password and Security Type of the Access Point that the TI CC35XX LaunchPad will connect to needs to be hardcoded into the example application. The CHIP Tool is an emulation of a Matter controller that can be used to commission the TI CC35XX LaunchPad onto a Matter network and to send commands. The TI CC35XX LaunchPad was tested against the C++ CHIP Tool (see in {connectedhomeip-root}/examples/chip-tool/). This is a Linux command line application (each command following device commissioning creates a secure CASE session to the device before sending a command to the device). The C++ CHIP Tool support device discovery through MDNS.

Setting up the Environment

1. Install dependencies by running:

   1. Sudo apt-get intall git gcc g++ pkg-config libssl-dev libdbus-1-dev libglib2.0-dev libavahi-client-dev ninja-build python3-venv python3-dev python3-pip unzip libgirepository1.0-dev libcairo2-dev libreadline-dev
      

2. Clone https://github.com/TexasInstruments/matter
3. Checkout tag matter-v1.4-ti-1.0-EA-1.0
4. Open your terminal and navigate to connectedhomeip/
5. Initialize and install dependencies by running:

   1. Source scripts/activate.sh
      ./scripts/checkout_submodules.py --shallow --platform cc35xx linux –-recursive

6. Create a directory called repo_cc35xx inside of “{connectedhomeiproot}/third_party/ti_simplelink_sdk/”

   1. mkdir {connectedhomeiproot}/third_party/ti_simplelink_sdk/repo_cc35xx

7. Download and install v9.13.00.13 of the SimpleLink Wi-Fi SDK (https://www.ti.com/secureresources/SIMPLELINK-WIFI-SDK-PREVIEW)
8. Download and patch the SimpleLink Wi-Fi SDK using the patch file (also found here: https://www.ti.com/drr/opn/CC35XX-MATTER-PREVIEW) by running:

   1. cd /path/to/installed/sdk
      patch -p1 < /path/to/patchfile.patch

9. Copy the contents of patched SDK into the new “repo_cc35xx” folder, make sure to use the "cp -a"

   1. cp -a path/to/patched/sdk/. {connectedhomeiproot}/third_party/ti_simplelink_sdk/repo_cc35xx

You should be all set and ready to build, compile and flashing your first matter example.

Building the lighting-app for CC35XXE platform

We will now build our first matter example. Most of these steps can also be found in {connectedhomeip}/examples/lighting-app/ti/cc35xx/

1. Navigate to lighting-app example folder:

   1. cd /{connectedhomeip}/examples/lighting-app/ti/cc35xx

2. The SSID, Password and Security Type of the AP need to be hardcoded into the example in {connectedhomeip}/src/platform/ti/cc35xx/ConnectivityManagerImpl.cpp
3. build the example:
   

   1. gn gen out/debug --args="ti_sysconfig_root=\"$HOME/ti/sysconfig_1.23.1\" ti_simplelink_wifi_toolbox_root=\"$HOME/ti/simplelink_wifi_toolbox_lin_3_1_12\""
      ninja -C out/debug

Flashing the CC35XXE

Now we are ready to flash the built code into the CC35XXE. To flash the device you will need to use the SimpleLink-WiFi-Toolbox program (installed as part of the SDK above).

1. Download the tool_setting.json (also found in https://www.ti.com/drr/opn/CC35XX-MATTER-PREVIEW) and place it in /path/to/simplelink-toolbox/programmer/programming
   1. PLEASE NOTE! Depending on where your {connectedhomeip}/examples/lighting-app build directory is at in relation to /path/to/simplelink-toolbox/ the contents of the tool-settings.json may change.
2. Navigate to /path/to/simplelink-toolbox/
3. Now flash the device by running (you may need to run it as sudo):

   1. ./simplelink-wifi-toolbox programmer -i XDS110 -param1 auto programming --tool_settings
      <path to json file>/tool_settings.json --verbose