Tag Archives: arduino

Trinket Air Quality Sensor

Source code is on GitHub. Ceramic cap is 104M, base resistor is 500 ohms, switch resistor is 1k. Electrolytic is 47 micro-farads

With the recent wildfires here in California and the on-going Covid crisis making us all stay indoors, indoor air quality has become a very important consideration. Working in a back bedroom all day can subject you to some bad air. Mostly volatile organic compounds — you know the stuff that smells — can build up and make a room unhealthy.

What I want, ultimately, is to monitor the indoor and outdoor air quality and generate alerts and run automation to deal with bad air. This sensor project is a key component for indoor air quality monitoring. But I wanted the sensor to provide some limited stand-alone functionality. By using the trinket’s dot star, a piezo buzzer and a button some basic functionality can be implemented.

The dot star on the Trinket serves as a visual indicator of the 10-minute rolling average of both pm 2.5 and eCo2 levels. Steady on is the current level of co2 — green, yellow, orange, red, purple, maroon. Flashing on is the current level of pm 2.5.

The levels are set as follows:

eCo2

WARNING COLORLEVEL ECO2
green< 1000 ppm
yellow< 1500 ppm
orange< 2000 ppm
red< 3000 ppm
purple< 5000 ppm
maroon> 5000 ppm

If enabled the alert will sound on orange and above. Solid on led displays eCO2 level.

pm 2.5

WARNING LEVELPM2.5 PPB
green< 12.1
yellow< 35.4
orange< 55.4
red< 150.4
purple< 250.4
maroon> 250.4

Blinking dot star is showing the pm25 warning level.

The button has 3 functions. If the alert is sounding 1 press will cancel it. Double click will toggle the alert buzzer on or off. Default is off. There is an increasing or decreasing tone to denote which happened. So, a hi to low tone means the alert is off. A long press will set the brightness of the dotstar. Default brightness is 90%. These settings revert to defaults on reset/power on.

A buzzer provides audible feedback of button presses and alerts. If enabled an alert tone will sound for 1 minute when a level goes above level 2 for either monitored compound.

The CCS811 measures VOCs that are normally found in indoor environments and provides an equivalent CO2 level. VOC levels vary by the atomic weight of the compound in question, so it is hard to pin down levels that require actions to be taken. But CO2 has well defined levels (such as this) that can be used for triggers.

For pm 2.5 measurement I chose the PMSA003I sensor. Adafruit sells this sensor on a breakout board which would be the way to go if you can get them. Otherwise you will need to either solder some wires on the very fine pitch connector Adafruit includes or you can use a swd breakout connector and a cable like I did. You will need to use a dremel to cut the connector to fit the PMSA003I. It’s really easy:

Start with this

Grind it down to this. The key has to go.

Ready for test. Can be glued and mounted as is or moved to another board.

A BME280 completes the package. The temperature and humidity are passed to the CCS811 to compensate for the measurements.

This is sort of a stew — the project takes advantage of components I had on hand as much as possible. If I were buying all the parts for this I would probably go with a BME680 and reduce the component count.

To utilize the project as a sensor for an HVAC system, we connect to it via the USB serial port. Command Messenger is used to pass messages to the device and retrieve data from the device. A python app is included that can help set measurement offsets and monitor data. It requires PyCmdMessenger. Data can be retrieved from the device in json format:

See the python source to see how offsets can be set for sensor readings. These are stored in flash when changed and will be valid after restarts.

The Arduino code is set up as a Platform.io project. Change trinket_aqs.cpp to trinket_aqs.ino to use in Arduino ide. See the source for required libraries.

Using Ohmite Force sensitive potentiometers.

Force sensing potentiometers offer an alternative to mechanical potentiometers and rotary encoders. These devices do away the mechanical action of the switch and instead offer a touch sensitive alternative. After looking around the web I was not able to find a suitable library for implementing these devices so I ended up creating my own for Arduino.

The libraries implement functionality for Ohmite’s FSP series of devices. The devices include one round sensor (FPS03CE), and two linear devices (FSP01CE and FSP02CE). The linear devices come in two lengths.

All devices are single touch. This means that you can only detect one touch location on the device at a time. If we tried to detect a finger on each end of a linear device it would register as being in the middle.

For all devices the force is reported as voltage. Generally 3.2 volts is the highest we will see on a 3.3 volt system. The position is reported as an integer. For the FPS03CE the integer represents 0 to 360 degrees from the tail (connector) of the device. For the linear devices it is 0 to 100 mm for the FSP01CE and 0 to 55 mm for the FSP02CE. Default for the two linear devices is for zero at the tail, but the call to position command can take a parameter to return with 0 at the head end of the device.

Integration Guide:

I was only able to find one source for the integration guide — this pdf at Mouser. It is pretty comprehensive, but contains a couple of errors that an integrator should be aware of.

First: In the section for FSP0(1/2)CE on page 4

This section from the integration guide specifies V2 as an analog input. It does not need to be.

The document specifies that V2 should be an ADC pin. In measuring the force and position I have not read an Analog value from there. Not a show stopper, but there is no need to tie up an analog input unnecessarily. I changed this to a digital input and these sensors work correctly.

Second: In the section for FSP03CE on page 7:

This table for the FSP03CE pinout is not correct.

Using Figure 10: Pin 4 is actually the wiper pin, while pin 1 is the third drive electrode. Plus the Pin name for pin 2 is incorrect. Luckily this diagram makes it clear where the connections go.

From the integration guide.

Hook up:

Refer to this diagram when hooking up one the FSP devices.

Use this schematic when wiring up one of the FSP devices. VRef will use a digital I/O

Each device requires one analog input and multiple digital I/O lines. I used 22K for the FSP03CE voltage divider and 18K for both the linear variants. All are 1/4 watt 5%. VRef will use a digital I/O line. These resistor values worked for my application. The sensitivity of response to touch is affected by these values. This is detailed in the integration guide.

Arduino:
#include "M2aglabs_Ohmite.h"

//Set this to the one the Arduino uses
#define ANALOG_RESOLUTION 12
#define LINEAR_THRESHOLD  0.3
#define ROUND_THRESHOLD  0.3

/*
     Round sensor
     WIPER, VREF, D0, D120, D240
     Linear Sensor
     WIPER, VREF, V1, V2, true/false (Short or Long)
    WIPER and VREF are on two sides of a resistor. VREF floats for position measurements,
     PULLS low for force.

*/

M2aglabs_Ohmite roundSensor(A5, 0, 2, 1, 3);
M2aglabs_Ohmite lLinear(A2, 7, 6, 10, true);  //true means short
M2aglabs_Ohmite sLinear(A4, 5, 4, 9, false);  //false is long sensor

void setup() {
     Serial.begin(115200);
     /*
          The lib is set for a default of 10 for analog resolution and     3.3. for voltage. If the voltage is 5.0 set it here.

     */

     analogReadResolution(ANALOG_RESOLUTION);
     roundSensor.begin(ANALOG_RESOLUTION);
     sLinear.begin(ANALOG_RESOLUTION);
     lLinear.begin(ANALOG_RESOLUTION);

     //Set options --
     /*
     Serial.println(roundSensor.readRange());
     Serial.println(roundSensor.readRange(1500));
     Serial.println(roundSensor.zeroOffset());
     Serial.println(roundSensor.zeroOffset(500));
     */

}

void loop() {
     roundSensorActions();
     linearSensorActions();
}

void linearSensorActions() {

     int spos, lpos; //Position is an integer
     float fsp, flp; //Force is a float
     fsp = sLinear.getForce();
     if (fsp > LINEAR_THRESHOLD) {
          //False reads from tail to tip.
          spos = sLinear.getPosition(false);
          Serial.print("s: ");
          Serial.print(fsp);
          Serial.print(" : ");
          Serial.println(spos);
     }

     flp = lLinear.getForce();

     if (flp > LINEAR_THRESHOLD) {
          lpos = lLinear.getPosition(false);
          Serial.print("l: ");
          Serial.print(flp);
          Serial.print(" : ");
          Serial.println(lpos);

     }

}

void roundSensorActions() {

     //Get the force from the round sensor
     float force = roundSensor.getForce();
     //If it looks like we are touching it, calculate the position.

     if (force > ROUND_THRESHOLD) {
          Serial.print("force: ");
          Serial.print(force);
          int angle = roundSensor.getPosition();
          Serial.print(" raw angle: ");
          Serial.print(angle);
          angle = constrain(angle, 0, 360);
          Serial.print(" adjusted: ");
          Serial.println(angle);

     }

     return;

}

The function calls are documented in the header for the library.

Using the library:

Usage is fairly straightforward. The general steps are:

  • Instantiate the object
  • Call begin
  • Poll for force
  • If there is force applied read the position

The library has only been tested on a Metro M4, ItsyBitsy M4 and Raspberry Pi Pico to date. There is nothing that is SAMD specific so the Arduino library should work on other devices.

Two settings to be aware of are the _ZERO_OFFSET and _READ_RANGE. These affect each sensor’s overall range. The _ZERO_OFFSET specifies the normal zero reading of the ADC. With a finger at the 0 position of the sensor there is still a voltage present. Depending on the sensor, the voltage will be in the 200 to 800 millivolt range. If the sensor will not go to zero try adjusting this. For round sensors the 0’s are at 0 degrees (at the tail) then clockwise to 120 degrees, then 240. This is detailed in the integration guide.

Read range sets the maximum value of the voltage at the max end of the sensor. So if the lengths come out short, or max is hit before the end reached try adjusting this setting.

The library is available on github.

https://github.com/m2ag-labs/m2aglabs_ohmite