25 euros y una pulsera Xiaomi que puedes hackear para que hable con Home Assistant

💡 Antes de empezar Necesitas: una Mi Smart Band 5, un teléfono Android o una Raspberry Pi / mini PC con Bluetooth, y opcionalmente Home Assistant funcionando. Tiempo estimado: 30-60 minutos para los casos básicos; más si quieres montar el análisis de datos con IA local. Nivel: Necesitas perder el miedo a la terminal — no hay soldadura, pero sí instalar una app alternativa o ejecutar un script de Python.

Una pulsera de fitness que no sabe guardar un secreto

La Xiaomi Mi Smart Band 5 es de las pulseras de fitness más vendidas de los últimos años. Mide pasos, frecuencia cardíaca y sueño. Tiene pantalla AMOLED, aguanta unos 14 días con batería y cuesta menos que una cena. El problema habitual es el de siempre con el hardware barato de grandes marcas: tus datos de salud se van a los servidores de Xiaomi en cuanto sincronizas, y tú no tienes control sobre dónde acaban ni cómo se procesan.

Lo interesante para nosotros es que la Mi Band 5 comunica por Bluetooth Low Energy —BLE— usando un protocolo que la comunidad lleva años documentando. Eso significa que puedes hablar con la pulsera desde tu propio software, sin intermediarios, sin cuenta cloud y sin que Xiaomi sepa que has dado diez mil pasos.

Qué es exactamente la Mi Smart Band 5

Es una pulsera de 11,9 gramos con pantalla táctil de 1,1 pulgadas, sensor óptico de frecuencia cardíaca, acelerómetro y giroscopio. Registra 11 modos deportivos y mide el sueño dividido en fases ligera, profunda y REM. La batería oficial promete hasta 14 días, aunque en uso real con más funciones activas lo normal es quedarse por debajo.

Conecta por Bluetooth 5.0 BLE. No tiene Wi-Fi propio: depende del móvil o de otro dispositivo con Bluetooth para sincronizar. Esa dependencia del Bluetooth es precisamente lo que nos permite hablar con ella directamente desde una Raspberry Pi, un mini PC o cualquier ordenador con adaptador BLE.

Cómo lo abrimos

Hay tres caminos según lo que quieras hacer.

Gadgetbridge: el más fácil

Gadgetbridge es una aplicación de Android de código abierto que reemplaza la app oficial de Xiaomi. Sincroniza los datos de la pulsera localmente en tu móvil sin enviar nada a servidores externos. Funciona bien con la Mi Band 5, pero aquí hay un matiz importante: para este modelo no basta con instalarla y ya. Gadgetbridge documenta que primero hay que emparejar con la app del fabricante y obtener la clave o token de autenticación antes de terminar el alta en la app libre.

Sigue siendo el punto de entrada recomendado si quieres salir del cloud de Xiaomi sin montar un servidor. No requiere root ni bricolaje, pero sí asumir ese paso inicial de emparejamiento y obtención de clave. A partir de ahí, los datos quedan en local y ya puedes exportarlos para procesarlos fuera de la app oficial.

Python por Bluetooth: el más potente

La comunidad ha publicado proyectos y librerías en Python que hablan directamente con la Mi Band 5 usando el protocolo BLE documentado. Esto te permite conectar desde una Raspberry Pi o cualquier mini PC con Bluetooth y hacer cosas que la app oficial no contempla:

Leer frecuencia cardíaca en tiempo real.
Descargar actividad y algunos datos históricos bajo demanda.
Enviar notificaciones de texto y vibraciones personalizadas.
Integrar el reloj en scripts o automatizaciones propias.

Aquí conviene ser honesto: no hay un único paquete “oficial” y estable que te dé una API bonita igual en todos los repositorios. Lo habitual es apoyarte en proyectos comunitarios que piden la clave de autenticación obtenida tras el emparejamiento inicial con Mi Fit, Zepp o Zepp Life, y desde ahí leer frecuencia cardíaca, actividad o lanzar notificaciones.

Lo importante no es memorizar una librería concreta, sino entender el flujo real:

Emparejas primero con la app del fabricante.
Obtienes la clave o token de autenticación.
Usas un proyecto comunitario en Linux o Python para abrir el canal BLE.
Desde ahí ya puedes sacar datos o empujar avisos a la pulsera.

Si vas a seguir este camino, asume que el repositorio exacto y el método de autenticación pueden cambiar antes que la propia pulsera. Aquí estás comprando protocolo abierto por la comunidad, no soporte oficial de Xiaomi.

Home Assistant alrededor del Bluetooth: más útil que directo

Home Assistant —el sistema de automatización del hogar de código abierto— detecta dispositivos Bluetooth cercanos y funciona mejor cuando usas un ESP32 o un Raspberry Pi como proxy BLE. Eso sí: aquí conviene no prometer más de la cuenta. La integración oficial Xiaomi BLE de Home Assistant está pensada para dispositivos Xiaomi que emiten valores por MiBeacon, como sensores o básculas, no para la Mi Band 5 como wearable de salud.

En la práctica, la pulsera puede servir como señal BLE dentro de montajes propios, pero no como una ruta oficial y limpia de “presencia Xiaomi” en Home Assistant. Si quieres usarla para saber si estás cerca, trátalo como un experimento o como una señal secundaria combinada con otros sensores, no como el equivalente a un sensor de puerta o a una integración soportada de principio a fin.

Qué capa de IA le ponemos encima

Con los datos en local, la IA puede hacer cosas útiles en lugar de decorativas.

Análisis de sueño con Ollama. Ollama es una herramienta que permite correr modelos de lenguaje en tu propio hardware. Si exportas los datos de sueño de Gadgetbridge en CSV y los pasas a un modelo local —Llama 3, Mistral o cualquier otro de tamaño razonable—, puedes pedirle que identifique patrones: semanas con sueño fragmentado, correlación entre días con poco movimiento y noches malas, o variaciones en el tiempo hasta alcanzar sueño profundo. Todo procesado en tu máquina, sin enviar tus biométricas a ningún servidor.

Automatizaciones contextuales desde Home Assistant. Si consigues sacar la frecuencia cardíaca o el estado de actividad por tu propio script, ese dato puede convertirse en un trigger —un disparador— para automatizaciones. Si la frecuencia sube por encima de un umbral durante más de diez minutos seguidos, Home Assistant puede asumir que estás haciendo ejercicio y pausar la calefacción, cambiar la música o dejar de enviarte notificaciones. Cuando baja al rango de reposo, todo vuelve a la normalidad.

Alertas desde Home Assistant hacia la pulsera. El canal también puede ir en el otro sentido usando scripts o herramientas comunitarias. Puedes enviar vibraciones y mensajes cortos a la Mi Band 5 desde tu propia lógica. Un sensor de CO2 que dispara una alerta, un temporizador de cocina o una notificación de que la lavadora ha terminado. La pulsera vibra en tu muñeca aunque el móvil esté en silencio y boca abajo.

Lista de compra

Xiaomi Mi Smart Band 5.
Teléfono Android para el emparejamiento inicial con Gadgetbridge.
Raspberry Pi 3/4/5 o cualquier mini PC con Bluetooth integrado o adaptador BLE USB, si quieres integración con Home Assistant o lectura en tiempo real.
Home Assistant funcionando en red local, si quieres automatizaciones y detección de presencia.
Opcional: mini PC N100 o similar con Ollama instalado para el análisis de datos con IA local.

Lo que no te van a contar

La librería Python de la Mi Band 5 no tiene soporte oficial y el protocolo puede cambiar con actualizaciones de firmware. Si Xiaomi saca un firmware que modifica la autenticación, puede que el script deje de funcionar hasta que alguien lo actualice. Mantener el firmware congelado es una opción, pero entonces pierdes posibles mejoras de batería o funcionalidad.

Gadgetbridge funciona muy bien para los datos básicos, pero algunas funciones avanzadas y ciertos detalles de firmware cambian según la versión. La propia documentación del proyecto recomienda revisar el estado del modelo exacto antes de dar por hecho que todo irá igual en cada unidad o cada actualización.

La detección de presencia por BLE alrededor de una pulsera tiene un margen de error según la densidad de la casa, la cobertura y los obstáculos. No es tan fiable como un sensor de puerta para saber exactamente cuándo alguien llega, y en este caso además depende de montajes propios más que de una integración oficial cerrada.

Por último: la Mi Band 5 ya tiene unos años y Xiaomi ha sacado modelos posteriores. La 7 y la 8 tienen mejor soporte en Gadgetbridge y más sensores. Si encuentras la 5 barata de segunda mano es un punto de entrada perfecto para experimentar; si vas a comprar nueva, mira primero la compatibilidad de la 7 o la 8 en la wiki de Gadgetbridge.

Cómo empezar sin romperte la cabeza

El orden más razonable es este. Primero, empareja la pulsera con la app oficial de Xiaomi para hacer la activación inicial. Segundo, instala Gadgetbridge en Android y sigue su flujo de emparejamiento para la Mi Band 5, que pasa por conseguir la clave o token de autenticación. Tercero, revisa que los datos básicos —pasos, sueño y frecuencia cardíaca— ya están apareciendo en local antes de meterte con scripts o automatizaciones.

Si quieres ir más allá, el siguiente paso es elegir un proyecto comunitario activo para Linux o Python, probar una lectura básica de frecuencia cardíaca y solo después llevar ese dato a Home Assistant. Desde ahí, conectar el resultado vía MQTT es razonable: MQTT es el protocolo de mensajería que usan muchísimos dispositivos y automatizaciones en Home Assistant para publicar valores.

Fuentes para verificar antes de comprar

Veredicto

Para alguien que empieza: Gadgetbridge ya justifica la compra. Sacas tus datos de salud del cloud de Xiaomi sin instalar nada raro en el móvil y sin necesitar servidor.

Para alguien con Home Assistant montado: las alertas bidireccionales y los experimentos de presencia tienen gracia, pero ya entran en terreno de script y prueba-error. No lo vendería como un clic y listo.

Para alguien que ya ha montado algo similar: el script Python abre un canal de datos en tiempo real que permite automatizaciones que la app oficial ni contempla. A 25 euros, es el sensor de muñeca más barato que vas a encontrar con protocolo documentado y comunidad activa detrás.