Difference between revisions of "Main Page"

From BITPlan can4eve Wiki
Jump to navigation Jump to search
 
(74 intermediate revisions by the same user not shown)
Line 7: Line 7:
 
* it reads, analyzes, visualizes, stores and replays CAN bus data from the vehicle taken via an OBDII adapter
 
* it reads, analyzes, visualizes, stores and replays CAN bus data from the vehicle taken via an OBDII adapter
 
* is an open source software project see https://github.com/BITPlan/can4eve
 
* is an open source software project see https://github.com/BITPlan/can4eve
 +
 
== Supported Vehicles ==
 
== Supported Vehicles ==
as of 2017-06 only {{Link|target=Triplet}} cars: Mitsubishi i-Miev, Citroe C-Zero, Peugeot-Ion are supported
+
{{#ask:
 +
[[Category:Vehicle]]
 +
[[Has image::+]]
 +
|?Has image=image
 +
|?can4eve support
 +
}}
 +
 
 +
as of 2017-06 only {{Link|target=Triplet}} cars: Mitsubishi i-Miev, Citroën C-Zero, Peugeot-Ion are supported
 +
The support for the {{Link|target=Mitsubishi Outlander PHEV}} is in preparation.
 +
See also {{Link|target=Help/VehicleTypes}}
 +
 
 +
= Contents =
 +
__TOC__
 +
== Supported OBDII-Adapters ==
 +
{{#ask:
 +
[[Category:ELM327]]
 +
[[Has image::+]]
 +
|?Has image=image
 +
|?can4eve support
 +
}}
  
== State of the project ==
+
== Supported Platforms ==
* the software is in alpha - experimental state - it has only been tested with a handful of vehicles so far
 
* as of 2017-06-07 the software is not available for endusers yet. As an interested developer you can
 
follow the {{Link|target=Installation}} instructions.
 
[[File:Screenshot2017-06-18.png|400px]]
 
  
=== Supported Platforms ===
 
 
can4eve is written in Java
 
can4eve is written in Java
 
It has been tested on
 
It has been tested on
* Raspberry PI
+
* {{Link|target=Raspberry PI}}
* MacOS
+
* {{Link|target=MacOS}}
 +
* {{Link|target=Windows}}
 +
 
 
An Android version is in preparation.
 
An Android version is in preparation.
  
 
Since Apple does not support Java on the iPhone and since Microsoft does not support Java on some of its environments can4eve  
 
Since Apple does not support Java on the iPhone and since Microsoft does not support Java on some of its environments can4eve  
would have to be ported to run in these environments. Currently there are no plans to work around this.
+
would have to be ported to run in these environments. Currently there are no concrete plans to work around this. Since can4eve uses JavaFX it is certainly feasible to get an iPhone and other ports. [http://openjdk.java.net/projects/mobile/ Oracle mobile] might also be a future option
=== Test ===
+
to support many more mobile devices.
Before installation of the software you might want to run the {{Link|target=JUnit tests|title=automated tests for can4eve}}.
+
 
 +
== State of the project ==
 +
* the software is in beta state - it has only been tested with a few vehicles so far
 +
* To install you might want to follow the {{Link|target=Installation}} instructions.
 +
* We are looking for more beta testers see e.g. [http://www.goingelectric.de/forum/c-zero-i-miev-ion/alpha-tester-fuer-neue-obdii-can-software-can4eve-gesucht-t24625.html german Triplet] and [http://www.goingelectric.de/forum/mitsubishi-plug-in-hybrid-outlander/ Outlander PHEV] forum
 +
* https://github.com/BITPlan/can4eve/issues/4 is been worked on see {{Link|target=Simple Report}}
 +
==== Screen Shots ====
 +
===== Odometer =====
 +
[[File:screenShot_Odometer_2017-08-16_103323.png|400px]]
 +
 
 +
===== Dashboard / Clocks =====
 +
[[File:screenShot_RPM_2017-08-16_102742.png|600px]]
 +
[[File:screenShot_Clocks_2017-08-16_102206.png|600px]]
 +
 
 +
=== Charging ===
 +
[[File:screenShot_SOC_2017-08-16_103106.png|600px]]
 +
 
 +
=== Battery Cell states / SOC-RR history===
 +
[[File:screenShot_Cell Voltage_2017-07-11_235316.png|600px]]
 +
[[File:screenShot_Cell Temp_2017-07-11_235321.png|600px]]
 +
[[File:socrr2017-06-18.png|600px]]
 +
 
 +
=== General OBD info (debug) ===
 +
[[File:Screenshot2017-06-18.png|600px]]
 +
[[File:data2-2017-06-18.png|600px]]
 +
 
 +
== Installation ==
 +
See {{Link|target=Help#Installation}}
 +
 
 +
=== Building the software yourself ===
 +
can4eve uses maven a build platform
 +
see test video below.
 +
 
 +
=== Developer / Unit Test ===
 +
The software runs a test suite on each release.
 +
If you want you can run the {{Link|target=JUnit tests|title=automated tests for can4eve}} yourself on your own development platform.
 +
The following video shows an example of such a test run and how it should work in your environment in principle. The nice side effect is
 +
that you get a preview of some of the features of the software this way.
 +
<HTML5video width="960" height="600" autoplay="false" loop="false">can4eveTest2017-08-16</HTML5video>
  
=== Installation ===
 
can4eve uses maven and gradle as a build platform
 
as of 2017-06 only the obdii module has a rudimentary user interface
 
To build it you might want to run
 
<source lang='bash'>
 
git clone https://github.com/BITPlan/can4eve
 
cd can4eve/obdii
 
./rebuild
 
</source>
 
 
=== Running from command line ===
 
=== Running from command line ===
 
As of 2017-06 the jar created by the rebuild script is compiled for the {{Link|target=Triplet}} vehicles.
 
As of 2017-06 the jar created by the rebuild script is compiled for the {{Link|target=Triplet}} vehicles.
Line 75: Line 121:
 
                                       used
 
                                       used
 
</source>
 
</source>
 
 
  
 
== License ==
 
== License ==
Line 89: Line 133:
 
! Vehicles !! Icon !! App !! Link
 
! Vehicles !! Icon !! App !! Link
 
|-
 
|-
| Mitsubishi i-Miev, Citroen C-Zero, Peugeot Ion || || CanIon || https://play.google.com/store/apps/details?id=emobility.canion&hl=de
+
| Mitsubishi i-Miev, Citroen C-Zero, Peugeot Ion || || {{Link|target=CanIon}} || https://play.google.com/store/apps/details?id=emobility.canion&hl=de
 
|-
 
|-
 
| Renault
 
| Renault
| [[File:Canze-icon-shading.png|64px]] || CANZE ||  http://canze.fisch.lu/
+
| [[File:Canze-icon-shading.png|64px]] || {{Link|target=CANZE}} ||  http://canze.fisch.lu/
 
|-
 
|-
 
| Outlander PHEV || [[File:SmallEvLogo.png|64px]] || EVBatMon for PHEV || http://evpositive.com/evbatmon-for-phev.html
 
| Outlander PHEV || [[File:SmallEvLogo.png|64px]] || EVBatMon for PHEV || http://evpositive.com/evbatmon-for-phev.html
Line 101: Line 145:
 
|-
 
|-
 
| Combustion engine cars || [[File:TorqueLogo.png|64px]] || Torque Pro || https://play.google.com/store/apps/details?id=org.prowl.torque&hl=de
 
| Combustion engine cars || [[File:TorqueLogo.png|64px]] || Torque Pro || https://play.google.com/store/apps/details?id=org.prowl.torque&hl=de
 +
|-
 +
| Combustion engine cars || [[File:EasyOBDIILogo.png|64px]] || Easy OBDII || http://www.easyobdii.com/
 
|}
 
|}
  
 
== Details ==
 
== Details ==
=== CanIon ===
 
''Diese App speichert und visualisiert die Daten des Can-Busses von Citroen C-Zero/Mitsubishi i-MiEV/Peugeot iOn. Diese Daten werden über den OBD-II Diagnose-Stecker und einem OBD-II Bluetooth/Usb/WiFi-Adapter auf das Android Gerät übertragen.''
 
 
[[File:Canionscreen1.png|480px]]
 
 
=== CANZE ===
 
''If you want to learn about your Renault electric vehicle, you’ve come to a good starting point. We will supply you with an app that displays driving stats and lots of interesting information about your car. All you need is a Bluetooth OBDII dongle and an Android device.''
 
 
<img src='https://i1.wp.com/canze.fisch.lu/wp-content/uploads/2015/10/Screen_Battery.png' width='480'>
 
 
 
=== EVBatMon ===
 
=== EVBatMon ===
 
''Our App not only gives you access to  internal information at your fingertips, it will also track the health of the Li On drive battery over time and against distance. ''
 
''Our App not only gives you access to  internal information at your fingertips, it will also track the health of the Li On drive battery over time and against distance. ''
Line 129: Line 165:
 
= Links =
 
= Links =
 
* https://www.quora.com/What-is-a-good-OBD2-that-is-compatible-with-Electric-Cars
 
* https://www.quora.com/What-is-a-good-OBD2-that-is-compatible-with-Electric-Cars
 +
* http://ion.bitplan.com
 
[[Category:can4eve]]
 
[[Category:can4eve]]

Latest revision as of 05:45, 3 January 2019

Sunflower.png
Profiwikiicon.png

What is can4eve?

can4eve

  • is a software for electric vehicles
  • it reads, analyzes, visualizes, stores and replays CAN bus data from the vehicle taken via an OBDII adapter
  • is an open source software project see https://github.com/BITPlan/can4eve

Supported Vehicles

 imageCan4eve support
Citroen C-ZeroC-zero.jpgsupported
KIA Soul EVKia-new-cars-soul-ev-models-01.jpgnot supported but we are looking for alpha testers
Mitsubishi Outlander PHEVOutlanderphev.jpgin preparation and we are looking for alpha testers
Mitsubishi i-MievI-miev.jpgsupported and looking for alpha and beta testers
Opel AmperaOpel Ampera-e Models First Edition.jpegnot supported yet - we are looking for alpha testers
Peugeot IonIon.jpgsupported

as of 2017-06 only Triplet cars: Mitsubishi i-Miev, Citroën C-Zero, Peugeot-Ion are supported The support for the Mitsubishi Outlander PHEV is in preparation. See also Help/VehicleTypes

Contents

Supported OBDII-Adapters

 imageCan4eve support
ELM327 China USBElm327chinausb.jpgnot recommended/limited/use at own risk!
OBDLink LXOBDLinkLX .jpgindirectly supported e.g. via rfcomm or ip forwarding on linux
OBDLink MXObd-wifi.jpgsupported
OBDLink SXObd-usb.jpgsupported
VGate ICar 2Icar2.pngnot recommended/limited/use at own risk!

Supported Platforms

can4eve is written in Java It has been tested on

An Android version is in preparation.

Since Apple does not support Java on the iPhone and since Microsoft does not support Java on some of its environments can4eve would have to be ported to run in these environments. Currently there are no concrete plans to work around this. Since can4eve uses JavaFX it is certainly feasible to get an iPhone and other ports. Oracle mobile might also be a future option to support many more mobile devices.

State of the project

Screen Shots

Odometer

ScreenShot Odometer 2017-08-16 103323.png

Dashboard / Clocks

ScreenShot RPM 2017-08-16 102742.png ScreenShot Clocks 2017-08-16 102206.png

Charging

ScreenShot SOC 2017-08-16 103106.png

Battery Cell states / SOC-RR history

ScreenShot Cell Voltage 2017-07-11 235316.png ScreenShot Cell Temp 2017-07-11 235321.png Socrr2017-06-18.png

General OBD info (debug)

Screenshot2017-06-18.png Data2-2017-06-18.png

Installation

See Help#Installation

Building the software yourself

can4eve uses maven a build platform see test video below.

Developer / Unit Test

The software runs a test suite on each release. If you want you can run the automated tests for can4eve yourself on your own development platform. The following video shows an example of such a test run and how it should work in your environment in principle. The nice side effect is that you get a preview of some of the features of the software this way.

Running from command line

As of 2017-06 the jar created by the rebuild script is compiled for the Triplet vehicles.

usage

java -jar target/com.bitplan.obdii-0.0.1-jar-with-dependencies.jar -h
Help
CANTriplet: 0.0.1

  usage: java CANTriplet
 --display [None | Console | Swing] : display
                                      the display to use one of:
                                       None,Console,Swing
 --host (--hostname) WERT           : host
                                      the host to connect to
 --limit (--framelimit) N           : limit
                                      the maximum number of frames to read
 --port (--portnumber) N            : port
                                      the port to connect to
 --vg (--vehicle-group) WERT        : vehicleGroup
                                      the vehicleGroup to connect to
 -c (--conn) WERT                   : connection device
                                      the connection to use
 -d (--debug)                       : debug
                                      create additional debug output if this
                                      switch is used
 -h (--help)                        : help
                                      show this usage
 -l (--log) WERT                    : log
                                      the logfile to write
 -p (--pid) WERT                    : pid to monitor
                                      the pid to monitor
 -t (--timeout) N                   : timeout in msecs
                                      the timeout for elm327 communication
 -v (--version)                     : showVersion
                                      show current version if this switch is
                                      used

License

https://www.apache.org/licenses/LICENSE-2.0

Creator

BITPlanLogo2012.svg

Other Apps

Vehicles Icon App Link
Mitsubishi i-Miev, Citroen C-Zero, Peugeot Ion CanIon https://play.google.com/store/apps/details?id=emobility.canion&hl=de
Renault Canze-icon-shading.png CANZE http://canze.fisch.lu/
Outlander PHEV SmallEvLogo.png EVBatMon for PHEV http://evpositive.com/evbatmon-for-phev.html
Nissan Leaf LeafSpyLogo.png Leaf Spy https://play.google.com/store/apps/details?id=com.Turbo3.Leaf_Spy_Lite&hl=de
Tesla TM-SpyLogo.png TM-Spy https://play.google.com/store/apps/details?id=com.Turbo3.TMSpy&hl=de
Combustion engine cars TorqueLogo.png Torque Pro https://play.google.com/store/apps/details?id=org.prowl.torque&hl=de
Combustion engine cars EasyOBDIILogo.png  Easy OBDII http://www.easyobdii.com/

Details

EVBatMon

Our App not only gives you access to internal information at your fingertips, it will also track the health of the Li On drive battery over time and against distance. com.EvPositive.EvBatMon_6.png

LeafSpy

Leaf Spy Lite lets a Nissan Leaf owner view detailed information about their Leaf's battery by plugging in an inexpensive ELM-327 Bluetooth OBDII adapter into the standard OBDII port on the Leaf. ELM-327 Bluetooth adapters are available on eBay for around $10-$20 and one is required before Leaf Spy Lite can display information from your Leaf. Main-qimg-eaec4f6a0b00c9fc98d84f1b376f811a.png

TM-Spy

TM-Spy uses a standard ELM 327 type Bluetooth or WiFi OBDII adapter to decode information from the CAN service plug located below the center display screen. Check the internet for how to access this cable and the specifications for the custom adapter cable required to go from the Tesla 12 pin connector to the standard 16 pin OBDII connector which the ELM 327 adapter plugs into.

TM-3-Screenshot.png

Links