Tech-invite  3GPPspace  IETFspace
21  22  23  24  25  26  27  28  29  31  32  33  34  35  36  37  38  4‑5x

Content for  TS 23.255  Word version:  19.4.0

Top   Top   Up   Prev   Next
0…   5…   6…   7…   7.1a…   7.2…   7.3…   7.4…   7.5…   7.6…   7.7…   7.8…   7.9…   7.10…   7.11…   8…   8.2.5…   A   B…   C… 
8 APIs  8.1 General  8.2 UAE server APIs  8.2.1 General  8.2.2 UAE_C2OperationModeManagement API  8.2.2.1 General  8.2.2.2 Manage_C2OperationMode operation  8.2.2.3 Notify_SelectedC2Mode  8.2.2.4 Notify_C2ModeSwitching  8.2.2.5 Notify_C2OperationModeManagementComplete  8.2.3 UAE_ RealtimeUAVStatus API  8.2.3.1 General  8.2.3.2 Subscribe_RealtimeUAVStatus operation  8.2.3.3 Unsubscribe_RealtimeUAVStatus operation  8.2.3.4 Notify_RealtimeUAVStatus operation  8.2.4 UAE_ChangeUSSManagement API  8.2.4.1 General  8.2.4.2 Manage_USSManagement operation  8.2.4.3 Notify_USSManagementComplete operation  8.2.4.4 Manage_USSChange operation  8.2.4.5 Notify_USSChange operation  8.2.4.6 Notify_USSChangeTrigger 
...

 

8  APIs  p. 92

8.1  General  p. 92

The following UAE capabilities are offered as APIs:
  • UAE server APIs;
The following SEAL service APIs are specified in TS 23.434:
  • Group management server APIs;
  • Location management server APIs;
  • Configuration management server APIs;
  • Identity management server APIs; and
  • Key management server APIs.
The following SEAL service APIs are specified in TS 23.435:
  • Network slice optimization APIs based on VAL server policy.
When UAS application specific server invokes a SEAL server API directly, the UAS application specific server acting as VAL server shall interact with the corresponding SEAL server over the SEAL-S reference point for the API invocation request and response as specified in TS 23.434.
Requesting specific QoS per planned flight path/waypoint is available using Policy of needed minimum QoS per UE in the SS_NSCE_PolicyManagement API, see clause 9.5.4.1 of TS 23.435.
Up

8.2  UAE server APIs  p. 92

8.2.1  General  p. 92

Table 8.2.1-1 illustrates the UAE server APIs.
API Name API Operations Known Consumer(s) Communication Type
UAE_C2OperationModeManagement APIManage_C2OperationModeUAS application specific serverRequest/ Response
Notify_SelectedC2Mode (NOTE 1)UAS application specific serverSubscribe/notify
Notify_C2ModeSwitching (NOTE 1)UAS application specific serverSubscribe/notify
Notify_C2OperationModeManagementComplete (NOTE 1)UAS application specific serverSubscribe/notify
UAE_RealtimeUAVStatus APISubscribe_RealtimeUAVStatusUAS application specific serverSubscribe/notify
Unsubscribe_RealtimeUAVStatusUAS application specific serverSubscribe/notify
Notify_RealtimeUAVStatusUAS application specific serverSubscribe/notify
UAE_ChangeUSSManagement APIManage_USSManagementUAS application specific serverRequest/ Response
Notify_USSManagementCompleteUAS application specific serverSubscribe/notify
Manage_USSChangeUAS application specific serverRequest/ Response
Notify_USSChangeUAS application specific serverSubscribe/notify
Notify_USSChangeTriggerUAS application specific serverSubscribe/notify
UAE_DAASupport APIManage_DAAManagementUAS application specific serverRequest/ Response
Notify_DAAManagementCompleteUAS application specific serverSubscribe/notify
Notify_DAAClientSupportEventUAS application specific serverSubscribe/notify
Manage_DAAServerSupportEventUAS application specific serverRequest/ Response
UAE_UAVDynamicInfo APISubscribe_UAVDynamicInfoUAS application specific serverSubscribe/ notify
Unsubscribe_UAVDynamicInfoUAS application specific serverSubscribe/ notify
Notify_UAVDynamicInfoUAS application specific serverSubscribe/ notify
UAE_FlightPathMonitoring APIManage_FlightPathReportingConfigurationUAS application specific serverRequest/ Response
Notify_FlightPathReportingConfigurationCompleteUAS application specific serverSubscribe/notify
Notify_FlightPathEventReportUAS application specific serverSubscribe/notify
UAE_FlightRouteSupport APIManage_QoSFlightRoutePlanUAS application specific server, UAE clientRequest/ Response
Manage_NTZUAS application specific serverRequest/response
Notify_NTZManagementComplete (NOTE 2)UAS application specific serverSubscribe/notify
Configure_NTZUAE serverRequest/response
Notify_NTZ (NOTE 3)UAE server, UAS application specific serverSubscribe/notify
SSUAE_NTZenforce APIEnforce_NTZUAE serverRequest/response
UAE_newNTZpolicy APINewPolicy_NTZUAE clientRequest/response
NOTE 1:
The subscribe operation for Notify_C2OperationModeManagementComplete, Notify_SelectedC2Mode and Notify_C2ModeSwitching is part of Manage_C2OperationMode.
NOTE 2:
The subscribe operation for Notify_NTZManagementComplete is part of Manage_NTZ.
NOTE 3:
The subscribe operation for Notify_NTZ is part of Configure_NTZ.
Up

8.2.2  UAE_C2OperationModeManagement API  p. 93

8.2.2.1  General  p. 93

API description:
This API enables the UAS application specific server to communicate with the UAE server to send configurations for C2 operation modes for the UAS and receive notifications of the selected C2 communication modes from the UAS UEs (i.e. UAV, UAV-C).

8.2.2.2  Manage_C2OperationMode operation  p. 93

API operation name:
Manage_C2OperationMode
Description:
Manage (initiate, change or delete) the configuration of the C2 operation modes for the UAS UEs.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.4.3.1.
Outputs:
Refer clause 7.4.3.2.
See clause 7.4.2.1 for the details of usage of this API operation.

8.2.2.3  Notify_SelectedC2Mode  p. 94

API operation name:
Notify_SelectedC2Mode
Description:
Notification of the selected C2 communication modes from the UAS UEs.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.4.3.10.
Outputs:
Refer clause 7.4.3.11.
See clause 7.4.2.3 for the details of usage of this API operation.

8.2.2.4  Notify_C2ModeSwitching  p. 94

API operation name:
Notify_C2ModeSwitching
Description:
Notification of the C2 communication mode switching from the UAS UEs.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.4.3.5.
Outputs:
Refer clause 7.4.3.6.
See clause 7.4.2.4 for the details of usage of this API operation.

8.2.2.5  Notify_C2OperationModeManagementComplete  p. 94

API operation name:
Notify_C2OperationModeManagementComplete
Description:
Notification about the C2 operation mode management completion by UAE server.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.4.3.3.
Outputs:
None.
See clause 7.4.2.1 for the details of usage of this API operation.

8.2.3  UAE_ RealtimeUAVStatus API  p. 94

8.2.3.1  General  p. 94

API description:
This API enables the UAS application specific server to subscribe for and receive notifications for the realtime status information of the UAV.

8.2.3.2  Subscribe_RealtimeUAVStatus operation  p. 94

API operation name:
Subscribe_RealtimeUAVStatus
Description:
Subscription for obtaining the realtime UAV status information.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.5.3.2.
Outputs:
Refer clause 7.5.3.3.
See clause 7.5.2.2 for the details of usage of this API operation.

8.2.3.3  Unsubscribe_RealtimeUAVStatus operation  p. 95

API operation name:
Unsubscribe_RealtimeUAVStatus
Description:
Unsubscription for a existing subscription for obtaining the realtime UAV status information.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.5.3.5.
Outputs:
Refer clause 7.5.3.6.
See clause 7.5.2.4 for the details of usage of this API operation.

8.2.3.4  Notify_RealtimeUAVStatus operation  p. 95

API operation name:
Notify_RealtimeUAVStatus
Description:
Notification of the realtime UAV status information.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.5.3.4.
Outputs:
None.
See clause 7.5.2.3 for the details of usage of this API operation.

8.2.4  UAE_ChangeUSSManagement API |R18|  p. 95

8.2.4.1  General  p. 95

API description:
This API enables the UAS application specific server to communicate with the UAE server to send policies, requests for change of USS for the UAS and receive notifications from the UAS UEs (i.e. UAV) about change of USS.

8.2.4.2  Manage_USSManagement operation  p. 95

API operation name:
Manage_USSManagement
Description:
Manage (initiate, change or delete) the configuration of the policies for change of USS for the UAS UEs.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.6.3.1.
Outputs:
Refer clause 7.6.3.2.
See clause 7.6.2.1 for the details of usage of this API operation.

8.2.4.3  Notify_USSManagementComplete operation  p. 95

API operation name:
Notify_USSManagementComplete
Description:
Notification about the USS management completion by UAE server.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.6.3.3.
Outputs:
None.
See clause 7.6.2.1 for the details of usage of this API operation.

8.2.4.4  Manage_USSChange operation  p. 96

API operation name:
Manage_USSChange
Description:
Manage change of USS on request from UAS application specific server.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.6.3.6.
Outputs:
Refer clause 7.6.3.7.
See clause 7.6.2.3 for the details of usage of this API operation.

8.2.4.5  Notify_USSChange operation  p. 96

API operation name:
Notify_USSChange
Description:
Notification about the change of USS required by UAS UE.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.6.3.8.
Outputs:
None.
See clause 7.6.2.4 for the details of usage of this API operation.

8.2.4.6  Notify_USSChangeTrigger  p. 96

API operation name:
Notify_USSChangeTrigger
Description:
Notify a trigger event related to the recommended change of USS.
Known Consumers:
UAS application specific server.
Inputs:
Refer clause 7.6.3.9.
Outputs:
None.
See clause 7.6.2.5 for the details of usage of this API operation.

Up   Top   ToC