Copyright 2005 Rob Fisher.

This file is part of R20Util.

R20Util 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; either version 2 of the License, or
(at your option) any later version.

R20Util 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 R20Util; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

--------------------------------------------------------------------------

Right, with all that license stuff out of the way, welcome to R20Util!

What is it?
-----------

If you have an ICOM IC-R20 and the ICOM software CS-R20 you may find this
program useful.  It performs various operations on the .icf files that
CS-R20 saves to disk.  You can then load the results back into CS-R20 and
clone them into your IC-R20.


Features
--------

R20Util can do the following things:

* Sort your memory banks into frequency or name order.
* Display a list of duplicate frequencies.
* Search for a specified frequency and display it.
* Write a binary version of the .icf file to disk (useful if you're working
  on some of your own IC-R20 software).


How To Install
--------------

There's no installation as such.  Simply extract the contents of the .zip
file to a new directory.


How To Use
----------

R20Util is a command line program.  To get a command line in a recent version
of Windows, run cmd.exe.  If you have an older version of Windows, try
command.exe or command.com.

The easiest way to start using R20Util is to change to the directory where
you installed it, e.g.:

cd \programs\r20util\

To see up to date help, type:

r20util -h

In general, the command format is:

r20util -i <name of input file> -o <name of output file> command

You can get help on a particular command with:

r20util -h command



Tutorial
--------

Let's say you have some world band radio stations programmed into bank W of
your IC-R20, and the memory banks are named after the broadcasting country.
To make finding a country easier, you want to sort them in alphabetical order.

1.  Connect your IC-R20 to your PC with the USB cable.
2.  Run the CS-R20 program.
3.  Choose the Clone menu.
4.  Choose Read <- Receiver.
5.  Click the save icon.
6.  Find the folder where you installed RC20Util and save your file as
    original.icf.
7.  Click the start button, choose run, and enter cmd.exe into the box.
8.  Type
        c:
    to make sure you're on the c: drive.
9.  Change to the directory where you installed R20Util.  E.g.:
        cd "\My Programs\r20util\"
10. Run R20Util with this command:
        r20util -i original.icf -o sorted.icf banksort alpha W
11. Now you have a new file called sorted.icf.  Go back to CS-R20, choose
    Open from the File menu, and open this new file.
12. Check in bank W to make sure everything is in order.
13. Choose the Clone menu and select Write -> Receiver.



Sorting Banks
-------------

Banks can be sorted by frequency or by name.  E.g., to sort bank C by
frequency:

r20util -i original.icf -o c_sorted_by_frequency.icf banksort num C

To sort bank D by name:

r20util -i original.icf -o c_sorted_by_name.icf banksort alpha C

To sort all banks by frequency:

r20util -i original.icf -o all_sorted_by_name.icf banksort num all

KNOWN ISSUE - R20Util does not operate on the "Program scan edge"
memories 00A to 24B.  This means that if any of these memories have
been assigned to a bank, doing a bank sort may create duplicate bank
entries.  These are indicated by a red cross in CS-R20 and can
be corrected manually.



Displaying Duplicates
---------------------

Sometimes it's useful to see what frequencies are stored more than once.
This is done with the duplicates command.  E.g.:

r20util -i original.icf duplicates

You can also put the results in a text file, e.g.:

r20util -i original.icf -o duplicates.txt duplicates



Finding a Frequency
-------------------

Not sure if you've programmed a frequency in or not?  You can use the
findfrequency command.  E.g.:

r20util -i original.icf findfrequency 98.2



Converting a .icf File To Binary
--------------------------------

You never know, you might want to do this:

r20util -i original.icf -o original.bin writebin



Converting a .icf File To WAV
-----------------------------

WARNING - This is an experimental feature that does not yet work properly.

When you use CS-R20 to save a recording to disk, it saves a .icw file.
You can't do much with it except clone it back onto your IC-R20.  It would
be nice to be able to make a .wav file for playback on your PC.  The
writewav command attepts to do this.

r20util -i recording.icw -o recording.wav writewav

So far the results have not been good.  You can just about hear the
recording but it is mostly drowned out in noise.  This command needs
more development.



Web Site
--------

See http://www.robfisher.net/software/r20 for news, and source code to this
program.