Deprecated: Hook custom_css_loaded is deprecated since version jetpack-13.5! Use WordPress Custom CSS instead. Jetpack no longer supports Custom CSS. Read the documentation to learn how to apply custom styles to your site: in /var/www/html/wp-includes/functions.php on line 6078 Cheap and Easy Control of 8 Relays through Home Assistant – D Khaz Skip to content

Cheap and Easy Control of 8 Relays through Home Assistant

Home Assistant and ESPHome

Following up on my previous post of the Cheap and Easy series, I’m going to show you how you can control 8 relay channels for about 25 bucks and in about 30 minutes. If you’re not familiar with Home Assistant or ESPHome, check out my previous post.

In this project, I use a Wemos D1 Mini as the wifi enable the controller to interface with the relay module using the IO expansion shield.  The magic of this setup is using the IO module and soldering it directly onto the relay board.  This eliminates the narly mess you see you when would typically have 8 channels of relays.  As a bonus, since you are only using 8 of the available 16 channels on the IO module, you could use the remaining 8 IO to do all sorts of other things.

Shopping list:

  1. Wemos D1 Mini – The Wemos D1 Mini is an ESP8266 based microcontroller that will handle the heavy lifting of WiFi and communicating to your Home Assistant instance [ Amazon, 3 Pack, Amazon, 5 Pack ]
  2. MCP23017 IO Expansion Module – This is what you will use to allow you to drive all 8 relay channels with minimal effort [ Amazon ]
  3. 8 Channel Relay Board – I added the DHT to get temperature and humidity data [ Amazon ]
  4. Assorted Dupont Jumpers – Always have a bunch of these handy, they have a tendency to disappear and get used up in projects. [ Amazon ]OPTIONAL: If you want to control 12v or 24v loads
  5. Appropriate DC power supply for your loads – This will vary on what you are trying to control, links to some options. [ Amazon 12v 5A | Amazon 24v 3A ]
  6. LM2596S DC-DC power regulator – It converts garage door’s 12V DC to 5V DC for the Wemos or use a microUSB cable. [ Amazon ]
  7. Soldering Iron Kit – It’s likely that you already have this if you’ve been DIYing for a while [ Amazon ]

Installation is cake

You will need to provide 5v DC power to power the system.  To get started, you will want to place the IO module over the pins of the relay module.  Make sure to line these up correctly as I’ve indicated below.  If you don’t, it’s a big pain to remove it and put it back on correctly, especially if you’ve soldered it in place.  Ask me how I know.
The IO module will have a total of 4 wires connected to it:  two for +5v and GND from the power supply, and two for the I2C (SDA and SCL) from the Wemos.
The IO module will have a total of 4 wires connected to it:  two for +5v and GND from the power supply, and two for the I2C (SDA and SCL) from the Wemos.
That’s it!

Wiring for all of the devices

Pay careful attention to the alignment of the pins

Soldered IO module on to the relay module

Since it’s likely that you will want to switch/power things that are of higher voltage than the 5v rail you need to power the Wemos, I’ve included the 12v and 24v optional power supplies.  Be sure that you do not connect any of these higher voltages to any of the logic pins on the Wemos or the IO, only connect them to the relay output terminals.

ESPHome config

I created the 8 channels as output switches and for the time being omitted the remaining 8 channels which can be configured as inputs or outputs.  I created a new device, named it esphome_relay_board using a D1 mini board with the following config:

The components above include

  • An I2C component to enable I2C communication
  • A MCP23017 component for the IO module
  • A switch restart component to reboot the Wemos
  • A switch GPIO component for the relay
  • A status LED component for indicating networking/error status.

Now can compile the firmware and flash it to your Wemos D1.  Again, if you’re not familiar with how to do this, reference the videos linked above.  Once it’s flashed, power cycle the device.  Now you should be able to open the web GUI for the device by either going to it’s IP or going to http://esphome_relay_board.local in your browser, or whatever you named it.  When the page loads up, you should test out the relay switches by hitting the button next to them.

Integration into Home Assistant

Now to integrate it into Home Assistant, you will need to go to configuration > integrations.  Assuming you have discovery enabled, you will have a new ESPHome device, click configure and add it to your system.  If you don’t have any existing conflicting entities, your entity names should match the ones I have.  I’m using the following config for lovelace:

This provides you with a simple switch list.  Each icon shows you the state of the relay.  And lastly, you get the reset switch to reset the ESP.

Published inDIY HardwareESPHomeHome AssistantHome Automation


  1. zws zws

    Very good tutorial. Thank you!

  2. DK DK

    It would probably be easier to use two separate 8 channel boards with two IO modules if you need 16 channels

  3. Anonymous Anonymous

    There’s a bug in the code:
    sda: D2
    scl: D1
    scan: True

    D1 and D2 should be the other way around:
    sda: D1
    scl: D2
    scan: True

  4. DK DK

    Awesome thanks for catching it!! Fixed.

  5. DK DK

    I would imagine it wouldn’t line up. If you want easiest wiring option, do two multiples of the 8 channel setup. You’ll just have to change the address of the second MCP module with the onboard solder pads.

  6. David David

    Hi! I think the commercial controllers are doing something more than a straight relay to control valves.

    I get really bad water hammer when my valve gets turned off via my outdoor Z-wave switch. I tried borrowing my friend’s new Orbit controller, and amazingly the hammer is gone.

    My suspicion is that the Orbit is soft powering off the valves. Perhaps some kind of RC circuit with a long time constant to slowly close the solenoid?

  7. DK DK

    Not sure. From what I’ve seen a lot of the commercial ones use a valve, which are inherently slow. On the other hand, the solenoid you mentioned, is typically very fast as they operate in a linear motion driven by magnets.

  8. David David

    My bad, I confused your article with another similar one I was reading which was geared towards a DIY irrigation controller

  9. Titus Titus

    Hey, I just went through your tutorial and I have everything set up, but I’m not able to control the relay. The web server for the relay spins up fine and I am able to toggle the states for different channels, however that does not seem to have any effect. I do see in the logs that I2C devices were found and etc. I also checked to make sure the relay is getting proper voltage on it’s VCC pin using a voltmeter. It seems to be getting 5.4V so that should be fine. Any ideas of what I could do to trouble shoot this further?

  10. BBK BBK

    Nice work, though, you have also forgot that ESPs run 3.3V on all their digital IO pins.
    You need a 3.3V – 5V logic level converter (e.g. not to ruin your ESP soon. Since you use i2c should use a bidirectional fast one.

    I hope this helps in the stabilization of your projects!

  11. BobT BobT

    Am ready to order the parts, but not sure about the comment from BBK on the voltage converter. Do I need that and how is it connected.

  12. BBK BBK

    BobT: officially GPIOs are only supporting 3.3V (

    The Espressif ESP8266 datasheet, on page 19 defines also 3.6v and 12mA max current:

    Though, there are people who has tested it and it works with 5V, though, it highly depends on the hw implementation (“clones”, since Espressif releases their specifications based on which others are also manufacturing boards).

    In this special case though, we could be lucky, since this relay board could be operated with isolated 3.3V for the I/O and giving 5V to the relays/transistors. Check the datasheet of the relay board, page 3:

    “It is sometimes possible to use this relay boards with 3.3V signals, if the JD-VCC (Relay Power) is provided from a +5V supply and the VCC to JD-VCC jumper is removed. That 5V relay supply could be totally isolated from the 3.3V device, or have a common ground if opto-isolation is not needed. If used with isolated 3.3V signals, VCC (To the input of the opto-isolator, next to the IN pins) should be connected to the 3.3V device’s +3.3V supply.”

    Do not misunderstand me, I am not saying that the connection presented by D Khaz is not working, or bad, but according to the datasheets, it is not compliant. I am just building an automated sprinkler solution based on esp8266 and this type of relays, and would want it to be on the safe side, have it work reliable.

    I would also be curious about D Khaz’s opinion on the topic too.

  13. BobT BobT

    BBK, Thanks for the quick response. I agree with the 3.3v for the I/O, but I noticed that the interface came in various physical configurations. I found one from AliExpress that matched the physical configuration in the write-up: but could not find any electrical specs.

    Another version of the MCP23017 IO indicates it is compatible with both 3.3v and 5V levels: but has a different physical configuration.

    I was unable to find the specifications on the relay board. If you have them please send me a link.

  14. DK DK

    I drive 5v relays with it so I know it works for my application, but I’m not sure about 3.3v

  15. DK DK

    Yes, it would definitely work. You should also check out this form factor of the MCP chip as it might better alight to the 16 channel relay:

  16. BobT BobT

    DK, Just finished the project and it is working. Have two questions, I would like to configure one of the unused pins PA0 – PA7 as binary input. Added this sample code from HA:
    # Example configuration.yaml entry
    – platform: mcp23017
    i2c_address: 0x20
    0: PIR Office
    1: PIR Bedroom

    and received an error message:
    Platform not found: ‘binary_sensor.mcp23017’.
    platform: mcp23017
    i2c_address: 32
    0: PIR Office
    1: PIR Bedroom
    Any suggestion on how to add a binary sensor?

    Also on power up/reset all the relays are triggered . Can this be turned off?


  17. DK DK

    Yea, it’s easily configurable it just requires to use the appropriate syntax for that module

  18. Hola buenas tardes, estaba viendo tu proyecto y me interesaría poder modificarlo para su integración con domoticz. El problema es que no puedo visualizar tu código me lo podrías pasar?

    Nahuel Baglietto

  19. Hello good afternoon, I was looking at your project and I would be interested in modifying it for integration with domoticz. The problem is that I cannot visualize your code, could you provide me with the code?

    Nahuel Baglietto

  20. Hello Dmitriy, I like your project and I would be interested to be able to modify it for its integration with domoticz and google assistant. Could you provide me with the code? since on the page I do not see it.

    Thanks a lot
    Nahuel Baglietto

  21. DK DK

    Hi Carlos, there is no code, just configuration. The project itself is on GitHub.

  22. Tienes una direccion en github ? me podrias pasar la url
    Muchas gracias
    Nahuel Baglietto

  23. Ok I apologize, I had not realized that it was an option with a different firmware from the wemos d1 mini. I was thinking about something else when I read ESPHome I imagined it was a server like domoticz or openHAB or

    Thank you and sorry for the misunderstanding

  24. Anonymous Anonymous

    Hey DK
    I like your writeup, the yaml configuration is empty though…

  25. DK DK

    If you run HASSos, you can install esphome as an add on with only a few clicks. In my setup, I run both home assistant and esphome using docker containers

  26. DK DK

    Carlos, My YAML configuration code may not have been displayed on the site when you looked at it. Check again and see if it makes a bit more sense now.

  27. DK DK

    De nada

  28. Patryk Patryk


    Thanks for great solution. I have implemented it but have some issue with turning on relays during reset. I have tried all ‘restore_mode’ from GPIO config but still the same response. Have You managed to figure out this issue? Below my code, maybe I am missing something? Will be grateful for some tips.

    name: przekazniki_2
    platform: ESP8266
    board: d1_mini

    ssid: xxx
    password: xxx

    # Enable logging

    # Enable Home Assistant API
    password: xxx

    password: xxx

    sda: D1
    scl: D2
    scan: False

    – id: ‘mcp23xxx_hub4’
    address: 0x25


    – platform: restart
    name: “Restart przekaźniki_2 dół”

    – platform: gpio
    restore_mode: ALWAYS_OFF
    mcp23xxx: mcp23xxx_hub4
    number: 8
    mode: OUTPUT
    inverted: True
    id: relay49
    – platform: template
    name: relay_channel_49
    icon: mdi:electric-switch
    – switch.turn_on: relay49
    – delay: 500ms
    – switch.turn_off: relay49
    – switch.turn_off: relay49

    and so on for other relays, I have many of them…

  29. DK DK

    Try thinking through it from start to finish. Are your relays high trigger or low trigger? If they are low-trigger you can activate the pull-up resistors inside the mcp23017. Alternatively, if they are high-trigger you can add external pull-down resistors. You can also try looking at the ESPHome logs when it’s booting to see if it’s doing anything odd to cause it to turn on momentarily, although restore_mode should take care of that.

  30. Patryk Patryk

    My idea of configuration is to use relay as “Momentary switch”, see this in ESPhome description below. It activates relay for period of 500ms, like an impulse signal to activate other things I have in my electrical box.

    Other connections and configuration are exactly as in Your description. Restore mode reconfiguration unfortunately does not help anything. I will gather logs for further discussion.

  31. Patryk Patryk

    It took some time but finally I made logs. First part from booting esp and later on with software triggered restart. In addition I have added to code “Restore Mode: Always OFF” to indicate that it does not help anything with triggering shortly all relays during booting.

  32. Shane Shane

    Hello, soo i got all this working, But ive been trying to add the relays to the home automation part in home assistant, but the relays dont show up, but yet i can add them to lovelace dashboard

  33. DK DK

    There is no home automation part in Home Assistant. If you can add them to your dashboard, then everything is working as it should. You can also check under your ESPHome device in the Integrations section.

    Are you trying to create an automation controlling one of the relays?

  34. Anonymous Anonymous

    I went to modify some of my code and noticed the following note:

    ‘mcp23017:’ has been removed from the pin schema in 1.17.0, please use ‘mcp23xxx:’.

    Any suggestions on what to do next??

    Bob T

  35. DK DK

    The schema (name of the sensors) has changed since I originally wrote this code a few years ago. I’ll try to post an update.

  36. Anonymous Anonymous

    Thinks, what i tried and it worked was simply replaced “mcp23017” with “mcp23xxx” and the message went away and everything seems to be working ok.

Leave a Reply

Your email address will not be published. Required fields are marked *