Fly.Simvol association and
ROTW, freewares production team for FLY ! II simulator 
http://fly.simvol.org
=================================================

	S Q U A W K B O X

TO BE USED ONLY WITH FLY ! II

by Roland Herblot (ROTW)
June 2005
Version 3.21

-------------------------------
Product description
-------------------------------

- PLEASE READ THE MANUAL - 'SquawkBox_3.2_User_Manual.PDF'


------------------
Prerequisite
------------------

- This application ONLY works with Fly! II with the last patch 240.
- You should have DirectX 9.0 or higher properly installed.
- Install all the aircraft required by the AI library (see "AI Library Listing.pdf").
- Launch once the Audio Wizard of Windows before any use of "POTW voice" system.

** TeamSpeak support **
-----------------------
If you have TeamSpeak installed on your system and intend to use it with SquawkBox (IVAO network),
please copy the "TSRemote.DLL" from the TeamSpeak "client_sdk" folder to your "system32" folder.


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

Following automatic installation, you should find from the Fly! root directory :

==> "splash.ACT" + "splash.PBM" in the "Art" folder,
==> "SquawkBox.dll" in the "Modules/Pc" folder,
==> "CSL_ICAO.csv" in the Fly! 2 root,
==> "sbox" folder with many "*.sbx" files inside,
==> "Attn.wav" and "myattn.wav" in the "Sound" folder,
==> 8 "sb*.WIN" files in "UI/templates/" folder,
==> lots of AI*.nfo and _AI*.nfo in "World"
==> SquawkBox_AI.pod in "Aircraft" folder
==> In "HowTo\SquawkBox" folder : AI library listing.PDF, Lisez_Moi_SquawkBox_V3.2.txt,
    SquawkBox_v32_manual.PDF, SquawkBox_v32_manuel.PDF.

------------------
Known problems
------------------

Hosting POTW session behind a firewall device or external router :
------------------------------------------------------------------
If you use one of these device, other peers can encounter some problems while trying to reach your hosted session.
The port number used by the host peer is always '7463'. So you need to allow external input through this port number inyou external devices and firewall.
Refer to you device documentation for a correct setup.


Transponder issues :
--------------------
 - When you load a new aircraft after connection, you may find that transponder mode detection by SB
 does not work anymore (always in StandBy mode - The cause of this has not been determined).
 So, to avoid this problem, please load the desired aircraft before connection,
 or disconnect/reconnect after loading a new one.


------------------
Thanks
------------------

- Lefeteris Kalamaras, creator of SquawkBox for Fly! II,
- Alejandro Amigorena for his "real intelligent" plane AI model,
- Frederic Mouflin for the helicopter AI's development,
- the POTW (ROTW) Beta testers (Fred, Gilles, René, Gérard).
- David Sandberg for Infometar
- Internet creators ;-)


------------------
History
------------------

=============================================================================================
 Version 3.24
 by Roland Herblot
 April 2006
=============================================================================================

- Change of Ivao domain name for metar download
- Add DC-3 AI
- Add TB-10 AI
- Add "Folow me" AI
- a few fixes


=============================================================================================
 Version 3.21
 by Roland Herblot
 June 2005
=============================================================================================

- Suppressed the ATC drop list which caused unexpected event loop and lead to wrong ATC


=============================================================================================
 Version 3.20
 by Roland Herblot
 June 2005
=============================================================================================

- Real AI library created with auto gear up/down and external lighting management

- Independant multiplayer system POTW created, based on Peer To Peer technologie (DirectX)
  ==> No server required, fast (100 ms) and full AI refresh (3D vectors for speed and angles)
  ==> Additionnal AI specific liveries for POTW system (repaints)
  ==> modem 56K compatible
  ==> integrated POTW voice (experimental - fast Internet access required)

- Added auto weather function independant of Ivao / Vatsim network connection (for POTW or stand-alone use)
  Drop old METAR (not of the current day)

- If no METAR available for closest airport, find the next closest one with METAR available.


=============================================================================================
 Version 3.11
 by Roland Herblot
 September 2004
=============================================================================================

IVAO fix :
----------
Supress the use of VIR frame which cause an immediate disconnection from server due to 
new Ivao server release

Server connection :
-------------------
- Fixed the CTD while the connection failed for any reason, then show a message to the user


Auto Weather :
--------------
- Add an option to request the Winds aloft frame from server to complete the METAR import


Main Window :
-------------
- Fixed the ATC drop menu and Pilot Msg drop menu should have some strange behaviors
 after expired / reconnection cycle of an ATC or PILOT.



=============================================================================================
 Version 3.10
 by Roland Herblot
 June 2004
=============================================================================================

Server connection :
-----------------------
- Before connecting to the server, you will have to choose your aircraft type.
  (because the aircraft type query from other players occurs within the first few second after connection)

Multiplayer Aircraft:
----------------------
- Reactivated the CSL Aircraft model loading from the received CSL type (if it exists in the sbox folder).
- PLEASE NOTICE that you must not change the name of *.sbx files AT ANY TIME,
  as they are official CSL name all around the world (and sims), but you can change the name of the .NFO file inside,
  to change the Fly! aircraft associated with a CSL type.
- Notice that all the unrecognised types received are listed in the SB main window for convenience.
- The real heading / bank / pitch angles are now used and set to the aircrafts at each refresh position time.
- A simple interpolation is made beetween actual / last position to estimate a vertical speed.
  Then a rotation matrix is computed to affect a ground + vertical vector speed to the aircraft whatever its own 3 angles are.
  (allows for example an aircraft with nose up, to descend straight to the runway).
- If the aircraft type is unknown, then a default aircraft is created, with the same engine type (piston, turbo, jet).
  (3 .sbx files added in sbox folder).
- Fixed the aircraft type we send to the PIR requests (was not the CSL ~TYPE)
- Fixed the engine type of our own aircraft, sent to the server (piston, turbo, jet)
- Fixed the 3 angles (pitch, bank, heading) sent to the server for our aircraft.
- Added a slider on the main SB window that allow manual tuning of other aircraft altitudes.
  This value is also substracted from our own aircraft's sent altitude.
  Then I hope that MSFS pilots will see us with wheels on the ground.

Voice support & ATC:
--------------------
- Added automatic voice ATC switching (RogerWilco or Advanced Voice Client & TeamSpeak clients). 
  It Works only if controllers send the voice server string infos in the FIRST ATIS LINE. 
  You have to launch TeamSpeak yourself at startup. Nothing to do with Roger Wilco.
- Added a fixed UNICOM freq in ATC directory. (active at launch time).
- Unicom voice is switched only in TeamSpeak, if you have already been switched by SquawkBox to an ATC
  as I can't guess the server path for UNICOM channel.
- Added a popup menu on the main window for quick ATC switching.
- Added a field that shows the active ATC frequency.


Fly! Cockpit
-------------
- The real transponder mode is now read fom the Cockpit xpdr button on Fly! panel (STDB, A,C).
  I beleive it does not work if you don't have the last patch 240. (that was an existing function from Lefteris)
  It's normal with Hawker 800 transponder type, that the active mode is the Alpha mode.
  This is correct and the ATC see you, as with standard Charley mode.
- You can now select an ATC freq directly on the cockpit radio COM1 standby freq, then when you pass it to the
  active freq, ATC & voice client will be switched automatically (if freq is recognised as a reachable ATC).
  (There are still some limitations on particular frequencies due to Fly!
  eg : you can't switch 118.330 with the mouse & cockpit radio).


Weather :
---------
- Each 5 minutes, request METAR weather from the nearest airport if available and pass it in Fly! weather (with pre-filtering and post-filtering).
  This option is switchable through a Check Box on the main window, and saved in the Fly.Ini.
- Added ".mt <ICAO>" special command to request METAR for a specified airport.
  REMEMBER : You should delete the automatic weather generator (like WindsAloft.dll or PA19_Rand_Weather.dll) from your "Modules/Pc" 
  or "system/modules/pc" to avoid strange weather mixing !
- As METAR does not contain cloud layer height information, 3 different random cloud layer heights are set, between 800f and 3000f
during PostMetar() threatment.
 (Fly! default value is always 1500f)


Flight Plan :
-------------
- SquawkBox FPL is now automatically filled from the Fly! FPL (if one exists)
- Also the speed, altitude, current time and estimated time are filled.
- Fixed the cause of "You are not allowed to multicast" message from Ivao servers at FPL sending time.

Main window :
-------------
 - Fixed : The cursor was occasionally locked in the text input field, without any way of getting back to Fly! input with the keyboard.
   If your cursor is still locked some times, select the "------" label in the "Private Pilot Msg" drop menu to force focus loosing ;-)

Code Robustness :
-----------------
- Added 2 global Critical Sections to protect the In/Out message packet list shared between threads,
  to avoid exceptions throw.
- Removed the Inside list class Mutex.
- Exceptions catched will be shown in the main window list (hope you won't see any ;-) )
  Please let me know.



=============================================================================================
 v3.02:
 by Lefteris Kalamaras
 2001
=============================================================================================

- Added 'Transponder' Menu to control how the transponder
functions within Squawkbox, as Fly! II transponder SDK functions
are too buggy to deal with.


-------------------------
Legal notices
-------------------------

Copyright (C) 2001 Lefteris Kalamaras & the SimClients Development Group
Copyright (C) 2004-2005 Roland Herblot

The author accepts no liability concerning the use of this freeware.
TRI is concerned on no account by this addition in its simulator.
This is a freeware and any use or commercial distribution, whatever the means (not free magazine CD-ROM or CD-ROM compilation ...), is strictly forbidden.
Any use of this freeware in other free products requires the ROTW explicit authorization and implies the reproduction, in its entirety, of this file README.TXT.


 - Happy ONLINE flying! -