1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# ESP8266 Lua/NodeMCU module for Vindriktning PM1006 PM sensors
This repository contains an ESP8266 NodeMCU Lua module (`pm1006.lua`) as well
as MQTT / HomeAssistant / InfluxDB integration example (`init.lua`) for
**PM1006** particulate matter (PM2.5) sensors found in IKEA Vindriktning.
## Dependencies
pm1006.lua has been tested with Lua 5.1 on NodeMCU firmware 3.0.1 (Release
202112300746, integer build). It does not require any special modules.
Most practical applications (such as the example in init.lua) need the
following modules.
* gpio
* mqtt
* node
* softuart
* tmr
* wifi
## Setup
Connect the Vindriktning PCB to your ESP8266/NodeMCU board as [documented by
Hypfer](https://github.com/Hypfer/esp8266-vindriktning-particle-sensor):
* Vindriktning +5V → NodeMCU 5V
* Vindriktning GND → ESP8266/NodeMCU GND
* Vindriktning REST → NodeMCU D2 (ESP8266 GPIO4)
If you use a different UART pin, you need to adjust the softuart.setup call in
the examples provided in this repository to reflect that change. Keep in mind
that some ESP8266 pins must have well-defined logic levels at boot time and may
therefore be unsuitable for PM1006 connection.
## Usage
Copy **pm1006.lua** to your NodeMCU board and set it up as follows.
```lua
pm1006 = require("pm1006")
port = softuart.setup(9600, nil, 2)
port:on("data", 20, uart_callback)
function uart_callback(data)
local pm2_5 = pm1006.parse_frame(data)
if pm2_5 ~= nil then
-- pm2_5 : PM2.5 concentration [µg/m³]
else
-- invalid frame header or checksum
end
end
```
## Application Example
**init.lua** is an example application with HomeAssistant integration. It uses
oversampling to smoothen readings, and only reports the average of every group
of ten readings. To use it, you need to create a **config.lua** file with WiFI
and MQTT settings:
```lua
station_cfg = {ssid = "...", pwd = "..."}
mqtt_host = "..."
```
Optionally, it can also publish readings to InfluxDB.
To do so, configure URL and attribute:
```lua
influx_url = "..."
influx_attr = "..."
```
Readings will be published as `vindriktning[influx_attr] pm2_5_ugm3=%d.%01d`.
So, unless `influx_attr = ''`, it must start with a comma, e.g. `influx_attr = ',device=' .. device_id`.
|
