diff --git a/Commands.md b/Commands.md index 09b1a027..12b3f2fa 100644 --- a/Commands.md +++ b/Commands.md @@ -106,7 +106,7 @@ Simply put, other messages may precede messages published as a result of your co BlinkTime | Time in 0.1 seconds to [blink](#power) (toggle Power) for a relay **(does not control device LED)**
`2..3600` = set with 0.1 second increment ButtonDebounce | User control over button debounce timing
`40..1000` = set button debounce time in ms. Default is `40` FanSpeed | Fan speed control *([iFan02](Sonoff-iFan02) module only)*
`0` = turn fan OFF
`1..3` = set fan speed
`+` = increase fan speed
`-` = decrease fan speed
-Interlock | Relay interlock mode and group selection. Introduced in [v6.4.1.11](https://github.com/arendst/Sonoff-Tasmota/pull/5014)
`0` = set self-locking mode for all relays *(default)*
`1` = set interlock mode for selected relays +Interlock | Relay interlock mode and group selection.
`0` = set self-locking mode for all relays *(default)*
`1` = set interlock mode for selected relays | | Add up to 8 relays in 1 to 4 interlock groups, each separated by a space. For example
`1,2 3,4` = Group Relay1 and Relay2 in group 1 and Relay3 and Relay4 in group 2 (_note the space between the two group declarations_)
`1,2,3` = group Relay1, Relay2 and Relay3 in a single interlock group
`1 3 2,4` = Relay1 is in group 1, Relay3 in group 2, Relay2 and Relay4 in group 3 LedMask | Allows setting a `` which specifies which relays control the LED indicator used to display whether a relay is latched/powered. The order of the `` is from most significant bit (MSB) to least significant bit (LSB). Bit 15 (MSB) masks Relay16 through bit 0 (LSB) which masks Relay1, respectively. Introduced in [v6.5.0.7](../commit/df6645481e08b36fe61aaebeeeed249d60730386)

`` = [bitwise](https://whatis.techtarget.com/definition/bitwise) value representing each relay. Values may be entered as either hexadecimal or decimal values (e.g., 0xFFFF = 65535). `0xFFFF` (= 1111 1111 1111 1111) All relays control the power LED _(default)_

**Examples:**
  • `LedMask 0xFFFD` Every relay, except Relay2, controls the power LED (0xFFFD = 1111 1111 1111 1101)
  • `LedMask 0x0002` Only Relay 2 controls the power LED (0x0002 = 0000 0000 0000 0010)
    • LedPower | LED power state as on or off
    `0` = turn LED OFF and LedState OFF
    `1` = turn LED ON and LedState OFF
    (Use `Backlog LedPower 0; SetOption31 1` to disable LED even when Wi-Fi or MQTT is not connected) @@ -170,7 +170,7 @@ Command | Parameters WebPassword | Show current web server password
    `0` = disable use of password for WebUI
    `1` = reset password to firmware default (`WEB_PASSWORD`)
    `` = set WebUI password for user `WEB_USERNAME` (32 char limit) WebSend | Send a command to Tasmota host. If a command starts with a `\` it will be used as a link.
    `[:,:] `
    `` = hostname or IP address.
    `` = port for the device if not the default `80`
    `` = enter username of the device you're sending the command to
    `` = enter password of the device you're sending the command to
    `` = command and payload
    *example: `[sonoff] POWER1 ON` sends `http://sonoff/cm?cmnd=POWER1 ON`* WebServer|`0` = stop web server
    `1` = start web server in user mode
    `2` = start web server in admin mode -WifiConfig|`0` - disable Wi-Fi config but restart (used with alternate AP)
    `1` = start smart config for 1 minute and set as current config tool
    `2` = start Wi-Fi manager (web server at 192.168.4.1) and set as current config tool
    `3` = start WPS config for 1 minute and set as current config tool
    `4` = disable Wi-Fi config but retry other AP without restart
    `5` = disable Wi-Fi config but retry same AP without restart and flash writes
    `7` = start restricted Wi-Fi manager (web server at 192.168.4.1 with only option to reset device settings) and set as current config tool. _**This setting is recommended for devices without an external control/reset button**_. *(Introduced in 6.4.1.18)* +WifiConfig|`0` - disable Wi-Fi config but restart (used with alternate AP)
    `1` = start smart config for 1 minute and set as current config tool
    `2` = start Wi-Fi manager (web server at 192.168.4.1) and set as current config tool
    `3` = start WPS config for 1 minute and set as current config tool
    `4` = disable Wi-Fi config but retry other AP without restart
    `5` = disable Wi-Fi config but retry same AP without restart and flash writes
    `7` = start restricted Wi-Fi manager (web server at 192.168.4.1 with only option to reset device settings) and set as current config tool. _**This setting is recommended for devices without an external control/reset button**_. See also | [`SetOption55`](#Setoption55) - mDNS service control
    [`SetOption56`](#Setoption56) - Wi-Fi network scan to select strongest signal on restart
    [`SetOption57`](#Setoption57) - Wi-Fi network re-scan every 44 minutes with switch to +10dB stronger signal if detected ### [MQTT](MQTT) @@ -401,11 +401,11 @@ See [Linux Infrared Remote Control (LIRC)](http://www.lirc.org/) for more inform SetOption29|IR received data format
    `0` = hex *(default)*
    `1` = decimal SetOption30|Enforce Home Assistant autodiscovery as light
    `0` = relays are announced as a switch and PWM as a light *(default)*
    `1` = both relays and PWM are announced as light SetOption31|Disable status LED blinking during Wi-Fi and MQTT connection problems.[`LedPower`](#LedPower) must be set to `0` for this feature to work.
    `0` = LED blinking enabled *(default)*
    `1` = LED blinking disabled -SetOption32|Number of 0.1 seconds to hold button before sending `hold` action message. Introduced in 6.4.1.14
    `1..100` to set Key Hold Time from 0.1 seconds to 10 seconds *(default =`40` (4 seconds))* +SetOption32|Number of 0.1 seconds to hold button before sending `hold` action message.
    `1..100` to set Key Hold Time from 0.1 seconds to 10 seconds *(default =`40` (4 seconds))* SetOption33|Max power limit can be exceeded by number of seconds before the relay is turned off
    `1..250` = set number of seconds *(default = `5`)* SetOption34|Set [Tuya dimmer device id](https://github.com/arendst/Sonoff-Tasmota/pull/4095)
    `0..255` = device id -SetOption36|Boot loop defaults restoration control. Introduced in 6.4.1.13
    `0` = disable boot loop control
    `1..200` = set number of boot loops (a restart caused by any exception or watchdog timer within less than `BOOT_LOOP_TIME` (default 10) seconds) before beginning to restore settings *(default = `1`)*. Once this number is reached, subsequent restarts will:
    • 1st restart: disable ESP8285 generic GPIOs interfering with flash SPI
    • 2nd restart: disable rules causing boot loop
    • 3rd restart: disable all rules
    • 4th restart: reset user defined GPIOs to disable any attached peripherals
    • 5th restart: reset module to Sonoff Basic (1)
    -SetOption37|Color remapping for led channels, also provides an option for allowing independent handling of RGB and wite channels. Introduced in 6.4.1.19
    `0` = disabled
    `1..119` = according to [this table](https://github.com/arendst/Sonoff-Tasmota/wiki/SetOption37---Color-channel-mapping)
    `120..127` = invalid (results in same as `0`)
    `128..255` = same as `0..127` but with independent channel handling enabled +SetOption36|Boot loop defaults restoration control.
    `0` = disable boot loop control
    `1..200` = set number of boot loops (a restart caused by any exception or watchdog timer within less than `BOOT_LOOP_TIME` (default 10) seconds) before beginning to restore settings *(default = `1`)*. Once this number is reached, subsequent restarts will:
    • 1st restart: disable ESP8285 generic GPIOs interfering with flash SPI
    • 2nd restart: disable rules causing boot loop
    • 3rd restart: disable all rules
    • 4th restart: reset user defined GPIOs to disable any attached peripherals
    • 5th restart: reset module to Sonoff Basic (1)
    +SetOption37|Color remapping for led channels, also provides an option for allowing independent handling of RGB and wite channels.
    `0` = disabled
    `1..119` = according to [this table](https://github.com/arendst/Sonoff-Tasmota/wiki/SetOption37---Color-channel-mapping)
    `120..127` = invalid (results in same as `0`)
    `128..255` = same as `0..127` but with independent channel handling enabled SetOption51|View extra pins for ESP8285 in Module Config
    **WARNING** Do not use on ESP8266 devices!!!
    `0` = disable *(default)*
    `1` = enable SetOption52|Control display of optional time offset from UTC in JSON messages
    `0` = disable *(default)*
    `1` = enable SetOption53|Display hostname and IP address in GUI
    `0` = disable *(default)*
    `1` = enable @@ -416,8 +416,8 @@ See [Linux Infrared Remote Control (LIRC)](http://www.lirc.org/) for more inform SetOption58|[IR Raw data in JSON message](https://github.com/arendst/Sonoff-Tasmota/issues/2116#issuecomment-440716483)
    `0` = disable *(default)*
    `1` = enable SetOption59|Send `tele/%topic%/STATE` in addition to `stat/%topic%/RESULT` for commands: [`State`](#State), [`Power`](#Power) and any command causing a light to be turned on.
    `0` = disable *(default)*
    `1` = enable SetOption60|Enable normal sleep instead of [dynamic sleep](Dynamic%20Sleep)
    `0` = dynamic sleep *(default)*
    `1` = sleep -SetOption61|Force [local operation](https://github.com/arendst/Sonoff-Tasmota/pull/4562#issuecomment-446230001) when [`ButtonTopic`](#ButtonTopic) or [`SwitchTopic`](#SwitchTopic) is set. Introduced in 6.4.1.17
    `0` = disable *(default)*
    `1` = enable -SetOption62|Introduced in 6.4.1.18
    `0` = disable *(default)*
    `1` = don't use retain flag on `HOLD` messages +SetOption61|Force [local operation](https://github.com/arendst/Sonoff-Tasmota/pull/4562#issuecomment-446230001) when [`ButtonTopic`](#ButtonTopic) or [`SwitchTopic`](#SwitchTopic) is set.
    `0` = disable *(default)*
    `1` = enable +SetOption62|`0` = disable *(default)*
    `1` = don't use retain flag on `HOLD` messages ### Serial Bridge Both Hardware and Software Serial Bridge are supported.