Integración domótica MySkoda, gratuita y de código abierto

Coches Škoda conectados (app MySkoda): batería, carga, clima, cierre, kilometraje.

• Publicado por guim31
• Dispositivos
• Versión 1.0.1
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Siga sus coches Škoda en Gladys: batería, autonomía y carga de los coches eléctricos e híbridos enchufables, climatización, cierre, puertas y ventanillas, combustible, kilometraje y, si lo desea, la posición. La integración usa la nube de la aplicación MySkoda, como la aplicación oficial y la integración de Home Assistant myskoda.

Sin relación con Škoda Auto. Desarrollada sin el hardware: sus comentarios son bienvenidos.

Requisitos

• Gladys 5.1.0 o posterior.
• Un coche añadido a una cuenta MySkoda (Škoda ID), visible en la aplicación oficial, con sus servicios conectados activos: Enyaq, Elroq, Citigo e iV, híbridos enchufables Superb / Octavia / Kodiaq iV, y los coches de gasolina, diésel y GNC conectados (Octavia, Superb, Kodiaq, Karoq, Kamiq…), cada uno con lo que la nube da para él.
• El correo electrónico y la contraseña de la cuenta, y su S-PIN si quiere bloquear el coche.

Configuración

En Gladys, Integraciones → MySkoda → Configuración:

Campo	Qué introducir
Correo electrónico	La dirección de su Škoda ID, con la que inicia sesión en la aplicación.
Contraseña	Su contraseña. Solo sirve para iniciar sesión: la sesión abierta la guarda después la integración.
S-PIN	Opcional: el S-PIN de 4 cifras de la aplicación, solo para bloquear (o desbloquear).
Idioma de los nombres de funciones	Francés por defecto. Gladys conserva un nombre una vez creado el dispositivo.
Intervalo de actualización	Frecuencia de lectura de la nube: cada 15, 30 (por defecto), 60 o 120 minutos.
Compartir la posición GPS	Desactivado por defecto. Activado: se lee y muestra la posición de aparcamiento de cada coche.
Permitir el desbloqueo	Desactivado por defecto. Activado: la acción de escena «Desbloquear un Škoda» funciona (vea Bloqueo y desbloqueo).

Guarde y luego pulse Probar la conexión: muestra los coches de la cuenta, o dice en rojo qué falla. Comprobar el S-PIN verifica el S-PIN guardado (uno incorrecto cuenta como intento fallido). Abra después la pestaña Descubrimiento y añada sus coches.

Dispositivos

Un dispositivo por coche, con el nombre del modelo y la matrícula (p. ej. «Škoda Enyaq (AB-123-CD)»). Cada coche recibe las funciones que ofrecen sus servicios:

Función	Significado
Nivel de batería	Estado de carga, en % (coches eléctricos e híbridos enchufables).
Autonomía eléctrica	Autonomía con la batería, en km.
Estado de la carga	Cargando, enchufado, límite alcanzado, desenchufado (estados de punto de carga de Gladys).
Enchufado	1 cuando hay un cable conectado.
Carga	1 mientras el coche carga. Un comando: encendido inicia la carga, apagado la detiene.
Potencia de carga	En kW, durante la carga (coches que la indican).
Tiempo de carga restante	En minutos, durante la carga (coches que lo indican).
Límite de carga	El nivel en el que se detiene la carga, de 50 a 100 % de diez en diez. Un comando (Enyaq, Elroq, híbridos recientes).
Climatización	1 mientras el coche calienta o enfría el habitáculo. Un comando: encendido la inicia a la temperatura de climatización, apagado la detiene.
Temperatura de climatización	La temperatura de la climatización, de 15,5 a 30 °C por medios grados. Un comando, guardado en el coche.
Temperatura exterior	En °C (coches que la indican).
Bloqueado	1 cuando el coche está bloqueado. Solo lectura: el bloqueo es una acción de escena.
Puerta abierta / Maletero abierto	1 cuando una puerta, o el maletero, está abierto.
Ventanilla o techo abierto	1 cuando una ventanilla o el techo solar está abierto.
Nivel / autonomía de combustible	En % y km (coches de gasolina, diésel, GNC e híbridos enchufables).
Kilometraje	En km.
Posición GPS	«latitud, longitud», solo si la posición GPS está activada.

Un comando aceptado por la nube no es un comando ejecutado por el coche. El coche lo ejecuta por su cuenta, a menudo uno o dos minutos después. La integración mantiene el valor pedido hasta diez minutos, vuelve a leer el coche dos y seis minutos después del comando, y luego publica lo que el coche indica. Si el coche nunca lo indica, vuelve el estado real y el widget muestra «No confirmada por el coche».

Widget

Mi Škoda (elija el vehículo en sus ajustes): batería y autonomía (combustible y autonomía para un coche de gasolina o diésel), una lista de estado (carga, límite de carga, climatización, puertas, última actualización) y hasta cuatro botones, rotulados con lo que hace una pulsación: encender el clima (pide confirmación) o apagarlo, iniciar o parar la carga, bloquear (cuando el coche está desbloqueado y hay un S-PIN guardado; pide confirmación), actualizar. Un comando muestra «Solicitado, esperando al coche» hasta que el coche lo indica. Nunca hay un botón de desbloqueo.

Disparador de escena

Carga terminada: el coche ha dejado de cargar y sigue enchufado (límite de carga alcanzado, o detenida por el coche o el cargador). Filtro opcional: el vehículo. Variables: nivel de batería (%) y autonomía eléctrica (km). Una carga detenida desde Gladys no lo dispara.

Enchufado, desenchufado, batería por debajo de un umbral: use las funciones del dispositivo en un disparador «estado de un dispositivo», ya lo hacen.

Acciones de escena

• Actualizar un Škoda: lee ahora el estado que el coche envió a la nube (sin despertarlo), y pasa el nivel de batería, la autonomía eléctrica, enchufado, cargando y bloqueado a las acciones siguientes.
• Bloquear un Škoda: pide al coche que se bloquee, con el S-PIN de la configuración.
• Desbloquear un Škoda: solo si «Permitir el desbloqueo» está activado; pide al coche que se desbloquee, con el S-PIN.

La carga, el límite de carga, la climatización y su temperatura son funciones del dispositivo: una escena las ajusta con «Controlar un dispositivo».

Ejemplos de escenas

• Coche caliente a las 7:30 entre semana: a las 7:15, de lunes a viernes, poner la Temperatura de climatización a 21 y la Climatización en encendido.
• Cargar en horas valle: a las 22:00, si Enchufado vale 1, poner la Carga en encendido; a las 6:00, en apagado. O poner el Límite de carga a 100 % antes de un viaje largo y volver a 80 % después.
• Bloqueado cada noche: a las 23:00, «Actualizar un Škoda», y si la salida bloqueado es falsa, «Bloquear un Škoda» y enviar un mensaje «El coche estaba abierto: bloqueo solicitado».
• Carga terminada: enviar un mensaje «El Enyaq está cargado ({{triggerEvent.data.battery_level}} %)».

Bloqueo y desbloqueo

El bloqueo y el desbloqueo necesitan el S-PIN de la aplicación MySkoda, introducido en la configuración. Nunca son interruptores de un dispositivo: un interruptor del panel o un asistente de voz no puede abrir el coche.

• Bloquear: la acción de escena «Bloquear un Škoda» y el botón del widget (pide confirmación).
• Desbloquear: desactivado por defecto. Active «Permitir el desbloqueo» solo si una escena lo necesita; entonces funciona la acción de escena «Desbloquear un Škoda». Una escena que desbloquea el coche puede dejarlo abierto: piénselo bien.
• Un S-PIN incorrecto cuenta como intento fallido en la cuenta, y la nube bloquea el S-PIN tras unos cuantos. Una vez rechazado, la integración no lo vuelve a enviar hasta que guarde la configuración con el correcto.

Actualización y cuota de la nube

La integración lee la nube con su propio temporizador (no depende del sondeo de Gladys). Cada lectura devuelve el estado que el coche envió por última vez a la nube: nunca despierta el coche (el despertar de la aplicación, limitado a unos pocos al día y duro para la batería de 12 V, nunca se usa). Un coche envía su estado al apagarlo, mientras carga y tras un comando; aparcado y dormido, puede pasar horas sin noticias, sea cual sea el intervalo elegido.

Una lectura cuesta una llamada por servicio que ofrece el coche (carga, climatización, estado, autonomía: 1 a 4), más el kilometraje una vez por hora y la posición si está activada. El grupo VW no publica ninguna cuota pero responde «demasiadas solicitudes» a los clientes que llaman demasiado: la integración se mantiene por debajo de 30 llamadas por hora y por cuenta (Home Assistant lee cada 30 minutos por defecto), espaciando las lecturas más allá del intervalo elegido si hay varios coches. Tras un «demasiadas solicitudes», las lecturas se pausan 30 minutos. Un valor que no cambia se envía de nuevo a Gladys cada 12 horas, para que nunca parezca caducado.

Privacidad y datos guardados

• La contraseña y el S-PIN se quedan en la configuración de Gladys; la contraseña solo sirve para iniciar sesión, el S-PIN solo para bloquear o desbloquear.
• La sesión (tokens de acceso y de renovación de la nube MySkoda) se guarda en el volumen /data de la integración, en un archivo que solo ella puede leer. Nada de ello, ni el correo, el S-PIN, el VIN, la matrícula o la posición, aparece nunca en los registros.
• La posición GPS está desactivada por defecto; desactivada, nunca se lee.
• La integración solo habla con el servicio de inicio de sesión del grupo VW (identity.vwgroup.io) y con la nube MySkoda (mysmob.api.connect.skoda-auto.cz).

Solución de problemas

• «Škoda no conoce este correo electrónico»: el servicio de identidad no tiene ningún Škoda ID para él (proponía crear uno). Introduzca la dirección con la que inicia sesión en la app MySkoda y guarde; la contraseña no se envía para una dirección desconocida.
• «Su Škoda ID aún no está activado»: confírmelo con el correo que le envió Škoda y vuelva a guardar.
• «La cuenta ha rechazado el inicio de sesión»: revise el correo y la contraseña (los de la aplicación) y guarde. La integración no lo vuelve a intentar sola, para no bloquear la cuenta.
• «Su cuenta debe aceptar primero nuevas condiciones»: abra la aplicación MySkoda, acéptelas y guarde de nuevo la configuración.
• «El servicio de inicio de sesión rechaza la conexión por ahora»: demasiados intentos; espere unas horas y guarde de nuevo.
• Falta un coche: compruebe que aparece en la aplicación oficial con la misma cuenta. Un coche cuyos servicios conectados han caducado no ofrece nada y no se muestra.
• Falta una función: el coche no la ofrece (usuario invitado, servicios del modelo), o nunca envió el valor. Un servicio que la nube rechaza en la primera lectura deja de leerse hasta el reinicio.
• «El S-PIN ha sido rechazado»: corríjalo en la configuración y guarde; «Comprobar el S-PIN» indica los intentos restantes.
• Valores antiguos: el coche no ha enviado su estado desde entonces (dormido, sin red donde está aparcado). La línea «Última actualización» del widget da la fecha del último estado.
• Más detalles: ponga LOG_LEVEL=debug en el contenedor.

Límites

• Desarrollada sin coche ni cuenta, a partir del protocolo y de las respuestas reales recogidas por skodaconnect/myskoda: sus comentarios son bienvenidos en el foro o en las issues.
• Sin eventos en directo: la aplicación MySkoda recibe los cambios por MQTT a través de Google Firebase; la integración lee la nube a intervalos regulares.
• Sin calefacción auxiliar (quemador de combustible), ni claxon ni ráfagas de luces, ni temporizadores de salida o perfiles de carga, ni estadísticas de viajes.
• Los comandos pasan por la nube de Škoda: si falla, nada funciona, y puede cambiar sin previo aviso.
• La posición se publica como texto; sin distancia al domicilio.

Créditos

El protocolo (inicio de sesión, puntos de acceso, contenidos) y los fixtures de prueba proceden de skodaconnect/myskoda (MIT), la biblioteca de la integración de Home Assistant skodaconnect/homeassistant-myskoda (MIT), cuyo comportamiento (intervalo de lectura, entidades, límites de coherencia) se ha seguido.

Parámetros de configuración

Estos son los parámetros que MySkoda te pide en su pantalla de configuración en Gladys.

Parámetro	Tipo	Obligatorio	Descripción
Antes de empezar	section	No	Esta integración inicia sesión en su cuenta MySkoda, como la aplicación oficial, y lee el estado que sus coches enviaron a la nube de Škoda (nunca los despierta). Coches eléctricos, híbridos enchufables y de gasolina o diésel conectados. Sin relación con Škoda Auto.
Correo electrónico	string	Sí	La dirección con la que inicia sesión en la app MySkoda (Škoda ID).
Contraseña	secret	Sí	Sirve para iniciar sesión una vez; después la integración guarda una sesión en su propio almacenamiento.
S-PIN	secret	No	El S-PIN de 4 cifras de la app MySkoda. Solo hace falta para bloquear (o desbloquear) el coche. Cada S-PIN incorrecto cuenta como un intento fallido.
Idioma de los nombres de funciones	select	No	Los nombres que reciben las funciones de los coches al añadirlos a Gladys.
Intervalo de actualización	select	No	Frecuencia de lectura del estado en la nube de Škoda. Nunca despierta el coche; con varios coches, el intervalo se alarga para no pasar de 30 llamadas por hora.
Compartir la posición GPS	boolean	No	Desactivado por defecto, por privacidad. Activado: la posición de aparcamiento de cada coche se convierte en una función (texto) y en un botón de mapa en el widget.
Desbloqueo a distancia	section	No	El desbloqueo desde Gladys está desactivado por defecto: una escena o un error podría dejar el coche abierto. Nunca es un interruptor, solo la acción de escena «Desbloquear un Škoda», y necesita el S-PIN.
Permitir el desbloqueo	boolean	No	Permite que funcione la acción de escena «Desbloquear un Škoda». Déjelo desactivado si ninguna escena lo necesita.

Cómo instalar MySkoda en Gladys

1. En Gladys, abre Integraciones: MySkoda aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/guim31/gladys-myskoda:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración).
3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/guim31/gladys-myskoda.

MySkoda 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

MySkoda 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 guim31, 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

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂