Tom's Life Bits

Edit the page and hit Save. See syntax for Wiki syntax. Please edit the page only if you can improve it. If you want to test some things, learn to make your first steps on the playground.

===== OpenHAB Switch =====
This tutorial will guide you to connect your first ESP Easy to OpenHAB to control a digital output on the ESP (i.e. to drive a relay). We expect that you have a working OpenHAB setup, a MQTT broker running and have loaded the ESP Easy firmware onto your ESP. In our testlab, we ran OpenHab on Windows and the Mosquitto MQTT broker on a RaspberryPI (it was already there due to some earlier experiments...)\\

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 and a LED + resistor should be sufficient for this tutorial. It will mainly demonstrate the basis steps to connect ESP to OpenHAB by using the ESP Easy firmware.\\

==== Get MQTT working ====
To be able to communicate with devices like the ESP, we have to get MQTT support into OpenHAB. This step has to be done only once in your setup.

We have used the Demo on OpenHAB to develop this support and we will be using that as a start.

In case MQTT is not setup already, please change the openhab.cfg file:
<code>
mqtt:localbroker.url=tcp://192.168.0.8:1883
mqtt:localbroker.clientId=openHAB
</code>
We had our broker service running on 192.168.0.8, please change to your local situation.\\

==== Add the MQTT binding file ====
If not done already, add the MQTT binding jar to the addon folder. We added this file:\\
<code>
org.openhab.binding.mqtt-1.7.1.jar
</code>

==== Change sitemap ====
You need to configure a switch device for this demo, we added the following to the demo sitemap:
<code>
Frame label="MQTT Test"{
 Switch item=MQTTLED label="LED"
}
</code>

==== Change items ====
And we have to configure how this device will work, in this case MQTT. Add following line to your items file:
<code>
Switch MQTTLED {mqtt=">[localbroker:/openhabdemo/gpio/2:command:ON:1],>[localbroker:/openhabdemo/gpio/2:command:OFF:0]"}
</code>
We tell openhab to use MQTT for this switch, communicate with the broker named "localbroker" and publish this to /openhabdemo/gpio/2 where "openhabdemo" is the name of the ESP module, "gpio" tells ESP what to do with the state value and "2" is the GPIO pin number that should be switched. And we tell that ON sends value 1 and OFF sends value 0.

Finally launch the OpenHAB gui and it should look like this:\\
{{:2016:ha:tutorial_openhab_gui.png?400|}}

==== Connect the ESP Easy to your network ====
f 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 http://192.168.4.1. If all went well, the following screen should be shown:\\
{{:2016:ha:easy_main.png?400|}}
Click the "Config" button\\
{{:2016:ha:tutorial_openhab_switch.png?400|}}
Configure at least the following settings to get you started:\\
<code>
SSID
WPA
Protocol OpenHAB MQTT
Controller IP = your MQTT Broker IP
Controller Port = your MQTT broker server port, default should be 1883
</code>
Click the "Submit" button\\

Click the "Tools" button and Click "Connect"\\
{{:2016:ha:tutorial_easy_tools.png?400|}}
Go back to "Main" and chech the status. It should have an IP address:\\
{{:2016:ha:tutorial_easy_connected.png?400|}}

From here on, you should start using http://192.168.0.232 to connect to your ESP device.

Since this will be an output device, we do not have to configure any devices on the ESP.\\

==== Testing ====

Connect an LED or Relay board to the GPIO-2 pin on the ESP and toggle the LED button in OpenHAB webgui. The LED of Relay should respond almost immediately!

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Noncommercial-Share Alike 4.0 International