WQM-1 Downloads
Firmware v2.4.0 · GPL-3.0
Product & Installer Manual
Revision in progressThe previous public manual has been retired while the board description and warranty terms are corrected. Contact BlueSignal for the current installation packet before commissioning a WQM-1.
WQM-1 Firmware
Open SourcePython 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)
Installation
- 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. - Connect the WQM-1 board to the 40-pin GPIO header, insert the microSD, and connect a 24 V DC supply (2 A minimum).
- SSH in:
ssh pi@wqm1.local - Install Git, then clone and run setup:
sudo apt-get update && sudo apt-get install -y gitgit clone https://github.com/bluesignal-xyz/wqm-1.gitcd wqm-1 && sudo bash setup.sh - Set your LoRaWAN AppKey (32 hex characters from the TTN console or ChirpStack):
sudo nano /etc/bluesignal/config.yaml - Verify the hardware:
sudo bash /opt/bluesignal/scripts/diagnostics.sh - Start the service and watch logs:
sudo systemctl start bluesignal-wqmjournalctl -u bluesignal-wqm -f
Version History
v1.0.0February 2026
Initial release — four base channels (pH, TDS, turbidity, temperature) plus GPS; ORP via optional RS485 probe. LoRaWAN uplink via SX1262, SQLite WAL buffer with store-and-forward, threshold automation on the four relay outputs, GPS geo-tagging.
System Requirements
Raspberry Pi Zero 2W
BlueSignal WQM-1 HAT
16 GB+ microSD (Class 10 / A1)
24 V DC power (2 A minimum)
LoRa antenna (915 MHz SMA)
TTN or ChirpStack account