Documentation update

# ASN.1 module ITS-Container

 OID: _{ itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) ts (102894) cdd (2) version3 (3) -- Note: the final OID is still to be agreed. }_

# ASN.1 module ETSI-ITS-CDD

 OID: _{itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) ts (102894) cdd (2) major-version-3 (3) minor-version-1 (1)}_

## Data Elements:

    **Revision**: _Created in V2.1.1_

```asn1

CardinalNumber1B ::= INTEGER(1..255)

CardinalNumber1B ::= INTEGER(0..255)

```

```

### <a name="CartesianCoordinateExtended"></a>CartesianCoordinateExtended

 This DF represents the value of a cartesian coordinate with a range of -1 327,67 to + 1 327,66 meters.

### <a name="CartesianCoordinateLarge"></a>CartesianCoordinateLarge

 This DF represents the value of a cartesian coordinate with a range of -1 310,72 to + 1 310,71 meters.

    **Unit**: _0,01 m_

    **Revision**: _Created in V2.1.1_

```asn1

CartesianCoordinateExtended::= INTEGER{ 

    negativeOutOfRange (-132768),

    positiveOutOfRange (132767)

} (-132768..132767)

CartesianCoordinateLarge::= INTEGER{ 

    negativeOutOfRange (-131072),

    positiveOutOfRange (131071)

} (-131072..131071)

```

### <a name="Longitude"></a>Longitude

 This DE represents the absolute geographical longitude in a WGS84 co-ordinate system, providing a range of 180 degrees

 This DE represents the absolute geographical longitude in a WGS84 coordinate system, providing a range of 180 degrees

 to the east or to the west of the prime meridian.

 The value shall be set to:

 - `4` stereovision       : in case the sensor is stereo vision.

 - `5` nightvision        : in case the sensor is night vision.

 - `6` ultrasonic         : in case the sensor is ultrasonic.

 - `7` pmd              : in case the sensor is pmd.

 - `8` fusion           : in case the information provided by a sensor data fusion system

 - `9` inductionloop    : in case the sensor is an induction loop.

 - `10` sphericalCamera : in case the sensor is a spherical camera.

 - `11` itssaggregation : in case the information is gathered from other received ITS messages

 - `12` uwb             : in case the sensor is ultra wide band.

 - `7` pmd                : in case the sensor is photonic mixing device.

 - `8` inductionLoop      : in case the sensor is an induction loop.

 - `9` sphericalCamera    : in case the sensor is a spherical camera.

 - `10` uwb               : in case the sensor is ultra wide band.

 - `11` acoustic          : in case the sensor is acoustic.

 - `12` localAggregation  : in case the information is provided by a system that aggregates information from different local sensors. Aggregation may include fusion.

 - `13` itsAggregation    : in case the information is provided by a system that aggregates information from other received ITS messages.

 - 14-15 reserved for future usage.

    **Categories**: Sensing Information 

    nightvision       (5),

    ultrasonic        (6),

    pmd               (7),

    fusion          (8), 

    inductionloop   (9),

    sphericalCamera (10),

    itssaggregation (11), 

	uwb             (12)

    inductionLoop     (8),

    sphericalCamera   (9),

    uwb               (10),

    acoustic          (11),

    localAggregation  (12),

    itsAggregation    (13)

} (0..15)

```

    lightTruck      (7), 

    heavyTruck      (8), 

    trailer         (9), 

    specialVehicles (10), 

    specialVehicle  (10), 

    tram            (11), 

    lightVruVehicle (12), 

    animal          (13), 

 - 2 `zebraCrossing`          : to indicate that the VRU is on a  zebra crossing (crosswalk).

 - 3 `sidewalk`               : to indicate that the VRU is on a sidewalk.

 - 4 `onVehicleRoad`          : to indicate that the VRU is on a traffic lane. 

 + - 5 `protectedGeographicArea`: to indicate that the VRU is in a protected area. 

 - 5 `protectedGeographicArea`: to indicate that the VRU is in a protected area. 

 - value 5 to 255             : reserved for future usage. Value 255 is set to "max" in order to bound the size of the encoded field.

```

### <a name="Altitude"></a>Altitude

 This DF provides the altitude and accuracy of an altitude information in a WGS84 co-ordinate system.

 This DF provides the altitude and accuracy of an altitude information in a WGS84 coordinate system.

 It includes the following components:

 It includes the following components:

Fields:

* value [**CartesianCoordinateExtended**](#CartesianCoordinateExtended) <br>

* value [**CartesianCoordinateLarge**](#CartesianCoordinateLarge) <br>

  the coordinate value which can be estimated as the mean of the current distribution.

    **Revision**: _Created in V2.1.1_

```asn1

CartesianCoordinateWithConfidence ::= SEQUENCE {

    value         CartesianCoordinateExtended,

    value         CartesianCoordinateLarge,

    confidence    CoordinateConfidence

}

```

* adverseWeatherCondition-Adhesion [**AdverseWeatherCondition-AdhesionSubCauseCode**](#AdverseWeatherCondition-AdhesionSubCauseCode) <br>

* aquaplannning [**SubCauseCodeType**](#SubCauseCodeType) <br>

* aquaplaning [**SubCauseCodeType**](#SubCauseCodeType) <br>

* reserved8 [**SubCauseCodeType**](#SubCauseCodeType) <br>

    reserved4                                        SubCauseCodeType,

    impassability                                    SubCauseCodeType,

    adverseWeatherCondition-Adhesion                 AdverseWeatherCondition-AdhesionSubCauseCode,

    aquaplannning                                    SubCauseCodeType,

    aquaplaning                                      SubCauseCodeType,

    reserved8                                        SubCauseCodeType,

    hazardousLocation-SurfaceCondition               HazardousLocation-SurfaceConditionSubCauseCode,

    hazardousLocation-ObstacleOnTheRoad              HazardousLocation-ObstacleOnTheRoadSubCauseCode,

* interferenceManagementMitigationType [**InterferenceManagementMitigationType**](#InterferenceManagementMitigationType)  OPTIONAL<br>

* interferenceManagementMitigationType [**MitigationForTechnologies**](#MitigationForTechnologies)  OPTIONAL<br>

  optional type of the mitigation to be used in the interference management zone. 

   In the case where no mitigation should be applied by the ITS-S, this is indicated by the field interferenceManagementMitigationType being absent.

InterferenceManagementInfoPerChannel ::= SEQUENCE {

    interferenceManagementChannel           InterferenceManagementChannel,

    interferenceManagementZoneType          InterferenceManagementZoneType,

    interferenceManagementMitigationType    InterferenceManagementMitigationType OPTIONAL,

    interferenceManagementMitigationType    MitigationForTechnologies OPTIONAL,

    expiryTime                              TimestampIts OPTIONAL, 

    ...

}

```

### <a name="InterferenceManagementMitigationType"></a>InterferenceManagementMitigationType

 This DF provides information and commands defining the required mitigation type in the defined interference management zone. 

 It includes the following options:

Fields:

* unavailable **NULL** <br>

  this is the default choice to be used when information is not available

* mitigationForTechnologies [**MitigationForTechnologies**](#MitigationForTechnologies) <br>

  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.

    **Categories**: Communication information 

    **Revision**: _created in V2.1.1_

```asn1

InterferenceManagementMitigationType ::= CHOICE {

    unavailable                  NULL,   

    mitigationForTechnologies    MitigationForTechnologies

}

```

### <a name="InterferenceManagementZones"></a>InterferenceManagementZones

 This DF consist of a list of up to 16 interference  management zones.  

Fields:

* mapReference [**MapReference**](#MapReference)  OPTIONAL<br>

  optionally identifies the MAPEM carrying the topology.

  optionally identifies the MAPEM containing the topology information.

   It is absent if the MAPEM topology is known from the context.

* laneId [**Identifier1B**](#Identifier1B) <br>

  identifies the lane in the topology.

  identifies the lane in the road segment or intersection topology on which the position is located.

* longitudinalLanePosition [**LongitudinalLanePosition**](#LongitudinalLanePosition)  OPTIONAL<br>

  optionally indicates the longitudinal offset of the map-matched position of the object along the lane.

  optionally indicates the longitudinal offset of the map-matched position of the object along the lane or connection.

* connectionId [**Identifier1B**](#Identifier1B) <br>

  identifies the connection inside the conflict area of an intersection, i.e. it identifies a trajectory for travelling through the

   conflict area of an intersection which connects e.g an ingress with an egress lane.

    mapReference                MapReference OPTIONAL,

    laneId                      Identifier1B,

    longitudinalLanePosition    LongitudinalLanePosition OPTIONAL,

    connectionId                Identifier1B, 

    ...

}

```

	}

```

### <a name="MessageSegmentInfo"></a>MessageSegmentInfo

### <a name="MessageSegmentationInfo"></a>MessageSegmentationInfo

 This DF provides information about a message with respect to the segmentation process at the sender.

 It includes the following components:

Fields:

* totalMsgSegments [**CardinalNumber1B**](#CardinalNumber1B) <br>

* totalMsgNo [**CardinalNumber1B**](#CardinalNumber1B)  (1..255)<br>

  indicates the total number of messages that has been used on the transmitter side to encode the information.

* thisSegmentNum [**OrdinalNumber1B**](#OrdinalNumber1B) <br>

* thisMsgNo [**OrdinalNumber1B**](#OrdinalNumber1B) <br>

  indicates the position of the message within of the total set of messages.

```asn1

MessageSegmentInfo ::= SEQUENCE {

    totalMsgSegments  CardinalNumber1B,

    thisSegmentNum    OrdinalNumber1B

MessageSegmentationInfo ::= SEQUENCE {

    totalMsgNo  CardinalNumber1B (1..255),

    thisMsgNo   OrdinalNumber1B

    }

```

* value [**ObjectDimensionValue**](#ObjectDimensionValue) <br>

* confidence [**ObjectDimensionValue**](#ObjectDimensionValue) <br>

* confidence [**ObjectDimensionConfidence**](#ObjectDimensionConfidence) <br>

    **Categories**: Sensing information 

}

ObjectDimension ::= SEQUENCE {

    value         ObjectDimensionValue,

    confidence    ObjectDimensionValue

    confidence    ObjectDimensionConfidence

}

```

### <a name="PathHistory"></a>PathHistory

 This DF that represents a path with a set of path points.

 This DF that represents a path history with a set of path points.

 It may contain up to `40` [**PathPoint**](#PathPoint). 

 The first PathPoint presents an offset delta position with regards to an external reference position.

PathHistory::= SEQUENCE (SIZE(0..40)) OF PathPoint

```

### <a name="PathPredicted"></a>PathPredicted

 This DF that represents a predicted path with a set of path points.

 It may contain up to `15` [**PathPoint**](#PathPoint). 

 The first PathPoint presents an offset delta position with regards to an external reference position.

 Each other PathPoint presents an offset delta position and optionally an offset travel time with regards to the previous PathPoint. 

    **Categories**: GeoReference information 

    **Revision**: _created in V2.1.1 based on PathHistory_

```asn1

PathPredicted::= SEQUENCE (SIZE(0..15,...)) OF PathPointPredicted

```

### <a name="PathPoint"></a>PathPoint

 This DF  defines an offset waypoint position within a path.

}

```

### <a name="PathPointAbsolute"></a>PathPointAbsolute

 The DF that defines a waypoint position within a path.

### <a name="PathPointPredicted"></a>PathPointPredicted

 This DF  defines a predicted offset waypoint position within a path.

 It includes the following components:

Fields:

* pathPosition [**ReferencePosition**](#ReferencePosition) <br>

  The waypoint position defined as an absolute  position.

* deltaLatitude [**DeltaLatitude**](#DeltaLatitude) <br>

  an offset latitude with regards to a pre-defined reference position. 

* deltaLongitude [**DeltaLongitude**](#DeltaLongitude) <br>

  an offset longitude with regards to a pre-defined reference position. 

* horizontalPositionConfidence [**PosConfidenceEllipse**](#PosConfidenceEllipse)  OPTIONAL<br>

  the accuracy of the horizontal geographical position.

* pathDeltaTime [**PathDeltaTime**](#PathDeltaTime)  OPTIONAL<br>

  The optional delta time in which the waypoint will be occupied, from a reference time.

* deltaAltitude [**DeltaAltitude**](#DeltaAltitude)  DEFAULT unavailable<br>

  an offset altitude with regards to a pre-defined reference position. 

* altitudeConfidence [**AltitudeConfidence**](#AltitudeConfidence)  DEFAULT unavailable<br>

  the accuracy of the altitude value of the geographical position.

* pathDeltaTime [**DeltaTimeTenthOfSecond**](#DeltaTimeTenthOfSecond) <br>

  The  travel time separated from the waypoint to the predefined reference position.

    **Categories**: GeoReference information 

    **Revision**: _created in V2.1.1_

    **Revision**: _semantics updated in V2.1.1_

```asn1

PathPointAbsolute ::=  SEQUENCE {

    pathPosition     ReferencePosition,                   

    pathDeltaTime    PathDeltaTime OPTIONAL 

PathPointPredicted::= SEQUENCE {

  deltaLatitude                 DeltaLatitude,      

  deltaLongitude                DeltaLongitude, 

  horizontalPositionConfidence  PosConfidenceEllipse OPTIONAL,   

  deltaAltitude                 DeltaAltitude DEFAULT unavailable, 

  altitudeConfidence            AltitudeConfidence DEFAULT unavailable,

  pathDeltaTime                 DeltaTimeTenthOfSecond,

  ... 

}

```

* timeToCollision [**DeltaTimeHundredthOfSecond**](#DeltaTimeHundredthOfSecond)  OPTIONAL<br>

* timeToCollision [**DeltaTimeTenthOfSecond**](#DeltaTimeTenthOfSecond)  OPTIONAL<br>

  optionally indicated the time-to-collision calculated as sqrt(LaDi<sup>2</sup> + LoDi<sup>2</sup> + VDi<sup>2</sup>)/relative speed 

   and represented in  the  nearest 100  ms. This component may be present only if subjectStation is present. 

SafeDistanceIndication ::= SEQUENCE {

    subjectStation           StationID OPTIONAL,

    safeDistanceIndicator    SafeDistanceIndicator,

    timeToCollision          DeltaTimeHundredthOfSecond OPTIONAL,

    timeToCollision          DeltaTimeTenthOfSecond OPTIONAL,

    ...

}

```

```

### <a name="SequenceOfPathPointAbsolute"></a>SequenceOfPathPointAbsolute

 This DF contains a list of DFs PathPointAbsolute. 

 The component pathDeltaTime shall be either present in all elements of the list or be absent in all elements.

    **Categories**: GeoReference information 

    **Revision**: _created in V2.1.1_

```asn1

SequenceOfPathPointAbsolute::= SEQUENCE (SIZE(1..16,...)) OF PathPointAbsolute

```

### <a name="SequenceOfSafeDistanceIndication"></a>SequenceOfSafeDistanceIndication

 The DF contains a list of DF  SafeDistanceIndication.

* trailerWidth [**VehicleWidth**](#VehicleWidth)  OPTIONAL<br>

* trailerWidth [**VehicleWidth**](#VehicleWidth) <br>

  optional width of the trailer.

* hitchAngle [**CartesianAngle**](#CartesianAngle)  OPTIONAL<br>

* hitchAngle [**CartesianAngle**](#CartesianAngle) <br>

  optional Value and confidence of the angle between the trailer orientation (corresponding to the x

   direction of the ISO 8855 [i.2] coordinate system centered on the trailer) and the direction of

   the segment having as end points the reference point of the trailer and the reference point of

   confidence level of 95 %.

    --tbd is OPTIONAL needed since the value unvailable can be used?

    **Categories**: Vehicle information 

    hitchPointOffset    StandardLength1B, 

    frontOverhang       StandardLength1B, 

    rearOverhang        StandardLength1B, 

    trailerWidth        VehicleWidth OPTIONAL, 

    hitchAngle          CartesianAngle OPTIONAL, 

    trailerWidth        VehicleWidth,

    hitchAngle          CartesianAngle,

    ...

}

```

* clusterProfiles [**VruClusterProfiles**](#VruClusterProfiles) <br>

  identifies all the VRU profile types that are believed to be within the cluster .

* clusterProfiles [**VruClusterProfiles**](#VruClusterProfiles)  OPTIONAL<br>

  optionally identifies all the VRU profile types that are believed to be within the cluster.

   if this component is absent it means that the information is unavailable. 

   clusterId                  ClusterId OPTIONAL,

   clusterBoundingBoxShape    Shape (WITH COMPONENTS{..., ellipse ABSENT, radial ABSENT, radialShapes ABSENT}) OPTIONAL,

   clusterCardinalitySize     ClusterCardinalitySize,

   clusterProfiles            VruClusterProfiles,

   clusterProfiles            VruClusterProfiles OPTIONAL,

   ...

}

```