Merge branch '14-firmware' into 'master'

Firmware

Closes #14

See merge request !9

README.md

@@ -3,7 +3,9 @@ Vaguely inspired by [this](https://www.airgradient.com/diy/), but with more sens
 
 ## Sensors
 ### Built-In
-* [BME280](https://www.aliexpress.com/item/32862421810.html)
+* BME (environment), one of
+  * [BME280](https://www.aliexpress.us/item/2251832676107058.html) (4- and 6-pin versions are supported)
+  * [BME680](https://www.aliexpress.us/item/2255800632115051.html) (not recommended, the gas resistance heater throws off temperature a lot)
 * [SenseAir S8 CO₂](https://senseair.com/products/size-counts/s8-5/)
 * [Plantower PMS7003 particulate matter sensor](https://www.espruino.com/PMS7003)
 
@@ -13,11 +15,14 @@ Vaguely inspired by [this](https://www.airgradient.com/diy/), but with more sens
   * Reference code: https://github.com/Seeed-Studio/Seeed_Arduino_MultiGas
 
 ## Other hardware
+* WiFi version
   * ESP-8266 D1 Mini ([notes](docs/D1_Mini.md))
-* Generic OLED screen
+  * Generic OLED screen ([example](https://www.aliexpress.us/item/2251832681959772.html))
+* PoE version
+  * Olimex ESP32-POE or ESP32-POE-ISO
 
 ## Software
-* ESPHome
+Instructions for creating firmware with ESPHome is provided in [this project](https://PigLab.ReaperLegion.net/home-automation/hass/esphome/packages/haks).
 
 ## PCB
 The PCB is designed with KiCad and intended to fab with JLCPCB.
@@ -29,10 +34,15 @@ The PoE version (haks_poe) uses the Olimex [ESP32-PoE-ISO](https://github.com/OL
 
 ## Assembly
 
-The boards support both common BME280 pinouts (4- and 6-pin).
-The 4-pin board runs on 5V, while the 6-pin board runs on 3.3V.
+The boards support both common BME280 pinouts (4- and 6-pin) as well as the BME680 (6-pin).
 Solder JP3 to select the appropriate voltage. 1-2 selects 5V, and 2-3 selects 3.3V.
 
+Please check the documentation for the BME you bought, but commonly:
+
+- BME280 4-pin usually runs on 5V
+- BME280 6-pin usually runs on 3.3V
+- BME680 6-pin usually runs on 3.3V
+
 ## CI/CD Pipeline
 [kicad_auto](https://github.com/INTI-CMNB/kicad_auto) is used to run DRC and generate Gerber files.
 JLCPCB rules for kiplot are based on the sample from [KiBot](https://github.com/INTI-CMNB/KiBot).