Manuals

SquawkWin

A Pilot Client For Online Simulation (Based on DAFSIM Protocol)

One thing you need to know before : You can not run FS with several pilot clients installed, so if you want to try Squawkwin, you must disable the other clients.

First thing first is to open two TCP ports number 55008 and 55009 in ALL your firewalls, routers, NATs, Windows firewall and so on.
The full path to reach your software on these ports must be opened and cleared.

I. Installation

The pilot client is available as an auto-installer executable software.
Unzip the package somewhere is a temporary folder, launch SwInstal.exe, select your version of FS ( FSX, FS2004 or FS2002) then click OK.
After having installed Squawkwin, all you need to do is to run FS.

II. Quick Connect

• 1. Lauching SquawkWin

You will find a new entry in your FS2004 menu (no need in FSX). Select “SquawkWin” and click “Open”.
Hint : You may also press on your keyboard Shift + Tab keys to open (or show/hide) SquawkWin and specially if you don't see the menu at first installation.

With FS2004, a multiplayer session will be launched automatically, with FSX, SquawkWin will create an internal multiplayer session.

A new window fully integrated in FS Window will appear. This is the SquawkWin user interface :

• 2. Initial setup

Move your mouse cursor over the Squawkwin’s text window and click the right mouse button. The SquawkWin menu will appear.
Click "Options" then "Main setup"

then fill the name and homebase fields like this :

Click "Save" button.

Move your mouse cursor over the Squawkwin’s text window and click the right mouse button.
Click "Options" then "Main setup"
Fill the fields

IMPORTANT:
You must open 2 TCP ports on your router and firewall to use SquawkWin in the best conditions .

- Fill the URL of your network and your Login (PID) and password for each network (up to 6) you want to connect to.
- Fill the TCP ports fields as shown.
- If you are behind a LAN, fill also your LAN IP (that is assumed to be forwarded by a router or a NAT to reach your PC)
- Click on Save buttom

• 3. Connecting to Your Network

Move your mouse cursor over the Squawkwin’s text window and click the right mouse button.

Select “Networks...”, then choose your favorite Network.

A new window will appear where you can enter your callsign and then connect.

If everything is ok, you should be connected to the network server.



If you are licensed to kick out "bad boys" , please refer to KICKING A PLAYER in the SquawkRadar section

SquawkRadar

An ATC Radar Client For Online Simulation (using DAFSIM Protocol)

How to setup and connect your SquawkRadar (SR) :

CAUTION : If you use SquawkRadar under Windows VISTA, then disable the AERO interface or SR would crash to desktop because of the 3D mode of AERO !

First thing first is to open TCP port number 55004 in ALL your firewalls, routers, NATs, Windows firewall and so on.
The full path to reach your software on TCP port 55004 must be open and cleared.

On your PC (running (c)Microsoft Windows) if you have not created the folder for SR, then create a folder called DAFSIM and in this folder create another folder called SR
This should looks like : C:\dafsim\SR

Copy and unzip in (C:\dafsim\SR) the SquawkRadar.zip file and double click to launch SquawkRadar.exe
Now there are two steps : One step should be done only ONCE to setup the installation and the second step is the normal and usual connecting step.

In SR, click "Setup" tab control then click "Network Setup" Button

FIRST STEP TO DO ONLY AT THE VERY FIRST INSTALLATION

In SR, click "Setup" tab control then click "Network Setup" Button

1. Fill your first and last name, then use the login / Password that are registered in the Dafnode (or choose what you want and apply on the fly if the network owner is front of his PC to accept you)
2. In the Radar TCP port enter 55004
3. In the website line enter www.mywebsite.com (without http:// !!!) of course don't use mywebsite but your real website name !
4. Third line should be like this /dafsim/servers.php
5. Type a text in your ATIS
6. Enter an URL to your voice channel (something like mywebsite.no-ip.org/KLAX_APP for example)
7. Click "Save" button
8. Click "Load Sector" button, select a sector file and then click "Save" button again

SECOND STEP (WHAT TO DO EACH TIME YOU LAUNCH YOUR RADAR)

1. Click "Main controls" tab control, Click the "OFF --> on" to connect (to switch from OFF state to ON)
2. That's ALL ! You should be connected on your network !

Hint : You may press F1 key to read a condensed HELP and find-out by your self...

KICKING A PLAYER
This may be done for a player that does not respond (not front of his PC) or a player that disturbs others.

1. In the text field where you usually exchange messages or request weather using .WX commands, enter the following :
   !TARGETCALLSIGN! always type a free text to explain the reason of kicking this callsign
2. No spaces between the target callsign and !
3. The player who's callsign is TARGETCALLSIGN will be kicked out ONLY if you have been licensed to kick by the DAFNODE
4. The target will receive a message saying why he has been kicked
5. And a log of this action is written in a file (same folder than dafnode) called KickedOut_log.txt to let the network owner review the actions.
   

(your) Website

If you have some trouble to open/setup your modem, here is are some good helpfull links:
http://portforward.com/routers.htm
http://www.dslreports.com/faq/7074

If your flight simulation network is not a LAN, you need to setup your website like this :

Assume that you have a website called www.mywebsite.com, then you can create a flight simulation network called MYWEBSITE.
For the moment I have only written the tools for a PHP compatible website, but if you are ASP skilled, then you can help the community and contribute by converting my PHP to it's equivalent in ASP and I'll put it online with your name.

Now, in your website, create two folders like this:
www.mywebsite.com/dafsim
and
www.mywebsite.com/whazzup

Unzip somewhere on your hard disk, the file php_dafsim.zip

Choose a password for your flight simulation network

Edit the file password.php and replace "yourpassword" by your password.

Now upload all the files to the folder www.mywebsite.com/dafsim, and give PHP pages the execution and file creation rights (use chmod command).

To test that everything is up and running, open your browser and in enter the url http://www.mywebsite.com/dafsim/servers.php  (of course, replace mywebsite by the real name of your website ...)

You should read the following message:

Congratulations ! Your PHP code for dafsim is up and running.

Dafnode

There are two items to setup : One item is the website, the other one is the Dafnode server.

First thing first, setup your website as explained above.

Installing and running the Dafnode :

Next step is to open TCP port number 55000 in ALL your firewalls, routers, NATs, Windows firewall and so on.
The full path to reach your software on TCP port 55000 must be open and cleared.

On your hard disk (your own PC or any windows machine) create a folder called DAFSIM and then in this folder create a folder called dafnode.
This should looks like : C:\dafsim\dafnode

In the dafnode folder (C:\dafsim\dafnode) unzip the Dafnode.zip file and double click to launch Dafnode.exe
Now there are two steps : One step should be done only ONCE in order to setup at first the installation and the second step is the normal and usual connecting step.

FIRST STEP TO DO ONLY AT THE VERY FIRST INSTALLATION

• In the Dafnode, click "Setup and Database" tab control then click "Network Setup" Button
  
  

1. In the node TCP port enter 55000
2. In the second line type www.mywebsite.com (without http:// !!!)
3. Third line should be like this /dafsim/servers.php
4. Enter or modify the Node name, Country, City and Comments as you wish.
5. Click the "Save" button

• Still in the "Setup and Database" screen :

1. In the "Dynamic DNS" field, enter your password
2. Click "Dynamic DNS Disabled" button and switch it to enabled state.

• Click "Main controls" tab control

1. Click the "OFF --> on" to connect (to switch from OFF state to ON)
2. If everything is correct, you should see this message "...Main Hub   mode enabled."
3. That's ALL ! Your server is now available for your network.

• Now let's create your whazzup infos to let you display your network activity on some softwares like (c)ServInfo and (c)Whazzup (Copyrighted softwares)

1. Edit the text file called status.txt (should be found in your C:\dafsim\dafnode) and replace "mywebsite" by the real name of your website.
2. Save it and then upload it to your website here www.mywebsite.com/whazzup and allow file creation in this folder (the file whazzup.txt will be automatically called at each minute when Dynamic DNS will occur)
3. That's ALL !

SECOND STEP (WHAT TO DO EACH TIME YOU LAUNCH YOUR SERVER)

1. After having launched Dafnode.exe, click "Setup and Database" tab control then click "Network Setup" Button.
2. Enter your password and click "Dynamic DNS Disabled" button and let it be enabled.
3. Click "Main controls" tab control, Click the "OFF --> on" to connect (to switch from OFF state to ON)
4. If everything is correct, you should see this message "...Main Hub   mode enabled."
5. That's ALL ! Your server is now available for your network.

You can create in advance accounts for members by clicking "Setup and Database" tab control then "Members Database" button ... I let you find out by yourself...
When a member is banned, then even if he tries to connect with a new name and new login, he will be refused. The only way to get accepted is to use another PC or reformat the Hard Drive, and this could take several hours or several PC's :-)

Take a look at the PHP code I've made to understand more... and don't forget to read the FAQ, there are some nice tricks !

DCS + DGI

The Dafnode has been split in two parts: A core part and the graphic (GUI) part.
The core part is called DCS (Dafnonode Core Server) and the graphic part is DGI (Dafnode Graphic Interface)

There are three items to setup : One item is the website, the other one is the core server (DCS) and the last one is the graphic interface DGI.

In this document, the term DCS will designate the file winDCS.exe under Windows, or linDCS under Linux

First thing first, setup your website as explained above.

Installing and running the DCS :

Next step is to open TCP port number 55000 in ALL your firewalls, routers, NATs, Windows firewall and so on.
The full path to reach your software on TCP port 55000 must be open and cleared.

On your hard disk, create a folder called DAFSIM and then in this folder create a folder called dafnode.
This should looks like : C:\dafsim\dafnode or any folder under Linux that ends with dafsim/dafnode

NOTA :

a) If you already have installed dafnode.exe, then you just need to copy there the DCS.exe ( dafnode.exe and DCS.exe do share the same database and config files )
b) It is NORMAL to create a folder called dafnode to install in it the DCS; DCS means ... Dafnode Core Server

In the DCS folder (C:\dafsim\dafnode) unzip the DCS.zip file and double click to launch DCS.exe
Now there are two steps : One step should be done only ONCE in order to setup the installation and the second step is the normal and usual connecting step.

FIRST STEP TO DO ONLY AT THE VERY FIRST INSTALLATION

• Edit the file DafNode.ini in the DCS folder and fill the following fields :

1. [GENERAL]
   NodeName=
   NodeCountry=
   NodeCity=
   NodeComments=
   
   
2. [NETWORK]
   TcpPortNumber=55000
   ConnectWebSite=      <--- Here write your website's name (www.yourwebsite.xxx)
   ConnectPagePath=/dafsim/servers.php
   
   
   Here is an example :
   
   ; This file is used by the DAFNODE server ( www.dafsim.com )
   ;------------------------------------------------------------------
   [GENERAL]
   NodeName=BEN
   NodeCountry=FRANCE
   NodeCity=PARIS
   NodeComments=Bonjour les pilotes et les ATC !!!
   AddPilotRankWhazzup=Y
   ATCcanKickout=Y
   OnlyAtcCanKickout=N
   AnyAtcCanKickout=N
   PilotsCanNotPause=N
   PilotsCanNotSlew=N
   AddFsVersionWhazzup=Y
   ;------------------------------------------------------------------
   [NETWORK]
   TcpPortNumber=55000
   ConnectWebSite=www.dafsim.com
   ConnectPagePath=/dafsim/servers.php
   ConnectWebSiteFriend=
   ConnectPagePathFriend=
   LANmode=N
   ;------------------------------------------------------------------
   
   
   
   
3. Save your DafNode.ini file and close it

• Run your DCS.exe server (double click directly on DCS.exe ) :

1. In the DCS window, press 'P' key then press 'Y' key and enter your password like this:
   
   
   
   
2. Now press 'D' key to activate the Dynamic DNS and switch it to enabled state.
   
   When you do this, the dafnode ( or DCS ) will connect to your website calling the servers.php file and providing your password.
   The php code will compare the password it receives from the dafnode against the one inside the file password.php
   If they match, then your dafnode will be recognized as being the main hub of you network
   
   
3. At this level, the IP address of the dafnode will be stored locally on the website (in the file dafsimhubslist.txt) and will be delivered to the clients that want to connect to the network.
   
   
4. Now press 'O' key to switch from OFF state to ON state and activate the server.
   You should see the message "Main Hub mode enabled" like this :
   
   
   
   
5. Now, in order to fully ( and remotely if need be ) manage your DCS, you need to connect a DGI ( Dafnode Graphic Interface ) to your DCS.
   
   On your hard disk open the DAFSIM folder and create there a new folder called DGI.
   This should looks like : C:\dafsim\DGI
   In the DCS folder (C:\dafsim\DGI) unzip the DGI.zip file and double click to launch DGI.exe, this should look like this :
   
   
   
   
6. Click the "Network setup" button and then enter a login (anyone you want, this is not meaningfull for now) and then in the password type the same password you used in the DCS ( in the example it was 'yourpassword' )
   
   
7. If you have installed the DGI on the same PC than the DCS then fill the url field with 127.0.0.1:55000 otherwise enter your website's name like in this example :
   
   
   
   Click the "Save" button
   
   Now click the "CONNECT" button and you should be connected to the DCS like this example :
   
   
   
   Now enjoy and manage your DCS remotely using the DGI exactly ( or better than ) you did with the "old" dafnode.

SECOND STEP ( HOW TO MAKE YOUR SERVER START AUTOMATICALLY )

1. Easy !
   
   Create a shortcut on the DCS and then make it automatically run at Windows (or Linux) Startup, just use in the "command line" these two commands separated by a space, Here is an example : C:\anyfolder\DCS.exe DELAY_TO_CONNECT_AT_STARTUP=3 PASSWORD_TO_WEBSITE=yourpassword
   
   This will automatically run the Dynamic DNS using your password and Connect Dafnode server after 3 seconds ...
   
   Here is an example for winDCS of how looks the shortcut under Windows ( My Windows is in French )
   
   
   
   
   
2. Under Windows, you may also make the winDCS run as "service" at machine boot-up.
   
   
3. This following example is a contribution sent by Brett Buchanan
   
   How to set linDCS ( under Linux CentOS in this case )

   #!/bin/bash ./lindcs_i686 DELAY_TO_CONNECT_AT_STARTUP=5 PASSWORD_TO_WEBSITE=yourpassword &

   The & at the end allows the session window, such as putty, to be closed. This also allows for any crashes. It will automatically restart itself on a crash, not a full system restart or shut down.
   
   

ADVICES

• In the downloads page, I give an example in html on how to use the PHP interface I've created to manage the dafnode remotely, but take care, rename the file dbz_get_member_infos.html with another name or people could access your database !
  
  
• For SECURITY reasons, only a PHP request incoming from YOUR WEBSITE is accepted by the Dafnode.exe
  
  
• ALWAYS BACKUP THE FILE Members.daf (in your C:\dafsim\dafnode) to save your members database

Copyright © DAFSIM by Karim BENNEGADI 2004-2010
Products, brands and trademarks are property of their respective owners/companies