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.
- Ubuntu 18.04 LTS
- Ubuntu 20.04 LTS
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
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
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. |
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 |
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.