ITS-Container.asn 252 KB
Newer Older
tijinkj's avatar
tijinkj committed
        UNECE/TRANS/WP.29/78/Rev.4 [i.16] class O,
tijinkj's avatar
tijinkj committed
 * - 10 `specialVehicles`: ITS-S mounted on vehicles which have special purposes other than the above (e.g. moving road works vehicle),
 * - 11 `tram`: ITS-S mounted on a vehicle which runs on tracks along public streets,
 * - 12 `lightVruVehicle`: ITS-S carried by a human being traveling on light vehicle , incl. possible use of roller skates or skateboards (VRU profile 2).
 * - 13 `animal`: ITS-S carried by an animal presenting a safety risk to other road users e.g. domesticated dog in a city or horse (VRU Profile 4)
 * - 14  reserved for future usage
 * - 15 `roadSideUnit`: ITS-S mounted on an infrastructure typically positioned outside of the drivable roadway (e.g. on a gantry, on a pole, 
        on a stationary road works trailer); the infrastructure is static during the entire operation period of the ITS-S (e.g. no stop and go activity),
 * - 16-255> reserved for future usage.
 * 
 * @category: Communication information.
 * @revision: revised in V2.1.1 (named values 12 and 13 added and note to value 9 deleted)
 */
StationType ::= INTEGER {
    unknown         (0), 
    pedestrian      (1), 
    cyclist         (2), 
    moped           (3), 
    motorcycle      (4), 
    passengerCar    (5), 
    bus             (6), 
    lightTruck      (7), 
    heavyTruck      (8), 
    trailer         (9), 
tijinkj's avatar
tijinkj committed
    specialVehicle  (10), 
tijinkj's avatar
tijinkj committed
    tram            (11), 
    lightVruVehicle (12), 
    animal          (13), 
    roadSideUnit    (15)
} (0..255)
tijinkj's avatar
tijinkj committed
/**
 * This DE represents the absolute accuracy for a reported steering wheel angle value for a confidence level of 95 %.
 * 
 * The value shall be set to:
 * - `n (n > 0 and n < 126)` if the steering wheel angle accuracy is equal to or less than n x 1,5 degrees,
 * - `126` if the accuracy is out of range, i.e. greater than 187,5 degrees,
 * - `127` if the accuracy information is not available.
 * 
 * @note 1: The fact that a steering wheel angle value is received with confidence set to 'unavailable(127)'
 * 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 steering wheel angle value may be valid and used by the application.
 * 
 * If a steering wheel angle value is received and its confidence is set to 'outOfRange(126)',
 * it means that the reported steering wheel angle value is not valid and therefore cannot be trusted.
 * Such value is not useful for the application.
 * 
 * @unit: 1.5 degree
 * @category: Vehicle Information
 * @revision: Description revised in V2.1.1
*/
SteeringWheelAngleConfidence ::= INTEGER {
    outOfRange                      (126), 
    unavailable                     (127)
} (1..127)

/**
 * This DE represents the steering wheel angle of the vehicle at certain point in time.
 * It corresponds to the vehicle coordinate system as specified in ISO 8855 [2].
 * 
 * The value shall be set to:
 * - `-511` if the steering wheel angle is equal to or greater than 511 x 1,5 degrees = 766,5 degrees to the right.
 * - `n (n > -511 and n <= 0)` if  the steering wheel angle is equal to or less than n x 1,5 degrees, and greater than (n-1) x 1,5 degrees, 
      turning clockwise (i.e. to the right).
 * - `n (n > 1 and n < 511)` if the steering wheel angle is equal to or less than n x 0,1 degrees, and greater than (n-1) x 0,1 degrees, 
      turning counter-clockwise (i.e. to the left).
 * - `511` if the steering wheel angle is greater than 510 x 1,5 degrees = 765 degrees to the left.
 * - `512` if information is not available.
 *
 * @unit: 1.5 degree
 * @revision: Description revised in V2.1.1 (meaning of value 511 has changed slightly).
 */
SteeringWheelAngleValue ::= INTEGER { 
    negativeOutOfRange (-511),
    positiveOutOfRange (511),
    unavailable        (512)
} (-511..512)

/**
 * This DE indicates the generic sub cause of a detected event.
 * 
 * @note 1: The sub cause code value assignment varies based on value of @ref CauseCode
 *
 * @category: Traffic information
 * @revision: Description revised in V2.1.1 (this is  the generic sub cause type)
 */
SubCauseCodeType ::= INTEGER (0..255)
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates a temperature value.

 * The value shall be set to:
 * - `-60` for temperature equal to or less than -60 degrees C.
 * - `n (n > -60 and n < 67)` for the actual temperature n in degrees C.
 * - `67` for temperature equal to or greater than 67 degrees C.
 * 
 * @unit: degrees Celsius
 * @category: Basic information
 * @revision: Editorial update in V2.1.1
 */
Temperature ::= INTEGER {
    equalOrSmallerThanMinus60Deg (-60), 
    equalOrGreaterThan67Deg(67)} (-60..67)

/**
 * This DE represents the number of elapsed (TAI) milliseconds since the ITS Epoch. 
 * The ITS epoch is `00:00:00.000 UTC, 1 January 2004`.
 * "Elapsed" means that the true number of milliseconds is continuously counted without interruption,
 *  i.e. it is not altered by leap seconds, which occur in UTC.
 * 
 * @note: International Atomic Time (TAI) is the time reference coordinate on the basis of the readings of atomic clocks, 
 * operated in accordance with the definition of the second, the unit of time of the International System of Units. 
 * TAI is a continuous time scale. UTC has discontinuities, as it is occasionally adjusted by leap seconds. 
 * As of 1 January, 2022, TimestampIts is 5 seconds ahead of UTC, because since the ITS epoch on 1 January 2004 00:00:00.000 UTC, 
 * further 5 leap seconds have been inserted in UTC.
 * 
 * EXAMPLE: The value for TimestampIts for 1 January 2007 00:00:00.000 UTC is `94 694 401 000` milliseconds,
 * which includes one leap second insertion since the ITS epoch.
tijinkj's avatar
tijinkj committed
 * @unit: 0,001 s
tijinkj's avatar
tijinkj committed
 * @category: Basic information
 * @revision: Description revised in in V2.1.1
 */
TimestampIts ::= INTEGER (0..4398046511103)

/**
 * This DE represents the value of the sub cause codes of the @ref CauseCode `trafficCondition`. 
 * 
 * The value shall be set to:
 * - 0 `unavailable`                 : in case further detailed information on traffic jam is unavailable,
 * - 1 `increasedVolumeOfTraffic`    : in case detected jam volume is increased,
 * - 2 `trafficJamSlowlyIncreasing`  : in case detected traffic jam volume is increasing slowly,
 * - 3 `trafficJamIncreasing`        : in case traffic jam volume is increasing,
 * - 4 `trafficJamStronglyIncreasing`: in case traffic jam volume is strongly increasing,
 * - 5 `trafficStationary`           : in case traffic is stationary,
 * - 6 `trafficJamSlightlyDecreasing`: in case traffic jam volume is decreasing slowly,
 * - 7 `trafficJamDecreasing`        : in case traffic jam volume is decreasing,
 * - 8 `trafficJamStronglyDecreasing`: in case traffic jam volume is decreasing rapidly,
 * - 9-255: reserved for future usage.
 *
 * @category: Traffic information
 * @revision: V1.3.1
 */
TrafficConditionSubCauseCode ::= INTEGER {
    unavailable                  (0),
    increasedVolumeOfTraffic     (1),
    trafficJamSlowlyIncreasing   (2),
    trafficJamIncreasing         (3),
    trafficJamStronglyIncreasing (4),
    trafficStationary            (5),
    trafficJamSlightlyDecreasing (6),
    trafficJamDecreasing         (7),
    trafficJamStronglyDecreasing (8)
} (0..255)
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates a traffic direction that is relevant to information indicated in a message.
 * 
 * The value shall be set to:
 * - 0 `allTrafficDirections` : for all traffic directions. 
 * - 1 `upstreamTraffic`      : for upstream traffic. 
 * - 2 `downstreamTraffic`    : for downstream traffic. 
 * - 3 `oppositeTraffic`      : for traffic in the opposite direction. 
 *
 * The terms `upstream`, `downstream` and `oppositeTraffic` are relative to the event position.
 *
 * @note: Upstream traffic corresponds to the incoming traffic towards the event position,
 * and downstream traffic to the departing traffic away from the event position.
 *
 * @category: GeoReference information
 * @revision: Created in V2.1.1 from RelevanceTrafficDirection
 */
TrafficDirection ::= ENUMERATED {
    allTrafficDirections (0), 
    upstreamTraffic      (1), 
    downstreamTraffic    (2), 
    oppositeTraffic      (3)
}
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates traffic rules that apply to vehicles at a certain position.
 *
 * The value shall be set to:
 * - `0` if overtaking is prohibited for all vehicles.
 * - `1` if overtaking is prohibited for trucks.
 * - `2` if vehicles should pass to the right lane.
 * - `3` if vehicles should pass to the left lane.
 *
 * @category: Infrastructure information, Traffic information
 * @revision: Editorial update in V2.1.1
 */
TrafficRule ::= ENUMERATED {
    noPassing          (0), 
    noPassingForTrucks (1), 
    passToRight        (2), 
    passToLeft         (3), 
 ...}

/**
 * This  DE  defines  the  probability  that the ego trajectory  intercepts  with any  other object's  trajectory  on the  road. 
 * 
 * The value shall be set to:
 * - `n (n >= 0 and n <= 50)` to indicate the actual stability level.
 * - the values between 51 and 62 are reserved. 
 * - `63`: to indicate that the information is unavailable. 
 *
 * @category: Kinematics information
 * @revision: Created in V2.1.1
 */
TrajectoryInterceptionProbability ::= INTEGER { 
    unavailable (63) 
} (0..63) 

/**
 * This DE  defines  the  confidence level of the trajectoryInterceptionProbability.
 *
 * The value shall be set to:
 * - `0` to indicate confidence less than 50 %
 * - `1` to indicate confidence greater than or equal to 50 % and less than 70 %.
 * - `2` to indicate confidence greater than or equal to 70 % and less than 90 %.
 * - `3` to indicate confidence greater than or equal to 90%.
 * 
 * @category: Kinematics information
 * @revision: Created in V2.1.1
 */
TrajectoryInterceptionConfidence ::= INTEGER { 
    lessthan50percent     (0), 
    between50and70Percent (1),
    between70and90Percent (2), 
    above90Percent        (3) 
} (0..3)

/**
 * This DE provides the turning direction. 
 * 
 * The value shall be set to:
 * - `left` for turning to te left.
 * - `right`for turing to the right.
 *
 * @category: Kinematics information
 * @revision: Created in V2.1.1
 */
TurningDirection::= ENUMERATED {
    left, 
    right 
tijinkj's avatar
tijinkj committed
/**
 * This DE represents the smallest circular turn (i.e. U-turn) that the vehicle is capable of making.
 *
 * The value shall be set to:
 * - `n (n > 0 and n < 254)` indicates the applicable value is equal to or less than n x 0,4 meter, and greater than (n-1) x 0,4 meters.
 * - `254` indicates that the turning radius is  greater than 253 x 0.4 metre = 101.2 metres.
 * - `255` indicates that the information is unavailable.
 * 
 * For vehicle with tracker, the turning radius applies to the vehicle only.
 *
 * @category: Vehicle information
 * @unit 0.4 metre
 * @revision: Description revised V2.1.1 (the meaning of 254 has changed slightly)
 */
TurningRadius ::= INTEGER {
    outOfRange  (254),
    unavailable (255)
} (1..255)

/**
tijinkj's avatar
tijinkj committed
 * This De represents the Vehicle Descriptor Section (VDS). The values are assigned according to ISO 3779 [i.6].
tijinkj's avatar
tijinkj committed
 * 
 * @category: Vehicle information
 * @revision: V1.3.1
 */
VDS ::= IA5String (SIZE(6))
tijinkj's avatar
tijinkj committed
/**
 * This DE represents the value of the sub cause codes of the @ref CauseCode `vehicleBreakdown`. 
 * 
 * The value shall be set to:
 * - 0 `unavailable`         : in case further detailed information on cause of vehicle break down is unavailable,
 * - 1 `lackOfFuel`          : in case vehicle break down is due to lack of fuel,
 * - 2 `lackOfBatteryPower`  : in case vehicle break down is caused by lack of battery power,
 * - 3 `engineProblem`       : in case vehicle break down is caused by an engine problem,
 * - 4 `transmissionProblem` : in case vehicle break down is caused by transmission problem,
 * - 5 `engineCoolingProblem`: in case vehicle break down is caused by an engine cooling problem,
 * - 6 `brakingSystemProblem`: in case vehicle break down is caused by a braking system problem,
 * - 7 `steeringProblem`     : in case vehicle break down is caused by a steering problem,
 * - 8 `tyrePuncture`        : in case vehicle break down is caused by tire puncture,
 * - 9 `tyrePressureProblem` : in case low tyre pressure in detected,
 * - 10 `vehicleOnFire`      : in case the vehicle is on fire,
 * - 11-255: reserved for future usage.
 *
 * @category: Traffic information

 */
VehicleBreakdownSubCauseCode ::= INTEGER {
    unavailable          (0), 
    lackOfFuel           (1), 
    lackOfBatteryPower   (2), 
    engineProblem        (3), 
    transmissionProblem  (4), 
    engineCoolingProblem (5), 
    brakingSystemProblem (6), 
    steeringProblem      (7), 
    tyrePuncture         (8), 
    tyrePressureProblem  (9), 
    vehicleOnFire        (10)
} (0..255)
tijinkj's avatar
tijinkj committed
/** 
 * This DE represents the height if the vehicle, measured from the ground to the highest point, excluding any antennas.
 * In case vehicles are equipped with adjustable ride heights, camper shells, and any other
 * equipment which may result in varying height, the largest possible height shall be used.
 *
 * @unit 5 cm (DE ranges to 6.35 m)
 * @revision: V1.3.1
*/
VehicleHeight ::= INTEGER (0..127)

/**
 * This DE provides information about the presence of a trailer. 
 *
 * The value shall be set to:
 * - 0 `noTrailerPresent`                : to indicate that no trailer is present, i.e. either the vehicle is physically not enabled to tow a trailer or it has been detected that no trailer is present.
 * - 1 `trailerPresentWithKnownLength`   : to indicate that a trailer has been detected as present and the length is  included in a reported vehicle length value.
 * - 2 `trailerPresentWithUnknownLength` : to indicate that a trailer has been detected as present and the length is not included in a reported vehicle length value.
 * - 3 `trailerPresenceIsUnknown`        : to indicate that information about the trailer presence is unknown, i.e. the vehicle is physically enabled to tow a trailer but the detection of trailer presence/absence is not possible.
 * - 4 `unavailable`                     : to indicate that the information about the presence of a trailer is not available, i.e. it is neither known whether the vehicle is able to tow a trailer 
 *                                        nor the detection of trailer presence/absence is possible.
 * 
 * @category: Vehicle information
 * @revision: Description revised in V2.1.1
*/
VehicleLengthConfidenceIndication ::= ENUMERATED {
    noTrailerPresent                (0), 
    trailerPresentWithKnownLength   (1), 
    trailerPresentWithUnknownLength (2), 
    trailerPresenceIsUnknown        (3), 
    unavailable                     (4)
}

/**
 * This DE represents the length of a vehicle.
 *
 * The value shall be set to:
 * - `n (n > 1 and n < 1022)` to indicate the applicable value n is equal to or less than n x 0,1 meter, and greater than (n-1) x 0,1 meter.
 * - `1 022` to indicate that the vehicle length is greater than 102.1 metres.
 * - `1 023` to indicate that the information in unavailable.
 * 
 * 
 * @unit: 0.1 metre
 * @category: Vehicle information
 * @revision: Description updated in V2.1.1 (the meaning of 1 022 has changed slightly).
 */
VehicleLengthValue ::= INTEGER {
    outOfRange(1022), 
    unavailable(1023)
}  (1..1023)

/**
 * This DE represents the mass of an empty loaded vehicle in multiple of 100 kg.
 *
 * The value shall be set to: 
 * - `n (n > 1 and n < 1023)` to indicate that the applicable value is equal to or less than n x 100 kg, and greater than (n-1) x 100 kg.
 * - `1 023` indicates that the vehicle mass is greater than 102 200 kg.
 * - `1 024` indicates  the vehicle mass information is unavailable.
 * 
tijinkj's avatar
tijinkj committed
 * @note:	The empty load vehicle is defined in ISO 1176 [i.8], clause 4.6.
tijinkj's avatar
tijinkj committed
 * 
 * @unit: 100kg
 * @category: Vehicle information
 * @revision: Description updated in V2.1.1 (the meaning of 1 023 has changed slightly).
*/
VehicleMass ::= INTEGER {
    outOfRange (1023), 
    unavailable(1024)
} (1..1024) 

/**
 * This DE indicates the role played by a vehicle at a point in time.
 *
 * The value shall be set to:
 * - 0 `default`          : to indicate the default vehicle role as indicated by the vehicle type,
 * - 1 `publicTransport`  : to indicate that the vehicle is used to operate public transport service,
 * - 2 `specialTransport` : to indicate that the vehicle is used for special transport purpose, e.g. oversized trucks,
 * - 3 `dangerousGoods`   : to indicate that the vehicle is used for dangerous goods transportation,
 * - 4 `roadWork`         : to indicate that the vehicle is used to realize roadwork or road maintenance mission,
 * - 5 `rescue`           : to indicate that the vehicle is used for rescue purpose in case of an accident, e.g. as a towing service,
 * - 6 `emergency`        : to indicate that the vehicle is used for emergency mission, e.g. ambulance, fire brigade,
 * - 7 `safetyCar`        : to indicate that the vehicle is used for public safety, e.g. patrol,
 * - 8 `agriculture`      : to indicate that the vehicle is used for agriculture, e.g. farm tractor, 
 * - 9 `commercial`       : to indicate that the vehicle is used for transportation of commercial goods,
 * - 10 `military`        : to indicate that the vehicle is used for military purpose, 
 * - 11 `roadOperator`    : to indicate that the vehicle is used in road operator missions,
 * - 12 `taxi`            : to indicate that the vehicle is used to provide an authorized taxi service,
 * - 13 `reserved`        : reserved for future usage,
 * - 14 `reserved`        : reserved for future usage,
 * - 15 `reserved`        : reserved for future usage.
 * 
 * @category: Vehicle Information
 * @revision: escription updated in V2.1.1 (removed reference to CEN/TS 16157-3)
 */
VehicleRole ::= ENUMERATED {
    default         (0), 
    publicTransport (1), 
    specialTransport(2), 
    dangerousGoods  (3), 
    roadWork        (4), 
    rescue          (5), 
    emergency       (6), 
    safetyCar       (7), 
    agriculture     (8), 
    commercial      (9), 
    military        (10), 
    roadOperator    (11), 
    taxi            (12), 
    reserved1       (13), 
    reserved2       (14), 
    reserved3       (15)
tijinkj's avatar
tijinkj committed
/**
 * This DE describes the subclass of a vehicle.
 *
 * The value shall be set to:
 * - `0` unknown          : to indicate that the type of vehicle is unknown.
tijinkj's avatar
tijinkj committed
 * - `1` passengerCar     : to indicate a small passenger car as defined in UNECE/TRANS/WP.29/78/Rev.4 [i.16] class M1.
 * - `2` bus              : to indicate a large passenger vehicle as defined in UNECE/TRANS/WP.29/78/Rev.4 [i.16] class M2, M3.
 * - `3` lightTruck       : to indicate a light goods vehicle as defined in UNECE/TRANS/WP.29/78/Rev.4 [i.16] class N1.
 * - `4` heavyTruck       : to indicate a heavy goods vehicle as defined in UNECE/TRANS/WP.29/78/Rev.4 [i.16] class N2, N3.
 * - `5` trailer          : to indicate an unpowered vehicle that is intended to be towed by a powered vehicle as defined in UNECE/TRANS/WP.29/78/Rev.4 [i.16] class O.
tijinkj's avatar
tijinkj committed
 * - `6` specialVehicles  : to indicate a vehicle which has a special purpose other than the above (e.g. moving road works vehicle).
 * - `7` tram             : to indicate a vehicle running on tracks along public streets.
 * - `8` emergencyVehicle : to indicate a vehicle used in an emergency situation such as an ambulance, police car or fire engine.
 * - `9` agricultural     : to indicate a vehicle used for agricultural purposes.
 * - Values 10 to 255 are reserved for future use.
 *
 * @category: Vehicle information 
 * @revision: Created in V2.1.1
 */
VehicleSubClass ::= INTEGER {
    unknown             (0),    
    passengerCar        (1),    
    bus                 (2),    
    lightTruck          (3),    
    heavyTruck          (4),    
    trailer             (5),    
    specialVehicles     (6),    
    tram                (7),    
    emergencyVehicle    (8),    
    agricultural        (9)     
} (0..255)
tijinkj's avatar
tijinkj committed
/**
 * This DE represents the width of a vehicle, excluding side mirrors and possible similar extensions.

 * The value shall be set to:
 * - `n (n > 1 and n < 61)` indicates the applicable value is equal to or less than n x 0,1 meter, and greater than (n-1) x 0,1 meter.
 * - `61`indicates that the vehicle width is greater than 6,0 metres.
 * - `62`indicates that the information in unavailable.
 * 
 * @unit: 0.1 metre
 * @category: Vehicle information 
 * @revision: Description updated in V2.1.1 (the meaning of 61 has changed slightly).
 */
VehicleWidth ::= INTEGER {
    outOfRange  (61),  
    unavailable (62)
} (1..62)

/**
 * This DE represents the vehicle acceleration at vertical direction in the centre of the mass of the empty vehicle.
 * It corresponds to the vehicle coordinate system as specified in ISO 8855 [2].
 *
 * The value shall be set to:
 * - `-160` for values equal to or less than -16 m/s<sup>2</sup>.
 * - `n (n > -160 and n <= 0)` to indicate downwards acceleration equal to or less than n x 0,1 m/s<sup>2</sup>, and greater than (n-1) x 0,1 m/s<sup>2</sup>.
 * - `n (n > 0 and n < 160)` to indicate upwards acceleration equal to or less than n x 0,1 m/s<sup>2</sup>, and greater than (n-1) x 0,1 m/s<sup>2</sup>.
 * - `160` for acceleration or greater than 15,9 m/s<sup>2</sup>.
 * - `161` when the data is unavailable.
 * 
tijinkj's avatar
tijinkj committed
 * @note: The empty load vehicle is defined in ISO 1176 [i.8], clause 4.6.
tijinkj's avatar
tijinkj committed
 *
 * @category: Vehicle information
 * @unit: 0.1 m/s<sup>2</sup>
 * @revision: Desciption updated in V2.1.1 (the meaning of 160 has changed slightly): This type is now based on the more generic type AccelerationValue. 
 *  
*/
VerticalAccelerationValue ::= AccelerationValue

/** 
 * This DE Identifies all the VRU profile types that are believed to be within a cluster.
 * It consist of a Bitmap encoding VRU profiles, to allow multiple profiles to be indicated in a single cluster (heterogeneous cluster if more than one profile).
 * 
 * The corresponding bit shall be set to 1 under the following conditions:
 * - 0 `pedestrian`  : indicates that the VRU cluster contains at least one pedestrian VRU.
 * - 1 `bicycle`     : indicates that the VRU cluster contains at least one bicycle VRU member.
 * - 2 `motorcycle`  : indicates that the VRU cluster contains at least one motorcycle VRU member.
 * - 3 `animal`      : indicates that the VRU cluster contains at least one animal VRU member.
 * 
 * Otherwise, the corresponding bit shall be set to 0.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
*/
VruClusterProfiles ::= BIT STRING {
    pedestrian   (0),
    bicyclist    (1),
    motorcyclist (2),
    animal       (3)
} (SIZE(4))

/**
 * This DE represents the possible VRU usage conditions.

 * - The value shall be set to:
 * - 0 `unavailable`      : to indicate that the usage conditions are unavailable. 
 * - 1 `other (1)`        : to indicate that the VRU is in a state not defined below.
 * - 2 `idle (2)`         : to indicate that the human is currently not interacting with the device.
 * - 3 `listeningToAudio` : to indicate that any audio source other than calling is in use.
 * - 4 `typing (4)`       : to indicate that the human is texting, entering addresses and other manual input activity.
 * - 5 `calling (5)`      : to indicate that the VRU device is currently received a call. 
 * - 6 `playingGames (6)` : to indicate that the human is playing games. 
 * - 7 `reading (7)`      : to indicate that the human is reading on the VRU device.
 * - 8 `viewing (8)`      : to indicate that the human is watching dynamic content, including following navigation prompts, viewing videos or other visual contents that are not static,
 * - value 9 to 255       : reserved for future usage. Value 255 set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruDeviceUsage ::= ENUMERATED {
    unavailable      (0), 
    other            (1), 
    idle             (2), 
    listeningToAudio (3), 
    typing           (4), 
    calling          (5), 
    playingGames     (6), 
    reading          (7), 
    viewing          (8), 
    max              (255)
}
tijinkj's avatar
tijinkj committed
/**
 * This DE represents the possible VRU environment conditions.
 *
 * - The value shall be set to:
 * - 0 `unavailable`            : to indicate that the information on the type of environment is unavailable,
 * - 1 `intersectionCrossing`   : to indicate that the VRU is on an intersection or crossing. 
 * - 2 `zebraCrossing`          : to indicate that the VRU is on a  zebra crossing (crosswalk).
 * - 3 `sidewalk`               : to indicate that the VRU is on a sidewalk.
 * - 4 `onVehicleRoad`          : to indicate that the VRU is on a traffic lane. 
tijinkj's avatar
tijinkj committed
 * - 5 `protectedGeographicArea`: to indicate that the VRU is in a protected area. 
tijinkj's avatar
tijinkj committed
 * - value 5 to 255             : reserved for future usage. Value 255 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruEnvironment ::= ENUMERATED {
    unavailable             (0), 
    intersectionCrossing    (1), 
    zebraCrossing           (2), 
    sidewalk                (3), 
    onVehicleRoad           (4), 
    protectedGeographicArea (5), 
    max                     (255)
tijinkj's avatar
tijinkj committed
/**
 *  This DE indicates the status of the possible human control over a VRU vehicle.
 *
 * The value shall be set to:
 * - 0 `unavailable`                 : to indicate that the information on is unavailable.
 * - 1 `braking`                     : to indicate that the VRU is braking.
 * - 2 `hardBraking`                 : to indicate that the VRU is braking hard.
 * - 3 `stopPedaling`                : to indicate that the VRU stopped pedaling.
 * - 4 `brakingAndStopPedaling`      : to indicate that the VRU stopped pedaling an is braking. 
 * - 5 `hardBrakingAndStopPedaling`  : to indicate that the VRU stopped pedaling an is braking hard.
 * - 6 `noReaction`                  : to indicate that the VRU is not changing its behavior.
 * - value 7 to 255                  : reserved for future usage. Value 255 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruMovementControl ::= ENUMERATED {
    unavailable                (0), 
    braking                    (1), 
    hardBraking                (2), 
    stopPedaling               (3), 
    brakingAndStopPedaling     (4), 
    hardBrakingAndStopPedaling (5), 
    noReaction                 (6), 
    max                        (255)
}
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates the profile of a pedestrian.
 * 
 * The value shall be set to:
 * - 0 `unavailable`             : to indicate that the information on is unavailable.
 * - 1 `ordinary-pedestrian`     : to indicate a pedestrian to which no more-specific profile applies.
 * - 2 `road-worker`             : to indicate a pedestrian with the role of a road worker.
 * - 3 `first-responder`         : to indicate a pedestrian with the role of a first responder. 
 * - value 4 to 15               : reserved for future usage. Value 15 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruSubProfilePedestrian ::= ENUMERATED {
    unavailable         (0), 
    ordinary-pedestrian (1),
    road-worker         (2), 
    first-responder     (3),
    max                 (15)
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates the profile of a VRU and its light VRU vehicle / mounted animal. 
 *
 * The value shall be set to:
 * - 0 `unavailable`           : to indicate that the information  is unavailable.
 * - 1 `bicyclist `            : to indicate a cycle and bicyclist.
 * - 2 `wheelchair-user`       : to indicate a wheelchair and its user.
 * - 3 `horse-and-rider`       : to indicate a horse and rider.
 * - 4 `rollerskater`          : to indicate a rolleskater and skater.
 * - 5 `e-scooter`             : to indicate an e-scooter and rider.
 * - 6 `personal-transporter`  : to indicate a personal-transporter and rider.
 * - 7 `pedelec`               : to indicate a pedelec and rider.
 * - 8 `speed-pedelec`         : to indicate a speed-pedelec and rider. 
 * - value 9 to 15             : reserved for future usage. Value 15 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruSubProfileBicyclist ::= ENUMERATED {
    unavailable          (0), 
    bicyclist            (1), 
    wheelchair-user      (2), 
    horse-and-rider      (3), 
    rollerskater         (4), 
    e-scooter            (5), 
    personal-transporter (6),
    pedelec              (7), 
    speed-pedelec        (8),
    max                  (15)
}
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates the profile of a motorcyclist and corresponding vehicle.
 * 
 * The value shall be set to:
 * - 0 `unavailable `                  : to indicate that the information  is unavailable.
 * - 1 `moped (1)`                     : to indicate a moped and rider.
 * - 2 `motorcycle`                    : to indicate a motorcycle and rider.
 * - 3 `motorcycle-and-sidecar-right`  : to indicate a motorcycle with sidecar on the right and rider.
 * - 4 `motorcycle-and-sidecar-left`   : to indicate  a motorcycle with sidecar on the left and rider.
 * - value 5 to 15                     : reserved for future usage. Value 15 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruSubProfileMotorcyclist ::= ENUMERATED { 
    unavailable                  (0), 
    moped                        (1), 
    motorcycle                   (2), 
    motorcycle-and-sidecar-right (3), 
    motorcycle-and-sidecar-left  (4), 
    max                          (15)
}
tijinkj's avatar
tijinkj committed
/**
 * This DE indicates the profile of a animal
 * 
 * The value shall be set to:
 * - 0 `unavailable`     : to indicate that the information  is unavailable.
 * - 1 `wild-animal`     : to indicate a animal living in the wildness. 
 * - 2 `farm-animal`     : to indicate an animal beloning to a farm.
 * - 3 `service-animal`  : to indicate an animal that supports a human being. 
 * - value 4 to 15       : reserved for future usage. Value 15 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruSubProfileAnimal ::= ENUMERATED {
    unavailable    (0), 
    wild-animal    (1), 
    farm-animal    (2), 
    service-animal (3),   
    max            (15)
}

/**
 * This DE indicates the approximate size of a VRU including the VRU vehicle used.
 * 
 * The value shall be set to:
 * - 0 `unavailable(0)` : There is no matched size class or due to privacy reasons in profile 1. 
 * - 1 `low (1)`        : the VRU size class is low depending on the VRU profile.
 * - 2 `medium (2)`     : the VRU size class is medium depending on the VRU profile.
 * - 3 `high (3)`       : the VRU size class is high depending on the VRU profile.
 * - value 4 to 15      : reserved for future usage. Value 15 is set to "max" in order to bound the size of the encoded field.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */
VruSizeClass ::= ENUMERATED { 
    unavailable (0), 
    low         (1), 
    medium      (2), 
    high        (3), 
    max         (15)
}

/**
 * This DE describes the status of the exterior light switches of a vehicle or a VRU.
 * The DE is an extension of the existing vehicular DE ExteriorLight.
 *
 * The value of each bit indicates the state of the switch, which commands the corresponding light. 
 * The bit corresponding to a specific light is set to 1, when the corresponding switch is turned on, either manually by the driver or VRU 
 * or automatically by a vehicle or VRU system: 
 * - 0 `unavailable`     : indicates no information available. 
 * - 1 `backFlashLight ` : indicates the status of the back flash light.
 * - 2 `helmetLight`     : indicates the status of the helmet light.
 * - 3 `armLight`        : indicates the status of the arm light.
 * - 4 `legLight`        : indicates the status of the leg leight.
 * - 5 `wheelLight`      : indicates the status of the wheel light. 
 * - Bits 6 to 8         : reserved for future use. 
 * The bit values do not indicate if the corresponding lamps are alight or not.
 * If  VRU is not equipped with a certain light or if the light switch status information is not available, the corresponding bit shall be set to 0.
 *
 * @category: VRU information
 * @revision: Created in V2.1.1
 */ 
VruSpecificExteriorLights ::= BIT STRING {
    unavailable    (0),
    backFlashLight (1),
    helmetLight    (2),
    armLight       (3),
    legLight       (4),
    wheelLight     (5)
Denis Filatov's avatar
Denis Filatov committed
} (SIZE(8))

tijinkj's avatar
tijinkj committed
/**
tijinkj's avatar
tijinkj committed
 * This DE indicates the perpendicular distance between front and rear axle of the wheel base of vehicle.
tijinkj's avatar
tijinkj committed
 *
 * The value shall be set to:
 * - `n (n >= 1 and n < 126)` if the value is equal to or less than n x 0.1 metres  and more than (n-1) x 0.1 metres.
 * - `126` indicates that the wheel base distance is equal to or greater than 12,5 metres.
 * - `127` indicates that the information is unavailable.
 *
 * @unit 0.1 metre
 * @category: Vehicle information
 * @revision: Created in V2.1.1
 */
WheelBaseVehicle ::= INTEGER {
    outOfRange  (126),
    unavailable (127)
} (1..127)

/** 
 * This DE represents the absolute accuracy of a reported angle value for a confidence level of 95 %.
 * The required confidence level is defined by the corresponding standards applying this DE.
 * 
 * The value shall be set to:
 * - `n (n >=1 and n < 126)` is equal to or less than n x 0.1 degrees and more than (n-1) x 0.1 degrees.
 * - `126` if the angle accuracy is out of range, i.e. greater than 12,5 degrees.
 * - `127` if the angle accuracy information is not available.
 *
 *
 * @unit 0,1 degrees
 * @category: GeoReference Information
 * @revision: Created in V2.1.1
*/
Wgs84AngleConfidence ::= INTEGER {
    outOfRange  (126), 
    unavailable (127)  
} (1..127)


/** 
 * This DE represents an angle value in degrees described in the WGS84 reference system with respect to the WGS84 north.
 * When the information is not available, the DE shall be set to 3 601. The value 3600 shall not be used.
 *
 * @unit 0,1 degrees
 * @category: GeoReference Information
 * @revision: Created in V2.1.1
*/
Wgs84AngleValue ::= INTEGER { 
    wgs84North  (0),
    wgs84East   (900),
    wgs84South  (1800),
    wgs84West   (2700),
    doNotUse    (3600),
    unavailable (3601)
} (0..3601)

/**
tijinkj's avatar
tijinkj committed
 * This DE represents the World Manufacturer Identifier (WMI). The values are assigned according to ISO 3779 [i.6].
tijinkj's avatar
tijinkj committed
 * 
 *
 * @category: Vehicle information
 * @revision: V1.3.1
 */
WMInumber ::= IA5String (SIZE(1..3))

/**
 * This DE represents the sub cause codes of the @ref CauseCode `wrongWayDriving` .
 * 
 * The value shall be set to:
 * - 0 `unavailable`    : in case further detailed information on wrong way driving event is unavailable,
 * - 1 `wrongLane`      : in case vehicle is driving on a lane for which it has no authorization to use,
 * - 2 `wrongDirection` : in case vehicle is driving in a direction that it is not allowed,
 * - 3-255              : reserved for future usage.
 * 
 * @category: Traffic information
 * @revision: V1.3.1
 */
WrongWayDrivingSubCauseCode ::= INTEGER {
    unavailable    (0), 
    wrongLane      (1), 
    wrongDirection (2)
} (0..255)

/**
 * This DE denotes the absolute accuracy range for reported yaw rate value for a confidence level of 95%.
 * 
 * The value shall be set to:
 * - `0` indicates that the accuracy is equal to or less than 0,01 degree/second.
 * - `1` indicates that the accuracy is equal to or less than 0,05 degrees/second.
 * - `2` indicates that the accuracy is equal to or less than 0,1 degree/second.
 * - `3` indicates that the accuracy is equal to or less than 1 degree/second.
 * - `4` indicates that the accuracy is equal to or less than 5 degrees/second.
 * - `5` indicates that the accuracy is equal to or less than 10 degrees/second.
 * - `6` indicates that the accuracy is equal to or less than 100 degrees/second.
 * - `7` indicates that the accuracy is out of range, i.e. greater than 100 degrees/second.
 * - `8` indicates that the accuracy information is unavailable
 * 
 * NOTE: The fact that a yaw rate value is received with confidence set to `unavailable(8)` 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 yaw rate value may be valid and used by the application.
 * 
 * If a yaw rate value is received and its confidence is set to `outOfRange(7)`, it means that the reported
 * yaw rate value is not valid and therefore cannot be trusted. Such value is not useful the application.
 * 
 * @category: Traffic information
 * @revision: Description revised in V2.1.1
 */
YawRateConfidence ::= ENUMERATED {
    degSec-000-01 (0),
    degSec-000-05 (1),
    degSec-000-10 (2),
    degSec-001-00 (3),
    degSec-005-00 (4),
    degSec-010-00 (5),
    degSec-100-00 (6),
    outOfRange    (7),
    unavailable   (8)
tijinkj's avatar
tijinkj committed
/**
 * This DE represents the vehicle rotation around z-axis of coordinate system centred on the centre of mass of the empty-loaded
 * vehicle. It corresponds to the vehicle coordinate system as specified in ISO 8855 [2]. The leading sign denotes the direction of rotation.
 * 
 * The value shall be set to:
 * - `-32 766` to indicate that the yaw rate is equal to or greater than 327,66 degrees/second to the right.
 * - `n (n > -32 766 and n <= 0)` to indicate that the rotation is clockwise (i.e. to the right) and is equal to or less than n x 0,01 degrees/s, 
      and greater than (n-1) x 0,01 degrees/s.
 * - `n (n > 0 and n < 32 766)` to indicate that the rotation is anti-clockwise (i.e. to the left) and is equal to or less than n x 0,01 degrees/s, 
      and greater than (n-1) x 0,01 degrees/s.
 * - `32 766` to indicate that the yaw rate is greater than 327.65 degrees/second to the left.
 * - `32 767` to indicate that the information is not available.
 * 
 * The yaw rate value shall be a raw data value, i.e. not filtered, smoothed or otherwise modified.
 * The reading instant should be the same as for the vehicle acceleration.
 * 
tijinkj's avatar
tijinkj committed
 * @note: The empty load vehicle is defined in ISO 1176 [i.8], clause 4.6.
tijinkj's avatar
tijinkj committed
 * 
 * @unit: 0,01 degree per second. 
 * @category: Vehicle Information
 * @revision: Desription revised in V2.1.1 (the meaning of 32766 has changed slightly). 
*/
YawRateValue ::= INTEGER {
    negativeOutOfRange (-32766), 
    positiveOutOfRange (32766), 
    unavailable        (32767)
} (-32766..32767)

----------------------------------------
-- Specification of CDD Data Frames:
----------------------------------------

/** 
 * This DF represents an acceleration component along with a confidence with a predefined confidence level of 95% for the component.
 *
 * It includes the following components: 
 *
 * @field value: the acceleration value which can be estimated as the mean of the current distribution.
 *
 * @field value confidence: the accuracy associated to the provided value at a predefined confidence level of 95% for the component.
 *
 * @category: Kinematic Information
 * @revision: Created in V2.1.1
 */
Acceleration1d ::= SEQUENCE {
    value         AccelerationValue,
    confidence    AccelerationConfidence
tijinkj's avatar
tijinkj committed
/** 
 * This DF represents information associated to changes in acceleration. 
 *
 * It includes the following components: 
 *
 * @field accelOrDecel: the indication of an acceleration change.
 *
 * @field value actionDeltaTime: the period in which the acceleration change action is performed.
 *
 * @category: Kinematic Information
 * @revision: Created in V2.1.1
 */
AccelerationChangeIndication ::= SEQUENCE {
    accelOrDecel       AccelerationChange,
    actionDeltaTime    DeltaTimeTenthOfSecond,
    ...
}
tijinkj's avatar
tijinkj committed
/**
 * This DF represents an identifier used to describe a protocol action taken by an ITS-S.
 * 
 * It includes the following components: 
 *
tijinkj's avatar
tijinkj committed
 * @field originatingStationId: Id of the ITS-S that takes the action. 
tijinkj's avatar
tijinkj committed
 * 
 * @field sequenceNumber: a sequence number. 
 * 
 * @category: Communication information
tijinkj's avatar
tijinkj committed
 * @revision: Update in V2.1.1 changed name from ActionID to ActionId
tijinkj's avatar
tijinkj committed
 */
tijinkj's avatar
tijinkj committed
ActionId ::= SEQUENCE {
    originatingStationId    StationId,
tijinkj's avatar
tijinkj committed
    sequenceNumber          SequenceNumber
}
tijinkj's avatar
tijinkj committed
/**
 * This DF represents a list of @ref ActionID. 

 * @category: Communication Information
tijinkj's avatar
tijinkj committed
 * @revision: Created in V2.1.1 based on ReferenceDenms from DENM Release 1
tijinkj's avatar
tijinkj committed
*/
tijinkj's avatar
tijinkj committed
ActionIdList::= SEQUENCE (SIZE(1..8, ...)) OF ActionId
tijinkj's avatar
tijinkj committed
 * This DF provides the altitude and accuracy of an altitude information in a WGS84 coordinate system.
tijinkj's avatar
tijinkj committed
 *
 * It includes the following components: 
 *
 * @field altitudeValue: altitude of a geographical point.
 *
 * @field altitudeConfidence: accuracy of the reported altitudeValue within a specific confidence level.
 *
 * @category: GeoReference information
 * @revision: V1.3.1
 */
Altitude ::= SEQUENCE {
    altitudeValue         AltitudeValue,
    altitudeConfidence    AltitudeConfidence
}
tijinkj's avatar
tijinkj committed
/** 
 * This DE represents a general container for usage in various types of messages.
 *
 * It includes the following components: 
 *
 * @field stationType: the type of station that has generated the message that contains the basic container.
 *
 * @field referencePosition: the reference position of the station that has generated the message that contains the basic container.
 *
 * @category: Basic information
 * @revision: Created in V2.1.1
*/
BasicContainer ::= SEQUENCE {
	stationType          StationType,
	referencePosition    ReferencePosition,
	...
}
tijinkj's avatar
tijinkj committed
/** 
 * This DF represents a general Data Frame to describe an angle component along with a confidence in a cartesian coordinate system.
 *
 * It includes the following components: 
 *
 * @field value: The angle value which can be estimated as the mean of the current distribution.
 *
 * @field confidence: The accuracy associated to the provided value.
 *
 * @category: Kinematics information
 * @revision: Created in V2.1.1