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

Cómo dejar operativa una Raspberry Pi (IOT Box) recién instalada en el hotel para que Astro HMS pueda enviarle órdenes a los periféricos que tiene conectados (cerraduras, datáfonos, lectores de documentos, impresoras de tickets…). Esta página cubre la parte de seguridad y enlace: el identificador del dispositivo y los tokens. La creación de la ficha del dispositivo se detalla en «Creación y configuración de IOTBox (Raspberry PI)».

Pantalla de configuración del dispositivo (navegador, en la misma red del hotel) e IoT > Dispositivos en Astro HMS.

Cuándo aplica

Cuando se instala una Raspberry Pi nueva en el hotel, cuando se sustituye una que ya había, o cuando un periférico deja de responder después de un cambio de red o de equipo.

Conviene revisarlo con cuidado por un motivo: si el identificador no está escrito exactamente igual en el dispositivo y en Astro HMS, las órdenes no llegan al periférico y no aparece ningún error en pantalla. Simplemente el datáfono o la cerradura no reaccionan, como si no pasara nada.

Pasos

1º Anotar el identificador del dispositivo

Desde un ordenador o móvil conectado a la misma red del hotel, abrir en el navegador la pantalla de configuración de la Raspberry (la dirección la facilita Astro; suele ser la IP local del equipo seguida de :5001).

Arriba se muestran dos datos que hay que anotar:

• Identificador del dispositivo (aparece como Device ID): el nombre único de esa Raspberry.
• IP actual: la dirección del equipo en la red del hotel.

2º Pedir los tokens a Astro

Los tokens son las claves de acceso del dispositivo y los genera Astro: no se crean desde el hotel. Hay que avisar a Astro indicando el hotel, el identificador del dispositivo del paso anterior y su IP local.

Astro devuelve la clave del dispositivo (empieza por GW_) y deja preparada la parte del servidor. No hace falta hacer nada más con la clave que pegarla en el paso siguiente. Por seguridad, no compartir esa clave por canales inseguros.

3º Pegar la clave en el dispositivo

En la misma pantalla de configuración de la Raspberry, entrar en la pestaña Token WS, pegar en el campo Gateway Token la clave que empieza por GW_ y guardar. El dispositivo se reinicia solo y se conecta al servidor de Astro.

4º Dar de alta el dispositivo en Astro HMS

En Astro HMS ir a IoT > Dispositivos > Nuevo y completar la ficha:

• Nombre: escribir el identificador del dispositivo tal cual, carácter a carácter. Este nombre es lo que usa Astro HMS para saber a qué Raspberry mandar cada orden: si no coincide con el del dispositivo, el periférico no responde.
• IP: la IP local de la Raspberry anotada en el paso 1.
• Compañía e Icono (elegir Raspberry) como en el alta habitual de una IOT Box.

Importante: la IP de la Raspberry debe ser fija o estar reservada en el router. Si el router le cambia la dirección, se pierde la conexión con los periféricos.

Resultado esperado

El dispositivo aparece activo en el listado de IoT > Dispositivos y los periféricos conectados a esa Raspberry responden desde Astro HMS. Una prueba sencilla (un cobro de prueba en el datáfono o abrir una cerradura) confirma que el enlace funciona.