Skip to content
HomeHome.App

Relay & Shutter

Relay & Shutter Β· ESP8266

Switch lights or move a roller shutter.

A NodeMCU ESP8266 board on a base board, plus a 2- or 4-channel relay module. With HomeHome.App firmware it becomes a smart switch for Apple Home, Google Home and the HomeHome.App web interface.

Board: NodeMCU LoLin V31, 2 or 4 relays1–4 creditsFree demo
Open the ESP8266 flasher β†—Maker Credits

Try it free first. Relay & Shutter starts in demo mode by itself after setup – usually for 10 to 20 on/off changes, depending on the device. Like it? Then buy Maker Credits.

NodeMCU IN1IN2IN3IN4 2- or 4-channel 5 V relay Light Β· on Shutter Β· 60%

Two modes

Custom On-Off Setting

On/off switch

Control lights or sockets with 1, 2 or 4 relays.

Custom Shutter Setting

Roller shutter

Control one shutter, blind or curtain motor with relays 1 and 2 (up / down).

Maker Credits

How many credits?

One device controls one roller shutter, even with a 4-channel board.

  • 1 roller shutter β†’ 1 device with 2 relays
  • 2 roller shutters β†’ 2 devices with 2 relays
  • 4 lights β†’ 1 device with 4 relays
  • 1 roller shutter + 2 lights β†’ 1 device for the shutter + 1 device with 2 relays
How Maker Credits work
SettingCredits
1-channel on/off1
2-channel on/off2
4-channel on/off4
Roller shutter (2 relays)3

Hardware

What you need

NodeMCU LoLin V3 + base boardNodeMCU LoLin V3 + base boardThe ESP8266 board and a NodeMCU base board to plug it into.
A 2- or 4-channel 5 V relayA 2- or 4-channel 5 V relayPlus Dupont cables to connect it to the base board.
  • Power: a 5 V micro USB charger, or a 12 V 1 A adapter on the base board's DC jack.
  • Optional: your own wall switches or push buttons.
  • The relays are dry contacts for up to 250 V AC / 30 V DC.

Safety: mains voltage is dangerous – let an electrician connect the 230 V wires.

Wiring

Which pin goes where?

Relay module: VIN β†’ VCC, GND β†’ GND, JD-VCC jumper on. A light goes on the relay's COM and NO terminals, so it turns on when the relay turns on.

A light connected to the COM and NO terminals of a relay
On/off with 4 relaysPins
RelaysD1 β†’ IN1 Β· D2 β†’ IN2 Β· D5 β†’ IN3 Β· D6 β†’ IN4
ButtonsD7 β†’ button 1 Β· RX β†’ button 2 Β· TX β†’ button 3 Β· D4 β†’ button 4
Reset buttonD0
LEDD4 – leave it empty if D4 is used for a button
Roller shutter or 2 relaysPins
RelaysD1 β†’ IN1 Β· D2 β†’ IN2
ButtonsD6 β†’ button 1 Β· D7 β†’ button 2
Reset buttonD0
LEDD4
Wiring a NodeMCU base board to a 4-channel relay module

Setup

Set it up

  1. Flash the firmware with Chrome or Edge over USB: ESP8266 flasher.
  2. Wi-Fi setup. Power the board and join the Wi-Fi network HomeHome-XXXXXX (password homehome) from your phone. The setup page opens by itself – if not, reconnect.
  3. Choose the device type – Custom On-Off Setting (1, 2 or 4 relays) or Custom Shutter Setting (roller shutter) – and the switch type (momentary or toggle, to match your wall switches). Enter your Gmail address, an optional static IP, and your home Wi-Fi and its password. Save, wait 3 seconds, then unplug and plug in the board.
  4. Apple Home. Within 90 seconds after the restart, add the accessory in the Home app with the code 111-88-111. Wait one minute after pairing.
  5. Activate with Maker Credits. Your credits are linked to your Gmail address: write it in the order note or email info@homehome.app.

Free demo: after setup the device runs in demo mode by itself, so you can test it before you buy. The demo usually ends after 10 to 20 on/off changes. When you have bought Maker Credits and we have added them to your Gmail account, restart the device and it keeps working.

Google Home (optional)

In Google Home: + β†’ Set up device β†’ Works with Google β†’ HomeHome, and log in with the same Gmail address.

Web interface (optional)

Sign in at smart.homehome.app with the same Gmail address and activate your device ID under Manage.

Not using Apple Home?

Wait about 3 minutes, open the device page and turn on Skip HomeKit Pair Standby Time in Settings.

Device page

Settings on the device

Type the board's IP address into a browser and log in with your full Gmail address. You find the IP in the Home app (long-press the accessory β†’ settings) or in your router's device list.

  • Turn Back – return to the last position after a power cut.
  • Auto Turn Off – switch relay 1 off by itself after 1 second to 18 hours.
  • Local Mode – keep working without internet (Apple Home and the device page only).
  • Rename the device, turn the device page off, and get updates over the air.

Apple Home and the device page work without internet. Google Home and the web interface need internet.

For developers: HTTP commands
Relay 1 on: <device-ip>/1/on?<gmail-name>
Relay 1 off: <device-ip>/1/off?<gmail-name>
All states: <device-ip>/all?<gmail-name> β†’ for example [0,1,2,2] (0 = off, 1 = on, 2 = not used).
Use your Gmail name without "@gmail.com".
Can one board run two shutters?
No. One device controls one roller shutter, even with a 4-channel board. Two shutters need two devices.
Is there a longer guide?

Planning lights or shutters? Ask us first.

Send us a WhatsApp message. Email: info@homehome.app.

Chat on WhatsAppinfo@homehome.app