GD6 Guía de configuración: ThinkLink, ChirpStack y TTN — ManThink
Portada del artículo técnico de ManThink

Contenido del artículo

Los tres primeros artículos cubrieron la descripción general del producto GD6, el diseño del hardware y el uso del código de código abierto. Este artículo aborda lo que más preocupa a los ingenieros de campo: llevar un GD6 desde la caja hasta un despliegue en producción.

Recorremos tres rutas principales de integración con servidores de red —la plataforma ThinkLink, ChirpStack y TTN (The Things Network)— junto con la configuración del backhaul de red, la configuración de la banda de frecuencia, el mantenimiento del sistema y la resolución de problemas comunes. Todos los pasos se basan en las versiones actuales de las Especificaciones de GD61x (v1.4) y de la Guía de configuración de gwTool6 (v1.0).


Desembalaje e instalación

Lista de verificación

Después del desembalaje, verifique los siguientes elementos:

  • Unidad de puerta de enlace GD6
  • Antena LoRa (compatible con la versión de RF de la puerta de enlace)
  • Adaptador de alimentación (si se incluye con el pedido)
  • Tarjeta SIM (solo para la configuración AG; debe estar activada para el servicio de datos)

El modelo de la puerta de enlace está impreso en la etiqueta del dispositivo. El formato es GD61{4|8}-A{N|G}-{region code}-{version code}-{1|2}. Por ejemplo, GD618-AG-AS923-N-2 significa: 800 MHz+ RF, con 4G y PoE, región AS923, versión predeterminada, concentrador SX1302.

Verifique que el código de región coincida con su área de despliegue. El código de región debe coincidir con el hardware de RF; esto es una restricción física, no un problema de configuración de software.

Instalación de la antena LoRa

Conecte la antena LoRa antes de encender. Iniciar la transmisión LoRa sin antena puede dañar el chip del concentrador.

  1. Confirme que la banda de frecuencia de la antena coincida con la versión de región de la puerta de enlace (868 / 915 / 470, etc.)
  2. Atornille la antena en el conector LoRa hasta que quede ajustada; no la apriete en exceso
  3. Las antenas Wi-Fi y 4G (configuración AG) son internas; no se necesita conexión externa

Instalación de la tarjeta SIM (solo configuración AG)

  1. Apague la puerta de enlace
  2. Inserte una tarjeta SIM activada en la ranura SIM
  3. Si la SIM tiene un PIN configurado, deberá introducir el PIN de 4–8 dígitos en la consola web más adelante

Ubicación

GD6 admite colocación sobre escritorio o montaje en pared mediante el soporte giratorio de la parte inferior. No bloquee los orificios de ventilación de la parte inferior de la carcasa.


Primer encendido y conexión

Selección de una fuente de alimentación

Elija un método; no conecte varias fuentes de alimentación simultáneamente:

Método de alimentación Especificación Puerto
Type-C 5V DC USB Type-C
Borne DC 5–24V DC 5–24V y G bornes
PoE solo configuración AG RJ45 (requiere un dispositivo PoE compatible)

No conecte alimentación a los bornes A+ y B- — estos son pines RS-485 reservados sin funcionalidad de usuario en la versión actual.

Estados del indicador LED

Después del encendido, el LED entra en un patrón de parpadeo lento (predeterminado: 1s encendido / 1s apagado), lo que indica un funcionamiento normal. La inicialización del sistema, la obtención de IP y el inicio del servicio LoRa tardan algún tiempo.

Patrón del LED Significado
Parpadeo lento (1s encendido / 1s apagado) Funcionamiento normal
Encendido fijo a los 2s → 3 parpadeos rápidos → reinicio Restablecimiento de fábrica en curso

Conexión mediante Ethernet

  1. Conecte el puerto RJ45 de la puerta de enlace a un router o switch
  2. La puerta de enlace obtiene una dirección IP mediante DHCP de forma predeterminada
  3. Busque la dirección de la puerta de enlace en la lista de concesiones DHCP del router
  4. Abra http://<gateway-address> en un navegador

Conexión mediante Wi-Fi AP

Si no hay acceso por Ethernet disponible, utilice el punto de acceso Wi-Fi predeterminado:

  1. Conéctese al punto de acceso Wi-Fi LGW-Config desde un teléfono o computadora
  2. Introduzca la contraseña del punto de acceso lgw12345678
  3. Abra http://192.168.4.1

Primer inicio de sesión

  • Contraseña de inicio de sesión web predeterminada: wifi!0804
  • Cambie la contraseña inmediatamente después del primer inicio de sesión: vaya a "Gestión de usuarios", introduzca la contraseña actual y una nueva contraseña (mínimo 8 caracteres) y guarde
  • La contraseña del punto de acceso y la contraseña de inicio de sesión web son dos contraseñas distintas; no las confunda

Lleva esta guía a tu proyecto

ManThink ofrece productos IoT para conectar dispositivos, desplegar redes y trabajar con datos. Consulta estos recursos de producto junto con las recomendaciones técnicas del artículo:

GD61 Gateway LoRaWAN para interiores · ThinkLink

Conoce los productos de ManThink y consulta tu proyecto →

Configuración del backhaul de red

GD6 admite tres enlaces de backhaul con prioridad Ethernet predeterminada y conmutación por error automática. Configuración: Consola web → página de red correspondiente.

Configuración de Ethernet

  1. Abra la página "Ethernet"
  2. Seleccione DHCP o IP estática
  3. Para IP estática, introduzca la dirección IP, la máscara de subred, la puerta de enlace predeterminada y el DNS
  4. Guarde; algunos cambios de dirección pueden requerir reconexión o reinicio

"Ethernet Power" controla la alimentación de tiempo de ejecución del controlador Ethernet interno de la puerta de enlace, no la salida PoE externa. Deshabilitar o reiniciar el puerto interrumpe temporalmente la conexión actual.

Configuración de Wi-Fi STA

La página Wi-Fi tiene tres controles:

  • Interruptor principal: apaga toda la radio Wi-Fi
  • AP (punto de acceso): modificar el SSID, la contraseña, el canal y el número máximo de conexiones del punto de acceso de configuración local
  • STA (cliente): escanear y conectar a la Wi-Fi del sitio como enlace de backhaul

Pasos de configuración de STA:

  1. Abra la página "Wi-Fi", haga clic en "Escanear" en la sección STA
  2. Seleccione la Wi-Fi de destino de la lista (solo 2.4 GHz)
  3. Introduzca la contraseña y guarde
  4. Una vez conectada, STA sirve como enlace de backhaul de respaldo

Modificar los parámetros de AP desconecta la sesión inalámbrica actual: vuelva a conectarse con el nuevo SSID o contraseña. Antes de deshabilitar la Wi-Fi, confirme que aún puede acceder a la puerta de enlace mediante otro enlace de gestión.

Configuración de 4G (solo configuración AG)

  1. Abra la página "4G / LTE"
  2. Introduzca el APN del operador (el nombre de usuario y la contraseña normalmente se dejan en blanco)
  3. Introduzca el PIN de la SIM si está configurado
  4. Mantenga la velocidad en baudios del puerto serie coherente con el módulo entregado
  5. Seleccione la prioridad de enrutamiento y guarde

El área de estado muestra el estado de la SIM, el registro en la red, el operador, la señal, la tecnología de acceso y la dirección PPP.

Enmascare el IMEI, el ICCID y otros identificadores del dispositivo antes de compartir capturas de pantalla.

Prioridad de enlaces y conmutación por error automática

Prioridad de enlaces predeterminada: Ethernet > Wi-Fi STA > 4G. Cuando el enlace principal falla, la puerta de enlace cambia automáticamente a un enlace de respaldo. Cuando el enlace principal se recupera, vuelve a él. Con los tres enlaces configurados, la puerta de enlace siempre mantiene al menos un backhaul disponible.


Conexión a la plataforma ThinkLink

ThinkLink es una plataforma IoT de ManThink. GD6 es el hardware de puerta de enlace nativo para ThinkLink, lo que hace que el proceso de conexión sea sencillo.

Registrar la puerta de enlace en ThinkLink

  1. Inicie sesión en la plataforma ThinkLink
  2. Vaya a la página de gestión de puertas de enlace y añada una nueva puerta de enlace
  3. Introduzca el EUI de la puerta de enlace (se encuentra en la página "Overview" de la consola web de GD6)
  4. Seleccione la configuración de región que coincida con el hardware de RF de la puerta de enlace

Configurar el LNS en GD6

ThinkLink admite tanto el método de acceso UDP como MQTT.

Método UDP Packet Forwarder:

  1. Abra la consola web de GD6 → "LNS Configuration"
  2. Establezca el controlador de enlace ascendente en Packet Forwarder y el protocolo en Semtech UDP
  3. Introduzca la dirección del servidor y los puertos de enlace ascendente y descendente proporcionados por ThinkLink
  4. Configure Keepalive, el informe de estado y el tiempo de espera de envío según lo requiera la plataforma
  5. Guarde y confirme el estado del servicio LoRa y la recuperación del ACK del servidor

Método MQTT Bridge:

  1. Establezca el controlador de enlace ascendente en Packet Forwarder y el protocolo en MQTT Bridge
  2. Introduzca el URI del Broker, el Client ID, el nombre de usuario y la contraseña
  3. Configure el QoS y el puerto UDP local
  4. Para TLS, cargue el certificado de CA; para TLS mutuo, cargue también el certificado de cliente y la clave privada
  5. Guarde y confirme que el estado de conexión del puente MQTT muestra conectado

Verificar la llegada de datos

  1. Compruebe el estado en línea de la puerta de enlace en la consola de ThinkLink
  2. Active un enlace ascendente desde un dispositivo final LoRaWAN registrado
  3. Confirme que los datos del enlace ascendente aparecen en la página de datos del dispositivo de ThinkLink

Conexión a ChirpStack

ChirpStack es un popular servidor de red LoRaWAN de código abierto. GD6 se conecta a ChirpStack mediante Basic Station LNS.

Requisitos previos

Antes de empezar, prepare:

  • El EUI de la puerta de enlace, la banda de frecuencia y el plan de canales
  • Una cuenta de ChirpStack con permisos para crear puertas de enlace
  • La dirección WebSocket del LNS Basic Station de ChirpStack Gateway Bridge
  • Para TLS: la CA requerida; para TLS mutuo: también el certificado de cliente y la clave privada de la puerta de enlace
  • Un enlace de gestión de la puerta de enlace que no se interrumpa por los cambios del servicio LoRaWAN

Configurar ChirpStack Gateway Bridge

  1. Habilite el basic_station backend en la configuración de ChirpStack Gateway Bridge y establezca la dirección de escucha
  2. Establezca el router_config plan de canales que coincida con el hardware y la región de la puerta de enlace
  3. Seleccione un modo de autenticación: - Sin autenticación: solo para redes de prueba aisladas - TLS de servidor: configure los certificados del servidor y proporcione la CA de firma a la puerta de enlace - TLS mutuo: configure además ca_cert para verificar los certificados de cliente de la puerta de enlace
  4. Para TLS mutuo, el Common Name (CN) del certificado de cliente debe ser el ID de gateway de 64 bits en hexadecimal (p. ej., 0102030405060708)
  5. Reinicie Gateway Bridge y confirme que el puerto de escucha WebSocket está abierto

Registrar la puerta de enlace en ChirpStack

  1. Cree una puerta de enlace en el tenant de ChirpStack
  2. Introduzca el Gateway ID/EUI que coincida con la etiqueta del dispositivo
  3. Seleccione la configuración de región que coincida con Gateway Bridge router_config y el hardware de RF de la puerta de enlace
  4. Guarde y mantenga visible la página de detalles de la puerta de enlace para la verificación

Configurar Basic Station en GD6

Cambiar a Basic Station puede reiniciar el servicio LoRa o toda la puerta de enlace. Confirme que no haya OTA, escrituras de configuración ni operaciones críticas de enlace descendente en curso antes de continuar.

  1. Inicie sesión en la consola web de GD6 y abra "LNS Configuration"
  2. Cambie el controlador de enlace ascendente a Basic Station y seleccione LNS directo
  3. Introduzca la dirección completa en tc.uri: - Sin TLS: ws://<gateway-bridge-address>:<port> - TLS: wss://<gateway-bridge-domain>:<port>
  4. Para TLS, cargue el certificado de CA que firmó el certificado del servidor
  5. Para TLS mutuo, cargue también el certificado de cliente y la clave privada del gateway — confirme que el CN del certificado coincida con el Gateway ID
  6. Rellene Authorization solo si un proxy inverso requiere un Token — no use la API Key de otra plataforma para ChirpStack
  7. Guarde, espere a que se recupere el servicio LoRa y vuelva a abrir la página para verificar la configuración actual

Verificar conexión

  1. Confirme que "Last seen" o la hora de conexión empieza a actualizarse en la página del gateway de ChirpStack
  2. Genere un uplink desde un dispositivo final LoRaWAN conocido
  3. Compruebe el estado del servicio LoRa y los registros en la consola web de GD6
  4. Confirme que el mismo uplink aparece en los eventos del gateway de ChirpStack
  5. Para TLS, revise los registros de Gateway Bridge en busca de errores de CN del certificado, validez o hora del sistema

Conexión a TTN / The Things Stack

TTN (The Things Network) y TTI (The Things Industries) usan The Things Stack, accesible mediante Basic Station con LNS directo o arranque CUPS.

Registrar el gateway en TTN Console

  1. Cree un gateway en The Things Stack Console
  2. Introduzca el gateway ID y el Gateway EUI de la etiqueta del dispositivo
  3. Seleccione el Frequency Plan que coincida con el hardware de RF del gateway
  4. Anote la Server Address del despliegue actual — <server-address> en los pasos siguientes debe usar este valor

Elija LNS o CUPS

LNS directo Arranque CUPS
Propósito Transportar datos de uplink/downlink LoRaWAN Configuración centralizada y distribución automática de credenciales LNS
Credenciales API Key LNS mantenida manualmente CUPS distribuye automáticamente las credenciales LNS, sobrescribiendo los valores locales
Recomendado para Despliegue a pequeña escala Despliegue a gran escala, gestión centralizada

Preparar credenciales LNS

  1. Cree una API Key de gateway solo con el permiso "Link as Gateway to a Gateway Server for traffic exchange"
  2. La dirección LNS usa wss://<server-address>:8887
  3. Obtenga el certificado de confianza PEM que coincida con el dominio del despliegue desde la página The Things Stack Root Certificates
  4. Formatee la API Key como una línea Authorization terminada en CRLF:
Authorization: Bearer <LNS-API-Key>\r\n

Nunca escriba API Keys reales en documentación, capturas de pantalla o tickets.

Preparar credenciales CUPS (solo modo CUPS)

  1. Cree una API Key CUPS con permisos para ver información del gateway, editar ajustes básicos y leer secretos del gateway
  2. Guarde la API Key LNS en General Settings del gateway en LoRa Basics Station LNS Authentication Key
  3. La dirección CUPS usa https://<server-address>:443
  4. Formatee la API Key CUPS como una línea terminada en CRLF cups.key:
Authorization: Bearer <CUPS-API-Key>\r\n

Configurar Basic Station en GD6

Método LNS directo:

  1. Abra "LNS Configuration" y seleccione Basic Station direct
  2. Introduzca wss://<server-address>:8887 en tc.uri
  3. Cargue el LNS Trust PEM
  4. Cargue o pegue el contenido completo lns.key en el campo Authorization/Key
  5. Guarde, espere a que se recupere el servicio y vuelva a leer la configuración

Método de arranque CUPS:

  1. Seleccione Basic Station CUPS
  2. Introduzca https://<server-address>:443 en cups.uri
  3. Cargue el CUPS Trust PEM y cups.key
  4. Guarde y espere a que CUPS distribuya los parámetros LNS
  5. No sobrescriba los valores distribuidos con ajustes LNS locales antiguos

Verificar conexión

  1. Revise los Live data del gateway en TTN Console — confirme que empiezan a aparecer eventos de conexión y uplinks
  2. Genere un uplink de un dispositivo final conocido y verifique el Gateway EUI, el plan de frecuencias y la marca de tiempo
  3. Compruebe el estado del servicio LoRa en la consola web de GD6
  4. Para CUPS, confirme que el gateway ha recibido la dirección y las credenciales LNS, y que no sigue usando la configuración antigua

Banda de frecuencia y configuración de RF

Selección de región y sub-banda

Configure en la página "Frequency & RF":

Región Sub-bandas Notas
CN470 Sub-bandas seleccionables Elija las sub-bandas aplicables según el plan regional
US902 (US915) Sub-bandas seleccionables Elija las sub-bandas aplicables según el plan regional
AU915 Sub-bandas seleccionables Elija las sub-bandas aplicables según el plan regional
AS923 AS923-1 hasta AS923-4 Seleccione la variante que coincida con la región de su despliegue
EU868 / EU433 Planes predefinidos Utilice el plan de canales preestablecido correspondiente

El plan de región debe coincidir con el front-end de RF del dispositivo y la antena LoRa. No se puede convertir una puerta de enlace de una banda de frecuencia a otra solo a través de la interfaz web.

Aplicación de configuración

  • Después de modificar los canales, haga clic en "Aplicar"
  • Reinicie el servicio LoRa si es necesario
  • Cambie el controlador de enlace ascendente (Packet Forwarder ↔ Basic Station) o reinicie todo el sistema solo cuando se le solicite explícitamente
  • Un reinicio normal tarda aproximadamente 90 segundos en restaurar el acceso

Mantenimiento del sistema

Visualización de los registros del sistema

La página "Registros del sistema" admite:

  • Visualización en tiempo real de los registros de web, red, Packet Forwarder, MQTT y módulo de comunicación
  • Filtrado por nivel (DEBUG/INFO/WARN/ERROR) o por origen
  • Pausar el desplazamiento, borrar y descargar registros

Revise los registros en busca de direcciones, EUI o identificadores de red antes de compartirlos.

Actualización de firmware (OTA A/B en la práctica)

  1. Abra la página "Actualización de firmware" y verifique la versión actual y la partición activa
  2. Seleccione un .bin firmware que coincida con el modelo de la puerta de enlace, la versión de hardware y la región de destino
  3. Espere a que se completen la carga, la verificación y la escritura
  4. Reinicie cuando se le solicite, luego inicie sesión de nuevo y verifique la versión del firmware

Notas críticas:

  • No cargue una imagen completa de Flash (-full.bin) como firmware de Web OTA — OTA escribe en la partición de respaldo, no en todo el Flash
  • No actualice la página, desconecte la red ni apague durante la actualización
  • OTA utiliza partición dual A/B: el nuevo firmware se escribe en la partición inactiva y la partición de arranque cambia después de que la verificación se supera

Restablecimiento de fábrica

Uso del botón REC:

  1. Mantenga pulsado el botón REC
  2. Después de 2 segundos, el LED se enciende de forma fija → se ejecuta el restablecimiento de fábrica → 3 parpadeos rápidos → reinicio
  3. Espere a que la puerta de enlace termine de reiniciarse

El restablecimiento de fábrica restaura:

  • Configuración de red (Ethernet / Wi-Fi / 4G)
  • Configuración del servidor LoRaWAN
  • MQTT y configuración remota
  • La contraseña de inicio de sesión se restablece a wifi!0804

El restablecimiento de fábrica no restaura:

  • EUI de la puerta de enlace (se conserva)
  • Archivos estáticos web (no se sobrescriben)

Gestión del sistema de archivos

La página "Sistema de archivos" permite gestionar archivos en /spiffs. Los archivos JSON de configuración normalmente surten efecto tras el reinicio.

Sobrescribir web/ archivos puede dejar la consola inaccesible, y el restablecimiento de fábrica no restaurará los archivos web dañados. No modifique este directorio a menos que realice un mantenimiento controlado.


Solución de problemas comunes

Sin enlace ascendente LoRa

Verifique en el siguiente orden:

Elemento a verificar Acción
Antena Confirme que la antena está conectada y que la banda de frecuencia coincide
Región/banda Confirme que el código de región coincide con el hardware de RF
EUI de la puerta de enlace Confirme que coincide con el EUI registrado en el servidor de red
Dirección/puerto del LNS Confirme que la dirección y el puerto son correctos; verifique las reglas del firewall
Enlace de backhaul Confirme que el enlace de backhaul actual está en línea (verifique la página "Overview")
Estado del servicio LoRa Verifique los errores de Packet Forwarder / Basic Station en los registros

Fallo de registro de 4G (configuración AG)

Elemento a verificar Acción
Tarjeta SIM Confirme que la SIM está insertada y activada para el servicio de datos
PIN Confirme que el PIN introducido en la consola web es correcto
APN Confirme que el APN coincide con el operador
Señal Verifique la intensidad de la señal en el área de estado; ajuste la posición de instalación si es necesario
Bandas del módulo Confirme que las bandas admitidas por el módulo coinciden con el operador

Consola web inaccesible

Elemento a verificar Acción
Misma subred Confirme que el terminal y la puerta de enlace están en la misma subred
Dirección DHCP Busque la dirección de la puerta de enlace en la lista de concesiones DHCP del router
Modo AP Conectar a LGW-Config punto de acceso y acceder 192.168.4.1
Todos los enlaces de administración no disponibles Realizar un restablecimiento de fábrica

Fallo de arranque tras OTA

  • Esperar a que se complete el reinicio automático
  • Si sigue sin ser accesible, realizar una recuperación controlada mediante AP Wi-Fi o puerto serie
  • No realizar ciclos de encendido repetidos — el mecanismo de particiones A/B volverá a la partición anterior en el siguiente arranque

Fallo de conexión Wi-Fi STA

  • Volver a escanear SSID
  • Comprobar que la contraseña es correcta
  • Confirmar que el Wi-Fi de destino es 2.4 GHz (los puntos de acceso solo 5 GHz no son compatibles)
  • Comprobar la cobertura Wi-Fi en el sitio

Fallo de handshake TLS (ChirpStack / TTN)

Elemento a comprobar Acción
Hora de la puerta de enlace Confirmar que la puerta de enlace ha sincronizado la hora mediante SNTP
Dominio del certificado del servidor Confirmar que el dominio en tc.uri / cups.uri coincide con el certificado
Cadena de CA Confirmar que el certificado de CA cargado está completo
Validez del certificado Confirmar que el certificado del servidor no ha caducado
CN de TLS mutuo Confirmar que el CN del certificado de cliente coincide con el Gateway ID

Fallo de autenticación 401 (TTN)

  • Comprobar que los permisos de la API Key son correctos (LNS Key y CUPS Key no son intercambiables)
  • Confirmar que la línea Authorization está completa y termina en CRLF
  • Confirmar que la API Key no se introdujo por error en el campo de clave privada del cliente

Referencia rápida de despliegue

Paso Acción Tiempo
Instalar antena Atornillar la antena LoRa 1 min
Instalar SIM (AG) Insertar la tarjeta SIM 1 min
Encender Type-C / DC / PoE Inmediato
Conectar a la puerta de enlace Ethernet o AP Wi-Fi 1 min
Primer inicio de sesión Introducir wifi!0804, cambiar la contraseña 1 min
Configurar el backhaul Ethernet / Wi-Fi STA / 4G 3 min
Configurar LNS UDP / MQTT / Basic Station 3 min
Configurar banda Seleccionar región y sub-banda 1 min
Verificar conexión Provocar el enlace ascendente del dispositivo final, confirmar la llegada de datos 2 min

Desde el desembalaje hasta el despliegue en producción, el flujo normal tarda aproximadamente 15 minutos.


Enlaces relacionados


ManThink — Haciendo el desarrollo de IoT más eficiente.