Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Append more information of pos.md and addclients.md collected from issue and experience #8

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open

Append more information of pos.md and addclients.md collected from issue and experience #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
05d3b62
Update pos.md
Feb 12, 2021
90a5a81
Update pos.md
Feb 12, 2021
48e5b60
Resolved PBH problem
Feb 13, 2021
6054b6f
Add Command of displaying new AI plane
Feb 13, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/api/addclients.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,11 @@ It is unknown as to what `100` represents, but it appears that all clients share
#AP(callsign):SERVER:(network ID)::1:(protocol version):(rating):(real name ICAO)
```

### When the SERVER asks to add a plane in your system ###
It will send you as the following
```
#SB{recipient}:{who's plane}:FSIPIR:1::{plane type like F18}:6.77316:-1.96366:400.00000:4.7F50DEA9.97E5F402::{detailed aircraft description}
```


## Removing clients ##
Expand Down
53 changes: 45 additions & 8 deletions docs/api/pos.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,14 +28,51 @@ Regardless of transponder mode, the altitude is always included in a position up

A squawk code of `7500` (aircraft hijacking) will result in an immediate disconnection from the server.

### Unknown fields ###

The meaning of the following fields is unclear:

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


### Now-Clear 'Unknown' fields answered by phoudoin ###

> (num1) = pitch / bank / heading / onground value
> a decimal sent as string whose value is the following unsigned 32bits binary number:
>
> ```
> 3 2 1 0
> 10987654321098765432109876543210
> < pitch >< bank ><heading >OU
> ```
>
> * **U** bit:
>
> * unused
> * **O** bit:
>
> * Aircraft onground indicator.
> * **heading** 10bits field:
>
> * aircraft current heading, in degree
> * values range [0, 1023] (unsigned 10 bits number)
> * 1 = 360/1024 degree
> * 0 = magnetic north
> * **bank** 10bits field:
>
> * aircraft current bank / roll angle, in degree
> * values range [-511, 512] (signed 10 bits number),
> * 1 = 180/512 degree,
> * negative value = right wing banking.
> * **pitch** 10bits field:
>
> * aircraft current pitch angle, in degree
> * values range [-511, 512] (signed 10 bits number)
> * 1 = 90/256 degree
> * 0 = aircraft is at level
> * 256 = aircraft pitch is 90 degree up (aka skyrocket!)
> * negative value = down pitch
>
> Onground aircrafts have usually 0 degree pitch and bank angles, their (num1) value is mostly heading encoded, a small value, very stable until they start taxiing.
>
> On the contrary, airborne aircrafts have rarely perfect 0 degree pitch and banking angles, leading to big (num1) values.

> (num2) = difference between Above Ground Level altitude (AGL) and Above Mean Sea Level (AMSL) altitude, as reported by aircraft barometric altimeter
>
> Unit is feet, obviously.

## ATC ##

Expand Down