Skip to content

Changes

Page history
Update Telemetry Connection authored by Efren Otero Cabaleiro's avatar Efren Otero Cabaleiro
Hide whitespace changes
Inline Side-by-side
Telemetry-Connection.md
View page @ 3381cba7
...@@ -53,6 +53,11 @@ Return to the main menu and go to the flight menu (Icon labeled with the number ...@@ -53,6 +53,11 @@ Return to the main menu and go to the flight menu (Icon labeled with the number
And you are ready to go. And you are ready to go.
# End Point connection # End Point connection
### Obtain token
To obtain the token necessary for sending telemetry, you need to make a GET request to this URL dev-dsdp-acquisition.airus-suite.com/api/token?username=USERNAME&password=PASSWORD .
For more information on the authentication process and how to obtein the token in general, you can consult here: [Get token in airus](get_token_in_airus)
### Sending Telemetry
To send Target Reports to this server you must connect via WS to the following endpoint: `wss://dev-dsdp-acquisition.airus-suite.com/ws/dsdp/$station-id/$token`. To send Target Reports to this server you must connect via WS to the following endpoint: `wss://dev-dsdp-acquisition.airus-suite.com/ws/dsdp/$station-id/$token`.
The token and station-id parameters included in the URL are explained below. The token and station-id parameters included in the URL are explained below.
...@@ -183,28 +188,3 @@ ws = create_connection(url) ...@@ -183,28 +188,3 @@ ws = create_connection(url)
target_report = json.dumps({'surveillance_station': {'identification': {'uuid': '08f73584-bbe7-48e8-88ee-56519ff040c7'}, 'type': 'MS_RADAR', 'period': 3.3}, 'timestamp': 30, 'association': {'track_uuid': '8f0002a9-d256-47f4-92ed-56e0ac149ae0'}, 'data_items': {'identification': {'reported_identification_data': {'reported_uuids': {'drone_serial': 'EA61723123Sergio', 'utm_transponder': '4526d17d-3d36-4d3e-a048-3371b7e256c4', 'telemetry': '926f3090-156d-4218-81e6-e5b1fa3c7fa5', 'pilot_uuid': 'abcde_sim', 'operator_uuid': 'abcde_sim'}}}, 'supplemental': {'aircraft': {'aircraft_type': {'type': 'MULTIROTOR'}}}, 'take_off_location': {'longitude': -4.010009765624999, 'latitude': 41.15797827873605, 'altitude': 2.317273050917592}, 'kinematic': {'position': {'geodetic': {'toa': 30, 'measured': True, 'relayed': True, 'position': {'longitude': -4.010009765624999, 'latitude': 41.15797827873605, 'altitude': -5.797273617990068}}, 'altitude_amsl': 1, 'altitude_agl': 1, 'enu': {'toa': 1, 'measured': False, 'relayed': False, 'position': {'east': 0, 'north': 0, 'up': 0}, 'error': {'horizontal': {'mean': {'east': 0, 'north': 0}, 'covariance': {'e_e': 1, 'n_n': 1, 'e_n': 0}, 'outliers': {}}, 'vertical': {'mean': {'up': 0}, 'covariance': {'u_u': 1}, 'outliers': {}}}}}, 'velocity': {'ned': {'vel_n': 1, 'vel_e': 2, 'vel_d': 3}}, 'attitude': {'yaw': 4}}}, 'vigilant_id': '8b0855b9-196c-4bc4-b949-8668742efb07'}) target_report = json.dumps({'surveillance_station': {'identification': {'uuid': '08f73584-bbe7-48e8-88ee-56519ff040c7'}, 'type': 'MS_RADAR', 'period': 3.3}, 'timestamp': 30, 'association': {'track_uuid': '8f0002a9-d256-47f4-92ed-56e0ac149ae0'}, 'data_items': {'identification': {'reported_identification_data': {'reported_uuids': {'drone_serial': 'EA61723123Sergio', 'utm_transponder': '4526d17d-3d36-4d3e-a048-3371b7e256c4', 'telemetry': '926f3090-156d-4218-81e6-e5b1fa3c7fa5', 'pilot_uuid': 'abcde_sim', 'operator_uuid': 'abcde_sim'}}}, 'supplemental': {'aircraft': {'aircraft_type': {'type': 'MULTIROTOR'}}}, 'take_off_location': {'longitude': -4.010009765624999, 'latitude': 41.15797827873605, 'altitude': 2.317273050917592}, 'kinematic': {'position': {'geodetic': {'toa': 30, 'measured': True, 'relayed': True, 'position': {'longitude': -4.010009765624999, 'latitude': 41.15797827873605, 'altitude': -5.797273617990068}}, 'altitude_amsl': 1, 'altitude_agl': 1, 'enu': {'toa': 1, 'measured': False, 'relayed': False, 'position': {'east': 0, 'north': 0, 'up': 0}, 'error': {'horizontal': {'mean': {'east': 0, 'north': 0}, 'covariance': {'e_e': 1, 'n_n': 1, 'e_n': 0}, 'outliers': {}}, 'vertical': {'mean': {'up': 0}, 'covariance': {'u_u': 1}, 'outliers': {}}}}}, 'velocity': {'ned': {'vel_n': 1, 'vel_e': 2, 'vel_d': 3}}, 'attitude': {'yaw': 4}}}, 'vigilant_id': '8b0855b9-196c-4bc4-b949-8668742efb07'})
ws.send(target_report) ws.send(target_report)
``` ```
### Obtain token
To obtain the token necessary for sending telemetry, you need to make a GET request to this URL dev-dsdp-acquisition.airus-suite.com/api/token?username=USERNAME&password=PASSWORD .
For more information on the authentication process and how to obtein the token in general, you can consult here: [Get token in airus](get_token_in_airus)
### External surveillance station
1. Register surveillance station in our service, **this step is not needed in case of telemetry surveillance stations**. Go to <https://dev-airus-ussp.airus-suite.com/sdp/surveillance_stations> and register a surveillance station in the side menu: Surveillance Data Processor -> Surveillance Status and click the button "NEW"
![img.png](register_surveillance_1.png)
![img.png](register_surveillance_2.png)
![img.png](register_surveillance_3.png)
The generated identifier of the surveillance station will be the one used in the websocket connection
![img.png](register_surveillance_4.png)