Integración domótica MEATER, gratuita y de código abierto
Los termómetros inalámbricos MEATER en Gladys: temperaturas, tiempo restante, cocción.
Publicado por guim31
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
Siga sus termómetros inalámbricos MEATER en Gladys: temperaturas interna y ambiente, temperatura objetivo, tiempo restante y estado de la cocción, y escenas que se inician en el momento justo de la cocción.
Sin afiliación con Apption Labs / MEATER. MEATER es una marca de Apption Labs. Desarrollada sin el hardware: sus comentarios son bienvenidos, en el foro de Gladys o en las issues.
Presentación
La integración lee sus sondas con la API oficial de MEATER Cloud, con la cuenta de la aplicación MEATER. Cada sonda se convierte en un dispositivo de Gladys, con sus temperaturas y su cocción. Tres activadores de escena marcan los momentos de una cocción (casi lista, retirar del fuego, reposo terminado), y un widget del panel muestra una cocción de un vistazo.
Todo es de solo lectura: Gladys nunca inicia, modifica ni detiene una cocción. La cocción se prepara en la aplicación MEATER, como siempre.
Requisitos
- Gladys 5.1.0 o posterior, con acceso a Internet.
- Una sonda MEATER: MEATER, MEATER+, MEATER 2 Plus, MEATER Pro, MEATER Pro XL, o un MEATER Block.
- Una cuenta MEATER Cloud, con la sesión iniciada en la aplicación MEATER.
- Durante la cocción, la aplicación MEATER (teléfono o tableta) o el Block debe seguir conectado a la sonda (Bluetooth) y a Internet: MEATER Cloud solo conoce lo que le transmiten la aplicación o el Block.
Configuración
En Gladys, abra Integraciones, luego MEATER, pestaña Configuración:
| Campo | Qué introducir |
|---|---|
| Correo electrónico | La dirección de correo electrónico de su cuenta MEATER Cloud. |
| Contraseña | Su contraseña. |
| Idioma | Idioma de los nombres de las funciones, de los estados de cocción y de los nombres de las piezas que envía MEATER Cloud (francés por defecto). |
| Actualización durante una cocción | Cada 15 s, 30 s (recomendado) o 60 s durante una cocción. Cada minuto en los demás casos. |
Guarde y haga clic en Probar la conexión: el mensaje indica cuántas sondas ve MEATER Cloud en este momento.
Después, añada las sondas:
- Inicie una cocción en la aplicación MEATER (una sonda solo aparece en MEATER Cloud durante una cocción).
- En la pestaña Descubrir, haga clic en el botón de búsqueda y luego en Añadir a Gladys en cada sonda.
Una sonda vista una vez permanece en la pestaña Descubrir, incluso entre dos cocciones.
Dispositivos
Un dispositivo por sonda, llamado «Sonda MEATER» seguido de los 8 primeros caracteres de su identificador (cámbiele el nombre en Gladys). Todas las funciones son de solo lectura.
| Función | Contenido |
|---|---|
| Temperatura interna | Temperatura en la punta de la sonda, dentro de la carne (°C). |
| Temperatura ambiente | Temperatura alrededor de la carne, en el horno o en la parrilla (°C). |
| Temperatura objetivo | El objetivo ajustado en la aplicación para la cocción (°C). |
| Temperatura máxima alcanzada | La temperatura interna más alta alcanzada durante la cocción (°C). |
| Tiempo restante | El tiempo restante estimado por MEATER (minutos). Conserva su último valor mientras MEATER sigue estimando. |
| Tiempo transcurrido | Tiempo desde el inicio de la cocción (minutos). |
| Estado de la cocción | Sin cocción, Sin iniciar, Preparada, Cocinando, Retirar del fuego, En reposo, Lista, Un poco cruda, Un poco pasada, ¡Demasiado hecha!. |
| Cocción | El nombre de la pieza, o el nombre dado a la cocción en la aplicación. |
| Cocción en curso | 1 desde el inicio de la cocción hasta el final del reposo, 0 en los demás casos. |
| Sonda conectada | 1 mientras MEATER Cloud ve la sonda, 0 en los demás casos. |
Cuando una sonda deja de verse (cocción terminada, sonda de vuelta en su cargador, teléfono fuera de alcance), «Sonda conectada» pasa a 0 enseguida y se conservan las últimas lecturas. Tras 30 minutos sin noticias, la cocción se considera terminada: «Cocción en curso» vuelve a 0 y «Estado de la cocción» a «Sin cocción».
Widget del panel
Cocción MEATER muestra una sonda: el nombre de la cocción, las temperaturas interna, objetivo y ambiente (en directo), el tiempo restante, el estado de la cocción, el tiempo transcurrido y si la sonda está conectada.
En sus ajustes, elija una sonda o déjelo vacío: el widget muestra entonces la sonda que está cocinando.
Activadores de escena
En una escena, Añadir activador y elija uno de los activadores MEATER. Cada uno se activa una vez por cocción, aunque Gladys se reinicie a mitad de ella.
| Activador | Cuándo | Filtros | Información transmitida a la escena |
|---|---|---|---|
| Cocción casi lista | El tiempo restante estimado por MEATER baja de 5, 10, 15 o 30 minutos, con la carne en el fuego | Sonda (opcional), umbral (obligatorio) | Cocción, tiempo restante, umbral, temperaturas interna y objetivo |
| Retirar del fuego | MEATER indica retirar la carne del fuego y dejarla reposar | Sonda (opcional) | Cocción, temperaturas interna y objetivo |
| Reposo terminado | El reposo ha terminado y MEATER da su veredicto | Sonda, resultado (ambos opcionales) | Cocción, resultado (Lista, Un poco cruda…), temperaturas interna y objetivo |
Los textos transmitidos (estado de la cocción, resultado) siguen el idioma de la configuración.
Acción
Probar la conexión (pestaña Configuración) inicia sesión en MEATER Cloud e indica cuántas sondas ve en este momento, o qué falla (contraseña rechazada, servicio inaccesible, demasiadas solicitudes). Tras una contraseña rechazada, también es la forma de volver a intentarlo sin guardar la configuración.
Ejemplos de escenas
Las palabras entre corchetes son información del activador, insertada en el texto con el selector de variables del editor de escenas.
- Poner la mesa: activador «Cocción casi lista» con el umbral «10 minutos», acción «Enviar mensaje»: «[Cocción] estará lista en 10 minutos, hora de poner la mesa.»
- Fuera del fuego: activador «Retirar del fuego», acciones «Hacer parpadear las luces» de la cocina y «Hablar en un altavoz»: «Retire [Cocción] del fuego, está a [Temperatura interna] °C.»
- A la mesa: activador «Reposo terminado» con el resultado «Lista», acción «Enviar mensaje» a toda la familia: «¡A la mesa!»
- Parrilla demasiado caliente: activador «Cambio de estado del dispositivo» en la «Temperatura ambiente» de la sonda, por encima de 300 °C: un mensaje para revisar la parrilla.
Actualización y cuotas
MEATER Cloud permite 60 solicitudes por minuto como máximo, y recomienda 2. La integración lee la cuenta:
- al ritmo elegido en la configuración mientras una cocción está preparada o en curso (cada 30 s por defecto);
- cada minuto en los demás casos, como aconseja la documentación de la API;
- nunca dos veces en menos de 2 segundos;
- tras un fallo, al cabo de 1, 2, 4… minutos, hasta 10 minutos (5 minutos como mínimo cuando MEATER Cloud pide reducir el ritmo).
Una solicitud responde por todas las sondas de la cuenta. La integración solo envía a Gladys los valores que han cambiado (y cada valor al menos cada 6 horas, para que ninguno parezca antiguo), y se actualiza por sí misma: no depende del planificador de Gladys.
Lo que se guarda en el volumen de datos de la integración: el token de MEATER Cloud (no caduca) con una huella de la cuenta, y la lista de las sondas vistas con la memoria de su cocción en curso. Ni la dirección de correo electrónico ni la contraseña se escriben ahí; la contraseña permanece en la configuración de Gladys.
Solución de problemas
- «MEATER Cloud ha rechazado la dirección de correo electrónico o la contraseña»: utilice la dirección y la contraseña de la aplicación MEATER y guarde de nuevo la configuración. La integración no vuelve a intentarlo por sí sola, para no bloquear la cuenta.
- Ninguna sonda en la pestaña Descubrir: una sonda solo aparece durante una cocción, mientras la aplicación MEATER o el Block están conectados a ella y a Internet. Inicie una cocción, haga clic en Probar la conexión y vuelva a buscar.
- Los valores ya no cambian: el teléfono con la aplicación MEATER está fuera del alcance Bluetooth, en reposo o sin Internet. «Sonda conectada» indica si MEATER Cloud sigue viendo la sonda.
- «MEATER Cloud pide reducir el ritmo»: otro programa lee la misma cuenta con demasiada frecuencia. Elija una actualización más lenta durante una cocción.
- Más detalles: los registros de la integración (pestaña Supervisión). La
variable de entorno
LOG_LEVEL=debugmuestra cada actualización.
Limitaciones
- Solo nube: Gladys no se comunica con la sonda por Bluetooth. Los datos llegan con el retraso de la aplicación MEATER, de MEATER Cloud y del ritmo de actualización (30 s por defecto).
- La API de MEATER Cloud está en beta: MEATER puede modificarla.
- La API da un solo nombre por cocción (la pieza, o el nombre que usted escribió): no hay un nombre de receta aparte.
- El tiempo restante es la estimación de MEATER; se desconoce al inicio de la cocción.
- Las temperaturas llegan en grados Celsius.
- Solo lectura: ni ajuste de la cocción ni alarma desde Gladys.
- Desarrollada sin el hardware ni una cuenta: el comportamiento se escribió a partir de la documentación oficial de la API y de la integración de Home Assistant. Sus comentarios son bienvenidos.
Parámetros de configuración
Estos son los parámetros que MEATER te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Cuenta MEATER Cloud | section | No | Las sondas se leen con la API oficial de MEATER Cloud, con la cuenta de la aplicación MEATER. En la aplicación, inicie sesión primero en MEATER Cloud. Una sonda solo aparece durante una cocción, mientras la aplicación MEATER o el Block están conectados a ella. Solo lectura: Gladys nunca modifica una cocción. |
| Correo electrónico | string | Sí | La dirección de correo electrónico de su cuenta MEATER Cloud. |
| Contraseña | secret | Sí | |
| Idioma | select | No | Idioma de los nombres de las funciones, de los estados de cocción y de los nombres de las piezas que envía MEATER Cloud. |
| Actualización durante una cocción | select | No | Con qué frecuencia se lee MEATER Cloud durante una cocción. Cada minuto en los demás casos, como aconseja la documentación de MEATER. |
Cómo instalar MEATER en Gladys
- En Gladys, abre Integraciones: MEATER 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-meater: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-meater.
MEATER 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
MEATER 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