ITS-Container.asn

/**
 * World Manufacturer Identifier (WMI). The values are assigned according to ISO 3779 [i.7].
 * 
 * The DE is used in @ref VehicleIdentification DF as defined in clause A.130.
 *
 * @category: Vehicle information
 */
WMInumber ::= IA5String (SIZE(1..3))

/**
 * Encoded value of the sub cause codes of the event type `wrongWayDriving` as defined in clause A.10.
 * Definition of the sub event cause is defined and the value is assigned according
 * to clause 7.1.4 of ETSI EN 302 637-3 [i.3].
 * 
 * The sub causes are described as following:
 * - 0 `unavailable`: in case further detailed information on wrong way driving event is unavailable,
 * - 1 `wrongLane`: in case vehicle is driving on a lane for which it has no authorization to use,
 * - 2 `wrongDirection`: in case vehicle is driving in a direction that it is not allowed,
 * - 3-255 reserved for future usage.
 * 
 * @category: Traffic information
 */
WrongWayDrivingSubCauseCode ::= INTEGER {unavailable(0), wrongLane(1), wrongDirection(2)} (0..255)

/**
 * DE that denotes the absolute accuracy range for reported yaw rate value for a predefined confidence level (e.g. 95 %).
 * The required confidence level is defined by the station applying this DE.
 * 
 * The value shall be set to:
 * - 0 if the accuracy is equal to or less than 0,01 degree/second
 * - 1 if the accuracy is equal to or less than 0,05 degrees/second
 * - 2 if the accuracy is equal to or less than 0,1 degree/second
 * - 3 if the accuracy is equal to or less than 1 degree/second
 * - 4 if the accuracy is equal to or less than 5 degrees/second
 * - 5 if the accuracy is equal to or less than 10 degrees/second
 * - 6 if the accuracy is equal to or less than 100 degrees/second
 * - 7 if the accuracy is out of range, i.e. greater than 100 degrees/second
 * - 8 if the accuracy information is unavailable
 * 
 * The DE is used in @ref YawRate DF as defined in clause A.132.
 * 
 * NOTE:	The fact that a yaw rate value is received with confidence set to `unavailable(8)` can be caused by
 * several reasons, such as:
 * - the sensor cannot deliver the accuracy at the defined confidence level because it is a low-end sensor,
 * - the sensor cannot calculate the accuracy due to lack of variables, or
 * - there has been a vehicle bus (e.g. CAN bus) error.
 * In all 3 cases above, the reported yaw rate value may be valid and used by the application.
 * 
 * If a yaw rate value is received and its confidence is set to `outOfRange(7)`, it means that the reported
 * yaw rate value is not valid and therefore cannot be trusted. Such value is not useful the application.
 * 
 * @category: Traffic information
 */
YawRateConfidence ::= ENUMERATED {
    degSec-000-01 (0),
    degSec-000-05 (1),
    degSec-000-10 (2),
    degSec-001-00 (3),
    degSec-005-00 (4),
    degSec-010-00 (5),
    degSec-100-00 (6),
    outOfRange (7),
    unavailable (8)
}

/**
 * It denotes the vehicle rotation around z-axis of coordinate system centred on the centre of mass of the empty-loaded
 * vehicle. It corresponds to the vehicle coordinate system as specified in ISO 8855 [2].
 * - The leading sign denotes the direction of rotation.
 * - Positive values indicate that the rotation is anti-clockwise (i.e. to the left).
 * - The value shall be set to `32 766` if the yaw rate is equal to or greater than 327.66 degrees/second to the left.
 * - Negative values indicate that the rotation is clockwise (i.e. to the right).
 * - The value shall be set to `-32 766` if the yaw rate is equal to or greater than 327,66 degrees/second to the right.
 * - The value shall be set to `32 767` if the information is not available.
 * 
 * The yaw rate value shall be a raw data value, i.e. not filtered, smoothed or otherwise modified.
 * The reading instant should be the same as for the vehicle acceleration.
 * 
 * The DE is used in @ref YawRate DF as defined in clause A.132.
 * 
 * @note: The empty load vehicle is defined in ISO 1176 [i.9], clause 4.6.
 * 
 * @unit: 0,01 degree per second. 
 * 
 * @category: Vehicle Information
*/
YawRateValue ::= INTEGER {straight(0), degSec-000-01ToRight(-1), degSec-000-01ToLeft(1), unavailable(32767)} (-32766..32767)

----------------------------------------
-- Specification of CDD Data Frames:
----------------------------------------

/** 
 * This DF represents general Data Frame to describe an acceleration component along with a confidence with a predefined confidence level of 95% for the component.
 *
 * @details value: the acceleration value which can be estimated as the mean of the current distribution.
 *
 * @details value confidence: the accuracy associated to the provided value at a predefined confidence level of 95% for the component.
 *
 * @category: Kinematic Information
 * Revision: Created in V2.1.1
 */
Acceleration1d ::= SEQUENCE {
    value       AccelerationValue,
    confidence  AccelerationConfidence
}

/** 
 * This DF represents information associated to changes in acceleration. 
 *
 * @details accelOrDecel: the indication of an acceleration change.
 *
 * @details value actionDeltaTime: the period in which the acceleration change action is performed.
 *
 * @category: Kinematic Information
 * Revision: Created in V2.1.1
 */
AccelerationChangeIndication ::= SEQUENCE {
    accelOrDecel    AccelerationChange,
    actionDeltaTime DeltaTimeTenthOfSecond,
    ...
}

/**
 * This DF represents an identifier used to describe a protocol action taken by an ITS-S.
 * 
 * 
 * @field originatingStationID: ID of the ITS-S that takes the action. 
 * 
 * @field sequenceNumber: a sequence number. 
 * 
 * @category: Communication information
 * Revision: V1.3.1
 */
ActionID ::= SEQUENCE {
    originatingStationID StationID,
    sequenceNumber SequenceNumber
}

/**
 * This DF provides the altitude and accuracy of an altitude information in a WGS84 co-ordinate system.
 *
 * @field altitudeValue: altitude of a geographical point.
 *
 * @field altitudeConfidence: accuracy of the reported altitudeValue within a specific confidence level.
 *
 * @category: GeoReference information
 * Revision: V1.3.1
 */
Altitude ::= SEQUENCE {
    altitudeValue AltitudeValue,
    altitudeConfidence AltitudeConfidence
}

/**
 * This DF provides the definition of a geographical area, based on different options.
 *
 * @field rectangle: definition of an area of rectangular shape.
 *
 * @field circle: definition of an area of cicrular shape.
 *
 * @field polygon: definition of an area of polygonal shape.
 *
 * @field ellipse: definition of an area of ellipse shape.
 *
 * @category: GeoReference information
 * Revision: Created in V2.1.1
 */

Area::= CHOICE {
   rectangle        RectangularArea,
   circle           CircularArea, 
   polygon          PolygonalArea,
   ellipse          EllipticalArea,
   radial           RadialArea,
  -- radialVehicle    
   ...
}

/** 
 * This DE represents a general container for usage in various types of messages.
 *
 * @details stationType: The type of station that has generated the message that contains the basic container.
 *
 * @details referencePosition: the reference position of the station that has generated the message that contains the basic container.
 *
 * @category: Basic information
 * Revision: Created in V2.1.1
*/
BasicContainer ::= SEQUENCE {
	stationType StationType,
	referencePosition ReferencePosition,
	...
}

/** 
 * This DF represents a general Data Frame to describe an angle component along with a confidence with a predefined
 * confidence level of 95% for the component in a Cartesian coordinate system.
 *
 * @details value: The angle value which can be estimated as the mean of the current distribution.
 *
 * @details confidence: The accuracy associated to the provided value at a predefined confidence level of 95% for the component.
 *
 * @category: Kinematics information
 * Revision: Created in V2.1.1
 */
CartesianAngle ::= SEQUENCE {
    value       CartesianAngleValue,
    confidence  AngleConfidence
}

/** 
 * This DF represents a general Data Frame to describe an angular speed component along with a confidence with a predefined
 * confidence level of 95% for the component in a Cartesian coordinate system.
 *
 * @details value: The angular speed (rate) value which can be estimated as the mean of the current distribution.
 *
 * @details confidence: The accuracy associated to the provided value at a predefined confidence level of 95% for the component.
 *
 * @category: Kinematics information
 * Revision: Created in V2.1.1
 */
CartesianAngularSpeed ::= SEQUENCE {
    value       CartesianAngularSpeedValue,
    confidence  AngularSpeedConfidence
}

/** 
 * This DF represents a general Data Frame to describe an angular acceleration component along with a confidence with a predefined
 * confidence level of 95% for the component in a Cartesian coordinate system.
 *
 * @details value: The angular acceleration value which can be estimated as the mean of the current distribution.
 *
 * @details confidence: The accuracy associated to the provided value at a predefined confidence level of 95% for the component.
 * 
 * @category: Kinematics information
 * Revision: Created in V2.1.1 
 */
CartesianAngularAcceleration ::= SEQUENCE {
    value       CartesianAngularAccelerationValue,
    confidence  AngularAccelerationConfidence
}

/**
 * This DF is a representation of the cause code value of a traffic event. 
 *
 * @field causeCode: the main cause of a detected event. 
 *
 * @field subCauseCode: the subordinate cause of a detected event. 
 *
 * The semantics of the entire DF are completely defined by the component causeCode. 
 * The interpretation of the subCauseCode may provide additional information that is not strictly necessary to understand the causeCode itself, and is therefore optional.
 *
 * @category: Traffic information
 * Revision: Editorial update in V2.1.1
 */
CauseCode ::= SEQUENCE {
    causeCode CauseCodeType,
    subCauseCode SubCauseCodeType,
    ...
}

/**
 * This DF is an alternative representation of the cause code value of a traffic event. 
 *
 * @field causeCode: the main cause of a detected event. Each choice is of a different type and represents the sub cause code.
 *
 * The semantics of the entire DF are completely defined by the component causeCode. 
 * The interpretation of the subCauseCode may provide additional information that is not strictly necessary to understand the causeCode itself, and is therefore optional.
 *
 * @category: Traffic information
 * Revision: Created in V2.1.1
 */

CauseCodeV2 ::= SEQUENCE {
 causeCode CHOICE {
    reserved                                         SubCauseCodeType,
    trafficCondition                                 TrafficConditionSubCauseCode,
    accident                                         AccidentSubCauseCode,
    roadworks-3                                      RoadworksSubCauseCode,
    reserved4                                        SubCauseCodeType,
    impassability                                    SubCauseCodeType,
    adverseWeatherCondition-Adhesion                 AdverseWeatherCondition-AdhesionSubCauseCode,
    aquaplannning                                    SubCauseCodeType,
    reserved8                                        SubCauseCodeType,
    hazardousLocation-SurfaceCondition               HazardousLocation-SurfaceConditionSubCauseCode,
    hazardousLocation-ObstacleOnTheRoad              HazardousLocation-ObstacleOnTheRoadSubCauseCode,
    hazardousLocation-AnimalOnTheRoad                HazardousLocation-AnimalOnTheRoadSubCauseCode,
    humanPresenceOnTheRoad                           HumanPresenceOnTheRoadSubCauseCode,
    reserved13                                       SubCauseCodeType,
    wrongWayDriving                                  WrongWayDrivingSubCauseCode,
    rescueAndRecoveryWorkInProgress                  RescueAndRecoveryWorkInProgressSubCauseCode,
    reserved16                                       SubCauseCodeType,
    adverseWeatherCondition-ExtremeWeatherCondition  AdverseWeatherCondition-ExtremeWeatherConditionSubCauseCode,
    adverseWeatherCondition-Visibility               AdverseWeatherCondition-VisibilitySubCauseCode,
    adverseWeatherCondition-Precipitation            AdverseWeatherCondition-PrecipitationSubCauseCode,
    violence                                         SubCauseCodeType,
    reserved21                                       SubCauseCodeType,
    reserved22                                       SubCauseCodeType,
    reserved23                                       SubCauseCodeType,
    reserved24                                       SubCauseCodeType,
    reserved25                                       SubCauseCodeType,
    slowVehicle                                      SlowVehicleSubCauseCode,
    dangerousEndOfQueue                              DangerousEndOfQueueSubCauseCode,
    reserved28                                       SubCauseCodeType,
    reserved29                                       SubCauseCodeType,
    reserved30                                       SubCauseCodeType,
    reserved31                                       SubCauseCodeType,
    reserved32                                       SubCauseCodeType,
    reserved33                                       SubCauseCodeType,
    reserved34                                       SubCauseCodeType,
    reserved35                                       SubCauseCodeType,
    reserved36                                       SubCauseCodeType,
    reserved37                                       SubCauseCodeType,
    reserved38                                       SubCauseCodeType,
    reserved39                                       SubCauseCodeType,
    reserved40                                       SubCauseCodeType,
    reserved41                                       SubCauseCodeType,
    reserved42                                       SubCauseCodeType,
    reserved43                                       SubCauseCodeType,
    reserved44                                       SubCauseCodeType,
    reserved45                                       SubCauseCodeType,
    reserved46                                       SubCauseCodeType,
    reserved47                                       SubCauseCodeType,
    reserved48                                       SubCauseCodeType,
    reserved49                                       SubCauseCodeType,
    reserved50                                       SubCauseCodeType,
    reserved51                                       SubCauseCodeType,
    reserved52                                       SubCauseCodeType,
    reserved53                                       SubCauseCodeType,
    reserved54                                       SubCauseCodeType,
    reserved55                                       SubCauseCodeType,
    reserved56                                       SubCauseCodeType,
    reserved57                                       SubCauseCodeType,
    reserved58                                       SubCauseCodeType,   
    reserved59                                       SubCauseCodeType, 
    reserved60                                       SubCauseCodeType,
    reserved61                                       SubCauseCodeType,
    reserved62                                       SubCauseCodeType,
    reserved63                                       SubCauseCodeType,
    reserved64                                       SubCauseCodeType,
    reserved65                                       SubCauseCodeType,
    reserved66                                       SubCauseCodeType,    
    reserved67                                       SubCauseCodeType,
    reserved68                                       SubCauseCodeType,
    reserved69                                       SubCauseCodeType,
    reserved70                                       SubCauseCodeType,
    reserved71                                       SubCauseCodeType,
    reserved72                                       SubCauseCodeType,
    reserved73                                       SubCauseCodeType,
    reserved74                                       SubCauseCodeType,
    reserved75                                       SubCauseCodeType,
    reserved76                                       SubCauseCodeType,
    reserved77                                       SubCauseCodeType,
    reserved78                                       SubCauseCodeType,
    reserved79                                       SubCauseCodeType,
    reserved80                                       SubCauseCodeType,
    reserved81                                       SubCauseCodeType,
    reserved82                                       SubCauseCodeType,
    reserved83                                       SubCauseCodeType,
    reserved84                                       SubCauseCodeType,
    reserved85                                       SubCauseCodeType,
    reserved86                                       SubCauseCodeType,
    reserved87                                       SubCauseCodeType,
    reserved88                                       SubCauseCodeType,
    reserved89                                       SubCauseCodeType,
    reserved90                                       SubCauseCodeType,
    vehicleBreakdown                                 VehicleBreakdownSubCauseCode,
    postCrash                                        PostCrashSubCauseCode,
    humanProblem                                     HumanProblemSubCauseCode,
    stationaryVehicle                                StationaryVehicleSubCauseCode,
    emergencyVehicleApproaching                      EmergencyVehicleApproachingSubCauseCode,
    hazardousLocation-DangerousCurve                 HazardousLocation-DangerousCurveSubCauseCode,
    collisionRisk                                    CollisionRiskSubCauseCode,
    signalViolation                                  SignalViolationSubCauseCode,
    dangerousSituation                               DangerousSituationSubCauseCode,
    reserved100                                      SubCauseCodeType,
    reserved101                                      SubCauseCodeType,
    reserved102                                      SubCauseCodeType,
    reserved103                                      SubCauseCodeType,
    reserved104                                      SubCauseCodeType,
    reserved105                                      SubCauseCodeType,
    reserved106                                      SubCauseCodeType,
    reserved107                                      SubCauseCodeType,
    reserved108                                      SubCauseCodeType,
    reserved109                                      SubCauseCodeType,
    reserved110                                      SubCauseCodeType,
    reserved111                                      SubCauseCodeType,
    reserved112                                      SubCauseCodeType,
    reserved113                                      SubCauseCodeType,
    reserved114                                      SubCauseCodeType,
    reserved115                                      SubCauseCodeType,
    reserved116                                      SubCauseCodeType,
    reserved117                                      SubCauseCodeType,
    reserved118                                      SubCauseCodeType,
    reserved119                                      SubCauseCodeType,
    reserved120                                      SubCauseCodeType,
    reserved121                                      SubCauseCodeType,
    reserved122                                      SubCauseCodeType,
    reserved123                                      SubCauseCodeType,
    reserved124                                      SubCauseCodeType,
    reserved125                                      SubCauseCodeType,
    reserved126                                      SubCauseCodeType,
    reserved127                                      SubCauseCodeType,
    reserved128                                      SubCauseCodeType
  },
  ...
}

/**
 * The DF describes the position of a CEN DSRC road side equipment.
 * 
 * @field protectedZoneLatitude: the latitude of the CEN DSRC road side equipment.
 * 
 * @field protectedZoneLongitude: the latitude of the CEN DSRC road side equipment. 
 * 
 * @field cenDsrcTollingZoneID: the optional ID of the CEN DSRC road side equipment.
 * 
 * @category: Infrastructure information, Communication information
 * Revision: V1.3.1
 */
CenDsrcTollingZone ::= SEQUENCE {
    protectedZoneLatitude Latitude,
    protectedZoneLongitude Longitude,
    cenDsrcTollingZoneID CenDsrcTollingZoneID OPTIONAL,
        ...
}

/** 
 * 
 * This DF defines a circular area that is centred on a reference position defined outside of the context of this DF. 
 * 
 * @field centerPoint: optional offset point which the rectangle is centred on with respect to the reference position.
 *
 * @field radius: the radius of the circular area, using the DE StandardLength.
 * 
 * @category: GeoReference information
 * Revision: Created in V2.1.1
 */
CircularArea ::= SEQUENCE {
    nodeCenterPoint      CartesianPosition3d OPTIONAL,
    radius               StandardLength
}

/**
 * This DF indicates the opening/closure status of a lane or a set of lanes.
 * 
 * @field innerhardShoulderStatus: this information is optional and shall be included if the information is known.
 * It indicates the open/closing status of inner hard shoulder lanes. 
 * 
 * @field outerhardShoulderStatus: this information is optional and shall be included if the information is known.
 * It indicates the open/closing status of outer hard shoulder lanes. 
 * 
 * @field drivingLaneStatus: this information is optional and shall be included if the information is known.
 * It indicates the open/closing status of driving lanes. 
 * For roads with more than 13 driving lanes, the drivingLaneStatus DE shall not be set.
 * 
 * @category: GeoReference information, Road topology information
 * Revision: V1.3.1
 */
ClosedLanes ::= SEQUENCE {
    innerhardShoulderStatus HardShoulderStatus OPTIONAL,
    outerhardShoulderStatus HardShoulderStatus OPTIONAL,
    drivingLaneStatus DrivingLaneStatus OPTIONAL,
    ...
}

/**
 * The DF provides information about the breakup of a cluster.
 * 
 * @field clusterBreakupReason: indicates the reason for breakup.
 * 
 * @field breakupTime: indicates the time of breakup. 
 *
 * @category: Cluster Information
 * Revision: Created in V2.1.1
 */
ClusterBreakupInfo ::= SEQUENCE {
        clusterBreakupReason  ClusterBreakupReason,
        breakupTime           ClusterOpTimestamp,
        ...
}

/**
 * The DF provides information about the joining of a cluster.
 * 
 * @field clusterId: indicates the identifier of the cluster.
 * 
 * @field joinTime: indicates the time of joining. 
 *
 * @category: Cluster Information
 * Revision: Created in V2.1.1
 */
ClusterJoinInfo ::= SEQUENCE {
        clusterId       ClusterId,
        joinTime        ClusterOpTimestamp,
        ...
}

/**
 * The DF provides information about the leaving of a cluster.
 * 
 * @field clusterId: indicates the cluster.
 * 
 * @field clusterLeaveReason: indicates the reason for leaving. 
 *
 * @category: Cluster Information
 * Revision: Created in V2.1.1
 */
ClusterLeaveInfo ::= SEQUENCE {
        clusterId               ClusterId,
        clusterLeaveReason      ClusterLeaveReason,
        ...
}

/**
 * This DF represents the column of the lower triangular positive semi-definite matrix and consists of a list of correlation row values.
 * Given a matrix "A" of size n x n, the number of columns to be included in the lower triangular matrix is k=n-1.
 * Each column "i" of the lower triangular then contains k-(i-1) values, where "i" refers to the column number count
 * starting at 1 from the left.
 *
 * @category: Sensing Information
 * Revision: Created in V2.1.1
*/
CorrelationColumn ::= SEQUENCE SIZE (1..17) OF CorrelationRowValue  -- tbd extension to be defined?

/**
 * This DF represents the curvature of the vehicle trajectory and the accuracy.
 * The curvature detected by a vehicle represents the curvature of actual vehicle trajectory.
 * 
 * @field curvatureValue: Detected curvature of the vehicle trajectory.
 * 
 * @field curvatureConfidence: Accuracy of the reported curvature value with a predefined confidence level. 
 * 
 * @category: Vehicle information
 * Revision: V1.3.1
 */
Curvature ::= SEQUENCE {
 curvatureValue CurvatureValue,
 curvatureConfidence CurvatureConfidence
}

/**
 * This DF provides a description of dangerous goods being carried by a heavy vehicle.
 * 
 * @field dangerousGoodsType: Type of dangerous goods, I
 * 
 * @field unNumber: a 4-digit number that identifies the substance of the dangerous goods as specified in
 * United Nations Recommendations on the Transport of Dangerous Goods - Model Regulations [i.5],
 * 
 * @field elevatedTemperature: whether the carried dangerous goods are transported at high temperature.
 * If yes, the value shall be set to TRUE,
 * 
 * @field tunnelsRestricted: whether the heavy vehicle carrying dangerous goods is restricted to enter tunnels.
 * If yes, the value shall be set to TRUE,
 * 
 * @field limitedQuantity: whether the carried dangerous goods are packed with limited quantity.
 * If yes, the value shall be set to TRUE,
 * 
 * @field emergencyActionCode: physical signage placard at the vehicle that carries information on how an emergency
 * service should deal with an incident. This DE is optional; it shall be present if the information is available,
 * 
 * @field phoneNumber: contact phone number of assistance service in case of incident or accident.
 * This DE is optional, it shall be present if the information is available.
 * It shall be presented as defined in clause A.135,
 * 
 * @field companyName: name of company that manages the transportation of the dangerous goods.
 * This DE is optional; it shall be present if the information is available.
 * 
 * @category Vehicle information
 * Revision: V1.3.1
 */
DangerousGoodsExtended ::= SEQUENCE {
    dangerousGoodsType DangerousGoodsBasic,
    unNumber INTEGER (0..9999),
    elevatedTemperature BOOLEAN,
    tunnelsRestricted BOOLEAN,
    limitedQuantity BOOLEAN,
    emergencyActionCode IA5String (SIZE (1..24)) OPTIONAL,
    phoneNumber PhoneNumber OPTIONAL,
    companyName UTF8String (SIZE (1..24)) OPTIONAL,
        ...
}



/** 
 * This DF represents a  position in a two- or three-dimensional cartesian coordinate system.
 *
 * @details xCoordinate: the X coordinate value using the DE CartesianCoordinate.
 *
 * @details yCoordinate: the Y coordinate value using the DE CartesianCoordinate.
 *
 * @details xCoordinate: the optional Z coordinate value using the DE CartesianCoordinate.
 * 
 * @category: GeoReference information
 * Revision: Created in V2.1.1
*/
CartesianPosition3d::=SEQUENCE{
	xCoordinate 	CartesianCoordinate,
	yCoordinate		CartesianCoordinate,
	zCoordinate		CartesianCoordinate OPTIONAL -- tbd keep optional?
}


/**
 * This DF represents a coordinate in a cartesian reference system
 * 
 * @details value: the coordinate value which can be estimated as the mean of the current distribution.
 * 
 * @details confidence: the coordinate accuracy associated to the provided value at a predefined confidence level of 95%.
 *
 * @category: GeoReference information
 * Revision: Created in V2.1.1
*/
CartesianCoordinateWithConfidence ::= SEQUENCE {
    value        CartesianCoordinate,
    confidence   CoordinateConfidence
}


/**
 * This DF defines a geographical point position as a 3 dimensional offset position to a reference geographical point.
 *
 * @field deltaLatitude: A delta latitude offset with regards to the latitude value of the reference position.
 *
 * @field deltaLongitude: A delta longitude offset with regards to the longitude value of the reference position.
 *
 * @field deltaAltitude: A delta altitude offset with regards to the altitude value of the reference position.
 *
 * @category: GeoReference information
 * Revision:  V1.3.1
 */
DeltaReferencePosition ::= SEQUENCE {
    deltaLatitude  DeltaLatitude,
    deltaLongitude DeltaLongitude,
    deltaAltitude  DeltaAltitude
}

/**
 * This DF represnets a portion of digital map, described using a list of waypoints @ref ReferencePosition.
 * 
 * @category: GeoReference information
 * Revision:  V1.3.1
 */
DigitalMap ::= SEQUENCE (SIZE(1..256)) OF ReferencePosition 

/** 
 * 
 * This DF represents an elliptical area that is centred on a reference position which is defined outside of the context of this DF. 
 * 
 * @field centerPoint: optional offset point which the rectangle is centred on with respect to the reference position.
 *
 * @field semiMajorAxisLenght: half length of the major axis of the ellipse.
 * 
 * @field semiMinorAxisLenght: half length of the minor axis of the ellipse.
 *
 * @field orientation: orientation of the major axis of the ellipse in the WGS84 coordinate system.
 
 * @category: GeoReference information
 * Revision: Created in V2.1.1
*/

EllipticalArea  ::= SEQUENCE {
    centerPoint          	 CartesianPosition3d OPTIONAL,
    semiMajorAxisLenght      StandardLength,
    semiMinorAxisLenght		 StandardLength,
    orientation   			 Wgs84AngleValue
 -- semiHeight               SemiRangeLength OPTIONAL
}

/**
 * The DF consists of a list of @Ref EventPoint.  
 * The eventPosition of each @Ref EventPoint is defined with respect to the previous @Ref EventPoint in the list. 
 * Except for the first @Ref EventPoint which is defined with respect to a position outside of the context of this DF.
 *
 * @category: GeoReference information, Traffic information
 * Revision: Generalized the semantics in V2.1.1
 */
EventHistory::= SEQUENCE (SIZE(1..23)) OF EventPoint


/**
 * This DF provides information related to an event at a defined position.
 * 
 * @field eventPosition: offset position of a detected event point to a defined position. 
 * 
 * @field eventDeltaTime: optional time travelled by the detecting ITS-S since the previous detected event point.
 * 
 * @field informationQuality: Information quality of the detection for this event point.
 * 
 * @category: GeoReference information, Traffic information
 * Revision: generalized the semantics in V2.1.1
 */
EventPoint ::= SEQUENCE {
    eventPosition DeltaReferencePosition,
    eventDeltaTime PathDeltaTime OPTIONAL,
    informationQuality InformationQuality
}

/**
 * This DF represents the status of the exterior light switches of a traffic participant.
 * 
 * @field vehicular:  represents the status of the exterior light switches of a road vehicle.
 * 
 * @field vruSpecific: represents the status of the exterior light switches of a VRU.
 *
 * @category: tbd
 * Revision: created in V2.1.1
 */
ExteriorLightsExtended ::= SEQUENCE {
   vehicular       ExteriorLights, 
   vruSpecific     VruSpecificExteriorLights,
   ...
}


/**
 * This DF indicates a transversal position in relation to the different lanes of the road. 
 * It is an extension of DE_LanePosition to cover locations (sidewalks, bicycle paths), where V-ITS-S would normally not be present. 
 *
 * The following options are available:
 *
 * @field trafficLanePosition: a position on a traffic lane. 
 * 
 * @field nonTrafficLanePosition: a position on a lane which is not a traffic lane.
 * 
 * @field trafficIslandPosition: a position on a traffic island
 * 
 * @field mapPosition: a position on a lane identified in a MAPEM.
 *  
 * @category: Road Topology information
 * Revision: created in V2.1.1
 */
GeneralizedLanePosition::= CHOICE {
	trafficLanePosition				LanePosition,
    nonTrafficLanePosition			LanePositionAndType,
    trafficIslandPosition           TrafficIslandPosition,
    mapPosition                     MapPosition,
    ...
}	

/**
 * This DF represents the Heading in a WGS84 co-ordinates system.
 * 
 * @field headingValue: the heading value.
 * 
 * @field headingConfidence: the accuracy of the reported heading value with a predefined confidence level.
 * 
 * @note: this DF is kept for backwards compatibiliyty reasons only. It is reccomended to use the @ref Wgs84Angle instead. 
 * @category: GeoReference information, Vehicle information, Road topology information
 * Revision: V1.3.1
 */
Heading ::= SEQUENCE {
    headingValue HeadingValue,
    headingConfidence HeadingConfidence
}


/**
 * This DF  provides  information  associated to heading  change indicators  such as  a  change  of  direction.
 * 
 * @field direction: the direction of heading change value.
 * 
 * @field actionDeltaTime: the period over which a direction change action is performed. 
 * 
 * @category: t.b.d.
 * Revision: created in V2.1.1
 */
HeadingChangeIndication ::= SEQUENCE {
    direction        TurningDirection,
    actionDeltaTime  DeltaTimeTenthOfSecond,
    ...
}

/**
 * This DF represents a frequency channel 
 *
 * @field centreFrequency: the centre frequency of the channel
 * @unit: 10exp+2 Hz (where exp is exponent)
 * 
 * @details channelWidth: width of the channel
 * @unit: 10exp Hz (where exp is exponent)
 *
 * @details exponent of the power of 10
 * @unit: N/A
 *
 * @category: Communication information
 * Revision: created in V2.1.1
*/
InterferenceManagementChannel ::= SEQUENCE {
    centreFrequency INTEGER (1 .. 99999),
    channelWidth    INTEGER (0 .. 9999),
    exponent        INTEGER (0 .. 15) 
}

/**
 * 
 * This DF represents a zone  inside which the ITS communication should be restricted in order to manage interference.
 *
 * @field zoneDefinition: contains the geographical definition of the zone.
 *
 * @field managementInfo: contains interference management information applicable in the zone defined in @field zoneDefinition.
 *
 * @category: Communication information
 * Revision: created in V2.1.1
 */
InterferenceManagementZone ::= SEQUENCE {
	zoneDefinition      InterferenceManagementZoneDefinition,
	managementInfo 		InterferenceManagementInfo
}

/**
 * This DF represents the geographical definition of the zone where band sharing occurs. 
 *
 * @field interferenceManagementZoneLatitude: Latitude of the centre point of the interference management zone.
 *
 * @field interferenceManagementZoneLongitude: Longitude of the centre point of the interference management zone.
 *
 * @field interferenceManagementZoneRadius: optional radius of the interference management zone in metres. 
 *
 * @field interferenceManagementZoneID: optional identification of the interference management zone. 
 *
 * @field interferenceManagementZoneShape: shape of the interference management zone. 
 *
 * @category: Communication information
 * Revision: created in V2.1.1
 */
InterferenceManagementZoneDefinition::= SEQUENCE{     
    interferenceManagementZoneLatitude   Latitude, 
    interferenceManagementZoneLongitude  Longitude, 
    interferenceManagementZoneRadius     ProtectedZoneRadius OPTIONAL,
    interferenceManagementZoneID         ProtectedZoneID OPTIONAL,
    interferenceManagementZoneShape      Area (WITH COMPONENTS{..., radial ABSENT}) OPTIONAL,
    ...
}

/**
 * This DF consists of a list of up to 16 definitions containing  interference management information, per affected frequency channels.
 *  
 * @category: Communication information.
 * Revision: created in V2.1.1
 */
InterferenceManagementInfo::= SEQUENCE (SIZE(1..16,...)) OF InterferenceManagementInfoPerChannel


/**
 * This DF contains interference management information for one affected frequency channel.
 *
 * @field interferenceManagementChannel: frequency channel for which the zone should be applied interference management 
 *
 * @field interferenceManagementZoneType: type of the interference management zone. 
 *
 * @field interferenceManagementMitigationType: optional type of the mitigation to be used in the interference management zone.
 *
 * @field expiryTime: optional time at which the validity of the interference management communication zone will expire. This component is present when the interference management is temporarily valid
 *
 * @category: Communication information
 * Revision: created in V2.1.1
 */
InterferenceManagementInfoPerChannel ::= SEQUENCE {
    interferenceManagementChannel         InterferenceManagementChannel,
    interferenceManagementZoneType        InterferenceManagementZoneType,
    interferenceManagementMitigationType  InterferenceManagementMitigationType OPTIONAL,
    expiryTime                            TimestampIts OPTIONAL, -- from ITS-Container
    ...
}

/**
 * This DF provides information and commands defining the required mitigation type in the defined interference management zone. 
 * @field unavailable: this is the default choice to be used when information is not available
 *
 * @field mitigationForTechnologies: it indicates the type of mitigation and the parameters to be used to protect the 
 * potential victim in the interference management zone per channel access technology class.
 *
 * @category: Communication information
 * Revision: created in V2.1.1
 */
InterferenceManagementMitigationType ::= CHOICE {
    unavailable   NULL,   
    mitigationForTechnologies MitigationForTechnologies
}

/**
 * This DF consist of a list of up to 16 interference interference management zones.  
 *
 * **EXAMPLE**: An interference management communication zone may be defined around a 
 * CEN DSRC road side equipment or an urban rail operational area.
 * Communication information
 * Revision: created in V2.1.1
 */
InterferenceManagementZones ::= SEQUENCE (SIZE(1..16), ...) OF InterferenceManagementZone

/**
 * This DF represents a unique id for an intersection, in accordance with ETSI TS 103 301.
 *
 * @field region: the optional identifier of the entity that is responsible for the region in which the intersection is placed.
 * It is the duty of that entity   to guarantee that the @ref Id is unique within the region.
 *
 * @field id: the identifier of the intersection
 *
 * @note: when the RoadRegulatorID is present, the IntersectionReferenceID is guaranteed to be globally unique.
 * @category: Road topology information
 * Revision: created in V2.1.1
 */
IntersectionReferenceId ::= SEQUENCE {
    region RoadRegulatorId OPTIONAL,
    id IntersectionID
}

/**
 * This DF consists of  a list of waypoints @ref ReferencePosition.
 *
 * @category: GeoReference information
 * Revision: Editorial update in V2.1.1
 */
ItineraryPath ::= SEQUENCE SIZE(1..40) OF ReferencePosition

/**
 * This DF represents a common message header for application and facilities layer messages.
 * It is included at the beginning of an ITS message as the message header.
 *
 * @field protocolVersion: version of the ITS message.
 *
 * @field messageId: type of the ITS message.
 *
 * @field stationId: the identifier of the ITS-S that generates the ITS message in question.
 *
 * @category: Communication information
 * Revision:  update in V2.1.1: messageID and stationID changed to messageId and stationId; messageId is of type MessageId.
 */
ItsPduHeader ::= SEQUENCE {
    protocolVersion    INTEGER (0..255),
    messageId          MessageId,
    stationId          StationID
}

/**
 * This DF indicates a transversal position in resolution of lanes and the associated lane type.
 * 
 * @field: transversalPosition: the transversal position.
 * 
 * @field: laneType: the type of the lane identified in the component transversalPosition.
 * 
 * @category GeoReference information
 * Revision: Created in V2.1.1
 */
LanePositionAndType::= SEQUENCE {
    transversalPosition 	LanePosition,
    laneType				LaneType,
    ...
}

/**
 * This DF indicates the vehicle acceleration at lateral direction and the accuracy of the lateral acceleration.
 * 
 * @field: lateralAccelerationValue: lateral acceleration value at a point in time.
 * 
 * @field: lateralAccelerationConfidence: accuracy of the reported lateral acceleration value.
 *
 * @note: this DF is kept forbackwards compatibility reasons only. It is recommended to use @ref Acceleration1d instead.
 * @category Vehicle information
 * Revision: V1.3.1
 */
LateralAcceleration ::= SEQUENCE {
    lateralAccelerationValue LateralAccelerationValue,
    lateralAccelerationConfidence AccelerationConfidence
}

/**
 * This DF indicates the vehicle acceleration at longitudinal direction and the accuracy of the longitudinal acceleration.
 *
 * @field longitudinalAccelerationValue: longitudinal acceleration value at a point in time.

 * @field longitudinalAccelerationConfidence: accuracy of the reported longitudinal acceleration value with a predefined
 *
 * @note: this DF is kept forbackwards compatibility reasons only. It is recommended to use @ref Acceleration1d instead. 
 * @category: Vehicle information
 * Revision: V1.3.1
 */
LongitudinalAcceleration ::= SEQUENCE {
    longitudinalAccelerationValue LongitudinalAccelerationValue,
    longitudinalAccelerationConfidence AccelerationConfidence
}

/** 
 * This DF represents the estimated position along the longitudinal length of a particular lane. 
 *
 * @field  longitudinalLanePositionValue: the mean value of the longitudinal position within a particular length.
 *
 * @field  longitudinalLanePositionConfidence: The confidence associated to the provided value.
 *
 * @note: this DF is kept forbackwards compatibility reasons only. It is recommended to use @ref Acceleration1d instead. 
 * @category: Vehicle information
 * Revision: V1.3.1
*/
LongitudinalLanePosition ::= SEQUENCE {
    longitudinalLanePositionValue        LongitudinalLanePositionValue,
    longitudinalLanePositionConfidence   LongitudinalLanePositionConfidence