Remote controller for FT757 v1.12 (c) John Coppens LW3HAZ/ON6JC 1997
---------------------------------

Introduction
------------

   I started this project as a programming exercise, and, as sometimes
happens, it grew from a simple program into something a bit more compli-
cated than intended.

   To make it as useful as possible, I tried to maintain the size of
the controller's window as small as possible, without recurring to
complicated or multi-page menus.

   Please note that the FT-757 doesn't report back to the program -
an unlucky decision of Yaesu - and means that it is not possible
to determine the actual state of the transceiver, for example the Lock
button or the actual frequency of the dial.

   Thanks to LU8HSY, Jos Mara, for testing the program.


Installation
------------
   Simply uncompress the .ZIP distribution archive into a directory,
preferably dedicated to this program. Four new files will appear:

   - FT757ENG.TXT (you are reading it)
   - FT757ESP.TXT (the spanish translation of this doc)
   - FT757.EXE
   - FT757.MEM (Example of a memory file)

   Then, you have two alternatives:

   - Test run the program if you don't trust it (preferred)
   - Permanent installation

   To evaluate the program, simply follow the 'Run' instructions from
the file menu of the Program Manager. Navigate to the directory, select
FT757.EXE, and click 'Ok' twice.

   To install FT757 permanently, you can either create a new group
or add it to an existing group, maybe together with other communication
programs. You'll have to use the Program Manager's new group option
to create the new group, then add item to add this program to it.
The exact procedure is a bit different for each version of Windows,
please refer to the Help file.


Configuration
-------------
   By default, the program uses COM2, and a speed of 4800 Bauds to
talk to the tranceiver. If this port is already used by Windows, a
menu will appear permitting to change this.

   It is also possible to change the value by right clicking anywhere
on the program's window, and entering the Setup option of the menu.
Setup permits changing the COM parameters, and changing the actual
configuration of the program.

   FT757 recalls its last position on the screen the next time it's
called.

   If you have non-standard COM port addresses or IRQs, please use
the Window configuration routines to change these values if necessary,
before calling FT757.


Usage
-----
   Once the program is running, the following possibilities exist:

Actual frequency:

   - Modify the frequency on the dial, using the + and - buttons on
     each digit.
     Pressing and releasing immediately, will increment or decrement
     the digit once.
     Holding the button a little longer will increment or decrement
     continuously. If 'Continue incrementing' is checked in the
     setup menu, the increment (or decrement) will stop only when
     a button is pressed or the dial is clicked. If not checked,
     incrementing will stop if the button is released.

   - To edit the description, click on the description box below
     the dial.
     By preference, enter the most important item of the description
     first. The alphabetic ordering will then group items of the
     same type. Example: 'SSTV Testing frequency'

  - To edit either mode or bandwidth (BW), you can left-click the
    edit box, and enter the text, or right-click, and a list with
    predefined values will appear.

   - The two buttons to the right of the dial, are two instantaneous
     memories, similar to the two VFOs of the tranceiver. The one
     selected will track the display. The memories will retain both
     frequency and description. Pushing the button will connect it
     to the dial.

   - The button with the arrow pointing down, will copy frequency
     and description of the dial into the selected memory of the
     memory bank.

   - Inversely, the arrow pointing up, will copy the selected memory
     into the dial.

   - The button marked with a '+' and an arrow, will add the current
     dial frequency as a new memory to the memory bank.


Memory bank:

   - The memory bank permits 999 memories.

   - The button with the trash can will delete the selected memory.

   - The button marked '123' will sort the bank according to frequency.
  - The button marked 'ABC', below the modes, will sort the bank
    according to mode.
  - The button marked 'ABC', below the descriptions, will sort the
    bank according to description.
    (case is important!)
     In all cases, the sorted list will only be saved to disk after
     the next modification to it. If necessary, it's possible to exit
     immediately after sorting, and reentering will restore the table's
     previous state.

   - Clicking in the columns below 1 - 8 (scan groups) will enable or
     disable scanning the corresponding channel in its group. Each
     change of state will update the disk image.

   - The buttons 1 to 8 start or stop the scanning of group. If
     a selected group contains less than 2 channels, scanning is
     stopped immediately.


Iconize:

   The FT757's icon, will reflect the frequency of the dial, even if
the program is scanning at that moment.


Attention
---------

   It's possible to edit FT757.INI using a simple ASCII editor like
Notepad. (This file is generated automatically after the first use
of the program)

   Also, it's possible to edit the memory file FT757.MEM, using an
ASCII editor. Take *very special care* if you do this, as the format
of this file is quite rigid, and the load routine in FT757 does not
check for syntax errors. If it does encounter errors, results may
be unpredictable.

   Probably it won't be necessary to edit these files at all, as
the .INI file is generated automatically, and the memory file is
updated each time a change is made to the table.


Finally
-------
   This file can be freely used and copied - except for commercial
use. This program may NOT be included with a tranceiver or software
package to aument its value.

   Though the copying is free, I would appreciate a donations: I don't
need them to live, so they will be used to improve our Club's communica-
tions system. If you find that this program does ease you operating,
please consider a contribution! (Somewhere around the equivalent of US$
10 would be nice - compare with the cost of commercial 'extras' you can
buy) People who 'register' this way will be notified of newer versions
by e-mail.

   This program may be published in BBSs, with the condition that
no fee is charged for accessing this particular archive. It may
also be included in 'Freeware/Shareware' type distributions.

   Without exceptions: the program may not be distributed incompletely.
Always, the parts listed before must be present, and no part may be
modified without my express authorization.

   As this is a free program, you have no garantee that:

   - this program will actually work,
   - this is the program you are looking for,
   - the author is willing to attend to your technical problems,
   - your disc will not be completely cleaned out by using the program.

   If you suspect or doubt, please do not use it...


And now for the real end:
-------------------------
   If you detect some problem (or are willing to donate), you can
contact me through:

   e-mail: on6jc@amsat.org
           jcoppens@linux2.uccor.edu.ar

   ax.25 : lw3haz@lu2hdx.arg.sa

   mail  : John Coppens
           Casilla de Correo 103
           5152 Villa Carlos Paz
           Argentina

