Documentation update

* **[ETSI-ITS-CDD](ETSI-ITS-CDD.md)** *{itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) ts (102894) cdd (2) major-version-3 (3) minor-version-1 (1)}*<br/>

## Data Elements:

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

This type represents the DENM PDU.

 It shall include the following components:

* _header_ of type [**ItsPduHeader**](ETSI-ITS-CDD.md#ItsPduHeader)  (WITH COMPONENTS {... , protocolVersion (2)<br>

  the header of the DENM PDU.

* _denm_ of type [**DenmPayload**](#DenmPayload) <br>

  the payload of the DENM PDU.

    messageId(denm)}),

```asn1

DENM ::= SEQUENCE {

	header ItsPduHeader (WITH COMPONENTS {... , protocolVersion (2), messageId(denm)}),

```

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

This type represents the DENM payload.

 It shall include the following components:

* _management_ of type [**ManagementContainer**](#ManagementContainer) <br>

  the Management Container.

* _situation_ of type [**SituationContainer**](#SituationContainer)  OPTIONAL<br>

  the optional Situation Container.

* _location_ of type [**LocationContainer**](#LocationContainer)  OPTIONAL<br>

  the optional Location Container.

* _alacarte_ of type [**AlacarteContainer**](#AlacarteContainer)  OPTIONAL<br>

  the optional À La Carte Container .

```asn1

DenmPayload ::= SEQUENCE {

	management ManagementContainer,

```

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

This type represents the Management Container.

 It shall include the following components:

* _actionId_ of type [**ActionId**](ETSI-ITS-CDD.md#ActionId) <br>

  an identifier generated by the DEN basic service for a new DENM.

* _detectionTime_ of type [**TimestampIts**](ETSI-ITS-CDD.md#TimestampIts) <br>

  the time at which the event is detected.

* _referenceTime_ of type [**TimestampIts**](ETSI-ITS-CDD.md#TimestampIts) <br>

  the time at which a new DENM, an update DENM or a cancellation DENM is generated

* _termination_ of type [**Termination**](#Termination)  OPTIONAL<br>

  the optional termination type of the DENM.

* _eventPosition_ of type [**ReferencePosition**](ETSI-ITS-CDD.md#ReferencePosition) <br>

  the geographical position used in the definition of the awareness area / relevance zone, see clause 6.1.3.

* _awarenessDistance_ of type [**StandardLength3b**](ETSI-ITS-CDD.md#StandardLength3b)  OPTIONAL<br>

  the optional radius of the circular awareness area, with centre at the event position or at any of the event history points as defined in clause 6.1.3.1.

* _awarenessTrafficDirection_ of type [**TrafficDirection**](ETSI-ITS-CDD.md#TrafficDirection)  OPTIONAL<br>

  the optional traffic direction along which the receiving ITS-S may encounter the event, as defined in clause 6.1.3.1.

* _validityDuration_ of type [**DeltaTimeSecond**](ETSI-ITS-CDD.md#DeltaTimeSecond)  DEFAULT defaultValidity<br>

  the validity duration of a DENM. This component represents a time offset in the unit of second since detectionTime.

* _transmissionInterval_ of type [**DeltaTimeMilliSecondPositive**](ETSI-ITS-CDD.md#DeltaTimeMilliSecondPositive)  OPTIONAL<br>

  the optional time interval for DENM transmission as defined by the originating ITS-S. If the component is not present in DENM, a default value defaultValidity is assumed.

* _stationType_ of type [**StationType**](ETSI-ITS-CDD.md#StationType) <br>

  the station type information of the originating ITS-S.

```asn1

ManagementContainer ::= SEQUENCE {

	actionId                  ActionId,

```

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

This type represents the situation container.

 It shall include the following components:

* _informationQuality_ of type [**InformationQuality**](ETSI-ITS-CDD.md#InformationQuality) <br>

  the quality level of the information provided by the ITS-S application of the originating ITS-S. 

   It indicates the probability of the detected event being truly existent at the event position. .

* _eventType_ of type [**CauseCodeV2**](ETSI-ITS-CDD.md#CauseCodeV2) <br>

  the event type, including direct cause and sub cause.

* _linkedCause_ of type [**CauseCodeV2**](ETSI-ITS-CDD.md#CauseCodeV2)  OPTIONAL<br>

  the optional description for a linked event of the component eventType, including direct cause and sub cause of the linked event.

* _eventZone_ of type [**EventZone**](ETSI-ITS-CDD.md#EventZone)  OPTIONAL<br>

  an optional list of eventPoints.

```asn1

SituationContainer ::= SEQUENCE {

	informationQuality InformationQuality,

```

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

This type represents the Location Container.

 It shall include the following components:

* _eventSpeed_ of type [**Speed**](ETSI-ITS-CDD.md#Speed)  OPTIONAL<br>

  optional speed of a detected dynamic event and the confidence of the speed information. 

* _eventPositionHeading_ of type [**Wgs84Angle**](ETSI-ITS-CDD.md#Wgs84Angle)  OPTIONAL<br>

  the optional heading of a dynamic event and the confidence of the heading information.

* _traces_ of type [**Traces**](ETSI-ITS-CDD.md#Traces) <br>

  the detection zone information.

* _roadType_ of type [**RoadType**](ETSI-ITS-CDD.md#RoadType)  OPTIONAL<br>

  the optional road type information at the event position. 

```asn1

LocationContainer ::= SEQUENCE {

	eventSpeed           Speed OPTIONAL,

```

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

This type contains detailed information about the vehicle in which the originating ITS-S is mounted, for mitigating the consequences of a collision.

 It shall include the following components:

* _heightLonCarrLeft_ of type [**HeightLonCarr**](ETSI-ITS-CDD.md#HeightLonCarr) <br>

  the height of the left longitudinal carrier of the vehicle from base to top.

* _heightLonCarrRight_ of type [**HeightLonCarr**](ETSI-ITS-CDD.md#HeightLonCarr) <br>

  the height of the right longitudinal carrier of the vehicle from base to top.

* _posLonCarrLeft_ of type [**PosLonCarr**](ETSI-ITS-CDD.md#PosLonCarr) <br>

  the position of the left longitudinal carrier of vehicle.

* _posLonCarrRight_ of type [**PosLonCarr**](ETSI-ITS-CDD.md#PosLonCarr) <br>

  the position of the right longitudinal carrier of vehicle.

* _positionOfPillars_ of type [**PositionOfPillars**](ETSI-ITS-CDD.md#PositionOfPillars) <br>

  information about the vertical support of the vehicle in which the originating ITS-S is mounted. It shall be included for passenger vehicles only.

* _posCentMass_ of type [**PosCentMass**](ETSI-ITS-CDD.md#PosCentMass) <br>

  the position of the centre of mass of the vehicle.

* _wheelBaseVehicle_ of type [**WheelBaseVehicle**](ETSI-ITS-CDD.md#WheelBaseVehicle) <br>

  the wheel base of the vehicle.

* _turningRadius_ of type [**TurningRadius**](ETSI-ITS-CDD.md#TurningRadius) <br>

  the turning radius of the vehicle.

* _posFrontAx_ of type [**PosFrontAx**](ETSI-ITS-CDD.md#PosFrontAx) <br>

  the position of the front axle of the vehicle.

* _positionOfOccupants_ of type [**PositionOfOccupants**](ETSI-ITS-CDD.md#PositionOfOccupants) <br>

  indicates whether an in-vehicle seat is occupied at the moment of generation of the message.

* _vehicleMass_ of type [**VehicleMass**](ETSI-ITS-CDD.md#VehicleMass) <br>

  the mass of the unloaded vehicle

* _requestResponseIndication_ of type [**RequestResponseIndication**](ETSI-ITS-CDD.md#RequestResponseIndication) <br>

  indicates whether the originating ITS-S transmitting the impactReduction component is requesting the receiving ITS-S to provide also its impactReduction component.

```asn1

ImpactReductionContainer ::= SEQUENCE {

	heightLonCarrLeft         HeightLonCarr,

```

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

This type contains detailed information of a roadwork zone and specific access conditions.

 It shall include the following components:

* _lightBarSirenInUse_ of type [**LightBarSirenInUse**](ETSI-ITS-CDD.md#LightBarSirenInUse)  OPTIONAL<br>

  optionally indicates whether a roadwork vehicle has switched on the light bar or siren. It is used when the roadwork involves a specific roadwork vehicle

* _closedLanes_ of type [**ClosedLanes**](ETSI-ITS-CDD.md#ClosedLanes)  OPTIONAL<br>

  optionally indicates whether the roadwork has caused the closure of one or several driving lanes. 

   Optionally, it may indicate whether a hard shoulder lane is closed to traffic or can be used for specific usage (e.g. for stopping).

* _restriction_ of type [**RestrictedTypes**](ETSI-ITS-CDD.md#RestrictedTypes)  OPTIONAL<br>

  the optional type(s) of vehicles that are restricted to access the road work zone. More than one vehicle types may be provided by this component if the restriction apply to multiple vehicle types. 

* _speedLimit_ of type [**SpeedLimit**](ETSI-ITS-CDD.md#SpeedLimit)  OPTIONAL<br>

  the optional speed limitation applied to the roadwork zone.

* _incidentIndication_ of type [**CauseCodeV2**](ETSI-ITS-CDD.md#CauseCodeV2)  OPTIONAL<br>

  the optional incident related to the roadworks to provide additional information of the roadworks zone.

* _recommendedPath_ of type [**ItineraryPath**](ETSI-ITS-CDD.md#ItineraryPath)  OPTIONAL<br>

  the optional recommended itinerary in order to contour the roadworks zone.

   A recommended path is presented with a list of path points in the order from the starting point closest to the roadworks zone to the end point of the recommended path. 

* _startingPointSpeedLimit_ of type [**DeltaReferencePosition**](ETSI-ITS-CDD.md#DeltaReferencePosition)  OPTIONAL<br>

  the optional effective starting position of a speed limit being applied to the roadwork zone.

* _trafficFlowRule_ of type [**TrafficRule**](ETSI-ITS-CDD.md#TrafficRule)  OPTIONAL<br>

  optionally indicates the side of the road to which the traffic should flow around a roadwork.

* _referenceDenms_ of type [**ActionIdList**](ETSI-ITS-CDD.md#ActionIdList)  OPTIONAL<br>

  an optional sequence of actionIds for different DENMs that describe the same event. If it is available, it indicates the actionIds of all other DENMs describing this event.

```asn1

RoadWorksContainerExtended ::= SEQUENCE {

	lightBarSirenInUse      LightBarSirenInUse OPTIONAL,

```

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

This type contains detailed information about a stationary vehicle.

 It shall include the following components:

* _stationarySince_ of type [**StationarySince**](ETSI-ITS-CDD.md#StationarySince)  OPTIONAL<br>

  the optional time duration of the stationary vehicle being stationary.

* _stationaryCause_ of type [**CauseCodeV2**](ETSI-ITS-CDD.md#CauseCodeV2)  OPTIONAL<br>

  optional additional information to describe causes of the stationary vehicle event such as human problem.

* _carryingDangerousGoods_ of type [**DangerousGoodsExtended**](ETSI-ITS-CDD.md#DangerousGoodsExtended)  OPTIONAL<br>

  optional information on the type of dangerous goods, the required emergency action and other information.

* _numberOfOccupants_ of type [**NumberOfOccupants**](ETSI-ITS-CDD.md#NumberOfOccupants)  OPTIONAL<br>

  the optional estimated number of occupants involved in the stationary vehicle event.

* _vehicleIdentification_ of type [**VehicleIdentification**](ETSI-ITS-CDD.md#VehicleIdentification)  OPTIONAL<br>

  the optional identification of the stationary vehicle.

* _energyStorageType_ of type [**EnergyStorageType**](ETSI-ITS-CDD.md#EnergyStorageType)  OPTIONAL<br>

  the optional vehicle energy storage type information of the stationary vehicle, such as electric, diesel, etc.

```asn1

StationaryVehicleContainer ::= SEQUENCE {

	stationarySince        StationarySince OPTIONAL, 

```

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

This type represents the À La Carte Container.

 It shall include the following components:

* _lanePosition_ of type [**LanePosition**](ETSI-ITS-CDD.md#LanePosition)  OPTIONAL<br>

  the optional lane position of the event.

* _impactReduction_ of type [**ImpactReductionContainer**](#ImpactReductionContainer)  OPTIONAL<br>

  optional vehicle data for  collision mitigation.

* _externalTemperature_ of type [**Temperature**](ETSI-ITS-CDD.md#Temperature)  OPTIONAL<br>

  optional the ambient temperature at the event position.

* _roadWorks_ of type [**RoadWorksContainerExtended**](#RoadWorksContainerExtended)  OPTIONAL<br>

  the information of the roadwork zone.

* _positioningSolution_ of type [**PositioningSolutionType**](ETSI-ITS-CDD.md#PositioningSolutionType)  OPTIONAL<br>

  optionally indicates the technical solution being used by the originating ITS-S to estimate the event position.

* _stationaryVehicle_ of type [**StationaryVehicleContainer**](#StationaryVehicleContainer)  OPTIONAL<br>

  optional information about a stationary vehicle.

```asn1

AlacarteContainer ::= SEQUENCE {

	lanePosition        LanePosition OPTIONAL,

```

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

This indicates the termination type of generated DENM, i.e. if it is a cancellation DENM or a negation DENM

```asn1

Termination ::= ENUMERATED {isCancellation(0), isNegation (1)}

```