Last Updated:

Configure Wi-Fi on Shelly Gen 2+ Devices via Home Assistant

S.C.O.R.E.ConvenienceDeviceControl

Overview

This capability allows users to configure Wi-Fi settings on Shelly generation 2+ devices directly from Home Assistant using Bluetooth, eliminating the need for manual configuration. It simplifies the setup process, making it more accessible for those who may find traditional methods cumbersome.

Convenience icon

Benefits

  • Streamlined setup process for Shelly devices, saving time and effort.
  • No need to physically access the device for Wi-Fi configuration.
  • Improved user experience for technology enthusiasts managing multiple devices.

Intent

The purpose of this capability is to enable users to easily manage network settings for their Shelly generation 2+ devices through Home Assistant. This results in a more cohesive smart home experience, allowing for quicker adjustments and better device management.

Preconditions

  • Home Assistant is installed and configured.
  • Shelly generation 2+ device is powered on and within Bluetooth range.
  • Bluetooth integration is enabled in Home Assistant.
  • Home Assistant installed and configured.
  • Integration available and authenticated: Shelly.
  • Device installed and reachable: Unifi Networks.

Actors

  • Homeowner
  • Family member
  • Guest

Trigger

The process begins when the user initiates the configuration through the Home Assistant interface.

Workflow Diagram

flowchart TD
    A[User Initiates Wi-Fi Setup] -->|check| B{{Is Bluetooth Enabled?}}
    B -->|Yes| C[Connect to Shelly Device]
    C --> D[Configure Wi-Fi Settings]
    D --> E[Save Configuration]
    B -->|No| F[Prompt User to Enable Bluetooth]

Workflow Description

1. Initiate Setup

User opens Home Assistant and navigates to the Shelly device configuration section.

2. Check Bluetooth

Home Assistant checks if Bluetooth is enabled and within range.

3. Connect to Device

If Bluetooth is enabled, Home Assistant connects to the Shelly device.

4. Enter Wi-Fi Credentials

User inputs the desired Wi-Fi network name and password in the interface.

5. Save Configuration

Home Assistant sends the configuration to the Shelly device for saving.

6. Confirmation

User receives a notification confirming successful configuration.

Postconditions

The Shelly generation 2+ device is connected to the specified Wi-Fi network and is fully operational within the Home Assistant environment.

Optional Enhancements

  • Add a monitoring feature to check Wi-Fi signal strength.
  • Implement an auto-update feature for device firmware through Home Assistant.
  • Create a backup option for Wi-Fi settings to restore configurations easily.

Recommended Components

Recommended ApplicationsRecommended IntegrationsRecommended Devices
Home AssistantShellyUnifi Networks

Source Examples