justdr00py/chirpstack-gateway-os-mntd-blackspot

This is a setup guide for running ChirpStack Gateway OS on the MNTD RAK v2 gateway, also known as the Blackspot. ChirpStack is open-source software for managing LoRaWAN networks. LoRaWAN is a wireless protocol designed for IoT devices (sensors, trackers, and similar hardware) that need to send small amounts of data over long distances on very little power. The MNTD Blackspot is a consumer gateway (hardware that connects IoT devices to the internet) based on a Raspberry Pi 4 with a RAK2287 radio module inside. The guide exists because the standard ChirpStack setup process does not work on this specific gateway without a few manual changes. The default configuration expects the concentrator reset pin to be on GPIO 17, but the MNTD hardware wires it to GPIO 25 instead. If this is not changed, the gateway fails to read its own ID and the radio does not start. Additionally, the Wi-Fi on the Raspberry Pi 4 inside the aluminum enclosure needs explicit regulatory country code and power settings to reliably connect to a router, which the standard setup also does not handle. The guide walks through four steps: configuring the radio chipset type and disabling the GPS module (which causes boot loops if left enabled without a GPS antenna), overriding the reset pin in a config file via SSH, adjusting Wi-Fi settings in the web interface, and restarting the concentrator and MQTT forwarder services. It includes a verification command to confirm the gateway ID is being read correctly, and a troubleshooting table covering the four most common failure modes. The repository is documentation only. There is no code to install or run beyond editing configuration files and restarting system services.