

---------------- Squawkbox v3.1 for Fly! II. ---------------------



(C) 2001 Lefteris Kalamaras & the SimClients Development Group
(C) 2004 Roland Herblot & the VATSIM's Development Group


Please send your comments, bug reports & suggestions to Roland Herblot : rolby@tele2.fr


=============================================================================================

Installation Instructions

=============================================================================================

This application ONLY works with Fly! II with the last patch 240.
PLEASE READ THE MANUAL - 'SquawkBox_3.1_User_Manual.PDF'

Read the License.txt file - it describes the license
agreement for this product. You are assumed to abide by the
license agreement once you unzip this application.


step 1 : remove the content of "sbox" directory in Fly! 2 root, if older version installed.
step 2 : copy all the extracted package files in the Fly! 2 root directory.


You should see now from the Fly! root directory :

==> "splash.ACT" + "splash.PBM" in the "Art" folder,
==> the present file + "License_SquawkBox_V3.1.txt" + "SB_31_Fly2.doc" in "HowTo" 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,
==> 7 "sb*.WIN" files in "UI/templates/" folder,


** 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.


=============================================================================================

Known problems

=============================================================================================

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.

Weather issues :
----------------
- The APILoadMetar() function might work in a strange way sometimes.
  So if you have a look at the Weather information overview after an automatic SB weather update,
  you might find some differences between the RAW METAR string received and the weather information shown in this window.
  This is not a SquawkBox bug ;-)
- I tried to manage the same filtering as InfoMetar does (Thanks to David Sandberg) like :
  + Re-compute QNH value after METAR loading (regarding HectoPascal or mercury unit),
  + tweak to allow Thunderstorm to be shown,
  + tweak to allow rain and snow to be shown,
  + Add airport altitude to the cloud layers (Fly! cloud altitudes are taken as MSL referenced) (Pre filtering)
  + Remove remark part of METAR string to avoid confusion with temp/dew point before importation (Pre filtering).
- After an auto weather update, the altimeter altitude is not refreshed on the cockpit.
  If you want to refresh it for maximum realism, open the "Weather->Other" menu from Fly! menu 
  and validate the window by "Ok" button. You will see the altimeter moving to a realistic value after a few seconds.



Many thanks to Lefteris Kalamaras and VATSIM's dev group for their precious help.
Thanks to all the the 3.1 Beta testers (- France : Chris H, Serge V, Gilles G; - USA : Tony C ; - UK : Andrew L).


 - Happy ONLINE flying! -

Roland Herblot
June 2004



HISTORY:
--------

=============================================================================================
 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.
