diff options
author | Birte Kristina Friesel <derf@finalrewind.org> | 2024-01-14 08:23:39 +0100 |
---|---|---|
committer | Birte Kristina Friesel <derf@finalrewind.org> | 2024-01-14 08:23:39 +0100 |
commit | 6fb1699433c87ce1abe22bfc90855cc6fb96c378 (patch) | |
tree | fa61cc707be64235de8fa0cf29acdb4b9d705f76 | |
parent | 58339aedfde7a13d402a1c1bc720506dab5deb5a (diff) |
README: nits; consistency with other NodeMCU drivers
-rw-r--r-- | README.md | 15 |
1 files changed, 8 insertions, 7 deletions
@@ -1,8 +1,8 @@ -# ESP8266 Lua/NodeMCU module for MAX44009 illuminance sensor +# ESP8266 Lua/NodeMCU module for MAX44009 illuminance sensors This repository contains an ESP8266 NodeMCU Lua module (`max44009.lua`) as well as MQTT / HomeAssistant / InfluxDB integration example (`init.lua`) for -**MAX44009** illuminance sensors. +**MAX44009** illuminance sensors connected via I²C. ## Dependencies @@ -41,15 +41,16 @@ Copy **max44009.lua** to your NodeMCU board and set it up as follows. ```lua max44009 = require("max44009") -i2c.setup(0, sda_pin, scl_pin, i2c.SLOW) +i2c.setup(0, 1, 2, i2c.SLOW) -- can be called with up to 1 Hz function some_timer_callback() local lx = max44009.read() - if lx == nil then + if lx ~= nil then + -- lx : Illuminance as floating point value [lx] + else print("MAX44009 error") else - -- lx contains the illuminance. Note that it is a floating point value. end end ``` @@ -60,7 +61,7 @@ end To use it, you need to create a **config.lua** file with WiFI and MQTT settings: ```lua -station_cfg = {ssid = "foo", pwd = "bar"} +station_cfg = {ssid = "...", pwd = "..."} mqtt_host = "..." ``` @@ -72,5 +73,5 @@ influx_url = "..." influx_attr = "..." ``` -Readings will be stored as `max44009[influx_attr] illuminance_lx=...`. +Readings will be stored as `max44009[influx_attr] illuminance_lx=%f`. So, unless `influx_attr = ''`, it must start with a comma, e.g. `influx_attr = ',device=' .. device_id`. |