https://github.com/trishmapow/obd-gui
Raspberry Pi powered dashboard with live OBD stats & graphs and reverse camera support.
https://github.com/trishmapow/obd-gui
Last synced: 3 months ago
JSON representation
Raspberry Pi powered dashboard with live OBD stats & graphs and reverse camera support.
- Host: GitHub
- URL: https://github.com/trishmapow/obd-gui
- Owner: trishmapow
- Created: 2020-01-10T03:38:54.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-08-24T00:23:50.000Z (almost 5 years ago)
- Last Synced: 2025-02-28T11:39:32.936Z (4 months ago)
- Language: Python
- Homepage:
- Size: 667 KB
- Stars: 46
- Watchers: 5
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RPi OBD dashboard (+ reverse camera display)
(yes there are too many decimal places on the engine load, I've fixed this in the code)
## Hardware
- Raspberry Pi with Bluetooth & Wi-Fi (inbuilt or USB dongle, doesn't matter)
- OBD2 Bluetooth module (buy from eBay, Aliexpress, etc. <$10)
- [PiFace Digital](http://www.piface.org.uk/products/piface_digital/) to switch video input & detect button presses. I had this lying around, otherwise you can use any kind of relay board and wire your own buttons to GPIO.
- Reversing camera / dash cam with video output
- Display with composite video input
note: [composite video](https://en.wikipedia.org/wiki/Composite_video) is used so I can easily switch outputs with a relay, quality isn't too bad on a small display.
### Wiring
Relays: NC (normally closed, i.e. connected by default when Pi is off), CO (common), NO (normally open)
```
RPi <<>> PiFace
PiFace relay 0/1 <<>> RPi video out
<<>> Display video in
<<>> Camera video out
<<>> Ground of all cables
```
### Power
I only had one 12V socket available at the front of the car, and the dashcam was already using this, so I took apart the plug, made a small hole and soldered two extra wires to power the 12V display.
The Pi gets power from a USB socket on the CD player meant for flash disks (it apparently provides adequate current, use a USB voltage/current meter to check you're still getting 5+/-0.25V if you're trying such tricks).
## Software setup
- Connect module to car
- On the Pi, in a terminal, run:
- `sudo apt update && sudo apt upgrade`
- `pip3 install obd PySimpleGUI keyboard`
- `git clone https://github.com/trishmapow/obd-gui`
- To connect to the module, run:
- `bluetoothctl` to enter bluetoothctl shell
- `scan on` and `scan off` once you see your module
- `pair [MAC]` where MAC is the address of your OBD module
- `trust [MAC]`
- `paired-devices` check your module is listed
- `quit` to exit bluetoothctl shell
- `sudo sdptool add SP`
- `sudo rfcomm connect hci0 [MAC]` you should see 'press ctrl+c for hangup'
- Now to see if you can interface with the module:
- `cd` into `obd-gui`
- `python3 gui.py`, if you see the numbers and graph updating, great! Otherwise alt-tab to switch to the terminal and see the errors (or exit the app using alt+f4). I had to make some patches to get my module working, you can find them [here](https://github.com/trishmapow/python-OBD/commit/ccd3e5c71032fd30717b83d5f93613ace153dbf4). Check the [troubleshooting guide](https://python-obd.readthedocs.io/en/latest/Troubleshooting/) and [issues in the repo](https://github.com/brendan-w/python-OBD/issues). You may have to dig into the pythonOBD source in `~/.local/lib/python3.7/site-packages/obd`
- PiFace config steps:
- unfortunately the apt and pip packages for the piface don't seem to exist anymore, so we have to install manually. `git clone` both [pifacecommon](https://github.com/piface/pifacecommon) and [pifacedigital-io](https://github.com/piface/pifacedigitalio), `cd` into the directories and run `sudo python3 setup.py install` for both modules
- enable SPI in `sudo raspi-config`, under 'interfacing' (iirc)
- run `sudo python3 piface.py` from the `obd-gui` folder. sudo is required for the `keyboard` module to work and emulate keypresses
- try pressing the first button, the relay should switch. The second and third buttons should emulate the left and right arrow keys respectively
- Autostart the apps with the Pi:
- copy the files in `autostart` to `/etc/xdg/autostart`. Make any necessary edits to the desktop files.
- add your module's MAC address in `connect.sh`
- if the scripts complain about missing modules when running with sudo, uncomment the `sys.path.append` lines at the top of `gui.py` and `piface.py` (edit as necessary depending on your Python version, you can run `pip3 show obd` to see where your package is installed). This is a quick fix solution, there are cleaner ways if you edit sudoers, etc.
## Modifying the GUI
The GUI uses the PySimpleGUI library (just about the fastest & easiest way to get a working GUI running). You can adjust the font, refresh rate etc easily by modifying the constants and/or the `layout` array.
Contributions are welcome, I made the GUI in a rush and focused mainly on functionality.