norrisng / fsd-doc

An unofficial attempt at docmenting FSD, the protocol behind IVAO and VATSIM.

FSD documentation

An unofficial attempt at documenting the implementations of FSD used today. IVAO and VATSIM happen to be the most common ones, though there are likely others.

The documentation can be viewed here: https://fsd-doc.norrisng.ca/

NOTE: the original link at https://studentweb.uvic.ca/~norrisng/fsd-doc/ is no longer accessible. Please update your links, bookmarks, favourites, URLs, BBQs, etc etc.

Editing and building the site

Individual pages can be edited using your favourite text or Markdown editor.

The entire documentation uses MkDocs. To build the site into static HTML files:

sudo apt-get install mkdocs
cd fsd-doc
mkdocs build

This creates a directory named site/. The index page is located at site/index.html.

To see a live preview while editing, run the following:

mkdocs serve

Once running, the preview can be viewed at http://localhost:8000.

The table of contents on the left is controlled by mkdocs.yml. To edit it, please refer to the official MkDocs documentation.

Contributing

Feel free to fork and create a pull request!

fsd-doc's Issues

Audio

Any info on how audio is running thru FSD, let's say on some defined frequency?

vPilot Password Hash

After wiresharking vPilot, i think they are using a Hash for the password nowdays.. Does anyone know what hash they use?

@N vs @S for pilot updates

What's the distinction between @N/@S for pilot position updates? Both are used for both outgoing/incoming updates.

Some Questions About Client Authorize

I am writing a server software based on open source fsd ,but i the client authorize always shutdown the socket ,if the hash token can be so ,can you figure out this problem Thanks

IVAO FSD revision D

IVAO forum threads (login required):

• http://forum.ivao.aero/index.php?topic=324301.0
• http://forum.ivao.aero/index.php?topic=328989.0

IVAO is in the process of rewriting the FSD server software, and in the process have implemented a new revision of the FSD protocol: revision D. It appears to be backward-compatible with the existing IVAO revisions C and B.

As of the time of writing, the only feature implemented is an increased refresh rate of 2.5 seconds (for pilot clients only) or 4 seconds (all clients), though it is unclear if any of the existing IVAO clients actually render the additional position updates received.

Currently, IVAO has deployed revision D on one server for its members: eu7.ivan.ivao.aero.

Transponder Mode C

How does the client indicate the transponder mode?

@N and @S seem to include the altitude regardless of transponder state.

Does any one know the protocol of ATC's handoff a pilot ?

I'm working on a controller client.

Pilot position updates - (num1) and (num2) fields

What does (num1) and (num2) represent? It's present in both IVAO and VATSIM variants, but isn't present in the original FSD spec.

• (num1) is a number of up to 10 digits. It seems to begin with 4.
• (num2) is an integer. There seems to be a wide range of values, anywhere between 1 and 3 digits, and can be positive or negative.