NAME

       owx - utility to program Wouxun dual-band handheld radios

SYNOPSIS

       owx-check [ -v | -h ] [ -f ] [ -p <port> ] [ -t <timeout> ]
       owx-get [ -v | -h ] [ -f ] [ -p <port> ] [ -t <timeout> ] -o <path>
       owx-put [ -v | -h ] [ -f ] [ -p <port> ] [ -t <timeout> ] -i <path> -r <path>
       owx-export [ -v | -h ] -i <bin path> -o <csv path>
       owx-import [ -v | -h ] -i <csv path> -o <bin path>

DESCRIPTION

       This manual page documents briefly the owx commands.

       owx  is  a  set  of commands that will allow you to fetch and update configuration on your
       Wouxun handheld radio. It is made of multiple commands.

COMMON OPTIONS

       These options are common to all commands.

       -h     Show summary of options.

       -v     Show version of program.

       -c <command>
              Invoke owx-<command>. Makes sense only if called directly as owx.

OPTIONS FOR check, get AND put

       -f     Force operation even if your radio identifies different from a  KG669V.   Use  this
              option  with extreme caution - it is very possible that your radio will be rendered
              unusable after you use this. It was NEVER tested  with  any  radio  different  from
              mentoined above.

       -p <port>
              Use port <port>, defaults to /dev/ttyUSB0. Of course you must have appropriate read
              and write permissions for this device.

       -t <timeout>
              Specify the receive timeout for communication with radio. If  you  disable  it  (by
              setting  to  0)  and  the  communication  fails, the program will hang forever. You
              probably don't need to change the default value (5 seconds).

USAGE

       owx-check
              This program just checks for the connection and identification string.  It  can  be
              used to check that your cable and port works.

       owx-get
              This program downloads memory map from radio to binary file.

              Options:

              -o <path>: binary file to write to

       owx-put

              This program uploads memory map from binary file to radio.

              Options:

              -i <path>: binary file to read from
              -r <path>: reference file

              Option  -r  is  not mandatory, but recommended. You can specify original, unchanged
              file (exactly as downloaded using owx-get) and this will speed up memory uploading,
              as  owx  will  compare  input  file  to this reference file and upload only changed
              memory pages. When using this option, be sure that nothing has changed in the radio
              (even the currently selected memory channel) between downloading reference file and
              using it for upload. This is important  as  some  variables  that  cross  the  page
              boundaries (if there are any in the memory map) could be corrupted by this.

              Example:

              owx-get -o file.bin
              cp file.bin backup.bin
              owx-export -i file.bin -o wouxun.csv
              oocalc wouxun.csv
              owx-import -i wouxun.csv -o file.bin
              owx-put -i file.bin -r backup.bin

              Please  do  yourself a favour and double-check that you upload the correct file. If
              you try to upload incorrect or corrupted file, your radio will power down and  fail
              to  power  up.  owx will refuse to upload any file with incorrect size, but this is
              the only safety check.

       owx-export

              This program exports channel data from binary file to CSV file. This  file  can  be
              later edited using your favourite spreadsheet editor or even text editor.

              Options:

              -i <path>: binary file to read from
              -o <path>: csv file to write to

       owx-import

              This  program  reads  the  specified,  possibly edited by you CSV file, and patches
              existing binary file with this updated  data.  The  file  is  now  prepared  to  be
              uploaded with owx-put.

              Options:

              -i <path>: csv file to read from

              -o <path>: binary file to write to (must already exist)

SEE ALSO

       chirp(1), the README file.

AUTHOR

       owx was written by SP5GOF (Adam Wysocki).

       This  manual  page  was  written  by  Antoine Beaupré <anarcat@debian.org>, for the Debian
       project (and may be used by others).

                                         October 26, 2011                                  OWX(1)