Instalace ChirpStack Concentratord
Tato část instaluje a konfiguruje ChirpStack Concentratord pro modul LoRa koncentrátoru. Hardwarová cesta se u obou variant liší — vyberte níže záložku, která odpovídá vašemu zařízení:
Připojuje se přes USB — standardní konfigurace ChirpStack Concentratord.
Připojuje se přes SPI pomocí HAT RAK2287 — jiný postup instalace.
- USB — FIBER (CM4)
- SPI, HAT RAK2287 — FIBER Lite (Pi 5)
-
Stáhněte a nainstalujte binárku ChirpStack Concentratord:
curl -sL https://artifacts.chirpstack.io/downloads/chirpstack-concentratord/chirpstack-concentratord-sx1302_4.5.3_linux_arm64.tar.gz | sudo tar -xzf - -C /usr/bin --no-same-owner chirpstack-concentratord-sx1302 -
Vytvořte konfigurační adresář se správným vlastnictvím:
sudo install -o chirpstack -g chirpstack -m 0750 -d /etc/chirpstack-concentratord -
Vytvořte konfigurační soubor se správným vlastnictvím a oprávněními:
sudo install -o chirpstack -g chirpstack -m 0640 /dev/null /etc/chirpstack-concentratord/chirpstack-concentratord.toml -
Zapište konfigurační soubor Concentratord:
cat << EOF | sudo tee /etc/chirpstack-concentratord/chirpstack-concentratord.toml > /dev/null[concentratord]log_level="INFO"log_to_syslog=falsestats_interval="30s"disable_crc_filter=false[concentratord.api]event_bind="ipc:///tmp/concentratord_event"command_bind="ipc:///tmp/concentratord_command"[gateway]antenna_gain=0lorawan_public=trueregion="EU868"model="rak_5146"model_flags=["USB"]time_fallback_enabled=truegateway_id=""[gateway.concentrator]multi_sf_channels=[868100000,868300000,868500000,867100000,867300000,867500000,867700000,867900000,][gateway.concentrator.lora_std]frequency=868300000bandwidth=250000spreading_factor=7[gateway.concentrator.fsk]frequency=868800000bandwidth=125000datarate=50000[gateway.location]latitude=0.0longitude=0.0altitude=0EOF -
Vytvořte systemd service soubor pro Concentratord:
cat << EOF | sudo tee /etc/systemd/system/chirpstack-concentratord.service > /dev/null[Unit]Description=ChirpStack ConcentratordDocumentation=https://www.chirpstack.io/Wants=network-online.targetAfter=network-online.target[Service]User=chirpstackGroup=chirpstackExecStart=/usr/bin/chirpstack-concentratord-sx1302 -c /etc/chirpstack-concentratord/chirpstack-concentratord.tomlRestart=on-failure[Install]WantedBy=multi-user.targetEOF -
Přidejte uživatele
chirpstackdo skupinydialoutpro přístup k sériovému portu:sudo usermod -aG dialout chirpstack -
Znovu načtěte systemd démona, aby rozpoznal novou službu:
sudo systemctl daemon-reload -
Zapněte a spusťte službu ChirpStack Concentratord:
sudo systemctl enable --now chirpstack-concentratord -
Zkontrolujte logy služby, abyste ověřili úspěšné spuštění a získali gateway ID:
sudo journalctl -fu chirpstack-concentratordtipZkopírujte si Gateway ID z výstupu logu – budete ho potřebovat k registraci brány v ChirpStack.
Koncentrátor ve FIBER Lite je tatáž LoRaWAN koncentrátorová karta RAK5146, ale nasazená na Pi HAT RAK2287 připojený přes SPI — jde tedy o jinou hardwarovou cestu (SPI zařízení + GPIO reset pin) než u výše uvedené varianty připojené přes USB.
Nepotřebujete instalátor SX1302 HAL od RAKwireless. ChirpStack Concentratord obsahuje HAL
i profil výrobce pro tento hardware, který dodává mapování pinů (reset na lince 17 na
gpiochip0), RSSI offsety a tabulku TX zesílení.
-
Zapněte SPI a ověřte, že je HAT detekován.
dtparam=spi=onje v Raspberry Pi OS dodáván zakomentovaný:grep spi /boot/firmware/config.txt # expect: dtparam=spi=on (uncommented)ls /dev/spidev* # expect: /dev/spidev0.0 and /dev/spidev0.1Pokud je
dtparam=spi=onzakomentovaný, odkomentujte ho (nebo ho přidejte) v souboru/boot/firmware/config.txta restartujte. Pokud se poté žádné zařízení/dev/spidev*neobjeví, HAT není správně nasazen — nepokračujte, dokud nebude. -
Stáhněte a nainstalujte binárku ChirpStack Concentratord. ChirpStack nepublikuje Concentratord ve svém apt repozitáři ani jako GitHub release asset, pouze jako tarball na artifacts serveru:
curl -sL https://artifacts.chirpstack.io/downloads/chirpstack-concentratord/chirpstack-concentratord-sx1302_4.7.1_linux_arm64.tar.gz | sudo tar -xzf - -C /usr/bin --no-same-owner chirpstack-concentratord-sx1302 -
Vytvořte konfigurační adresář:
sudo mkdir -p /etc/chirpstack-concentratord -
Zapište konfigurační soubor Concentratord:
cat << EOF | sudo tee /etc/chirpstack-concentratord/chirpstack-concentratord-sx1302.toml > /dev/null[concentratord]log_level="INFO"log_to_syslog=falsestats_interval="30s"[concentratord.api]event_bind="ipc:///tmp/concentratord_event"command_bind="ipc:///tmp/concentratord_command"[gateway]antenna_gain=2lorawan_public=trueregion="EU868"model="rak_2287"model_flags=[]gateway_id=""time_fallback_enabled=true[gateway.concentrator]multi_sf_channels=[868100000,868300000,868500000,867100000,867300000,867500000,867700000,867900000,][gateway.concentrator.lora_std]frequency=868300000bandwidth=250000spreading_factor=7[gateway.concentrator.fsk]frequency=868800000bandwidth=125000datarate=50000EOFwarningKanálový plán
[gateway.concentrator]je povinný. Profil výrobce dodává pouze mapování pinů, RSSI offsety a tabulku zesílení — kanálový plán nedodává. Bez něj se každé rádio nastartuje jakoenabled: falsena frekvenci 0 a démon se natrvalo zablokuje naOpening SPI communication interfacebez jakékoli chybové zprávy, což vypadá naprosto stejně jako závada v zapojení nebo detekci, ale jde čistě o problém konfigurace.notemodel="rak_5146"zde funguje také. Oba profily používají stejný reset pin a ani jeden neřídí pin pro zapnutí napájení; liší se pouze konfigurací SX1261 používanou pro Listen Before Talk, kterou EU868 nevyužívá. -
Vytvořte systemd service soubor pro Concentratord:
cat << EOF | sudo tee /etc/systemd/system/chirpstack-concentratord.service > /dev/null[Unit]Description=ChirpStack ConcentratordDocumentation=https://www.chirpstack.io/After=network.target[Service]Type=simpleExecStart=/usr/bin/chirpstack-concentratord-sx1302 -c /etc/chirpstack-concentratord/chirpstack-concentratord-sx1302.tomlRestart=on-failureRestartSec=5Group=chirpstackUMask=0007[Install]WantedBy=multi-user.targetEOFwarningGroup=chirpstackaUMask=0007jsou zásadní. Na rozdíl od varianty s USB běží tato služba jako root, aby se dostala k SPI zařízení a GPIO reset pinu — což znamená, že ZeroMQ IPC sockety, které vytváří v/tmp, by měly ve výchozím stavuroot:roots režimem 0755. MQTT Forwarder se k nim připojuje jako neprivilegovaný uživatelchirpstacka připojení k unix socketu vyžaduje oprávnění pro zápis, takže by bylo odmítnuto. Tyto dvě řádky místo toho nastaví sockety naroot:chirpstacks režimem 0770. Obě služby budou hlásitactivev obou případech — jediným symptomem je, že do MQTT nikdy nedorazí žádné uplinky. -
Znovu načtěte systemd démona, aby rozpoznal novou službu:
sudo systemctl daemon-reload -
Zapněte a spusťte službu ChirpStack Concentratord:
sudo systemctl enable --now chirpstack-concentratord -
Zkontrolujte logy služby, abyste ověřili úspěšné spuštění a získali gateway ID:
sudo journalctl -u chirpstack-concentratord | grep 'Gateway ID'Zdravé spuštění vypadá takto. Řádky
Frame receivedse objevují samy z jakéhokoli LoRaWAN provozu v dosahu, ještě než zaregistrujete vlastní zařízení:INFO [libconcentratord::reset] Triggering sx130x resetINFO [...::concentrator] Configuring radio, radio: 0, enabled: true, center_freq: 867500000INFO [...::cmd::root] Gateway ID retrieved, gateway_id: "0016c001f13999e8"INFO [...::handler::uplink] Frame received, freq: 868100000, bw: 125000, mod: LoRa, dr: SF7tipZkopírujte si Gateway ID z výstupu logu – budete ho potřebovat k registraci brány v ChirpStack.