Integración domótica Automate Pulse Hub v2, gratuita y de código abierto
Rollease Acmeda Automate shades through the Pulse Hub v2, on the local network. Unofficial.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.2
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
This integration brings the Rollease Acmeda Automate shades paired with a Pulse Hub v2 into Gladys. Each shade becomes a shutter of the Discovery tab: open, close, stop, its position, and the battery level of battery motors. Everything stays on your local network; the cloud of Rollease Acmeda is not used. Unofficial, not affiliated with Rollease Acmeda.
Development version. This integration has never been tested with a real hub: only with a simulated hub. The local protocol of the hub is not documented by Rollease Acmeda; it comes from the aiopulse2 library (the Home Assistant integration). Feedback is welcome in the GitHub issues.
Before you start
- Set up the hub and its shades in the Automate Pulse 2 app, and name the shades there: Gladys takes their names from the hub.
- Give the hub a fixed IP address in your router (DHCP reservation).
- The Pulse Hub v1 is not supported (another protocol).
Configuration
- Address of the hub: its IP address, like
192.168.1.50. - Certificate fingerprint (optional): the hub uses a self-signed TLS certificate. Empty, the certificate met at the first connection is kept; if another one shows up later (a new hub, a reset, or another machine at this address), everything stops and the status shows its SHA-256 fingerprint. If it is your hub, press Trust the new certificate twice (within 60 s), or type that fingerprint in this field.
- Read interval: how often the state of the shades is asked (10 s by default, 5 to 300 s). After a command the shade is also read at 1.5, 4, 10, 25 and 50 s.
- Language of the feature names.
Then open the Discovery tab and add the shades.
What you get
| Feature | Gladys | Notes |
|---|---|---|
| Open / close | shutter, state | open, close, stop |
| Position | shutter, position | 0 closed .. 100 open |
| Battery | battery, % | battery motors only, an estimate from the voltage (as the app) |
A shade is never a switch: a "turn everything off" never moves it.
How the commands behave
- A move is sent within 3.5 s of your click or refused (nothing sent). It is "accepted" only when the hub then reports a change the order caused: the shade still before and now moving, a position closer to the one asked, or that position. Otherwise (a shade that was already moving proves nothing), Gladys says "sent, without confirmation" and reads the shade again. The position is confirmed only when the hub reports it; a position not reached at the end shows on the badge.
- Stop never waits for a queue nor for a pause asked by the hub. On an open connection it goes at once; without one, it opens one (one try, at most every 5 s, within its 3.5 s). It is refused when the certificate of the hub changed. It cancels a move not sent yet, and for a minute it is sent again while the hub still reports the shade moving (also first thing on the next connection if the connection dropped).
- The battery and the motor type come from the hub rarely: they are asked for at most once an hour per shade, so the battery may appear after you added the shade: then press Update on it in the Discovery tab.
- The state of all the shades is asked from the hub at most once a second, however many shades a scene moves.
Limits
- One hub per integration in this version.
- The names of the shades are read on the second port of the hub (TCP 1487); if it does not answer, a shade is named after its id ("Shade ABC"). That port is plain TCP, without TLS nor the certificate check: only the names go through it, never a command.
- A hub that refuses connections (HTTP 429 or 5xx) is left alone 1 minute to 6 hours; other failures are retried after 10 s, 30 s, 1, 2 and 5 minutes, never sooner than the read interval, a restart included.
- Nothing is a secret here: the hub has no password.
Parámetros de configuración
Estos son los parámetros que Automate Pulse Hub v2 te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Your Automate shades in Gladys | section | No | Each shade paired with your Pulse Hub v2 becomes a shutter in the Discovery tab: open, close, stop, position, and the battery of battery motors. Everything stays on your local network (the WebSocket of the hub, which is not documented by Rollease Acmeda); the cloud is not used. Set up the hub and its shades in the Automate Pulse 2 app first. Never tested with a real hub yet. Unofficial, not affiliated with Rollease Acmeda. |
| Address of the hub | string | Sí | The local IP address of your Pulse Hub v2, like 192.168.1.50. Give it a fixed address in your router (DHCP reservation). |
| Certificate fingerprint (optional) | string | No | The hub uses a self-signed certificate. Empty: the certificate met at the first connection is kept, and another one later stops everything until you vouch for it (its fingerprint is then shown in the status). Or type its SHA-256 fingerprint here. |
| Read interval (s) | number | No | How often the state of the shades is asked from the hub (5 to 300 s). After a command, the shade is also read a few times while it moves. |
| Language of the feature names | select | No | Used for the names of the features of the shades added from now on. |
Cómo instalar Automate Pulse Hub v2 en Gladys
- En Gladys, abre Integraciones: Automate Pulse Hub v2 aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/lm1lc3n7/gladys-automate-pulse:0.1.2), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-automate-pulse.
Automate Pulse Hub v2 requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Automate Pulse Hub v2 es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación