Integración domótica Amber Electric, gratuita y de código abierto
Precios de Amber Electric en directo y previstos, picos de precio y renovables.
Publicado por prohand
- Dispositivos
- Versión 1.1.0
- Requiere Gladys >=5.1.0
- ★ 0
Esta integración conecta Gladys con su cuenta de Amber Electric (Australia) y trae el precio de su electricidad, en directo y previsto, para que sus escenas pongan en marcha la bomba de la piscina, el agua caliente o la carga del coche cuando la electricidad es barata, y las paren antes de un pico de precio.
Solo habla con la nube de Amber (lleva la etiqueta cloud): no hay nada que instalar en su red.
Lo que obtiene
- Un dispositivo por sitio de Amber (un contador, mostrado con su NMI), con:
- el precio de la electricidad que paga ahora mismo, en $/kWh;
- el precio spot mayorista;
- el precio de la carga controlada, si su contador tiene una (el agua caliente, por ejemplo);
- el precio de inyección, si exporta energía solar: lo que gana por kWh inyectado. Es negativo cuando inyectar le cuesta dinero;
- la proporción de renovables en la red, en %.
- Tres disparadores de escena, dos acciones de escena y un widget de panel (Gladys 5.1 o posterior).
Antes de empezar
Necesita una cuenta de Amber Electric con al menos un sitio activo y un token de API personal.
Crear su token de API
- Inicie sesión en la aplicación web de Amber: app.amber.com.au.
- Abra la página Developers (app.amber.com.au/developers).
- Haga clic en Generate a new token, póngale un nombre (por ejemplo
Gladys) y cópielo. Amber solo lo muestra una vez.
El token solo da acceso de lectura a sus sitios y precios. Puede revocarlo en la misma página en cualquier momento.
Configuración
- Abra la pestaña Configuración de la integración.
- Pegue el token en Token de API de Amber.
- Sitio: déjelo vacío para seguir todos los sitios activos de la cuenta. Para seguir solo uno, escriba su identificador de Amber o su NMI (el botón Probar la conexión los lista).
- Intervalo de actualización: 300 segundos (5 minutos) por defecto. Amber publica un nuevo precio cada 5 minutos y limita el número de llamadas: no sirve de nada ir más rápido, y un minuto es el mínimo.
- Horizonte de previsión: cuántas horas de precios previstos se leen, para el gráfico del widget y la franja más barata. 12 horas por defecto.
- Guarde y pulse Probar la conexión: lista sus sitios y muestra el precio actual.
- Abra la pestaña Descubrimiento y añada su sitio: sus funciones se rellenan en la siguiente actualización.
Las lecturas están alineadas con los intervalos de Amber (unos segundos después de :00, :05, :10…): el precio cambia en Gladys al mismo tiempo que en la aplicación de Amber.
Los dispositivos
| Función | Unidad | Qué es |
|---|---|---|
| Precio de la electricidad | $/kWh | Lo que paga ahora, con red y GST incluidos |
| Precio spot mayorista | $/kWh | El precio del mercado NEM detrás |
| Precio de la carga controlada | $/kWh | Solo si su contador tiene una carga controlada |
| Precio de inyección | $/kWh | Lo que gana por kWh inyectado (negativo = cuesta) |
| Renovables en la red | % | Proporción de electricidad renovable en su región |
Las funciones guardan su historial: los gráficos estándar de Gladys muestran cómo ha evolucionado el precio durante el día. Un valor solo se envía a Gladys cuando cambia (y cada 30 minutos si no).
Puede usar estas funciones en el disparador estándar estado de un dispositivo de las escenas: «cuando el precio de la electricidad supere 0,30 $/kWh…».
Escenas
La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior), en la categoría Integraciones.
Disparadores
- Cambia el nivel del precio de la electricidad — se activa cuando cambia
el nivel de precio de Amber: extremadamente bajo, muy bajo, bajo, medio, alto
o pico. Si quiere, elija el sitio y los nuevos niveles que inician la escena.
Las acciones siguientes pueden leer
{{triggerEvent.data.level}},{{triggerEvent.data.previous_level}}y{{triggerEvent.data.price}}. - Un pico de precio es posible, empieza o termina — se activa cuando el estado de pico pasa entre ninguno, posible y pico en curso. Elija «pico posible» para prepararse (enfriar la casa con antelación), «sin pico (terminado)» para reanudar.
- Inyectar a la red pasa a costar o vuelve a pagar — se activa cuando el precio de inyección cruza cero: inyectar la energía solar empieza a costar dinero (limitar el inversor, cargar la batería, poner en marcha la bomba de la piscina) o vuelve a pagar.
Un disparador se activa una vez por cambio, nunca en cada actualización. La primera lectura tras el arranque de la integración solo registra el estado actual: un reinicio no vuelve a lanzar los disparadores.
Acciones
- Leer el precio actual de la electricidad — da a las acciones siguientes
el precio actual (
price), el precio spot, el nivel (level), el estado de pico (spike_status), la proporción de renovables, si el precio aún es una estimación, y el periodo tarifario. Elija el precio que leer: electricidad comprada, carga controlada o inyección.availablees falso cuando el sitio no tiene ese canal. - Buscar el momento más barato — indique una duración (60 minutos por
defecto) y un horizonte (las próximas 12 horas por defecto): la acción
responde
starts_in_minutes,start_timeyend_time(UTC), y elaverage_pricede esa franja.foundes falso cuando la previsión es demasiado corta. Ejemplo: «cada noche a las 21:00, buscar las 2 horas más baratas de las próximas 10 horas y enviarme un mensaje: pon el lavavajillas dentro destarts_in_minutesminutos».
Panel
Añada el widget Precios de Amber a un panel. Muestra:
- el precio actual, el precio de inyección y la proporción de renovables, en c/kWh como en la aplicación de Amber, coloreados según el nivel de precio;
- el gráfico de previsión, con la hora más barata y los picos marcados;
- el nivel de precio, el estado de pico y el periodo tarifario;
- un botón Actualizar que vuelve a leer los precios al instante.
En los ajustes del widget, elija el sitio que mostrar (el primero si se deja vacío).
Solución de problemas
- «Amber rechazó el token de API»: el token se revocó o se copió mal. Cree uno nuevo en la página Developers y vuelva a pegarlo.
- «Ningún sitio de esta cuenta de Amber tiene el identificador escrito en el campo Sitio»: vacíe el campo, o copie un identificador que dé Probar la conexión.
- «Esta cuenta de Amber aún no tiene ningún sitio activo»: Amber todavía no suministra su contador (sitio pendiente). Los precios aparecerán cuando esté activo.
- «Amber limita el número de llamadas»: las lecturas se pausan unos minutos. Si se repite (otra herramienta usa el mismo token), aumente el intervalo de actualización.
- Las funciones siguen vacías: añada primero el sitio desde la pestaña Descubrimiento.
- Para más detalle, active Registros detallados en la configuración y revise los registros de la integración. Su token nunca se escribe en los registros.
Parámetros de configuración
Estos son los parámetros que Amber Electric te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Esta integración lee sus precios de Amber Electric desde la nube de Amber. Cree un token de API personal en la aplicación web de Amber (página Developers, Generate a new token), péguelo abajo y guarde: sus sitios aparecen en la pestaña Descubrimiento. |
| Token de API de Amber | secret | Sí | El token personal creado en app.amber.com.au/developers. Solo lee sus sitios y sus precios. |
| Sitio | string | No | Déjelo vacío para seguir todos los sitios activos de la cuenta. Para seguir solo uno, su identificador de Amber o su NMI: «Probar la conexión» los lista. |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura de los precios, en segundos. Amber publica un nuevo precio cada 5 minutos (300 s) y limita el número de llamadas: un minuto como mínimo. |
| Horizonte de previsión (h) | number | No | Cuántas horas de precios previstos se leen, para el gráfico del panel y la franja más barata. |
| Registros detallados (depuración) | boolean | No | Registra cada llamada a Amber y cada precio leído. El token de API nunca se registra. |
Cómo instalar Amber Electric en Gladys
- En Gladys, abre Integraciones: Amber Electric 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/prohand/gladys-amberelectric:1.1.0), 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/prohand/gladys-amberelectric.
Amber Electric 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
Amber Electric 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 prohand, 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