Difference between revisions of "Main Page"

From BITPlan can4eve Wiki
Jump to navigation Jump to search
 
(32 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 ==
 +
{{#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
 
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 ==
 
== Supported OBDII-Adapters ==
#{{Link|target=OBDLink_SX}}
+
{{#ask:
#{{Link|target=OBDLink_LX}} (via rfcomm on Linux!)
+
[[Category:ELM327]]
#{{Link|target=ELM327_China_USB}} (not recommended/limited/use at own risk!)
+
[[Has image::+]]
#{{Link|target=VGate_ICar_2}} (not recommended/limited/use at own risk!)
+
|?Has image=image
 +
|?can4eve support
 +
}}
 +
 
 
== Supported Platforms ==
 
== 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}}
 
* {{Link|target=MacOS}}
 
* {{Link|target=MacOS}}
 
* {{Link|target=Windows}}
 
* {{Link|target=Windows}}
Line 29: Line 45:
  
 
== State of the project ==
 
== State of the project ==
* the software is in alpha - experimental state - it has only been tested with a handful of vehicles so far
+
* the software is in beta state - it has only been tested with a few vehicles so far  
* as of 2017-06-07 the software is not available for endusers yet.
+
* To install you might want to follow the {{Link|target=Installation}} instructions.
* As an interested developer you can 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
* We are looking for alpha 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}}
 
* https://github.com/BITPlan/can4eve/issues/4 is been worked on see {{Link|target=Simple Report}}
 
==== Screen Shots ====
 
==== Screen Shots ====
 
===== Odometer =====
 
===== Odometer =====
[[File:Odometer2017-07-10.png|300px]]
+
[[File:screenShot_Odometer_2017-08-16_103323.png|400px]]
  
 
===== Dashboard / Clocks =====
 
===== Dashboard / Clocks =====
[[File:DashBoard2017-07-06.png|600px]]
+
[[File:screenShot_RPM_2017-08-16_102742.png|600px]]
[[File:clocks2017-07-10.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===
 
=== Battery Cell states / SOC-RR history===
 
[[File:screenShot_Cell Voltage_2017-07-11_235316.png|600px]]
 
[[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]]
 
[[File:socrr2017-06-18.png|600px]]
  
Line 50: Line 69:
 
[[File:data2-2017-06-18.png|600px]]
 
[[File:data2-2017-06-18.png|600px]]
  
 +
== Installation ==
 +
See {{Link|target=Help#Installation}}
  
=== Test ===
+
=== Building the software yourself ===
Before installation of the software you might want to run the {{Link|target=JUnit tests|title=automated tests for can4eve}}.
+
can4eve uses maven a build platform
 +
see test video below.
  
=== Installation ===
+
=== Developer / Unit Test ===
can4eve uses maven and gradle as a build platform
+
The software runs a test suite on each release.
as of 2017-06 only the obdii module has a rudimentary user interface
+
If you want you can run the {{Link|target=JUnit tests|title=automated tests for can4eve}} yourself on your own development platform.
See {{Link|target=Help#Installation}}
+
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>
  
 
=== Running from command line ===
 
=== Running from command line ===
Line 141: 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