Updated example code

examples/C02_PM_SHT/C02_PM_SHT.ino

@@ -1,26 +0,0 @@
-#include <AirGradient.h>
-AirGradient ag = AirGradient();
-
-void setup(){
-  Serial.begin(9600);
-  ag.PMS_Init();
-  ag.CO2_Init();
-  ag.TMP_RH_Init(0x44); //check for SHT sensor with address 0x44
-}
-
-void loop(){
-    
-Serial.print("PM2: ");
-Serial.println(ag.getPM2());
-
-
-Serial.print("CO2: ");
-Serial.println(ag.getCO2());
-
-TMP_RH result = ag.periodicFetchData();
-Serial.print("Humidity: ");
-Serial.print(result.rh);
-Serial.print(" Temperature: ");
-Serial.println(result.t);
-delay(5000);
-}

examples/C02_PM_SHT_OLED/C02_PM_SHT_OLED.ino

@@ -1,41 +0,0 @@
-#include <AirGradient.h>
-#include <Adafruit_GFX.h>
-#include <Adafruit_SSD1306.h>
-
-AirGradient ag = AirGradient();
-#define OLED_RESET 0
-Adafruit_SSD1306 display(OLED_RESET);
-
-void setup(){
-  Serial.begin(9600);
-  display.begin(SSD1306_SWITCHCAPVCC, 0x3C); 
-  ag.PMS_Init();
-  ag.CO2_Init();
-  ag.TMP_RH_Init(0x44); //check for SHT sensor with address 0x44
-  showTextRectangle("Init", String(ESP.getChipId(),HEX),"AirGradient");
-  delay(2000);
-}
-
-void loop(){
-  int PM2 = ag.getPM2_Raw();
-  int CO2 = ag.getCO2_Raw();
-  TMP_RH result = ag.periodicFetchData();
-  showTextRectangle(String(result.t)+"c "+String(result.rh)+"%", "PM2: "+ String(ag.getPM2()), "CO2: "+String(ag.getCO2())+"");
-  delay(5000);
-}
-
-// DISPLAY
-void showTextRectangle(String ln1, String ln2, String ln3) {
-  display.clearDisplay();
-  display.setTextColor(WHITE);
-  display.setTextSize(1);
-  display.setCursor(32,8);
-  display.println(ln1);
-  display.setTextSize(1);
-  display.setCursor(32,16);
-  display.println(ln2);
-  display.setTextSize(1);
-  display.setCursor(32,24);
-  display.println(ln3);
-  display.display();
-}

examples/C02_PM_SHT_OLED_WIFI/C02_PM_SHT_OLED_WIFI.ino

@@ -1,35 +1,101 @@
+/*
+This is the code for the AirGradient DIY Air Quality Sensor with an ESP8266 Microcontroller.
+
+It is a high quality sensor showing PM2.5, CO2, Temperature and Humidity on a small display and can send data over Wifi.
+
+For build instructions please visit https://www.airgradient.com/diy/
+
+Compatible with the following sensors:
+Plantower PMS5003 (Fine Particle Sensor)
+SenseAir S8 (CO2 Sensor)
+SHT30/31 (Temperature/Humidity Sensor)
+
+Dependent Libraries:
+The codes needs the following libraries installed:
+ESP8266 board with standard libraries
+WifiManager by tzar, tablatronix tested with Version 2.0.3-alpha
+ESP8266 and ESP32 OLED driver for SSD1306 displays by ThingPulse, Fabrice Weinberg tested with Version 4.1.0
+
+Configuration:
+Please set in the code below which sensor you are using and if you want to connect it to WiFi.
+
+If you are a school or university contact us for a free trial on the AirGradient platform.
+https://www.airgradient.com/schools/
+
+MIT License
+*/
+
 #include <AirGradient.h>
-#include <Adafruit_GFX.h>
-#include <Adafruit_SSD1306.h>
 #include <WiFiManager.h>
 #include <ESP8266WiFi.h>
 #include <ESP8266HTTPClient.h>
 
-AirGradient ag = AirGradient();
-#define OLED_RESET 0
-Adafruit_SSD1306 display(OLED_RESET);
+#include <Wire.h>
+#include "SSD1306Wire.h"
 
+AirGradient ag = AirGradient();
+
+SSD1306Wire display(0x3c, SDA, SCL);
+
+// set sensors that you do not use to false
+boolean hasPM=true;
+boolean hasCO2=true;
+boolean hasSHT=true;
+
+// set to true if you want to connect to wifi. The display will show values only when the sensor has wifi connection
+boolean connectWIFI=false;
+
+// change if you want to send the data to another server
 String APIROOT = "http://hw.airgradient.com/";
 
 void setup(){
   Serial.begin(9600);
-  display.begin(SSD1306_SWITCHCAPVCC, 0x3C); 
-  ag.PMS_Init();
-  ag.CO2_Init();
-  ag.TMP_RH_Init(0x44); //check for SHT sensor with address 0x44
-  showTextRectangle("Init", String(ESP.getChipId(),HEX),"AirGradient");
-  connectToWifi();
+
+  display.init();
+  display.flipScreenVertically();
+  showTextRectangle("Init", String(ESP.getChipId(),HEX),true);
+
+  if (hasPM) ag.PMS_Init();
+  if (hasCO2) ag.CO2_Init();
+  if (hasSHT) ag.TMP_RH_Init(0x44);
+
+  if (connectWIFI) connectToWifi();
   delay(2000);
 }
 
 void loop(){
-  int PM2 = ag.getPM2_Raw();
-  int CO2 = ag.getCO2_Raw();
-  TMP_RH result = ag.periodicFetchData();
-  showTextRectangle(String(result.t)+"c "+String(result.rh)+"%", "PM2: "+ String(PM2), "CO2: "+String(CO2)+"");
-  
+
+  // create payload
+
+  String payload = "{\"wifi\":" + String(WiFi.RSSI()) + ",";
+
+  if (hasPM) {
+    int PM2 = ag.getPM2_Raw();
+    payload=payload+"\"pm02\":" + String(PM2);
+    showTextRectangle("PM2",String(PM2),false);
+    delay(3000);
+  }
+
+  if (hasCO2) {
+    if (hasPM) payload=payload+",";
+    int CO2 = ag.getCO2_Raw();
+    payload=payload+"\"rco2\":" + String(CO2);
+    showTextRectangle("CO2",String(CO2),false);
+    delay(3000);
+  }
+
+  if (hasSHT) {
+    if (hasCO2 || hasPM) payload=payload+",";
+    TMP_RH result = ag.periodicFetchData();
+    payload=payload+"\"atmp\":" + String(result.t) +   ",\"rhum\":" + String(result.rh);
+    showTextRectangle(String(result.t),String(result.rh)+"%",false);
+    delay(3000);
+  }
+
+   payload=payload+"}";
+
   // send payload
-  String payload = "{\"pm02\":" + String(ag.getPM2()) +  ",\"wifi\":" + String(WiFi.RSSI()) +  ",\"rco2\":" + String(ag.getCO2()) + ",\"atmp\":" + String(result.t) +   ",\"rhum\":" + String(result.rh) + "}";
+  if (connectWIFI){
   Serial.println(payload);
   String POSTURL = APIROOT + "sensors/airgradient:" + String(ESP.getChipId(),HEX) + "/measures";
   Serial.println(POSTURL);
@@ -41,37 +107,34 @@ void loop(){
   Serial.println(httpCode);
   Serial.println(response);
   http.end();
-  
-  delay(15000);
+  }
 }
 
 // DISPLAY
-void showTextRectangle(String ln1, String ln2, String ln3) {
-  display.clearDisplay();
-  display.setTextColor(WHITE);
-  display.setTextSize(1);
-  display.setCursor(32,8);
-  display.println(ln1);
-  display.setTextSize(1);
-  display.setCursor(32,16);
-  display.println(ln2);
-  display.setTextSize(1);
-  display.setCursor(32,24);
-  display.println(ln3);
+void showTextRectangle(String ln1, String ln2, boolean small) {
+  display.clear();
+  display.setTextAlignment(TEXT_ALIGN_LEFT);
+  if (small) {
+    display.setFont(ArialMT_Plain_16);
+  } else {
+    display.setFont(ArialMT_Plain_24);
+  }
+  display.drawString(32, 16, ln1);
+  display.drawString(32, 36, ln2);
   display.display();
 }
 
 // Wifi Manager
 void connectToWifi(){
   WiFiManager wifiManager;
-  //chWiFi.disconnect(); //to delete previous saved hotspot
+  //WiFi.disconnect(); //to delete previous saved hotspot
   String HOTSPOT = "AIRGRADIENT-"+String(ESP.getChipId(),HEX);
   wifiManager.setTimeout(120);
   if(!wifiManager.autoConnect((const char*)HOTSPOT.c_str())) {
-      //Serial.println("failed to connect and hit timeout");
+      Serial.println("failed to connect and hit timeout");
       delay(3000);
       ESP.restart();
       delay(5000);
-  } 
-    
+  }
+
 }

library.properties

@@ -1,9 +1,9 @@
 name=AirGradient Air Quality Sensor
-version=1.0.0
+version=1.3.4
 author=AirGradient <support@airgradient.com>
 maintainer=AirGradient <support@airgradient.com>
 sentence=ESP8266 library for an air quality sensor featuring PM2.5, CO2, Temperature and Humidity with OLED display.
 paragraph=The library is very robust and works with the Plantower PMS5003 particle sensor, the Senseair S8 CO2 sensor and the SHT30/31 sensor for humidity and temperature. You can also connect an OLED display or send the air quality data to the AirGradient platform or any other backend.
 category=Sensors
 url=https://github.com/airgradienthq/arduino
-architectures=*
+architectures=*