Integración domótica Dawarich, gratuita y de código abierto
Su historial de Dawarich en Gladys: distancias, países visitados, seguimiento detenido.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Conecte Gladys a Dawarich, el historial de ubicaciones autoalojado (una alternativa a Google Timeline): siga las distancias recorridas y los países visitados, y reciba un aviso cuando su teléfono deje de enviar su posición. Todo se queda en su red local: Gladys solo lee su servidor Dawarich y no le envía nada.
Probada con un servidor Dawarich 1.16.0 real (la imagen Docker oficial) y trayectos simulados, no con un teléfono en carretera: sus comentarios son bienvenidos en el foro de Gladys. Para el seguimiento GPS en directo, vea la integración Traccar: esta trata del historial y las estadísticas.
Requisitos previos
- Gladys Assistant 5.1 o posterior.
- Un servidor Dawarich accesible desde el equipo de Gladys, en el puerto 3000 por defecto o detrás de un proxy inverso, y una aplicación de seguimiento que le envíe posiciones (aplicación Dawarich, OwnTracks, Overland…).
- La clave de API de su usuario de Dawarich: abra el menú de su cuenta → Account, allí aparece la clave.
Configuración
- Abra la pestaña Configuración de la integración.
- En Dirección de Dawarich, introduzca la dirección IP del servidor, por
ejemplo
192.168.1.50: la integración usa entonces el puerto 3000. Añada el puerto si es otro (192.168.1.50:3100). Detrás de un proxy inverso, introduzca la dirección completa (https://dawarich.example.org). - Pegue la clave de API.
- Leer Dawarich cada: 5, 15 (por defecto), 30 o 60 minutos.
- Mostrar las coordenadas de la última posición: desactivado por defecto. Activado, el dispositivo recibe una función más con la latitud y la longitud del último punto.
- Idioma de los nombres fija los nombres de las funciones (fijados al añadir el dispositivo), los nombres de los países y los textos de las escenas. Francés por defecto.
- Guarde y use Probar la conexión: muestra el número de puntos y de países visitados.
- En la pestaña Descubrir, añada el dispositivo Dawarich.
Dispositivo
Dawarich (un dispositivo para el usuario de la clave de API):
| Función | Valor |
|---|---|
| Distancia hoy | km recorridos desde medianoche, sumados a partir de puntos |
| Distancia este mes | km del mes, según las estadísticas de Dawarich |
| Distancia este año | km del año, según las estadísticas de Dawarich |
| Distancia total | km desde su primer punto |
| Países visitados | países de todos sus puntos |
| Ciudades visitadas | ciudades contadas por Dawarich (requiere geocodificación) |
| Puntos registrados | número de posiciones guardadas en Dawarich |
| Última posición recibida | fecha y hora del último punto, o «Ninguna» |
| Última posición (coordenadas) | «latitud, longitud», solo con la opción del paso 5 |
Distancias y contadores guardan su historial: un gráfico muestra los kilómetros de cada día o de cada mes.
Widget del panel
Desplazamientos: cuatro mosaicos (hoy, este mes, este año, países), la antigüedad de la última posición (verde, amarillo tras una hora, rojo tras un día) y los países de los últimos 30 días. No requiere ajustes.
Disparadores de escena
- Nuevo país visitado: llega una posición de un país nunca visitado antes
en Dawarich. Variables: País (en el idioma de la integración) y Código
del país (ISO, 3 letras, por ejemplo
ITA). Los países que ya están en Dawarich al instalar la integración, y los de un historial antiguo importado más tarde, no se anuncian. - No se reciben posiciones: ningún punto nuevo durante al menos el tiempo elegido (1, 2, 3, 6, 12, 24 o 48 horas). Puede que la aplicación de seguimiento se haya detenido o que el teléfono esté apagado o sin red. Se dispara una vez por silencio y por duración; un punto nuevo vuelve a empezar. Variable: Hora de la última posición.
Ejemplos de escenas
- Modo vacaciones: cuando se dispare «Nuevo país visitado», envíese el mensaje «¡Bienvenido a {{triggerEvent.data.country}}!» y pase la casa al modo vacaciones.
- Aplicación de seguimiento detenida: cuando se dispare «No se reciben posiciones» para 6 horas, envíe el mensaje «Dawarich no ha recibido nada desde {{triggerEvent.data.last_position}}: compruebe la aplicación de seguimiento del teléfono.»
- Balance semanal: cada domingo a las 20:00, envíe un mensaje con los valores de «Distancia este mes» y «Países visitados».
Solución de problemas
- «Dawarich rechazó la clave de API»: copie de nuevo la clave desde la página Account. Una clave cambia cuando se regenera.
- «Dawarich no responde»: compruebe la dirección y el puerto desde el equipo
de Gladys (
http://<dirección>:3000/api/v1/healthresponde{"status":"ok"}) y que Dawarich esté en marcha. - «Esta dirección no responde como Dawarich»: la dirección lleva a otro servicio o a la página de inicio de sesión de un proxy inverso.
- El mes o el año no cambian: Dawarich recalcula estas estadísticas una vez por hora, en segundo plano (Sidekiq). «Distancia hoy» la calcula la integración en cada lectura.
- Las ciudades quedan en 0: la geocodificación inversa está desactivada en Dawarich (Photon, Geoapify… en sus ajustes). Los países vienen de las fronteras y funcionan sin ella; Probar la conexión indica cuando está desactivada.
- Registros: en la pestaña Registros de la integración. Más detalles con
LOG_LEVEL=debug. Nunca se escriben en ellos coordenadas ni nombres de lugares.
Límites
- Solo lectura: la integración nunca escribe en Dawarich. No puede enviar a Dawarich las posiciones de otros dispositivos de Gladys (una integración no lee los dispositivos de las demás).
- Los kilómetros del mes, del año y el total son números enteros, tal como los da Dawarich; «Distancia hoy» se redondea a 0,1 km y descarta los saltos de GPS más rápidos que un avión.
- Los disparadores reaccionan en la lectura siguiente: con hasta el intervalo elegido de retraso.
- Un solo usuario de Dawarich por integración: el de la clave de API.
- La opción de las coordenadas muestra su posición a todos los usuarios de Gladys: déjela desactivada si no la necesita.
- Sin relación con Dawarich. Desarrollada con el servidor real, sin teléfono en carretera: sus comentarios son bienvenidos.
Parámetros de configuración
Estos son los parámetros que Dawarich te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Conectar Dawarich | section | No | Introduzca la dirección de su servidor Dawarich (puerto 3000 por defecto) y la clave de API que aparece en su página Account. La integración solo lee: distancias, países y ciudades visitados, hora de la última posición. No se envía nada a Dawarich. |
| Dirección de Dawarich | string | Sí | Dirección IP o nombre, con el puerto si no es 3000, o la dirección completa detrás de un proxy inverso. |
| Clave de API | secret | Sí | Aparece en la página Account de Dawarich (menú de su cuenta). |
| Leer Dawarich cada | select | No | Dawarich recalcula sus estadísticas mensuales y anuales una vez por hora. |
| Mostrar las coordenadas de la última posición | boolean | No | Desactivado por defecto: añade una función con la latitud y la longitud del último punto. Nunca se escriben en los registros. |
| Idioma de los nombres | select | No | Idioma de los nombres de funciones, de países y de los textos de escena. |
Cómo instalar Dawarich en Gladys
- En Gladys, abre Integraciones: Dawarich 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/guim31/gladys-dawarich: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). - 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/guim31/gladys-dawarich.
Dawarich 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
Dawarich 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