TLSR9518
This example functions as a light bulb device type, with on/off capabilities. The steps were verified on a Telink TLSR9518 development board (also known as the B91 Development Board).
This example uses a test Vendor ID (VID) of 0xFFF1
and a Product ID (PID) of
0x8005
.
Initial setup
The steps in this document were validated on Ubuntu 20.04.
Connect the dev board to the host PC with a USB-to-UART adapter for the serial console:
- Connect PB2 of J34 (labeled TX above) on the dev board to RXD of the adapter.
- Connect GND of J56 (labeled GND above) to GND of the adapter.
Connect one side of the Burning Key (the black box with four LEDs) to the host PC with a USB A Male-to-Mini B cable, and the other side to the dev board with another USB A Male-to-Mini B cable as following:
Download LinuxBDT:
wget http://wiki.telink-semi.cn/tools_and_sdk/Tools/BDT/LinuxBDT.tar.bz2
tar -xvf LinuxBDT.tar.bz2
Install Docker Engine (don't use Docker Desktop).
Run the Docker container (this will take a while to complete the first time):
docker run -it --rm -v $PWD:/host -w /host connectedhomeip/chip-build-telink:$(wget -q -O - https://raw.githubusercontent.com/project-chip/connectedhomeip/v1.0-branch/.github/workflows/examples-telink.yaml 2> /dev/null | grep chip-build-telink | awk -F: '{print $NF}')
In the Docker container, clone and initialize the Matter SDK github repository (
connectedhomeip
):git clone https://github.com/project-chip/connectedhomeip.git
cd connectedhomeip
git fetch origin v1.0-branch
git checkout FETCH_HEAD
./scripts/checkout_submodules.py --platform telink
source ./scripts/activate.sh
Build the image and flash the board
In the Docker container, build the
lighting-app
, and then exit from Docker:cd examples/lighting-app/telink
rm -rf build
west build
exit
Flash the image to the board:
cd LinuxBDT
sudo ./bdt 9518 sws # Verify the connection
sudo ./bdt 9518 ac # Activate MCU
sudo ./bdt 9518 wf 0 -s 2040k -e # Erase flash sectors
sudo ./bdt 9518 wf 0 -i ../connectedhomeip/examples/lighting-app/telink/build/zephyr/zephyr.bin
sudo ./bdt 9518 rst -f # Reset MCU
If the previous steps succeeded, the following commands should produce similar output in the terminal:
sudo ./bdt 9518 sws
TC32 EVK: Swire ok!
sudo ./bdt 9518 ac
Activate OK!
sudo ./bdt 9518 wf 0 -s 2040k -e
EraseSectorsize...
Total Time: 26973 ms
sudo ./bdt 9518 wf 0 -i ../connectedhomeip/examples/lighting-app/telink/build/zephyr/zephyr.bin
EraseSectorsize...
Total Time: 9806 ms
Flash writing...
[ 0%]Flash Bytes Program at address 0
...
[100%]Flash Bytes Program at address b6d00
File Download to Flash at address 0x000000: 748836 bytes
Total Time: 191337 ms
sudo ./bdt 9518 rst -f
Total Time: 72 ms
reset mcu
Validate the example
The device should present itself as a USB serial device on your computer. You may look it up in
/dev
:ls -la /dev/tty*
You can open the serial console with GNU
screen
orminicom
. For example, if the device is at/dev/ttyACM0
:screen /dev/ttyACM0 115200
To reset the board, press the CHIP_RESET button, and you should see output like this in the terminal:
*** Booting Zephyr OS build v3.1.0-rc1-3593-gdac17979d626 ***
I: Init CHIP stack
I: Starting CHIP task
...
I: 812 [DL]BLEManagerImpl::ConfigureAdvertisingData
I: 823 [DL]Setting device name to : "TelinkMatter"
...
I: 1093 [SVR]SetupQRCode: [MT:NOTAREALQRCODE01234]
I: 1099 [SVR]Copy/paste the below URL in a browser to see the QR Code:
I: 1107 [SVR]https://project-chip.github.io/connectedhomeip/qrcode.html?data=MT%3ANOTAREALQRCODE01234
I: 1118 [SVR]Manual pairing code: [34970112332]
I: 1124 [DL]Setting device name to : "TelinkLight"
After successfully commissioning the board, you may control the blue LED by pressing the SW3 K2 button. Each press causes the LED to alternately turn on or off and the following output to appear in the terminal:
I: Turn On Action has been initiated
I: Turn On Action has been completed
D: 1058359 [DMG]Endpoint 1, Cluster 0x0000_0006 update version to 92b92035
...
I: 1058365 [ZCL]Cluster OnOff: attribute OnOff set to 1
...
D: 1058372 [DMG]Endpoint 1, Cluster 0x0000_0008 update version to 7ea4bc9c
...
I: 1058378 [ZCL]Cluster LevelControl: attribute CurrentLevel set to 254
To factory reset the board, press the SW2 K1 button, and you should see output like this in the terminal:
I: Factory Reset triggered.
Next steps
When your Matter example has been successfully built, create a developer project.