FSQCall V0.40 & FSE V0.05
=========================

14/10/16

Welcome to FSQ - and be prepared to be amazed by the features of FSQCALL! Retro Selective
Calling and Link Establishment meets the 21st Century!


V0.00	20/12/14	First working FSQ alpha - first successful QSOs. 20-odd test versions followed!
V0.14	30/01/15	First version with Directed Messaging
V0.21a	08/02/15	Small direction call bug fixed. First public release.
V0.21b	09/02/15	Additional rig CAT support.
V0.22	13/02/15	CAT setup major future-proof revision, command lockout while buffer full added,
			station callsign added to banner.
V0.23	15/02/15	Bug in TX inhibit introduced with command lockout now fixed.
V0.23	03/03/15	Source code released.
V0.24	29/03/15	US Edition (not covered here).
V0.25	06/04/15	Image modes added. New '%' commands. Syntax and Rules now only embedded in program
			(and updated). Extended Slant correction added. Not released.
V0.26	15/04/15	Minor improvements. Bugs removed. FSQ-FAX mode added and image modes completely rewritten.
V0.26a	19/04/15	Image Send window copy & paste feature added. Image receive with text in TX buffer enabled.
			Default sending speed now 4.5 baud.
V0.27	12/05/15	Image modes with colour-difference encoding. Not released, as colour modes proved to be very fiddly to tune.
V0.28			Test Version. Never left home!
V0.29	23/05/15	RGB colour modes, now with HD colour mode, HD webcam and new improved RX image controls. Added "_" command.
V0.30	01/06/15	Centre frequency for TX/RX moved to 1500 Hz, with 1150 Hz option.
V0.31	19/06/15	$ command added. Test version, not released. Reception of $ not
			correctly supported.
V0.32	26/06/15	$ command works correctly. File save parser issue fixed. Sounding
			payload added.
V0.33	10/05/16	Heard Log spots logged with 1s resolution to match FSQPlot V0.7, which now screens for LDEs.
V0.34	03/06/16	Major changes to file send and receive. Shared folder added, directory functions added.
V0.35	13/06/16	Major changes: larger screen, remote image file TX - alpha distribution only. Overtaken by V0.36!
V0.36	19/06/16	Major changes: resizable screen, tool tips, bug fixes, full Telemetry and 'Smart Sounding' support,
			window layout revised, option tabs removed, replaced with Menu-driven help. Right-click commands added.
			Menu-based Inactive mode removed, so use SELCAL button instead. Menu seriously revised. Fully updated
			and comprehensive Help.
V0.40	16/08/16	Changes to support FSE, especially synchronous sampling to raw file on reception of encoded file.
			Help updated. FSQCall V0.37 to V0.39 never existed. Release includes FSE V0.05.
V0.40	14/10/16	Silent update, fixed bug in RX pane time stamping.
V0.41	21/10/16	Remembers pane size and loacation, and much improved COM port handling (now works with > COM9).

Installation
------------

Unzip this archive into a suitable folder on your C: drive. Make sure that the folder
isn't buried too deep. It also MUST NOT have spaces in the folder names. This is a
limitation of the shell mechanism used to maintain file directories. I suggest using
an installation folder such as C:\Radio\FSQ. Nice and simple.

You CAN install on top of V0.36: just make sure you allow each new file to overwrite.

Right-click on the executable FSQCALv040.exe, select 'Create Shortcut', then drag the
shortcut to the desktop or your menu. Do the same for FSEv003.exe. This is the error
correction 'helper'.

Connect the receiver audio output to the computer Line Input via an isolating transformer
or digital modes interface. Ensure that the Line Input is selected as a Record source. 
This is the same as any digital modes setup with an SSB transceiver.

Connect the audio out from your computer to the transmitter via an isolating transformer
or digital modes interface. This is the same as any digital modes setup with an SSB transceiver.

If you also have a second sound card connected to speakers, check that system sounds are
directed in that direction. This will allow you to hear Alert tones.

If using CAT, connect the appropriate (serial, USB or CI/V) cable or adaptor between the
transceiver and computer. You may need to manually edit the setup file FSQCALv022_setup.txt,
to set the correct data rate, or change your transceiver to suit the default rate, 9600 bps.
In order to use the 'CAT from file' option (for unknown rigs) you must add the TX and RX
commands to this file as indicated in the index in the file. You must open and then close
the program (to create the file) before you can edit the file.

At present only a limited number of radios with CAT are supported directly. If you use another
brand, or a model that's not listed, use the 'From file' option, or as a last resort contact
the developer, Con ZL2AFP, zl2afp@xtra.co.nz for advise. We urgently need beta testers with
these other radios.

If you are loading a new version of the program over an older one, you should not need to
rename or delete the old setup file before you start the new program. You may later wish to
cut and paste your QTC and QTH messages from the old file to the new one.

If you change your callsign in the program for any reason, close the program, close the program
and restart, otherwise the file directories won't be updated with the new callsign. At no time
should you delete Files.bat, and you should not delete the Shared folder. You can however delete
from or copy files to the Shared folder at any time. Run Files.bat or use the Menu Files/Refresh
directories item if you do.

If you really mess up, just delete the contents of the working folder, including the Shared folder,
and start installation all over again.

Removing the software (why would you want to do that?) can be done by simply deleting the
whole folder and sub-folders. There's no evil stuff scribbled in the registry - this is honest
software, with no smoke and mirrors! And no advertisements, viruses or other nasties, either.

File Access Changes
-------------------

FSQCall V0.40 operates with a sub-folder 'Shared', which is created when first run. This
is where you keep files you wish other users to access remotely. They can't access files
anwhere else on your system. Files they send you are also stored here. A further sub-folder
"Help' is created during installation, and holds all the latest Help information, now accessable
from the program Menu.

The working folder has the above-mentioned /Shared folder, which includes a /Shared/Images folder.
ONLY these two folders are accessable by other stations.

Two other folders are created. On installation, the folder /Help contains all the FSQCall Help
and associated files. The folder /FSEHelp contains FSE help and associated files. When FSE is
first run, it creates an archive folder for receeived working files, /Archive.

You can manually send any file from your computer or network using the 'Files/File to send'
menu item. Files must contain only text, and should be small. .CSV, .HTM and .TXT files are
suitable. The restriction of other operators to only your Shared folder is a security and safety
measure. You should manually clear out the /Shared folder periodically, before it gets too cluttered.

Other users can find out what files you have available by requesting the files 'short.your_call',
or 'long.your_call', depending on how much detail they require. They can then request the file,
which will be sent and saved in your Shared folder automatically.

Help Information
----------------

Both FSQCall and FSE are extensively documented. Both programs have a means to access the Help,
FSQCall from the Menu, FSE using a ' ? ' button. Make use of these resources! Read carefully. If
there is anything you do not understand, seek help (see below).

Additional Information
----------------------

Please test the new software as thoroughly as possible. We need your help, but at the same
time, we know you'll have a lot of fun using it! The software has been publicly released, so
please direct your buddies to my website for the latest and greatest. Read the Help information
carefully, especially the Syntax and Rules information, which are updated with each release.

We would appreciate all feedback, negative and positive, although preferably constructive.
We'd also appreciate operating information, including who you've worked and what you thought
about the reception quality, and the facilities provided by the system. Please send comments
and technical issues to Con ZL2AFP, zl2afp@xtra.co.nz.

While it's not too late to consider good ideas, should you have them, don't expect big
changes, and even little ones may take a while to filter through. Make sure you've read
and understood the documentation - it could be that what are looking for already exists!
There are seven detailed Help files, which you should read carefully.

We rely on your feedback to correct any problems, and for any good ideas, some of which are incorporated
in this new version. Please send feedback on both the software and the documentation, as we really do
want to have it perfect. So please read the three help files, the Rules and the Syntax carefully,
and send any comments about the documentation to Murray ZL1BPU, zl1bpu@nzart.org.nz.

Some of the features provided here (specifically file and image requests, telemetry support and
Error Corrected file support) are not currently supported by FSQ programs from other developers,
but in other respects these programs should remain compatible. If in doubt, use only the genuine ZL2AFP
FSQCall V0.40.

The source code for this software is public domain, and other versions are being built elsewhere.
Thus this is an open-source design. The software (this version at least) is written in standard
ANSI C. It works under Linux using Wine. Anyone interested in development should contact Con ZL2AFP
for the latest source code.

You should operate this software on the posted calling frequencies, which are set for software using
the default 1500 Hz centre frequency (rather than the other 1150Hz option). All frequencies quoted here
are the posted frequencies.

At the moment stations zl1bpu, zl1ee_g and zl2afp are active just about 24 hrs/day. Please join us!
As conditions change, expect to find us on either of the frequencies listed in the Rules information,
3580 kHz night, 7105 kHz day. 

Station zl1ee_g is unmanned, and operates 24hrs on a short vertical antenna. It's on 7105 kHz.
You may use it as a test station whenever you wish. It runs 35 Watts. You will find that the
signal reports it gives you will be quite different from other stations running dipoles, and may
vary more. There are 24/7 stations in other countries too, for example w5dmh on 7104 kHz.

Questions
---------
The best way to have your questions answered is to write directly to the development team at:

	zl1bpu@gmail.com.

You can discuss the mode and share operating information at:

	https://groups.yahoo.com/neo/groups/fsqdigital/conversations/messages

but be aware that answers to technical questions posed here may often be wide of the mark!

Support for the US version of FSQCall and FSQ in FLDIGI is provided only by their authors,
not by the ZL2AFP/ZL1BPU team.

Legal Stuff
-----------

The FSQ, FSE and FSQCALL software is the property of Con Wassilieff and is his Copyright (C) 2015-2016.
The FSQ and FSQCALL documentation, images and WSQ alphabet, also FSQPlot, FSE, FSM, FSP and FST, are the
property of Murray Greenman and are his Copyright (C) 2013-2016. You have permission to use this
software and these documents for Amateur Radio non-profit purposes only, and may not modify them,
or distribute any of these in any form, by any medium, without written permission.

Have fun!

73,
Murray zl1bpu/zl1ee and Con zl2afp/zl2ee

