Skip to content
SensorNode is an opensource framework to configure access to different modules on the ESP8266 NodeMCU. (Captive Portal)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


SensorNode is an opensource framework to configure access to different modules on the ESP8266 NodeMCU.

You can simulate an access on the SensorNode here

What you can currently do?

  • Access temperature, time, leds using a REST API / JSON.
  • You can configure wireless access using a web interface (captive portal).
  • You can get time and configure timezones once you have configured internet access.
  • Control LEDs using the web interface (or calling an api).
  • Switch on-off a relay (using an api call).
  • Get value of a geiger counter (RadiationD-v1.1)
  • Configure access to a MQTT server (send messages)

What I expect to do?

  • Do actions when we are out of some temperature (send an alert).
  • Improve the ugly UI/UX, make it mobile friendly.
  • Fix some issues with RGB Leds.
  • Create a sunrise, sunset effect.
  • Use a web interface to control relays.
  • Draw some schema and share some pictures / videos.
  • Switch on and off relay using time.
  • Switch on and off relay using temperature.

Help more than welcome!


Settings.h contains the configuration for the pins and sensors.

Please copy Settings.h.sample to Settings.h and configure it based on your hardware.

You can speedup file serving by gzipping files in data. On linux just call ""

Needed libraries

pio lib list

  • 64: ArduinoJson (5.8.4)
  • 54: DallasTemperature (3.7.7)
  • 1: OneWire (2.3.2)
  • 76: Timezone (8e96486b2c)
  • 44: Time (1.5)
  • 551: NTPClient (3.1.0)
  • 547: NeoPixelBus (2.2.7)
  • 19: DHT sensor library (1.3.0)
  • 31: Adafruit Unified Sensor (1.0.2)

The libraries should be installed automatically!

If it doesn't work, you can install them by typing in your terminal (the icon with a > on the left of PlatformIO).

platformio lib install {library id}

Example for the pixel library: platformio lib install 679

What is the current status

  • You can configure a captive portal
  • You can control the leds (no ui yet)
  • You can get temperature
  • You can control 2 relays
  • You can send data to a MQTT server (only send geiger info for now)

What you need?

  • PlatformIO
  • An ESP8266
  • Some modules

Supported modules

You may be interested to buy: Please note that other modules are supported for each of these sensors type. It's the one I've tested.

  • NodeMCU dev board

  • WS2813 or WS2812 (RGB leds)


A few leds could be connected directly to signal port D4 and powered with 3.3v. I tried with 300.

The red, geen, blue level of each of them can be controlled individually.

I recommend to use a SN74AHCT125N if you want to use more than 5 at full power!

1: 1OE: Connect to GND

2: 1A: Input with port D4

3: 1Y: Output to "signal" pin of the leds.

7: GND to GND

14: Vcc to +5V

Connect the leds to the 5v power supply!

2x 1 Channel, 5V relay module KY-019

or a Solid State Relay Module

Should work fine with 5v. You can connect them to port D7 and D8. Please note that they consume a lot of energy!

  • DS18B20 Waterproof temperature sensors (Should be supported DS18B20, DS18S20, DS1822, DS1820)

You can connect multiple temperature modules together (I've tested 3 with success).

Link the red and blue wires together with a resistance of 4.7 kOhm. (A resistance between D1 and +3.3v)

You can connect the signal wire on D1.

  • Switch or PIR (infrared detector)

Put the signal wire on pin D5 or D6.

To avoid completely chaotic behavior (false positives) it is advisable to connect an external pull-up-Resistor between the GPIO and VCC (10KOhm)

  • DHT22 temperature and humidity sensor.

Put a resistance of 4700 Ohm between +3.3v and "signal"

  • RadiationD-v1.1 (CAJOE) radiation monitor (Geiger counter)

You have a pin P3 with GND, 5V, VIN

VIN is HIGH (+5v). When you receive a particle, it becomes LOW then HIGH again. The signal you will get will be inverted!

Connect the GND RadiationD-v1.1 with GND ESP8266.

You have to use a SN74AHCT125N as RadiationD-v1.1 is running at 5v and the ESP8266 at 3.3v.

1: 1OE: Connect to VIN (RadiationD-v1 - Not to GND!!)

2: 1A: Connect to 5V (RadiationD-v1.1)

3: 1Y: Output to D8 (ESP8266)

7: GND to GND (ESP8266 and RadiationD-v1)

14: Vcc to +3.3V (ESP8266)


You can buy it here

How to deploy

You need PlatformIO (it's the simplest solution :))

All actions are done on the left panel.

To build: PlatformIO: Build

If you have any errors, verify that your libraries are well installed!

To deploy files (images, html, javascript),

click on : Run other target. PIO Upload SPIFFS image

This action will clear configurations!

Now click on PlatformIO: Upload

The leds will blink and you will see a new wireless access.

Connect to this wireless access and type: in your browser.

OTA updates

You can support OTA updates (configure in Settings.h!)

Deploying the SPIFFS part is faster.

In platformio.ini add

// upload_port=

// upload_flags = --port=8266 --auth=YourPassword

With the IP of your module, port and password.

You can’t perform that action at this time.