From 05d3b62364e644f0b59a4b8fe52091e706c142b4 Mon Sep 17 00:00:00 2001 From: yajusenpai Date: Fri, 12 Feb 2021 15:55:51 +0000 Subject: [PATCH 1/4] Update pos.md --- docs/api/pos.md | 39 +++++++++++++++++++++++++++++++++++++-- 1 file changed, 37 insertions(+), 2 deletions(-) diff --git a/docs/api/pos.md b/docs/api/pos.md index 761618a..64ca6f3 100644 --- a/docs/api/pos.md +++ b/docs/api/pos.md @@ -32,8 +32,43 @@ A squawk code of `7500` (aircraft hijacking) will result in an immediate disconn 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. +(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 >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. + +@phoudoin + +phoudoin commented on 15 Aug 2019 • +(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. From 90a5a81cb6867593eaedbde368bb7f6d832f0901 Mon Sep 17 00:00:00 2001 From: yajusenpai Date: Fri, 12 Feb 2021 15:56:58 +0000 Subject: [PATCH 2/4] Update pos.md --- docs/api/pos.md | 84 +++++++++++++++++++++++++------------------------ 1 file changed, 43 insertions(+), 41 deletions(-) diff --git a/docs/api/pos.md b/docs/api/pos.md index 64ca6f3..107df34 100644 --- a/docs/api/pos.md +++ b/docs/api/pos.md @@ -30,47 +30,49 @@ A squawk code of `7500` (aircraft hijacking) will result in an immediate disconn ### Unknown fields ### -The meaning of the following fields is unclear: - -(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 >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. - -@phoudoin - -phoudoin commented on 15 Aug 2019 • -(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. - - +> (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 >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 ## From 48e5b6076752966ae3c304cb85f97ee637d61fe0 Mon Sep 17 00:00:00 2001 From: yajusenpai Date: Sat, 13 Feb 2021 15:25:42 +0000 Subject: [PATCH 3/4] Resolved PBH problem --- docs/api/pos.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api/pos.md b/docs/api/pos.md index 107df34..fdcef38 100644 --- a/docs/api/pos.md +++ b/docs/api/pos.md @@ -28,7 +28,7 @@ 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 ### +### 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: From 6054b6faaebaf7d7f68ff6a80037da9e6982eb41 Mon Sep 17 00:00:00 2001 From: yajusenpai Date: Sat, 13 Feb 2021 15:30:00 +0000 Subject: [PATCH 4/4] Add Command of displaying new AI plane --- docs/api/addclients.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/api/addclients.md b/docs/api/addclients.md index 7a23091..2761d73 100644 --- a/docs/api/addclients.md +++ b/docs/api/addclients.md @@ -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 ##