Wrong credentials
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
.
Admin password
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 should have at least
eight characters
(letters, numbers or the underscore) and at least
one number
,
one lowercase
and
one uppercase
letter.
Admin password (repeat)
Update
ESPurna 0.0.0
STATUS
GENERAL
WIFI
MQTT
NTP
DOMOTICZ
INFLUXDB
POWER
ADMIN
Update
Reconnect
Reset
STATUS
Current configuration
Analog
Temperature (
)
Temperature (
)
Humidity (%)
Apparent Power (VA)
Current (A)
Active Power (W)
Apparent Power (VA)
Reactive Power (VAR)
Current (A)
Voltage (V)
Power Factor
Manufacturer
Device
Chip ID
MAC
Network
IP
ESPurna Version
ESPurna Build
MQTT Status
NTP Status
GENERAL
General configuration values
Hostname
This name will identify this device in your network (http://<hostname>.local). For this setting to take effect you should restart the wifi interface clicking the "Reconnect" button.
Switch boot mode
Always OFF
Always ON
Same as before
Toogle before
Here you can define what will be the status of the switch after a reboot.
Switch sync mode
No synchonisation
Zero or one switches active
One and just one switch active
All synchonised
Define how the different switches should be synchronized.
Switch pulse mode
Don't pulse
Normally OFF (stays on for a short time)
Normally ON (stays off for a short time)
When pulse mode is enabled the switch will automatically switch back to its normal state after the pulse time (below).
Switch pulse time
Pulse time in seconds (maximum value is 60s, accepts decimals).
Double click delay
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
reset the device
after updating for this setting to apply.
Use colorpicker
Use color picker for the first 3 channels as RGB.
Will only work if the device has at least 3 dimmable channels.
Use white channel
Use forth dimmable channel as white when first 3 have the same RGB value.
Will only work if the device has at least 4 dimmable channels.
Use gamma correction
Use gamma correction for RGB channels.
Will only work if "use colorpicker" above is also ON.
Alexa integration
Temperature units
Celsius (ºC)
Fahrenheit (ºF)
Settings
Backup
Restore
ADMINISTRATION
Device administration and security settings
Admin password
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 should have at least
eight characters
(letters, numbers or the underscore) and at least
one number
,
one lowercase
and
one uppercase
letter.
Admin password (repeat)
HTTP port
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/
Enable HTTP API
HTTP API Key
Generate
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
.
Upgrade
Browse
Upgrade
WIFI
You can configure up to 5 different WiFi networks. The device will try to connect in order of signal strength.
Add network
MQTT
Configure an
MQTT broker
in your network and you will be able to change the switch status via an MQTT message. Leave the server field empty to disable MQTT.
MQTT Server
MQTT Port
MQTT User
MQTT Password
MQTT Root Topic
This is the root topic for this device. A trailing slash will be added if not preset. The {identifier} placeholder will be replaces by the device hostname.
-
<root>/relay/#
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>/color
The device will report the current color in #RRGGBB format to this topic. You can also set the color using this same topic.
-
<root>/led/#
Send a 0 or a 1 as a payload to this topic to set the onboard LED to the given state, send a 3 to turn it back to WIFI indicator. Replace # with the LED ID (starting from 0). If the board has only one LED it will be 0.
-
<root>/button/#
For each button in the board subscribe to this topic to know when it is pressed (payload 1) or released (payload 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
.
Use JSON payload
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.
Subscribtions 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.
NTP Server 1
NTP Server 2
NTP Server 3
Time offset
Set to 0 for UTC time
Enable Daylight Saving Time
DOMOTICZ
Configure the connection to your Domoticz server.
Domoticz IN Topic
Domoticz OUT Topic
Temperature IDX
Set to 0 to disable notifications.
Humidity IDX
Set to 0 to disable notifications.
Power IDX
Set to 0 to disable notifications.
Energy increment IDX
Set to 0 to disable notifications.
Voltage IDX
Set to 0 to disable notifications.
Current IDX
Set to 0 to disable notifications.
Analog IDX
Set to 0 to disable notifications.
INFLUXDB
Configure the connection to your InfluxDB server. Leave the host field empty to disable InfluxDB connection.
Host
Port
Database
Username
Password
POWER
Calibrate your power monitor device. Use a pure resistive load and introduce the expected values for active power, current and voltage. Use the nominal values or a multimeter to get the proper numbers. Set any field to 0 to leave the calibration value untouched.
AC RMS Active Power
In Watts (W). If you are using a pure resistive load like a bulb this will be writen on it, otherwise use a socket multimeter to get this value.
AC RMS Voltage
In Volts (V). Enter your the nominal AC voltage for your household or facility, or use multimeter to get this value.
AC RMS Current
In Ampers (A). If you are using a pure resistive load like a bulb this will the ratio between the two previous values, i.e. power / voltage. You can also use a current clamp around one fo the power wires to get this value.
Reset calibration
Move this switch to ON and press "Update" to revert to factory values.
Network SSID
...
Password
Static IP
Leave empty for DNS negotiation
Gateway IP
Set when using a static IP
Network Mask
Usually 255.255.255.0 for /24 networks
DNS IP
Set the Domain Name Server IP to use when using a static IP
Del
Switch
Status
Switch
IDX
Set to 0 to disable notifications.
Color
Brightness
Channel #