Extending the Vehicle Data API
This specification anticipates that implementors may desire to extend this API and
define new data types that this specification does not define. This section provides some
general guidlines on how extending the API should be done.
All new data types must have two parts: a VehicleInterface
attributed on the navigator.vehicle object and an interface definition that defines the
data type. The following example describes how one would extend the specification to add
a "whizzer" data feature.
partial interface Vehicle {
readonly attribute VehicleSignalInterface whizzer; /// returns an interface to the Whizzer type
}
interface Whizzer {
readonly attribute boolean isWhizzing;
}
Extending Existing Data Types
There may also be attributes of a data type interface that an implementor may wish to extend.
The general guideline here is to add attributes to interfaces that are logically related. For
example, lets say an implementor wishes to add support for a new type of light. The implementor
would extend the already existing Light interface and add the attribute there.
partial interface Light {
attribute boolean superBeam;
}
Mapping vs. Extending
Because vehicle data may be different in a system than what is defined in the specication, it is
preferable to perform post-processing to translate and map the system data to the defined type. It
is NOT preferable to create a new type if one has already been defined by this specification.
Configuration and Identification Interfaces
Interfaces relating to vehicle configuration and identification including: make, type size, transmission
configuration, identification numbers, etc...
- readonly attribute VehicleConfigurationInterface identification
- MUST return VehicleConfigurationInterface for accessing Identification
- readonly attribute VehicleConfigurationInterface sizeConfiguration
- MUST return VehicleConfigurationInterface for accessing SizeConfiguration
- readonly attribute VehicleConfigurationInterface fuelConfiguration
- MUST return VehicleConfigurationInterface for accessing FuelConfiguration
- readonly attribute VehicleConfigurationInterface transmissionConfiguration
- MUST return VehicleConfigurationInterface for accessing TransmissionConfiguration
- readonly attribute VehicleConfigurationInterface wheelConfiguration
- MUST return VehicleConfigurationInterface for accessing WheelConfiguration
- readonly attribute VehicleSignalInterface steeringWheelConfiguration
- MUST return VehicleConfigurationInterface for accessing SteeringWheelConfiguration
The Identification interface provides identification information about a
vehicle.
- passengerCarMini
- Passenger car 680–907 kg
- passengerCarLight
- Passenger car 907–1,134 kg
- passengerCarCompact
- Passenger car 1,134–1,360 kg
- passengerCarMedium
- Passenger car 1,361–1,587 kg
- passengerCarHeavy
- Passenger car 1,588 kg and over
- sportUtilityVehicle
- Sport utility vehicle
- pickupTruck
- Pickup truck
- van
- Van
- readonly attribute DOMString? VIN
- MUST return the Vehicle Identification Number (ISO 3833)
- readonly attribute DOMString? WMI
- MUST return the World Manufacture Identifier defined by SAE ISO 3780:2009. 3 characters.
- readonly attribute VehicleTypeEnum? vehicleType
- MUST return vehicle type
- readonly attribute DOMString? brand
- MUST return vehicle brand name
- readonly attribute DOMString? model
- MUST return vehicle model
- readonly attribute unsigned short? year
- MUST return vehicle model year
The SizeConfiguration interface provides size and shape information about a
vehicle as a whole.
- readonly attribute unsigned short? width
- MUST return widest dimension of the vehicle (not including the side mirrors) (Unit: millimeters
Note: Number may be an approximation, and should not be expected to be exact.)
- readonly attribute unsigned short? height
- MUST return distance from the ground to the highest point of the vehicle (not including antennas)
(Unit: millimeters Note: Number may be an approximation, and should not be expected to be exact.)
- readonly attribute unsigned short? length
- MUST return distance from front bumper to rear bumper
(Unit: millimeters Note: Number may be an approximation, and should not be expected to be exact.)
- readonly attribute unsigned short[]? doorsCount
- MUST return list of car doors, organized in "rows" with number doors in each row.(Per Row -
Min: 0, Max: 3)
- readonly attribute unsigned short? totalDoors
- MUST return total number of doors on the vehicle (all doors opening to the interior,
including hatchbacks) (Min: 0, Max: 10)
The FuelConfiguration interface provides information about the fuel
configuration of a vehicle.
- gasoline
- Gasoline
- methanol
- Methanol
- ethanol
- Ethanol
- diesel
- Diesel
- lpg
- Liquified petroleom gas
- cng
- Compressed natural gas
- electric
- Electric
- readonly attribute FuelTypeEnum[]? fuelType
- MUST return type of fuel used by vehicle. If the vehicle uses multiple fuels, fuelType returns an array of fuel types.
- readonly attribute Zone? refuelPosition
- MUST return location on the vehicle with access to the fuel door
The TransmissionConfiguration interface provides transmission configuration
information information about a vehicle.
- auto
- Automatic transmission
- manual
- Manual transmission
- readonly attribute TransmissionGearTypeEnum? transmissionGearType
- MUST return transmission gear type
The WheelConfiguration interface provides wheel configuration information
about a vehicle.
- readonly attribute unsigned short? wheelRadius
- MUST return radius of the front wheel (Unit: millimeters)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The SteeringWheelConfiguration interface provides steering wheel configuration
information information about a vehicle.
- readonly attribute boolean? steeringWheelLeft
- MUST return true if steering wheel is on left side of vehicle
- attribute unsigned short? steeringWheelTelescopingPosition
- MUST return steering wheel position as percentage of extension from the dash
(Unit: percentage, 0%:closest to dash, 100%:farthest from dash)
- attribute unsigned short? steeringWheelPositionTilt
- MUST return steering wheel position as percentage of tilt
(Unit: percentage, 0%:tilted lowest downward-facing position, 100%:highest upward-facing position)
Running Status Interfaces
Interfaces relating to the running/operation of a vehicle including: speed, temperatures, acceleration,
etc...
- readonly attribute VehicleSignalInterface vehicleSpeed
- MUST return VehicleSignalInterface for accessing VehicleSpeed
- readonly attribute VehicleSignalInterface wheelSpeed
- MUST return VehicleSignalInterface for accessing WheelSpeed
- readonly attribute VehicleSignalInterface engineSpeed
- MUST return VehicleSignalInterface for accessing EngineSpeed or undefined if not supported
- readonly attribute VehicleSignalInterface powertrainTorque
- MUST return VehicleSignalInterface for accessing PowertrainTorque
- readonly attribute VehicleSignalInterface acceleratorPedalPosition
- MUST return VehicleSignalInterface for accessing AcceleratorPedalPosition
- readonly attribute VehicleSignalInterface throttlePosition
- MUST return VehicleSignalInterface for accessing ThrottlePosition
- readonly attribute VehicleSignalInterface tripMeters
- MUST return VehicleSignalInterface for accessing TripMeters
- readonly attribute VehicleSignalInterface transmission
- MUST return VehicleSignalInterface for accessing Transmission
- readonly attribute VehicleSignalInterface cruiseControlStatus
- MUST return VehicleSignalInterface for accessing CruiseControlStatus
- readonly attribute VehicleSignalInterface lightStatus
- MUST return VehicleSignalInterface for accessing LightStatus
- readonly attribute VehicleSignalInterface interiorLightStatus
- MUST return VehicleSignalInterface for accessing InteriorLightStatus
- readonly attribute VehicleSignalInterface horn
- MUST return VehicleSignalInterface for accessing Horn
- readonly attribute VehicleSignalInterface chime
- MUST return VehicleSignalInterface for accessing Chime
- readonly attribute VehicleSignalInterface fuel
- MUST return VehicleSignalInterface for accessing Fuel
- readonly attribute VehicleSignalInterface engineOil
- MUST return VehicleSignalInterface for accessing EngineOil
- readonly attribute VehicleSignalInterface acceleration
- MUST return VehicleSignalInterface for accessing Acceleration
- readonly attribute VehicleSignalInterface engineCoolant
- MUST return VehicleSignalInterface for accessing EngineCoolant
- readonly attribute VehicleSignalInterface steeringWheel
- MUST return VehicleSignalInterface for accessing SteeringWheel
- readonly attribute VehicleSignalInterface ignitionTime
- MUST return VehicleSignalInterface for accessing IgnitionTime
- readonly attribute VehicleSignalInterface yawRate
- MUST return VehicleSignalInterface for accessing YawRate
- readonly attribute VehicleSignalInterface brakeOperation
- MUST return VehicleSignalInterface for accessing BrakeOperation
- readonly attribute VehicleSignalInterface wheelTick
- MUST return VehicleSignalInterface for accessing WheelTick
- readonly attribute VehicleSignalInterface buttonEvent
- MUST return VehicleSignalInterface for accessing ButtonEvent
- readonly attribute VehicleSignalInterface drivingMode
- MUST return VehicleSignalInterface for accessing DrivingMode
- readonly attribute VehicleSignalInterface nightMode
- MUST return VehicleSignalInterface for accessing NightMode
The VehicleSpeed interface represents vehicle speed information
- readonly attribute unsigned short speed
- MUST return vehicle speed (Unit: meters per hour)
The WheelSpeed interface represents wheel speed information.
- readonly attribute unsigned short speed
- MUST return wheel speed (Unit: meters per hour)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The EngineSpeed interface represents engine speed information.
- readonly attribute unsigned long speed
- MUST return engine speed (Unit: rotations per minute)
The VehiclePowerModeType interface represents position of the ignition switch.
- off
- Off - No power
- accessory1
- Accessory power 1
- accessory2
- Accessory power 2
- running
- Running power
- readonly attribute VehiclePowerMode value
- MUST return position of the ignition switch
The PowertrainTorque interface represents powertrain torque.
- readonly attribute short value
- MUST return powertrain torque (Unit: newton meters)
The AcceleratorPedalPosition
interface represents the accelerator pedal position.
- readonly attribute unsigned short value
- MUST return accelerator pedal position as a percentage (Unit: percentage, 0%: released pedal, 100%: fully depressed)
The ThrottlePosition
represents position of the throttle.
- readonly attribute unsigned short value
- MUST return throttle position as a percentage (Unit: percentage, 0%: closed, 100%: fully open)
Trip Interface
The Trip interface
represents trip meter.
- readonly attribute unsigned long distance
- MUST return distance travelled based on trip meter (Unit: meters)
- readonly attribute unsigned short? averageSpeed
- MUST return average speed based on trip meter (Unit: kilometers per hour)
- readonly attribute unsigned short? fuelConsumption
- MUST return fuel consumed based on trip meter (Unit: milliliters per 100 kilometers)
- readonly attribute Trip[] meters;
- MUST return trip meters
The Transmission interface represents the current transmission gear and mode.
- park
- Transmission is in park
- reverse
- Transmission is in reverse
- neutral
- Transmission is in neutral
- low
- Transmission is in low
- drive
- Transmission is in drive
- overdrive
- Transmission is in overdrive
- readonly attribute octet? gear
- MUST return transmission gear position. Range 0 - 10
- readonly attribute TransmissionMode? mode
- MUST return transmission Mode (see TransmissionMode)
The CruiseControlStatus interface represents cruise control settings.
- readonly attribute boolean status
- MUST return whether or not the Cruise Control system is on (true) or off (false)
- readonly attribute unsigned short speed
- MUST return target Cruise Control speed in kilometers per hour (Unit: kilometers per hour)
The LightStatus interface represents exterior light statuses.
- attribute boolean head
- MUST return headlight status: on (true), off (false)
- attribute boolean rightTurn
- MUST return right turn signal status: on (true), off (false)
- attribute boolean leftTurn
- MUST return left turn signal status: on (true), off (false)
- attribute boolean brake
- MUST return Brake light status: on (true), off (false)
- attribute boolean? fog
- MUST return Fog light status: on (true), off (false)
- attribute boolean hazard
- MUST return Hazard light status: on (true), off (false)
- attribute boolean parking
- MUST return Parking light status: on (true), off (false)
- attribute boolean highBeam
- MUST return HighBeam light status: on (true), off (false)
- attribute boolean? automaticHeadlights
- MUST return whether automatic head lights status: activated (true) or not (false)
- attribute boolean? dynamicHighBeam
- MUST return whether dynamic high beam status: activated (true) or not (false)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The InteriorLightStatus interface represents interior light status.
- attribute boolean status
- MUST return interior light status for the given zone: on (true), off (false)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
Horn Interface
The Horn interface represents horn status.
- attribute boolean status
- MUST return Horn status: on (true) or off (false)
The Chime interface represents chime status.
- readonly attribute boolean status
- MUST return Chime status when a door is open: on (true) or off (false)
Fuel Interface
The Fuel interface represents vehicle fuel status.
- readonly attribute unsigned short? level
- MUST return fuel level as a percentage of fullness
- readonly attribute unsigned long? range
- MUST return estimated fuel range (Unit: meters)
- readonly attribute unsigned long? instantConsumption
- MUST return instant fuel consumption in per distance travelled (Unit: milliliters per 100 kilometers)
- attribute unsigned long? averageConsumption
- MUST return average fuel consumption in per distance travelled (Unit: milliliters per 100 kilometers). Setting this to any value should reset the counter to '0'
- readonly attribute unsigned long? fuelConsumedSinceRestart
- MUST return fuel consumed since engine start; (Unit: milliliters per 100 kilometers) resets to 0 each restart
- readonly attribute unsigned long? timeSinceRestart
- MUST return time elapsed since vehicle restart (Unit: seconds)
The EngineOil interface represents engine oil status.
- readonly attribute unsigned short level
- MUST return engine oil level (Unit: percentage, 0%: empty, 100%: full
- readonly attribute unsigned short lifeRemaining
- MUST return remaining engine oil life (Unit: percentage, 0%:no life remaining, 100%: full life remaining
- readonly attribute long temperature
- MUST return Engine Oil Temperature (Unit: celcius)
- readonly attribute unsigned short pressure
- MUST return Engine Oil Pressure (Unit: kilopascals)
- readonly attribute boolean change
- MUST return engine oil change indicator status: change oil (true) or no change (false)
The Acceleration interface represents vehicle acceleration.
- readonly attribute long x
- MUST return acceleration on the "X" axis (Unit: centimeters per second squared)
- readonly attribute long y
- MUST return acceleration on the "Y" axis (Unit: centimeters per second squared)
- readonly attribute long z
- MUST return acceleration on the "Z" axis (Unit: centimeters per second squared)
The EngineCoolant
represents values related to engine coolant.
- readonly attribute octet level
- MUST return engine coolant level (Unit: percentage 0%: empty, 100%: full)
- readonly attribute short temperature
- MUST return engine coolant temperature (Unit: celcius)
The SteeringWheel
represents steering wheel data.
- readonly attribute short angle
- MUST return angle of steering wheel off centerline (Unit: degrees -:degrees to the left, +:degrees to the right)
The WheelTick
number of ticks per second.
- readonly attribute unsigned long value
- MUST return number of ticks per second (Unit: ticks per second)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The IgnitionTime
represents status of ignition.
- readonly attribute DOMTimeStamp ignitionOnTime
- MUST return time at ignition on
- readonly attribute DOMTimeStamp ignitionOffTime
- MUST return time at ignition off
The YawRate
represents vehicle yaw rate.
- readonly attribute short value
- MUST return yaw rate of vehicle. (Unit: degrees per second)
The BrakeOperation
represents vehicle brake operation.
- readonly attribute boolean brakePedalDepressed
- MUST return whether brake pedal is depressed or not. true: brake pedal is depressed, false: brake pedal is not depressed
The ButtonEvent
represents button press events from the steering wheel or other source
- home
- back
- search
- call
- end_call
- media_play
- media_next
- media_previous
- media_pause
- voice_recognize
- enter
- left
- right
- up
- down
- press
- long_press
- release
- readonly attribute Button button
- MUST return the button corresponding to the event.
- readonly attribute ButtonEventType state
- MUST return the type of event
- readonly attribute VehicleButton[] button
- MUST return the button events that occured. This supports multiple simultanious button events.
The DrivingMode interface provides information about whether or not the vehicle is driving. DrivingMode is an abstract data type that may
combine several other data types such as vehicle speed, transmission gear, etc. Typical usage would be to disable certain functions in the application
if the vehicle is not safe to operate those functions to avoid driver distraction.
- readonly attribute boolean mode
- MUST return true if vehicle is in driving mode
The NightMode interface provides information about whether or not it is night time. NightMode is an abstract data type that may
combine several other data types such as exterior brightness, time of day, sunrise/sunset, etc to determine whether or not it is night time.
Typical usage is to change the UI theme to a darker theme during the night.
- readonly attribute boolean mode
- MUST return true if it is night time
Maintenance Interfaces
Interfaces relating to vehicle maintenance, the act of inspecting or testing the condition of vehicle
subsystems (e.g., engine) and servicing or replacing parts and fluids.
- readonly attribute VehicleSignalInterface odometer
- MUST return VehicleSignalInterface for accessing Odometer or undefined if not supported
- readonly attribute VehicleSignalInterface transmissionOil
- MUST return VehicleSignalInterface for accessing TransmissionOil
- readonly attribute VehicleSignalInterface transmissionClutch
- MUST return VehicleSignalInterface for accessing TransmissionClutch
- readonly attribute VehicleSignalInterface brakeMaintenance
- MUST return VehicleSignalInterface for accessing BrakeMaintenance
- readonly attribute VehicleSignalInterface washerFluid
- MUST return VehicleSignalInterface for accessing WasherFluid
- readonly attribute VehicleSignalInterface malfunctionIndicator
- MUST return VehicleSignalInterface for accessing MalfunctionIndicator
- readonly attribute VehicleSignalInterface batteryStatus
- MUST return VehicleSignalInterface for accessing BatteryStatus
- readonly attribute VehicleSignalInterface tire
- MUST return VehicleSignalInterface for accessing Tire
- readonly attribute VehicleSignalInterface diagnostic
- MUST return VehicleSignalInterface for accessing Diagnostic
The Odometer interface provides information about the distance that the
vehicle has traveled.
- readonly attribute unsigned long? distanceSinceStart
- MUST return the distance traveled by vehicle since start (Unit: meters).
- readonly attribute unsigned long distanceTotal
- MUST return the total distance traveled by the vehicle (Unit: meters).
The TransmissionOil interface provides information about the state of a
vehicles transmission oil.
- readonly attribute octet? wear
- MUST return transmission oil wear (Unit: percentage, 0: no wear, 100: completely worn).
- readonly attribute byte? temperature
- MUST return current temperature of the transmission oil(Unit: celsius).
The TransmissionClutch interface provides information about the state of a
vehicles transmission clutch.
- readonly attribute octet wear
- MUST return transmission clutch wear (Unit: percentage, 0%: no wear, 100%: completely worn).
The BrakeMaintenance interface provides information about the maintenance state of a
vehicles brakes.
- readonly attribute octet? fluidLevel
- MUST return brake fluid level (Unit: percentage, 0%: empty, 100%: full).
- readonly attribute boolean? fluidLevelLow
- MUST return true if brake fluid level: low (true), not low (false)
- readonly attribute octet? padWear
- MUST return brake pad wear (Unit: percentage, 0%: no wear, 100%: completely worn).
- readonly attribute boolean? brakesWorn
- MUST return true if brakes are worn: worn (true), not worn (false)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The WasherFluid interface provides information about the state of a
vehicles washer fluid.
- readonly attribute unsigned short? level
- MUST return washer fluid level (Unit: percentage, 0%: empty, 100%: full).
- readonly attribute boolean? levelLow
- MUST return true if washer fluid level is low: low (true), not low: (false)
The MalfunctionIndicator interface provides information about the state of a
vehicles Malfunction Indicator lamp.
- readonly attribute boolean on
- MUST return true if malfunction indicator lamp is on: lamp on (true), lamp not on (false)
The BatteryStatus interface provides information about the state of a
vehicles battery.
- readonly attribute octet? chargeLevel
- MUST return battery charge level (Unit: percentage, 0%: empty, 100%: full).
- readonly attribute unsigned short? voltage
- MUST return battery voltage (Unit: volts).
- readonly attribute unsigned short? current
- MUST return battery current (Unit: amperes).
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
Tire Interface
The Tire interface provides information about the state of a
vehicles tires.
- readonly attribute boolean? pressureLow
- MUST return true if any tire pressure is low: pressure low (true), pressure not low (false)
- readonly attribute unsigned short? pressure
- MUST return tire pressure (Unit: kilopascal).
- readonly attribute short? temperature
- MUST return tire temperature (Unit: celsius).
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The Diagnostic interface
represents Diagnostic interface to malfunction indicator light information.
- readonly attribute unsigned long accumulatedEngineRuntime
- MUST return engine runtime (Unit: seconds)
- readonly attribute unsigned long distanceWithMILOn
- MUST return distance travelled with the malfunction indicator light on (Unit: meters)
- readonly attribute unsigned long distanceSinceCodeCleared.
- MUST return distance travelled since the codes were last cleared (Unit: meters)
- readonly attribute unsigned long timeRunMILOn
- MUST return time elapsed with the malfunction indicator light on (Unit: seconds)
- readonly attribute unsigned long timeTroubleCodeClear
- MUST return time elapsed since the trouble codes were last cleared (Unit: seconds)
Personalization Interfaces
Interfaces relating personalization the settings of vehicle
such as seat and mirror position.
- readonly attribute VehicleSignalInterface? languageConfiguration
- MUST return VehicleSignalInterface for accessing LanguageConfiguration
- readonly attribute VehicleSignalInterface unitsOfMeasure
- MUST return VehicleSignalInterface for accessing UnitsOfMeasure
- readonly attribute VehicleSignalInterface mirror
- MUST return VehicleSignalInterface for accessing Mirror
- readonly attribute VehicleSignalInterface driveMode
- MUST return VehicleSignalInterface for accessing DriveMode
- readonly attribute VehicleSignalInterface seatAdjustment
- MUST return VehicleSignalInterface for accessing SeatAdjustment
- readonly attribute VehicleSignalInterface dashboardIllumination
- MUST return VehicleSignalInterface for accessing DashboardIllumination
- readonly attribute VehicleSignalInterface vehicleSound
- MUST return VehicleSignalInterface for accessing VehicleSound
The LanguageConfiguration interface provides language information about a
vehicle.
- attribute DOMString? language
- MUST return language identifier based on two-letter codes as specified in ISO 639-1
The UnitsOfMeasure interface provides information about the measurement
system and units of measure of a vehicle.
- attribute boolean? isMKSSystem
- MUST return measurement system currently being used by vehicle.
'true' means the current measurement system is MKS-km(liter).
'false' means it is US customary units-mile(gallon).
- attribute DOMString? unitsFuelVolume
- MUST return fuel unit of measurement. The value is one of both "litter" and "gallon".
- attribute DOMString? unitsDistance
- MUST return distance unit of measurement. The value is one of both "km" and "mile".
- attribute DOMString? unitsSpeed
- MUST return speed unit of measurement. The value is one of both "km/h" and "mph".
- attribute DOMString? unitsFuelConsumption
- MUST return fuel consumption unit of measurement.
The value is one of following values: "l/100", "mpg", "km/l".
The Mirror interface provides or sets information about mirrors
in vehicle.
- attribute octet? mirrorTilt
- MUST return mirror tilt position in percentage distance travelled, from downward-facing to
upward-facing position (Unit: percentage, 0%:center position, -100%:fully downward, 100%:full upward)
- attribute octet? mirrorPan
- MUST return mirror pan position in percentage distance travelled, from left to right
position (Unit: percentage, %0:center position, -100%:fully left, 100%:fully right)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The SeatAdjustment interface provides or sets information about seats
in vehicle.
- attribute octet? reclineSeatBack
- MUST return seat back recline position as percent to completely reclined
(Unit: percentage, 0%: fully forward, 100%: fully reclined)
- attribute octet? seatSlide
- MUST return seat slide position as percentage of distance travelled away from forwardmost
position (Unit: percentage, 0%: farthest forward, 100%: farthest back)
- attribute octet? seatCushionHeight
- MUST return seat cushion height position as a percentage of upward distance travelled
(Unit: percentage, 0%: lowest. 100%: highest)
- attribute octet? seatHeadrest
- MUST return headrest position as a percentage of upward distance travelled
(Unit: percentage, 0%: lowest, 100%: highest)
- attribute octet? seatBackCushion
- MUST return back cushion position as a percentage of lumbar curvature
(Unit: percentage, 0%: flat, 100%: maximum curvature)
- attribute octet? seatSideCushion
- MUST return sides of back cushion position as a percentage of curvature
(Unit: percentage, 0%: flat, 100%: maximum curvature)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The DriveMode interface provides or sets information about a vehicles
drive mode.
- comfort
- Comfort mode
- auto
- Automatically set mode
- sport
- Sport mode
- eco
- Ecological/fuel efficient mode
- manual
- Manual mode
- winter
- Winter/slippery mode
- attribute DriveModeType? driveMode
- MUST return vehicle drive mode
The DashboardIllumination interface provides or sets information about dashboard
illumination in vehicle.
- attribute octet? dashboardIllumination
- MUST return illumination of dashboard as a percentage
(Unit: percentage, 0%: none, 100%: maximum illumination)
The VehicleSound interface provides or sets information about vehicle sound.
- attribute boolean activeNoiseControlMode
- MUST return active noise control status: not-activated (false), activated (true)
- attribute DOMString? engineSoundEnhancementMode
- MUST return engine sound enhancement mode where a null string means not-activated, and any
other value represents a manufacture specific setting. See availableSounds.
- readonly attribute DOMString[]? availableSounds
- MUST return array of available sounds. See engineSoundEnhancementMode
DrivingSafety Interfaces
Interfaces related to driving safety such as anti-lock braking and airbag status.
- readonly attribute VehicleSignalInterface antilockBrakingSystem
- MUST return VehicleSignalInterface for accessing AntilockBrakingSystem
- readonly attribute VehicleSignalInterface tractionControlSystem
- MUST return VehicleSignalInterface for accessing TractionControlSystem
- readonly attribute VehicleSignalInterface electronicStabilityControl
- MUST return VehicleSignalInterface for accessing ElectronicStabilityControl
- readonly attribute VehicleSignalInterface topSpeedLimit
- MUST return VehicleSignalInterface for accessing TopSpeedLimit
- readonly attribute VehicleSignalInterface airbagStatus
- MUST return VehicleSignalInterface for accessing AirbagStatus
- readonly attribute VehicleSignalInterface door
- MUST return VehicleSignalInterface for accessing Door
- readonly attribute VehicleSignalInterface childSafetyLock
- MUST return VehicleSignalInterface for accessing ChildSafetyLock
- readonly attribute VehicleSignalInterface seat
- MUST return VehicleSignalInterface for accessing Seat
The AntilockBrakingSystem interface
provides status of ABS(Antilock Braking System) status and setting.
- readonly attribute boolean enabled
- MUST return whether or not the ABS Setting is enabled: enabled (true) or disabled (false)
- readonly attribute boolean engaged
- MUST return whether or not the ABS is engaged: engaged (true) or idle (false)
The TractionControlSystem interface
provides status of TCS(Traction Control System) status and setting.
- readonly attribute boolean enabled
- MUST return whether or not the TCS Setting is enabled: enabled (true) or disabled (false)
- readonly attribute boolean engaged
- MUST return whether or not the TCS is engaged: engaged (true) or idle (false)
The ElectronicStabilityControl interface
provides status of ESC(Electronic Stability Control) status and setting.
- readonly attribute boolean enabled
- MUST return whether or not the ESC Setting is enabled: enabled (true) or disabled (false)
- readonly attribute boolean engaged
- MUST return whether or not the ESC is engaged: engaged (true) or idle (false)
The TopSpeedLimit interface
provides the current setting of top speed limit of the vehicle.
- readonly attribute unsigned short speed
- MUST return vehicle top speed limit (Unit: kilometers per hour)
The AirbagStatus interface
provides the current status of airbags in each zones of the vehicle.
- readonly attribute boolean activated
- MUST return whether or not the airbag is activaged: activated (true) or deactivated (false)
- readonly attribute boolean deployed
- MUST return whether the airbag is deployed: deployed (true) or not (false)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
Door Interface
The Door interface
provides the current status of doors in each zones of the vehicle.
- open
- Door is opened
- ajar
- Door is ajar
- closed
- Door is closed
- readonly attribute DoorOpenStatus status
- MUST return the status of door's open status
- attribute boolean lock
- MUST return whether or not the door is locked: locked (true) or unlocked (false)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The ChildSafetyLock interface
provides the current setting of Child Safety Lock.
- attribute boolean lock
- MUST return whether or not the Child Safety Lock is locked: locked (true) or unlocked (false)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
Seat Interface
The Seat interface
provides the current occupant information and seatbelt status of a seat in different zones of the vehicle.
- adult
- Occupant is an adult
- child
- Occupant is a child
- vacant
- Seat is vacant
- pin
- Four digit pin number entered by user
- keyfob
- Identification by key fob
- Bluetooth
- Identification by Bluetooth device
- NFC
- Identification by NFC device
- fingerprint
- Identification by fingerprint
- camera
- Identification by camera
- voice
- Identification by voice
- readonly attribute OccupantStatus occupant
- MUST return the status of seat occupant
- readonly attribute boolean seatbelt
- MUST return whether or not the seat belt is fastened: fastened (true) or unfastened (false)
- readonly attribute DOMString? occupantName
- Must return occupant identifier
- readonly attribute IdentificationType identificationType
- MUST return identification type
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
Climate Interfaces
Interfaces related to vehicle climate (interior and exterior) such as temperature and rain.
- readonly attribute VehicleSignalInterface temperature
- MUST return VehicleSignalInterface for accessing Temperature
- readonly attribute VehicleSignalInterface rainSensor
- MUST return VehicleSignalInterface for accessing RainSensor
- readonly attribute VehicleSignalInterface wiperStatus
- MUST return VehicleSignalInterface for accessing WiperStatus
- readonly attribute VehicleSignalInterface defrost
- MUST return VehicleSignalInterface for accessing Defrost
- readonly attribute VehicleSignalInterface sunroof
- MUST return VehicleSignalInterface for accessing Sunroof
- readonly attribute VehicleSignalInterface convertibleRoof
- MUST return VehicleSignalInterface for accessing ConvertibleRoof
- readonly attribute VehicleSignalInterface sideWindow
- MUST return VehicleSignalInterface for accessing SideWindow
- readonly attribute VehicleSignalInterface climateControl
- MUST return VehicleSignalInterface for accessing ClimateControl or undefined if not supported
- readonly attribute VehicleSignalInterface atmosphericPressure
- MUST return VehicleSignalInterface for accessing AtmosphericPressure
The Temperature interface provides information about the current temperature of outside or inside vehicle.
- readonly attribute float interiorTemperature
- MUST return the current temperature of the air inside of the vehicle (Unit: celsius)
- readonly attribute float exteriorTemperature
- MUST return the current temperature of the air around the vehicle (Unit: celsius)
The RainSensor interface provides information about ambient light levels.
- readonly attribute octet rainIntensity
- MUST return the amount of rain detected by the rain sensor. level of rain intensity (0: No Rain, 10:Heaviest Rain)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The WiperStatus interface represents the status of wiper operation.
- off
- Wiper is not in operation
- once
- Wipe single. It's a transient state and goes to the off mode
- slowest
- Wiper is on mode with the slowest speed
- slow
- Wiper is on mode with slow speed
- middle
- Wiper is on mode with middle speed
- fast
- Wiper is on mode with fast speed
- fastest
- Wiper is on mode with the fastest speed
- auto
- Wiper is on the automatic mode which controls wiping speed with accordance with the amount of rain
- readonly attribute WiperControl wiperSpeed
- MUST return current speed interval of wiping windshield
- attribute WiperControl wiperSetting
- MUST return current setting of the front wiper controller. It can be used to send user's request for changing setting.
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The Defrost interface represents the status of wiper operation.
- attribute boolean? defrostWindow
- MUST return current status of the defrost switch for window. It can be used to send user's request for changing setting.
- attribute boolean? defrostMirrors
- MUST return current status of the defrost switch for mirrors. It can be used to send user's request for changing setting.
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The Sunroof interface represents the current status of Sunroof.
- attribute octet openness
- MUST return current status of Sunroof as a percentage of openness (0%: closed, 100%: fully opened)
- attribute octet tilt
- MUST return current status of Sunroof as a percentage of tilted (0%: closed, 100%: maximum tilted)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
Both can be used to send user's request for changing setting.
The ConvertibleRoof interface represents the current status of Convertible Roof.
- closed
- the convertible roof is closed
- closing
- the convertible roof is closing
- opening
- the convertible roof is opening
- opened
- the convertible roof is opened
- readonly attribute ConvertibleRoofStatus status
- MUST return current status of Convertible Roof.
- attribute boolean? setting
- MUST return current setting of Convertible Roof. This is used to open (true) and close (false).
This attribute can be used to send user's request for changing setting. "closed" is used to close and "opened" is used to open.
The SideWindow interface represents the current status of openness of side windows.
- attribute boolean? lock
- MUST return whether or not the window is locked: locked (true) or unlocked (false)
- attribute octet? openness
- MUST return current status of the side window as a percentage of openness. (0%: Closed, 100%: Fully Opened)
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
The ClimateControl interface represents the current setting of the climate control equipments such as heater and air conditioner.
- frontpanel
- Air flow is directed to the instrument panel outlets
- floorduct
- Air flow is directed to the floor outlets
- bilevel
- Air flow is directed to the instrument panel outlets and the floor outlets
- defrostfloor
- Air flow is directed to the floor outlets and the windshield
- attribute AirflowDirection airflowDirection
- MUST return current status of the direction of the air flow through the ventilation system
- attribute octet fanSpeedLevel
- MUST return current status of the fan speed of the air flowing (0: off, 1: weakest, 10: strongest )
- attribute byte? targetTemperature
- MUST return current setting of the desired temperature (Unit: celsius)
- attribute boolean airConditioning
- MUST return current status of the air conditioning system: on (true) or off (false)
- attribute boolean heater
- MUST return current status of the heating system: on (true) or off (false)
- attribute octet? seatHeater
- MUST return current status of the seat warmer ( 0: off, 1: least warm, 10: warmest )
- attribute octet? seatCooler
- MUST return current status of the seat ventilation ( 0: off, 1: least warm, 10: warmest )
- attribute boolean airRecirculation
- MUST return current setting of air recirculation: on (true) or pulling in outside air (false).
- attribute octet? steeringWheelHeater
- MUST return current status of steering wheel heater ( 0: off, 1: least warm, 10: warmest ).
- readonly attribute Zone? zone
- MUST return Zone for requested attribute
ClimateControl can be used to send user's request for changing setting.
The AtmosphericPressure interface provides information about the current atmospheric pressure outside of the vehicle.
- readonly attribute unsigned short pressure
- MUST return the current atmospheric pressure outside of the vehicle (Unit: hectopascal)