SensorBoard

Homie based SensorBoard

This sensor board is developed by paddy22 [ät] gmx.de
See at: https://wiki.muc.ccc.de/sensornetzwerk:start

Version 1.0.1
ported to Homie by -mat- filid brandy@linuxpinguin.de

We use the following sensors:

• BH1750
• BME280 or BME680
• MCP
• WS2818 aka Neopixel
• PIR, Radar and Sound sensor via MCP
• soil humidity sensor via analog input

This is build with Homie-ESP8266 version 3.0.1
on a NodeMCU ESP8266 with the following settings:

• NodeMCU 1.0 (ESP-12E Module)
• 4M (1M SPIFFS)

Install the hardware support

To enable the hardware support in the Arduino IDE, make sure the following url is part of "Additional Boards Manager URLS" in the preferences.

• https://arduino.esp8266.com/stable/package_esp8266com_index.json

Make sure to use the latest version (2.6.3) for the esp hardware support.

Now we install the SPIFFs upload tool.

• Browse to https://github.com/esp8266/arduino-esp8266fs-plugin/releases
• Go to your Arduino folder
• Create a directory tools
• Change into the directory
• Download the ESP8266FS-0.5.0.zip
• Unzip it
• Restart Arduino IDE

Install the necessary libraries

Via library manager

• ArduinoJson version 6.13.0
• Bounce2 version 2.52.0
• Adafruit Unified Sensor version 1.0.3
• BH1750FVI version 1.1.1
• Adafruit BME280 version 1.1.0
• Adafruit BME680 version 1.0.7
• Adafruit NeoPixel version 1.3.2
• Adafruit MCP23017 version 1.0.6
• Adafruit SSD1306 version 2.0.3
• Adafruit SSD1306 Wemos Mini OLED version 1.1.2
• Adafruit GFX version 1.7.0

Via git download and manual install

The following are not directly accessible via the library manager.
You need to download the ZIPs and do a manuall Sketch->Include Library->Add .ZIP Library
Following software is requires for the Homie support:

• ESPAsyncTCP >= c8ed544
  https://github.com/me-no-dev/ESPAsyncTCP
• AsyncMqttClient
  https://github.com/marvinroger/async-mqtt-client
• ESPAsyncWebServer
  https://github.com/me-no-dev/ESPAsyncWebServer
• Homie, we need the v3.0 tree
  https://github.com/homieiot/homie-esp8266/tree/v3.0
• Documentation for the Homie v3.0 branch is at
  https://homieiot.github.io/homie-esp8266/docs/3.0.0/

Get it just working

• Compile
• Upload the fs data
• Log into the Wifi
• Fill out the forms

Get it working with config.json

• Compile
• Copy data/homie/config.json_example to data/homie/config.json
• Edit the data/homie/config.json and fill in the Wifi and Mqtt credentials
  Make sure to choose uniqe names for the device_id
• Upload the fs data

OpenHab2

OpenHab2 things

See the sensorboard.things

OpenHab2 items

See the sensorboard.items

How to connect the code to OpenHAB2 config

Example in OpenHAB2