Documentación de MuPiBox MuPiBox NG

Panel de Home Assistant

YAML listo para una página bonita de la MuPiBox en Home Assistant – reproductor, batería, imagen de la pantalla, avisos y mantenimiento – y ejemplos de automatizaciones.

Con la integración de Home Assistant tienes el reproductor, la batería, el wifi y el mantenimiento de la MuPiBox en Home Assistant. Esta página te da una tarjeta de panel lista para pegar y dos automatizaciones como plantilla. Solo se usan tarjetas incluidas en Home Assistant; no hace falta ningún frontend adicional de HACS.

Antes: comprueba los nombres de las entidades

La integración nombra las entidades según el dispositivo. En los ejemplos la caja se llama MuPiBox, por eso todos los ID empiezan por mupibox_ (p. ej. media_player.mupibox_player). Si tu caja se llama de otra forma, por ejemplo «Habitación», el ID será media_player.habitacion_player.

Para comprobar los ID, abre Ajustes → Dispositivos y servicios → MuPiBox → dispositivo y pulsa en las entidades. En algunas entidades (botones, salida de audio, aviso) el nombre depende del idioma en que funcionaba Home Assistant al configurarla; consulta esos ID allí.

Entidad (nombre en inglés)ID de ejemplo
Playermedia_player.mupibox_player
Batterysensor.mupibox_battery
Charging / External powerbinary_sensor.mupibox_charging, binary_sensor.mupibox_external_power
Wi-Fi signalsensor.mupibox_wi_fi_signal
CPU temperature / CPU usage / Storage usagesensor.mupibox_cpu_temperature, sensor.mupibox_cpu_usage, sensor.mupibox_storage_usage
Version / Active providersensor.mupibox_version, sensor.mupibox_active_provider
Display (imagen de la pantalla táctil)camera.mupibox_display
Audio outputselect.mupibox_audio_output
Restart box / Power off boxbutton.mupibox_restart_box, button.mupibox_power_off_box
Speak announcementnotify.mupibox_speak_announcement

Los valores de batería y carga solo existen con MuPiHAT. La entidad de aviso y los botones de reiniciar y apagar solo aparecen si al emparejar permitiste TTS y mensajes en pantalla o Reiniciar y apagar.

La tarjeta del panel

  1. Pulsa el lápiz (Editar panel) arriba a la derecha.
  2. Añadir tarjeta → elige Manual abajo del todo.
  3. Borra el contenido, pega el YAML de abajo, ajusta los ID si hace falta y pulsa Guardar.
type: vertical-stack
cards:
  - type: media-control
    entity: media_player.mupibox_player
  - type: grid
    columns: 3
    square: false
    cards:
      - type: gauge
        entity: sensor.mupibox_battery
        name: Batería
        min: 0
        max: 100
        severity:
          green: 50
          yellow: 20
          red: 0
      - type: tile
        entity: binary_sensor.mupibox_charging
        name: Cargando
      - type: tile
        entity: sensor.mupibox_wi_fi_signal
        name: Wifi
  - type: picture-entity
    entity: camera.mupibox_display
    name: Pantalla de la caja
    camera_view: auto
    show_state: false
  - type: entities
    title: Aviso y salida
    entities:
      - entity: select.mupibox_audio_output
        name: Salida de audio
      - type: button
        name: Aviso de buenas noches
        icon: mdi:weather-night
        action_name: Enviar
        tap_action:
          action: perform-action
          perform_action: notify.send_message
          target:
            entity_id: notify.mupibox_speak_announcement
          data:
            message: ¡Buenas noches! Enseguida bajará la música.
  - type: entities
    title: Mantenimiento
    state_color: true
    entities:
      - entity: sensor.mupibox_version
        name: Version
      - entity: sensor.mupibox_cpu_temperature
        name: Temperatura de la CPU
      - entity: sensor.mupibox_storage_usage
        name: Almacenamiento usado
      - entity: button.mupibox_restart_box
        name: Reiniciar la caja
      - entity: button.mupibox_power_off_box
        name: Apagar la caja

Automatización: aviso de buenas noches

Cada tarde a las 19:30 un aviso y después se baja el volumen. volume_level se refiere al volumen máximo de la caja: 0.2 es el 20 % de él. Pégalo en Ajustes → Automatizaciones y escenas → Crear automatización → ⋮ → Editar en YAML:

alias: MuPiBox – Buenas noches
triggers:
  - trigger: time
    at: "19:30:00"
actions:
  - action: notify.send_message
    target:
      entity_id: notify.mupibox_speak_announcement
    data:
      message: ¡Buenas noches! En diez minutos, a dormir.
  - delay: "00:00:10"
  - action: media_player.volume_set
    target:
      entity_id: media_player.mupibox_player
    data:
      volume_level: 0.2
mode: single

Automatización: aviso de batería baja

Envía un mensaje al móvil cuando la batería baja del 15 % y la caja no se está cargando. Sustituye notify.mobile_app_tu_movil por tu propio servicio de notificaciones.

alias: MuPiBox – Batería baja
triggers:
  - trigger: numeric_state
    entity_id: sensor.mupibox_battery
    below: 15
conditions:
  - condition: state
    entity_id: binary_sensor.mupibox_charging
    state: "off"
actions:
  - action: notify.mobile_app_tu_movil
    data:
      message: A la MuPiBox solo le queda {{ states('sensor.mupibox_battery') }} % de batería.
mode: single
© 2026 MuPiBox