This is the repository for the Neutral Vehicle Project's car hacking workshop. This README contains installation instructions for downloading the tools needed to participate in the workshop, as well as instructions for following along with the demo.
The workshop is split into two pieces:
- Network sniffing with Wireshark
- Vehicle hacking and reverse engineering with
can-utils
The following tools are required for this workshop:
We highly recommend that you use our virtual machine image instead of trying to set up these tools yourself. The main exception is if you already have an Ubuntu-based virtual machine (include the Computer Science Department's VM), in which case installation shouldn't be too difficult.
If you have a virtual machine that is running an Ubuntu-based distribution (including Xubuntu, MATE, etc.), you can use the following commands to install Wireshark, can-utils, and ICSim.
NOTE: if you have the CU Boulder Computer Science Department VM, you can install everything with the instructions below! This is because the CS Dept.'s VM is based on Xubuntu.
sudo apt install git wireshark libsdl2-dev libsdl2-image-dev can-utils
git clone https://github.com/zombieCraig/ICSim.gitOn other operating systems you will likely be able to run Wireshark. However, can-utils and ICSim may not work if you aren't using Linux.
- Wireshark: Wireshark can be installed on multiple operating systems. Visit https://www.wireshark.org/ to find instructions to download Wireshark and run it on your computer.
- can-utils and ICSim: if you have a Unix-based system, these may work on your computer. You will have to clone both of these from their respective repositories:
- can-utils: https://github.com/linux-can/can-utils
- ICSim: https://github.com/zombieCraig/ICSim