Telink Zigbee-BLE Lighting User Guide

Overview

This document offers an user guide for the Zigbee/BLE Concurrent Demonstration.

Zigbee/BLE Concurrent Demonstration is a set of dual-mode application examples provided by Telink based on Zigbee and BLE specifications. This example demonstrates how the GW (Zigbee Coordinator), SmartPhone (as BLE master), and Zigbee/BLE Concurrent Lighting nodes communicate with each other for network registration, connection, and simple control operations.

Hardware and Software Requirements

Software Tools

1) Required software tools

(a) Telink IDE

https://doc.telink-semi.cn/tools/telink_iot_studio/TelinkIoTStudio_V2025.2.zip

(b) Telink download tool

https://doc.telink-semi.cn/tools/bdt/BDT_v5.8.4.zip

2) Demonstration tools

(a) TelinkConnect (BLE APP on smartPhone)

3) Zigbee packet capture analysis tool

(a) Ubiqua

Hardware Platform

Supports multiple hardware platforms, such as TLSR8258, TLSR921x, TL321x, TL721x, etc.

We take the TLSR8258 platform as an example. This demonstration requires at least two TLSR8258 USB dongles, which use 1M flash by default.

TLSR8258 USB Dongle

Platform Differences

This document uses TLSR8258 as an example. The differences from other platforms are as follows:

1) The lights demonstrated on the TLSR8258 platform Lighting node are yellow, while those on other platforms are red.

2) BLE broadcast name of GW devices:

TLSR8258 and TLSR921x: tl--gw
TL321x and TL721x: multi--gw

3) BLE broadcast name of Lighting devices:

TLSR8258 and TLSR921x: tlBulb
TL321x and TL721x: multi--light

Firmware Requirements

1) concurrent_sampleGW_8258.bin: Zigbee/BLE dual-mode Gateway (GW)

2) concurrent_sampleLight_8258.bin: Zigbee/BLE dual-mode lighting device (Lighting)

Firmware Getting

SDK download link:

https://github.com/telink-semi/telink_zigbee_ble_concurrent_sdk/releases/tag/V2.4.1.0

https://gitee.com/telink-semi/telink_zigbee_ble_concurrent_sdk/releases/tag/V2.4.1.0

Download the latest version of the SDK from the directory.

Import the TLSR8258 project into the IDE, open the IDE, go to File->Import->Existing Projects into Workspace, select tlsr_tc32 in the build directory of the SDK, as shown in the figure below:

Import TLSR8258

Generate concurrent_sampleGW_8258.bin using the concurrent_sampleGW_8258 compilation option.

Generate concurrent_sampleLight_8258.bin using the concurrent_sampleLight_8258 compilation option.

For information on how to compile and burn the firmware, refer to Chapter 3 of the document “AN_18110500-E_Telink Zigbee Demo User Guide”.

Compile Option

Firmware Testing

Establish Network (GW Device)

Step 1. Power on the GW node, and the red light will be on.

Step 2. Open TelinkConnect on your mobile phone, enter the ADV interface, press the scan button in the upper left corner to start searching for Bluetooth devices, and you will find a BLE device named tl--gw.

GW Searching Interface

Step 3. Click tl--gw to connect and bind the device.

Step 4. As shown in the figure below, enter the Zigbee working channel, click ESTABLISH, and create a Zigbee network on the GW. If a network has already been established, open or close Zigbee permit join as shown in the second figure below.

Building Zigbee Network Interface

Opening and Closing Zigbee Permit Join Interface

Access Network (Lighting Equipment)

Step 1. Click ACCESS ENABLE to enable the GW's network access permission. The green light on the GW dongle will be on.

Step 2. With GW network access permission, power up the Lighting nodes that are not yet connected to the network. The Lighting nodes will start automatic network access. After successful network access, the permit join 180s will be automatically turned on, and the green light will be also on.

Light Node Control

The behavior of dual-mode light nodes can be controlled either by the GW or directly by a mobile phone via BLE.

Control via GW Nodes

There are two ways:

1) Control Lights through button:

Short pressing the SW1 button triggers the GW's Zigbee broadcast action. The GW will broadcast an On/Off command once per second, and the yellow light on the Lighting node will flash accordingly. Pressing the button again will stop the continuous broadcast.

2) Control Lights via BLE GW:

Connect to GW under TelinkConnect and enter the interface shown in the figure below.

Controling GW Broadcast ON/OFF Interface

Press ON, TelinkConnect sends a BLE message to the GW, instructing the GW to broadcast the Zigbee on command.

Press OFF, TelinkConnect sends a BLE message to the GW, instructing the GW to broadcast the Zigbee off command. And the Light will turn on and off accordingly.

Control via Lighting Node

Step 1. Search using TelinkConnect. The device named tlBulb is the Lighting device.

Lighting Searching Interface

Step 2. Pair and connect the Lighting device.

Step 3. After connecting, enter the device operation interface. In the command interface, directly send the turn on/off light command, and you can see the yellow light on Lighting turn on and off accordingly.

Turn on the light command: 0x000601
Turn off the light command: 0x000600

Lighting Controlling Interface