tiamat-tech / carhackingtools

Install and Configure Common Car Hacking Tools.

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
https://archive.org/details/car-hackers-handbook-the-craig-smith	Car Hacking Handbook
https://wiki.linklayer.com/index.php/SocketCAN	I use 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