Shelly Smart Relay

1. Overview

This premium QuickApp is specifically optimized to overcome the typical limitations of standard marketplace plugins. Beyond sending standard On/Off commands, it establishes a reliable bi-directional communication channel with your Shelly 1 or Shelly Plus 1 devices via the HTTP API. Extensively field-tested, it guarantees near-zero latency, immediate UI responsiveness, and unparalleled system stability.

2. Key Features

• Real-time Bi-directional Synchronization: Automatically updates the status on the Fibaro interface even when toggled manually via a physical wall switch, the native Shelly app, or voice assistants.
• Absolute Safe Anti-Freeze Loop: Utilizes an intelligent, independent asynchronous scheduling algorithm (fibaro.clearTimeout paired with an isolated fibaro.setTimeout loop) and enforces a strict 5-second request timeout limit. This ensures that the Fibaro gateway never hangs, freezes, or suffers from thread bottlenecks if the Shelly device loses power or goes offline.
• Enhanced Security (HTTP Basic Auth): Automatically processes Base64 encryption for your credentials (Username/Password). This enables secure communication with Shelly modules that have "Restrict Login" security enabled.
• Comprehensive Hardware Telemetry: Displays critical diagnostics directly on the Fibaro UI dashboard, including real-time WiFi signal strength (dBm), continuous system Uptime, available RAM consumption, and operational network states.
• Relay Operating Cycles Counter: Keeps a persistent record of the relay's physical toggle actions (ON/OFF). This data is incremented and stored inside a local system variable, helping you monitor component wear and schedule preventative maintenance.
• Smart Auto Reboot: Allows scheduling automatic device reboots after a defined number of operational hours (default is 24h). This clears the ESP chip's RAM cache, preventing memory leaks and increasing hardware longevity.
• One-Touch Remote Maintenance: Includes a dedicated virtual REBOOT MODULE button on the interface so installers or homeowners can reboot the Shelly hardware remotely without needing to flip breaker switches or open walls.

3. UI Breakdown & Visuals

The user interface is clean, minimalist, yet packed with high-end telemetry data:

• ON / OFF / Auto Off Switches: Main relay triggers providing instant graphical feedback.
• WiFi Indicators: Color-coded status icons (🟢 Excellent/Good, 🟡 Fair, 🟠 Weak, 🔴 Poor) mapped alongside actual dBm levels to help optimize your access point placement.
• Network Info: Displays the module's Static IP and MAC Address clearly for easy network administration.
• RAM & Reboot Status: Tracks real-time system memory usage in percentages (%) and reflects your current auto-reboot interval configuration.
• Cloud & MQTT Status: Instantly diagnostics whether the device is successfully connected to local MQTT Brokers or the global Shelly Cloud.

4. Variables Configuration

After importing the .fqa file into your Fibaro Home Center, please configure the following variables within the device settings tab:

Variable Name	Default Value	Description
IP	192.168.1.100	The local LAN IP address of your Shelly 1 device (Static IP recommended).
Port	80	The standard HTTP API port used by Shelly.
Channel	0	The target relay channel index (Defaults to 0 for single-channel Shelly 1).
Loop	5000	State-polling cycle interval in milliseconds. 5000ms (5 seconds) is optimized for stability.
Username	Leave Empty	The login username if Restrict Login security is activated on the Shelly device.
Password	Leave Empty	The corresponding login password for your Shelly device.
AutoRebootHours	24	Continuous uptime hours before triggering an automated system reboot (Set to 0 to DISABLE).
RelayToggleCount	0	System-managed counter that stores total relay operation cycles over time.

5. Quick Installation Guide

• Step 1: Download the QuickApp binary configuration file (SHELLY_SIG.fqax) to your local drive.
• Step 2: Log into your Fibaro Home Center to Settings -> Devices -> Click Add Devices -> Select Other Device -> Click Upload File and select your downloaded file (SHELLY_SIG.fqax).
• Step 3: Open the newly created device, head to the Variables tab, fill in your Shelly module's network credentials (IP, Port, Username, Password...), and click Save.
• Step 4: The QuickApp will initialize automatically within a few seconds, fetching your telemetry logs and syncing real-time relay values instantly.