Safety notice¶
Not a vehicle instrument
anywidget-instruments-automotive is a library for visualization, teaching, simulation and aftermarket dashboards in notebooks. Its widgets are not type-approved vehicle components, are not designed or verified according to automotive functional safety (ISO 26262), and must not be used in place of a vehicle's own instruments.
It does not replace the vehicle's instruments¶
A vehicle's speedometer, odometer and tell-tales are regulated equipment: their accuracy, symbols and colours are part of the vehicle's type approval (for example UN Regulations No. 39 and No. 121 in the countries that apply them). A widget drawing a speedometer or an engine warning light is none of that:
- the driver must keep relying on the vehicle's own speedometer and warning lights;
- a
TellTaleshowing "off" does not mean the vehicle has no fault: it means the code feeding it did not report one; - the tell-tale symbols are original drawings modelled on the meaning of the ISO 2575 symbols, not the symbols of the standard, and the function a colour is given for is the library's choice: a vehicle's own tell-tale may look different or take another colour;
- a
Speedometeris only as right as the value it is given. Values read over OBD-II arrive late — a request and its answer take tens to hundreds of milliseconds, and an adapter polls several parameters in turn — and can be wrong or stale.
Driver distraction¶
Looking at a screen while driving is dangerous, and in many countries using a handheld device while driving is an offence.
- Set up, configure and read the dashboard while stationary. The widgets offer no interaction meant to be performed while driving.
- A passenger, not the driver, operates the notebook.
- Mount any device so that it does not obstruct the driver's view of the road nor the vehicle's own instruments, and so that it cannot become a projectile in a collision or interfere with an airbag.
The design limits on the number of items and on motion (see Standards and references) reduce the attention a page demands; they do not make it safe to use while driving.
Head-up display mode¶
The HUD mode mirrors a page for a reflection in the windscreen. A phone or tablet laid on the dashboard:
- can dazzle at night or produce a double image; lower its brightness and check the reflection before driving;
- must not slide, block air vents meant to demist the windscreen, or sit where an airbag deploys.
Limits of a notebook environment¶
A notebook is not a real-time system. The kernel, the browser, the host or the link to the vehicle can freeze, restart or disconnect; displayed values can then be delayed or stale. A widget shows when its value is stale (see the specification), which reduces the risk of trusting an old figure but does not remove it.
Connecting to a vehicle¶
Reading a vehicle's data is outside the scope of the library: the values come from the code that feeds the widgets, such as CAN & CANopen Studio. Whoever connects a vehicle is responsible for doing so read-only unless they know what a write does, and for complying with the regulations that apply to them.
No warranty¶
The library is distributed under the BSD 3-Clause license, "as is", without warranty of
any kind (see the LICENSE file). The standards cited in
this notice are listed with their disclaimer in Standards and references.