Commit 0376ff1d authored by Jesus de Gregorio's avatar Jesus de Gregorio
Browse files

CT#107

parent ff478faf
Loading
Loading
Loading
Loading
+43 −6
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0

info:
  title: LMS_LocationInformation
  version: 1.0.0-alpha.1
  version: 1.0.0-alpha.2
  description: |
    API for Requesting and subscribing on Location Information from LMS Service.  
    © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
    All rights reserved.

externalDocs:
  description: 3GPP TS 24.283 V0.4.0; Mission Critical Location Management (MCLoc).
  description: 3GPP TS 24.283 V0.5.0; Mission Critical Location Management (MCLoc).
  url: http://www.3gpp.org/ftp/Specs/archive/24_series/24.283/

servers:
@@ -131,7 +131,7 @@ components:
          items:
            type: string
            format: uri
            description: A list of activated Functiona Alias Id of requested MC Users.
            description: A list of activated Functional Alias Id of requested MC Users.
        mcServiceIds:
          type: array
          items:
@@ -139,17 +139,54 @@ components:
            format: uri
            description: A list of MC service IDs of the MC users for which 
              location information is requested MC Users.
        refresh:
          type: boolean
          nullable: true
          description: The presence of this attribute indicates that the 
            location report shall be refreshed immediately.
      anyOf:
        - required: [functionalAliasIds]
        - required: [mcServiceIds]


    MCUserLocation:
      description: Represents one MC User's device location information.
      type: object
      properties:
        mcServiceIds:
          type: array
          items:
            type: string
            format: uri
            description: A list of MC service IDs of the MC user for which 
              location information is reported.
        functionalAliasIds:
          type: array
          items:
            type: string
            format: uri
            description: A list of activated Functional Alias Id of the MC user
              for which location information is reported.
        mcServiceUELabel:
          type: string
          description: Used to identify the reporting MC UE for the end user, this may be used
            when multiple MC UEs are reporting by the same MC service user.
        locationInfo:
          $ref: 'TS24283_Lms_LocationReport.yaml#/components/schemas/LocationInfo'
    LocationNotification:
      description: Represents an location notification response, Content of this object is FFS
      description: Represents an location notification response.
      type: object
      properties:
        mcUEResponseList:
          type: array
          items:
            $ref: 'TS24283_Lms_LocationReport.yaml#/components/schemas/MCUELocation'
          description: Content of this object is FFS
            $ref: '#/components/schemas/MCUserLocation'
        requestingMcServiceId:
          type: string
          format: uri
          description: The MC service ID of the LMC that requested the location report.
        requestingfunctionalAliasId:
          type: string
          format: uri
          description: The activated Functional Alias Id of the LMC that requested
            the location report.
+12 −52
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0

info:
  title: LMS_LocationReport
  version: 1.0.0-alpha.2
  version: 1.0.0-alpha.3
  description: |
    API for LocationReports to LMS Service.
    © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
    All rights reserved.

externalDocs:
  description: 3GPP TS 24.283 v0.4.0; Mission Critical Location Management (MCLoc).
  description: 3GPP TS 24.283 v0.5.0; Mission Critical Location Management (MCLoc).
  url: http://www.3gpp.org/ftp/Specs/archive/24_series/24.283/

servers:
@@ -116,8 +116,8 @@ components:
      description: object that includes coordinates typically obtained from GPS.
      type: object
      properties:
        coordinate:
          $ref: '#/components/schemas/Coordinate'
        currentCoordinate:
          $ref: '#/components/schemas/CurrentCoordinate'
        ecgi:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/Ecgi'
        mbmsSaiId:
@@ -140,71 +140,31 @@ components:
        nr5GMbsfsaArea:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/MbsFsaId'

    Coordinate:
    CurrentCoordinate:
      description: This object contains one specific location point, speed and bearing (e.g., 
        received from a GPS reciever).
      type: object
      properties:
        altitude:
          anyOf:
            - $ref: '#/components/schemas/TwoBytes'
            - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Altitude'
        bearingAndSpeed:
          anyOf:
            - $ref: '#/components/schemas/BearingAndSpeed'
        horizontalaccuracy:
          anyOf:
            - $ref: '#/components/schemas/OneByteUnsignedHalfRange'
        latitude:
            - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/HorizontalWithVerticalVelocity'
        geographicalCoordinate:
          anyOf:
            - $ref: '#/components/schemas/ThreeBytes'
        longitude:
            - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicalCoordinates'
        horizontalaccuracy:
          anyOf:
            - $ref: '#/components/schemas/ThreeBytes'
            - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy'
        verticalaccuracy:
          anyOf:
            - $ref: '#/components/schemas/OneByteUnsignedHalfRange'
            - $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/Accuracy'

#
# Simple Types:
#

    BearingAndSpeed:
      description: This object contains an optional attribute consisting of a 7 bytelong string of
        14 hexadecimal digits which encode the binary content of the bearing, horizontal velocity
        and vertical velocity, as well as horizontal and vertical speed uncertainties of the
        MC UE, according to clause 8.15 of 3GPP TS 23.032 [3], where the spare bits are set to 0.
        bearing and speed coded as in clause 8.15 in 3GPP TS 23.032
      type: object
      properties:
        bearingAndSpeed:
          type: string
          pattern: '^[A-Fa-f0-9]{14}$'
    OneByteUnsignedHalfRange:
      description: This object contains location accuracy coded as in clause 6.2 in 3GPP TS 23.032
      type: object
      properties:
        oneByteUnsignedHalfRange:
          type: integer
          minimum: 0
          maximum: 127
    ThreeBytes:
      description: This object contains one specific location point, in a three byte format
        according to TS 23.032 clause 6.1
      type: object
      properties:
        threeBytes:
          type: integer
          minimum: 0
          maximum: 16777215
    TwoBytes:
      description: This object contains one specific altitude, in a two byte format
        according to TS 23.032 clause 6.3
      type: object
      properties:
        twoBytes:
          type: integer
          minimum: -32768
          maximum: 32767

#
# Enumeration data types
+217 −10
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0

info:
  title: LMS_Registration
  version: 1.0.0-alpha.2
  version: 1.0.0-alpha.3
  description: |
    API for Registration to LMS Service.  
    © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
    All rights reserved.

externalDocs:
  description: 3GPP TS 24.283 V0.4.0; Mission Critical Location Management (MCLoc).
  description: 3GPP TS 24.283 V0.5.0; Mission Critical Location Management (MCLoc).
  url: http://www.3gpp.org/ftp/Specs/archive/24_series/24.283/

servers:
@@ -288,6 +288,14 @@ components:
          $ref: '#/components/schemas/TriggeringCriteria'
        nonEmergencyLocationInformation:
          $ref: '#/components/schemas/RequestedLocationInfo'
        mcServiceId:
          type: string
          format: Uri
          description: Optional attribute that is used to indicate the identity of the 
            MC user requesting to set the location configuration. 
        configScope:
          $ref: '#/components/schemas/ConfigScope'




@@ -296,6 +304,8 @@ components:
        MC UE is in emergency state.
      type: object
      properties:
        adaptiveTrigger:
          $ref: '#/components/schemas/AdaptiveTrigger'
        cellChange:
          $ref: '#/components/schemas/CellChange'
        geographicalAreaChange:
@@ -310,12 +320,73 @@ components:
          $ref: '#/components/schemas/PeriodicReport'
        plmnChange:
          $ref: '#/components/schemas/PlmnChange'
        ratTypeChange:
          $ref: '#/components/schemas/RatTypeChange'
        signallingEvent:
          $ref: '#/components/schemas/SignallingEvent'
        trackingAreaChange:
          $ref: '#/components/schemas/TrackingAreaChange'
        travelledDistance:
          $ref: '#/components/schemas/TravelledDistance'

# Editor’s note: AdaptiveTriggger, FA activation, Signaling event and RATType change is FFS

    AdaptiveTrigger:
      description: This attribute specifies parameters controlling adaptive combined time
        and distance triggers for location reporting.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'
        minPeriod:
          type: integer
          description: An optional attribute specified as a positive or 0 integer number
            of seconds and defaulting at 0, if not present. This attribute specifies the minimum
            wait period between consecutive location reports, irrespective of changes in the
            distance between the current location and the location of the most recent sending of a
            location report.
        minDistance:
         type: integer
         description: An optional attribute specified as a strictly positive integer number of
           meters and defaulting at infinity, if not present. This attribute is used in the
           decision of sending a location report based on travelled distance, and specifies the
           minimum required distance, between the current location and the location of the most
           recent sending of a location report.
        persistencePeriod:
          type: integer
          description: An optional attribute specified as a positive or 0 integer number of
            seconds and defaulting at 0, if not present. This attribute specifies the time between
            the moment when the LMC detected that the distance between the current location and
            the location of the most recent sending of a location report exceeded the minDistance
            attribute and the moment when the LMC will check again that the updated current
            location is still farther away by at least minDistance from the location of the
            mentioned sending of the location report. If the check is positive, a location report
            based on travelled distance will be sent.
        additionalTime:
          type: integer
          description: An optional attribute, specified as a strictly positive integer number of
            seconds and defaulting at 1. If a location report is not sent based on the travelled
            distance, the LMC will send a location report after minPeriod + PersistencePeriod
            + AdditionalTime seconds after the previous location report.
        rrcInactiveMinPeriod:
          type: integer
          description: An optional attribute with the same semantics and behaviour as described
            above for the corresponding parameter, but applicable when the UE receives MBS traffic
            in RRC_INACTIVE state.
        rrcInactiveMinDistance:
          type: integer
          description: An optional attribute with the same semantics and behaviour as described
            above for the corresponding parameter, but applicable when the UE receives MBS traffic
            in RRC_INACTIVE state.
        rrcInactivePersistencePeriod:
          type: integer
          description: An optional attribute with the same semantics and behaviour as described
            above for the corresponding parameter, but applicable when the UE receives MBS traffic
            in RRC_INACTIVE state.
        rrcInactiveadditionalTime:
          type: integer
          description: An optional attribute with the same semantics and behaviour as described
            above for the corresponding parameter, but applicable when the UE receives MBS traffic
            in RRC_INACTIVE state.


    CellChange:
@@ -390,14 +461,31 @@ components:
      type: object
      properties:
        anyAreaChange:
          type: string
          $ref: '#/components/schemas/AnyAreaChange'
        enterSpecifcArea:
          type: string
          $ref: '#/components/schemas/SpecificArea'
        exitSpecifcArea:
          type: string
## The definition of this object is FFS.
          $ref: '#/components/schemas/SpecificArea'


    AnyAreaChange:
      description: The presence of this attribute specifies that any area change
        is a trigger for location reporting.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'

    SpecificArea:
      description: A geographical area which triggers location reporting when 
        entering or exiting the defined geographical area.
      type: object
      properties:
        geoAreas:
          type: array
          items:
            $ref: 'TS29572_Nlmf_Location.yaml#/components/schemas/GeographicArea'


    MbsfnAreaChange:
      description: The attribute specifies which MBSFN area changes trigger
@@ -585,6 +673,90 @@ components:



    RatTypeChange:
      description: An optional attribute specifying what inter-RAT changes triggers
        a location report.
      type: object
      properties:
        anyRatTypeChange:
          $ref: '#/components/schemas/AnyRatTypeChange'

    AnyRatTypeChange:
      description: This attribute specifies that any inter-RAT change triggers a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'



    SignallingEvent:
      description: An optional attribute specifying what signalling events triggers
        a location report.
      type: object
      properties:
        functionalAliasActivation:
          $ref: '#/components/schemas/FunctionalAliasActivation'
        functionalAliasDeactivation:
          $ref: '#/components/schemas/FunctionalAliasDeactivation'
        initialLogOn:
          $ref: '#/components/schemas/InitialLogOn'
        groupCallNonEmergency:
          $ref: '#/components/schemas/GroupCallNonEmergency'
        privateCallNonEmergency:
          $ref: '#/components/schemas/PrivateCallNonEmergency'
        locationConfigurationReceived:
          $ref: '#/components/schemas/LocationConfigurationReceived'

    FunctionalAliasActivation:
      description: This attribute specifies that a functional alias activation 
        triggers a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'

    FunctionalAliasDeactivation:
      description: This attribute specifies that a functional Alias deactivation 
        triggers a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'

    InitialLogOn:
      description: This attribute specifies that an initial log on triggers a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'

    GroupCallNonEmergency:
      description: This attribute specifies that a non-emergency group call triggers
        a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'

    PrivateCallNonEmergency:
      description: This attribute specifies that a non-emergency private call triggers
        a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'

    LocationConfigurationReceived:
      description: This attribute specifies that a received location configuration triggers
        a location report.
      type: object
      properties:
        triggerId:
          $ref: '#/components/schemas/TriggerId'



    TrackingAreaChange:
      description: The attribute specifies which tracking area changes trigger 
        location reporting.
@@ -705,9 +877,44 @@ components:


    LocationRequest:
      description: Represents an location configuraion objects used by LMC.
      description: Represents an location request object used by LMS to
        request a location report from an LMC.
      type: object
      properties:
        requestObject:
        requestedMcServiceId:
          type: string
          format: uri
          description: The MC service ID of the MC user being requested to send a
            location report.
        requestingMcServiceId:
          type: string
          format: uri
          description: The MC service ID of the MC user from which location information
            is being requested.
        requestedFunctionalAliasId:
          type: string
          format: uri
          description: The activated functional alias ID of the MC user being requested
            to send a location report.
        requestingFunctionalAliasId:
          type: string
          description: Content of this object is FFS
          format: uri
          description: The activated functional alias ID of the MC user from which location
            information is being requested.
        requestedLocationInfo:
          $ref: '#/components/schemas/RequestedLocationInfo'



    ConfigScope:
      description: Indicates if the location configuration shall be updated fully and replace
        existing configration, or if the location configuration is added to the exsting.
      anyOf:
        - type: string
          enum: 
            - FULL
            - UPDATE
        - type: string
          description: This string provides forward-compatibility with future extensions to the
            enumeration and is not used to encode content defined in the present version
            of this API.
+7 −4
Original line number Diff line number Diff line
@@ -2,14 +2,14 @@ openapi: 3.0.0

info:
  title: Eecs_ServiceProvisioning
  version: "1.2.0-alpha.1"
  version: "1.2.0-alpha.2"
  description: |
    API for ECS Service Provisioning.  
    © 2023, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
    © 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
    All rights reserved.

externalDocs:
  description: 3GPP TS 24.558 V19.1.0 Enabling Edge Applications; Protocol specification.
  description: 3GPP TS 24.558 V19.2.0 Enabling Edge Applications; Protocol specification.
  url: https://www.3gpp.org/ftp/Specs/archive/24_series/24.558/

security:
@@ -362,6 +362,9 @@ components:
          description: Indicates to the ECS which EES providers are preferred by the EEC.
        predictExpTime:
          $ref: 'TS29122_CommonData.yaml#/components/schemas/DateTime'
        satelliteId:
          type: string
          description: Represents the satellite identifier serving UE in current location.
        suppFeat:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      required:
@@ -435,7 +438,7 @@ components:
            Indicates to the ECS, whether the application triggering is required by the EEC.
            Default value false indicates the application triggering is not required.
        eecTriggerPortInfo:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/Uinteger'
          $ref: 'TS29122_CommonData.yaml#/components/schemas/Port'
        suppFeat:
          $ref: 'TS29571_CommonData.yaml#/components/schemas/SupportedFeatures'
      required:
+3 −3
Original line number Diff line number Diff line
openapi: 3.0.0
info:
  title: Eees Application Context Relocation Service
  version: "1.2.0-alpha.1"
  version: "1.2.0-alpha.2"
  description: |
    Eees Application Context Relocation Service.  
    © 2024, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
    © 2025, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).  
    All rights reserved.

externalDocs:
  description: >
    3GPP TS 24.558 V19.1.0; Enabling Edge Applications; Protocol specification; Stage 3.
    3GPP TS 24.558 V19.2.0; Enabling Edge Applications; Protocol specification; Stage 3.
  url: 'https://www.3gpp.org/ftp/Specs/archive/29_series/24.558/'

servers:
Loading