C library for Digital Mobile Radio
dmrlib is a C library for building Digital Mobile Radio applications,
included are a couple of utilities that build on dmrlib.
These applications are for educational purposes and should be used by licensed HAM radio operators, commercial use is strictly prohibited.
The following software is required to compile dmrlib:
If you enable the mbelib proto (--with-mbelib):
To compile dmrlib, you run:
$ ./configure && make
To compile dmrlib for debugging:
$ ./configure --with-debug && make
This should result with libdmr built in the build directory.
On Debian (compatible) systems, you need the following packages:
~$ sudo apt-get install gcc git python-jinja2 libtalloc-dev
For the mbe proto:
~$ sudo apt-get install portaudio-dev
Now clone the repository and build the software:
~$ git clone --recursive https://github.com/pd0mz/dmrlib
...
~$ cd dmrlib
dmrlib$ ./configure
...
Using Homebrew, you need the following packages:
~$ brew install talloc python libpcap
...
~$ pip install Jinja2
...
For the mbe proto:
~$ brew install portaudio
See compiling on Linux on how to build dmrlib.
Tested to work with the Minimalist GNU for Windows (MinGW) compiler. You also need to get these packages:
- Git Windows installer
- Python Windows installer version 2.7.x
- Jinja2
Make sure you install the Git Bash shell when prompted in the installer.
Start the Git Bash shell, then enter:
~$ git clone --recursive https://github.com/pd0mz/dmrlib
...
~$ cd dmrlib
dmrlib$ ./configure
...
If configure can't find Python, you can run Wright (our configuration utility) manually:
~$ export PYTHONPATH=$(pwd)/site_wright
~$ /c/Python27/pythonw.exe -m wright.main [.. configure flags ..]
Check out https://github.com/pd0mz/dmrlib
| Algorithm | Encoding | Decoding |
|---|---|---|
| CRC-5 | ❌ | ❌ |
| CRC-9 | 👍 | 👍 |
| CRC-16 (CCITT) | 👍 | 👍 |
| CRC-32 | 👍 | 👍 |
| Algorithm | Encoding | Decoding |
|---|---|---|
| Block Product Turbo Code (196, 96) | 👍 | 👍 |
| Hamming (7,4,3) | 👍 | 👍 |
| Hamming (13,9,3) | 👍 | 👍 |
| Hamming (15,11,3) | 👍 | 👍 |
| Hamming (16,11,4) | 👍 | 👍 |
| Hamming (17,12,3) | 👍 | 👍 |
| Golay (20, 8) | 👍 | 👍 |
| Quadratic Residue (16, 7, 6) | 👍 | 👍 |
| Reed-Solomon (12, 9, 4) 2 | 👍 | 👍 |
| Rate ¾ Trellis | ❌ | ❌ |
| Variable length BPTC | 👍 | 👍 |
- Full Hamming error correction not yet available
- Simplified form, shortened syndrome not implemented
| Data Type | Encoding | Decoding |
|---|---|---|
| Privacy Indicator | ❌ | ❌ |
| Voice Link Control | 👍 | 👍 |
| Terminator with Link Control | ❌ | ❌ |
| Control Signaling Block | ❌ | ❌ |
| Multiple Block Control | ❌ | ❌ |
| Data Header | ❌ | ❌ |
| Rate | ❌ | ❌ |
| Rate ¾ Data | ❌ | ❌ |
| Idle | ❌ | ❌ |
| Voice 1 | 👍 | 👍 |
- Depends on the availability of compatible hardware and/or software
The development of dmrlib wasn't possible without the help of the following people:
- Rudy Hardeman PD0ZRY
- Artem Prilutskiy R3ABM for support with Homebrew protocol
- Guus van Dooren PE1PLM for providing hardware to integrate MMDVM
- Jonathan Naylor G4KLX
You can use the issue tracker to file bug reports and feature requests.