dmrconfig/README.md

105 lines
2.7 KiB
Markdown
Raw Normal View History

2021-01-05 11:26:19 -08:00
# DMRconfig
2018-08-20 22:47:13 -07:00
DMRconfig is a utility for programming digital radios via USB programming cable.
2021-01-05 11:26:19 -08:00
## Supported radios:
2018-08-20 22:47:13 -07:00
* TYT MD-380, Retevis RT3, RT8
2018-11-27 21:38:49 -08:00
* TYT MD-390
2018-10-26 20:12:05 -07:00
* TYT MD-2017, Retevis RT82
2018-08-20 22:47:13 -07:00
* TYT MD-UV380
2018-10-26 20:12:05 -07:00
* TYT MD-UV390, Retevis RT3S
* TYT MD-9600
2018-11-21 00:42:08 -08:00
* Baofeng DM-1701, Retevis RT84
* Baofeng RD-5R, TD-5R
* Baofeng DM-1801
2018-10-04 21:25:46 -07:00
* Radioddity GD-77
* Anytone AT-D868UV
2018-12-26 21:37:15 -08:00
* Anytone AT-D878UV
* BTECH DMR-6x2
2018-10-26 20:12:05 -07:00
* Zastone D900
* Zastone DP880
* Radtel RT-27D
2018-08-20 22:47:13 -07:00
[![Packaging status](https://repology.org/badge/vertical-allrepos/dmrconfig.svg)](https://repology.org/metapackage/dmrconfig/versions)
2018-08-20 22:47:13 -07:00
## Usage
Read codeplug from the radio and save it to file 'device.img',
2018-08-31 23:20:07 -07:00
and also save text configuration to 'device.conf':
2018-08-20 22:47:13 -07:00
2018-08-31 23:20:07 -07:00
dmrconfig -r [-t]
2018-08-20 22:47:13 -07:00
Write codeplug to the radio:
2018-08-31 23:20:07 -07:00
dmrconfig -w [-t] file.img
2018-08-20 22:47:13 -07:00
Configure the radio from text file.
Previous codeplug is saved to 'backup.img':
2018-08-31 23:20:07 -07:00
dmrconfig -c [-t] file.conf
2018-08-20 22:47:13 -07:00
Show configuration from the codeplug file:
dmrconfig file.img
2018-08-31 23:20:07 -07:00
Apply configuration from text file to the codeplug file:
dmrconfig -c file.img file.conf
2018-09-05 23:47:57 -07:00
Update database of contacts from CSV file:
dmrconfig -u [-t] file.csv
2018-08-31 23:20:07 -07:00
Option -t enables tracing of USB protocol.
2018-08-20 22:47:13 -07:00
## Compilation
2021-01-05 12:56:39 -08:00
Whenever possible use the `dmrconfig` package provided from by Linux distribution
If you want to compile `dmrconfig`, follow these instructions:
* Install dependencies
* On Ubuntu `sudo apt install git build-essential pkg-config libusb-1.0-0-dev libudev-dev`
* On Arch Linux `sudo pacman -S git base-devel libusb`
* On Mac OS `brew install pkg-config libusb`
* Clone this repository
```
git clone https://github.com/sergev/dmrconfig
```
* Compile and install
```
make
sudo make install
```
2018-09-21 12:17:23 -07:00
## Permissions
On Linux, a permission to access USB device is required.
It's possible to run dmrconfig as root, like "sudo dmrconfig",
but it's safer to enable access for users.
Create a file /etc/udev/rules.d/99-dmr.rules with the following contents:
# TYT MD-UV380
SUBSYSTEM=="usb", ATTRS{idVendor}=="0483", ATTRS{idProduct}=="df11", MODE="666"
# Baofeng RD-5R, TD-5R, DM-1801
2018-09-21 12:17:23 -07:00
SUBSYSTEM=="usb", ATTRS{idVendor}=="15a2", ATTRS{idProduct}=="0073", MODE="666"
2018-10-26 20:12:05 -07:00
# Anytone AT-D868UV: ignore this device in Modem Manager
ATTRS{idVendor}=="28e9" ATTRS{idProduct}=="018a", ENV{ID_MM_DEVICE_IGNORE}="1"
2018-09-21 12:17:23 -07:00
To activate it, run:
sudo udevadm control --reload-rules
Then re-attach the USB cable to the radio.
2018-08-20 22:47:13 -07:00
## License
2018-08-20 22:47:13 -07:00
Sources are distributed freely under the terms of BSD 3 license. \
For more information see the [LICENSE file](https://github.com/OpenRTX/dmrconfig/blob/master/LICENSE)
2018-08-20 22:47:13 -07:00
2021-01-05 11:26:19 -08:00
## Credits
DMRconfig was created by Serge Vakulenko KK6ABQ.
2018-08-20 22:47:13 -07:00
It is currently maintained by the OpenRTX developers.