First 12 BlueSignal sites — 2 deployed, 10 beta slots open

WQM-1 Firmware Downloads

Current Version: v1.0.0 · February 2026 · GPL-3.0

WQM-1 Firmware

Open Source

Python firmware for the Raspberry Pi Zero 2W — all sensor drivers, the LoRaWAN stack, SQLite buffering, and systemd services. There is no custom image to flash: install stock Raspberry Pi OS Lite, then set up the firmware with a single command.

git clone https://github.com/bluesignal-xyz/wqm-1.gitGPL-3.0 · Raspberry Pi OS Lite (64-bit)
Download Source (ZIP)View on GitHub

Documentation

Getting Started GuideSensor CalibrationFirmware OverviewHardware OverviewTroubleshooting

Installation

  1. Flash Raspberry Pi OS Lite (64-bit) to a 16 GB+ microSD with Raspberry Pi Imager. In Edit Settings, set the hostname to wqm1, enable SSH, and add your WiFi credentials.
  2. Connect the WQM-1 HAT to the 40-pin GPIO header, insert the microSD, and connect a 9–24 V DC supply (2 A recommended).
  3. SSH in: ssh pi@wqm1.local
  4. Install Git, then clone and run setup:
    sudo apt-get update && sudo apt-get install -y git
    git clone https://github.com/bluesignal-xyz/wqm-1.git
    cd wqm-1 && sudo bash setup.sh
  5. Set your LoRaWAN AppKey (32 hex characters from the TTN console or ChirpStack):
    sudo nano /etc/bluesignal/config.yaml
  6. Verify the hardware: sudo bash /opt/bluesignal/scripts/diagnostics.sh
  7. Start the service and watch logs:
    sudo systemctl start bluesignal-wqm
    journalctl -u bluesignal-wqm -f

Version History

v1.0.0February 2026

Initial release — 6 sensor channels (pH, TDS, turbidity, ORP, temperature, GPS), LoRaWAN uplink via SX1262, SQLite WAL buffer with store-and-forward, relay control with threshold automation, GPS geo-tagging.

System Requirements

Raspberry Pi Zero 2W
BlueSignal WQM-1 HAT
16 GB+ microSD (Class 10 / A1)
9–24 V DC power (2 A)
LoRa antenna (915 MHz SMA)
TTN or ChirpStack account