The D-Star Repeater.

Go to file

Andy Taylor 6dc8097d20 Add optional MQTT support, Display-Driver compatibility, and documentation MQTT telemetry (build with make MQTT=1) --------------------------------------- Add optional MQTT publishing to DStarRepeater, following the same conventions as MMDVMHost: CMQTTConnection wrapping libmosquitto, topic-prefix convention ({name}/topic), log-level filtering, PID-based client IDs, and matching config key names. All MQTT code is guarded by #if defined(MQTT) — without the flag, the binary is unchanged. Three topics are published: {name}/log Timestamped log messages filtered by severity {name}/status JSON repeater state snapshot, once per second {name}/json Display-Driver-compatible events at state transitions Display-Driver compatibility ---------------------------- Publish event-driven JSON on the "json" topic in the exact format that Display-Driver expects, enabling OLED/TFT display output with no changes to Display-Driver. Events: D-Star start (RF/net with callsign fields), end, lost (watchdog), idle, and BER. Hooks added at every state transition point in all four thread variants (TRXThread, RXThread, TXThread, TXRXThread). Shutdown safety --------------- Add mosquitto_loop_stop() before mosquitto_destroy() in close() to prevent use-after-free from the background network thread. Add Wait() after kill() in OnExit() so the repeater thread has fully exited before tearing down MQTT. Both issues also exist in MMDVMHost. Config parser bug fix --------------------- The config file parser called GetNextLine() inside comment and no-equals handlers before continuing, but the for-loop increment already advances — silently skipping the line after every comment or blank line. Remove the redundant calls and add an empty-line guard. Comments and blank lines now work correctly in config files. Documentation and config ------------------------ Add MQTT.md with build instructions, config keys, topic structure, JSON examples, and Display-Driver compatibility details. Add CONFIGURATION.md as a full reference guide for every config setting. Update README.md with gateway links (ircDDBGateway, DStarGateway) and MQTT build instructions. Rename and update the example config with corrected defaults, missing icomPort, and MQTT settings.		5 months ago
Arduino/RepeaterControl	Initial commit.	8 years ago
Common	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago
DStarRepeater	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago
DStarRepeaterConfig	Improve Linux build	6 years ago
Data	Improve Linux build	6 years ago
GUICommon	Improve Linux build	6 years ago
LinuxUSB	Initial commit.	8 years ago
WindowsUSB	Initial commit.	8 years ago
debian	Initial commit.	8 years ago
linux	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago
.gitignore	Makefile Tweaks	8 years ago
BUILD.txt	Add the new web page for the VC2017 redist downloads.	8 years ago
CHANGES.txt	Update the text files for this version.	8 years ago
CONFIGURATION.md	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago
COPYING.txt	Initial commit.	8 years ago
DStarRepeater.sln	Initial commit.	8 years ago
DStarRepeater32.nsi	Update to the latest version.	8 years ago
DStarRepeater64.nsi	Update to the latest version.	8 years ago
MQTT.md	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago
Makefile	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago
MakefileGUI	Improve Linux build	6 years ago
MakefileGUIPi	Makefile fixes	8 years ago
MakefilePi	Makefile fixes	8 years ago
README.md	Add optional MQTT support, Display-Driver compatibility, and documentation	5 months ago

README.md

DStarRepeater

DStarRepeater is the D-Star repeater controller for homebrew repeater hardware. It links into ircDDBGateway or the newer DStarGateway to provide access to D-Star networking facilities such as callsign routing, reflector linking, and ircDDB.

Supported Hardware

DVAP
DV-Mega (D-Star only)
GMSK Modems
Soundcard repeaters (including UDRC)
MMDVM (D-Star only)
DV-RPTR V1, V2, and V3
Icom Terminal and Access Point modes

Building

Builds on 32-bit and 64-bit Linux as well as on Windows using Visual Studio 2017 (x86 and x64).

Standard Build

make

With MQTT Support

DStarRepeater can optionally publish live telemetry to an MQTT broker, including log messages, repeater status, and Display-Driver-compatible events for driving OLED/TFT displays.

sudo apt-get install libmosquitto-dev
make MQTT=1

MQTT support is entirely opt-in. When built without the MQTT=1 flag, the binary is identical to the tree before MQTT was added — no MQTT code is compiled in and no additional libraries are required.

See MQTT.md for full configuration details, topic structure, JSON examples, and Display-Driver compatibility information.

Licence

This software is licenced under the GPL v2.