Qorvo® QPG6105 Matter lighting example shows how to create a remotely controlled dimmable color light bulb, with Thread connectivity, using the Matter protocol. It is using Bluetooth™ LE to perform Matter commissioning. This example can be used as reference for creating your own Matter light bulb.
Buttons are used as input to trigger device state changes, LEDs are used as output to visualize the device states.
Features of this application are:
- Remote lighting control (dimming, color, on/off) using a Matter controller.
- Bluetooth LE for Matter commissioning procedure.
- Factory reset implementation based on number of reset cycles.
This application uses following buttons of the Qorvo IoT Dev Kit for QPG6105:
SW2 (PB2): Used to toggle the light between two levelsSW6 (RADIO RESET): Used to perform a HW reset for the full board. If the reset is triggered 10 times in a row, factory reset will be triggered.SW4 (PB1): Used to toggle the off/on state of the simulated lightSW5 (PB4): Used to perform, depending on the time the button is kept pressed,- Trigger OTA (released 0-3s)
- Factory Reset (released after 6s)
The buttons SW1, SW3 and the slider switch SW7 are unused.
The following LEDs are used during the application:
LD3- RGB led:- Off: Light is off
- Dim: Light is set to low level
- Bright: Light is set to high level
LD4- RED led - shows the device state and its connectivity. Following states are defined:- Short blink every 1s: The device is in idle state (not commissioned yet and not Bluetooth LE advertising).
- Very fast binks: Bluetooth LE advertising.
- Fast blinks: Bluetooth LE connected and subscribed but not yet commissioned.
- On: Full service connectivity
Factory reset of the Matter light can be triggered by pressing the reset SW6 exactly 10 times in a row or by holding
SW5 at least 6 seconds. If the factory reset is triggered by the reset sequence, the light will blink one second ON and
one second OFF, two times.
For instructions to view the serial logging, refer to Enable serial logging
At startup you will see:
NRT ROM v1
qvCHIP <version> ROMv1/1 (CL:0) r:3
ResetCount[0]
[P][DL] BLEManagerImpl::Init() complete
[P][-] Initializing OpenThread stack
[P][DL] OpenThread started: OK
[P][DL] Setting OpenThread device type to ROUTER
[P][-] Starting OpenThread task
[P][-] Starting Platform Manager Event Loop
[P][-] ============================
[P][-] Qorvo Lighting-app Launching
[P][-] ============================
See Building and flashing the example applications section to get instructions how to build and program the Matter light example application.
The Matter light will start Bluetooth LE advertising automatically at start-up if it is was not commissioned before in a fabric. If it is advertising, it is discoverable for a Matter controller to start the Matter commissioning over Bluetooth LE.
The commissioning procedure is done over Bluetooth LE where a connection is setup between a Matter device and a Matter controller. This Matter controller takes the role of a commissioner. The commissioner needs to get information from the Matter device to start the commissioning. This information can be obtained by a QR code or from the serial output of the Matter device.
The final phase in the commissioning procedure is Thread provisioning. This involves sending the Thread network credentials over Bluetooth LE to the Matter device. Once this is done, the device joins the Thread network and communication with other Thread devices in the network can be achieved.
For a commissioning guide that makes use of the POSIX cli chip-tool, please refer to Commissioning Qorvo Matter device with POSIX CLI chip-tool
For a commissioning guide that makes use of the Google ecosystem, please refer to Commissioning a Qorvo Matter™ end device in the Google ecosystem.
For a commissioning guide that makes use of the Apple ecosytem, please refer to Commissioning a Qorvo Matter™ end device in the Apple ecosystem.