Ir al contenido

Caso de uso

Crear y configurar el IOTBox (Raspberry PI)

Cómo dar de alta la IOT Box (Raspberry Pi) en Astro HMS, qué dispositivos del hotel se conectan a través de ella y sus limitaciones.

Módulos

IoT IoT

Integraciones

IoT Box
M

Autor

Miquel Romera Luis

Actualizado 14/11/2026
Versión 18.8
5 min de lectura

Permitir la vinculación de hardware sin servicio web nativo con el servidor cloud de Astro HMS mediante una IOT Box (Raspberry Pi). Esto facilita la comunicación directa entre dispositivos físicos y el ecosistema digital del hotel.

IoT > Dispositivos > Nuevo

¿Qué permite esta integración?

La IOT Box es el puente entre Astro HMS, que está en la nube, y los aparatos que hay en la red del hotel. La Raspberry abre por su cuenta la conexión con el servidor de Astro HMS, de modo que Astro HMS nunca tiene que entrar en la red del hotel: le envía la orden a la Raspberry y ella habla con el aparato. A través de la IOT Box se conectan:

Tipo de dispositivoQué se hace a través de la IOT Box
Cerraduras electrónicasGrabar las llaves de la habitación desde la reserva.
Lectores de documentos (ARH, Gesvi, Quickin, ICAR, Delta Id y el servidor DltId instalado en el hotel)Leer el documento del huésped y rellenar su ficha de check-in.
Tabletas de firma (Wacom)Capturar la firma del huésped.
Datáfonos y cajones de efectivo (TPV PC implantado, Ecopaynet, Cashlogy, Glory)Enviar los cobros al terminal y recibir el resultado.
Terminales de fichaje (Suprema, Kimaldi, Anviz)Traer los fichajes de los empleados y, según el fabricante, darlos de alta en el terminal.
Centralitas (Elastix con el módulo de hotel y Grandstream UCM)Abrir y cerrar el teléfono de la habitación y programar despertadores.

Cada uno de esos dispositivos se configura en su propio menú de Interfaces (o en el terminal de pago) y allí, en la pestaña caja de IoT, se elige esta IOT Box.

Conceptos clave

  • IOT Box: dispositivo físico (Raspberry Pi) que actúa como puente de conexión entre el hardware local y el servidor en la nube.
  • Hardware sin Webservice: periféricos que no disponen de una interfaz de comunicación por red propia y requieren un mediador.
  • Device ID: identificador que genera la propia Raspberry a partir de su MAC, con el formato blackbox- seguido de 12 caracteres. Se consulta en el portal de configuración de la Raspberry (http://<ip-de-la-raspberry>:5001).

Configuraciones previas

La Raspberry debe estar arrancada y con sus tokens de conexión dados de alta. Ese proceso se explica en la guía «Dar de alta una Raspberry Pi: identificador y tokens de conexión».

Paso a paso

1º Acceder al área de dispositivos

Dentro del módulo de IoT, navegar hasta Dispositivos para visualizar el listado actual de hardware vinculado.

2º Iniciar la creación del nuevo dispositivo

Pulsar sobre el botón «Nuevo» para abrir el formulario de configuración de la nueva IOT Box.

3º Cumplimentar la información técnica

Completar los campos para asegurar la correcta identificación y conectividad del dispositivo:

  • Nombre: debe ser exactamente el Device ID que muestra el portal de la Raspberry (blackbox-…). Cópialo de allí, no lo escribas a mano: si no coincide carácter a carácter, las órdenes nunca llegan a la Raspberry.
  • Sistema de comunicación: campo obligatorio; elige el sistema de comunicación configurado para las Raspberry.
  • Marca: la marca hotelera (establecimiento) a la que pertenece el dispositivo. No es el fabricante del equipo.
  • Compañía: seleccionar la empresa a la que pertenece el dispositivo.
  • IP: dirección de red local de la IOT Box. Es un dato de referencia (por ejemplo, para abrir su portal de configuración); las órdenes no se envían a esta IP, sino a través del servidor de Astro HMS usando el Nombre.
  • Icono IOT: seleccionar la opción «Raspberry PI» para la representación visual del hardware.

4º Guardar y validar la conexión

Guarda el registro. Para comprobar que la IOT Box está conectada, usa el monitor de conectividad IoT (guía «Usar el monitor de conectividad IOT»).

Importante: El Device ID tiene que ser idéntico en el Nombre del dispositivo, en el alta de los tokens y en el portal de la Raspberry. Si no coincide, no aparece ningún error: simplemente las órdenes no llegan.

Limitaciones

  • Necesita conexión a internet. Si la Raspberry está apagada o sin internet, ningún dispositivo que dependa de ella funciona (no se graban llaves, no se leen documentos, no llegan fichajes…).
  • Misma red que los aparatos. La Raspberry tiene que llegar por la red del hotel a cada aparato; si están en redes separadas, las órdenes no llegan.
  • Algunos aparatos necesitan además un ordenador con Windows. El datáfono TPV PC implantado, la tableta de firma Wacom, los lectores ICAR y Delta Id, el cajón Cashlogy y el terminal de fichaje Anviz dependen de un programa del fabricante instalado en un PC y necesitan el agente HMS IoT Windows Client instalado y en marcha en ese ordenador; la Raspberry habla con el agente y el agente con el aparato.
  • No hay ningún aviso si el Nombre no coincide con el Device ID: las órdenes simplemente no llegan.

Resultado esperado

Al finalizar estos pasos, la IOT Box aparecerá en el listado de dispositivos y Astro HMS podrá enviar datos entre nuestro servidor y el hardware conectado a ella.

Valoración

¿Te ha resultado útil este documento?

271 visitas

¿No has encontrado lo que buscabas?

Abrir ticket de soporte

Ver también

Artículos relacionados

Configurar los textos legales que firma el huésped en el Modo Quiosco, Pre Check-in y Self Check-in

Cómo dar de alta los textos legales (protección de datos, comunicaciones comerciales y otros) que acepta el huésped en el quiosco, el pre check-in y el self check-in, y comprobar que salen.

Normativas y calidad Configuración Astro HMS

Dar de alta una Raspberry Pi: identificador y tokens de conexión

Cómo dejar operativa una Raspberry Pi (IoT Box) recién instalada: anotar su identificador, pedir los tokens, pegar la clave en el dispositivo y darlo de alta en Astro HMS.

Configuración hardware

Instalar Astro HMS en el móvil, la tableta o el ordenador (app desde el navegador)

Cómo instalar Astro HMS como app desde el navegador en Android con Chrome, en iPhone o iPad con Safari y en el ordenador con Chrome o Edge, cómo quitarla y qué hacer si algo falla.

Configuración Astro HMS Configuración hardware

Instalar el módulo de fichaje en modo quiosco (PWA)

Explica cómo copiar la dirección del modo de quiosco de Asistencias y crear con ella un acceso directo tipo app (PWA) en la tablet o el PC de fichaje.

Configuración Astro HMS Configuración hardware

Instalar el quiosco de recepción del PMS en una tablet o móvil

Explica cómo crear el quiosco de recepción y su acceso directo en una tablet o móvil.

Configuración Astro HMS Configuración hardware

Instalar la aplicación POS en el dispositivo (PWA)

Cómo instalar el Punto de Venta como aplicación (PWA) en el terminal de caja para abrirlo desde el escritorio a pantalla completa, sin pasar por el navegador.

Configuración Astro HMS Configuración hardware

Instalar Mis habitaciones en el móvil o la tableta

Cómo dejar Mis habitaciones como un icono en el móvil o la tableta de pisos con el botón Instalar aplicación (o desde el menú del navegador), qué rol necesita el usuario y cómo se comporta la sesión.

Configuración Astro HMS Configuración hardware

¿Necesitas ayuda?

¿No encuentras lo que buscas?

Explora todos los procesos o contacta con soporte para recibir ayuda personalizada.