Tutorial Domoticz Switch

From Let's Control It
Jump to navigation Jump to search

This tutorial will guide you to connect your first ESP Easy switch to Domoticz. We expect that you have a working Domoticz setup and have loaded the ESP Easy firmware onto your ESP.

In this tutorial, we use a simple switch demonstration so you don't need a real sensor attached to your ESP. A barebone ESP-01 should be sufficient for this tutorial. It will mainly demonstrate the basis steps to connect ESP to Domoticz by using the ESP Easy firmware.

Add virtual hardware

To be able to communicate with devices like the ESP, we have to add virtual hardware to Domoticz. This step has to be done only once in your setup.

From the main Domoticz Menu, Select Setup -> Hardware

Tutorial Domoticz Menu.png

And add following hardware to you system:

Tutorial Domoticz Add Hardware.png

Create a virtual sensor

The new hardware should be in the list and there should be a button "Create Virtual Sensors"

Tutorial Domoticz Create Sensor.png

Click this button and choose Sensor Type "Switch"

Tutorial Domoticz Add Sensor.png

Add device to your system

Now we have to add the device in Domoticz to become active.

From the main Domoticz Menu, Select Setup -> Devices

Tutorial Domoticz Menu.png

Your new switch device should be listed here

Tutorial Domoticz Device List.png

Please note the number below "IDX". This is the unique reference to this device and we need it later on to configure the ESP Easy module. In this case the IDX number is 250.

Click the little green button with the arrow pointing in the right direction to add this device

Tutorial Domoticz Device Add.png

Name this device "Demo" and click add device.

Navigate to menu "Switches" and your device should be listed:

Tutorial Domoticz Device.png

Connect the ESP Easy to your network

If you have your ESP board loaded with ESP Easy firmware, powerup the unit and an Access point named "ESP_0" should appear. Connect to this access point and browse to If all went well, the following screen should be shown:

Easy Main.png

Click the "Config" button

Tutorial Easy Config.png

Configure at least the following settings to get you started:

Protocol Domoticz HTTP
Controller IP = your Domoticz server IP
Controller Port = your Domoticz server port, default should be 8080

Click the "Submit" button

Click the "Tools" button and Click "Connect"

Tutorial Easy Tools.png

Go back to "Main" and chech the status. It should have an IP address:

Tutorial Easy Connected.png

From here on, you should start using to connect to your ESP device.

Configure the ESP Easy Devices

Click the "Devices" button

Tutorial Easy Devices.png

Click the "Edit" button on the first row

Tutorial Easy DevicesConfig1.png

Select "Switch Input" and enter the IDX found earlier in Domoticz. In our demo it was 250.

click "Submit" to get additional settings for this device

Tutorial Easy DevicesConfig2.png

This should be the final result:

Tutorial Easy DevicesConfig3.png


Now toggle GPIO-0 pin high and low and the light bulb in Domoticz should turn on/off accordingly!

(if you're using a NodeMCU board, you just have to toggle the "flash" button)

Another way to set up Domoticz to control an ESP Easy

Tutorial - Domoticz to control an ESP as a light switch