Skip to content
This repository has been archived by the owner on Aug 4, 2023. It is now read-only.

Commit

Permalink
Some Sunday Updates
Browse files Browse the repository at this point in the history 
Sume Sunday Updates (Readme / Shell Check / Linter Run)
  • Loading branch information
@jgamblin
jgamblin committed Aug 5, 2018
1 parent c6ff91c commit 68182c6
Show file tree
Hide file tree
Showing 3 changed files with 49 additions and 35 deletions.
65 changes: 38 additions & 27 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@

# WARNING! THIS IS STILL IN TESTING! PLEASE DONT USE!

*_I am still testing and writing this code. It likely doesn't work fully and isn't fully documented._*
`*_I am still testing and writing this code. It likely doesn't work fully and isn't fully documented._*`

# CarHacking.Tools
[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](ubuntu.com).
Expand Down Expand Up @@ -42,40 +42,51 @@ sudo chmod +x *.sh
```


# OBDII Adapter
# 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.
| 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. |
| Socketcand | https://github.com/dschanoeh/socketcand | Basic CAN tool. |
| 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. |
| 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 | <https://github.com/dschanoeh/socketcand> | Basic CAN tool. |
| 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.
15 changes: 9 additions & 6 deletions toolinstall.sh
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ sudo chmod -R 0777 /tools
cd /tools || exit

# Add user to dialout so USB-to-Serial Works-ish.
sudo usermod -a -G dialout $USER
sudo usermod -a -G dialout "$USER"

# Update System
sudo DEBIAN_FRONTEND=noninteractive apt-get update -y -qq
Expand All @@ -25,6 +25,8 @@ sudo DEBIAN_FRONTEND=noninteractive apt-get update -y -qq
sudo DEBIAN_FRONTEND=noninteractive apt-get install -qq \
aircrack-ng \
ant \
arduino \
arduino-core \
autoconf \
automake \
bison \
Expand Down Expand Up @@ -94,7 +96,7 @@ sudo apt install --reinstall python-pip
# Starting Car Hacking Tool Installation

printf "Instaling Tools"
printf "\n"
printf "\\n"

# Bluelog
# Read The Docs: https://github.com/MS3FGX/Bluelog
Expand Down Expand Up @@ -176,6 +178,7 @@ cd python-OBD || exit
sudo python setup.py install
cd .. || exit


# PyOBD:
# Fix This!
# Backup: git clone https://github.com/Pbartek/pyobd-pi.git
Expand Down Expand Up @@ -297,7 +300,7 @@ cd .. || exit
# Make Desktop Icons

printf "Configuring Desktop Icons"
printf "\n"
printf "\\n"

mkdir -p -p icons
cd icons || exit
Expand Down Expand Up @@ -384,10 +387,10 @@ EOF

sudo rm ~/Desktop/SavvyCAN.desktop
sleep 15
sudo chmod 755 *.desktop
cp *.desktop ~/.local/share/applications
sudo chmod 755 ./*.desktop
cp ./*.desktop ~/.local/share/applications
cd .. || exit

cd ~/.local/share/applications || exit
sudo chmod 755 *.desktop
sudo chmod 755 ./*.desktop
cd .. || exit
4 changes: 2 additions & 2 deletions workstationinstall.sh
View file
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ gsettings set org.gnome.desktop.screensaver secondary-color '#000000'
gsettings set org.gnome.desktop.screensaver ubuntu-lock-on-suspend false
gsettings set org.gnome.login-screen disable-user-list true
gsettings set org.gnome.nautilus.desktop trash-icon-visible false
gsettings set org.gnome.shell favorite-apps "['firefox.desktop', 'org.gnome.Terminal.desktop', 'Cantact.desktop', 'ICSim.desktop', 'ICSimControls.desktop', 'SavvyCAN.desktop', 'wireshark.desktop', 'moserial.desktop']"
gsettings set org.gnome.shell favorite-apps "['firefox.desktop', 'org.gnome.Terminal.desktop', 'Cantact.desktop', 'ICSim.desktop', 'ICSimControls.desktop', 'SavvyCAN.desktop', 'wireshark.desktop', 'arduino.desktop', 'moserial.desktop']"
gsettings set org.gnome.shell.extensions.dash-to-dock dash-max-icon-size 32
gsettings set org.gnome.shell.extensions.dash-to-dock dock-position BOTTOM
gsettings set org.gnome.shell.extensions.dash-to-dock extend-height false
Expand All @@ -44,5 +44,5 @@ gsettings set org.gtk.Settings.FileChooser sort-directories-first true
sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target

#Running The Tool Install script
cd $installdir
cd "$installdir"
./toolinstall.sh

0 comments on commit 68182c6

Please sign in to comment.