Qorvo® QPG6105 Matter lock example shows how to create a remotely controlled Matter lock, 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 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 Qorvo IoT Dev Kit for QPG6105:
SW6 (RADIO RESET): 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) (if not already commissioned in a fabric)
- 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: 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 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 lock 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 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.