Skip to content

Latest commit

 

History

History
71 lines (55 loc) · 3.58 KB

README.md

File metadata and controls

71 lines (55 loc) · 3.58 KB
Raw

Hello all,

This is my fork of jgamblin's CarHackingTools, designed to work on both Ubuntu 18.04 and 20.04. It's a WIP as of right now as I am planning to add more things... though we all know how plans can change. The README remains largely unchanged, and I have removed the workstationinstall.sh since terminal is king or something idk.

Tested Operating Systems

  • Ubuntu 18.04 LTS
  • Ubuntu 20.04 LTS

CarHacking.Tools

CarHacking.Tools is a scripts collection of scripts to help jump start car research (and hacking?). All the scripts are designed to run on Ubuntu 18.04 LTS.

To Install The Tools:

Git clone https://github.com/Turb0Yoda/CarHackingTools
cd CarHackingTools
sudo chmod +x *.sh
./toolinstall.sh

OBDII Adapters

You will need an OBDII adapter to get started.

Here are three of my favorites that I own and test with:

Tool Name Link Notes
USB ELM327 http://a.co/7YrtPui Best for getting started and virtual environments.
Veepeak Bluetooth http://a.co/80FLIMV Great for permanent installs and using with your phone.
Cantact https://hackerwarehouse.com/product/cantact-bundle/ An amazing open-source project for advanced users.
$10 Veepeak Bluetooth http://a.co/ajFbcZ4 Great for getting started has some limitations.

*I've opted for the ELM327

Included Tools

The following tools are installed and configured automatically:

Tool Name Link Notes
Can-Utils https://github.com/linux-can/can-utils Basic CAN tool.
Canbus-Utils https://github.com/digitalbond/canbus-utils Basic CAN tool.
Cantact-App https://github.com/linklayer/cantact-app/ Built to work with the Cantact Harware. I have not got it to work yet.
Caringcaribou https://github.com/CaringCaribou/caringcaribou
GNUradio https://www.gnuradio.org/ If you want to look at door locks and TPM modules.
c0f https://github.com/zombieCraig/c0f
ICSim https://github.com/zombieCraig/ICSim Basic simulator for testing without a car.
KatyOBD https://github.com/YangChuan80/KatyOBD A really neat project that provides a GUI. I want to fork this and make it better.
Kayak http://kayak.2codeornot2code.org/
OBD-Monitor https://github.com/dchad/OBD-Monitor A rally neat project that provides a GUI. Needs some documentation work.
PyOBD http://www.obdtester.com/pyobd Super old tool, still works, kinda.
Python-OBD https://github.com/brendan-w/python-OBD Use over PIP install.
SavvyCAN http://www.savvycan.com/ Basic CAN tool.
Scantool https://www.scantool.net/ Super old tool but still works.
Socketcand hhttps://github.com/linux-can/socketcand Basic CAN tool.
UDSim https://github.com/zombieCraig/UDSim Basic simulator for testing without a car.
CANToolz https://github.com/CANToolz/CANToolz/ CANBus analysis tool
Wireshark https://www.wireshark.org/ Great for capturing OBDII data just like you would ethernet data.

Stuff To Read

The following sites have been useful to me:

Link Notes
http://opengarages.org/handbook/ Car Hacking Handbook
http://opengarages.org/ Open Garages
https://wiki.linklayer.com/index.php/SocketCAN I user this when I forget how to enable can0

Warning

I likely don't know what I am doing and this could be done faster, better and simpler some other way. These scripts could also break your car (seriously) and make you cry.