Commands¶
LK4 can be controlled by commands that can be sent via HTTP or MQTT.
Additionally, the version with an LTE modem also supports SMS commands.
How to use commands¶
Almost every command has the structure NAME=VALUE
.
HTTP¶
To send a command via HTTP, send an HTTP GET request to the address /api/v1/save/
, e.g.
http://[IP]/api/v1/save/?out1=1
http://[IP]/api/v1/save/?out=out1
http://[IP]/api/v1/save/?outName1=Lampa%20Biurko
Multiple commands can be sent in one query, e.g.
http://[IP]/api/v1/save/?out1=1&out2=1&out3=1&out4=1&out5=1&out6=1
Special characters in parameter values
Please note that spaces and special characters in the GET parameter value must be replaced with their hex ASCII codes, e.g. space
= %20
, %
= %25
.
MQTT¶
To send commands via MQTT, you need an MQTT client, e.g. a web client on our website
After configuring MQTT client and successfully connecting to the MQTT server, you can send commands on [Topic prefix]/cmd
with content similar to HTTP commands, e.g.
out1=1
out=out1
outName1=Lampa Biurko
With MQTT, you also can send multiple commands in one message, e.g.
out1=1&out2=1&out3=1&out4=1&out5=1&out6=1&out7=1
It is worth noting that there is no need for character encoding as in the case of HTTP.
Each command is confirmed with a reply 1
on the subject [Topic prefix]/cmdr
. In the case of messages with multiple commands, there will be multiple replies - one for each command.
SMS¶
Only for LK4 with LTE modem
Commands in SMS messages must have the appropriate structure:
[ACCESS CODE]:cmd:[COMMAND]
For example:
1234:cmd:out=out1
Unlike HTTP and MQTT, only single commands can be sent via SMS, they cannot be combined using &
.
In the modem configuration, you can enable the Send return SMS after SMS command option to receive reply SMS messages with the content, e.g. cmd ack SMS from LK4 uptime=1874
.
List of commands¶
UI settings¶
webRefresh¶
How often values from the device are refreshed on the page, value in seconds.
webRefresh=[A]
A
- real number0.3 - 3276
.
webLanguage¶
User interface language.
webLanguage=[A]
-
A
- integer{ 0: 'PL', 1: 'EN', 2: 'FR', 3: 'HU', 4: 'CZ', }
webUserSetNames¶
When enabled, the reading names will be displayed as just user-set names without standard names, e.g. Inside temp instead of DS1 - Inside temp.
webUserSetNames=[A]
A
- integer0-1
webReadOnlyUser¶
The user will only be able to read the data, not able to control the outputs on the page Status for user.
webReadOnlyUser=[A]
A
- integer0-1
webAutoSignIn¶
Automatically sign in as administrator when visiting the index page (skip the login page). When this option is enabled, logout has no effect and user sign in is disabled.
webAutoSignIn=[A]
A
- integer0-1
webHomepage¶
The page that will be loaded after signing in.
webHomepage=[A]
-
A
- integer0-3
{ 0: 'Status', 1: 'StatusUser', 2: 'SerialPort', 3: 'Modbus', }
webVisibility¶
Specifies the visibility of elements on the Status and User Status pages.
webVisibility=[A]
-
A
- a sequence of 140 digits0-1
(currently the first 127 are used), where subsequent digits correspond to the visibility of elements.{ 0: 'OUT1 showValue', 1: 'OUT1 showName', 2: 'OUT2 showValue', 3: 'OUT2 showName', 4: 'OUT3 showValue', 5: 'OUT3 showName', 6: 'OUT4 showValue', 7: 'OUT4 showName', 8: 'OUT5 showValue', 9: 'OUT5 showName', 10: 'OUT6 showValue', 11: 'OUT6 showName', 12: 'PWM1 showValue', 13: 'PWM1 showName', 14: 'PWM1 showDuty', 15: 'PWM2 showValue', 16: 'PWM2 showName', 17: 'PWM2 showDuty', 18: 'PWM3 showValue', 19: 'PWM3 showName', 20: 'PWM3 showDuty', 21: 'VAR1 show', 22: 'VAR2 show', 23: 'VAR3 show', 24: 'VAR4 show', 25: 'VAR5 show', 26: 'VAR6 show', 27: 'VAR7 show', 28: 'VAR8 show', 29: 'iA1 showValue', 30: 'iA1 showName', 31: 'iA2 showValue', 32: 'iA2 showName', 33: 'iA3 showValue', 34: 'iA3 showName', 35: 'DS1 showName', 36: 'DS1 showValue', 37: 'DS2 showName', 38: 'DS2 showValue', 39: 'DS3 showName', 40: 'DS3 showValue', 41: 'DS4 showName', 42: 'DS4 showValue', 43: 'DS5 showName', 44: 'DS5 showValue', 45: 'DS6 showName', 46: 'DS6 showValue', 47: 'DS7 showName', 48: 'DS7 showValue', 49: 'DS8 showName', 50: 'DS8 showValue', 51: 'T1 showName', 52: 'T1 showValue', 53: 'H1 showName', 54: 'H1 showValue', 55: 'P1 showName', 56: 'P1 showValue', 57: 'IAQ show', 58: 'DewPoint show', 59: 'PM1 showName', 60: 'PM1 showValue', 61: 'PM2.5 showName', 62: 'PM2.5 showValue', 63: 'PM4 showName', 64: 'PM4 showValue', 65: 'PM10 showName', 66: 'PM10 showValue', 67: 'CO2 showName', 68: 'CO2 showValue', 69: 'm1 show', 70: 'm2 show', 71: 'm3 show', 72: 'm4 show', 73: 'm5 show', 74: 'm6 show', 75: 'm7 show', 76: 'm8 show', 77: 'm9 show', 78: 'm10 show', 79: 'm11 show', 80: 'm12 show', 81: 'm13 show', 82: 'm14 show', 83: 'm15 show', 84: 'm16 show', 85: 'm17 show', 86: 'm18 show', 87: 'm19 show', 88: 'm20 show', 89: 'm21 show', 90: 'm22 show', 91: 'm23 show', 92: 'm24 show', 93: 'm25 show', 94: 'm26 show', 95: 'm27 show', 96: 'm28 show', 97: 'm29 show', 98: 'm30 show', 99: 'DIFF1 showValue', 100: 'DIFF2 showValue', 101: 'DIFF3 showValue', 102: 'DIFF4 showValue', 103: 'DIFF5 showValue', 104: 'DIFF6 showValue', 105: 'iD1 show', 106: 'iD2 show', 107: 'iD3 show', 108: 'iD4 show', 109: 'POWER1 showName', 110: 'POWER1 showValueP', 111: 'POWER1 showValueE', 112: 'POWER2 showName', 113: 'POWER2 showValueP', 114: 'POWER2 showValueE', 115: 'POWER3 showName', 116: 'POWER3 showValueP', 117: 'POWER3 showValueE', 118: 'POWER4 showName', 119: 'POWER4 showValueP', 120: 'POWER4 showValueE', 121: 'POWER5 showName', 122: 'POWER5 showValueP', 123: 'POWER5 showValueE', 124: 'POWER6 showName', 125: 'POWER6 showValueP', 126: 'POWER6 showValueE', }
webPositionTop¶
Specifies the positions of elements on the Status for user page, specifically the offset from the top in px relative to the default position.
webPositionTop=[A]
A
- sequence of 84 integers-1024 - 1024
separated by a*
character.
webPositionLeft¶
Specifies the positions of elements on the Status for user page, specifically the offset from the left in px relative to the default position.
webPositionLeft=[A]
A
- sequence of 84 integers-1024 - 1024
separated by a*
character.
General¶
restartFlag¶
Sets a flag that is reset on device startup. This allows you to quickly check whether there has been a restart of the device since the last flag setting.
restartFlag=1
eeprom_reset¶
Restores settings to default values.
eeprom_reset=1
restart¶
Restarts the device.
restart=1
Others¶
varName¶
Added in SW 1.06
Sets the name for the VAR (1-8) variable.
varName[A]=[B]
A
- variable number, integer1-8
B
- string up to 15 characters
var¶
Sets the state of the VAR (1-8) variable.
var[A]=[B]
A
- variable number, integer1-8
B
- state to set, integer0-1
Outputs¶
out¶
Sets the state of the output. The command has two variants - one to change the state to the opposite and the other to set a specific state (syntax of both variants below).
out=out[A]
A
- output number, integer1-6
out[A]=[B]
A
- output number, integer1-6
B
- state to set, integer0-1
outName¶
Sets the name of the output.
outName[A]=[B]
A
- output number, integer1-6
B
- string up to 15 characters
outResetTime¶
Sets the return time. It causes that after turning on the output, it will turn off automatically after a set time.
outResetTime[A]=[B]
A
- output number, integer1-6
B
- time in seconds, integer0-65535
outAutoSwitch¶
Activates periodic switching of the output state with preset on and off times.
outAutoSwitch[A]=[B]
A
- output number, integer1-6
B
- integer0-1
outAutoSwitchH¶
Sets the output ON time for periodic switching.
outAutoSwitchH[A]=[B]
A
- output number, integer1-6
B
- time in seconds, integer0-65535
outAutoSwitchL¶
Sets the output OFF time for periodic switching.
outAutoSwitchL[A]=[B]
A
- output number, integer1-6
B
- time in seconds, integer0-65535
outStartOn¶
Activates the function to turn on the output with a specified delay after starting the device.
outStartOn[A]=[B]
A
- output number, integer1-6
B
- integer0-1
outStartOnTime¶
Sets the delay time after which the output will be turned on.
outStartOnTime[A]=[B]
A
- output number, integer1-6
B
- time in seconds, integer0-65535
outSaveState¶
Activates the function of saving the output state so that it is restored after restarting the device.
outSaveState[A]=[B]
A
- output number, integer1-6
B
- integer0-1
outNegation¶
Activates the negation of the outputs. Makes 1
appear as OFF
and 0
as ON
.
outNegation=[A]
A
- integer0-1
outLock¶
Activates outputs state blocking from the level of HTTP/MQTT commands. The status will only be driven by device features such as Schedules, Events, Watchdog.
outLock=[A]
A
- integer0-1
PWM outputs¶
pwmName¶
Sets the name of the PWM output.
pwmName[A]=[B]
A
- output number, integer1-3
B
- string up to 15 characters
pwm¶
Sets the state of the PWM output. The command has two variants - one to change the state to the opposite and the other to set a specific state (syntax of both variants below).
pwm=pwm[A]
A
- output number, integer1-3
pwm[A]=[B]
A
- output number, integer1-3
B
- state to set, integer0-1
pwmDuty¶
Sets the duty cycle for the PWM output.
pwmDuty[A]=[B]
A
- output number, integer1-3
B
- the duty cycle in percent, integer0-100
pwmActiveLow¶
Enables mode Active low, that reverses the switch and fill factor of PWM output.
pwmActiveLow[A]=[B]
A
- output number, integer1-3
B
- integer0-1
pwmModeOnOff¶
Enables mode Mode ON/OFF, so the PWM output changes into a two-state output: on/off.
pwmModeOnOff[A]=[B]
A
- output number, integer1-3
B
- integer0-1
pwmFrequency¶
Sets the frequency for the PWM outputs.
pwmFrequency=[A]
A
- the frequency in Hz, integer1-1000000
pwmChangeTime¶
Sets the time over which the duty cycle of signal will be changed.
pwmChangeTime[A]=[B]
A
- output number, integer1-3
B
- the time in seconds, integer0-2147483647
Inputs¶
iAName¶
Sets a name for the analog input.
iAName[A]=[B]
A
- input number, integer1-3
B
- string up to 15 characters
iASensor¶
Ustawia czujnik dla wejścia.
iASensor[A]=[B]
A
- input number, integer1-3
-
B
- determines the sensor connected to the input, integer0-16
{ 0: "off", 1: "vin=3.3V/5V", // 5V for iA3 2: "vin=58V", 3: "ACS711EX_15", 4: "ACS711EX_30", 5: "ACS709_75", 6: "R=0.1", 7: "LA100-P", 8: "SCT-013-000", 9: "SCT-013-030", 10: "PT1000", 11: "4..20mA", 12: "AC meter", 13: "ACS711LC-12.5A", 14: "ACS711LC-25A", 15: "ACS712-20A", 16: "WCS1800", }
iACalibration¶
Sets the calibration for the input.
iACalibration[A]=[B]
A
- input number, integer1-3
B
- the calibration value, integer
iAMultiplier¶
Sets the multiplier for the input reading.
iAMultiplier[A]=[B]
A
- input number, integer1-3
B
- a multiplier, real number
dsName¶
Sets the name of the DS read.
dsName[A]=[B]
A
- DS sensor number, integer1-8
B
- string up to 15 characters
i2cTempName¶
Sets the name of the I2C sensor temperature reading.
i2cTempName=[A]
A
- string up to 15 characters
i2cHumName¶
Sets the name of the I2C sensor humidity reading.
i2cHumName=[A]
A
- string up to 15 characters
i2cPressureName¶
Sets the name of the I2C sensor pressure reading.
i2cPressureName=[A]
A
- string up to 15 characters
i2cPressureCal¶
Sets the calibration for the I2C sensor pressure reading.
i2cPressureCal=[A]
A
- the number of meters above sea level, integer
pmName¶
Sets the name of PM reading.
pm[A]Name=[B]
A
- reading identifier1
- PM1.0,2
- PM2.5,4
- PM4.0,10
- PM10.0B
- string up to 15 characters
co2Name¶
Sets the name of CO2 reading.
co2Name=[A]
A
- string up to 15 characters
diffName¶
Added in SW 1.06
Sets the name of DIFF reading.
diffName[A]=[B]
A
- DIFF measurement number, integer1-6
B
- string up to 15 characters
diffConfig1S¶
Sets the first input for a DIFF operation.
diffConfig1S[A]=[B]
A
- DIFF measurement number, integer1-6
-
B
- input number, integer0-32
{ 0: 'INPA1', 1: 'INPA2', 2: 'INPA3', 3: 'DS1', 4: 'DS2', 5: 'DS3', 6: 'DS4', 7: 'DS5', 8: 'DS6', 9: 'DS7', 10: 'DS8', 11: 'T1', 12: 'H1', 13: 'Dew Point', 14: 'POWER1', 15: 'POWER2', 16: 'POWER3', 17: 'POWER4', 18: 'POWER5', 19: 'POWER6', 20: 'ENERGY1', 21: 'ENERGY2', 22: 'ENERGY3', 23: 'ENERGY4', 24: 'ENERGY5', 25: 'ENERGY6', 26: 'VCC', 27: 'DIFF1', 28: 'DIFF2', 29: 'DIFF3', 30: 'DIFF4', 31: 'DIFF5', 32: 'DIFF6', }
diffConfig2S¶
Sets the second input for the DIFF operation.
diffConfig2S[A]=[B]
A
- DIFF measurement number, integer1-6
B
- input number, integer0-32
, list of values
diffConfigO¶
Sets the operator for the DIFF operation.
diffConfigO[A]=[B]
A
- DIFF measurement number, integer1-6
-
B
- operator number, integer0-3
{ 0: '-', 1: '+', 2: '*', 3: '/', }
iDName¶
Sets the name for the digital input.
iDName[A]=[B]
A
- digital input number, integer1-4
B
- string up to 15 characters
iDNegation¶
Activates negation for digital input. Makes 1
appear as OFF
and 0
as ON
.
iDNegation[A]=[B]
A
- digital input number, integer1-4
B
- integer0-1
iDBistable¶
Activates bistable operation mode for the input.
iDBistable[A]=[B]
A
- digital input number, integer1-4
B
- integer0-1
iDBistableTime¶
Sets the time for the bistable operation mode.
iDBistableTime[A]=[B]
A
- digital input number, integer1-4
B
- time in seconds, integer0-65535
iDCountImpulse¶
Activates function Impulse time for input.
iDCountImpulse[A]=[B]
A
- number of pair of digital inputs, integer1-2
B
- integer0-1
Sensors¶
dsReadID¶
Reads the next DS ID and places it in the dsReadID variable for reading.
dsReadID=0
dsID¶
Sets the DS sensor ID to the given position.
dsID[A]=[B]
A
- DS sensor number, integer1-8
B
- ID to be set, a string of characters in the form ofXX:XX:XX:XX:XX:XX:XX:XX
, whereX
is0-9, A-F
dsOffset¶
Sets the offset for DS reading.
dsOffset[A]=[B]
A
- DS sensor number, integer1-8
B
- offset to be set, real number
i2cFrequency¶
Sets the frequency of I2C communication with the sensor.
i2cFrequency=[A]
A
- frequency in kHz, integer5-100
i2cSensor¶
Sets the type of primary I2C sensor.
i2cSensor=[A]
-
A
- sensor number, integer0-5
{ 0: 'None', 1: 'BME280', 2: 'AM2320', 3: 'HTS221', 4: 'BME680', 5: 'AM2301B/AHT25/AHT20', }
i2cPMSensor¶
Sets the type of I2C PM sensor.
i2cPMSensor=[A]
-
A
- sensor number, integer0-2
{ 0: 'None', 1: 'SPS30', 2: 'APM10', }
i2cCO2Sensor¶
Sets the type of I2C CO2 sensor.
i2cCO2Sensor=[A]
-
A
- sensor number, integer0-2
{ 0: 'None', 1: 'SCD40', 2: 'ACD10', }
i2cDetect¶
Detects connected I2C sensor.
i2cDetect=1
Serial port¶
uartSensor¶
Sets support for the module connected to the serial port.
uartSensor=[A]
-
A
- module number, integer0-6
{ 0: "OFF", 1: "DURALUX", 2: "PM SDS011", 3: "CO2 MH-Z16/19", 4: "PM SPS30", 5: "Bar/Qr Code Scanner", 6: "Ultrasonic distance sensor", }
Modbus¶
modbusSensor¶
Selects the module connected to the Modbus port.
modbusSensor[A]=[B]
A
- Modbus slot number, integer1-5
-
B
- connected module number, integer0-6
,100-104
{ 0: "OFF", 1: "SDM120", 2: "SDM72D-M", 3: "Epever Tracer", 4: "Sofarsolar", 5: "SDM630/72D-v2", 6: "CHINT-DTSU666", 100: "custom1 (custom)", 101: "custom2 (custom)", 102: "custom3 (custom)", 103: "custom4 (custom)", 104: "custom5 (custom)", }
modbusID¶
Sets the ID of the supported Modbus module.
modbusID[A]=[B]
A
- Modbus slot number, integer1-5
B
- ID, integer
modbusCConfig¶
Sets the name of custom Modbus device and communication parameters like bitrate, parity bit and stop bit.
modbusCConfig[A]=[B]*[C]*[D]*[E]*[F]
A
- custom configuration number, integer1-5
B
- name, string up to 15 characters-
C
- bitrate, integer0-5
{ 0: "9600", 1: "19200", 2: "38400", 3: "57600", 4: "115200", 5: "4800", }
-
D
- parity bit, integer0-2
{ 0: "none", 1: "even", 2: "odd", }
-
E
- stop bit, integer1-2
F
- delay between register reads, integer
modbusCField¶
Sets reading parameters for a custom Modbus device, such as name, unit, divisor, register address, function code, type (kind), endian.
modbusCField[A][B]=C*D*E*F*G*H*I
A
- custom configuration number, integer1-5
B
- number of reading, integer1-30
C
- name of reading, string up to 15 charactersD
- unit, string up to 7 characters-
E
- divisor, integer0-4
{ 0: "1", 1: "10", 2: "100", 3: "1000", 4: "10000", }
-
F
- register address in decimal format, integer -
G
- function code, integer1-4
{ 1: "0x1", 2: "0x2", 3: "0x3", 4: "0x4", }
-
H
- type of variable, integer0-2
{ 0: "int16", 1: "int32", 2: "float", }
-
I
- defines endian option, integer0-3
{ 0: "no swap", 1: "swap byte", 2: "swap word", 3: "swap byte and word", }
modbusTCPServer¶
Activates the Modbus TCP server.
A device restart is required to apply this change.
modbusTCPServer=[A]
A
- specifies whether the feature is enabled, integer0-1
Mapowane odczyty¶
mConfig¶
Sets the mapping of Modbus readings to the variables m1-m30
, which can be used in the HTTP client, MQTT client, OLED, VOLED, Power and energy.
mConfig[A]=[B]*[C]
A
- variable numberm
, integer1-30
B
- slot number, integer0-5
(0
inactive,1-5
Modbus modules)C
- reading number, integer0-30
(0
inactive,1-30
reading number)
Power and energy¶
powerName¶
Sets the name for power and energy measurement.
powerName[A]=[B]
A
- measurement number, integer1-6
B
- string up to 15 characters
powerIOption¶
Sets the source of the measured power or I component.
powerIOption[A]=[B]
A
- measurement number, integer1-6
-
B
- measurement source, integer0-10
{ 0: 'INPA1', 1: 'INPA2', 2: 'INPA3', 3: 'INPD1', 4: 'INPD2', 5: 'INPD3', 6: 'INPD4', 7: 'm1', 8: 'm2', 9: 'm3', 10: 'm4', }
powerUOption¶
Sets the U component for power measurement.
powerUOption[A]=[B]
A
- measurement number, integer1-6
-
B
- component U, integer0-10
{ 0: 'INPA1', 1: 'INPA2', 2: 'INPA3', 3: '225V', 4: '230V', 5: '235V', 6: 'VCC', 7: 'm1', 8: 'm2', 9: 'm3', 10: 'm4', }
powerUnit¶
Sets the unit for the power/energy reading.
powerUnit[A]=[B]
A
- measurement number, integer1-6
-
B
- the unit to use, integer0-5
{ 0: { power: 'kW', energy: 'kWh' }, 1: { power: 'W', energy: 'kWh' }, 2: { power: 'l/min', energy: 'm3' }, 3: { power: 'm3/h', energy: 'm3' }, 4: { power: 'kW -> W', energy: 'kWh' }, 5: { power: 'W -> kW', energy: 'kWh' }, }
Unit and measurement
Only the two options 4
(kW -> W
) and 5
(W -> kW
) result in conversion of values. The other options are labels only. In addition, these two options should only be selected when Modbus power readings are selected in powerIOption (variables m1-m4
).
powerImpulses¶
Sets the pulse to power conversion factor.
powerImpulses[A]=[B]
A
- measurement number, integer1-6
B
- number of pulses, integer
energySet¶
Sets the state of the energy measurement.
energySet[A]=[B]
A
- measurement number, integer1-6
B
- the value of energy (with the unit dictated by the choice of powerIOption), real number
Note
The energy value in energy
changes only when powerCounting
is activated.
powerCounting¶
Activates energy measurement. It can be controlled in the Schedule to measure energy in different time intervals (different tariffs).
powerCounting[A]=[B]
A
- measurement number, integer1-6
B
- integer0-1
powerSaveToMem¶
Activates the function of saving the energy values after restarting the device (cyclic saving of the energy state to the permanent memory).
powerSaveToMem=[A]
A
- integer0-1
Events¶
event¶
Sets the event entry to the given position.
event[A]=[B]*[C]*[D]*[E]*[F]*[G]*[H]*[I]*[J]*[K]*[L]*[M]*[N]*[O]*[P]*[R]*[S]*[T]
A
- position, integer1-20
B
- determines whether the entry is set (1
- set), integer0-1
C
- determines whether the entry is active, integer0-1
-
D
,J
- sources (input data) of conditions (first and second, respectively), integer0-51, 100-121
{ // Analog 0: 'VCC', 1: 'TEMP', 2: 'HUM', 3: 'INPA1', 4: 'INPA2', 5: 'INPA3', 6: 'T1', 7: 'H1', 8: 'P1', 9: 'DS1', 10: 'DS2', 11: 'DS3', 12: 'DS4', 13: 'DS5', 14: 'DS6', 15: 'DS7', 16: 'DS8', 17: 'DIFF1', 18: 'DIFF2', 19: 'DIFF3', 20: 'DIFF4', 21: 'DIFF5', 22: 'DIFF6', 23: 'CO2', 24: 'PM1.0', 25: 'PM2.5', 26: 'PM4.0', 27: 'PM10.0', 28: 'POWER1', 29: 'POWER2', 30: 'POWER3', 31: 'POWER4', 32: 'POWER5', 33: 'POWER6', 34: 'ENERGY1', 35: 'ENERGY2', 36: 'ENERGY3', 37: 'ENERGY4', 38: 'ENERGY5', 39: 'ENERGY6', 40: 'm1', 41: 'm2', 42: 'm3', 43: 'm4', 44: 'm5', 45: 'm6', 46: 'm7', 47: 'm8', 48: 'm9', 49: 'm10', 50: 'Dew Point', 51: 'Distance sensor', // Digital 100: 'INPD1', 101: 'INPD2', 102: 'INPD3', 103: 'INPD4', 104: 'VAR1', 105: 'VAR2', 106: 'VAR3', 107: 'VAR4', 108: 'VAR5', 109: 'VAR6', 110: 'VAR7', 111: 'VAR8', 112: 'OUT1', 113: 'OUT2', 114: 'OUT3', 115: 'OUT4', 116: 'OUT5', 117: 'OUT6', 118: 'PWM1', 119: 'PWM2', 120: 'PWM3', 121: 'MQTT CONNECTION', }
-
E
,K
- condition operator for analog sources (for digital=
is always used), integer0-1
{ 0: '>=', 1: '<', }
-
F
,L
- reference values for conditions, real number (for a digital source, an integer0-1
) G
,M
- hysteresis values for conditions, real number-
H
- operator between conditions, integer0-5
{ 0: '-', 1: 'AND', 2: 'OR', 3: 'NAND', 4: 'NOR', 5: 'XOR', }
-
I
- action to be performed, integer0-48
{ 0: 'OUT1', 1: 'OUT2', 2: 'OUT3', 3: 'OUT4', 4: 'OUT5', 5: 'OUT6', 6: 'PWM1', 7: 'PWM2', 8: 'PWM3', 9: 'VAR1', 10: 'VAR2', 11: 'VAR3', 12: 'VAR4', 13: 'VAR5', 14: 'VAR6', 15: 'VAR7', 16: 'VAR8', 17: 'AutoSwitch OUT1', 18: 'AutoSwitch OUT2', 19: 'AutoSwitch OUT3', 20: 'AutoSwitch OUT4', 21: 'AutoSwitch OUT5', 22: 'AutoSwitch OUT6', 23: 'HTTP1', 24: 'HTTP2', 25: 'HTTP3', 26: 'HTTP4', 27: 'eMail 1', 28: 'eMail 2', 29: 'eMail 3', 30: 'eMail 4', 31: 'SMS1', 32: 'SMS2', 33: 'SMS3', 34: 'SMS4', 35: 'RESET ENERGY1', 36: 'RESET ENERGY2', 37: 'RESET ENERGY3', 38: 'RESET ENERGY4', 39: 'RESET ENERGY5', 40: 'RESET ENERGY6', 41: 'SNMP trap', 42: 'MQTT', 43: 'OLED ON/NEXT SCREEN', 44: 'OLED - SET SCREEN 1', 45: 'OLED - SET SCREEN 2', 46: 'OLED - SET SCREEN 3', 47: 'OLED - SET SCREEN 4', 48: 'ENABLE PID', }
-
N
- specifies whether Permanent (Per) is enabled for the event entry. Affects only OUT and VAR actions. It causes the action to be performed every time the conditions are checked, instead of only when the outcome of conditions change (they start to be met or stop being met, i.e. when a threshold is passed, so to speak). Integer0-1
O
- off delay (deactivation delay), i.e. the time in seconds by which the deactivation of the operation will be delayed, after the condition is no longer met. To be set only for OUT, VAR actions. Integer.-
P
- value for OUT, VAR actions (no effect for others). Integer0-2
.{ 0: '0', 1: '1', 2: 'Reverse', }
-
R
- on delay (activation delay), i.e. the time in seconds by which the activation of the action will be delayed, after the condition begins to be met. To be set only for OUT, VAR actions. Integer. S
- dependence on the outcome of the conditions of another event, e.g. entry 2 dependent on the outcome of the conditions of entry 1. Integer0-40
(0
- inactive,1-20
- conditions not met, respectively EV 1 - EV 20,21-40
- conditions met, respectively EV 1 - EV 20).-
T
Mode option for Action in Events. It allows you to specify when the event action will be performed - when the condition begins to be met, when it stops being met, or both (default behavior). An integer0-2
.{ "0": "Action when the condition starts or stops to be met", "1": "Action only when the condition starts to be met", "2": "Action only when the condition stops to be met", }
Deleting the entry
In order for an entry to be invisible (not set) on the list in the web interface, it must have 0
set in the B
field.
Schedules (Scheduler)¶
schedule¶
Sets a schedule entry (Scheduler).
schedule[A]=[B]*[C]*[D]*[E]*[F]*[G]*[H]*[I]*[J]*[K]*[L]*[M]*[N]
A
- entry number, integer1-50
B
- determines whether the entry is set (1
- set), integer0-1
C
- the name of the entry, string up to 15 characters-
D
- action to be performed, integer0-30
{ 0: 'OUT1', 1: 'OUT2', 2: 'OUT3', 3: 'OUT4', 4: 'OUT5', 5: 'OUT6', 6: 'PWM1', 7: 'PWM2', 8: 'PWM3', 9: 'VAR1', 10: 'VAR2', 11: 'VAR3', 12: 'VAR4', 13: 'VAR5', 14: 'VAR6', 15: 'VAR7', 16: 'VAR8', 17: 'RESTART', 18: 'RESET ENERGY1', 19: 'RESET ENERGY2', 20: 'RESET ENERGY3', 21: 'RESET ENERGY4', 22: 'RESET ENERGY5', 23: 'RESET ENERGY6', 24: 'OLED ON/NEXT SCREEN', 25: 'COUNT ENERGY1', 26: 'COUNT ENERGY2', 27: 'COUNT ENERGY3', 28: 'COUNT ENERGY4', 29: 'COUNT ENERGY5', 30: 'COUNT ENERGY6', }
-
E
- the value of the action, integer0-2
{ 0: '0', 1: '1', 2: 'Reverse', }
-
F
- binary notation of 32 consecutive seconds (0-31, for each value0-1
), integer0-4294967295
G
- binary notation of 28 consecutive seconds (32-59, for each value0-1
), integer0-268435455
H
- binary notation of 32 consecutive minutes (0-31, for each value0-1
), integer0-4294967295
I
- binary notation of 28 consecutive minutes (32-59, for each value0-1
), integer0-268435455
J
- binary notation of 24 consecutive hours (0-23, for each value0-1
), integer0-16777215
K
- binary notation of 31 consecutive days of the month (0-30, for each value0-1
), integer0-2147483647
L
- binary notation of 12 consecutive months (0-11, for each value0-1
), integer0-4095
M
- binary notation of 7 consecutive days of the week (0-6, Poniedziałek-Wtorek, for each value0-1
), integer0-127
N
- determines whether the entry is active, integer0-1
Watchdog¶
wdConfig¶
Sets parameters for the watchdog function at the selected position.
wdConfig[A]=[B]*[C]*[D]*[E]*[F]*[G]*[H]*[I]*[J]*[K]*[L]
A
- entry number, integer1-7
B
- determines whether the entry is enabled, integer0-1
C
- determines whether email sending is enabled, integer0-1
-
D
- determines which output is controlled, integer0-16
{ 0: 'OUT1', 1: 'OUT2', 2: 'OUT3', 3: 'OUT4', 4: 'OUT5', 5: 'OUT6', 6: 'PWM1', 7: 'PWM2', 8: 'PWM3', 9: 'VAR1', 10: 'VAR2', 11: 'VAR3', 12: 'VAR4', 13: 'VAR5', 14: 'VAR6', 15: 'VAR7', 16: 'VAR8', }
-
E
- IP address/domain to monitor, a string of characters F
- number of consecutive ping failures before restarting the output, integerG
- timeout in seconds for the ping command, integerH
- time in seconds between ping tests, integerI
- ping resumption delay after output restart, in seconds, integerJ
- output restart time in seconds, integerK
- number of consecutive restarts before stopping the watchdog function (value 0 means no limit), integerL
- watchdog start delay after device start up in seconds, integer
Remote control¶
remoteEnabled¶
Activates the remote control functions.
remoteEnabled=[A]
A
- integer0-1
remoteHost¶
Sets the address of the controlled LAN Controller.
remoteHost=[A]
A
- string up to 48 characters
remotePort¶
Sets the port for communication with another LAN Controller.
remotePort=[A]
A
- integer1-65535
remotePassword¶
Sets the communication password.
remotePassword=[A]
A
- string up to 16 characters
remoteNegation¶
Specifies whether the input state or its negated value is to be set on the output. For example, INPD1 = 0 without negation will cause OUT1 to be set to 0, but with negation enabled to 1.
remoteNegation=[A]
A
- integer0-4095
(12 bits sequentially for INPD1-INPD4, VAR1-VAR8)
remoteInputs¶
It defines which outputs will be controlled when changing inputs INPD1-INPD4, VAR1-VAR8.
remoteInputs[A]=[B]
A
- input number, integer1-12
(in sequence INPD1-INPD4, VAR1-VAR8)B
- outputs that will be controlled when the input state changes, integer0-131071
(17 bits sequentially for OUT1-OUT6, PWM1-PWM3, VAR1-VAR8)
HTTP Client¶
httpModem¶
Removed in SW 1.18a. The device automatically determines interface priorities.
Causes HTTP requests to be sent over a modem instead of an Ethernet connection.
httpModem=[A]
A
- integer0-1
httpReadingCode¶
Changes the format for inserting readings from the device from %XXXA
to %%XXXA
, i.e. requires double %
.
httpReadingCode=[A]
A
- integer0-1
httpDigestAuth¶
Causes the HTTP request to use Digest Authentication after a failed attempt with Basic Authentication.
httpDigestAuth=[A]
A
- integer0-1
httpPerEnabled¶
Available since SW 1.06
Activates periodic sending of the first set HTTP GET query entry.
httpPerEnabled=[A]
A
- integer0-1
httpPerPeriod¶
Available since SW 1.06
Sets the sending period in seconds for the periodic sending function.
httpPerPeriod=[A]
A
- integer5-...
httpPerURL¶
Available since SW 1.06
Sets the GET query URL for the periodic sending function.
httpPerURL=[A]
A
- a string of characters in the formathttp(s)://([USERNAME]:[PASSWORD]@)[HOST(DOMAIN OR IP):[PORT][PATH]
, e.g.http://admin:admin@192.168.1.100:80/api/v1/save/?out=out1
httpURLEv¶
Available since SW 1.06
Sets the GET query URL for the Events function (HTTP action with variants: T
- when the condition is met, F
- when the condition is no longer met).
httpURLEv[A][B]=[C]
A
-T
orF
character, variant after fulfillment or when the condition is no longer fulfilledB
- number of HTTP action, integer1-4
C
- a string of characters in the formathttp(s)://([USERNAME]:[PASSWORD]@)[HOST(DOMAIN OR IP):[PORT][PATH]
, e.g.http://admin:admin@192.168.1.100:80/api/v1/save/?out=out1
httpEnabled¶
Removed in SW 1.06. Instead, use httpPerEnabled.
Activates periodic sending of the first set HTTP GET query entry.
httpEnabled=[A]
A
- integer0-1
httpPeriod¶
Removed in SW 1.06. Instead, use httpPerPeriod.
Sets the sending period in seconds for the periodic sending function.
httpPeriod=[A]
A
- integer5-...
httpHost¶
Removed in SW 1.06. Instead, use httpPerURL and httpURLEv.
Sets the IP address / domain with optional Basic Authentication/Digest Authentication authentication information. It must also contain a choice of http
or https
.
httpHost[A]=[B]
A
- position number, integer1-4
B
- protocol, IP address/domain and optional credentials, string, e.g.http://admin:admin@192.168.1.100
httpPort¶
Removed in SW 1.06. Instead, use httpPerURL and httpURLEv.
Sets the port to which the query will be sent.
httpPort[A]=[B]
A
- position number, integer1-4
B
- port, integer1-65535
httpPath¶
Removed in SW 1.06. Instead, use httpPerURL and httpURLEv.
Sets the query path.
httpPath[A]=[B]
A
- position number, integer1-4
B
- query path, with a leading/
, string, e.g./api/v1/save/?out1=1
MQTT Client¶
mqttEnabled¶
Activates the MQTT client.
mqttEnabled=[A]
A
- integer0-1
mqttAuth¶
Makes the client use the authentication data (login and password).
mqttAuth=[A]
A
- integer0-1
mqttHost¶
Sets the IP address/domain of the MQTT server to connect to.
mqttHost=[A]
A
- string up to 128 characters
mqttPort¶
Sets the MQTT server port.
mqttPort=[A]
A
- port, integer1-65535
mqttLogin¶
Sets the username to authenticate.
mqttLogin=[A]
A
- string up to 99 characters
mqttPassword¶
Sets the password for authentication.
mqttPassword=[A]
A
- string up to 199 characters
mqttPrefix¶
Sets the prefix for the topics used by the device (subscribe and publish).
mqttPrefix=[A]
A
- string up to 13 characters
mqttPeriod¶
Sets the data sending period in seconds.
mqttPeriod=[A]
A
- integer5-...
mqttKeepAlive¶
Sets the value for the Keep Alive parameter.
mqttKeepAlive=[A]
A
- integer5-...
mqttTLS¶
Causes the client to use an encrypted connection (the feature must be offered by the server).
mqttTLS=[A]
A
- integer0-1
mqttLWT¶
Causes the client to use LWT. As a result, when connected to the server, it will publish a message 1
on the topic [mqttPrefix]/connected
, and if the client loses connection with the server, the server will publish a message 0
on the previously mentioned topic.
mqttLWT=[A]
A
- integer0-1
mqttModem¶
Removed in SW 1.18a. The device automatically determines interface priorities.
Causes the MQTT connection to be established via a modem instead of an Ethernet connection.
mqttModem=[A]
A
- integer0-1
mqttSend¶
Sets which readings will be periodically sent.
mqttSend=[A]
-
A
- a string of 97 integers0-1
, corresponding to consecutive readings as listed below{ 0: 'VCC', 1: 'TEMP', 2: 'HUM', 3: 'INPA1', 4: 'INPA2', 5: 'INPA3', 6: 'DS1', 7: 'DS2', 8: 'DS3', 9: 'DS4', 10: 'DS5', 11: 'DS6', 12: 'DS7', 13: 'DS8', 14: 'T1', 15: 'H1', 16: 'P1', 17: 'DIFF1', 18: 'DIFF2', 19: 'DIFF3', 20: 'DIFF4', 21: 'DIFF5', 22: 'DIFF6', 23: 'INPD1', 24: 'INPD2', 25: 'INPD3', 26: 'INPD4', 27: 'OUT1', 28: 'OUT2', 29: 'OUT3', 30: 'OUT4', 31: 'OUT5', 32: 'OUT6', 33: 'PWM1', 34: 'PWM2', 35: 'PWM3', 36: 'PWM1 Duty', 37: 'PWM2 Duty', 38: 'PWM3 Duty', 39: 'POWER1', 40: 'POWER2', 41: 'POWER3', 42: 'POWER4', 43: 'POWER5', 44: 'POWER6', 45: 'ENERGY1', 46: 'ENERGY2', 47: 'ENERGY3', 48: 'ENERGY4', 49: 'ENERGY5', 50: 'ENERGY6', 51: 'VAR1', 52: 'VAR2', 53: 'VAR3', 54: 'VAR4', 55: 'VAR5', 56: 'VAR6', 57: 'VAR7', 58: 'VAR8', 59: 'PM1.0', 60: 'PM2.5', 61: 'PM4.0', 62: 'PM10.0', 63: 'CO2', 64: 'Distance sensor', 65: 'IAQ', 66: 'm1', 67: 'm2', 68: 'm3', 69: 'm4', 70: 'm5', 71: 'm6', 72: 'm7', 73: 'm8', 74: 'm9', 75: 'm10', 76: 'm11', 77: 'm12', 78: 'm13', 79: 'm14', 80: 'm15', 81: 'm16', 82: 'm17', 83: 'm18', 84: 'm19', 85: 'm20', 86: 'm21', 87: 'm22', 88: 'm23', 89: 'm24', 90: 'm25', 91: 'm26', 92: 'm27', 93: 'm28', 94: 'm29', 95: 'm30', 96: 'UPTIME', 97: 'IP', // added in SW 1.06 98: 'Time', // added in SW 1.06 99: 'Date', // added in SW 1.06 100: 'Dew Point', // added in SW 1.06 }
mqttSendChanges¶
Sets which readings will be sent on a state change.
mqttSendChanges=[A]
-
A
- a string of 3 integers0-1
, corresponding to consecutive readings as listed below{ 0: "INPT1", 1: "INPT2", 2: "BARCODE", }
SNMP¶
snmpTrapEnabled¶
Activates the Trap function.
snmpTrapEnabled=[A]
A
- integer0-1
snmpV2Enabled¶
Activates SNMPv2c support.
snmpV2Enabled=[A]
A
- integer0-1
snmpV3Enabled¶
Activates SNMPv3 support.
snmpV3Enabled=[A]
A
- integer0-1
snmpCommRead¶
Sets the read password.
snmpCommRead=[A]
A
- string up to 31 characters
snmpCommWrite¶
Sets the save password.
snmpCommWrite=[A]
A
- string up to 31 characters
snmpCommTrap¶
Sets the Trap password.
snmpCommTrap=[A]
A
- string up to 31 characters
snmpTrapReceive¶
Sets the Trap receiver address.
snmpTrapReceive=[A]
A
- a string of characters
snmpUser¶
Sets the user name to be authenticated (SNMPv3).
snmpUser=[A]
A
- string up to 31 characters
snmpAuthPass¶
Sets the authentication password (SNMPv3).
snmpAuthPass=[A]
A
- string up to 19 characters
snmpPrivacyPass¶
Sets the privacy password (SNMPv3).
snmpPrivacyPass=[A]
A
- string up to 19 characters
Network - General¶
netHostname¶
Sets the hostname of the device, also used as the device name on the page, e.g. in the title.
netHostname=[A]
A
- hostname, a string of characters
netHttpPort¶
Sets the port on which the device's HTTP server will listen for requests (and host the page).
netHttpPort=[A]
A
- integer1-65535
netHttpsOn¶
Activates encryption of the HTTP connection to the web interface, i.e. HTTPS.
Attention
HTTPS listening is always performed on the standard port 443.
netHttpsOn=[A]
A
- integer0-1
Network - Ethernet¶
netMac¶
Sets the device's MAC address.
netMac=[A]
A
- MAC address, a string of characters
netDhcp¶
Activates address retrieval via DHCP.
netDhcp=[A]
A
- integer0-1
netIp¶
Sets the IP address of the device.
netIp=[A]
A
- IP address, a string of characters
netMask¶
Sets the subnet mask.
netMask=[A]
A
- subnet mask, a string of characters
netGateway¶
Sets the default gateway address.
netGateway=[A]
A
- IP address, a string of characters
netDns1¶
Sets the primary DNS server address.
netDns1=[A]
A
- IP address, a string of characters
netDns2¶
Sets the secondary DNS server address.
netDns2=[A]
A
- IP address, a string of characters
Network - Wi-Fi¶
netWifi¶
Activates Wi-Fi.
netWifi=[A]
A
- integer0-1
netWifiMode¶
Sets the operating mode.
netWifiMode=[A]
A
- integer0-1
(AP or STA)
netWifiSSID¶
Sets the SSID of the network to create or connect to.
netWifiSSID=[A]
A
- string up to 32 characters
netWifiSecurity¶
Sets the network security method.
netWifiSecurity=[A]
-
A
- integer0-9
{ 0: 'open', 1: 'WEP', 2: 'WPA_PSK', 3: 'WPA2_PSK', 4: 'WPA_WPA2_PSK', 5: 'WPA2_ENTERPRISE', 6: 'WPA3_PSK', 7: 'WPA2_WPA3_PSK', 8: 'WAPI_PSK', 9: 'OWE', }
netWifiPass¶
Sets the network access password.
netWifiPass=[A]
A
- string up to 63 characters
netWifiDhcp¶
Activates address retrieval via DHCP.
netWifiDhcp=[A]
A
- integer0-1
netWifiIp¶
Sets the IP address of the device.
netWifiIp=[A]
A
- IP address, a string of characters
netWifiMask¶
Sets the subnet mask.
netWifiMask=[A]
A
- subnet mask, a string of characters
netWifiGateway¶
Sets the default gateway address.
netWifiGateway=[A]
A
- IP address, a string of characters
netWifiDns1¶
Sets the primary DNS server address.
netWifiDns1=[A]
A
- IP address, a string of characters
netWifiDns2¶
Sets the secondary DNS server address.
netWifiDns2=[A]
A
- IP address, a string of characters
netWifiReload¶
Reloads Wi-Fi settings to take effect, without restarting the device.
netWifiReload=1
Time¶
timeNTP¶
Activates time synchronization using NTP.
timeNTP=[A]
A
- integer0-1
timeManual¶
Sets the device's system time.
timeManual=[A]
A
- UNIX timestamp (number of seconds since early 1970 UTC), integer
timeNTPHost¶
Sets the address of the NTP server.
timeNTPHost=[A]
A
- IP address/domain, a string of characters
timeNTPPort¶
Sets the NTP server port.
timeNTPPort=[A]
A
- port, integer1-65535
timeTimezone¶
Sets the time zone.
timeTimezone=[A]
-
A
- time zone number, integerList of options
{ 0: 'Africa/Abidjan', 1: 'Africa/Accra', 2: 'Africa/Addis_Ababa', 3: 'Africa/Algiers', 4: 'Africa/Asmara', 5: 'Africa/Bamako', 6: 'Africa/Bangui', 7: 'Africa/Banjul', 8: 'Africa/Bissau', 9: 'Africa/Blantyre', 10: 'Africa/Brazzaville', 11: 'Africa/Bujumbura', 12: 'Africa/Cairo', 13: 'Africa/Casablanca', 14: 'Africa/Ceuta', 15: 'Africa/Conakry', 16: 'Africa/Dakar', 17: 'Africa/Dar_es_Salaam', 18: 'Africa/Djibouti', 19: 'Africa/Douala', 20: 'Africa/El_Aaiun', 21: 'Africa/Freetown', 22: 'Africa/Gaborone', 23: 'Africa/Harare', 24: 'Africa/Johannesburg', 25: 'Africa/Juba', 26: 'Africa/Kampala', 27: 'Africa/Khartoum', 28: 'Africa/Kigali', 29: 'Africa/Kinshasa', 30: 'Africa/Lagos', 31: 'Africa/Libreville', 32: 'Africa/Lome', 33: 'Africa/Luanda', 34: 'Africa/Lubumbashi', 35: 'Africa/Lusaka', 36: 'Africa/Malabo', 37: 'Africa/Maputo', 38: 'Africa/Maseru', 39: 'Africa/Mbabane', 40: 'Africa/Mogadishu', 41: 'Africa/Monrovia', 42: 'Africa/Nairobi', 43: 'Africa/Ndjamena', 44: 'Africa/Niamey', 45: 'Africa/Nouakchott', 46: 'Africa/Ouagadougou', 47: 'Africa/Porto-Novo', 48: 'Africa/Sao_Tome', 49: 'Africa/Tripoli', 50: 'Africa/Tunis', 51: 'Africa/Windhoek', 52: 'America/Adak', 53: 'America/Anchorage', 54: 'America/Anguilla', 55: 'America/Antigua', 56: 'America/Araguaina', 57: 'America/Argentina/Buenos_Aires', 58: 'America/Argentina/Catamarca', 59: 'America/Argentina/Cordoba', 60: 'America/Argentina/Jujuy', 61: 'America/Argentina/La_Rioja', 62: 'America/Argentina/Mendoza', 63: 'America/Argentina/Rio_Gallegos', 64: 'America/Argentina/Salta', 65: 'America/Argentina/San_Juan', 66: 'America/Argentina/San_Luis', 67: 'America/Argentina/Tucuman', 68: 'America/Argentina/Ushuaia', 69: 'America/Aruba', 70: 'America/Asuncion', 71: 'America/Atikokan', 72: 'America/Bahia', 73: 'America/Bahia_Banderas', 74: 'America/Barbados', 75: 'America/Belem', 76: 'America/Belize', 77: 'America/Blanc-Sablon', 78: 'America/Boa_Vista', 79: 'America/Bogota', 80: 'America/Boise', 81: 'America/Cambridge_Bay', 82: 'America/Campo_Grande', 83: 'America/Cancun', 84: 'America/Caracas', 85: 'America/Cayenne', 86: 'America/Cayman', 87: 'America/Chicago', 88: 'America/Chihuahua', 89: 'America/Costa_Rica', 90: 'America/Creston', 91: 'America/Cuiaba', 92: 'America/Curacao', 93: 'America/Danmarkshavn', 94: 'America/Dawson', 95: 'America/Dawson_Creek', 96: 'America/Denver', 97: 'America/Detroit', 98: 'America/Dominica', 99: 'America/Edmonton', 100: 'America/Eirunepe', 101: 'America/El_Salvador', 102: 'America/Fort_Nelson', 103: 'America/Fortaleza', 104: 'America/Glace_Bay', 105: 'America/Godthab', 106: 'America/Goose_Bay', 107: 'America/Grand_Turk', 108: 'America/Grenada', 109: 'America/Guadeloupe', 110: 'America/Guatemala', 111: 'America/Guayaquil', 112: 'America/Guyana', 113: 'America/Halifax', 114: 'America/Havana', 115: 'America/Hermosillo', 116: 'America/Indiana/Indianapolis', 117: 'America/Indiana/Knox', 118: 'America/Indiana/Marengo', 119: 'America/Indiana/Petersburg', 120: 'America/Indiana/Tell_City', 121: 'America/Indiana/Vevay', 122: 'America/Indiana/Vincennes', 123: 'America/Indiana/Winamac', 124: 'America/Inuvik', 125: 'America/Iqaluit', 126: 'America/Jamaica', 127: 'America/Juneau', 128: 'America/Kentucky/Louisville', 129: 'America/Kentucky/Monticello', 130: 'America/Kralendijk', 131: 'America/La_Paz', 132: 'America/Lima', 133: 'America/Los_Angeles', 134: 'America/Lower_Princes', 135: 'America/Maceio', 136: 'America/Managua', 137: 'America/Manaus', 138: 'America/Marigot', 139: 'America/Martinique', 140: 'America/Matamoros', 141: 'America/Mazatlan', 142: 'America/Menominee', 143: 'America/Merida', 144: 'America/Metlakatla', 145: 'America/Mexico_City', 146: 'America/Miquelon', 147: 'America/Moncton', 148: 'America/Monterrey', 149: 'America/Montevideo', 150: 'America/Montreal', 151: 'America/Montserrat', 152: 'America/Nassau', 153: 'America/New_York', 154: 'America/Nipigon', 155: 'America/Nome', 156: 'America/Noronha', 157: 'America/North_Dakota/Beulah', 158: 'America/North_Dakota/Center', 159: 'America/North_Dakota/New_Salem', 160: 'America/Nuuk', 161: 'America/Ojinaga', 162: 'America/Panama', 163: 'America/Pangnirtung', 164: 'America/Paramaribo', 165: 'America/Phoenix', 166: 'America/Port-au-Prince', 167: 'America/Port_of_Spain', 168: 'America/Porto_Velho', 169: 'America/Puerto_Rico', 170: 'America/Punta_Arenas', 171: 'America/Rainy_River', 172: 'America/Rankin_Inlet', 173: 'America/Recife', 174: 'America/Regina', 175: 'America/Resolute', 176: 'America/Rio_Branco', 177: 'America/Santarem', 178: 'America/Santiago', 179: 'America/Santo_Domingo', 180: 'America/Sao_Paulo', 181: 'America/Scoresbysund', 182: 'America/Sitka', 183: 'America/St_Barthelemy', 184: 'America/St_Johns', 185: 'America/St_Kitts', 186: 'America/St_Lucia', 187: 'America/St_Thomas', 188: 'America/St_Vincent', 189: 'America/Swift_Current', 190: 'America/Tegucigalpa', 191: 'America/Thule', 192: 'America/Thunder_Bay', 193: 'America/Tijuana', 194: 'America/Toronto', 195: 'America/Tortola', 196: 'America/Vancouver', 197: 'America/Whitehorse', 198: 'America/Winnipeg', 199: 'America/Yakutat', 200: 'America/Yellowknife', 201: 'Antarctica/Casey', 202: 'Antarctica/Davis', 203: 'Antarctica/DumontDUrville', 204: 'Antarctica/Macquarie', 205: 'Antarctica/Mawson', 206: 'Antarctica/McMurdo', 207: 'Antarctica/Palmer', 208: 'Antarctica/Rothera', 209: 'Antarctica/Syowa', 210: 'Antarctica/Troll', 211: 'Antarctica/Vostok', 212: 'Arctic/Longyearbyen', 213: 'Asia/Aden', 214: 'Asia/Almaty', 215: 'Asia/Amman', 216: 'Asia/Anadyr', 217: 'Asia/Aqtau', 218: 'Asia/Aqtobe', 219: 'Asia/Ashgabat', 220: 'Asia/Atyrau', 221: 'Asia/Baghdad', 222: 'Asia/Bahrain', 223: 'Asia/Baku', 224: 'Asia/Bangkok', 225: 'Asia/Barnaul', 226: 'Asia/Beirut', 227: 'Asia/Bishkek', 228: 'Asia/Brunei', 229: 'Asia/Chita', 230: 'Asia/Choibalsan', 231: 'Asia/Colombo', 232: 'Asia/Damascus', 233: 'Asia/Dhaka', 234: 'Asia/Dili', 235: 'Asia/Dubai', 236: 'Asia/Dushanbe', 237: 'Asia/Famagusta', 238: 'Asia/Gaza', 239: 'Asia/Hebron', 240: 'Asia/Ho_Chi_Minh', 241: 'Asia/Hong_Kong', 242: 'Asia/Hovd', 243: 'Asia/Irkutsk', 244: 'Asia/Jakarta', 245: 'Asia/Jayapura', 246: 'Asia/Jerusalem', 247: 'Asia/Kabul', 248: 'Asia/Kamchatka', 249: 'Asia/Karachi', 250: 'Asia/Kathmandu', 251: 'Asia/Khandyga', 252: 'Asia/Kolkata', 253: 'Asia/Krasnoyarsk', 254: 'Asia/Kuala_Lumpur', 255: 'Asia/Kuching', 256: 'Asia/Kuwait', 257: 'Asia/Macau', 258: 'Asia/Magadan', 259: 'Asia/Makassar', 260: 'Asia/Manila', 261: 'Asia/Muscat', 262: 'Asia/Nicosia', 263: 'Asia/Novokuznetsk', 264: 'Asia/Novosibirsk', 265: 'Asia/Omsk', 266: 'Asia/Oral', 267: 'Asia/Phnom_Penh', 268: 'Asia/Pontianak', 269: 'Asia/Pyongyang', 270: 'Asia/Qatar', 271: 'Asia/Qyzylorda', 272: 'Asia/Riyadh', 273: 'Asia/Sakhalin', 274: 'Asia/Samarkand', 275: 'Asia/Seoul', 276: 'Asia/Shanghai', 277: 'Asia/Singapore', 278: 'Asia/Srednekolymsk', 279: 'Asia/Taipei', 280: 'Asia/Tashkent', 281: 'Asia/Tbilisi', 282: 'Asia/Tehran', 283: 'Asia/Thimphu', 284: 'Asia/Tokyo', 285: 'Asia/Tomsk', 286: 'Asia/Ulaanbaatar', 287: 'Asia/Urumqi', 288: 'Asia/Ust-Nera', 289: 'Asia/Vientiane', 290: 'Asia/Vladivostok', 291: 'Asia/Yakutsk', 292: 'Asia/Yangon', 293: 'Asia/Yekaterinburg', 294: 'Asia/Yerevan', 295: 'Atlantic/Azores', 296: 'Atlantic/Bermuda', 297: 'Atlantic/Canary', 298: 'Atlantic/Cape_Verde', 299: 'Atlantic/Faroe', 300: 'Atlantic/Madeira', 301: 'Atlantic/Reykjavik', 302: 'Atlantic/South_Georgia', 303: 'Atlantic/St_Helena', 304: 'Atlantic/Stanley', 305: 'Australia/Adelaide', 306: 'Australia/Brisbane', 307: 'Australia/Broken_Hill', 308: 'Australia/Currie', 309: 'Australia/Darwin', 310: 'Australia/Eucla', 311: 'Australia/Hobart', 312: 'Australia/Lindeman', 313: 'Australia/Lord_Howe', 314: 'Australia/Melbourne', 315: 'Australia/Perth', 316: 'Australia/Sydney', 317: 'Etc/GMT', 318: 'Etc/GMT+0', 319: 'Etc/GMT+1', 320: 'Etc/GMT+10', 321: 'Etc/GMT+11', 322: 'Etc/GMT+12', 323: 'Etc/GMT+2', 324: 'Etc/GMT+3', 325: 'Etc/GMT+4', 326: 'Etc/GMT+5', 327: 'Etc/GMT+6', 328: 'Etc/GMT+7', 329: 'Etc/GMT+8', 330: 'Etc/GMT+9', 331: 'Etc/GMT-0', 332: 'Etc/GMT-1', 333: 'Etc/GMT-10', 334: 'Etc/GMT-11', 335: 'Etc/GMT-12', 336: 'Etc/GMT-13', 337: 'Etc/GMT-14', 338: 'Etc/GMT-2', 339: 'Etc/GMT-3', 340: 'Etc/GMT-4', 341: 'Etc/GMT-5', 342: 'Etc/GMT-6', 343: 'Etc/GMT-7', 344: 'Etc/GMT-8', 345: 'Etc/GMT-9', 346: 'Etc/GMT0', 347: 'Etc/Greenwich', 348: 'Etc/UCT', 349: 'Etc/UTC', 350: 'Etc/Universal', 351: 'Etc/Zulu', 352: 'Europe/Amsterdam', 353: 'Europe/Andorra', 354: 'Europe/Astrakhan', 355: 'Europe/Athens', 356: 'Europe/Belgrade', 357: 'Europe/Berlin', 358: 'Europe/Bratislava', 359: 'Europe/Brussels', 360: 'Europe/Bucharest', 361: 'Europe/Budapest', 362: 'Europe/Busingen', 363: 'Europe/Chisinau', 364: 'Europe/Copenhagen', 365: 'Europe/Dublin', 366: 'Europe/Gibraltar', 367: 'Europe/Guernsey', 368: 'Europe/Helsinki', 369: 'Europe/Isle_of_Man', 370: 'Europe/Istanbul', 371: 'Europe/Jersey', 372: 'Europe/Kaliningrad', 373: 'Europe/Kiev', 374: 'Europe/Kirov', 375: 'Europe/Lisbon', 376: 'Europe/Ljubljana', 377: 'Europe/London', 378: 'Europe/Luxembourg', 379: 'Europe/Madrid', 380: 'Europe/Malta', 381: 'Europe/Mariehamn', 382: 'Europe/Minsk', 383: 'Europe/Monaco', 384: 'Europe/Moscow', 385: 'Europe/Oslo', 386: 'Europe/Paris', 387: 'Europe/Podgorica', 388: 'Europe/Prague', 389: 'Europe/Riga', 390: 'Europe/Rome', 391: 'Europe/Samara', 392: 'Europe/San_Marino', 393: 'Europe/Sarajevo', 394: 'Europe/Saratov', 395: 'Europe/Simferopol', 396: 'Europe/Skopje', 397: 'Europe/Sofia', 398: 'Europe/Stockholm', 399: 'Europe/Tallinn', 400: 'Europe/Tirane', 401: 'Europe/Ulyanovsk', 402: 'Europe/Uzhgorod', 403: 'Europe/Vaduz', 404: 'Europe/Vatican', 405: 'Europe/Vienna', 406: 'Europe/Vilnius', 407: 'Europe/Volgograd', 408: 'Europe/Warsaw', 409: 'Europe/Zagreb', 410: 'Europe/Zaporozhye', 411: 'Europe/Zurich', 412: 'Indian/Antananarivo', 413: 'Indian/Chagos', 414: 'Indian/Christmas', 415: 'Indian/Cocos', 416: 'Indian/Comoro', 417: 'Indian/Kerguelen', 418: 'Indian/Mahe', 419: 'Indian/Maldives', 420: 'Indian/Mauritius', 421: 'Indian/Mayotte', 422: 'Indian/Reunion', 423: 'Pacific/Apia', 424: 'Pacific/Auckland', 425: 'Pacific/Bougainville', 426: 'Pacific/Chatham', 427: 'Pacific/Chuuk', 428: 'Pacific/Easter', 429: 'Pacific/Efate', 430: 'Pacific/Enderbury', 431: 'Pacific/Fakaofo', 432: 'Pacific/Fiji', 433: 'Pacific/Funafuti', 434: 'Pacific/Galapagos', 435: 'Pacific/Gambier', 436: 'Pacific/Guadalcanal', 437: 'Pacific/Guam', 438: 'Pacific/Honolulu', 439: 'Pacific/Kiritimati', 440: 'Pacific/Kosrae', 441: 'Pacific/Kwajalein', 442: 'Pacific/Majuro', 443: 'Pacific/Marquesas', 444: 'Pacific/Midway', 445: 'Pacific/Nauru', 446: 'Pacific/Niue', 447: 'Pacific/Norfolk', 448: 'Pacific/Noumea', 449: 'Pacific/Pago_Pago', 450: 'Pacific/Palau', 451: 'Pacific/Pitcairn', 452: 'Pacific/Pohnpei', 453: 'Pacific/Port_Moresby', 454: 'Pacific/Rarotonga', 455: 'Pacific/Saipan', 456: 'Pacific/Tahiti', 457: 'Pacific/Tarawa', 458: 'Pacific/Tongatapu', 459: 'Pacific/Wake', 460: 'Pacific/Wallis', }
timeNTPPeriod¶
Sets the time update interval in NTP mode.
timeNTPPeriod=[A]
A
- update interval in seconds, integer
timeSetRTC¶
Saves the given time and date in the RTC.
timeSetRTC=[A]
A
- sequence of integers separated by,
([YEAR],[MONTH],[DAY OF THE MONTH],[HOUR],[MINUTE],[SECOND]
, e.g.2023,03,13,12,43,00
)
Access¶
auth¶
Activates Basic Authentication for HTTP access.
auth=[A]
A
- integer0-1
upgr¶
Specifies whether the firmware can be updated over HTTP.
upgr=[A]
A
- integer0-1
adminLogin¶
Sets the administrator username.
adminLogin=[A]
A
- string up to 15 characters (Base64 encoded)
adminPass¶
Sets the administrator password.
adminPass=[A]
A
- string up to 15 characters (Base64 encoded)
userLogin¶
Sets the username (with access to the Status page only).
userLogin=[A]
A
- string up to 15 characters (Base64 encoded)
userPass¶
Sets the user's password (with access to the Status page only).
userPass=[A]
A
- string up to 15 characters (Base64 encoded)
authUser¶
Sets the username and password combinations that will have access to output control when Basic Authentication is enabled.
authUser[A]=[B]*[C]*[D]*[E]
A
- entry number, integer1-50
B
- determines whether the entry is set (1
- set), integer0-1
C
- determines whether the entry is active, integer0-1
D
- username, string up to 15 charactersE
- user password, string up to 15 characters
E-mail¶
emailHost¶
Sets the address of the SMTP server.
emailHost=[A]
A
- a string up to 64 characters
emailPort¶
Sets the SMTP server port.
emailPort=[A]
A
- port, integer1-65535
emailTLS¶
Changed in SW 1.13
Activates support for TLS encryption when connecting to the server.
emailTLS=[A]
-
A
- integer0-2
{ 0: "No encryption", 1: "SSL/TLS", 2: "StartTLS", }
A
- integer0-1
emailUser¶
Sets the username (access data).
emailUser=[A]
A
- a string up to 64 characters
emailPassword¶
Sets the user's password (access data).
emailPassword=[A]
A
- a string up to 64 characters
emailSender¶
Sets the sender's address (usually the same as emailUser).
emailSender=[A]
A
- a string up to 64 characters
emailWdTo¶
Available since SW 1.06
Sets the recipient's address for Watchdog function.
emailWdTo=[A]
A
- a string up to 64 characters
emailWdSubj¶
Available since SW 1.06
Sets the subject of the email for Watchdog function.
emailWdSubj=[A]
A
- a string up to 64 characters
emailWdText¶
Available since SW 1.06
Sets the email content for Watchdog function.
emailWdText=[A]
A
- string up to 256 characters
emailToEv¶
Available since SW 1.06
Sets the recipient's address for the Events function (Email action with variants: T
- when the condition is met, F
- when the condition is no longer met).
emailToEv[A][B]=[C]
A
-T
orF
character, variant after fulfillment or when the condition is no longer fulfilledB
- number of Email action, integer1-4
C
- a string up to 64 characters
emailSubjEv¶
Available since SW 1.06
Sets the subject of the email for the Events function (Email action with variants: T
- when the condition is met, F
- when the condition is no longer met).
emailSubjEv[A][B]=[C]
A
-T
orF
character, variant after fulfillment or when the condition is no longer fulfilledB
- number of Email action, integer1-4
C
- a string up to 64 characters
emailTextEv¶
Available since SW 1.06
Sets the email content for the Events function (Email action with variants: T
- when the condition is met, F
- when the condition is no longer met).
emailTextEv[A][B]=[C]
A
-T
orF
character, variant after fulfillment or when the condition is no longer fulfilledB
- number of Email action, integer1-4
C
- a string up to 256 characters
testemail¶
Sends a test email according to the current configuration.
testemail=1
emailReceiver¶
Sets the recipient's address.
emailReceiver=[A]
A
- a string up to 64 characters
emailSubject¶
Removed in SW 1.06. Instead, use emailWdSubj and emailSubjEv.
Sets the subject of the email.
emailSubject=[A]
A
- a string up to 64 characters
emailTextOn¶
Removed in SW 1.06. Instead, use emailWdText and emailTextEv.
Sets the content of the message used when the event condition is met.
emailTextOn[A]=[B]
A
- number of the text pair, integer1-4
B
- string up to 256 characters
emailTextOff¶
Removed in SW 1.06. Instead, use emailWdText and emailTextEv.
Sets the content of the message used when the event condition expires.
emailTextOff[A]=[B]
A
- number of the text pair, integer1-4
B
- string up to 256 characters
OLED¶
oledEnabled¶
Activates the OLED function.
oledEnabled=[A]
A
- integer0-1
oledTime¶
Sets the display time, i.e. the time for which the display will be on after an activation event occurs (actions OLED ON/NEXT SCREEN and OLED - SET SCREEN X in Events and Schedule). For value 0
the display is always on.
oledTime=[A]
A
- time in seconds, integer
oledSize¶
Sets the size of the supported display.
oledSize=[A]
-
A
- option number, integer0-1
{ 0: '128 x 64', 1: '128 x 32', }
oledFrequency¶
Sets the frequency of I2C communication with the display.
oledFrequency=[A]
A
- frequency in kHz, integer50-400
oledScreen¶
Activates the selected screen configuration for display (inactive items will be skipped by the OLED ON/NEXT SCREEN actions).
oledScreen[A]=[B]
A
- screen number, integer1-4
B
- determine whether it is active, integer0-1
oledLine¶
Set the text of the selected line in the selected screen configuration.
oledLine[A][B]=[C]
A
- screen number, integer1-4
B
- line number, integer1-4
C
- string up to 159 characters
Modem¶
modemCmd¶
Sends an AT command to the modem. The response will be available in the modemConsole
variable.
modemCmd=[A]
A
- a string of characters
modemCode¶
Sets the access code for SMS commands (every command must be preceded by [modemCode]:[command]
).
modemCode=[A]
A
- string up to 4 characters, digits only
modemAPN¶
Sets the APN, username and password.
modemAPN=[A]
A
- string up to 63 characters, in the format"[APN]","[USERNAME]","[PASSWORD]"
, e.g."internet","",""
modemReturnSMS¶
Activates sending SMS confirmations to SMS commands.
modemReturnSMS=[A]
A
- integer0-1
modemNumberEv¶
Available since SW 1.06
Sets the recipient number for the Events function (SMS action with variants: T
- when the condition is met, F
- when the condition is no longer met). .
modemNumberEv[A][B]=[C]
A
-T
orF
character, variant after fulfillment or when the condition is no longer fulfilledB
- number of SMS action, integer1-4
C
- phone numbers separated by:
, string
modemTextEv¶
Available since SW 1.06
Ustawia treść wiadomości dla funkcji Zdarzenia (działanie SMS z wariantami: T
- po spełnieniu warunku, F
- gdy warunek przestaje być spełniony). .
modemTextEv[A][B]=[C]
A
-T
orF
character, variant after fulfillment or when the condition is no longer fulfilledB
- number of SMS action, integer1-4
C
- string up to 256 characters
modemSendSMS¶
Sends a test SMS according to the current configuration (first position).
modemSendSMS
modemNumber¶
Removed in SW 1.06. Instead, use modemNumberEv.
Sets the recipient number for the position.
modemNumber[A]=[B]
A
- position number, integer1-4
B
- phone numbers separated by:
, string
modemTextOn¶
Removed in SW 1.06. Instead, use modemTextEv.
Sets the content of the message used when the event condition is met.
modemTextOn[A]=[B]
A
- position number, integer1-4
B
- string up to 256 characters
modemTextOff¶
Removed in SW 1.06. Instead, use modemTextEv.
Sets the content of the message used when the event condition expires.
modemTextOff[A]=[B]
A
- position number, integer1-4
B
- string up to 256 characters
Other settings¶
Some parameters can only be configured using HTTP POST requests, not HTTP GET or MQTT. They are described below.
Image for Status for user¶
To set an image, it must be sent in binary form as POST query data to the address [IP]/api/v1/post_data/pictureupload
.
Firmware update¶
To update the firmware, it should be sent in binary form as POST query data to the address [IP]/api/v1/upload_firmware/new_firmware
.
Uploading a backup¶
To upload a backup, send it in binary form as POST request data to the address [IP]/api/v1/upload_firmware/backupSettings
.