ITS-Container.asn

ITS-Container {
itu-t (0) identified-organization (4) etsi (0) itsDomain (5) wg1 (1) ts (102894) cdd (2) version (2) 
}

DEFINITIONS AUTOMATIC TAGS ::=

BEGIN

/**
 * Common message header for application and facilities layer messages.
 * It is included at the beginning of an ITS message as the message header.
 * Test
 *
 * @param protocolVersion: version of the ITS message,
 *
 * @param messageID: Type of the ITS message.
 *  Following message type values are assigned in the present document:
 *	- 1 `denm`: Decentralized Environmental Notification Message (DENM) as specified in ETSI EN 302 637-3 [i.3],
 *  - 2 `cam`: Cooperative Awareness Message (CAM) as specified in ETSI EN 302 637-2 [i.2],
 *  - 3 `poi`: Point of Interest message as specified in ETSI TS 101 556-1 [i.11],
 *  - 4 `spatem`: Signal Phase And Timing (SPAT) message as specified in SAE J2735 [i.12] and in ETSI TS 103 301 [i.17],
 *  - 5 `mapem`: MAP message as specified in SAE J2735 [i.12] and in ETSI TS 103 301 [i.17],
 *  - 6 `ivim`: In Vehicle Information (IVI) message as defined in ISO TS 19321 [i.13],
 *  - 7 `ev-rsr`: Electric vehicle recharging spot reservation message, as defined in ETSI TS 101 556-3 [i.14],
 *  - 8 `tistpgtransaction`: messages for Tyre Information System (TIS) and Tyre Pressure Gauge (TPG) interoperability, as specified in ETSI TS 101 556-2 i.15,
 *  - 9 `srem`: Traffic light Signal Request Message as specified in ETSI TS 103 301 [i.17],
 *  - 10 `ssem`: Traffic Light Signal Request Status Message as specified in ETSI TS 103 301 [i.17].
 *  - 11 `evcsn`: Electrical Vehicle Charging Spot Notification message as specified in ETSI TS 101 556-1 [i.11],
 *  - 12 `saem`: Services Announcement Extended Message as specified in ETSI TS 102 890-1 i.19,
 *  - 13 `rtcmem`: Radio Technical Commission for Maritime Services (RTCM) Message as specified in ETSI TS 103 301 [i.17],
 *  - 14-255: reserved for future usage,
 *
 * @param stationID: the identifier of the ITS-S that generates the ITS message in question. It shall be represented as specified in clause A.77 @ref StationID.
 * @category: Communication information
 */
ItsPduHeader ::= SEQUENCE {
    protocolVersion INTEGER (0..255),
    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),  -- Mantis #7209, #7005
    stationID StationID
}

/**
 * Identifier for an ITS-S.
 *
 * The ITS-S ID may be a pseudonym. It may change over space and/or over time.
 *
 * The DE is used in @ref ActionID DF as defined in clause A.102 and @ref ItsPduHeader DF as defined in clause A.114.
 */
StationID ::= INTEGER(0..4294967295)

/**
 * The geographical position of a position or of an ITS-S. It represents a geographical point position.
 *
 * @field latitude: A latitude of the geographical point; it shall be presented as specified in clause A.41,
 *
 * @field longitude: A longitude of the geographical point; it shall be presented as specified in clause A.44,
 *
 * @field positionConfidenceEllipse: An accuracy of the geographical position; it shall be presented as specified in clause A.119,
 *
 * @field altitude: An altitude and an altitude accuracy of the geographical point; it shall be presented as specified in clause A.103.
 *
 * The DF is used in @ref ItineraryPath DF as defined in clause A.113.
 * @category: GeoReference information
 */
ReferencePosition ::= SEQUENCE {
    latitude Latitude,
    longitude Longitude,
    positionConfidenceEllipse PosConfidenceEllipse,
    altitude Altitude
}

/**
 * Defines a geographical point position as offset position to a reference geographical point.
 *
 * The DF is used in @ref EventPoint DF as defined in clause A.111 and in @ref PathPoint DF as defined in clause A.118
 * 
 * @field deltaLatitude A delta latitude offset with regards to the latitude value of the reference position.
 *   It shall be presented as defined in clause A.20
 *
 * @field deltaLongitude A delta longitude offset with regards to the longitude value of the reference position.
 *   It shall be presented as defined in clause A.21
 *
 * @field deltaAltitude A delta altitude offset with regards to the altitude value of the reference position.
 *   It shall be presented as defined in clause A.19
 *
 * @category: GeoReference information
 */
DeltaReferencePosition ::= SEQUENCE {
    deltaLatitude DeltaLatitude,
    deltaLongitude DeltaLongitude,
    deltaAltitude DeltaAltitude
}

/**
 * Absolute geographical longitude in a WGS84 co-ordinate system, providing a range of 180 degrees
 * to the east or to the west of the prime meridian.
 *
 * - Negative values are used for longitudes to the west,
 * - Positive values are used for longitudes to the east.
 * - When the information is unavailable, the value shall be set to _1 800 000 001_.
 *
 * The DE is used in
 * @ref CenDsrcTollingZone DF as defined in clause A.105,
 * @ref ProtectedCommunicationZone DF as defined in clause A.121 and
 * @ref ReferencePosition DF as defined in clause A.124.
 * @unit: 0.1 microdegree
 * @category: GeoReference information
 */
Longitude ::= INTEGER {
    oneMicrodegreeEast (10),
    oneMicrodegreeWest (-10),
    unavailable(1800000001)
} (-1800000000..1800000001)

/**
 * Absolute geographical latitude in a WGS84 coordinate system, providing a range of 90 degrees in north or
 * in south hemisphere.
 *
 * - Positive values are used for latitude in north of the Equator,
 * - Negative values are used for latitude in south of the Equator.
 * - When the information is unavailable, the value shall be set to _900 000 001_.
 *
 * The DE is used in
 * @ref CenDsrcTollingZone DF as defined in clause A.105, 
 * @ref ProtectedCommunicationZone DF as defined in clause A.121 and
 * @ref ReferencePosition DF as defined in clause A.124.
 * @unit: 0.1 microdegree
 * @category: GeoReference information
 */
Latitude ::= INTEGER {
    oneMicrodegreeNorth (10),
    oneMicrodegreeSouth (-10),
    unavailable(900000001)
} (-900000000..900000001)

/**
 * Altitude and accuracy of an altitude in a WGS84 co-ordinate system.
 *
 * @field altitudeValue: altitude of a geographical point.
 *        It shall be presented as specified in clause A.9 AltitudeValue,
 *
 * @field altitudeConfidence: accuracy of the reported altitudeValue within a specific confidence level.
 *        It shall be presented as specified in clause A.8.
 *
 * This DF is used in @ref ReferencePosition DF as defined in clause A.124.
 * @category: GeoReference information
 */
Altitude ::= SEQUENCE {
    altitudeValue AltitudeValue,
    altitudeConfidence AltitudeConfidence
}

/**
 * Altitude in a WGS84 co-ordinate system.
 * - When the information is not available, the DE shall be set to _800 001_.
 * - For altitude equal or greater than _8 000 m_, the DE shall be set to _800 000_.
 * - For altitude equal or less than _-1 000_ m, the DE shall be set to  _100 000_.
 *
 * The DE is used in @ref Altitude DF as defined in clause A.103.
 * @unit: 0.1 meter
 * @category: GeoReference information
 */
AltitudeValue ::= INTEGER {
    referenceEllipsoidSurface(0),
    oneCentimeter(1),
    unavailable(800001)
} (-100000..800001)

/**
 * Absolute accuracy of a reported altitude value of a geographical point for a predefined confidence level (e.g. 95 %).
 * The required confidence level is defined by the corresponding standards applying the usage of this DE.
 *
 * The DE is used in @ref Altitude DF as defined in clause A.103
 *
 * @note: The fact that an altitude value is received with confidence set to `unavailable(15)` can be caused
 * by several reasons, such as:
 * - the sensor cannot deliver the accuracy at the defined confidence level because it is a low-end sensor,
 * - the sensor cannot calculate the accuracy due to lack of variables, or
 * - there has been a vehicle bus (e.g. CAN bus) error.
 * In all 3 cases above, the reported altitude value may be valid and used by the application.
 * 
 * @note: If an altitude value is received and its confidence is set to `outOfRange(14)`, it means that the reported 
 * altitude value is not valid and therefore cannot be trusted. Such value is not useful for the application.
 *
 * The value shall be set to: 
 *   - 0 `alt-000-01` if the altitude accuracy is equal to or less than 0,01 metre
 *   - 1 `alt-000-02` if the altitude accuracy is equal to or less than 0,02 metre
 *   - 2 `alt-000-05` if the altitude accuracy is equal to or less than 0,05 metre            
 *   - 3 `alt-000-10` if the altitude accuracy is equal to or less than 0,1 metre             
 *   - 4 `alt-000-20` if the altitude accuracy is equal to or less than 0,2 metre             
 *   - 5 `alt-000-50` if the altitude accuracy is equal to or less than 0,5 metre             
 *   - 6 `alt-001-00` if the altitude accuracy is equal to or less than 1 metre               
 *   - 7 `alt-002-00` if the altitude accuracy is equal to or less than 2 metres              
 *   - 8 `alt-005-00` if the altitude accuracy is equal to or less than 5 metres              
 *   - 9 `alt-010-00` if the altitude accuracy is equal to or less than 10 metres             
 *   - 10 `alt-020-00` if the altitude accuracy is equal to or less than 20 metres            
 *   - 11 `alt-050-00` if the altitude accuracy is equal to or less than 50 metres            
 *   - 12 `alt-100-00` if the altitude accuracy is equal to or less than 100 metres           
 *   - 13 `alt-200-00` if the altitude accuracy is equal to or less than 200 metres           
 *   - 14 `outOfRange` if the altitude accuracy is out of range, i.e. greater than 200 metres