Skip to content

Latest commit

 

History

History
 
 

bluetooth_co_monitor

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

Bluetooth - CO Monitor (MQ7)

Summary

This project aims to implement a CO application using Silabs development kits and external sensors integrated with the BLE wireless stack. It can be used to monitor and track carbon monoxide levels in various environments. Users can use this system for monitoring CO levels in offices, warehouses, factories...The wireless CO system incorporates an MQ7 sensor and client devices. The sensor periodically measures the CO level and advertises the processed CO level value to the client devices.

Sensor:

The sensor device is an EFR32 xG24 Explorer Kit connected to a Mikroe CO Click sensor board. This device periodically measures the CO level and advertises the processed CO level value to the client devices.

The advertisement package contains a measurement counter value and the processed CO level in ppm.

Client:

The client device is an EFR32 xG24 Explorer Kit connected to a BUZZ 2 Click buzzer and a Sparkfun Micro OLED Display. This device provides two operational modes.

If the BTN0 is pressed during the initialization sequence then the application boots into the configuration mode. In this operational mode, the device sends normal advertisement packages and is connectable to other BLE devices. Users can connect to the client via the EFR Connect mobile application. This mode provides BLE characteristics to configure the volume of the connected buzzer, the CO alarm threshold level, and notification status.

If the BTN0 is released during the initialization phase, the application starts scanning the BLE network. The application periodically scans the BLE network looking for a sensor device. The application logic and display updating features are invoked when a sensor device is found and receives at least five advertisement packages from it and each package has different sample counter values.

Gecko SDK Suite version

Hardware Required

Sensor:

Client:

NOTE: Tested boards for working with this example:

Board ID Description
BRD2703A EFR32xG24 Explorer Kit - XG24-EK2703A
BRD4108A BG22 Bluetooth SoC Explorer Kit - BG22-EK4108A
BRD4314A BGM220 Bluetooth Module Explorer Kit - BGM220-EK4314A

Connections Required

The hardware connection is shown in the image below:

hardware connection

Sensor:

The CO click board can be easily connected to the EFR32 xG24 Explorer Kit via a MikroE connection.

Client:

The Sparkfun OLED Display board can be easily connected to the EFR32 xG24 Explorer Kit by using a Qwiic cable. The Buzzer 2 Click connects to the EFR32 xG24 Explorer Kit using PWM via a MikroE connection.

Setup

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.

Create a project based on an example project

  1. 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 the filter "co".

  2. Click Create button on both Bluetooth - CO Monitor (MQ7) - Client and Bluetooth - CO Monitor (MQ7) - Sensor examples. Example project creation dialog pops up -> click Create and Finish and Project should be generated. board

  3. Build and flash this example to the board.

Start with a "Bluetooth - SoC Empty" project

  1. Create a Bluetooth - SoC Empty project for your hardware using Simplicity Studio 5.

  2. copy all the .h and .c files to the following directory of the project root folder (overwriting existing file).

  3. Install the software components:

    • Open the .slcp file in the project.

    • Select the SOFTWARE COMPONENTS tab.

    • Install the following components for sensor device:

      • [Application] → [Service] → [Simple timer service]
      • [Services] → [IO Stream] → [IO Stream: USART] → default instance name: vcom
      • [Application] → [Utility] → [Log]
      • [Third Party] → [Tiny printf]
      • [Third Party Hardware Drivers] → [Sensors] → [MQ7 - CO Click (Mikroe)]
    • Install the following components for client device:

      • [Services] → [NVM3] → NVM3 Core
      • [Services] → [NVM3] → NVM3 Default Instance
      • [Services] → [IO Stream] → [IO Stream: USART] → default instance name: vcom
      • [Application] → [Utility] → [Log]
      • [Third Party] → [Tiny printf]
      • [Platform] → [Driver] → [Button] → [Simple Button] → default instance name: btn0
      • [Platform] → [Driver] → [I2C] → [I2CSPM] → default instance name: qwiic
      • [Platform] → [Driver] → [PWM] → [PWM] → default instance name: mikroe
      • [Third Party Hardware Drivers] → [Display & LED] → [SSD1306 - Micro OLED Breakout (Sparkfun) - I2C]
      • [Third Party Hardware Drivers] → [Audio & Voice] → [CMT_8540S_SMT - Buzz 2 Click (Mikroe)]
      • [Third Party Hardware Drivers] → [Services] → [GLIB - OLED Graphics Library]
  4. Import the GATT configuration:

    • Open the .slcp file in the project again.
    • Select the CONFIGURATION TOOLS tab and open the "Bluetooth GATT Configurator".
    • Find the Import button and import the gatt_configuration.btconf file.
    • Save the GATT configuration (ctrl-s).
  5. Build and flash this example to the board.

Note:

How it Works

Sensor

How to calibrate sensor

  • Note: Because the EFR32xG24 Explorer Kit can only measure the voltage range from 0 V to 3.3 V, so you have to turn the rheostat on the CO click to 0 Ohm.

The graph below shows the dependence between Rs/R0 and the value of Ppm

Calib sensor

Datasheet has a graph for sensitivity characteristic, following the equation

ppm(Rs/R0) = coefficient_A * Rs/R0 ^ (coefficient_B) (*)

with

Rs means resistance in target gas with different concentrations.
R0 means resistance of sensor in clean air.

From the blue line, select 2 points and replace the above equation, you will be able to calculate coefficient A and coefficient B. You will calculate the value as follows:

coefficient_A = 0.14
coefficient_B = -2.26

The R0 is calculated by assuming clean air (approx 10 ppm of carbon monoxide) -- it is therefore best to perform this calibration outside. Place the sensor in a place where the air is clean and assume the value of carbon monoxide is 10ppm. Substituting into equation (*) you get the ratio Rs/R0. Then call the function mq7_read_rs to calculate Rs. From Rs and the ratio Rs/R0 you will be able to calculate R0.

Sensor overview

Application overview

Sensor Implementation

Application initialization:

Application init

On Timer callback:

This handler called when the timer expires in every configured process period time.

Application callback

Advertisement Packet:

AdvData field in the advertisement packet is as table below:

DeviceName SampleCounter COLevel
CO_S_< MAC unique 2 byte > 4 byte 4 byte
  • SampleCounter: Device increases the counter value for each new measurement
  • CoLevel: Calculated CO level in ppm
  • Device is not connectable. It sends manufacturer specific advertisement packets.

Client

Client overview

Application overview

Client GATT Database

Advertisement Packet Device name: CO_Client

GATT Database

  • Device name: CO_Client

  • [Service] CO Client

    • [Char] Threshold CO ppm
      • [R] Get alarm threshold value
      • [W] Set alarm threshold value - alarm_threshold (e.g.: 100 => 100 ppm)
    • [Char] Notification
      • [R] Get Notification Sound Status
      • [W] Set Notification Sound Status value - notification_status (0 - disabled, 1 - enabled)
    • [Char] Buzzer volume
      • [R] Get Buzzer volume
      • [W] Set Buzzer volume value (0 - 10)

Client Implementation

Application initialization:

Application init

Runtime - Configuration Mode:

Config mode

Runtime - Normal Mode:

Client events:

Client event

Event Handler:

co_monitor_callback is a function invoked periodically by the sleep timer service with the configured time period.

Client logic

BLE External Event Handler:

CO monitor event handler retrieves and processes the CO level data.

Client logic

CO Notification Event:

This function processes the measured values, checks the values against the configured thresholds.

If the measured value(s) are above the configured thresholds => the buzzer will be activated.

Client logic

Event Handler for button:

This event handler checks the BTN0's status. When the button is released, it checks the notification feature status, and buzzer state in accordance with the flowchart below.

Client logic

Display:

If the Client is in the configuration mode, the OLED will show threshold and status of Alarm (ON or OFF)

Configuration

If the Client is in the normal mode, the OLED will show CO level and threshold CO value

Display

Testing

Sensor:

You can use a smartphone application such as the EFR Connect application, to see the advertising packet from the Sender.

  • Open the EFR Connect application.

  • Open the Bluetooth Browser.

  • Find the device advertising as CO_S_<7a:57>.

  • Click on the instance of CO_S_<7a:57>. Now, you should see the counter and the CO ppm value on the Manufacturer Specific Data row. Please have a look at the red highlighted area below in the result pictures.

    Display

  • After flashing the code to the sensor board, a similar output from the serial terminal as shown below

    Sensor Log

Client:

  • 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 scanning advertising devices.

  • Open your terminal emulator and connect to your client device over its serial port. Set the baud rate to 115200. A similar output as below

    Client log

  • Note: Button PB0 should be pressed during startup (power-on or reset) to run the client in Configuration Mode. The terminal will display the information as below

    Consumer configuration