DMR CPSProgrammer by DL5MCC

What is CPSProgrammer?

DMR (Digital Mobile Radio) is a digital voice (DV) modulation scheme, which becomes more and more popular in amateur radio (ham radio). To be able to use the radio transceivers, all frequencies (channels) used must be entered as a „memory channel“ into the so called codeplug (CP). There is a huge number of local radio repeaters, as well as analogue FM repeaters and simplex frequencies, which all have to be entered into the CP by typing it manually into a programming software (CPS). Only in Germany we currently have about 300 DMR repeater, which expand to about 700 channels (2 timeslots + many mixed mode FM) only for DMR.
.

Principle of the CPSProgrammer: CPSProgrammer is designed to interact with the existing vendor-provided CPS software.
The vendor's CPS software must be running for CPSProgrammer to update the codeplug that is open in vendor's CPS software
 

Programming this huge numbers of channels (callsigns, frequencies, timeslot & colour code, scanlist, RXGroup, TXContact, etc.) is a huge, boring and annoying pile of work, which can sum up to days

CPSProgrammer will make that work much more simple. All DV channels can be downloaded from the DMR database and than can easily be managed and extended by analogue channels, using Excel. A CSV file, to be generated from the Excel table, then will be used by the CPSProgrammer to program the channel information into the CPS.
CPSProgrammer directly accesses the CPS windows controls to transfer the programming information from the CSV-file into the codeplug. The automatic transfer of a few hundred channels into the Radio Programming Software takes a few minutes only.

CPSProgrammer requires a well prepared codeplug and a well prepared database (CSV), to be able to minimize your typing work on the codeplug.

Additional information can be found at this Yahoo group (founded in April 2016):
https://groups.yahoo.com/neo/groups/DMR-CPS-programming/info

Features and Limitations

CPSProgrammer is an automatic programming (programming robot) of the channel information of a CPS. CPSProgrammer reads all input-information from a CSV file. CPSProgrammer is designed to interact with the existing vendor-provided CPS software. CPSProgrammer does not read or write codeplug-files (.rdt, .rcd, .rcdx).  The vendor's CPS software must be running for CPSProgrammer to update the codeplug that is open in vendor's CPS software (see picture above:  "Principle of the CPSProgrammer"). Currently supported CPS software. Anytone AT-D868UV (CSV converting), CPS V 1.25+ Ailunce HD1 (CSV converting), CPS V1.65+ CSI CS700 Radio Programming Software V1.25 (2015-06-04): CS700, CS701, Kirisun DR7100 CSI CS750 CPS HAM2000 R4.00.27: CS750, CS751, CS800, CS801 Tytera MD380 Radio Programming Software V1.29.0, V1.30.0: MD380, MD390 Tytera MD390 → edit [MD380] section in .ini file: WindowTitle=CPS MD-390. Then select MD380 as CPS Tytera MD2017 Tytera MD9600 (select MD2017 as CPS) Retevis RT3 Radio Programming SW, V1.30.0 Retevis RT82, RT90 (select MD2017 as CPS) Hytera PD365 Hytera Customer Programming Software, V1.04.03.003.EM5: PD365, PD375 Hytera PD785 Customer Programming Software (CPS), V7.00.07.020.EM5 / v7.06.02.006.EM5, V8.00.09.007.EM5: MD 655 (G), MD785 (G), PD785 (G), X1p Please note: The new feature of 255 channels/zone is not yet supported (however planned). Hytera AR685 → edit [PD785] section in .ini file: WindowTitle. Then select PD785 as CP

CPS Compatibility

Installing

• CPSProgrammer_[version-number].exe:  Executeable
• CPSProgrammer.ini: Your individual settings for cpsprogrammer. See table below for details.
• Some sample CSV, just for demonstration. Not for a real codeplug.
• Prepared codeplug samples for CS700 / PD785G with scanlists, zones, RXgroups and TXcontacts, but without channels. This codeplug will intentionally cause warnings while programming, just to show how the software works.
• This page as pdf
• A tutorial with a prepared, empty codeplug, some CSVs and description
  

Sample and first steps

Start the Programmer

Open your Customer Programming Software (CS700/MD380/RT3 or Hytera radio programmer) and load a prepared codeplug, containing at least the required RXGroups and TXContacts (see coding reference below for additional information). The programmer allows you to create scanlists, write channels and fill scanlists. Switch to the directory where you have installed the programmer. Start the CPSProgrammer and switch to the function, you want to perform. Then select a CSV file, if you want to use another than the default one. Normally you first create empty scanlists (step 1, required to program the channels). Next you write the channel information (step 2). Once the channels are defined, you can fill the scanlists with the required channels (step 4). Start Programming by clicking the related button, e.g. "Write Channels" or "Fill Scanlists". Now, the Radio Programming Software gets focused, while all the information is automatically written into the codeplug. Note: Should anything go wrong, click onto the tray-icon on your task-line, to pause CPSProgrammer immediately. Then select to continue or to exit the programmer.	Main Menue of CPS Programmer V0.35.x
Click the Tray-Icon to pause immediately, then you may continue or exit
Tutorial The download below provides a tutorial wit some sample CSVs. Please follow the tutorial to learn how CPSProgrammer interacts with your customer programming software (CPS). The tutorial can be done within 15 minutes only. The tutorial video, embedded below, uses the CSV files used for the tutorial as well:
CPS-Programmer tutorial video More tutorials on YouTube

Concepts Of Programming Codeplugs

This picture shows the most important interdependencies in a codeplug (click to enlarge)

• First define all GroupCall, which are the Talk-Groups used in your area (e.g. TG1 world wide, TG2 Europe, TG262 Germany). This step must be done manually.
• Second define at least one RX-Group which contains all Talk-Groups expected to be received on a single channel (check for a talk group matrix for the repeaters in your area. This step also must be done manually
• Next we have to define scanlists. As we have not yet programmed the channels, the scanlists will be empty in the first step. The CPSProgrammer supports generating empty scanlists from a given csv. This is marked as step 1 in the CPSProgrammer.
• Having prepared TX-Contacts (a single talk group), RX-Groups (a list of talk groups) and empty scanlists, we are able to write our channels into the CPS. This is step 2 in the CPSProgrammer.
• Next we are able to fill our empty scanlists with the channels, we just have written into the code plug. This is step 3 in the CPSProgrammer.
• As a last step (step 4) we can create zones and fill the zones with the channels we have written into the code plug.

Coding Reference for Channels

How to generate a propper CSV File for channels

A tool providing help to create a channellist with proper coding for the CPSProgrammer is provided online:



Just go to http://www.spacesupport.de/repeater-liste.php and select "create channel list". The DMR repeater list will directly be taken from the DMR database, which grants an up-to-date channel list.

Description of the additional labels, used

num;dmrid;callsign;qrg;shift;cc;mix;ctcss;net;city;cnty;country;ctry;lat;lon;longcall
489;262866;DB0RTA;438,36250;-7,600;1;;0;DMR-plus;Gilching;Bayern;Germany;DEU;48,11044;11,32423;DB0RTA

0;num;type;callsign;dmrid;qrg;shift;cc;mix;ctcss;net;city;cnty;country;ctry;lat;lon;longcall;callext1;
callext2;txcontact1;rxgroup1;txcontact2;rxgroup2;pwr;scanlist1;scanlist2;scanlistfm{line-break=@CRLF}
1;1;d;DB0DMR;262815;439.47500;-7.600;1;;;DMR-plus;Feuchtwangen;;Germany;DEU;49.15835;10.32665;DB0DMR;
1TG262;2TG9;TG262 DL;WW;TG9 Lokal/Refl.;WW;h;BY-Nord;BY-Nord;{line-break=@CRLF}
1;2;d;DB0LEO;262750;439.53750;-7.600;1;;;DMR-DL;Leonberg;;Germany;DEU;48.80621;9.01525;DB0LEO;1TG262;
2TG9;TG262 DL;WW;TG9 Lokal/Refl.;WW;h;Stuttgart;Stuttgart;{line-break=@CRLF}

Generation of display names (channel name)

Coding Reference for Scan- and Roaminglists

To automatically generate and fill scanlists, a CSV with a specific format is required. The file contains one line for each scanlist, starting with the name of the scanlist and followed by the channel names.

ScanList;Ch1;Ch2;Ch3;Ch4;Ch5;Ch6;Ch7;Ch8;Ch9;Ch10;Ch11;Ch12;Ch13;Ch14;Ch15;Ch16;Ch17;Ch18;Ch19;
Ch20;Ch21;Ch22;Ch23;Ch24;Ch25;Ch26;Ch27;Ch28;Ch29;Ch30;Ch31{line-break=@CRLF}
MUC-DRM-FM;DB0NJ TS1;DB0NJ TS2;DB0TVM #TS1;DB0TVM #TS2;DB0PUC HTS1;DB0PUC HTS2;DB0RTA #TS1;
DB0RTA #TS2;DB0RTA %FM;DB0FSG HTS1;DB0FSG HTS2;DB0HKN TS1;DB0HKN TS2;DB0PME TS1;DB0PME TS2
;DB0AAT #TS1;DB0AAT #TS2;DB0AAT %FM;DB0ESS #TS1;DB0ESS #TS2;DB0ESS %FM;DM0ESS #TS1
;DM0ESS #TS2;DM0ESS %FM;DF0ANN TS1;DF0ANN TS2;DB0FUE #TS1; DB0FUE #TS2;DO0ET #TS1
;DO0ET #TS2;DO0ET %FM;{line-break=@CRLF}
Bodensee;DM0ESS #TS1;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;{line-break=@CRLF}

To generate scanlists, you may comfortably use DO1JG's scanlist & zonelist CSV-generator

For a Roaminglist the same structure is valid, as for a Scanlist. The keyword in the CSV, line 1 is "RoamList". Please note, that roaming is not supported by all devices.

Coding Reference for Zones

To automatically generate and fill Zones, a CSV with a specific format is required. The file contains one line for each zone, starting with the name of the Zone and followed by the channel names.

ZoneList;Ch1;Ch2;Ch3;Ch4;Ch5;Ch6;Ch7;Ch8;Ch9;Ch10;Ch11;Ch12;Ch13;Ch14;Ch15;Ch16{line-break=@CRLF}
Munich;DB0NJ 1TG262;DB0NJ 2TG9;DB0TVM #1TG262;DB0TVM #2TG9;DB0PUC #1TG262;
DB0PUC #2TG9;DB0RTA %FM;DB0FSG #1TG262;DB0FSG #2TG9;DB0HKN 1TG262;DB0HKN 2TG9;
DB0TTB #1TG262;DB0TTB #2TG9;DB0PME 1TG262;DB0PME 2TG9;DB0AAT #1TG262{line-break=@CRLF}

Coding Reference for RX Groups

To automatically generate and fill RXGroups, a CSV with a specific format is required. The file contains one line for each RXGroup, starting with the name of the Group and followed by the TalkGroup names.

RxGroups;tg1;tg2;tg3;tg4;tg5;tg6;tg7;tg8;tg9;tg10;tg11;tg12;tg13;tg14;tg15;tg16;tg17;tg18;tg19;
tg20;tg21;tg22;tg23;tg24;tg25;tg26;tg27;tg28;tg29;tg30;tg31;tg32;tg33;tg34;tg35;tg36;tg37;tg38;
tg39;tg40;tg41;tg42;tg43;tg44;tg45;tg46;tg47;tg48;tg49;tg50;tg51;tg52;tg53;tg54;tg55;tg56;tg57;
tg58;tg59;tg60;tg61;tg62;tg63;tg64{line-break=@CRLF}
WW;TG1 WW;TG10 DE-WW;TG110 UA-DE;TG113 UA-EN;TG119 UA-any;TG120 UA-DE;TG123 UA-EN;TG129 UA-any;
TG13 EN-WW;TG2 EU;TG20 DACH;TG204 NL;TG206 ON;TG228 HB9;TG230 Czech;TG232 OE;TG235 GB;TG238 OZ;
TG262 DE;TG2628 DE-BY;TG8 regional;TG9 local;TG99 Simplex;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;;;;;;;{line-break=@CRLF}

Ini-File

Export Codeplug to CSV

CPSProgrammer can read the controls of the CPS and therefore export the channels of an opened codeplug into a CSV file. This can be used as backup, or as a base for codeplug development, to start from. This may also be used to copy channels between different DMR transceivers, which codeplugs are not interchangeable. Before you start "export channels", you have to open any channel with your CPS!

The picture above shows the export of channels from a CPS. The exported channels are written into a edit field in CSV notation first, where you can edit the data before storage. You may enter text, delete text or copy (ctrl+c) and paste (ctrl+v) text in the edit field. The red out channels are re-compiled into the CPSProgrammer format, where up to 3 channels (TS1, TS2, mixed-mode-FM) can be packed into one line, if applicable.
While exporting the channels, CPSProgrammer collects information about the used ScanLists, RXGroups and TXContacts in the codeplug being exported. This information is shown in the boxes under "Code Plug information" and can be saved in a text file by clicking the "Save Code Plug Information" button.
You may also define a range in your codeplug within the selected channels will be exported (a channel number can be found next to the navigation buttons in your CPS). With the default setting 1 ... 1024 ALL channels of a codeplug will be exported.

Exporting zones is shown in the picture below. The operation of exporting zones, scanlists and RXGroups as well, is quite similar to exporting channels, described above. Once the zones, scanlists or RXGroups are written into the edit-field, you can edit the CSV or save the data in a file by clicking "Save as".

List Generators

CPSProgrammer provides list generators for DMR and FM channels, to automatically generate channel-CSVs with consecutive frequencies, such as consecutive simplex- or repeater-channels. The generated channels are written into a edit field in CSV notation first, where you can edit the data before storage. You may enter text, delete text or copy (ctrl+c) and paste (ctrl+v) text in the edit field.
Below is an example, how to generate the European FM repeater channels with its former naming pattern R70, R70x ... R101x (x equals 12,5 kHz offset). The naming pattern for repeater channels now is different, but this example shows how powerful the channel list generator can be used.

The callsign ("channel name") to be displayed is generated automatically and made by a concatenation of up to 6 input fields. The following functions are available for each of the 6 fields:

• N: Insert counter value, incremented by one, each line. Usually starts by 0
• Text: Insert text, entered in the input field just below the combo-field
• space: Insert a single space " "
• N, N/2 ... N/16: Insert an integer N, or N/x (to generate x times the same number, e.g. N/2: generates 0, 0, 1, 1, 2, 2, ...)
• Nmod2 ... Nmod16: Insert the remainder of N/x. (e.g. N Mod 4 generates 0, 1, 2, 3, 0, 1, 2, 3, 0, ...)
• C1-3-5: Insert "Cx", cycling all odd numbers from 1 to 15: C1, C3, C5 ... C13, C15, C1, C3, C5, ...
• 0-0x: Inserts letter x, when N is an odd value (Used to generate R70, R70x, R71, R71x, ... in the sample above)
• 0-0text: Inserts the text, entered in the input field just below, when N is an odd value
• clr: Insert nothing (clear)
• f-RX.5: Insert RX frequency with 5 digits, e.g. 433.58750
• f-RX.4: Insert RX frequency with 4 digits, e.g. 433.5875
• f-RX.3: Insert RX frequency with 3 digits, e.g. 433.587

The picture above shows the DMR CSV List-Generator, which allows to generate a channel list with consecutive frequencies. The sample shown here, will generate consecutive channels according to the DMR-Find scheme.

The picture above shows the window of "Convert FM-Repeater List" with a converted repeater list. This allows you to convert a CSV file, downloaded from http://relaislisten.darc.de/ into a format required from CPSProgrammer.
Via this Interface you have access to one of the biggest databases on amateur radio voice repeaters. Currently they have more than 8000 entries from more than 60 countries in their database.
To build the channel-name for the newly generated CSV, two additional functions are provided:

• CSV-call: Adds the text provided with the "call" field of the input file
• CSV-info: Adds the text provided with the "info" field of the input file

Please carefully check the input file for inconsistency and doubled entries. Sometimes information (e.g. repeater input frequency) is missing.

Bulk Edit

To edit a bulk of channels in one time, CPSProgrammer does provide bulk edit functions. Bulk Delete Channels (picture below) allows you to delete channels in your codeplug.
You can select if you want to delete all channels or only FM or DMR channels. You may also skip mixed mode channels (delimiter, e.g. %FM, is defined in the ini-file). You may also define a range in your codeplug within the selected channels will be deleted (a channel number can be found next to the navigation buttons on the left side). With the default setting 1 ... 1024 ALL channels in a codeplug will be deleted.
CPSProgrammer first jumps to last channel in the codeplug and starts searching reverse. If the number of the current channel is lower or equal then "delete to ch'" the current channel will be deleted, provided it fits to the selection (all, DMR, FM). If the channel number, given in "delete from ch" is reached, bulk delete stops.

Bulk Delete: The green progress bar shows the current progress.

Convert CSV

This new function allows you to convert CPSProgrammer CSVs into CSV-formats accepted from third party Customer Programming Software, for importing data.
Following sources may be used as input for conversion:

• CPSProgrammer CSV, generated by exporting any existing codeplug from any supported CPS (Hytera, Tytera, Retevis)
• CSV generated from the current DMR-Repeater-Database. See here for detailed information.
• CSV containing consecutive frequencies (lists), generated by the integrated list generator. See here for detailed information.

Convert CSV: Allows to convert CPSProgrammer CSVs into other CPS (=target) CSV formats

Downloads

Codeplugs

History

Disclaimer and legal note