Switch Settings - mongoose-os-apps/shelly-homekit GitHub Wiki

/resources/Switch-Settings.png


Status: Toggle button controls the relay ON or OFF.

Power: Shows the current / total used power usages.

Name: Name of the switch relay in HomeKit.

HAP Type: Allows you to choose the type of accessory you would like to be shown in HomeKit.

  • Disabled: hides the switch from HomeKit.
  • Switch: shown as a switch in HomeKit.
  • Outlet: shown as an outlet in HomeKit.
  • Lock: shown as a lock in HomeKit.
  • Valve: shown as a water Valve in HomeKit (other options available in 'Valve Type').

Valve Type: Allows you to choose the type of water accessory you would like to be shown in HomeKit (this is only available when HAP Type is set to 'Valve').

  • Generic Valve: shown as a garden tap in HomeKit.
  • Irrigation: shown as a Sprinkler Irrigation in HomeKit.

NOTE: Apple's Home app doesn't support the valve in automatisations and scenes, you can work around that by using other app like Home+ or Eve.

Input Mode: Allows you to choose how the input associated with the switch will be controlling the relay (this is not present on devices like Plugs, that have no external input control).

  • Momentary: push button that is only engaged while it is being depressed. The relay state changes once per press.
  • Toggle: always relates the relay state to the power state ON or OFF coming from the switch. This works the same way for 1, 2 or 3 switches in a hallway. When you switch the Shelly via the home app or automations, it may not be in sync with the switch state any more and then you have to press the switch two times to switch the relay again.
  • Edge: means that the relay changes its state every time when the switch also changes. It doesn’t matter if the switch is on or off, it will also toggle the relay state. That’s a good mode if you want to use a wall switch and automations / home app without the effect mentioned above.
  • Detached: will not affect the output in any way and will instead the input will be disassociated from the relay, goto to "Input1" / "Input2" to configure it.
  • Activation: any input turns "ON" and resets Auto OFF timer.

Inverted Input: This swaps the input method from Closed circuit to OPEN, and Open circuit to CLOSED..

Initial state: How the relay acts upon power up or reboot.

  • Off: is in OFF position.
  • On: is in ON position
  • Last: returns to the same position before power was lost or rebooted.
  • Input: whatever the physical switch is set to.

Auto off: Toggle to enable or disable auto off, when enabled this will automatically turn off the relay after a user set period of time.

When Input Mode is Momentary:

  • Short Press: turns on the relay and activates the auto off.
  • Long Press: turns on the relay, but bypasses the auto off, for this action only.

Auto off delay: The delay time before the relay turns off, format is D:HH:MM:SS.sss (hidden when Auto off is disabled).

  • D: is the number of days
  • HH: is the numbers of hours
  • MM: is number of minutes.
  • SS: is the number of seconds
  • sss: is the number of milliseconds.

State LED: Turns On / Off the LED Status indicator on the device (not available on Shelly1).

[Save] button: Saves settings.