Documentation update

# <a name="DENM-PDU-Description"></a>ASN.1 module DENM-PDU-Description

OID: _{itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) denmPduRelease2 (103831) major-version-2 (2) minor-version-1 (1)}_

OID: _{itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) denmPduRelease2 (103831) major-version-2 (2) minor-version-2 (2)}_

draft 004 of the DENM module for TS 103 831 V2.2.1 integrating:

- ITSWG1(23)000082   Proposal for Road Configuration Container in DENMs

- ITSWG1(23)063002r2 Extend LaneInformation to cover more scenarios

- ITSWG1(23)063004   Provide possibility to link a DENM to other DENMs

- ITSWG1(23)063004   Provide possibility to link DENMs to other C-ITS messages

- ITSWG1(23)063004   Add the possibility to support traces leading to any eventZone point.

- ITSWG1(23)000117   Proposal for encoding areas in location Container in DENMs through predicted paths

- ITSWG1(23)063013   Add PreCrashContainer as proposed by TR 103 832

- ITSWG1(23)000134   Relative event position using road configuration container in DENM

## Imports:

* **[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/>

* **[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-4 (4) minor-version-1 (1)} WITH SUCCESSORS*<br/>

## Data Elements:

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

This type represents the DENM PDU.

    location   LocationContainer OPTIONAL,

    alacarte   AlacarteContainer OPTIONAL

}

((WITH COMPONENTS {..., management (WITH COMPONENTS {..., termination ABSENT}), situation PRESENT, location PRESENT}) |

 (WITH COMPONENTS {..., management (WITH COMPONENTS {..., termination PRESENT}), situation ABSENT, location ABSENT, alacarte ABSENT}))

```

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

 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.

  the identifier of the DENM.

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

  the time at which the event is detected.

* _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. .

   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.

  the optional type of a linked event co-existing at the same time and the same place (same event zone), including direct cause and sub cause of the linked event, 

   for which no other DENM is sent out.

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

  an optional list of eventPoints.

  an optional list of EventPoint, using the position indicated in the component eventPosition of the Management container as the reference position for the first EventPoint.

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

  the end position of the event along the road that is affected by the event w.r.t. the component eventPosition of the Management container. 

   This end position is represented by the length of the event along the road. 

       ...,

   [[  linkedDenms        ActionIdList OPTIONAL,

* linkedDenms<br>

  the optional list of DF ActionId, pointing to DENMs that are semantically connected because applying to consecutive event zones at the same time.

```asn1

SituationContainer ::= SEQUENCE {

    eventType          CauseCodeV2,

    linkedCause        CauseCodeV2 OPTIONAL,

    eventZone          EventZone OPTIONAL,

	...

    ...,

[[  linkedDenms        ActionIdList OPTIONAL,

    eventEnd           Position1d OPTIONAL ]]   

}

  ((WITH COMPONENTS {..., eventZone PRESENT, eventEnd ABSENT}) |

   (WITH COMPONENTS {..., eventZone ABSENT, eventEnd PRESENT}))

```

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

* _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.

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

  the detection zone information approaching the event position.

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

  the optional road type information at the event position. 

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

  the optional lane(s) that are fully or partially occupied by the event, at the position indicated by the component eventPosition of the Management container.

       ...,

   [[	lanePositions                         GeneralizedLanePositions OPTIONAL,

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

  the optional list of DF IvimReference, pointing to IVIMs that are semantically connected because providing information 

   applying to the road segment(s) covered by the components detectionZonesToEventPosition, detectionZonesToSpecifiedEventPoint and the SituationContainer component eventZone.

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

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

  the optional detection zone information approaching towards a specified event point. 

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

  the optional list of future paths or trajectories that the event may move along or zones that the event may occupy. 

* lanePositions<br>

  the optional lane(s) where the event is located, at the position indicated by the component eventPosition of the Management container.

* linkedMapem<br>

  the optional list of DF Mapreference, pointing to MAPEMs that are semantically connected because providing information 

   applying to the road segment(s) covered by the component detectionZonesToEventPosition, detectionZonesToSpecifiedEventPoint and the SituationContainer component eventZone.

```asn1

LocationContainer ::= SEQUENCE {

    eventSpeed                            Speed OPTIONAL,

    eventPositionHeading                  Wgs84Angle OPTIONAL,

	traces               Traces,

    detectionZonesToEventPosition         Traces,

    roadType                              RoadType OPTIONAL,

	...

    ...,

[[	lanePositions                         GeneralizedLanePositions OPTIONAL,

    occupiedLanes                         OccupiedLanesWithConfidence OPTIONAL,

    linkedIvims                           IvimReferences OPTIONAL, 

    linkedMapems                          MapReferences OPTIONAL, 

    detectionZonesToSpecifiedEventPoint   TracesExtended OPTIONAL,

    predictedPaths	          	          PathPredictedList OPTIONAL ]]

}

```

}

```

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

This type contains detailed information about an object with which a vehicle and/or the traffic is likely to collide.

 It shall include the following components:

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

  information about a perceived object in the East, North, Up reference frame.

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

  the optional station Id of the object for which the information is provided.

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

  the optional estimated time to collision of a vehicle with the object. 

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

  indication of the object’s section where the impact will most likely occur. 

   When the target object is likely to be a vehicle, then this component should be present, otherwise it should not be provided.  

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

  the optional estimated distance in which the vehicle would need to come to a complete hold, if no obstruction was in the way. 

```asn1

PreCrashContainer ::= SEQUENCE { 

    perceivedPreCrashObject   PerceivedObject, 

    objectStationId           StationId OPTIONAL, 

    timeToCollision           DeltaTimeMilliSecondPositive OPTIONAL, 

    impactSection             ObjectFace OPTIONAL, 

    estimatedBrakingDistance  StandardLength12b OPTIONAL,

    ... 

}

```

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

This type contains detailed information about the configuration of road section(s) that are geographically related to the event.

 It shall include the following components:

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

  information about the source of the road configuration and the confidence in the information.

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

  a list of road configuration information per applicable road section. 

```asn1

RoadConfigurationContainer ::=  SEQUENCE {

    roadConfigurationConfidence     MetaInformation,

    roadConfigurationSectionList    RoadConfigurationSectionList,

    ...

}

```

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

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

* _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. 

   If present, a recommended path shall be 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.

  the optional effective starting position of a speed limit being applied to the roadwork zone, w.r.t. the component eventPosition on the Management Container.

   This component shall be present if the speed limit is applied at a certain distance prior to the roadwork zone starting position.

* _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.

  optional the ambient temperature at the event position.

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

  the information of the roadwork zone.

  optional 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.

* _precrash_ of type [**PreCrashContainer**](#PreCrashContainer)  OPTIONAL ]]<br>

  the optional information about perceived objects that represent hazards and/or could be subject of collisions. 

       ...,

   [[  roadConfiguration 	RoadConfigurationContainer OPTIONAL,

* roadConfiguration<br>

  optional information about the configuration of the road.

```asn1

AlacarteContainer ::= SEQUENCE {

    lanePosition        LanePosition OPTIONAL,

    roadWorks           RoadWorksContainerExtended OPTIONAL,

    positioningSolution PositioningSolutionType OPTIONAL,

    stationaryVehicle   StationaryVehicleContainer OPTIONAL,

	...

    ...,

[[  roadConfiguration 	RoadConfigurationContainer OPTIONAL,

    precrash            PreCrashContainer OPTIONAL ]]

}

```