GD6 Guía de configuración: ThinkLink, ChirpStack y TTN

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:

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.

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

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":

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:

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

Consola web inaccesible

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)

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

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

Enlaces relacionados

• Repositorio de código abierto GD6: github.com/ManThink/gd6-open
• Especificaciones y guía de usuario de GD61x: think-link.net/docs/zh/Device/LoRaWANGateway/gd61x-user-guide
• Guía de configuración de GD6 (gwTool6): think-link.net/docs/zh/Device/LoRaWANGateway/gd6-configuration-guide
• Conexión a ChirpStack mediante Basic Station: think-link.net/docs/zh/Device/LoRaWANGateway/gwtool-chirpstack-basic-station
• Conexión a TTN mediante Basic Station: think-link.net/docs/zh/Device/LoRaWANGateway/gwtool-ttn-basic-station
• Artículo 1: ManThink lanza la puerta de enlace LoRaWAN de código abierto GD6: solución interior ESP32-S3 + SX1302
• Artículo 2: Dentro de la GD6: decisiones de diseño de hardware detrás de la puerta de enlace ESP32-S3 + SX1302
• Artículo 3: Primeros pasos con la puerta de enlace de código abierto GD6: del clon al firmware personalizado
• Plataforma ThinkLink: www.think-link.net
• Sitio web oficial de ManThink: www.manthink.cn

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