Merge branch 'stf593' into 'develop'

Final draft

See merge request !1

.jenkins.sh

+#!/bin/bash
+
+specfiles=$(ls | egrep "^[^.]*.(json|yaml)")
+
+fres=0
+for i in $specfiles ; do
+    echo "-- Validating and linting OpenAPI file $i..."
+    swagger-cli validate $i
+    res=$?
+    speccy lint "$i"
+    res2=$?
+    fres=$(($fres||$res||$res2))
+    echo "--- Validator returned $res, linter returned $res2."
+done
+
+echo "-- Final validator returns $fres."
+exit $fres
+

README.md

@@ -2,7 +2,18 @@
 
 This repository contains OpenAPIs descriptions for the interfaces specified in ETSI GS MEC 030.
 
+
+## Online resources
+
+* [Specification document](https://www.etsi.org/deliver/etsi_gs/MEC/001_099/030/02.01.01_60/gs_MEC030v020101p.pdf)
+* [Navigate the V2X Information Service API in the browser](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/mec/gs030-vis-api/raw/stf593/MEC030_V2XInformationService.yaml).
+* [Edit the V2X Information Service API online](https://forge.etsi.org/swagger/editor/?url=https://forge.etsi.org/rep/mec/gs030-vis-api/raw/stf593/MEC030_V2XInformationService.yaml).
+
+
 ## License 
 
 Unless specified otherwise, the content of this repository and the files contained are released under the BSD-3-Clause license.
 See the attached LICENSE file or visit https://forge.etsi.org/legal-matters.
+
+
+# Application package lifecycle and operation granting API

proto3/models/cell_id.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message CellId {
+
+  // E-UTRAN Cell Identity as a bit string (size (28)).
+  string cell_id = 1;
+
+}

proto3/models/earfcn.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message Earfcn {
+
+  // E-UTRA Absolute Radio Frequency Channel Number, range (0... 65535)
+  int32 earfcn = 1;
+
+}

proto3/models/ecgi.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/cell_id.proto";
+import public "models/plmn.proto";
+
+message Ecgi {
+
+  CellId cell_id = 1;
+
+  Plmn plmn = 2;
+
+}

proto3/models/fdd_info.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/earfcn.proto";
+import public "models/transmission_bandwidth.proto";
+
+message FddInfo {
+
+  Earfcn dl_earfcn = 1;
+
+  TransmissionBandwidth dl_transmission_bandwidth = 2;
+
+  Earfcn ul_earfcn = 3;
+
+  TransmissionBandwidth ul_transmission_bandwidth = 4;
+
+}

proto3/models/link_type.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message LinkType {
+
+  // The URI referring to the subscription.
+  string href = 1;
+
+}

proto3/models/location_info.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/ecgi.proto";
+import public "models/location_info_geo_area.proto";
+
+message LocationInfo {
+
+  Ecgi ecgi = 1;
+
+  LocationInfoGeoArea geo_area = 2;
+
+}

proto3/models/location_info_geo_area.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message LocationInfoGeoArea {
+
+  // Latitude (DATUM = WGS84) -90 to 90 in decimal degree format DDD.ddd
+  float latitude = 1;
+
+  // Longitude (DATUM = WGS84)-180 to 180 in decimal degree format DDD.ddd
+  float longitude = 2;
+
+}

proto3/models/msg_type.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message MsgType {
+enum TypeEnum {
+		MSG_TYPE_TYPE_ENUM_1 = 0;
+		MSG_TYPE_TYPE_ENUM_2 = 1;
+		MSG_TYPE_TYPE_ENUM_3 = 2;
+		MSG_TYPE_TYPE_ENUM_4 = 3;
+		MSG_TYPE_TYPE_ENUM_5 = 4;
+		MSG_TYPE_TYPE_ENUM_6 = 5;
+		MSG_TYPE_TYPE_ENUM_7 = 6;
+	}
+}
+

proto3/models/pc5_neighbour_cell_info.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/ecgi.proto";
+import public "models/plmn.proto";
+
+message Pc5NeighbourCellInfo {
+
+  Ecgi ecgi = 1;
+
+  Plmn plmn = 2;
+
+  // V2X sidelink communication configuration, as defined in ETSI TS 136 331 [i.11].
+  string si_v2x_config = 3;
+
+}

proto3/models/pc5_provisioning_info.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/pc5_provisioning_info_pro_info_pc5.proto";
+import public "models/time_stamp.proto";
+
+message Pc5ProvisioningInfo {
+
+  repeated Pc5ProvisioningInfoProInfoPc5 pro_info_pc5 = 1;
+
+  TimeStamp time_stamp = 2;
+
+}

proto3/models/pc5_provisioning_info_pro_info_pc5.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/location_info.proto";
+import public "models/pc5_neighbour_cell_info.proto";
+
+message Pc5ProvisioningInfoProInfoPc5 {
+
+  // For sidelink communication, the Destination Layer-2 ID is set to the ProSe Layer-2 Group ID or Prose UE ID, see ETSI TS 136 321 [i.12]. PLMN operators coordinate to make sure Destination Layer-2 ID(s) for different V2X services are configured in a consistent manner.
+  string dst_layer2_id = 1;
+
+  LocationInfo location_info = 2;
+
+  // The information of the neighbour cells in a visiting PLMN that support V2X communication over PC5.
+  repeated Pc5NeighbourCellInfo neighbour_cell_info = 3;
+
+}

proto3/models/plmn.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message Plmn {
+
+  // The Mobile Country Code part of PLMN Identity.
+  string mcc = 1;
+
+  // The Mobile Network Code part of PLMN Identity.
+  string mnc = 2;
+
+}

proto3/models/predicted_qos.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/predicted_qos_routes.proto";
+import public "models/time_stamp.proto";
+
+message PredictedQos {
+
+  TimeStamp time_granularity = 1;
+
+  // Granularity of visited location. Measured in meters
+  string location_granularity = 2;
+
+  repeated PredictedQosRoutes routes = 3;
+
+}

proto3/models/predicted_qos_routes.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/predicted_qos_routes_route_info.proto";
+
+message PredictedQosRoutes {
+
+  // Information relating to a specific route. The first structure shall relate to the route origin and the last to the route destination. Intermediate waypoint locations may also be provided. 
+  repeated PredictedQosRoutesRouteInfo routeinfo = 1;
+
+}

proto3/models/predicted_qos_routes_route_info.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/location_info.proto";
+import public "models/time_stamp.proto";
+
+message PredictedQosRoutesRouteInfo {
+
+  LocationInfo location = 1;
+
+  TimeStamp time = 2;
+
+  // Reference Signal Received Quality as defined in ETSI TS 136 214 [i.13]. Shall only be included in the response
+  int32 rsrp = 3;
+
+  // Reference Signal Received Quality as defined in ETSI TS 136 214 [i.13]. Shall only be included in the response
+  int32 rsrq = 4;
+
+}

proto3/models/problem_details.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+
+message ProblemDetails {
+
+  // A human-readable explanation specific to this occurrence of the problem
+  string detail = 1;
+
+  // A URI reference that identifies the specific occurrence of the problem
+  string instance = 2;
+
+  // The HTTP status code for this occurrence of the problem
+  int32 status = 3;
+
+  // A short, human-readable summary of the problem type
+  string title = 4;
+
+  // A URI reference according to IETF RFC 3986 that identifies the problem type
+  string type = 5;
+
+}

proto3/models/prov_chg_pc5_notification.proto

+/*
+  ETSI GS MEC 030 V2X Information Service API
+ 
+  ETSI GS MEC 030 V2X Information Service API described using OpenAPI.
+ 
+  The version of the OpenAPI document: 2.1.1
+  Contact: cti_support@etsi.org
+  Generated by OpenAPI Generator: https://openapi-generator.tech
+*/
+
+syntax = "proto3";
+
+package mec030;
+
+import public "models/location_info.proto";
+import public "models/pc5_neighbour_cell_info.proto";
+import public "models/time_stamp.proto";
+
+message ProvChgPc5Notification {
+
+  // For sidelink communication, the Destination Layer-2 ID is set to the ProSe Layer-2 Group ID or Prose UE ID, see ETSI TS 136 321 [i.12].
+  string dst_layer2_id = 1;
+
+  LocationInfo location_info = 2;
+
+  // The information of the neighbour cells in a visiting PLMN that support V2X communication over PC5.
+  repeated Pc5NeighbourCellInfo neighbour_cell_info = 3;
+
+  // Shall be set to \"ProvChgPc5Notification\".
+  string notification_type = 4;
+
+  TimeStamp time_stamp = 5;
+
+}