DMR tier III trunking controller GUI for MMDVM

This program is a proof-of-concept implementation of a DMR tier III trunked radio controller with a graphical user interface. Only a subset of ETSI TS 102 361-4 is implemented currently, see list below. This software is licenced under the GPL v3 and is primarily intended for amateur radio and educational use. This software is intended to work together with DMRGateway, MMDVMHost-SDR, MMDVM-SDR and QRadioLink in order to create a DMR tier III radio site.

DMR tier III services partly or completely implemented

1. Registration and deregistration service, mass registration request
2. Talkgroup voice call service
3. Private voice call service: OACSU (to and from network subscribers), FOACSU (local subscribers only)
4. Broadcast talkgroup call service (local subscribers only)
5. UDT short data message service: private (local subscribers only), talkgroup (local and network), ISO-8 and UTF-16 SMS
6. Voice call late entry announcements
7. System frequencies and local time broadcasts - logical/physical channel map definitions
8. Network voice services
9. Talkgroup attachment on registration (up to 6 additional talkgroups)
10. Dynamic Group Numbering Assignment service - TS initiated or requested by MS via SMS to system service
11. Radio presence check
12. Private voice / UDT short data call diversion service
13. MS authentication prior to registration or service access (optional)
14. Preferential call notification (MS call priority choice)
15. Group call priorities, priority interrupt of network-originated group calls
16. Adjacent sites announcements
17. Fixed and flexible hunt channel plans
18. Absolute channel grants (only usable when MS is set to hunt in flexible channel plan, apparently due to radio limitations)
19. Status delivery service - group and private
20. Status polling service
21. NMEA location polling via UDT, MS-requested location polling of another MS via SMS
22. Individual packet data call service (single item, confirmed data, long SMS, 8 bit ISO text unit-to-unit, unit-to-group), dedicated channel
23. Signalling using single control block (CSBK) or multiple control blocks (MBC)
24. Supplimentary user data transfer service (additional data sent as part of the primary call setup)
25. Dial digit upload for PABX call service (SIP signalling to PBX is not implemented yet)
26. TS-received RF signal report service via SMS or via private call to defined system id
27. Automatic subscription of talkgroups from core network upon local attachment or DGNA request
28. Site presence of MS sent to core network to facilitate private call and SMS routing across IP network
29. Site-local talkgroup definitions
30. Static talkgroup subscription to core network
31. Gateway definitions and dynamic call routing towards gateways based on talkgroup prefix (7th most significant digit)
32. Voice with location embedded (GPS coordinates are displayed on logical channel information but not sent anywhere else)
33. Extended talker-alias parsing (ISO-7, ISO-8, UTF-16), display on logical channel information element

DMR tier III services NOT implemented

1. MS dynamic power control
2. MS pre-emption control
3. All-MS call service
4. Packet data call service using unconfirmed data, raw data, defined data, group call, multi-item data
5. IP bearer services
6. Ambient listening service
7. MS stun, kill and revive
8. Full duplex voice call service
9. PABX/PSTN call service via SIP trunk
10. Call diversion service to PSTN/PABX/Gateway

Radio compatibility matrix

DMR Tier III compatible radios tested and confirmed to work fully or partially with this software:

1. Hytera HP785: registration, talkgroup attachment, group voice calls, private voice calls (OACSU and FOACSU), short text messages, call divert, voice with location, DGNA, status transfer service, authentication, hunting in fixed or flexible channel plans, NMEA location polling via UDT, long SMS on dedicated channel, all basic functions compatibility
2. Hytera HM785: registration, talkgroup attachment, group voice calls, private voice calls (OACSU and FOACSU), short text messages, call divert, voice with location, DGNA, status transfer service, authentication, hunting in fixed or flexible channel plans, NMEA location polling via UDT, long SMS on dedicated channel, all basic functions compatibility
3. Hytera PD755: registration, talkgroup attachment, group voice calls, private voice calls (OACSU only, radio does not support FOACSU), short text messages, the rest of features are not 100% confirmed to work yet
4. Hytera PD785: registration, talkgroup attachment, group voice calls, private voice calls (OACSU and FOACSU), short text messages, call divert, voice with location, DGNA, status transfer service, authentication, hunting in fixed or flexible channel plans, NMEA location polling via UDT
5. Hytera PD685G: registration, talkgroup attachment, group voice calls, private voice calls (OACSU and FOACSU), short text messages, call divert, voice with location, DGNA, status transfer service, authentication, hunting in fixed or flexible channel plans, NMEA location polling via UDT
6. Motorola SL4000e: only fixed channel plan hunt mode, Open Radio or Open System mode in RadioManager CapMax system settings, otherwise no registration possible, talkgroup and private voice calls work, short text messages partly work, everything else does not at this moment, regardless of settings. Also, one timing parameter needs to be adjusted in RadioManager, otherwise in about 30 minutes radio deregisters from dmrtc.
7. Motorola DP4801e: same as Motorola SL4000e

Known issues

1. Private calls and private messages do not work when MS registration is disabled (due to missing site-presence information)
2. Site to site handover during RX and TX does not work (seems to be manufacturer-specific so out-of-scope for this software)
3. MS power control and transmit interrupt (partly implemented but there are clarity issues in the DMR standard surrounding these)
4. RSSI indicated values are not always accurate and may have large errors at times
5. UDT short data polling other than NMEA location does not work
6. Status polling from TS does not work (not supported by radios)
7. Talkgroup call priorities are not respected for local calls, only for incoming network calls
8. Absolute channel grants do not work when the MS is set to hunt with fixed channel plan (possibly radio issues)
9. TSCCAS support is incomplete / buggy
10. ISO-7 formatted SMS text is not parsed adequately

Requirements

• Qt >= 5.14 with GUI, network and widgets support (but not Qt6 yet)
• libconfig
• liblog4cpp
• libuuid
• Installing build dependencies on Debian Trixie:

$ sudo apt-get install liblog4cpp5v5 libconfig++11 libconfig++-dev uuid-dev libuuid1 qt5-qmake qtbase5-dev libqt5core5t64 libqt5gui5t64 libqt5network5t64

Building the software

• Clone the Github repository into a directory of your choice
• Change directory to where you have cloned or unzipped the code
• Run qmake to generate the Makefile
• Run make (with the optional -j flag)

$ git clone https://codeberg.org/qradiolink/dmrtc
$ cd dmrtc/
$ git checkout master
$ mkdir -p build
$ cd build/
$ qmake ..
$ make

Running the controller

• To run it with the GUI interface, simply execute drmtc.

$ ./dmrtc

• To run it in console, without the GUI interface, start it with the "-h" flag:

$ ./dmrtc -h

• The configuration file is located at $HOME/.config/dmrtc/dmrtc.cfg (see dmrtc.cfg.example)
• The list of DMR ids must be created at $HOME/.config/dmrtc/DMRIds.dat (CSV file with id, callsign and name, format by radioid.net and named user.csv in the Downloads area )
• The log file is written at $HOME/.config/dmrtc/dmrtc.log

Documentation

A complete HTML version of the MMDVM DMR trunking documentation can be found here

The specification for the new IP network communication protocol (Homebrew DMR Trunking Protocol) can now be found in the docs/ directory

Copyright and License

• The program is released under the GNU General Public License version 3. Please see the COPYRIGHT and AUTHORS files for details.
• This program uses code (with modifications) from MMDVMHost copyright by Jonathan Naylor G4KLX and others, licensed under GPLv2, see the MMDVM directory and source files for details and license
• Graphical resources are licensed under LGPLv3 (icons from KDE Oxygen theme copyright KDE Foundation)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.