Skip to content

1. Getting Started — Home Assistant Integration Requirements

The EasyRoll Smart Blind can connect directly to Home Assistant (HA). Once connected, you can control the blind from your HA dashboard and use it in HA automations (sunrise/sunset, temperature triggers, etc.).

How does it work?

[Home Assistant] ←── home network (MQTT) ──→ [Blind]

  • This is a local connection that does not go through the cloud — it works at home even when the internet is down.
  • It uses HA's MQTT integration, and the blind registers automatically (no code to write).

Requirements Checklist

Item Description
Home Assistant Installed and running (HA OS, container, etc. — any type)
MQTT broker The HA Mosquitto broker add-on is recommended — see below for installation
MQTT user account One HA user (e.g. easyroll1) — the blind logs in with this account
Same network The blind and HA must be on the same Wi-Fi router
Blind firmware v2.9.7 or later (supports the web setup method)

Installing the Mosquitto broker

If you don't have an MQTT broker yet, install it as an HA add-on. (Skip this if you already use one.)

① Install the add-on

  1. In the HA left menu, go to Settings → Apps (or Add-ons, depending on your version).
  2. Open the [Add-on Store] at the bottom right.
  3. Type mosquitto in the search box to find Mosquitto broker.
  4. Click [Install]. (Takes 1–2 minutes.)

② Startup settings

Once installed, configure it in the Controls area on the right of the add-on's [Info] tab.

  1. Click [Start] to run it. (If it's already running, you'll see Stop / Restart buttons.)
  2. Turning on the following two options keeps it stable:
    • Start on boot — the broker starts automatically when HA powers on
    • Watchdog — automatically restarts the broker if it stops
  3. When the status at the top left shows Running, everything is fine.

💡 The host name core-mosquitto at the bottom right of the same screen is used as the broker address later, when you manually add the MQTT integration. 💡 You can leave Auto update off. (Update manually whenever you like.)

③ Check the ports (leave the defaults as-is)

At the top of the add-on, the [Configuration] tab → the Network section at the bottom already has the ports configured.

Port Purpose
1883 Normal MQTT — the port the blind uses
1884 MQTT over WebSocket
8883 Normal MQTT with SSL
8884 MQTT over WebSocket with SSL

💡 The blind uses 1883 only. Unless you have a specific reason, leave the defaults as-is.

Don't touch the other settings

The SSL · Certificate/Private Key · Log Types · Customize and other options on the same [Configuration] tab are not needed for EasyRoll integration. Leave them at their defaults.

In particular, turning on Require Client Certificate will prevent the blind from connecting to the broker.

④ Create the MQTT account the blind will use

Mosquitto logs in with an HA user account. Create one dedicated account for the blind.

  1. Settings → Users (People/Users, depending on your version) → [Add user]
  2. Choose a name and username. (e.g. easyroll1)
  3. Set a password and write it down — you'll enter this value in the blind's settings.
  4. Admin privileges are not required.

⑤ Check the MQTT integration

For the blind to talk to HA, the MQTT integration must be registered.

Go to Settings → Devices & Services → the [Integrations] tab at the top, then follow whichever of the three cases below matches your screen.

Case 1 — an MQTT card is already in the "Configured integrations" list at the bottom

It's already registered. You don't need to do anything. (Proceed to 2. Connecting the Device.)

Case 2 — MQTT appears under "Discovered integrations" at the top

Click the [Add] button on the card, then [Submit] in the window that follows to register it.

Case 3 — MQTT isn't anywhere (add it manually)

  1. Click [＋ Add Integration] at the bottom right of the screen.
  2. Type MQTT in the search box and select it.

  3. Enter the values below and click [Submit].

    Field Value
    Broker core-mosquitto
    Port 1883
    Username / Password The MQTT account you created in ④

💡 Once registered, an MQTT card appears in the "Configured integrations" list.

💡 With that done, the blind is ready to connect. Continue to 2. Connecting the Device.

3 things to note down in advance

You'll need to enter these during the connection step, so write them down:

  1. Broker IP = the IP of the machine HA is installed on (e.g. 192.168.0.14)
  2. Find it in HA: Settings → System → Network
  3. Broker port = 1883 by default
  4. MQTT username / password = the account you created above

⚠️ If you installed HA on a NAS virtual machine or similar, the IP must be the LAN IP visible on your router (not an internal address like 172.30.x.x).