Difference between revisions of "StofAnanas"
Jump to navigation
Jump to search
| (7 intermediate revisions by the same user not shown) | |||
| Line 20: | Line 20: | ||
* Automatic determination of location by means of wifi location | * Automatic determination of location by means of wifi location | ||
* Remote control over IR | * Remote control over IR | ||
| + | |||
| + | == Operation Manual == | ||
| + | [[File:ananas_config.png|right|thumb|configuration]] | ||
| + | |||
| + | === Programming === | ||
| + | * connect everything up as indicated under 'hardware' and plug the Wemos D1 in the USB port | ||
| + | * flash the software into the Wemos D1 mini, typically from the command line | ||
| + | pio run -t upload | ||
| + | |||
| + | === Configuration === | ||
| + | * on https://netherlands.maps.luftdaten.info find the particulate matter station you want to follow and note the number of the station, for example "12246" | ||
| + | * on a mobile phone, connect to the "ESP-STOFANANAS" network, and select login | ||
| + | * when presented with the captive portal, select a WiFi network, fill in the WiFi password, AND ALSO fill in the number you looked up earlier, press SAVE | ||
| + | * NOTE: when the configuration is ongoing, the LED will be YELLOW, it turns OFF when configuration is done. | ||
== Hardware == | == Hardware == | ||
| + | [[File:pl9823.png|right|thumb|pinout]] | ||
The lamp is controlled by an ESP8266, a Wemos D1 mini board. | The lamp is controlled by an ESP8266, a Wemos D1 mini board. | ||
The LEDs used has a built-in PL9823 controller. | The LEDs used has a built-in PL9823 controller. | ||
| + | |||
| + | Connections: | ||
| + | * LED Din to Wemos D1 mini pin D4 | ||
| + | * LED Gnd to Wemos D1 mini pin GND | ||
| + | * LED Vdd to Wemos D1 mini pin 5V | ||
== Software == | == Software == | ||
Software is available on [https://github.com/bertrik/stofananas github]. | Software is available on [https://github.com/bertrik/stofananas github]. | ||
| + | === Luftdaten interface === | ||
| + | The current measurement value of a particular sensor can be retrieved over a REST interface, using URL | ||
| + | http://api.luftdaten.info/v1/sensor/<sensor-id>/ | ||
| + | where <sensor-id> is the database id used by luftdaten (and visible on their map). | ||
| + | The trailing slash in the URL is significant. | ||
| + | |||
| + | For example: | ||
| + | http://api.luftdaten.info/v1/sensor/12246/ | ||
| + | |||
| + | === Arduino libraries === | ||
Libraries: | Libraries: | ||
* WiFiManager is used to manage WiFi connection to the local AP | * WiFiManager is used to manage WiFi connection to the local AP | ||
* FastLED is used to control the LED | * FastLED is used to control the LED | ||
* ArduinoJSON for the parsing the luftdaten response | * ArduinoJSON for the parsing the luftdaten response | ||
Revision as of 23:57, 16 June 2019
| Project StofAnanas | |
|---|---|
| |
| Showing particulate matter concentration as a coloured light | |
| Status | Initializing |
| Contact | bertrik |
| Last Update | 2019-06-16 |
Contents
The idea
Show current airborne particulate matter concentration using a LED light in a lamp, inspired by http://stoflamp.nl The data that the LED colour is based on is simply retrieved over WiFi from the luftdaten website.
This lamp is a plastic pine apple ("ananas"), bought at the "Action" store.
Concepts/ideas:
- The lamp shows particulate matter concentration as a colour, e.g. soft/positive colours for low concentration and hard/bright colour for high concentration
- The lamp "breathes" by varying the intensity over time, e.g. a cycle of 10 seconds where the light dims a bit and brightens a bit. Perhaps we can increase the breathing rate as well for higher PM.
- The lamp retrieves the PM value over wifi from the the luftdaten website
Nice to have:
- Automatic determination of location by means of wifi location
- Remote control over IR
Operation Manual
Programming
- connect everything up as indicated under 'hardware' and plug the Wemos D1 in the USB port
- flash the software into the Wemos D1 mini, typically from the command line
pio run -t upload
Configuration
- on https://netherlands.maps.luftdaten.info find the particulate matter station you want to follow and note the number of the station, for example "12246"
- on a mobile phone, connect to the "ESP-STOFANANAS" network, and select login
- when presented with the captive portal, select a WiFi network, fill in the WiFi password, AND ALSO fill in the number you looked up earlier, press SAVE
- NOTE: when the configuration is ongoing, the LED will be YELLOW, it turns OFF when configuration is done.
Hardware
The lamp is controlled by an ESP8266, a Wemos D1 mini board. The LEDs used has a built-in PL9823 controller.
Connections:
- LED Din to Wemos D1 mini pin D4
- LED Gnd to Wemos D1 mini pin GND
- LED Vdd to Wemos D1 mini pin 5V
Software
Software is available on github.
Luftdaten interface
The current measurement value of a particular sensor can be retrieved over a REST interface, using URL
http://api.luftdaten.info/v1/sensor/<sensor-id>/
where <sensor-id> is the database id used by luftdaten (and visible on their map). The trailing slash in the URL is significant.
For example:
http://api.luftdaten.info/v1/sensor/12246/
Arduino libraries
Libraries:
- WiFiManager is used to manage WiFi connection to the local AP
- FastLED is used to control the LED
- ArduinoJSON for the parsing the luftdaten response
