CAPÍTULO 05

Instalar y validar la radio EU868

Concentratord, MQTT Forwarder, perfil del HAT, EUI y primera prueba de recepción.

ResultadoRadio inicializada, EUI estable y estadísticas publicadas con prefijo eu868.Tiempo orientativo45–90 min

Componentes del gateway

Componente	Responsabilidad
ChirpStack Concentratord SX1302	Inicializar el concentrador, aplicar canales EU868 y exponer eventos/comandos locales
ChirpStack MQTT Forwarder	Publicar eventos del gateway y recibir comandos desde el broker
systemd	Arrancar ambos servicios automáticamente y reiniciarlos ante fallos

Instala los paquetes o binarios indicados por la documentación mantenida para el modelo exacto. No existe una configuración universal para todos los HAT: el modelo, SPI, reset, reloj y radio auxiliar deben coincidir.

Configuración de gatewaysChirpStack oficial Repositorio ConcentratordCódigo y versiones Repositorio MQTT ForwarderCódigo y versiones

Configurar el perfil correcto

Región: EU868.
Modelo: identificador exacto soportado por Concentratord.
Dispositivo SPI: normalmente /dev/spidev0.0, solo si así lo documenta el HAT.
GPIO de reset y power-enable: los del HAT exacto.
Ganancia de antena: valor real del conjunto antena/cable, no un valor inventado.
Canales: plan EU868 compatible con la región configurada en ChirpStack.

Generar las plantillas instaladas

chirpstack-concentratord-sx1302 configfile | less
chirpstack-mqtt-forwarder configfile | less

Configurar MQTT Forwarder

Fragmento orientativo de chirpstack-mqtt-forwarder.toml

[mqtt]
topic_prefix="eu868"
server="tcp://127.0.0.1:1883"
username=""
password=""

[backend]
enabled="concentratord"

[backend.concentratord]
event_url="ipc:///tmp/concentratord_event"
command_url="ipc:///tmp/concentratord_command"

Para una plataforma remota, sustituye el broker local por ssl://<servidor>:8883 y utiliza credenciales o certificados exclusivos del gateway. Nunca publiques un broker sin autenticación.

Validar servicios, EUI y tráfico

Estado y registros

sudo systemctl status chirpstack-concentratord-sx1302 --no-pager
sudo systemctl status chirpstack-mqtt-forwarder --no-pager
sudo journalctl -u chirpstack-concentratord-sx1302 -n 80 --no-pager
sudo journalctl -u chirpstack-mqtt-forwarder -n 80 --no-pager

Observar estadísticas MQTT localmente

mosquitto_sub -h 127.0.0.1 -t 'eu868/gateway/+/event/stats' -v -C 1 -W 90

El registro identifica SX1302/SX1303 sin errores continuos de SPI o reset.
La EUI aparece y se mantiene idéntica después de reiniciar.
MQTT Forwarder conecta al broker y publica estadísticas.
Un nodo autorizado a corta distancia produce una trama real.