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

Sus vehículos Ford en Gladys: combustible, batería, cierre, neumáticos, posición y órdenes.

• Publicado por gboulvin
• Dispositivos
• Versión 1.0.3
• Requiere Gladys >=5.1.0
• ★ 0

Ver en GitHubTodas las integraciones

Integra sus vehículos Ford en Gladys: nivel de combustible o de batería, autonomía, kilometraje, cierre, alarma, puertas y ventanillas, presión de los neumáticos, posición y las órdenes remotas de la aplicación FordPass (bloquear, desbloquear, arranque remoto, carga).

Esta integración usa los mismos servidores que la aplicación móvil FordPass. Ford no ofrece una API pública para ello: Ford puede cambiarla en cualquier momento, y la integración puede necesitar entonces una actualización.

Requisitos

• Una cuenta FordPass con sus vehículos añadidos y activados en la aplicación FordPass (los servicios conectados deben estar activados).
• Un ordenador con un navegador de escritorio (Chrome, Edge, Firefox…) para el inicio de sesión, que se hace una sola vez.

Conectar su cuenta

Ford inicia la sesión en su propia página y luego intenta abrir la aplicación FordPass. Un navegador no puede abrir la aplicación, así que se copia la dirección final a mano. Lleva dos minutos, una sola vez.

1. En Gladys, abra la pestaña Configuración de la integración y elija la región de su cuenta FordPass. Guarde.
2. Pulse Conectar junto a Cuenta Ford. La página de inicio de sesión de Ford se abre en una pestaña nueva. No inicie sesión ahí: copie la dirección de esa página desde la barra de direcciones y cierre la pestaña.
3. Abra una pestaña nueva, abra las herramientas de desarrollo del navegador (F12, o Ctrl+Mayús+I / Cmd+Opción+I en Mac), seleccione la pestaña Red y marque Conservar registro (Firefox: ⚙ → Persistir registros). Las herramientas de desarrollo solo registran la pestaña en la que se abrieron, y el inicio de sesión pasa por varias páginas (entre ellas la del código de verificación): sin esta casilla, la lista se vacía por el camino.
4. Pegue la dirección copiada en la barra de direcciones de esta pestaña y pulse Intro. Inicie sesión con el correo y la contraseña de su cuenta FordPass y luego introduzca el código de verificación que le envía Ford (autenticación de dos factores).
5. La página parece cargar indefinidamente: es lo esperado. En la pestaña Red, la última petición aparece en rojo; su iniciador es authorize?redirect_uri=fordapp://userauthorized&… y su dirección empieza por fordapp://userauthorized/?code= (escriba code= en el filtro para encontrarla). Clic derecho → Copiar → Copiar URL. En Firefox, la dirección puede aparecer en la consola como un error («se impidió abrir»): cópiela desde ahí.
6. De vuelta en Gladys, ejecute la acción Completar el inicio de sesión y pegue la dirección. Hágalo enseguida: el código solo es válido unos minutos, y el inicio de sesión debe completarse en los 10 minutos siguientes al clic en Conectar.
7. La respuesta lista los vehículos encontrados. Abra la pestaña Descubrimiento y añádalos.

Su contraseña nunca pasa por Gladys: la integración solo recibe un código de un solo uso, cambiado por tokens guardados en la configuración de la integración. Ford mantiene la sesión durante meses; si caduca (contraseña cambiada, demasiado tiempo sin uso), la pantalla de configuración lo indica: repita los pasos anteriores.

El vehículo en Gladys

Cada vehículo es un dispositivo. Sus funciones dependen de su motorización:

Función	Gasolina / diésel / híbrido	Eléctrico / híbrido enchufable
Cuentakilómetros	✓	✓
Nivel de combustible, autonomía (combustible)	✓	✓ (solo híbrido enchufable)
Carga de la batería, autonomía eléctrica		✓
Cargando (controlable), enchufado, potencia		✓
Batería de 12 V	✓	✓
Cierre centralizado (controlable)	✓	✓
Alarma activada	✓	✓
Puerta abierta, ventanilla abierta	✓	✓
Arranque remoto (controlable)	✓	✓
Vida útil del aceite	✓	✓ (solo híbrido enchufable)
Temperatura exterior	✓	✓
Presión de cada neumático	✓	✓

Un valor que su vehículo no informa simplemente queda vacío.

La función Cierre centralizado bloquea (encendido) y desbloquea (apagado) el vehículo, Arranque remoto arranca el motor o la climatización previa (encendido) o la detiene (apagado), Cargando inicia o detiene la carga. Ford transmite una orden al coche en 10 a 60 segundos; la función muestra después el estado confirmado por el coche.

Ajustes

• Intervalo de actualización: frecuencia de lectura de cada vehículo (5 minutos por defecto, 1 minuto como mínimo). La lectura solo recupera lo que los servidores de Ford ya conocen: nunca despierta el coche ni vacía su batería. El coche envía nuevos valores por sí mismo cuando circula, se bloquea, se carga…
• Unidad de distancia y unidad de presión de neumáticos.
• Umbral de combustible / batería bajo: el nivel que activa el disparador Combustible o batería bajos (15 % por defecto).
• Idioma de los nombres de funciones: inglés, francés, alemán o español, aplicado al añadir un vehículo a Gladys.

Acciones

• Completar el inicio de sesión — véase arriba.
• Probar la conexión — lista los vehículos de la cuenta.
• Desconectar de Ford — borra los tokens guardados. Los vehículos permanecen en Gladys con su historial.

Escenas

La integración añade sus propias tarjetas al editor de escenas (Gladys 5.1 o posterior).

Disparadores:

• Combustible o batería bajos — el nivel bajó del umbral configurado. Filtre por vehículo y por energía (combustible, batería). Variables: {{triggerEvent.data.energy}}, {{triggerEvent.data.level}}.
• Alarma disparada — la alarma antirrobo se ha disparado. Variables: latitude y longitude del vehículo.
• Aviso de presión de neumáticos — el control de presión ha señalado una rueda. Variables: wheel (p. ej. rear_left), pressure.
• Carga terminada — un vehículo eléctrico o híbrido enchufable ha dejado de cargar. Variables: level, range.
• Contacto encendido o apagado — inicio o fin de trayecto. Filtre por Encendido / Apagado. Variables: state, odometer.

Las funciones del dispositivo también funcionan con el disparador estándar Un dispositivo cambia de estado (p. ej. «Cierre centralizado pasa a 0»).

Acciones:

• Enviar una orden a un vehículo Ford — bloquear, desbloquear, arranque remoto, detener el arranque remoto, iniciar o detener la carga, o actualizar los datos (esta despierta el vehículo: limitada a 24 al día). Salidas: success y status, para que las acciones siguientes comprueben que el coche obedeció.
• Leer el estado de un vehículo Ford — los últimos valores conocidos por Ford, utilizables en las acciones siguientes: odometer, fuel_level, battery_level, range, locked, doors_open, windows_open, charging, latitude, longitude.

Ejemplo: cada noche a las 22 h → leer el estado del vehículo → si locked es falso → enviar la orden «Bloquear» y una notificación.

Panel

• Vehículo Ford — elija un vehículo: energía, autonomía y kilometraje en directo, el estado del cierre, la alarma, las puertas, las ventanillas, los neumáticos y la carga, la hora de la última actualización, y botones para bloquear, desbloquear (con confirmación), actualizar y abrir la posición en un mapa.
• Vehículos Ford — todos los vehículos de la cuenta con su nivel, autonomía, cierre y un enlace al mapa.

Solución de problemas

• «Ford rechazó el inicio de sesión»: el código caducó o ya se usó. Pulse de nuevo Conectar y pegue la nueva dirección enseguida. Compruebe la región.
• «No hay ningún inicio de sesión en curso»: han pasado más de 10 minutos desde el clic en Conectar: vuelva a pulsarlo.
• Ningún vehículo encontrado: el vehículo debe estar añadido y activado en la aplicación FordPass con la misma cuenta.
• «Vehicle not authorized» en los registros: acepte de nuevo los servicios conectados en la aplicación FordPass.
• Una orden falla: el vehículo puede estar en reposo profundo (sin uso durante días, batería de 12 V baja), sin cobertura móvil, o rechazar la orden (arranque remoto con una puerta abierta, alarma…). El widget muestra «Órdenes en pausa» durante el reposo profundo.
• Los valores no cambian: el coche solo envía nuevos valores cuando se usa; pulse Actualizar en el widget para pedírselos.

Los registros de la integración (Gladys → Integraciones → FordPass) nunca contienen sus tokens ni su contraseña.

Parámetros de configuración

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

Parámetro	Tipo	Obligatorio	Descripción
Conectar su cuenta FordPass	section	No	1. Elija su región y guarde. 2. Pulse Conectar, copie la dirección de la página de Ford que se abre y ciérrela. 3. En una pestaña nueva, abra las herramientas de desarrollo (F12), pestaña Red, marque «Conservar registro» y pegue la dirección. 4. Inicie sesión con su cuenta FordPass y el código de verificación que envía Ford. 5. La página nunca termina de cargar: copie la petición en rojo que empieza por fordapp://userauthorized/?code= y péguela en la acción «Completar el inicio de sesión» de abajo. Su contraseña nunca pasa por Gladys.
Región de la cuenta FordPass	select	Sí	El país donde se creó su cuenta FordPass.
Cuenta Ford	account_link	No	Abre la página de inicio de sesión de Ford. Después ejecute «Completar el inicio de sesión».
Intervalo de actualización (s)	number	No	Frecuencia de lectura de cada vehículo, en segundos (mínimo un minuto). La lectura nunca despierta el coche.
Unidad de distancia	select	No
Unidad de presión de neumáticos	select	No
Umbral de combustible / batería bajo (%)	number	No	Por debajo de este nivel se activa el disparador «Combustible o batería bajos».
Idioma de los nombres de funciones	select	No	Se usa al añadir un vehículo a Gladys.

Cómo instalar FordPass en Gladys

1. En Gladys, abre Integraciones: FordPass 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/gboulvin/gladys-fordpass:1.0.3), 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/gboulvin/Gladys-FordPass.

FordPass 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

FordPass 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 gboulvin, 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 🙂