StofAnanas - Revision history

Bertrik Sikken: /* Colour mapping */

2023-02-01T12:50:12Z

Colour mapping

← Older revision		Revision as of 12:50, 1 February 2023
Line 107:		Line 107:
	[[File:Fastled_rainbow.jpg\|right\|thumb\|FastLED rainbow hue chart]]		[[File:Fastled_rainbow.jpg\|right\|thumb\|FastLED rainbow hue chart]]

	Mapping is currently as follows:		Mapping is currently as follows, using the PM2.5 value:
	* 0 ug/m3: <span style="background:#0000FF>deep blue</span>		* 0 ug/m3: <span style="background:#0000FF>deep blue</span>
	* 15 ug/m3: <span style="background:#00F00F>green</span>		* 15 ug/m3: <span style="background:#00F00F>green</span>

Bertrik Sikken at 12:12, 28 July 2022

2022-07-28T12:12:27Z

← Older revision		Revision as of 12:12, 28 July 2022
Line 3:		Line 3:
	\|Picture=StofAnanas.jpg		\|Picture=StofAnanas.jpg
	\|Omschrijving=Showing particulate matter concentration as a coloured light		\|Omschrijving=Showing particulate matter concentration as a coloured light
	\|Status=~~In progress~~		\|Status=Completed
	\|Contact=bertrik		\|Contact=bertrik
	}}		}}

Bertrik Sikken: /* Hardware */

2022-05-12T12:18:08Z

Hardware

← Older revision		Revision as of 12:18, 12 May 2022
Line 78:		Line 78:
	* 7-LED shield: https://www.wemos.cc/en/latest/d1_mini_shield/rgb_led.html		* 7-LED shield: https://www.wemos.cc/en/latest/d1_mini_shield/rgb_led.html

	The 7-LED shield is a lot brighter than the 1-LED shield.		The 7-LED shield is a lot brighter than the 1-LED shield, I recommend to use the 7-led shield.

	Unfortunately not all LED shields are equal, some contain an RGB LED, others have the RGB colours switched.		Unfortunately not all LED shields are equal, some contain an RGB LED, others have the RGB colours switched.

Bertrik Sikken: /* The concept */

2022-05-11T15:41:20Z

The concept

← Older revision		Revision as of 15:41, 11 May 2022
Line 9:		Line 9:
	== The concept ==		== The concept ==
	The stofananas/stoflama visualizes the current airborne particulate matter concentration from the nearest sensor.community measurement station, inspired by http://stoflamp.nl		The stofananas/stoflama visualizes the current airborne particulate matter concentration from the nearest sensor.community measurement station, inspired by http://stoflamp.nl
	The data that the LED colour is based on is retrieved over WiFi from the ~~sensor~~.~~community~~ website every 5 minutes.		The data that the LED colour is based on is retrieved over WiFi from the stofradar.nl website every 5 minutes.

	This lamp is a soft plastic translucent pine apple ("ananas") or lama, bought at the "Action" store.		This lamp is a soft plastic translucent pine apple ("ananas") or lama, bought at the "Action" store.
Line 15:		Line 15:
	Features:		Features:
	* The lamp shows particulate matter concentration as a colour, from dark blue for low concentration to bright pink for high concentration		* The lamp shows particulate matter concentration as a colour, from dark blue for low concentration to bright pink for high concentration
	* The lamp retrieves the PM value over wifi from the the ~~sensor~~.~~community~~ website, there is a one-time setup to configure your WiFi network so the device can access the internet		* The lamp retrieves the PM value over wifi from the the stofradar.nl website, there is a one-time setup to configure your WiFi network so the device can access the internet
	* The lamp ~~automatically~~ determines ~~the nearest sensor.community particulate measurement station,~~ by ~~doing WiFi-~~based ~~geolocation.~~		* The lamp determines its location by based on signal strength and BSSID of nearby WiFi base stations.
	* The number/id of ~~the sensor.community station can also be entered manually during the one-time setup~~.
	* The hardware consists of a Wemos D1 mini board (about E3,-), a LED shield and a USB power supply + cable.		* The hardware consists of a Wemos D1 mini board (about E3,-), a LED shield and a USB power supply + cable.
	* The software supports two different kinds of Wemos D1 mini LED "shield", both the shield with a single LED and the shield with 7 LEDs arranged in a star.		* The software supports two different kinds of Wemos D1 mini LED "shield", both the shield with a single LED and the shield with 7 LEDs arranged in a star.
Line 26:		Line 25:
	* Run the software directly on a WiFi-enabled E14 RGB lamp from the Action store. This lamp has the microcontroller already built in. No separate USB power adapter is needed, it runs directly off 230V. See the [[WifiLamp]] project.		* Run the software directly on a WiFi-enabled E14 RGB lamp from the Action store. This lamp has the microcontroller already built in. No separate USB power adapter is needed, it runs directly off 230V. See the [[WifiLamp]] project.
	* Instead of controlling a light directly, send a command over infrared remote to an RGB lamp already having remote control, see https://www.instructables.com/Reverse-Engineering-RGB-LED-Bulb-with-IR-remote/		* Instead of controlling a light directly, send a command over infrared remote to an RGB lamp already having remote control, see https://www.instructables.com/Reverse-Engineering-RGB-LED-Bulb-with-IR-remote/

	~~=== Simplified REST API ===~~
	~~Problems with the current implementation:~~
	* communicaton with sensor.community fails randomly, or takes very long
	* the auto-detection method puts a burden on the sensor.community servers, takes very long
	* only returns data from sensor.community, not from other providers (like RIVM, samenmeten)

	~~New plan:~~
	* Create my own API to get a PM-value
	* The API runs on my own server (www.stofradar.nl), where I have full control over performance, features, etc.
	* REST-like protocol, e.g. HTTP GET /v1/airquality/latitude>/<longitude>
	* Response is a JSON structure which contains an interpolated PM value:
	** field "PM2.5" contains the PM2.5 value in ug/m3
	** field "color" contains a color in RGB hex, according to luchtmeetnet colour scale
	* Implemented as a REST resource, based on the values aggregated in stofradar.nl
	** simple square geofilter around the requested geo location, say 25x25 km
	** inverse-distance squared weighted value from values with the square
	* Data sources are sensor.community and RIVM (samenmeten)
	* The API will be part of the stofradar application, which already collects the data from sensor.community and RIVM (samenmeten)
	* The lamp still performs its own geolocation (can cache it), then queries this API, so this remains a two-step process

	== Building it ==		== Building it ==

Bertrik Sikken: /* Hardware */

2022-05-11T15:37:32Z

Hardware

← Older revision		Revision as of 15:37, 11 May 2022
Line 97:		Line 97:
	The LED can be one of these LED shields:		The LED can be one of these LED shields:
	* 1-LED shield: https://wiki.wemos.cc/products:d1_mini_shields:ws2812b_rgb_shield		* 1-LED shield: https://wiki.wemos.cc/products:d1_mini_shields:ws2812b_rgb_shield
	* 7-LED shield: https://~~wiki~~.wemos.cc/~~products:d1_mini_shields:rgb_led_shield~~		* 7-LED shield: https://www.wemos.cc/en/latest/d1_mini_shield/rgb_led.html

	The 7-LED shield is a lot brighter than the 1-LED shield.		The 7-LED shield is a lot brighter than the 1-LED shield.

Bertrik Sikken: /* Configuration */

2022-05-11T15:36:23Z

Configuration

@@ Line 84: / Line 84: @@
 * power up the lamp
 * on a mobile phone, connect to the "ESP-PMLAMP" network, and select login
-* when presented with the captive portal, select a WiFi network, fill in the WiFi password, leave the luftdaten id field EMPTY, press SAVE
+* when presented with the captive portal, select a WiFi network, fill in the WiFi password, press SAVE
 === Usage ===

Bertrik Sikken: /* Software */

2022-05-11T15:34:22Z

Software

@@ Line 130: / Line 130: @@
 * FastLED (v 3.5.0) is used to control the RGB LED
 * WiFiManager (v 0.16.0) is used to manage WiFi connection to the local WiFi access point
 === stofradar.nl interface ===

Bertrik Sikken: /* Getting and building the source code */

2022-05-10T13:03:42Z

Getting and building the source code

← Older revision		Revision as of 13:03, 10 May 2022
Line 123:		Line 123:
	To compile and upload it, I use platform io:		To compile and upload it, I use platform io:
	pio run -t upload		pio run -t upload

			The ESP8266 board support should be version 2.6.3!

	You can also compile it with the Arduino IDE, libraries used:		You can also compile it with the Arduino IDE, libraries used:

Bertrik Sikken: /* Software */

2022-05-04T15:37:20Z

Software

← Older revision		Revision as of 15:37, 4 May 2022
Line 141:		Line 141:

	The software looks for the "P1" (PM10) sensor value in the JSON message and averages all measurements it finds (usually the current one and a previous one).		The software looks for the "P1" (PM10) sensor value in the JSON message and averages all measurements it finds (usually the current one and a previous one).

			=== stofradar.nl interface ===
			The firmware performs a GET on
			http://stofradar.nl:9000/air/<latitude>/<longitude>

			This returns a JSON message as follows
			{"pm2.5":4.25}

	=== Colour mapping ===		=== Colour mapping ===

Bertrik Sikken at 08:08, 30 April 2022

2022-04-30T08:08:36Z

← Older revision		Revision as of 08:08, 30 April 2022
Line 25:		Line 25:
	* some kind of compatibility mode with the stoflamp from stoflamp.nl		* some kind of compatibility mode with the stoflamp from stoflamp.nl
	* Run the software directly on a WiFi-enabled E14 RGB lamp from the Action store. This lamp has the microcontroller already built in. No separate USB power adapter is needed, it runs directly off 230V. See the [[WifiLamp]] project.		* Run the software directly on a WiFi-enabled E14 RGB lamp from the Action store. This lamp has the microcontroller already built in. No separate USB power adapter is needed, it runs directly off 230V. See the [[WifiLamp]] project.
			* Instead of controlling a light directly, send a command over infrared remote to an RGB lamp already having remote control, see https://www.instructables.com/Reverse-Engineering-RGB-LED-Bulb-with-IR-remote/

	=== Simplified REST API ===		=== Simplified REST API ===