This example is used for a BLE-based device lock system using one Silicon Labs EFR32xG24 Explorer kit and various hardware components such as MikroE Fingerprint Click 2 (A-172-MRQ) and SparkFun Micro OLED Breakout (Qwiic). The system is using BLE for wireless communication. This example also is the foundation to develop a secure and convenient device system using biometric authentication (fingerprint) and LED display indication. The system will use BLE for wireless communication between the Silicon Labs board and the EFR connect mobile application.
-
GSDK v4.4.0
NOTE: Tested boards for working with this example:
| Board ID | Description |
|---|---|
| BRD2703A | EFR32xG24 Explorer Kit - XG24-EK2703A |
| BRD4314A | BGM220 Bluetooth Module Explorer Kit - BGM220-EK4314A |
| BRD4108A | BG22 Bluetooth SoC Explorer Kit - BG22-EK4108A |
The following picture shows the system view of how it works.
The SparkFun OLED Display board can be easily connected to the EFR32 xG24 Explorer Kit by using a Qwiic cable. The Fingerprint 2 Click connects to the EFR32xG24 Explorer Kit using USART via MikroE connection.
To test this application, you can either create a project based on an example project or start with a "Bluetooth - SoC Empty" project based on your hardware.
-
From the Launcher Home, add your hardware to My Products, click on it, and click on the EXAMPLE PROJECTS & DEMOS tab. Find the example project with filter "door lock fingerprint".
-
Click Create button on the Bluetooth - Door Lock Fingerprint (A-172-MRQ) example. Example project creation dialog pops up -> click Create and Finish and Project should be generated.
-
Build and flash this example to the board.
-
Create a Bluetooth - SoC Empty project for your hardware using Simplicity Studio 5.
-
Copy all attached files in inc and src folders into the project root folder (overwriting existing).
-
Import the GATT configuration:
-
Open the .slcp file in the project.
-
Select the CONFIGURATION TOOLS tab and open the Bluetooth GATT Configurator.
-
Find the Import button and import the attached gatt_configuration.btconf file.
-
Save the GATT configuration (ctrl-s).
-
-
Open the .slcp file. Select the SOFTWARE COMPONENTS tab and install the software components:
-
[Services] → [IO Stream] → [IO Stream: EUSART] → default instance name: vcom
-
[Services] → [IO Stream] → [IO Stream: USART] → default instance name: mikroe
-
[Application] → [Utility] → [Log]
-
[Platform] → [Driver] → [LED] → [Simple LED] → default instance name: lock. Then, configure pin as bellow:
-
[Third Party Hardware Drivers] → [SparkFun] → [Human Machine Interface] → [A-172-MRQ - Fingerprint 2 Click (Mikroe)]
-
[Third Party Hardware Drivers] → [SparkFun] → [Display & LED] → [SSD1306 - Micro OLED Breakout (SparkFun) - I2C]
-
[Third Party Hardware Drivers] → [Services] → [GLIB Graphics Library]
-
-
Build and flash the project to your device.
Note:
-
Make sure that the SDK extension already be installed and this repository is added to Preferences > Simplicity Studio > External Repos.
-
Do not forget to flash a bootloader to your board, see Bootloader for more information
Advertisement Packet Device name: FINGERPRINT DOORLOCK
GATT Database:
-
Device name: FINGERPRINT DOORLOCK
-
[Service]: Fingerprint Door Lock
- [Char] Mode
- [R] Get mode value.
- [W] Set operation mode (0 - normal, 1 - register, remove, 2 - show).
- [Char] Remove Authorized Fingerprint
- [W] Provide authorized fingerprint ID to remove it from the authorized fingerprints.
- [Char] Get Fingerprint ID
- [W] Select the index.
- [R] Provide the status of the index (EMPTY or EXISTS).
- [Char] Open Lock
- [W] Write 1 to open lock.
- [Char] Mode
In normal mode, the OLED displays the BLE connection status (CONNECTED or DISCONNECTED) as well as the door status (LOCKED or UNLOCKED). If the door is unlocked by a user's fingerprint, the screen will display the index of this fingerprint.
In configuration mode 1, the OLED will show "CONFIG" on the screen and the number of fingerprints that have already been authorized. There are two methods in this mode:
-
When the user adds the new fingerprint, the screen will show the "ADDED" label and the index of this fingerprint.
-
Otherwise, when the fingerprint is removed by the user, the OLDE will show the "REMOVED" label and the index of the removed fingerprint, which was stored on the Fingerprint 2 Click board and NVM memory.
In configuration mode 2, if the fingerprints were stored in NVM memory and on the Fingerprint 2 Click board, the OLED would show the index of each fingerprint in 4 seconds. If do not have any authorized fingerprints, the OLED will show "-" and "NO FPs".
You can use a smartphone application, such as the EFR Connect application on your phone, to connect to the board. Following some steps as below:
-
Open the EFR Connect app.
-
Open the Bluetooth Browser.
-
Find the device advertising as FINGERPRINT DOORLOCK.
-
Click on Connect button.
Upon reset, the application will display the Silicon Labs logo on the OLED screen for a few seconds. After the firmware is configured, the device starts in normal mode. In this state, it starts advertising devices. Open your terminal emulator and connect to your client device over its serial port. Set baudrate to 115200. A similar output as below:
When you place your finger on the sensor in normal mode, the system compares your fingerprint and returns the result. Please see the terminal output as follows:
In configuration mode 1, you can get the index of authorized fingerprints by reading Get Fingerprint ID characteristic. After that, you can delete the fingerprint that you no longer use. The terminal output is as follows:
Moreover, in this mode, when you place the new finger, that is not authorized. The system will then assist you in registering this fingerprint if it has enough storage space. The terminal output is as follows:
The OLED screen will show the index of the authorized fingerprints. Please take a look at the picture in the paragraph marked Display.