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
Integraciones
Autor
Miquel Romera Luis
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 dispositivo | Qué se hace a través de la IOT Box |
|---|---|
| Cerraduras electrónicas | Grabar 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?
¿No has encontrado lo que buscabas?
Abrir ticket de soporteVer también
Artículos relacionados
Dar de alta una Raspberry Pi: identificador y tokens de conexión
Instalar Astro HMS en el móvil, la tableta o el ordenador (app desde el navegador)
Instalar el módulo de fichaje en modo quiosco (PWA)
Instalar el quiosco de recepción del PMS en una tablet o móvil
Instalar la aplicación POS en el dispositivo (PWA)
Instalar Mis habitaciones en el móvil o la tableta
¿Necesitas ayuda?
¿No encuentras lo que buscas?
Explora todos los procesos o contacta con soporte para recibir ayuda personalizada.