CanAirIO - Citizen science air quality network
Description
[![PlatformIO](https://github.com/hpsaturn/CanAirIO/workflows/PlatformIO/badge.svg)](https://github.com/hpsaturn/CanAirIO/actions/) [![Build Status](https://travis-ci.com/hpsaturn/CanAirIO.svg?branch=master)](https://travis-ci.com/hpsaturn/CanAirIO) ![ViewCount](https://views.whatilearened.today/views/github/kike-canaries/canairio_firmware.svg) [![Liberapay Status](http://img.shields.io/liberapay/receives/CanAirIO.svg?logo=liberapay)](https://liberapay.com/CanAirIO) # CanAirIO Citizen science project with mobile and fixed sensors for measuring air quality (PM 2.5) using low-cost sensors and smartphones. Built with a `ESP32` module board and some dust sensor, like Sensirion, Panasonic, Honeywell and Samsung interfaced with an [CanAirIO Android app](https://github.com/kike-canaries/canairio_android#canairio-air-quality-reporter). <a href="https://play.google.com/store/apps/details?id=hpsaturn.pollutionreporter" target="_blank"><img width="120" src="screenshots/gplayicon.png"></a> This repo is a TTGO version of CanAirIO that supports two Air Quality sensors: - [x] Panasonic PM Sensor - [x] Bosch BME680 VOC sensor for IAQ. **Warnning**: it is a alternative to [CanAirIO firmware](https://github.com/kike-canaries/canairio_firmware#canairio-firmware) # Android CanAirIO App 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 continuous development then please any feedback, report errors, or any thing please let us know it via: | | | |----------------------------|-------------------------------| | Contact form | [CanAir.io page](http://canair.io/#three) | | Group support | [Telegram support](https://t.me/canairio) | | Issues and errors | [Github issues](https://github.com/hpsaturn/CanAirIO/issues) | | Community | [CanAirIO foro](https://foro.canair.io/) | | Firmware & App | [Releases](https://github.com/hpsaturn/CanAirIO/releases) | Firmware other boards | [Releases](https://github.com/kike-canaries/canairio_firmware/releases) | Android App | [GooglePlay](https://play.google.com/store/apps/details?id=hpsaturn.pollutionreporter) | | | | --- ## If you want invite me a coffee in: https://hpsaturn.com/about/ https://paypal.me/hpsaturn ### Or support my initiative CanAir.IO Citizen network for monitoring air quality https://canair.io --- 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 <a href="https://github.com/kike-canaries/esp32-hpma115s0/blob/master/images/device_connection.jpg" target="_blank"><img src="https://raw.githubusercontent.com/kike-canaries/esp32-hpma115s0/master/images/device_connection.jpg" width="512" align="center" ></a> ## Recording track and share <a href="https://github.com/kike-canaries/esp32-hpma115s0/blob/master/images/app_track_record.jpg" target="_blank"><img src="https://raw.githubusercontent.com/kike-canaries/esp32-hpma115s0/master/images/app_track_record.jpg" width="512" align="center" ></a> **NOTE**: Also all recorded tracks will be saved in the `/sdcard/canairio/` directory on `json` format. # Fixed Station Mode <img width="600" src="https://raw.githubusercontent.com/hpsaturn/CanAirIO/master/screenshots/influxdb_grafana.jpg"> 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 initial settings, after that the device could be publish data without the phone. For this you need configure it in `settings` section: ## Settings <img align="right" width="300" src="https://raw.githubusercontent.com/hpsaturn/CanAirIO/master/screenshots/canairio_app_settings.png"> - **Station Name**: for example: `PM25_Berlin_Pankow` - **Wifi Name and Password**: - Your Wifi network credentials. - Save the credentials with the switch. - **InfluxDB Cloud**: add the next values, - Database name: `canairio` - Hostname: `influxdb.canair.io` - Save the settings with the switch. The data will be configured and showed in [CanAirIO Grafana Server](https://bit.ly/3bLpz0H) # Electronic components <img width="400" src="https://raw.githubusercontent.com/hpsaturn/CanAirIO/master/docs/schematic.jpg"> | **Description** | **Alternative store link** | |----------------------------|-------------------------------| | TTGO T-Display |[AliExpress option](https://bit.ly/2z21vti) | | Panasonic SN-GCJA5 |[Mouser international option](https://bit.ly/3bMmRYC) | | Bosch BME680 |[AliExpress option](https://bit.ly/2LIB0eR) | | DC-DC Booster ** |[AliExpress option](https://bit.ly/2LMm7Ip) | | Lipo Battery 3.7 *** |[Amazon option](https://amzn.to/2FtzE5c)| | | | *** Any lipo battery with max size: 25x48x8 mm aprox. Please see the 3D box model. The battery in the link has 8.8x47x19.7 mm and is the ~500mAh. # 3D Print box ```bash ArtilleryGenius_Cura_project.3mf # Project for Ultimaker Cura slicer software (optional). CanAirIO_3dBox_body.stl # Main body for sensors and TTGO T-Display board. CanAirIO_3dBox_cap.stl # Body cap with holes for air input/output. CanAirIO_Logo_canary.stl # Optional CanAirIO logo. CanAirIO_Logo_cloud.stl # Optional CanAirIO logo cloud. ``` <img width="512" src="https://raw.githubusercontent.com/kike-canaries/CanAirIO/master/screenshots/3dbox_models.jpg">
Statistics
Likes
11
Downloads
0