Codebase list dmrconfig / 80e2e7a
Bundle wiki HOWTOs with the package. Francois Marier 3 years ago
8 changed file(s) with 173 addition(s) and 0 deletion(s). Raw diff Collapse all Expand all
22 * Add a patch to fix "channel 65536 not found" errors on Anytone 878.
33 * Add a patch to raise the contact limit on Anytone 868/878.
44 * Link to upstream bug in gcc10 patch.
5 * Bundle wiki HOWTOs with the package.
56 * Add a debian/TODO file.
67
78 -- Francois Marier <francois@debian.org> Sat, 19 Sep 2020 19:17:06 -0700
0 debian/wiki/Howto-Configure-Codeplug.md
1 debian/wiki/Howto-Configure-Radio.md
2 debian/wiki/Howto-Extract-Configuration.md
3 debian/wiki/Howto-Read-Codeplug.md
4 debian/wiki/Howto-Update-Callsign-Database.md
5 debian/wiki/Howto-Write-Codeplug.md
0 # Configure a codeplug with a text script
1
2 A configuration script can be applied to a binary codeplug image with -c option.
3
4 The script can contain a complete configuration or any part of it.
5 Only parts present in the script are replaced with new data,
6 other parts are preserved. For example, to add a few useful text messages
7 to any codeplug, the following script can be used:
8
9 ```
10 $ cat messages.conf
11 Message Text
12 1 QSY Norcal 95150, pls
13 2 QSY Local, pls
14 3 QSY California 3106, pls
15 4 QSY 441.000 CC1 TS1 TG99 Direct, pls
16 5 Be Right Back
17 6 My email is mycall@arrl.net
18 7 73 . .
19 ```
20
21 The source codeplug is not touched.
22 Result is saved to a new file 'device.img'.
23
24 ```
25 $ dmrconfig -c md380-norcal-brandmeister.rdt messages.conf
26 Read codeplug from file 'md380-norcal-brandmeister.rdt'.
27 Last Programmed Date: 2016-10-20 17:49:09
28 CPS Software Version: V01.32
29 Read configuration from file 'messages.conf'.
30 Total 239 channels, 39 zones, 39 scanlists, 35 contacts, 2 grouplists.
31 Write codeplug to file 'device.img'.
32 ```
0 # Configure the radio with a text script
1
2 A configuration script can be applied to the radio with -c option.
3
4 The script can contain a complete configuration or any part of it.
5 Only parts present in the script are replaced with new data,
6 other parts are preserved. For example, I use the following script
7 to set DMR ID and name on my radios, without changing channels
8 and other stuff:
9
10 ```
11 $ cat kk6abq.conf
12 ID: 3114542
13 Name: KK6ABQ
14 Intro Line 1: KK6ABQ
15 Intro Line 2: Sergey
16 ```
17
18 Previous state is saved to file backup.img.
19 It can be restored back using -w option, in case you are not happy with
20 the result of your script.
21
22 ```
23 $ dmrconfig -c kk6abq.conf
24 Connect to TYT MD-UV380.
25 Read device: ########################## done.
26 Last Programmed Date: 2018-08-31 23:23:13
27 CPS Software Version: V=0.01
28 Write codeplug to file 'backup.img'.
29 Read configuration from file 'kk6abq.conf'.
30 Total 239 channels, 39 zones, 39 scanlists, 35 contacts, 2 grouplists.
31 Write device: ########################################### done.
32 Close device.
33 ```
0 # Extract configuration from codeplug
1
2 To convert a binary codeplug into a configuration script,
3 invoke dmrconfig without options, for example:
4
5 ```
6 $ dmrconfig md-uv380-empty.rdt
7 Read codeplug from file 'md-uv380-empty.rdt'.
8 Radio: TYT MD-UV380
9
10 Analog Name Receive Transmit Power Scan AS Sq TOT RO Admit RxTone TxTone Width
11 1 Channel1 400.000 +0 High - - 1 60 - - - - 12.5
12
13 Zone Name Channels
14 1a Zone1 1
15 1b - -
16
17 Scanlist Name PCh1 PCh2 TxCh Channels
18 1 ScanList1 - - Last 1
19
20 Contact Name Type ID RxTone
21 1 Contact1 Group 1 -
22
23 Grouplist Name Contacts
24 1 GroupList1 1
25
26 Message Text
27 1 Hello
28
29 ID: 1234
30 Name: -
31 Intro Line 1: -
32 Intro Line 2: -
33 ```
34
35 Input binary file can have IMG format (compatible with md380tools)
36 or RDT format (compatible with native CPS software).
37
38 When redirected to a file, the script will contain comments,
39 which describe the details of the configuration.
40 For examples, see [dmrconfig/examples](https://github.com/sergev/dmrconfig/tree/master/examples).
0 # Read codeplug from radio
1
2 Use option -r to read a codeplug from the radio to a binary file 'device.img'.
3 File format is compatible with md380tools.
4
5 A configuration in text format is also saved to file 'device.conf'.
6
7 ```
8 $ dmrconfig -r
9 Connect to TYT MD-UV380.
10 Read device: ########################## done.
11 Last Programmed Date: 2018-08-31 23:23:13
12 CPS Software Version: V=0.01
13 Close device.
14 Write codeplug to file 'device.img'.
15 Print configuration to file 'device.conf'.
16 ```
0 # Update Callsign Database
1
2 Radios AT-D868UV, AT-D878UV, MD-2017 and MD-UV380 are able to store a full database of DMR IDs and callsigns.
3 A firmware of your radio should be [upgraded](https://www.buytwowayradios.com/blog/2017/07/how_to_update_the_tyt_md-2017_to_store_100000_contacts.html)
4 to enable this feature.
5
6 Full list of contacts can be obtained from [RadioId.net](https://www.radioid.net/) website as a text file in CSV format. For example:
7 ```
8 $ wget https://www.radioid.net/static/user.csv
9 ```
10
11 With dmrconfig, the CSV file can be uploaded to the radio with the following command:
12 ```
13 $ dmrconfig -u user.csv
14 Connect to TYT MD-UV380.
15 Read file 'users.csv'.
16 Total 109122 contacts.
17 Erase contacts: ########################## done.
18 Write contacts: ########################## done.
19 Close device.
20 ```
21
22 Resulting view of Contacts CSV List:
23
24 ![md-uv380-csv-view.jpg](https://raw.githubusercontent.com/wiki/sergev/dmrconfig/files/md-uv380-csv-view.jpg)
0 # Write codeplug to radio
1
2 Use option -w to write a binary codeplug image to the radio.
3
4 ```
5 $ dmrconfig -w md-uv380-factory.img
6 Connect to TYT MD-UV380.
7 Read codeplug from file 'md-uv380-factory.img'.
8 Last Programmed Date: 2018-07-13 16:02:59
9 CPS Software Version: V01.07
10 Write device: ########################################### done.
11 Close device.
12 ```
13
14 Input binary file can have IMG format (compatible with md380tools)
15 or RDT format (compatible with native CPS software).