PriiDash(TM) - Enhanced Instrument Panel and Data Logger for the Prius and more

PriiDash: Project Web Hosting - Open Source Software

PriiDash^(TM) Home Page

PriiDash(TM) is an enhanced instrument panel and data logger for the Prius and more. Obtain and display real time CAN bus data on a car PC through the OBD port via an ELM327 compatible OBD-USB device.

PriiDash(TM) in action PriiDash(TM) in action close up

PriiDash(TM) was registered on SourceForge.net on Jun 8, 2011. The exact license terms used by this project are in the licensing documents LICENSE.txt and GPL(v.3).txt (also included in the downloads).

Acknowledgements

Features

Users

Safety - Read Me First!

Features

Currently support only Gen 2 Prius (2004 ~ 2009).

"Green Zone" and "Red Line": Gauge changes color when the value crosses certain thresholds for easy visualization. Some examples:

Engine Coolant Temperature/ Warm Up Stages	Stage 2	Stage 3/4	Overheat
HV Battery Current	Discharging	Recharging	Gliding
Speed/ Condition for ICE Stop	No stop in S3	Can stop in S3	Has to spin
Engine RPM	ICE Off	Mid RPM	High RPM
Fuel Gauge	Near Full	Low
Inverter/ MG Temperatures		Inverter 2 and MG 2 overheat Inverter 1, converter and MG 1 OK

Each gauge displays min and max values logged.
High precision speedometer (0.1 MPH) and odometer (0.01 mile).

[Back] [Top]

Users

Safety - Read Me First!

Hardware and Software Setup - Please read thoroughly!

Download PriiDash files

Pictures and Screen Shots

Data Logs and Analysis - Please contribute to the collective knowledge once you get the software working.

FAQs and Troubleshoot

Feature Suggestions and Bug Report

Project detail and discuss: Project summary page | Forum at PriusChat

Reviews

Get support

Donate money - Please consider supporting the development of PriiDash(TM) if you find it useful.

[Back] [Top]

Not what you're looking for?

SourceForge.net hosts over 100,000 Open Source projects. You may find what you're looking for by searching our site or using our Software Map.

Safety - Read Me First!

Drive safely and responsibly.

Keep your eyes on the road at all times while driving.

You don't want to end up like this, do you?

EMS Helicopter Flipped Car.jpg

[Back] [Top]

Hardware and Software Setup - Please read thoroughly!

Hardware: We need a laptop or netbook, and an ELM327 compatible OBD-USB device. Connect the hardware and set the baud rate to 2M bps. Just as an example and without any implied endorsement or promotion, I am currently using an Eee PC 1001PXD-EU17 10.1-inch netbook with Intel Atom N455 CPU, 1 GB RAM and Win7 Starter (as out of box without any upgrade), and an OBDLink device.
Operating System: The software assumes Linux system so it is slightly time consuming to set it up on a Windows machine. Linux users need to recompile from the source and link with X11, FLTK and Boost_thread libraries. Windows users may do the same or use the precompiled "priidash.exe" file and set up directories and the USB-serial port as instructed below. Windows users please download and install Cygwin with the following components:
1. devel/cmake
2. devel/gcc ("gcc-core" and "gcc-g++")
3. devel/make
4. devel/gdb
5. devel/subversion (just "subversion")
6. X11/xinit
7. X11/libfltk-devel
8. X11/libfltk1.1-gdi
9. lib/boost
The Cygwin installer will suggest some other dependent components. Please keep them selected. Then it will go to the web to download and install all the selected components. On my laptop Cygwin (with the components listed above) takes about 700 MB of disk space.
Directories and Ports: The precompiled "priidash.exe" file needs a text file "ODO.txt" (containing the current odometer reading) in the same directory, assumes the USB-serial port is COM7, and saves the log data in the path "f:\OBDLog\". So to use the precompiled "priidash.exe" file directly we need to create the file "ODO.txt" with the current odometer reading and put it in the same directory as the "priidash.exe" file, go to the Device Manager to set the USB-serial port to COM7, and go to the Disk Management to either create a partition "f:" or change the drive letter of a disk to "f:", and then create a directory "OBDLog" under it. Once these are set the program needs to be executed from a cygwin xterm, not from a Windows cmd.exe window.
Disk Space: The data logs are plain text and csv files and can take a lot of disk space, about 160 MB per hour of driving. It is probably wise to use a solid state device as opposed to a hard disk unless it's shock proof. For example I use an 8 GB HDSC card and set its drive letter to "f:".
Usage: To run the program, first open an X terminal (Start | All Programs | Cygwin-X | XWin Server). Change directory (cd) to where the "priidash.exe" file is and type "./priidash". If the program is run for the first time, then an "About" window will appear, displaying the license agreement. Please read the license agreement carefully and click the "Accept License" button. At a later time the "About" window can be opened by clicking the "About" button in the "Main Control" window. Click the "Go" button in either the "Main Control" window or the "Gauges" window to start data logging and display. Click the same button (text on the button should have changed to "Stop") to stop data logging and display. Click the "x" (close window) button at the upper right corner of the "Main Control" window to quit the program.

[Back] [Top]

Feature Suggestions and Bug Report

Features to be added

HV battery health check (usbseawolf2000)

Bugs

hvAirT & hvBT not correct

[Back] [Top]

Acknowledgements

Gary Briggs, author of obdgpslogger, who introduced me to FLTK and cygwin.
Michael Pearce, who started the Fl_Gauge program, upon which I have expanded functionality and added many new gauges.
Flyer at scantool.net, who came up with a brilliant method to toggle between passive and active CAN message handling.
Attila Vass, who pioneered in cracking the Prius CAN codes.
Planetaire at priuschat.com, and kinetik (kiki.netik at google.com) who provided many updated Prius CAN codes since Vass' work.
The PriusChat forum community, that inspired my interest in the Prius technology.
Many other forums that provided answers to various questions during the development of the software.
SteveDH at PriusChat, who made the Windows version working.

[Back] [Top]

Developers

Join this project:

To join this project, please contact the project administrators of this project, as shown on the project summary page.

Get the source code:

Source code for this project may be available as downloads or through one of the SCM repositories used by the project, as accessible from the project develop page.

About SourceForge.net:

SourceForge.net is the world's largest provider of hosting for Open Source software development projects. SourceForge.net provides a variety of services to projects, including a download mirror network, collaborative development tools (like CVS and Subversion), and tools to support discussion and support. These services are provided to projects and their end-users free-of-charge.

About Open Source:

Of benefit to users, Open Source software is licensed so you can download and use the software free-of-charge. The source code for this software is made available free-of-charge, you (or a programmer you hire) can make changes to this software to better meet your needs, and you can release your changed code back to the community passing the benefit on to other users.