Skip to content

Quick Start Guide - ECO1624 Device

Prerequisites

Before setting up your ECO1624 device, make sure your Home Assistant environment is ready with MQTT support.

Install MQTT (Mosquitto broker) Add-on

  1. In Home Assistant, go to Settings → Add-ons → Add-on Store.
  2. Search for Mosquitto broker and click Install.
  3. (Recommended) Create a dedicated MQTT user: Settings → People → Users → Add user
    Username: mqtt (example)
    Password: your-strong-password
    Do not make it an administrator.
  4. Open the Mosquitto broker add-on → Configuration: leave defaults (the add-on uses HA users).
  5. Click Start, and optionally Start on boot, Autoupdate
  6. Note the connection details for your device:
    MQTT Server: IP of your HA box (e.g., 192.168.8.90)
    Port: 1883 (non-TLS) or 8883 (TLS, only if you set it up)
    MQTT Username/Password: the user you created in step 3.

Getting Started

If you prefer a mobile setup, you can also configure ECO1624 with the EcoEdge.io iOS app:

  1. Download the app from the Apple App Store.
  2. Use the app to scan for nearby devices and choose the one with the ECOEDGE_ prefix.
  3. Enter the same Configuration Parameters listed below to finish setup.

Or, use the built-in WiFi portal:

  1. Turn on the ECO1624 device. The LED indicator will light up.
  2. Find the WiFi connection (access point) named EcoEdge-Setup and connect.
  3. Password: password
  4. After a successful WiFi connection, a configuration window with parameters will automatically open.
  5. If the window does not open automatically, open a web browser and enter the address:
    http://192.168.4.1

Configuration Parameters

  1. Device Name
    Choose a unique name to make it easier to identify the device in Home Assistant later. (Mandatory)
  2. WiFi SSID
    Your WiFi Access Point SSID. (Mandatory)
  3. WiFi Password
    Your WiFi Access Point password. (Mandatory)
  4. MQTT Server
    MQTT server IP address. (Mandatory)
    Example: Non-SSL mqtt://192.168.8.90:1883, SSL/TLS mqtts://192.168.8.90:8883
  5. MQTT Username
    MQTT server username, if authentication is enabled. (Optional)
  6. MQTT Password
    MQTT server password, if authentication is enabled. (Optional)
  7. Login Username
    Device web UI username. Default: admin. It is recommended to change this. (Optional but Recommended)
  8. Login Password
    Device web UI password. Default: admin. It is recommended to change this. (Optional but Recommended)
  9. Syslog Server : IP address of the syslog server. (Optional)
  10. IP Mode
    Choose DHCP or Static IP mode. (Optional)

Integration with Home Assistant

Once the device successfully connects to your WiFi network and the MQTT service, it will automatically appear in the Home Assistant Integrations section under MQTT, using the Device Name you specified in step 1.

Factory Reset

If you ever need to clear saved settings, perform a factory reset using the recessed reset button on the upper-left side of the device. A small screwdriver or similar tool is recommended.

  1. Power on the ECO1624.
  2. Press and hold the reset button. The LEDs will illuminate in sequence from 1 through 16.
  3. Once all 16 LEDs are lit, release the button. The reset is now complete—no additional reboot is required.