Simplified Integration of Battery Operated Shelly Devices

S.C.O.R.E. → Convenience → DeviceControl

Overview

Configuring battery-operated Shelly devices used to require manual setup of outbound WebSocket configurations, which could be cumbersome. With @bdraco’s update, this process has been streamlined, allowing for quicker and easier integration, enhancing user convenience and efficiency in home capability.

Benefits

• Reduces setup time for homeowners when adding new devices.
• Minimizes technical barriers for non-expert users.
• Improves overall user experience with smoother device management.

Intent

The purpose of this capability is to simplify the process of adding battery-operated Shelly devices to a home capability system. By eliminating the need for manual WebSocket configuration, users can quickly and easily integrate these devices, resulting in a more efficient home setup.

Preconditions

• Home Assistant version 2024.9 or later installed.
• Battery-operated Shelly devices available for integration.
• Stable internet connection for WebSocket communication.
• Home Assistant installed and configured.
• Integration available and authenticated: Shelly.
• Device installed and reachable: Energy Monitoring.

Actors

• Homeowner
• Family member
• Guest

Trigger

The capability is triggered when a new battery-operated Shelly device is detected within the network.

Workflow Diagram

flowchart TD
    A[New Shelly Device Detected] -->|check| B{{WebSocket Configuration Required?}}
    B -->|Yes| C[Set Up WebSocket Configuration]
    C --> D[Device Successfully Integrated]
    B -->|No| E[Skip Configuration]
    E --> D[Device Successfully Integrated]

Workflow Description

1. Detect Device

The home capability system identifies a new battery-operated Shelly device on the network.

2. Check Configuration Requirement

The system checks if the device requires a WebSocket configuration to be set up.

3. Configure Automatically

If a configuration is needed, the system automatically sets up the WebSocket configuration without user intervention.

4. Integrate Device

The device is integrated into the home capability system, allowing it to be controlled through the interface.

5. Notify User

The homeowner receives a notification confirming successful integration of the new device.

Postconditions

The battery-operated Shelly device is fully integrated into the home capability system, ready for control and capability tasks.

Optional Enhancements

• Add support for additional device types in future updates.
• Implement a backup configuration option for users.
• Provide a user-friendly guide for troubleshooting integration issues.

Recommended Components

Source Examples

• 2026.1: Home is where the dashboard is ?? – Home Assistant (homeassistant)