This specification defines a Vehicle Information API which offers a simple interface to get access to vehicle data. A typical use case of the Vehicle Information is the implementation of a tachometer application that allows view information from the vehicle such as speed, tire pressure, and engine rotation speed (RPMs).

Introduction

TBW

Use Cases for climate/environment interfaces

API Description & Properties

Temperature Interface

The Temperature interface provides information about the current temperature of outside or inside vehicle.

readonly attribute short interiorTemperature
the current temperature of the air inside of the vehicle.
readonly attribute short exteriorTemperature
the current temperature of the air around the vehicle

Unit is deg. of Celsius
Resolution is 0.5
Range is -70 to 125
This interface is optional

There's relevant exploratory work in W3C.
https://dvcs.w3.org/hg/dap/raw-file/default/temperature/Overview.html
However, interior or exterior temperature must be distinguished in vehicles.

RainSensor Interface

The RainSensor interface provides information about ambient light levels.

readonly attribute unsigned byte rain
the amount of rain detected by the rain sensor. level of rain intensity ( 0: No Rain ~ 10: Heaviest Rain)

WiperStatus Interface

The WiperStatus interface represents the status of wiper operation.

readonly attribute unsigned byte frontWiperSpeed
current speed interval of wiping windshield ( 0: off, 1: Slowest ~ 10: Fastest )
readonly attribute unsigned byte? rearWiperSpeed
current speed interval of wiping rear window ( 0: off, 1: Slowest ~ 10: Fastest )

rearWiperSpeed is optional depending on vehicle type.

WiperSetting Interface

The WiperSetting interface represents the current setting of the wiper controller.

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
attribute WiperControl frontWiperControl
current setting of the front wiper controller. It can be used to send user's request for changing setting.
attribute WiperControl? rearWiperControl
current setting of the rear wiper controller. It can be used to send user's request for changing setting.

rearWiperControl is optional depending on vehicle type.

Defrost Interface

The Defrost interface represents the status of wiper operation.

attribute boolean defrostWindShield
current status of the defrost switch for WindShield. It can be used to send user's request for changing setting.
attribute boolean? defrostRearWindow
current status of the defrost switch for rear window. It can be used to send user's request for changing setting.
attribute boolean? defrostSideMirrors
current status of the defrost switch for side mirrors. It can be used to send user's request for changing setting.

defrostRearWindow, defrostSideMirrors are optional depending on vehicle type.

Sunroof Interface

The Sunroof interface represents the current status of Sunroof.

attribute unsigned byte openness
current status of Sunroof as a percentage of openness ( 0: Closed, 100: Fully Opened).
attribute unsigned byte tilt
current status of Sunroof as a percentage of tilted ( 0: Closed, 100: Maximum Tilted).

Both can be used to send user's request for changing setting.

ConvertibleRoof Interface

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
attribute ConvertibleRoofStatus status
current status of Convertible Roof.

It can be used to send user's request for changing setting. "closed" is used to close and "opened" is used to open.

SideWindow Interface

The SideWindow interface represents the current status of openness of side windows.

attribute unsigned byte openness
current status of the side window as a percentage of openness. (0:Closed, 100:Fully Opened)
Available Zone: Front, Rear, Left, Right

It can be used to send user's request for changing setting.

ClimateControl Interface

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
current status of the direction of the air flow through the ventilation system
attribute unsigned byte fanSpeedLevel
current status of the fan speed of the air flowing ( 0: off, 1: weakest ~ 10: strongest )
attribute byte? targetTemperature
current setting of the desired temperature (Unit is deg. of Celsius, Resolution is 0.5, Range is -70 to 125)
attribute boolean airConditioning
current status of the air conditioning system (true: on, false: off)
attribute boolean heater
current status of the heating system (true: on, false: off)
attribute unsigned byte? seatHeater
current status of the seat warmer ( 0: off, 1: least warm ~ 10: warmest )
attribute unsigned byte? seatCooler
current status of the seat ventilation ( 0: off, 1: least warm ~ 10: warmest )
attribute boolean airRecirculation
current setting of air recirculation. (true : on, false : pulling in outside air).
Available Zone: None
attribute unsigned byte? steeringWheelHeater
current status of steering wheel heater ( 0: off, 1: least warm ~ 10: warmest ).
Available Zone: None

ClimateControl can be used to send user's request for changing setting.