Qorvo's QPG6105 Matter lock example shows how to create a remotely controlled Matter lock, with Thread connectivity, using Matter. It is using Bluetooth LE to perform Matter provisioning. This example can be used as reference for creating your own Matter lock.
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 lock control (lock/unlock) using a Matter controller.
- Bluetooth LE for Matter commissioning procedure.
- Factory reset implementation.
This application uses following buttons of the DK board:
SW6[RADIORESET]: Used to perform a HW reset for the full boardSW4[PB1]: Used to Unlock/Lock the simulated lockSW5[PB4]: Used to perform, depending on the time the button is kept pressed,- Start Bluetooth LE advertising (released between 0-1.5s)
- Trigger Trigger OTA (released between 1.5-3s)
- Factory reset (released after 6s)
The buttons SW1, SW2, SW3 and the slider switch SW7 are unused.
The following LEDs are used during the application:
LD1- White cool led: Status LED simulating the lock state- On - lock closed
- Off - lock open
- Blinking - lock moving to new state
LD4- RED led - shows the device state and its connectivity. Following states are defined:- Short blink every 1s: Bluetooth LE advertising. The device is not commissioned yet.
- Fast blinks: Bluetooth LE connected and subscribed but not yet commissioned.
- On: Full service connectivity
Factory reset of the Matter lock can be triggered by holding SW5 at least 6 seconds.
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 Lock-app Launching
[P][-] ============================
See Building and flashing the example applications section to get instructions how to build and program the Matter base example application.
The Matter lock will not start Bluetooth LE™ advertising automatically at start-up so a manual action is needed for this. Refer to the section Button control to understand how to start advertising. Once it is advertising, it is discoverable for a Matter controller to start the Matter commissioning.
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 Android chip-tool, please refer to Commissioning Qorvo Matter device with Android chip-tool
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