Commit ec54acf5 authored by ASN.1 Documenter's avatar ASN.1 Documenter
Browse files

update documentation

parent cc10ea97
Loading
Loading
Loading
Loading
+75 −101
Original line number Diff line number Diff line
--! @brief Specification of the Interference Management Zone Message ETSI TS 103 724
--! Latest version available at @url https://forge.etsi.org/rep/ITS/asn1/imzm_ts103724
--! Specification of the Interference Management Zone Message ETSI TS 103 724<br/>  
--! Latest version available at https://forge.etsi.org/rep/ITS/asn1/imzm_ts103724

IMZM-PDU-Descriptions {
itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) ts (103724) imzm (1) version (1)
@@ -10,168 +10,143 @@ DEFINITIONS AUTOMATIC TAGS ::=
BEGIN

IMPORTS 
--! @brief Include ETSI TS 102 894-2
--! Include references from @url https://forge.etsi.org/rep/ITS/asn1/cdd_ts102894_2/blob/master/ITS-Container.asn
--! Include ETSI TS 102 894-2 references from https://forge.etsi.org/rep/ITS/asn1/cdd_ts102894_2/blob/master/ITS-Container.asn
ItsPduHeader, Latitude, Longitude, TimestampIts, ProtectedZoneRadius, ProtectedZoneID FROM ITS-Container {
itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) 
ts (102894) cdd (2) version (2) 
}

--! brief Include ETSI EN 302 637-2
--! Include references from @url https://forge.etsi.org/rep/ITS/asn1/cam_en302637_2/blob/master/CAM-PDU-Descriptions.asn
--! Include ETSI EN 302 637-2 references from https://forge.etsi.org/rep/ITS/asn1/cam_en302637_2/blob/master/CAM-PDU-Descriptions.asn
BasicContainer, GenerationDeltaTime FROM CAM-PDU-Descriptions { 
itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) 
en (302637) cam (2) version (2)
}

--! @brief Include ETSI TS 103 300-3
--! This is temporary 
--! Import from VAM-Temp-Imports will be changed to CDD ETSI TS 102 894-2 Release 2 when available
--! Include references from @url https://forge.etsi.org/rep/ITS/asn1/vam-ts103300_3/blob/master/VAM-Temp-Imports.asn
--! Include ETSI TS 103 300-3 references from https://forge.etsi.org/rep/ITS/asn1/vam-ts103300_3/blob/master/VAM-Temp-Imports.asn  
--!     *This is temporary*   
--!     *Import from **VAM-Temp-Imports** will be changed to CDD ETSI TS 102 894-2 Release 2 when available*
AreaCircular, AreaRectangle, AreaPolygon, OffsetPoint, SemiRangeLength, WGS84AngleValue FROM VAM-Temp-Imports { 
itu-t(0) identified-organization(4) etsi(0) itsDomain(5) wg1(1)  
ts(103300) temp-imports(255) version1(1)
}
;

--! @defgroup IMZM Interference Management Zone Message
--! @{
--! _Interference Management Zone Message Root_

--! @brief DF- Interference Management Zone Message Root
--! This DF includes DEs for the IMZM protocolVersion, the IMZ message type identifier _messageID_ 
--! This DF includes DEs for the IMZM _protocolVersion_, the IMZ message type identifier _messageID_ 
--! and the station identifier _stationID_ of the originating ITS-S.
IMZM ::= SEQUENCE {
    --! @details 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.
--! * 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 @todo imzm(15).  
   header ItsPduHeader,
   imzm InterferenceManagementZoneMessage
}

--! @brief 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_.
--! This is the actual @ref IMZM Payload. It shall include the time stamp of the @ref IMZM and the applicable
--! containers of type @ref BasicContainer and @ref ImzmContainer.
InterferenceManagementZoneMessage ::= SEQUENCE {
   generationDeltaTime GenerationDeltaTime, -- from CAM-PDU-Descriptions
   imzmParameters ImzmParameters
}

--! @brief DF- IMZM Parameters
--! The sequence of containers in the IMZM. Other containers may be added in the future.
--! The sequence of containers in the @ref IMZM. Other containers may be added in the future.

ImzmParameters ::= SEQUENCE {
    --! @details basicContainer
    --! imported from CAM-PDU-Descriptions
    basicContainer BasicContainer, 
    --! @details imzmContainer
    --! container specific to the IMZM
    --! container specific to the @ref IMZM
    imzmContainer ImzmContainer,
   ...
}

--! @brief DF- IMZM Container
--! The IMZM container includes a sequence of up to 16 interference management communication zones. 
--! For each interference management communication zones, it contains a sequence of interference 
--! management zones per channel together with their characteristics.
ImzmContainer ::= SEQUENCE {
    --! @details interferenceManagementZones
    --! mapped to the DF_ProtectedCommunicationZone in ETSI TS 102 894-2 
    --! Mapped to the DF @ref ProtectedCommunicationZone in ETSI TS 102 894-2
    interferenceManagementZones InterferenceManagementZones,
    ...
}

--! @brief DF- InterferenceManagementZones
--! A list of up to 16 interference management communication zones.
--!
--! EXAMPLE: An interference management communication zone may be defined around a 
--!          CEN DSRC road side equipment or an urban rail operational area.  
--!
--! @category: Infrastructure information, Communication information
InterferenceManagementZones ::= SEQUENCE (SIZE(1..16)) OF InterferenceManagementZone

--! @brief DF- InterferenceManagementZone
--! describes a zone of interferenceManagement inside which the ITS communication should
--! Describes a zone of interferenceManagement inside which the ITS communication should
--! be restricted.
--!
--! @category: Infrastructure information, Communication information
InterferenceManagementZone ::= SEQUENCE {
	zoneDefinition             ZoneDefinition,
	interferenceManagementInfo InterferenceManagementInfo
}

--! @brief DF- ZoneDefinition
--! describes the zone where band sharing occurs. When reusing CDD Rel.1 types, names are unchanged.
--! Describes the zone where band sharing occurs. When reusing CDD Rel.1 types, names are unchanged.
--!
--! @category: Infrastructure information, Communication information

ZoneDefinition::= SEQUENCE{     
	 --! @details interferenceManagementZoneLatitude
    --! Latitude of the centre point of the interference management zone.
    interferenceManagementZoneLatitude   Latitude, --! from ITS-Container
     --! @details interferenceManagementZoneLongitude
    --! Longitude of the centre point of the interference management zone.
    interferenceManagementZoneLongitude  Longitude, --! from ITS-Container
     --! @details interferenceManagementZoneRadius
    --! Radius of the interference management zone in metres. 
     --! This DE is present if the data is available
    interferenceManagementZoneRadius     ProtectedZoneRadius OPTIONAL, --! from ITS-Container
     --! @details interferenceManagementZoneID
    --! Identification of the interference management zone. 
     --! This DE is present if the data is available.
    interferenceManagementZoneID         ProtectedZoneID OPTIONAL, --! from ITS-Container
     --! @details interferenceManagementZoneShape
    --! Shape of the interference management zone. 
     --! This DF is present if the data is available.
    interferenceManagementZoneShape      InterferenceManagementZoneShape OPTIONAL,
    ...
}

--! @brief DF- Interference Management Info
--! _Interference Management Info_
--! A list of up to 16 definitions of 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 
--! 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.   
--! @category: Infrastructure information, Communication information
InterferenceManagementInfo::= SEQUENCE (SIZE(1..16,...)) OF InterferenceManagementInfoPerChannel

--! @brief DF- InterferenceManagementInfoPerChannel 
--! _InterferenceManagementInfoPerChannel_   
--! A break up of the interference management information per affected frequency channels.  
--!
--! @category: Infrastructure information, Communication information
InterferenceManagementInfoPerChannel ::= SEQUENCE {
     --! @details interferenceManagementChannel
     --! Characteritics of the frequency channel for which the zone
     --! should be applied interference management 
    --! Characteritics of the frequency channel for which the zone should be applied interference management 
    interferenceManagementChannel         InterferenceManagementChannel,
     --! @details interferenceManagementZoneType
    --! Type of the interference management zone. 
    interferenceManagementZoneType        InterferenceManagementZoneType,
     --! @details interferenceManagementMitigationType
    --! Type of the mitigation to be used in the interference management zone.
    interferenceManagementMitigationType  InterferenceManagementMitigationType OPTIONAL,
     --! @details 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
    --! Time at which the validity of the interference management communication zone will expire.<br>
    --! _This DE is present when the interference management is temporarily valid._
    expiryTime                            TimestampIts OPTIONAL, --! from ITS-Container
    ...
}

--! @brief DF- InterferenceManagementChannel
--! indicates which shared frequency channel should be applied interference management in the zone. 
--! Indicates which shared frequency channel should be applied interference management in the zone. 
--!
--! @category: Communication information
InterferenceManagementChannel ::= SEQUENCE {
     --! @details centre frequency of the channel
     --! @unit: 10exp+2 Hz (where exp is exponent)
--!   Center of the channel frequency in 10exp+2 Hz (where exp is exponent)
    centreFrequency INTEGER (1 .. 99999),
     --! @details width of the channel
     --! @unit: 10exp Hz (where exp is exponent)
--!   Width of the channel frequence band in 10exp Hz (where exp is exponent)
    channelWidth    INTEGER (0 .. 9999),
     --! @details exponent of the power of 10
     --! @unit: MHz
--!   Exponent of the power of 10 in Mhz
    exponent        INTEGER (0 .. 15) 
}

--! @brief DE- InterferenceManagementZoneType
--! DE that defines the type of an interference management zone, so that an ITS-S can
--! This DE 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).
--! @unit: N/A
--! power in case of a DSRC tolling station).<br>
--! @category: Communication information

InterferenceManagementZoneType ::= ENUMERATED {
    permanentCenDsrcTolling(0), --! as specified in ETSI TS 102 792
    temporaryCenDsrcTolling(1), --! as specified in ETSI TS 102 792
@@ -182,44 +157,40 @@ InterferenceManagementZoneType ::= ENUMERATED {
    ...
}

--! @brief DF- Mitigation type in the interference management zone
--! This DE defines the 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.
--! @category: Communication information
InterferenceManagementMitigationType ::= SEQUENCE {
     --! @details Default value to be used when data is not available. 
    --! Default value to be used when data is not available
    unavailable   BOOLEAN OPTIONAL,   
    mitigationForTechnologies MitigationForTechnologies
}

--! @brief DF- Mitigation type container for the different channel access technology classes 
--! This DE defines the mitigation type container for the different channel access technology classes.<br> 
--! Class of parameters for the relevant channel access technology classes,
--! as specified in ETSI TS 103 724, clause 7. 
--! @category: Communication information
MitigationForTechnologies ::= SEQUENCE (SIZE(1..8)) OF MitigationPerTechnologyClass

--! @brief DF- Mitigation type container per channel access technology class 
--! This DE defines the mitigation type container per channel access technology class <br>
--! 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. 
--! @category: Communication information
MitigationPerTechnologyClass ::= SEQUENCE {
     --! @details channel access technology in which this mitigation is applied.
     --! @unit: N/A
     --! Channel access technology in which this mitigation is applied.
   accessTechnologyClass  AccessTechnologyClass, 
     --! @details duty cycle limit.
     --! @unit: 0.01% steps
     --! Duty cycle limit in 0.01% steps
   lowDutyCycle  INTEGER (0 .. 10000) OPTIONAL, 
     --! @details power reduction.
     --! @unit: dB
     --! Power reduction in dB
   powerReduction INTEGER (0 .. 30) OPTIONAL,
     --! @details Idle time limit as defined in ETSI TS 103 175.
     --! @unit: ms
     --! Idle time limit in ms as defined in ETSI TS 103 175.
   dmcToffLimit   INTEGER (0 .. 1200) OPTIONAL,   
     --! @details Transmission duration limit, as defined in ETSI EN 302 571.
     --! @unit: ms
     --! Transmission duration limit in ms, as defined in ETSI EN 302 571.
   dmcTonLimit   INTEGER (0 .. 20) OPTIONAL,   
   ...
}
@@ -228,10 +199,14 @@ MitigationPerTechnologyClass ::= SEQUENCE {
--! Access technology to which the mitigation type applies.
--! @category: Communication information
AccessTechnologyClass ::= ENUMERATED {
   unavailable(0), --! default value.
   itsg5Class(1),  --! ITS-G5 access technology class.
   ltev2xClass(2), --! LTE-V2X access technology class.
   nrv2xClass(3), --! NR-V2X access technology class.
   --! default value.
   unavailable(0),
   --! ITS-G5 access technology class.
   itsg5Class(1), 
   --! LTE-V2X access technology class.
   ltev2xClass(2),
   --! NR-V2X access technology class.
   nrv2xClass(3), 
   ...
}

@@ -239,9 +214,9 @@ AccessTechnologyClass ::= ENUMERATED {
--! Bounding box of an interference management  zone
--! @category: GeoReference information
InterferenceManagementZoneShape::= CHOICE {
   rectangle    AreaRectangle, --! imported from VAM-Temp-Imports
   circle       AreaCircular,  --! imported from VAM-Temp-Imports
   polygon      AreaPolygon,   --! imported from VAM-Temp-Imports
   rectangle    AreaRectangle,
   circle       AreaCircular, 
   polygon      AreaPolygon,
   ellipse      AreaEllipse, --! could not be imported from another specification yet
   ...
}
@@ -266,5 +241,4 @@ AreaEllipse ::= SEQUENCE {
    --! Orientation of the semiMajorRangeLength of the ellipse in the WGS84 coordinate system.
    semiMajorRangeOrientation   WGS84AngleValue
}
--! @}
END