20.pilot-situation-awareness

Function Overview

TSA is a function that supports DJI Pilot 2 to display the aircraft/RC info on the map by using the device coordinate information which is sent by the Server end. Both web end and DJI Pilot 2 end will have all devices info under the same workspace. It can help the communication and info sharing between all devices/Pilot2/teammates.

For example, in the following figure,Pilot A,Pilot B, DOCK A, DOCK B, Human, and other devices have pushed their information to the server through API. Once the server end receives all information, it will summarize it and push it to different DJI Pilot 2 through WebSocket, thenPilot A andPilot B will have all info displayed in their APP.

Interaction Sequence Diagram

sequenceDiagram

participant h5 as Pilot2 Webview
participant app as DJI Pilot 2
participant cloud as Cloud Server
participant other as Others
h5 ->> cloud:Log in to the 3rd party platform
note over app, h5: Setup workspaceId, load api,ws,tsa module 
h5 ->> app: load api module
h5 ->> app: load Ws module
h5 ->> app: load TSA module
app ->> cloud: Websocket connection
cloud -->> app:connect

app ->> cloud:Pilot2 online first time, request device list topology
cloud -->> app: response



loop status push
other ->> cloud: Push device remote sensing information
cloud ->> app: Push device remote sensing information at a fixed frequency

opt device_online/offline/update
	other ->> cloud: other devices online/offline/update status
	cloud ->> app: push device_online info through websocket
	app ->> app:process websocket info
	app ->> cloud: request device list topology
end

end

Detailed API Realization

• JSBridge

  • Load DJI Pilot 2 TSA Module window.djiBridge.platformLoadComponent(String name, String param) Before using the TSA function, developers need to set up the workspaceId, configure the Ws module and api module, and then load the DJI Pilot 2 map module. Also, developers can consider adding the loading interface of map module in log-in phase.

• Situation Awareness (HTTPS)

  • Obtain Device Topology List In the first connection, DJI Pilot 2 will send out an http request to obtain all devices list and topology list. On the server end, it needs to synchronize the device list to DJI Pilot 2. Also, if it receives an instruction of device online/offline/update from WebSocket, it needs the same interface to request the update of the device topology list.

  • Custom Icon The device can display custom icons by using icon_urls. If the field is defined, it will be displayed in preference to the content of the field. If not, it is displayed by default by device_model.

"icon_urls":{      
                "normal_icon_url":"resource://Pilot2/drawable/tsa_aircraft_others_normal",    // Normal status icon
                "selected_icon_url":"resource://Pilot2/drawable/tsa_aircraft_others_pressed",   // Selected status icon
            }

App has some built-in icons.

url style:  resource://Pilot2/drawable/tsa_aircraft_others_normal

Built-in Icon List

Icon	Icon_url	Remark
	resource://Pilot2/drawable/tsa_car_select
	resource://Pilot2/drawable/tsa_car_normal
	resource://Pilot2/drawable/tsa_person_select
	resource://Pilot2/drawable/tsa_person_normal
	resource://Pilot2/drawable/tsa_equipment_select
	resource://Pilot2/drawable/tsa_equipment_normal

Support online icon. Online Icons are downloaded and cached inside the App and displayed on the map at a fixed size (28dp).

url style: http://r56978dr7.hn-bkt.clouddn.com/tsa_equipment_normal.png

The icon in DJI Pilot 2 Map:

• Situation Awareness (WebSocket) and Remote Controller Properties

  • Device Remote Sensing information Push The Server end will push all devices' remote sensing information under the same workspace to DJI Pilot 2 and DJI Pilot 2 will update the status and position of the device based on the received data.

  • Device Online/Offline/Update Topology Status Push When the Server end has received a request for any device online/offline/topology update, it will broadcast a device online/offline/topology update push notification to DJI Pilot 2. DJI Pilot 2 will trigger "obtain device topology list"