Skip to content

Latest commit

 

History

History
109 lines (77 loc) · 5.11 KB

README.md

File metadata and controls

109 lines (77 loc) · 5.11 KB
Raw

Home Automation (Wi-Fi Relay Board)

 -- Wemos D1 mini code and circuit design for a remotely controllable (using HTTP and MQTT) array of relays, meant to be concealed inside standard switchboards.

This is basically a "Smart Switch" project, with the following features:

  1. It is open source!
  2. It has an array of 5 relays controlled by a Wemos D1 Mini MCU.
  3. Control is possible by HTTP API call and by MQTT messaging (simultaneously, if required).
  4. The system provides on-demand and periodic feedback regarding the state of the connected devices/appliances.
  5. It is meant to be compact, so it can be installed inside standard switchboards
  6. The PCB is designed to be "scalable". So it can be literally cut to the user's needs. So if the switchboard is small, with fewer than 5 switches that need to be automated, then the board can be cut to just include the needed number of relays.
  7. The relays can be easily wired to existing wall switches. They can either be connected in parallel to the existing switches, or be connected in a "staircase wiring" configuration to 2-way switches that replace existing 1-way switches, allowing independent control of the lights/fans both electronically (remotely) and manually.
  8. The system exposes a basic Web-UI to let the user configure the Wi-Fi router and MQTT Server IP address details and also show status of the "loads" connected, and to control them.
  9. There is no "cloud component" or other app dependencies for using this system. All network traffic is local.
  10. The state of loads connected to the relay board is persisted on the Wemos, each time any state changes. This saved state can be optionally used to restore the load states after a power-cycle (reboot) of the system.
  11. MQTT Broker server is optional and can be disabled from the Web-UI.

Configuration

Upon first boot, the Wemos starts up in AP mode with SSID RelayBoard and the Web-UI is accessible at http://relay.local/ OR http://192.168.4.1 from a computer or mobile phone connected to the RelayBoard Wi-Fi network. The home router SSID and password and other details can be entered and saved (persisted on the Wemos). Upon restarting, the Wemos should connect to the home router and get an IP address from there. Now the Web-UI should still be accessible at http://relay.local/ or at http://<whatever IP address the Wemos got from the router>/

Web-User Interface

Drawing

Control API

HTTP Control API

To turn ON the 4th Load (connected to the 4th Relay), the URL is:

http://<IP_Address_of_Wemos>/relay-control?l=4,1

Note that the query parameter is "l", for "'l'oad".

To turn OFF the 4th Load (connected to the 4th Relay), the URL is:

http://<IP_Address_of_Wemos>/relay-control?l=4,0

To turn ON all 5 Loads, the URL is:

http://<IP_Address_of_Wemos>/relay-control?l=0,1

To turn OFF all 5 Loads, the URL is:

http://<IP_Address_of_Wemos>/relay-control?l=0,0

One can toggle the state of a load. For example, to toggle load #4, the URL is:

http://<IP_Address_of_Wemos>/relay-control?t=4

MQTT Control

All command messages are to be sent to the topic relay-control

To turn ON the 4th Load (connected to the 4th Relay), the MQTT message to be sent is:

l,4,1

Note that the first character in the message is "l", for "'l'oad".

So the mosquitto_pub command would be:

mosquitto_pub -q 1 -h 172.20.1.120 -t relay-control -m l,4,1

where 172.20.1.120 is the MQTT Broker Server IP address

Similarly, to turn OFF all 5 Loads, the command would be

mosquitto_pub -q 1 -h 172.20.1.120 -t relay-control -m l,0,0

To toggle load #4, the command is:

mosquitto_pub -q 1 -h 172.20.1.120 -t relay-control -m t,4

Replacing 'l' with 'r' (for "'r'elay") in the above 'l' commands and messages would control the relay state. In this case, the state of the actual load is not considered. The actual load can be OFF while the relay is ON, and vice-versa due to the "staircase wiring".

Feedback

Whenever the state of any load changes, and also periodically every 3 seconds, an MQTT message containing the status of each load, and their corresponding relays (these need not be the same) is published from the Wemos on the topic relay-status. So the mosquitto_sub command to receive these status messages is:

mosquitto_sub -q 1 -h 172.20.1.120 -t relay-status

The message looks like this:

0,0,0,1,0|0,0,0,0,0

In the above example, the 4th Load is ON, with all other Loads OFF, and also, all Relays are OFF. A message like 0,1,0,0,0|0,0,1,0,0 indicates that the 2nd Load is ON, all other Loads are OFF, and also, the 3rd Relay is ON.

Circuit Schematic and PCB Design

The Circuit Schematic and PCB are drawn/designed in KiCAD and the associated project files are zipped and included in this project.

Prototype

Prototype