bmidgley / citizen-scientist

Everyone can participate in environmental data collection and analysis

citizen-scientist

Monitor air quality and automatically share the collected data using inexpensive hardware.

OpenWest slides show how to build the project, including slide 24 with wiring explanation.

Setup

Install arduino 1.8.2 or newer

Install serial driver from vendor drivers

Set up esp8266 runtime for arduino

Open geothunk.ino in arduino and select board. Tools->Board->NodeMCU 1.0 (ESP-12E Module)

Libraries: sketch->include library->manage libraries

• WiFiManager (0.14.x)
• ArduinoJson (5.x.x)
• PubSubClient (2.x.x)
• "ESP8266 and ESP32 Oled Driver for SSD1306 display" (4.x.x)
• Esp8266TrueRandom (wget https://github.com/marvinroger/ESP8266TrueRandom/archive/master.zip; sketch->include library->Add .zip Library)

Plug in board and choose the port. On mac: Tools->Port->/dev/cu.SLAB_USBtoUART (Reboot and check your USB cable is a full power+data cable if the port isn't available.)

Hit the upload button.

Reboot the board and use your phone to connect to the Geothunk-XXX access point. In the captive portal screen, set the password for your access point. Hit save. There is a youtube video to show this in practice.

If you're on the same access point as the sensor, you should be able to see graphs for your measurements by clicking its geothunk.local mdns link. If mdns isn't working or you have multiple sensors, point a browser at the IP address displayed on the device instead.

Register and agree to share your data with our agreement

Contributors

• Brad Midgley wrote the firmware and built the sensor
• Tim Harper updated the firmware with refactors, overflow protection, improved sensor listener
• Dorian Tolman designed the case

Parts:

• Esp8266 D-Duino
• DHT22 (3-wire package)
• PMS3003

citizen-scientist's Issues

Report to mqtt on a secure connection

Do not display a measurements before a successful reading

Display should just be blank in this spot

On-device graph should not compress smaller than 30 (similar to web graph)

Link on mdns page to the server with the uuid as a parameter

Get all devices in the field updated in firmware and installed in the new case

Put up web server and mqtt processor with mqtt.geothunk.com directed there

Flash LED in response to an alert message from the server

calculate aqi

https://diyprojects.io/calculate-air-quality-index-iaq-iqa-dsm501-arduino-esp8266/#.XlaV1xNKjBL

Generate a certificate for each sensor

WeMos DHT sensor regression with 7a0b17b

After upgrading my WeMos geothunk sensor (the one with the built-in display) to the latest master, I noted that the DHT temperature readings would fail frequently. I traced it down to commit 7a0b17b, specifically the following change:

diff --git a/geothunk/geothunk.ino b/geothunk/geothunk.ino
index d2b9a7e..99801b4 100644
--- a/geothunk/geothunk.ino
+++ b/geothunk/geothunk.ino
@@ -296,9 +296,27 @@ void paint_display(long now) {
   }
   display.setTextAlignment(TEXT_ALIGN_RIGHT);
   display.setFont(ArialMT_Plain_10);
-  display.drawString(display.getWidth(), 34, String("1/2/10=") + String(pm1) + String("/") + String(pm2_5) + String("/") + String(pm10));
-  display.drawString(display.getWidth(), 44, String(humidity) + String("%h"));
-  display.drawString(display.getWidth(), 54, String(temperature) + String("°C"));
+
+  String pmValues = String("1/2/10=");
+  String humidityString;
+  String temperatureString;
+
+  if (pmOverdue(now))
+    pmValues = pmValues + String("E/E/E");
+  else
+    pmValues = pmValues + String(pm1) + String("/") + String(pm2_5) + String("/") + String(pm10);
+
+  if (dhtOverdue(now)) {
+    humidityString = String("E");
+    temperatureString = String("E");
+  } else {
+    humidityString = String(humidity);
+    temperatureString = String(temperature);
+  }
+  display.drawString(display.getWidth(), 34, pmValues);
+  display.drawString(display.getWidth(), 44, humidityString + String("%h"));
+  display.drawString(display.getWidth(), 54, temperatureString + String("°C"));
+
   display.setTextAlignment(TEXT_ALIGN_LEFT);
   if (hours < 24)
     uptime = String(hours) + String("h");

Link to an online image from the sensor page

Add a param for the uuid so the server can detect the use of the page

Allow user to configure the mdns name

uuid-linked web page should report the device's registration status

Share data with http://aqandu.org/

Work with Dr. Kelly at the U to send our data to their server to visualize and analyze

Slow wifi connections time out and go into AP mode

If the wifi connection takes a long time or is unreliable, the device goes into AP mode. Combined with reset cycles causes the device to be unreliable.

There should be a way to lock the wifi or make a long timeout.

I think I'd prefer a configuration option to lock the wifi and never enter AP mode.

If the wifi is locked in via flash memory options, then the program button would be required to reset the wifi and get back into AP mode. This will have to work either when associated or when trying to get associated.

I'm not sure we can get into the wifimanager loop, but we could execute this using a connect timeout combined with a test for the button press if you don't mind holding the button for a while to reset it.

Report mdns name to dhcp server

Device reporting 4000+ -- check sensor

Reset the sensor in response to a server push message

This also requires wiring the sensor reset control! Must be backwards compatible with devices that are missing this connection.

Program button can't be pressed using the current 3d printed case

This is a hardware bug! I'll get exact measurements so we can print a pinhole in the right spot and use a pin to hit this button.

I've tried this out and found I broke the microusb connection to the board. So we will need to be sure the board is both connected solidly to the faceplate and also add a little loop in the usb cable so if it does wiggle, it won't put pressure on the connector.