Radio2csv v0.30

A simple command-line-based program
for the exchange of common data between D-Star radios

Radio2csv is a program for assisting in the mass loading of "frequency memories" ("channels") between the following Icom & Kenwood radios & software:

RadioSoftwareFirmware/software
version
TH-D74 MCP-D74 ≥1.01
IC-7300 (micro-SD card)≥1.14
ID-5100 CS-5100 ≥1.20
ID-51++ CS-51PLUS2 ≥1.0
ID-51+ CS-51PLUS ≥1.0
ID-51 CS-51 ≥1.0
ID-31 CS-31 ≥1.0
IC-2820H CS-2820 ≥1.0
ID-880H CS-80/880 ≥1.0
IC-80D CS-80/880 ≥1.0
IC-92AD RS-92 ≥1.0
IC-91AD RS-91 ≥1.0
ID-800H CS-D800 ≥2.0
ID-1 (included) ≥1.0

User knowledge requirements: Before you read any further, you need to know that Radio2csv is a command line program that runs in a command-line ("DOS"-type) window, under either Microsoft Windows or the x86 variants of Linux.

Proper usage requires a knowledge of intermediate command line operation (eg, piping/redirection). In order to use Radio2csv effectively, you will also have to understand & edit CSV (ASCII "Comma Separated Values") format files.

If you do not immediately understand the following commands, you do not have the required knowledge of intermediate command line operation to use the program effectively. Please do not ask for assistance in gaining this knowledge; it is available elsewhere on the Internet and from books.

Radio2csv does not read & write to the radios directly; rather it extracts & updates the channels in files created by the radio's software from Icom or Kenwood (hereafter referred to as "native" software).

The general model for use is:

  1. You use the native software for the target radio and possibly one or more source radios, to save the settings from those radios to native-format file(s).
  2. You use Radio2csv to extract the channels from those native-format files, to ASCII files in CSV ("Comma Separated Values") format.
  3. You optionally edit and/or merge/combine the CSV files with an ASCII editor, spreadsheet, or database program of your choice. In the case of the IC-91A/AD & IC-92AD radios, you may wish to copy data from a different "page" in the same radio.
  4. You run Radio2csv again to use your edited CSV file to update the target radio's native-format file.
  5. You run the native software for the target radio again, loading the modified target radio's native-format file and verifying that your changes are correct.
  6. Using the native software for the target radio, you upload the settings to that radio.

As you can see, Radio2csv runs in two modes:

Extraction:
It extracts channels from the source radio's native-format file. To run in this mode, enter at the command prompt:
radio2csv  RadioSourceFilename
The above command will display programmed channels information on the screen in CSV format. However, typically you will redirect this information to a file; eg:
radio2csv  RadioSourceFilename  > ChannelsFilename.csv
Modification:
It updates channels in the target radio's native-format file. To run in this mode, enter at the command prompt:
radio2csv  OldRadioTargetFilename  NewRadioTargetFilename  < ChannelsFilename.csv
Programmed channels information from the ChannelsFilename.csv will be merged with the OldDstarTargetFilename, and written to a new file named NewDstarTargetFilename. Channel information in the native-format file that is not replaced by data from the CSV-format file, is left unchanged. You can add a quoted comment (16 characters for Icom radios, 32 for the Kenwood TH-D74) after the above parameters, that will be placed in the NewDstarTargetFilename. This can be used to place a time-stamp or other comment in the file.

The Radio2csv program automatically recognizes the type of radio from the native-format file.


Reference information

Here are the fields that are present in the CSV-format file for Icom D-Star radios. Notes:

This program is currently BETA software, and you are advised to use the radio manufacturer's software for the radio to verify that valid values are going to be uploaded to the radio. In particular, if you use banks, verify that the "Bank Channel" is set correctly.

Linux note: When Radio2csv creates a new native-format file on Linux, it writes the file with the standard Linux "LF" line endings, as opposed to the "CR-LF" line endings in Windows. Apparently, the native programs will accept their native-format file with Linux line endings. In any case, you can always use the Linux unix2dos utility to convert an native-format file to Windows line endings (and dos2unix to convert back, if necessary).

Download:

Support: You can ask questions in the Radio2csv forum.

Release history:


GNU General Public License (GPL)

Radio2csv copyright © 2007-2017 by Dean K. Gibson.

Please refer interested parties to the Radio2csv web site and the Radio2csv forum.

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, version 2 of the License.

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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA


XHTML validator This page last modified on 2017-01-26 11:49 PST