Library to provide Dash measurements via the OpenXC project. This project provides
an implementation of the OpenXC
interface VehicleDataSource
which provides Measurement
values for diagnostic information produced by a running Dash service.
Just like openxc-android, the build requires Maven
v3.0.3+ and the Android SDK
to be installed in your development environment. In addition you'll need to set the ANDROID_HOME
environment variable to the location of your SDK:
export ANDROID_HOME=/opt/tools/android-sdk
After satisfying those requirements, run the standard maven command:
mvn clean install
To use the DashDataSource
install it like any other OpenXC
VehicleDataSource implementation.
See the OpenXC API Guide for more information.
Additionally, you must use the Dash Labs forked version of openxc-android as it includes the DiagnosticTroubleCode
measurment object and a number of minor fixes. Dash Labs is working with the openxc
team to include these changes
directly into the openxc-android
project.
By using openxc-dash
on phones with a version of Dash installed,
and an OBD-II compliant hardware device, your project will get access to diagnostic trouble codes in real time. This means that if an engine-light goes on
your openxc
project will receive a measurement reading DiagnosticTroubleCode
whose value is a String
representing the mechanic code (e.g., P0001
).
Note, as long as the vehicle supports the OBD-II hardware device (which is all cars 1996 or newer in the United States), you will receive these DiagnosticTroubleCode
measurements.
This isn't particular to Ford vehicles.