/CarHackingTools

Install and Configure Common Car Hacking Tools.

Primary LanguageShellMIT LicenseMIT

CarHacking.Tools

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

How To Install

Install Full Desktop

To Install The Full Desktop:

Git clone https://github.com/jgamblin/carhackingtools
cd CarHackingTools
sudo chmod +x *.sh
./workstationinstall.sh

Install Tools Only

To Install Only The Tools:

git clone https://github.com/jgamblin/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.

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.
UDSim https://github.com/zombieCraig/UDSim Basic simulator for testing without a car.
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.

Github Action Badges

Lint Code Base