Integración domótica Audi Connect, gratuita y de código abierto
Batería, carga, climatización, cierres y posición de sus Audi, desde myAudi.
Publicado por prohand
- Dispositivos
- Versión 0.0.2
- Requiere Gladys >=5.1.0
- ★ 0
Siga sus Audi en Gladys: batería y carga, combustible, autonomía, kilometraje, cierres, puertas y ventanas, climatización y posición de aparcamiento. Inicie o detenga la carga y la climatización, fije el objetivo de carga, cierre y abra el coche, desde Gladys, una escena o el panel.
La integración lee la nube de Audi (myAudi): los mismos datos que la app myAudi.
Antes de empezar
- Una cuenta myAudi con su coche añadido y los servicios Audi connect activos (como en la app myAudi).
- Una cuenta creada en Europa o en Canadá. Las cuentas de Estados Unidos y China no son compatibles.
- Opcional: su S-PIN (PIN de seguridad de myAudi de 4 cifras), solo para cerrar y abrir desde Gladys.
- Algunos valores y órdenes dependen del coche y de su contrato connect: un coche que no informa de un valor simplemente no tiene la función correspondiente.
Configuración
- Abra la pestaña Configuración de la integración.
- Elija su Mercado: Europa (todos los países europeos) o Canadá. Guarde.
- Pulse Conectar junto a Cuenta myAudi. Se abre una página de Audi: inicie sesión con su cuenta myAudi y apruebe el código mostrado. La pantalla de configuración muestra el mismo código mientras espera (10 minutos como máximo).
- Una vez aprobado, el estado pasa a conectado y sus coches aparecen en la pestaña Descubrimiento: añádalos.
- Opcional: indique su S-PIN para cerrar y abrir desde Gladys.
- Opcional: cambie el Intervalo de actualización, 15 minutos por defecto (de 5 minutos a 1 hora).
¿Por qué no hay contraseña? Audi ya no permite que las aplicaciones de terceros inicien sesión con contraseña. El inicio de sesión en la página de Audi es el método que Audi sigue aceptando. La integración conserva la sesión (un token, guardado por Gladys, nunca mostrado) y la renueva sola: solo se conecta una vez.
Qué muestra cada coche
| Función | Coches | Control |
|---|---|---|
| Kilometraje | todos | |
| Nivel de batería | eléctricos e híbridos | |
| Autonomía eléctrica | eléctricos e híbridos | |
| Autonomía | gasolina, diésel, PHEV | |
| Nivel de combustible | gasolina, diésel, PHEV | |
| Carga | eléctricos e híbridos | iniciar / detener |
| Enchufado | eléctricos e híbridos | |
| Potencia de carga | eléctricos e híbridos | |
| Tiempo de carga restante | eléctricos e híbridos | |
| Objetivo de carga | eléctricos e híbridos | de 20 a 100 % |
| Climatización | si es compatible | iniciar / detener |
| Temperatura de climatización | si es compatible | usada en el próximo inicio |
| Cerrado | todos | cerrar / abrir (S-PIN) |
| Puerta abierta, Ventana abierta | todos | |
| Revisión en (días, km) | si se informa | negativo si está atrasada |
| Posición de aparcamiento | si se comparte | latitud, longitud |
Una insignia en cada coche muestra nube cuando la última lectura funcionó, inaccesible cuando falló.
Las órdenes tardan: el coche recibe la orden por la nube de Audi y la ejecuta en menos de un minuto. Gladys muestra el nuevo estado cuando el coche lo confirma, y el coche se vuelve a leer 20 segundos después.
Botones de la configuración
- Probar la conexión: vuelve a iniciar sesión, lista sus coches y las llamadas que quedan hoy.
- Actualizar un coche ahora: lee un coche al instante. Marque Despertar el coche para pedir valores nuevos al propio coche (hasta 2 minutos; usa la batería de 12 V, así que no demasiado a menudo).
- Hacer parpadear las luces: el coche hace parpadear sus luces 10 segundos, para encontrarlo en un aparcamiento (necesita su posición de aparcamiento).
Escenas
La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior).
Disparadores:
- Ha cambiado el estado de carga: cargando, terminada (objetivo alcanzado), sin cargar, error. Filtre por coche y por nuevo estado. Variables: nombre del coche, estado, nivel de batería, autonomía.
- Coche cerrado o abierto: el estado de cierre cambió entre dos lecturas. Variables: nombre del
coche, estado (
locked/unlocked). - Ha fallado una orden al coche: el coche o la nube de Audi rechazó una orden (cierre, carga,
climatización…). Variables: nombre del coche, orden, motivo (
spin_missing,spin_refused,failed,error…), mensaje.
Acciones:
- Iniciar la climatización de un coche, con una temperatura opcional (16 a 30 °C; vacío: los ajustes del coche). Salidas: inicio aceptado, confirmado por el coche.
- Detener la climatización de un coche. Salidas: parada aceptada, confirmada por el coche.
- Leer un coche ahora, despertándolo si se desea. Salidas: nivel de batería, autonomía, nivel de combustible, kilometraje, cerrado, cargando, enchufado, climatización encendida — utilizables por las acciones siguientes.
Ejemplo: «cada día laborable a las 7:30, si la batería está por debajo del 30 %, iniciar la carga; a las 7:45, iniciar la climatización a 21 °C».
Panel
Añada el widget Coche Audi y elija el coche (el primero si se deja vacío). Muestra en directo el indicador de batería (o de combustible), la autonomía y el kilometraje, los cierres, puertas y ventanas, la carga y la climatización, la hora del último dato y botones: actualizar, iniciar/parar el clima, cerrar (nunca abrir desde un panel) y un enlace al mapa de la posición de aparcamiento.
Límites
- Audi limita el número de llamadas por cuenta y por día. Cada lectura de un coche cuesta dos llamadas: mantenga un intervalo de 15 minutos o más si tiene varios coches. Probar la conexión indica las llamadas que quedan hoy.
- Los valores son los últimos que el coche envió a la nube. Un coche aparcado y dormido no envía nada: use Despertar el coche cuando necesite valores nuevos.
Solución de problemas
- «Aún no hay ninguna cuenta myAudi vinculada»: pulse Conectar y apruebe el código en la página de Audi.
- «Audi ha rechazado el inicio de sesión guardado»: el vínculo fue revocado (contraseña cambiada en myAudi, cuenta eliminada…). Pulse de nuevo Conectar.
- Cerrar o abrir falla con
spin_missing/spin_refused: indique el S-PIN correcto. - Falta un valor: el coche no lo informa, o el servicio no forma parte de su contrato connect. Compruébelo en la app myAudi.
- Active Registros detallados en la configuración, reproduzca el problema y lea los registros de la integración. El correo, las contraseñas, los tokens y el S-PIN nunca se registran.
Parámetros de configuración
Estos son los parámetros que Audi Connect te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | Elija su mercado y pulse Conectar: se abre una página de Audi, inicie sesión con su cuenta myAudi y apruebe el código. Sus coches aparecen después en la pestaña Descubrimiento. Audi ya no permite que las aplicaciones de terceros inicien sesión con contraseña, por eso no se pide ninguna aquí. |
| Mercado | select | Sí | Dónde se creó su cuenta myAudi. Europa abarca todos los países europeos. |
| Cuenta myAudi | account_link | No | Abre la página de inicio de sesión de Audi. Apruebe el código mostrado; la integración lo espera (10 minutos como máximo). |
| S-PIN | secret | No | El PIN de seguridad de 4 cifras de su cuenta myAudi. Solo hace falta para cerrar y abrir el coche desde Gladys: si no, déjelo vacío. |
| Intervalo de actualización (s) | number | No | Frecuencia de lectura de cada coche en la nube de Audi, en segundos (de 5 minutos a 1 hora). Audi limita las llamadas diarias: 15 minutos es un ritmo seguro. |
| Registros detallados (depuración) | boolean | No | Registra cada llamada a la nube de Audi. Actívelo para entender un problema y desactívelo después: es muy prolijo. Contraseñas, tokens y el S-PIN nunca se registran. |
Cómo instalar Audi Connect en Gladys
- En Gladys, abre Integraciones: Audi Connect 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-audiconnect:0.0.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/prohand/gladys-audiconnect.
Audi Connect 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
Audi Connect 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