Head-Up Display for the Tesla Model 3 using a Raspberry Pi and CAN data captured from the car.
This HUD displays similar information to what is shown on the top left of the Tesla Model 3's display.
- Current date and time, converted from UTC to local time at the beginning of the drive
- Current speed when driving, "P" when parked, "H" when brake hold is active
- Turn signal state (may not blink exactly like the car display though)
- Current "gear" state (i.e. P/R/N/D)
- Current state-of-charge in percentage
To-do wishlist (not sure if these are all possible using CAN data):
- Next navigation step
- Reduce display brightness when the car display switches to night mode
- Current TACC speed if cruise is enabled
- Raspberry Pi 3B+ or Nvidia Jetson Nano: performance is better with Jetson Nano
- Sunlight-readable display, e.g. Newhaven Display NHD-7.0-HDMI-N-RSXN-CTU
- CAN harness for the Tesla Model 3, I am using this one
- Beamsplitter mirror, 87mm x 157mm, thickness 1/8", transparency 30R/70T, rounded corners
- 3D printed mounts to place your monitor and mirror in the right place for driver's line-of-sight in the car
- Car 12V power splitter to power the Pi and the monitor, while leaving a 12V socket open for other devices
- HDMI cable at least 6 feet long
- Car power cable for the monitor
- 5V, 2A car power cable for the Pi with a switch
The Jetson Nano is more expensive, but it can handle 5-10 times higher screen refres rates than the RPi. This can make for a nicer experience with the speed updating real-time when accelerating, or the turn signal indicators blinking in alignment with the car display. Please note that the Jetson Nano does not have onboard Wi-Fi, so you will need to pull it out of the car for troubleshooting or changes. If you want Wi-Fi on the Jetson Nano, you will need a USB adapter like this one.
- Raspbian Stretch Desktop if using a Raspberry Pi
- Linux4Tegra if using a Jetson Nano
- unclutter
- PyGObject
Connect up the Pi or Nano with your LCD monitor and a USB keyboard.
Get the Raspberry Pi 3B+ loaded with Raspbian Desktop, or the Jetson Nano with the initial image of L4T. You can remove packages like LibreOffice and Mathematica as we don't need them.
If you use the Jetson Nano, switch to the GNOME Desktop (instead of the default Unity Desktop that L4T comes with). You can do this by clicking on the settings icon at the login screen. In the Jetson Nano, you also need to auto-hide the Dock and install the GNOME extension "Hide Top Bar".
Install the needed software:
sudo apt install git python3-pip unclutterpip3 install pyserial- Download 'Gotham Book' font and put the TTF file in
.fontsin your home directory
Clone this project and get it running:
git clone https://github.com/ppamidimarri/TeslaModel3HUDchmod +x serial_test.py reader_test.py tm3hud.py gui_test.py
Connect the CAN harness to the USB port and check that /dev/ttyUSB0 is now available. If your CAN device shows up with a different path than /dev/ttyUSB0, you need to update serial_test.py and canreader.py with that path. On the Jetson Nano, you need to add your account to the group dialout if you want to run the HUD application without sudo.
Open a terminal and try to run serial_test.py. You should see a bunch of CAN messages. Then try to run reader_test.py, you should see summary results like speed, state-of-charge, etc.
If both these tests run OK, check the path to hud.glade inside the tm3hud.py and gui_test.py files and update them if needed. You can now test the GUI with tm3hud.py. It should run in full-screen mode. If you want to test just the GUI layout without real data from the CAN harness, you can run gui_test.py. This is useful when your Pi or Nano is not connected to the CAN harness in the car.
If your GUI is starting in full-screen mode, it is time to set the HUD to start up on boot. The steps are different for each device.
Raspberry Pi
We have to edit two configuration files.
sudo nano /etc/xdg/lxsession/LXDE-pi/autostart, remove the @xscreensaver line, and add:
@xset s off
@xset -dpms
@xset s noblank
@/home/pi/TeslaModel3HUD/tm3hud.py
sudo nano /boot/config,txt, and at the end, add:
display_rotate=0x10000
If you are using a Pi, reduce the screen refresh rate by looking in tm3hud.py for the line that contains GObject.timeout_add and increase the number. This is what works best for me in my testing:
GObject.timeout_add(500, self.update_data)
Jetson Nano
Disable the screensaver and screen off options.
Under Activities, search for Startup activities. Add two new startup activities:
xrandr -xto reflect the display- Full path to tm3hud.py, to start the HUD GUI
Now restart your device with sudo reboot and the GUI should start up!
HUD in action
Close-up of driver's view of HUD
Side view of monitor and mirror mounts
Close front view of HUD
This project owes a lot to the following people who helped me: