Commit ec58860a authored by ASN.1 Checker's avatar ASN.1 Checker
Browse files

Documentation update

parent 91b4236a

docs/IMZM-PDU-Descriptions.md

0 → 100644
+419 −0
Original line number Diff line number Diff line 
# ASN.1 module IMZM-PDU-Descriptions

 OID: _{ itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) ts (103724) imzm (1) version (1) }_

 Specification of the Interference Management Zone Message ETSI TS 103 724

 Latest version available at https://forge.etsi.org/rep/ITS/asn1/imzm_ts103724



## Imports:

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

    Include ETSI TS 102 894-2

    Include references from https://forge.etsi.org/rep/ITS/asn1/cdd_ts102894_2/blob/master/ITS-Container.asn



 * **[CAM-PDU-Descriptions](CAM-PDU-Descriptions.md)** *{ itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) en (302637) cam (2) version (2) }*<br/>

    Include ETSI EN 302 637-2

    Include references from https://forge.etsi.org/rep/ITS/asn1/cam_en302637_2/blob/master/CAM-PDU-Descriptions.asn



 * **[VAM-Temp-Imports](VAM-Temp-Imports.md)** *{ itu-t(0) identified-organization(4) etsi(0) itsDomain(5) wg1(1) ts(103300) temp-imports(255) version1(1) }*<br/>

    Include ETSI TS 103 300-3

    All data types, imported from `VAM-Temp-Imports` will be imported from the CDD ETSI TS 102 894-2 Release 2 when available

    Include references from https://forge.etsi.org/rep/ITS/asn1/vam-ts103300_3/blob/master/VAM-Temp-Imports.asn



## Data Elements:

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



 DF: Interference Management Zone Message Root

 This DF includes DEs for the IMZM `protocolVersion`, the IMZ message type identifier `messageID`

 and the station identifier `stationID` of the originating ITS-S.



Fields:

* header [**ItsPduHeader**](ITS-Container.md#ItsPduHeader) <br>

    header

    - The DE `protocolVersion` is used to select the appropriate protocol decoder at the receiving

      ITS-S. For TS 103 724 V2.1.1, the value of the DE `protocolVersion` shall be set to 1.

    - The DE `messageID` shall be harmonized with other V2X message identifier definitions.

      For IMZM, the DE messageID shall be set to `imzm(15)`.

* imzm [**InterferenceManagementZoneMessage**](#InterferenceManagementZoneMessage) <br>

```asn1

IMZM ::= SEQUENCE {

   header ItsPduHeader,

   imzm InterferenceManagementZoneMessage

}

```



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



 DF: Interference Management Zone Message

 This is the actual IMZM Payload. It shall include the time stamp of the IMZM and the applicable

 containers of type `BasicContainer` and `ImzmContainer`.



Fields:

* generationDeltaTime [**GenerationDeltaTime**](CAM-PDU-Descriptions.md#GenerationDeltaTime) <br>

* imzmParameters [**ImzmParameters**](#ImzmParameters) <br>

```asn1

InterferenceManagementZoneMessage ::= SEQUENCE {

   generationDeltaTime GenerationDeltaTime, 

   imzmParameters ImzmParameters

}

```



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



 DF: IMZM Parameters

 The sequence of containers in the IMZM. Other containers may be added in the future.



Fields:

* basicContainer [**BasicContainer**](CAM-PDU-Descriptions.md#BasicContainer) <br>

    basicContainer

    imported from CAM-PDU-Descriptions

* imzmContainer [**ImzmContainer**](#ImzmContainer) <br>

    imzmContainer

    container specific to the IMZM

```asn1

ImzmParameters ::= SEQUENCE {

    basicContainer BasicContainer, 

    imzmContainer ImzmContainer,

   ...

}

```



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



 DF: IMZM Container

 The IMZM container includes a sequence of up to 16 interference management zones.

 For each interference management zones, it contains a sequence of interference

 management zones per channel together with their characteristics.



Fields:

* interferenceManagementZones [**InterferenceManagementZones**](#InterferenceManagementZones) <br>

    interferenceManagementZones

    mapped to the DF_ProtectedCommunicationZone in ETSI TS 102 894-2

```asn1

ImzmContainer ::= SEQUENCE {

    interferenceManagementZones InterferenceManagementZones,

    ...

}

```



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



 DF: List of Interference Management Zones

 A list of up to 16 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.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Infrastructure information](#Infrastructure+information) [Communication information](#Communication+information) 







```asn1

InterferenceManagementZones ::= SEQUENCE (SIZE(1..16), ...) OF InterferenceManagementZone

```



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



 DF: Interference Management Zone

 Describes a zone of interferenceManagement inside which the ITS communication should

 be restricted.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Infrastructure information](#Infrastructure+information) [Communication information](#Communication+information)



Fields:

* zoneDefinition [**ZoneDefinition**](#ZoneDefinition) <br>

* interferenceManagementInfo [**InterferenceManagementInfo**](#InterferenceManagementInfo) <br>

```asn1

InterferenceManagementZone ::= SEQUENCE {

	zoneDefinition             ZoneDefinition,

	interferenceManagementInfo InterferenceManagementInfo

}

```



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



 DF: Zone Definition

 Describes the zone where band sharing occurs. When reusing CDD Rel.1 types, names are unchanged.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Infrastructure information](#Infrastructure+information) [Communication information](#Communication+information)



Fields:

* interferenceManagementZoneLatitude [**Latitude**](ITS-Container.md#Latitude) <br>

    interferenceManagementZoneLatitude

    Latitude of the centre point of the interference management zone.

* interferenceManagementZoneLongitude [**Longitude**](ITS-Container.md#Longitude) <br>

    interferenceManagementZoneLongitude

    Longitude of the centre point of the interference management zone.

* interferenceManagementZoneRadius [**ProtectedZoneRadius**](ITS-Container.md#ProtectedZoneRadius)  OPTIONAL<br>

    interferenceManagementZoneRadius

    Radius of the interference management zone in metres.

    This DE is present if the data is available

* interferenceManagementZoneID [**ProtectedZoneID**](ITS-Container.md#ProtectedZoneID)  OPTIONAL<br>

    interferenceManagementZoneID

    Identification of the interference management zone.

    This DE is present if the data is available.

* interferenceManagementZoneShape [**InterferenceManagementZoneShape**](#InterferenceManagementZoneShape)  OPTIONAL<br>

    interferenceManagementZoneShape

    Shape of the interference management zone.

    This DF is present if the data is available.

```asn1

ZoneDefinition::= SEQUENCE{     

    interferenceManagementZoneLatitude   Latitude, 

    interferenceManagementZoneLongitude  Longitude, 

    interferenceManagementZoneRadius     ProtectedZoneRadius OPTIONAL, 

    interferenceManagementZoneID         ProtectedZoneID OPTIONAL, 

    interferenceManagementZoneShape      InterferenceManagementZoneShape OPTIONAL,

    ...

}

```



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



 DF: Interference Management Information

 A list of up to 16 definitions containing which interference management may be applied in the zone,

 per affected frequency channels.



 **Note**: in the case where no mitigation should be applied by the ITS-S, this is indicated

 by the value of interferenceManagementMitigationType set to unavailable.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Infrastructure information](#Infrastructure+information) [Communication information](#Communication+information) 







```asn1

InterferenceManagementInfo::= SEQUENCE (SIZE(1..16,...)) OF InterferenceManagementInfoPerChannel

```



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



 DF: Interference Management Information Per Channel

 A break up of the interference management information per affected frequency channels.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Infrastructure information](#Infrastructure+information) [Communication information](#Communication+information)



Fields:

* interferenceManagementChannel [**InterferenceManagementChannel**](#InterferenceManagementChannel) <br>

    interferenceManagementChannel

    Characteritics of the frequency channel for which the zone

    should be applied interference management

* interferenceManagementZoneType [**InterferenceManagementZoneType**](#InterferenceManagementZoneType) <br>

    interferenceManagementZoneType

    Type of the interference management zone.

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

    interferenceManagementMitigationType

    Type of the mitigation to be used in the interference management zone.

* expiryTime [**TimestampIts**](ITS-Container.md#TimestampIts)  OPTIONAL<br>

    expiryTime

    Time at which the validity of the interference management communication zone will expire.

    This DE is present when the interference management is temporarily valid

```asn1

InterferenceManagementInfoPerChannel ::= SEQUENCE {

    interferenceManagementChannel         InterferenceManagementChannel,

    interferenceManagementZoneType        InterferenceManagementZoneType,

    interferenceManagementMitigationType  InterferenceManagementMitigationType OPTIONAL,

    expiryTime                            TimestampIts OPTIONAL, 

    ...

}

```



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



 DF: InterferenceManagementChannel

 Indicates which shared frequency channel should be applied interference management in the zone.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Communication information](#Communication+information)



Fields:

* centreFrequency **INTEGER**  (1 .. 99999)<br>

    centre frequency of the channel

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _10exp+2 Hz (where exp is exponent)_



* channelWidth **INTEGER**  (0 .. 9999)<br>

    width of the channel

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _10exp Hz (where exp is exponent)_



* exponent **INTEGER**  (0 .. 15)<br>

    exponent of the power of 10

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _N/A_



```asn1

InterferenceManagementChannel ::= SEQUENCE {

    centreFrequency INTEGER (1 .. 99999),

    channelWidth    INTEGER (0 .. 9999),

    exponent        INTEGER (0 .. 15) 

}

```



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



 DE: InterferenceManagementZoneType

 defines the type of an interference management zone, so that an ITS-S can

 assert the actions to do while passing by such zone (e.g. reduce the transmit

 power in case of a DSRC tolling station).

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Communication information](#Communication+information) 



<br>&nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _N/A_







```asn1

InterferenceManagementZoneType ::= ENUMERATED {

    permanentCenDsrcTolling(0), 

    temporaryCenDsrcTolling(1), 

    unavailable(2),             

    urbanRail(3),               

    satelliteStation(4),        

    fixedLinks(5),              

    ...

}

```



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



 DF: Mitigation type in the interference management zone

 Information and commands defining the required mitigation type the

 receiving ITS-S has to use in the defined interference management zone.

 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.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Communication information](#Communication+information)



Fields:

* unavailable **NULL** <br>

    unavailable is the default value to be used when data is not available.

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

```asn1

InterferenceManagementMitigationType ::= CHOICE {

    unavailable   NULL,   

    mitigationForTechnologies MitigationForTechnologies

}

```



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



 DF: Mitigation type container for the different channel access technology classes

 Class of parameters for the relevant channel access technology classes,

 as specified in ETSI TS 103 724, clause 7.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Communication information](#Communication+information) 







```asn1

MitigationForTechnologies ::= SEQUENCE (SIZE(1..8)) OF MitigationPerTechnologyClass

```



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



 DF: Mitigation type container per channel access technology class

 Class of parameters for the specific technology indicated in the container.

 All parameters are optional, as they may not apply to some of the technologies or

 interference management zone types. Specification details are in ETSI TS 103 724, clause 7.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Communication information](#Communication+information)



Fields:

* accessTechnologyClass [**AccessTechnologyClass**](#AccessTechnologyClass) <br>

    channel access technology in which this mitigation is applied.

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _N/A_



* lowDutyCycle **INTEGER**  (0 .. 10000) OPTIONAL<br>

    duty cycle limit.

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _0.01% steps_



* powerReduction **INTEGER**  (0 .. 30) OPTIONAL<br>

    power reduction.

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _dB_



* dmcToffLimit **INTEGER**  (0 .. 1200) OPTIONAL<br>

    Idle time limit as defined in ETSI TS 103 175.

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _ms_



* dmcTonLimit **INTEGER**  (0 .. 20) OPTIONAL<br>

    Transmission duration limit, as defined in ETSI EN 302 571.

<br>   &nbsp;&nbsp;&nbsp;&nbsp;**Unit**: _ms_



```asn1

MitigationPerTechnologyClass ::= SEQUENCE {

   accessTechnologyClass  AccessTechnologyClass, 

   lowDutyCycle  INTEGER (0 .. 10000) OPTIONAL, 

   powerReduction INTEGER (0 .. 30) OPTIONAL,

   dmcToffLimit   INTEGER (0 .. 1200) OPTIONAL,   

   dmcTonLimit   INTEGER (0 .. 20) OPTIONAL,   

   ...

}

```



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



 DE: channel access technology class

 Access technology to which the mitigation type applies.

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [Communication information](#Communication+information) 







```asn1

AccessTechnologyClass ::= ENUMERATED {

   any(0),         

   itsg5Class(1),  

   ltev2xClass(2), 

   nrv2xClass(3),  

   ...

}

```



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



 DF: Shape of the interference management zone

 Bounding box of an interference management  zone

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [GeoReference information](#GeoReference+information)



Fields:

* rectangle [**AreaRectangle**](VAM-Temp-Imports.md#AreaRectangle) <br>

* circle [**AreaCircular**](VAM-Temp-Imports.md#AreaCircular) <br>

* polygon [**AreaPolygon**](VAM-Temp-Imports.md#AreaPolygon) <br>

* ellipse [**AreaEllipse**](#AreaEllipse) <br>

```asn1

InterferenceManagementZoneShape::= CHOICE {

   rectangle    AreaRectangle, 

   circle       AreaCircular,  

   polygon      AreaPolygon,   

   ellipse      AreaEllipse,   

   ...

}

```



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



 DF: Area Ellipse

 Area Ellipse copied from CPM TR 103 562. Will be removed when CDD Release 2 is available.

 Describes an elliptical area. The ellipse is centred about the reference point

 of the ITS-S or about the nodeCenterPoint (if provided).

 

&nbsp;&nbsp;&nbsp;&nbsp;**Categories**: [GeoReference information](#GeoReference+information)



Fields:

* nodeCenterPoint [**OffsetPoint**](VAM-Temp-Imports.md#OffsetPoint)  OPTIONAL<br>

    nodeCenterPoint

    Optional offset point about which the ellipse is centred with respect to the reference

    position of the ITS-S.

* semiMajorRangeLength [**SemiRangeLength**](VAM-Temp-Imports.md#SemiRangeLength) <br>

    semiMajorRangeLength

    Minor radius of the ellipse.

* semiMinorRangeLength [**SemiRangeLength**](VAM-Temp-Imports.md#SemiRangeLength) <br>

    semiMinorRangeLength

    Major radius of the ellipse.

* semiMajorRangeOrientation [**WGS84AngleValue**](VAM-Temp-Imports.md#WGS84AngleValue) <br>

    semiMajorRangeOrientation

    Orientation of the semiMajorRangeLength of the ellipse in the WGS84 coordinate system.

```asn1

AreaEllipse  ::= SEQUENCE {

    nodeCenterPoint             OffsetPoint OPTIONAL,

    semiMajorRangeLength        SemiRangeLength,

    semiMinorRangeLength        SemiRangeLength,

    semiMajorRangeOrientation   WGS84AngleValue

}

```

docs/ITS-Container.md

+2 −2
Original line number Diff line number Diff line
@@ -7,7 +7,7 @@ 
Fields:

* protocolVersion **INTEGER**  (0..255)<br>

* messageID **INTEGER** { denm(1), cam(2), poi(3), spatem(4), mapem(5), ivim(6), ev-rsr(7), tistpgtransaction(8), srem(9), ssem(10), evcsn(11), saem(12), rtcmem(13) } (0..255)<br>

* stationID [**StationID**](ITS-Container.md#StationID) <br>

* stationID [**StationID**](#StationID) <br>

```asn1

ItsPduHeader ::= SEQUENCE {

    protocolVersion INTEGER (0..255),
@@ -1112,7 +1112,7 @@ ValidityDuration ::= INTEGER {timeOfDetection(0), oneSecondAfterDetection(1)} 
### <a name="ActionID"></a>ActionID



Fields:

* originatingStationID [**StationID**](ITS-Container.md#StationID) <br>

* originatingStationID [**StationID**](#StationID) <br>

* sequenceNumber [**SequenceNumber**](#SequenceNumber) <br>

```asn1

ActionID ::= SEQUENCE {