Giter VIP home page Giter VIP logo

enviromonitor / enviromonitorstation Goto Github PK

View Code? Open in Web Editor NEW
81.0 22.0 11.0 2.28 MB

Arduino compatible software for ESP8266 based environmental monitoring station. Includes temperature, humidity, barometric pressure and PM2.5, PM10 dust monitoring

License: GNU General Public License v3.0

Arduino 73.15% C++ 26.85%
esp8266 esp8266-arduino smog monitoring-station environmental-monitoring temperature air humidity sensor pm25

enviromonitorstation's Introduction

EnviroMonitorStation

EnviroMonitorStation (part of Smogly aka EnviroMonitor project) is an ESP8266 based, outdoor environmental monitoring station. It includes temperature, humidity, barometric pressure and most importantly, PM2.5, PM10 dust monitoring.

Features:

  • PM1.0, PM2.5, PM10 monitoring
  • temperature, humidity, barometric pressure monitoring
  • heater for exsiccating incoming air for better results in humid conditions (e.g. during autumn and winter)
  • post data to custom backend
  • post data to Wunderground
  • OTA updates for software
  • WiFi auto configuration
  • 12V/5V powered

Currently EnviroMonitor station is DIY project, we don't provide ability to buy monitoring station, you need to build it yourself. We also designed PCB and enclosure so you can easily build your own sensor. Moreover - every piece of the project is Open Source, so you can modify it for your needs.

Please stay tuned, this is work in progress. Prototypes are being tested and we will post usable software and HW design soon.

Hardware

Bill of Materials

Below is the list of parts you will need to build monitoring station:

  • Wemos D1 mini ESP8266 based development board (example: https://goo.gl/nk0Xvn)
  • PMS3003 - Plantower particulate matter sensor detecting PM1.0, PM2.5, PM10 (example: https://goo.gl/ZB6P51)
  • BME280 - barometric pressure, temperature and humidity sensor (example: https://goo.gl/bCfaJp)
  • Si7021 temperature and humidity sensors (example: https://goo.gl/RCU0Vk)
  • DHT22 temperature and humidity sensors (example: https://goo.gl/guQqyB)
  • 12V or 5V heat plate (example: https://goo.gl/Pexr5R)
  • DC-DC step down power supply module, preferably based on LM2596 (example: https://goo.gl/TbNs1Y)
  • AC power supply with 12V DC 1A output (example: https://goo.gl/fVu5LT)
  • N-MOSFET, example: AUIRLZ44Z
  • 2.54 pitch male pin headers: 2 x 8 pins (Wemos connectors, usually included with Wemos), 1 x 6 pins (PMS3003 connector), 3 x 3 pins (DS, DHT and HEAT DC switch), 1 x 4 pins (I2C bus)
  • 2.54 ptich female pin headers: 2 x 8 pins for wemos socket, 1 x 6 pin (to solder instead of original PMS3003 plug)
  • 3 x 3.5 mm pitch 2 pin screw terminals
  • resistors: 1 x 4.7 kΩ, 1 x 47 kΩ, 1 x 1 kΩ
  • PCB
  • enclosure

Software

Backend configuration

Before sensor is added to the system, it needs to be registered on the backend side. After registration you will receive couple of parameters:

  • sensor ID - used to identify the sensor
  • API key - to be able to post and receive data from backend

Sensor configuration

After sensor is connected to power, it start local AccessPoint for initial configuration. User needs to connect to this AccessPoint and as a next step, familiar HotSpot configuration page should be presented. Using this simple page user can configure:

  • sensor ID (generated during sensor registration)
  • API access key (generated during sensor registration)
  • WiFi network and password to use for sending data
  • backend and OTA server address

Once you finish configuration, sensor will reboot, and join configured WiFi network. If there was any error , e.g. wrong password, sensor will again reboot into AccessPoint mode, so you are able to correct configuration.

How we measure parameters

In every cycle device measures couple of parameters and sends them to EnviroMonitorWe backend. In current version of hardware we measure:

  • PM1.0, PM2.5 and PM10
  • external temperature and humidity
  • external barometric pressure
  • temperature and humidity of air incoming to PMS3003 sensor

Before we start measuring PM* parameters, we ensure that incoming air is of accepted parameters: it's humidity and temperature are acceptable. This is required because humid air particles have size similar to PM1 and PM2.5 and can impact precision of measurement. To overcome this effect one could try to figure out how humidity and temperature impacts the measurement (develop mathematical function) or heat the air. We decided to incorporate heating plate near PMS3003 air intake.

Once the air reaches accepted humidity level, we start PM* measurement. Raw data is then sent to backend using simple HTTP GET call. For every monitoring station we can apply individual calibration functions before data is presented.

Software updates

Every sensor can be updated over-the-air. Once a day sensor sends special request to backend asking for new compiled software image. Using combination of hardware versions and software version for given hardware backend decides to send new image to sensor over HTTP. Before applying new image we launch pre-update functions ensuring that even if update goes wrong, sensor is safe, e.g. we switch off the heater. Once the update is successful, we use post-update function to get back all sensor features.

Development

EnviroMonitor project is developed as a community and open source / open hardware project. We use Github for all the development workflow. EnviroMonitorStation is Arduino based project, but we use PlatformIO development environment. Please follow PlatformIO getting started guide to set up your environment. We try too keep our code Arduino compatible, so it's possible to use Arduino IDE for development, but we strongly recommend using PlatformIO.

enviromonitorstation's People

Contributors

justi avatar khasinski avatar lechup avatar pim avatar zen avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

enviromonitorstation's Issues

Add external reset button for ESP

ESP8266 is very sensitive for power drops, in some cases it would hang and the only way to reset is using HW button. This button should be added to the project and put on the enclosure for better access

Add support for HTTP OTA updates

Sensor should be able to request new firmware through HTTP OTA procedure.
There should be pre- and post-update actions, specifically turn off the heater.
Sensor should send following data to the server:

  • hw_version
  • sw_version
  • devel (tree or false) - for development type of firmware

Server will decide if there is a new firmware based on hw_version (denoting firmware line) and sw_version (using semver naming).

Add station WiFi autoconfiguration

While WiFi setting are not provided, station should switch into AccessPoint mode and provide captive portal asking user for:

  • AP name
  • AP password
  • backend URL
  • backend access token
  • other?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.