So you just bought an OpenXC BLE vehicle interface? Let’s get it programmed and
test it in a car with your iOS device or Mac.
If you have issues at any point in this process, check for similar issues in the
Google Group or create a new
post to ask for some assistance.
Install the OpenXC Demo application from Demo App on your iOS phone/simulator.
Follow the steps mentioned in this document
The Demo app takes care of a lot of boilerplate code, so your app’s code can be
simpler. It also includes a basic GUI for most functionality of the iOS
Note: Even if you only plan to use previously recorded trace
files and don't need to connect to a physical vehicle interface, the Demo app
still must be installed.
The Demo app also has views that allow you to:
- Display all received simple vehicle messages from the VI.
- Display all received low-level CAN messages from the VI, if that
functionality is enabled in the firmware.
- Send an arbitrary CAN message to the vehicle through the VI (requires firmware
that supports this feature).
- Send a diagnostic request to the vehicle through the VI.
- Send commands
It’s a fairly basic UI, so consider these proof of concept features. Everything
they do is available via the library’s API.
Program the Vehicle Interface
If you haven’t done so already, visit the VI firmware page to find the
right firmware for your VI and to learn how to re-program it.
If you plan only to use pre-recorded vehicle data trace files instead of a
physical vehicle interface, you can skip this step.
Obtaining real vehicle data from VI
- Plug the vehicle interface into the OBD-II port in your car - it will be
somewhere below the steering wheel, possibly behind a door. It should light up
blue if it's plugged in all the way and the car is running.
- Run the OpenXC Demo app, hit the
Search for BLE VI
button and wait a moment. Within a minute, it should detect your BLE VI.
- If your VI is plugged into a running vehicle, after a few seconds it will
open a connection and start receiving vehicle data. You should see a Green checkmark
icon appear next to "Active Connections" and the "Messages Received" number
should be increasing.
- Click on Dashboard to see the list of messages being received from the VI.
You can now install the OpenXC iOS
library and get started creating
your first app.