SECURITY

Before using this device you have to change the default password for the user admin. This password will be used for the AP mode hotspot, the web interface (where you are now) and the over-the-air updates.

Password must be 8..63 characters (numbers and letters and any of these special characters: _,.;:~!?@#$%^&*<>\|(){}[]) and have at least one lowercase and one uppercase or one number.

STATUS

Current configuration

Manufacturer
Device
Chip ID
Wifi MAC
SDK version
Core version
Firmware name
Firmware version
Firmware revision
Firmware build date
Firmware size
Free space
Network
BSSID
Channel
RSSI
IP
(telnet)
Free heap
Load average
%
VCC
? mV
MQTT Status
NTP Status
Current time
Uptime
Last update
? seconds ago

GENERAL

General configuration values

This name will identify this device in your network (http://<hostname>.local).
Hostname may contain only the ASCII letters 'a' through 'z' (in a case-insensitive manner), the digits '0' through '9', and the hyphen ('-'). They can neither start or end with an hyphen.
For this setting to take effect you should restart the wifi interface by clicking the "Reconnect" button.
Delay in milliseconds to detect a double click (from 0 to 1000ms).
The lower this number the faster the device will respond to button clicks but the harder it will be to get a double click. Increase this number if you are having trouble to double click the button. Set this value to 0 to disable double click. You won't be able to set the device in AP mode manually but your device will respond immediately to button clicks.
You will have to reboot the device after updating for this setting to apply.
This setting defines the behaviour of the main LED in the board.
When in "WiFi status" it will blink at 1Hz when trying to connect. If successfully connected it will briefly blink every 5 seconds if in STA mode or every second if in AP mode.
When in "Relay status" mode the LED will be ON whenever any relay is ON, and OFF otherwise. This is global status notification.
When in "MQTT managed" mode you will be able to set the LED state sending a message to "<base_topic>/led/0/set" with a payload of 0, 1 or 2 (to toggle it).
When in "Find me" mode the LED will be ON when all relays are OFF. This is meant to locate switches at night.
When in "Relay & WiFi" mode it will follow the WiFi status but will stay mostly off when relays are OFF, and mostly ON when any of them is ON.
When in "Find me & WiFi" mode is the opposite of the "Relay & WiFi", it will follow the WiFi status but will stay mostly on when relays are OFF, and mostly OFF when any of them is ON.
"Always ON" and "Always OFF" modes are self-explanatory.

SWITCHES

Switch / relay configuration

General
Define how the different switches should be synchronized.

ADMINISTRATION

Device administration and security settings

The administrator password is used to access this web interface (user 'admin'), but also to connect to the device when in AP mode or to flash a new firmware over-the-air (OTA).
It must be 8..63 characters (numbers and letters and any of these special characters: _,.;:~!?@#$%^&*<>\|(){}[]) and have at least one lowercase and one uppercase or one number.
This is the port for the web interface and API requests. If different than 80 (standard HTTP port) you will have to add it explicitly to your requests: http://myip:myport/
If enabled, API requests to change a status (like a relay) must be done using PUT. If disabled you can issue them as GET requests (easier from a browser).
By default, some magnitudes are being preprocessed and filtered to avoid spurious values. If you want to get real-time values (not preprocessed) in the API turn on this setting.
This is the key you will have to pass with every HTTP request to the API, either to get or write values. All API calls must contain the apikey parameter with the value above. To know what APIs are enabled do a call to /apis.
Turn ON to be able to telnet to your device while connected to your home router.
TELNET is always enabled in AP mode.
This name address of the NoFUSS server for automatic remote updates (see https://bitbucket.org/xoseperez/nofuss).
The device has bytes available for OTA updates. If your image is larger than this consider doing a two-step update.

WIFI

You can configure up to 5 different WiFi networks. The device will try to connect in order of signal strength.

General
ESPurna will scan for visible WiFi SSIDs and try to connect to networks defined below in order of signal strength, even if multiple AP share the same SSID. When disabled, ESPurna will try to connect to the networks in the same order they are listed below. Disable this option if you are connecting to a single access point (or router) or to a hidden SSID.
Networks

SCHEDULE

Turn switches ON and OFF based on the current time.

MQTT

Configure an MQTT broker in your network and you will be able to change the switch status via an MQTT message.

If left empty the firmware will generate a client ID based on the serial number of the chip.
This is the fingerprint for the SSL certificate of the server.
You can get it using https://www.grc.com/fingerprints.htm
or using openssl from a linux box by typing:
$ openssl s_client -connect <host>:<port> < /dev/null 2>/dev/null | openssl x509 -fingerprint -noout -in /dev/stdin
This is the root topic for this device. The {hostname} and {mac} placeholders will be replaced by the device hostname and MAC address.
- <root>/relay/#/set Send a 0 or a 1 as a payload to this topic to switch it on or off. You can also send a 2 to toggle its current state. Replace # with the switch ID (starting from 0). If the board has only one switch it will be 0.
- <root>/status The device will report a 1 to this topic every few minutes. Upon MQTT disconnecting this will be set to 0.
- Other values reported (depending on the build) are: firmware and version, hostname, IP, MAC, signal strenth (RSSI), uptime (in seconds), free heap and power supply.
All messages (except the device status) will be included in a JSON payload along with the timestamp and hostname and sent under the <root>/data topic.
Messages will be queued and sent after 100ms, so different messages could be merged into a single payload.
Subscriptions will still be done to single topics.

NTP

Configure your NTP (Network Time Protocol) servers and local configuration to keep your device time up to the second for your location.

DOMOTICZ

Configure the connection to your Domoticz server.

General
Sensors & actuators
Set IDX to 0 to disable notifications from that component.

HOME ASSISTANT

Add this device to your Home Assistant.

Discover
Home Assistant auto-discovery feature. Enable and save to add the device to your HA console.
Configuration
These are the settings you should copy to your Home Assistant "configuration.yaml" file. If any of the sections below (switch, light, sensor) already exists, do not duplicate it, simply copy the contents of the section below the ones already present.

THINGSPEAK

Send your sensors data to Thingspeak.

General
Sensors & actuators
Enter the field number to send each data to, 0 disable notifications from that component.

INFLUXDB

Configure the connection to your InfluxDB server. Leave the host field empty to disable InfluxDB connection.

DEBUG LOG

Shows debug messages from the device

Write a command and click send to execute it on the device. The output will be shown in the debug text area below.
Leave empty for DHCP negotiation
Set when using a static IP
Usually 255.255.255.0 for /24 networks
Set the Domain Name Server IP to use when using a static IP
 h
 m
 1 for Monday, 2 for Tuesday...
Switch # (GPIO)