ESP Wordclock

Setup

Initial Setup

Install the firmware on the ESP: The ESP must be set into the bootloader mode, like this

The firmware can be downloaded with the following script:

cd os/
./flash.sh ttyUSB0

Connect to the ESP via a terminal emulator like screen using a baud rate of 115200. Then format the filesystem and reboot the ESP with the following commands:

file.format()
node.restart()

Then disconnect the serial terminal and copy the required files to the microcontroller:

./tools/initialFlash.sh /dev/ttyUSB0

Upgrade

Determine the IP address of your clock and execute the following script:

./tools/remoteFlash.sh IP-Address

Hardware Setup

Mandatory:

• GPIO2 LEDs
• GPIO0 Bootloader (at start)
• GPIO0 factory reset (long during operation) Optinal:
• ADC VT93N2, 48k light resistor

MQTT Interface

Status

• basetopic/brightness Current brightness in percent
• basetopic/background Current background color

Commands

• basetopic/cmd/single
  • ON Set brightness to 100%
  • OFF Set brightness to 0%
  • 0-100 Set brightness to given value
  • #rrggbb Background color is set to hex representation of red, green and blue
  • 0-255,0-255,0-255 Background color is set to decimal representation of red, green an blue
• basetopic/cmd/telnet
  • ignored Stop MQTT server and start telnetserver at port 23

OpenHAB2

Tested MQTT with binding-mqtt 2.5.x

Configuration

Thing mqtt:topic:wordclock "Wordclock" (mqtt:broker) @ "MQTT"  {
  Channels:
   Type dimmer : dim "Dimming" [ stateTopic="basetopic/brightness", commandTopic="basetopic/cmd/single" ]
   Type string : cmd "Command" [ commandTopic="basetopic/cmd/single" ]
   Type switch : active "Active" [ commandTopic="basetopic/cmd/single" ]
   Type colorRGB : background "Background" [ stateTopic="basetopic/background", commandTopic="basetopic/cmd/single", on="28,0,0", off="0,0,0" ]
}