Modo de emparejamiento

El modo de emparejamiento añade dispositivos sin escribir el DevEUI de cada uno. Durante unos minutos, cualquier dispositivo que aún no esté registrado y se una con la AppKey compartida del perfil se añade a ese perfil. Es adecuado para lotes de sensores idénticos que el proveedor entregó con una AppKey común.

El modo de emparejamiento está desactivado por defecto y funciona por perfil. Necesita el permiso para añadir, editar y eliminar dispositivos LoRaWAN para iniciarlo y detenerlo.

Antes de empezar

• Use un perfil LoRaWAN para el lote, por ejemplo un perfil que haya creado para este tipo de sensor. El emparejamiento añade los dispositivos al perfil en el que se ejecuta.
• Configure la AppKey compartida del perfil en su pestaña LoRaWAN (32 dígitos hexadecimales) y guarde. Sin ella, la sección muestra Pairing mode needs a shared AppKey on this profile. y no ofrece nada.
• Compruebe la LoRaWAN version y la Class del perfil: los dispositivos que añade el modo de emparejamiento reciben estos valores.
• Decida sobre la aprobación con Devices added by pairing mode are ready at once (no approval). Desactivado (por defecto) significa que cada dispositivo nuevo espera a que alguien lo apruebe. Consulte Approving devices added by pairing.
• Asegúrese de que una pasarela cercana a los dispositivos esté Online y de que su plan tenga espacio para los dispositivos.

Ejecutar el modo de emparejamiento

1. Abra el perfil y su pestaña LoRaWAN. Desplácese hasta Pairing mode; su insignia indica Off.
2. En For how long, elija 5, 15 (por defecto), 30, 60 o 120 minutes.
3. Seleccione Start pairing y confirme Start pairing mode: «Durante n minutos, cualquier dispositivo que se una con la AppKey compartida de este perfil se añadirá a sus dispositivos. Inícielo solo mientras enciende sus propios dispositivos.»
4. La insignia ahora indica On: con el tiempo restante, en cuenta regresiva.
5. Encienda los dispositivos o haga que se unan.
6. Observe Devices added. La lista se vuelve a leer cada 10 segundos mientras el emparejamiento está activo.
7. Cuando estén listados todos los dispositivos, seleccione Stop. Si no, la ventana se cierra sola al terminar el tiempo.

Seleccionar de nuevo Start pairing mientras está activo desplaza el final de la ventana; los dispositivos ya encontrados permanecen en la lista.

Qué ocurre con cada dispositivo

1. El dispositivo envía una solicitud de unión. Su DevEUI no está registrado en ningún lugar de la plataforma.
2. El servidor de red prueba la AppKey compartida de cada uno de sus perfiles que esté en modo de emparejamiento. Si la comprobación de integridad de la solicitud coincide con una, el dispositivo es reconocido. El servidor de red no responde a esta primera solicitud.
3. Hermetry añade el dispositivo a ese perfil, con el nombre LoRa <DevEUI>, con codec Automatic, usando la clave compartida, la versión y la clase del perfil. Cuenta para su límite de dispositivos.
4. Los propietarios y administradores de su organización reciben una notificación: LoRaWAN device DevEUI added by pairing mode.
5. El dispositivo envía su siguiente solicitud de unión (los dispositivos reintentan por sí mismos):
   • Con aprobación requerida, la solicitud se rechaza como Waiting for approval hasta que alguien apruebe el dispositivo.
   • Con ready at once, la solicitud recibe respuesta y el dispositivo se une.

El registro de tramas muestra la primera solicitud como Being added by pairing mode.

La lista Devices added

Columna	Muestra
Name	LoRa <DevEUI> hasta que lo renombre
DevEUI	El EUI del dispositivo
Added	Cuándo lo añadió el modo de emparejamiento
Status	Waiting for approval (con un botón Approve) o Ready

La lista muestra los dispositivos de la ventana actual (o la última), del más reciente al más antiguo, hasta 200. Si está vacía: No device has been added by pairing mode yet.

Reglas y salvaguardas

• Un DevEUI que ya esté registrado, en su organización o en otra, nunca se añade por emparejamiento. El dispositivo de otra organización sigue mostrando «A device of another network».
• Un dispositivo cuya unión no coincida con una AppKey compartida de un perfil en modo de emparejamiento se rechaza como Unknown DevEUI, como siempre.
• El emparejamiento solo funciona dentro de la ventana. Una solicitud vista en la ventana pero procesada después se comprueba con el inicio y el final de la ventana.
• Cuando se alcanza su límite de dispositivos, los siguientes dispositivos se omiten.
• Un perfil sin AppKey compartida no puede iniciar el emparejamiento: Hermetry lo rechaza con Pairing mode needs a shared AppKey on the profile. (no_shared_appkey).
• El inicio y la detención se registran en el registro de auditoría (iot_lorawan.profile.pairing_started, iot_lorawan.profile.pairing_stopped); cada dispositivo añadido se registra como iot_lorawan.device.paired.

A través de la API

Solicitud	Hace
GET /tenant/<tenantId>/api/iot/lorawan/profiles/<profileId>/pairing	La ventana y los dispositivos que ha añadido
POST …/pairing con { "minutes": 15 }	Inicia o amplía la ventana (1–120 minutos)
DELETE …/pairing	La detiene de inmediato

La respuesta es { pairing: { active, until, startedAt, hasSharedAppKey, found: [...] } }.