CanAir.io Air Quality Network

Description

CanAirIO is a citizen science project using mobile and fixed sensors to measure air quality with cell phones and low-cost technology.

This is an Open Source initiative that uses a ESP32 module and some air quality sensors, interfaced with an Android client app to have fixed (WiFi) or mobile (Bluetooth) air quality stations.

Details

CanAirio is a citizen science iniciative that not only aims to generate an air quality network of fixed monitoring stations, but also to measure what occurs with pedestrians, drivers and passengers in their daily lives considering that in some cities the highest density of affected people is moving. For this reason, we are developing a mobile application that is able to set a PM2.5 sensor, and other related sensors, as a fixed station using WiFi or mobile data from the smartphone by using a Bluetooth connection.

Air pollution is one of the biggest world wide problems we have been facing during the last years. For reference I’ll quote recent articles from research organizations such as NOAA and WHO.

Air pollution is the world’s largest single environmental health risk WHO
Airborne particulate matter (particles with diameters of 2.5 μm or less, known as a PM2.5) has consistently been shown to increase mortality and morbidity. Institute for Risk Assessment Sciences, Utrecht University
Carbon dioxide levels today are higher than at any point in at least the past 800,000 years NOAA
As urban air quality declines, the risk of stroke, heart disease, lung cancer, and chronic and acute respiratory diseases, including asthma, increases for the people who live in them. WHO

Those articles among many others and our daily lives experiences (which is becoming more and more contaminated during the past few years), lead us to design: A citizen science solution to monitor the air quality.

We are a community of open source activists with a wide range of skills on different knowledge fields. CanAir.io is one of our community citizen science projects, with the goal to contribute to the air quality index knowledge base. Not only to create air quality awareness and conscience on citizens, but also on the government which in some cases mislead pollution reports.

Files

rev468v0.3.1_signed20201116.apk

package-archive - 7.19 MB - 12/11/2020 at 10:48

Download

canairio_rev680_20201121.zip

Zip Archive - 5.60 MB - 12/11/2020 at 10:48

Download

d1miniv2box.zip

Laser cut box files (official stable) and 3dprint box files (alpha version)

Zip Archive - 814.19 kB - 09/20/2019 at 20:39

Download

Components

Project Logs

Collapse

CanAirIO Bike and CanAirIO CO2

Hpsaturn • 05/16/2021 at 18:50 • 0 comments

We are close to launching two new versions of CanAirIO device, the first one is a CanAirIO mobile version, "CanAirIO bike", the idea is to try to give an improved mobile version, for example to carry it in bicycles.

The second one, keeping in mind the COVID-19 risk on indoors, the idea is to launch a small device with a real CO2 sensor (NDIR sensor) to sense the right indoor environments.

New CanAirIO firmware easy loader

Hpsaturn • 03/20/2021 at 15:20 • 0 comments

We have a new CanAirIO easy uploader!!

With this simple Arduino sketch, you able to upload our firmware via Arduino IDE or via Arduino Droid (Android app), more details in:

https://github.com/hpsaturn/esp32-canairio-loader

Video step by step

[![Youtube CanAirIO basic loader guide]( "Youtube CanAirIO basic loader guide")

New CanAirIO Air Quality Sensors Library

Hpsaturn • 12/11/2020 at 11:03 • 0 comments

We released a new sensors library for PlatformIO and Arduino library managers. The idea with this libraries is handling some particle meter (PM) sensors, like Honeywell, Plantower, Panasonic, Sensirion, and others compatible with UART communication, also in the roadmap we could have i2c support. The library supports others environment sensors like AM2320, dht22, sht31, aht10, bme280 sensors too.

For example here, we showing auto-configuration feature with Panasonic and Sensirion sensors:

Source code: https://github.com/kike-canaries/canairio_sensorlib

New guide and some sensor alternatives

Hpsaturn • 08/24/2020 at 09:51 • 0 comments

We are working on test different sensors, because the first Honeywell sensor that we had it has some stability and electric noise issues.

We can know some alternatives, for example using a Panasonic sensor, in the next guides:

https://www.hackster.io/canairio/build-a-low-cost-air-quality-sensor-with-canairio-v2-1-d87494

And with 3d print box:

https://github.com/hpsaturn/CanAirIO

Build Instructions

Collapse

1

Overview Video Alternatives

Honeywell version (CanAirIO v2)

Panasonic version (CanAirIO v2.1)

Sensirion version (without soldering iron)

CanAirIO Bike version

 

CanAirIO IKEA Vindriktning sensor version
CanAirIO solar version (testing)
CanAirIO M5Stack devices
2
Upload CanAir.IO firmware
Installation alternatives
We have different alternatives for load the current firmware. In order of complexity they are:
Via CanAirIO Web Installer (RECOMMENDED)

If you already have a ESP32 board, you can test our CanAirIO firmware on one click, with our web installer:
Video and instructions here

Installation via CanAirIO loader

You will able to install the last version of CanAirIO firmware with internet updates via a simple Arduino sketch that it will doing all for you, you only need to use the official Arduino IDE or Arduino Droid for Android for load this simple sketch. Please follow the instructions here or follow the next YouTube video guide for Android OTG installation alternative.

Installation via binaries (Linux and MacOSx)

You can download the last firmware version in releases section. Download the last release from assets section in releases and please uncompress zip file.

USB alternative

Connect your CanAirIO device to your USB and execute the next command for your model board*, like this:
```
unzip canairio_rev414_20190829.zip
cd canairio_installer
./install.sh canairio_TTGO_T7_rev605_20200925.bin
```
For more options run ./canairio_installer help.

Note: you need python2 or python3 with pyserial in your system.

OTA alternative

After that you will able to send OTA updates to any board supported, like this:
```
./install.sh ota canairio_d1mini_rev414_20190829.bin
```
Also you can specify the IP address:
```
./install.sh ota canairio_xxx.bin 192.168.1.10
```
Windows

Please read procedure on firmware section on HacksterIO Guide for details for load firmware via oficial Espressif Download Tool in Windows

For build a firmware version please follow the README instructions on Github:

https://github.com/kike-canaries/canairio_firmware#optional-compiling-and-installing
3
Using CanAirIO app
Usage

For now you need any Android device with Bluetooth 4 or above. You can download the CanAirIO app from GooglePlay, keep in mind that it is in continuos development then please any feedback, report errors, or any thing please let us knowed it via our contact form or on our Telegram chat

You have two configuration options or modes of your CanAirIO device from the app:

Mobile Station Mode

For record tracks on your device (Sdcard) or publish it to the cloud (share), please follow the next steps:

Connection to device

Recording track and share

NOTE: Also all recorded tracks will be saved in the /sdcard/canairio/ directory on json format.

CanAirIO Mobile Map

We are developing a new mobile map, you can see the current tracks that the people share here:

Fixed Station Mode

Also, you can connect your CanAirIO device to the WiFi and leave this like a fixed station. In this mode you only need the Android app only for setup the initial settings, after that the device could be publish data without the phone using the WiFi. For this please download the CanAirIO app and setup the WiFi:

WiFi Setup
- Open the app and enter on settings section
- Choose the Wifi Name and set the Password (if it has)
- Save the credentials with the switch.
- Wait for connected status in the summary switch
Publication

After WiFi is ready, please follow the next steps for publish your fixed station:
- save Geohash location (turn on the switch for save, it will go to off after some seconds)
- enable the publication switch
- wait for some minutes, the device should be show data icon some times
- your station should be in our Global Map with the special ID showed in the last item of settings
CanAirIO fixed station (fast setup guide)

CanAirIO Documentation

We have a documentation portal with full information about the device and the app usage.

Supporting the project

If you want to contribute to the code or documentation, consider posting a bug report, feature request or a pull request.

When creating a pull request, we recommend that you do the following:
- Clone the repository
- Create a new branch for your fix or feature. For example, git checkout -b fix/my-fix or git checkout -b feat/my-feature.
- Run to any clang formatter if it is a code, for example using the vscode formatter. We are using Google style. More info here
- Document the PR description or code will be great
- Target your pull request to be merged with devel branch
Also you can consider make a donation, be a patron or buy a device:
- Via Ethereum:
- 0x1779cD3b85b6D8Cf1A5886B2CF5C53a0E072C108
- Be a patron: Github Sponsors, LiberaPay
- Buy a device: CanAirIO Bike in Tindie
- Inviting us a coffee: buymeacoffee, Sponsors
NOTE: Supporting our Citizen Science Initiative many people be able to fight for air quality rights in many countries with this kind of problems. More info in CanAir.IO