GP v30 04: Particle Matter Sensor
This is the basic code to manage and read the particle sensor.
Required Materials
1 x Waspmote 1 x Battery 1 x Gases PRO board v30 1 x Particle matter sensor
Notes
- Remember to connect the battery to Waspmote for proper operation. - The connection of the sensor is described in the Gases PRO v30 technical guide.
Code
/*
* ------------ [GP_v30_04] - Particle Matter Sensor --------------
*
* Explanation: This is a complete code to manage and read the particle
* sensor.
*
* Copyright (C) 2018 Libelium Comunicaciones Distribuidas S.L.
* http://www.libelium.com
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* Version: 3.1
* Design: David Gascón
* Implementation: Isabel Burillo
*/
#include <WaspPM.h>
#include <WaspFrame.h>
/*
* P&S! Possibilities for this sensor:
* - SOCKET_D
*/
char info_string[61];
char serial_number[61];
int status;
int measure;
void setup()
{
USB.println(F("Particle Matter Sensor example"));
// switch on sensor
status = PM.ON();
// check answer
if (status == 1)
{
// get info from sensor
status = PM.getInfoString(info_string);
if (status == 1)
{
USB.println(F("Information string extracted:"));
USB.println(info_string);
}
else
{
USB.println(F("Error reading the particle sensor"));
}
// read serial number from sensor. That funtion isn't avalable for OPC-N2 sensor
status = PM.readSerialNumber(serial_number);
if (status == 1)
{
USB.print(F("Serial number: "));
USB.println(serial_number);
}
else
{
USB.println(F("Error reading the serial number"));
}
// switch off sensor
PM.OFF();
}
else
{
USB.println(F("Error starting the particle sensor"));
}
}
void loop()
{
///////////////////////////////////////////
// 1. Turn on the sensor
///////////////////////////////////////////
// Power on the PM sensor
status = PM.ON();
// check answer
if (status == 1)
{
USB.println(F("Particle sensor started"));
}
else
{
USB.println(F("Error starting the particle sensor"));
}
///////////////////////////////////////////
// 2. Read sensor
///////////////////////////////////////////
if (status == 1)
{
// Power the fan and the laser and perform a measure of 5 seconds
measure = PM.getPM(5000, 5000);
// check answer
if (measure == 1)
{
USB.println(F("Measure performed"));
USB.print(F("PM 1: "));
USB.printFloat(PM._PM1, 3);
USB.println(F(" ug/m3"));
USB.print(F("PM 2.5: "));
USB.printFloat(PM._PM2_5, 3);
USB.println(F(" ug/m3"));
USB.print(F("PM 10: "));
USB.printFloat(PM._PM10, 3);
USB.println(F(" ug/m3"));
USB.print(F("Temp: "));
USB.print(PM._temp);
USB.println(F(" ºC"));
USB.print(F("Hum: "));
USB.print(PM._hum);
USB.println(F(" %RH"));
USB.print("Bin: ");
for (int i = 0; i < 24; i++)
{
USB.print(PM._bin[i]);
USB.print(";");
}
USB.println();
}
else
{
USB.print(F("Error performing the measure. Error code:"));
USB.println(measure, DEC);
}
}
///////////////////////////////////////////
// 3. Turn off the sensor
///////////////////////////////////////////
// Power off the PM sensor. If there aren't other sensors powered,
// turn off the board automatically
PM.OFF();
///////////////////////////////////////////
// 4. Create ASCII frame
///////////////////////////////////////////
if (measure == 1)
{
// Create new frame (ASCII)
frame.createFrame(ASCII);
// Add sensor values
frame.addSensor(SENSOR_GASES_PRO_PM1, PM._PM1);
frame.addSensor(SENSOR_GASES_PRO_PM2_5, PM._PM2_5);
frame.addSensor(SENSOR_GASES_PRO_PM10, PM._PM10);
frame.addSensor(SENSOR_GASES_PRO_TC, PM._temp);
frame.addSensor(SENSOR_GASES_PRO_HUM, PM._hum);
// Show the frame
frame.showFrame();
// Create new frame (ASCII)
frame.createFrame(ASCII);
// Add first 16 bins
frame.addSensor(SENSOR_GASES_PRO_PM_BINL, PM._binL);
// Add last 8 bins
frame.addSensor(SENSOR_GASES_PRO_PM_BINH, PM._binH);
// Show the frame
frame.showFrame();
}
///////////////////////////////////////////
// 5. Sleep
///////////////////////////////////////////
// Go to deepsleep
// After 3 minutes, Waspmote wakes up thanks to the RTC Alarm
PWR.deepSleep("00:00:03:00", RTC_OFFSET, RTC_ALM1_MODE1, ALL_OFF);
}Output
J#
Particle Matter Sensor example
Information string extracted:
OPC-N3 Iss1.1 FirmwareVer=1.17............................
Serial number: OPC-N3 177470907
Particle sensor started
Measure performed
PM 1: 1.360 ug/m3
PM 2.5: 3.300 ug/m3
PM 10: 10.230 ug/m3
Temp: 23.5199985504 ºC
Hum: 32.9699974060 %RH
Bin: 264;44;19;3;3;2;2;0;2;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;
===============================
Current ASCII Frame:
Length: 87
Frame Type: 134
frame (HEX):
3C3D3E86052332313439364630353743313035344444234F50435F4E33233023504D313A312E3336303023504D325F353A332E3330303023504D31303A31302E323330302354433A32332E35322348554D3A33332E3023
frame (STR):
<=>�#21496F057C1054DD#OPC_N3#0#PM1:1.3600#PM2_5:3.3000#PM10:10.2300#TC:23.52#HUM:33.0#
===============================
===============================
Current ASCII Frame:
Length: 100
Frame Type: 134
frame (HEX): 3C3D3E86022332313439364630353743313035344444234F50435F4E33233123504D5F42494E4C3A3236343B34343B31393B333B333B323B323B303B323B303B303B303B303B303B303B3023504D5F42494E483A303B303B303B303B303B303B303B3023
frame (STR):
<=>�#21496F057C1054DD#OPC_N3#1#PM_BINL:264;44;19;3;3;2;2;0;2;0;0;0;0;0;0;0#PM_BINH:0;0;0;0;0;0;0;0#
===============================Last updated