teslausb

Intro

You can configure a Raspberry Pi Zero W so that your Tesla thinks it's a USB drive and will write dashcam footage to it. Since it's a computer, you can run scripts on the Pi to automatically copy the clips to an archive server when you get home. The Pi is going to continually:

Wait until it can connect to the archive server
Archive the clips
Wait until it can't connect to the archive server
GOTO 1.

The scripts in this repo will also allow you to use the Pi to store music that the Tesla can read through the USB interface.

Archiving the clips can take from seconds to hours depending on how many clips you've saved and how strong the WiFi signal is in your Tesla. If you find that the clips aren't getting completely transferred before the car powers down after you park or before you leave you can use the Tesla app to turn on the Climate control. This will send power to the Raspberry Pi, allowing it to complete the archival operation.

Prerequisites

Assumptions

You park in range of your wireless network.
Your wireless network is configured with WPA2 PSK access.
You'll be archiving your dashcam clips to a Windows machine, and the Windows machine has a stable IP address on your home network.
You'll be setting up the Raspberry Pi using a Windows machine.

Hardware

Required:

Raspberry Pi Zero W: Adafruit or Amazon

Note: Of the many varieties of Raspberry Pi only the Raspberry Pi Zero and Raspberry Pi Zero W can be used as simulated USB drives. It may be possible to use a Pi Zero with a USB Wifi adapter to achieve the same result as the Pi Zero W, but this hasn't been confirmed.
A Micro SD card, at least 8 GB in size, and an adapter (if necessary) to connect the card to your computer.
A mechanism to connect the Pi to the Tesla. Either:
- A USB A/Micro B cable: Adafruit or Amazon, or
- A USB A Add-on Board if you want to plug your Pi into your Tesla like a USB drive instead of using a cable. Amazon

Optional:

A case. Don't want unprotected circuits hanging about! Official case at Adafruit or Amazon. There are many others to choose from. Note that the official case won't work with the USB A Add on board.
USB Splitter if you don't want to lose a front USB port. The Onvian Splitter has been reported working by multiple people on reddit.

Software

Download Raspbian Stretch Lite

Note: Bittorrent is dramatically faster than direct download.

Download and install:

Etcher

Create your archive

Hosting on Windows

Set up a share on a Windows (or macOS using Sharing, or Linux using Samba) machine to host the archive. These instructions assume that you created a share named "SailfishCam" on the server "Nautilus". It is recommended that you create a new user. Grant the user you'll be using read/write access to the share. These instructions will assume that the user you've created is named "sailfish" and that the password for this user is "pa$$w0rd".

Get the IP address of the archive machine. You'll need this later, so write it down, somewhere. You can do this by opening a command prompt on the archive machine and typing ipconfig. Get the IP address from the line labeled "IPv4 Address". These instructions will assume that the IP address of the archive server is 192.168.0.41.

TODO Other hosting solutions

Set up the Raspberry Pi

There are three phases to setting up the Pi:

Get the OS onto the micro sd card.
Get a shell on the Pi.
Set up the USB storage functionality.

Get the OS onto the micro SD card

These instructions tell you how to get Raspbian onto your MicroSD card. Basically:

Connect your SD card to your computer.
Use Etcher to write the zip file you downloaded to the SD card. Etcher works well and is multi-platform.

Note: you don't need to uncompress the zip file you downloaded.

Get a shell on the Pi

If you used a Windows computer to flash the OS onto the MicroSD card, follow these Instructions.

If you used a Mac or a Linux computer, follow these Instructions.

Set up the USB storage functionality

Now that you have Wifi up and running, it's time to set up the USB storage and scripts that will manage the dashcam and (optionally) music storage.

SSH to the Pi and run
```
sudo -i
```
Try to ping your archive server from the Pi. In this example the server is named nautilus.
```
ping -c 3 nautilus
```
If the server can't be reached, ping its IP address:
```
ping 192.168.0.41
```
If you can't ping the archive server by IP address from the Pi, you should go do whatever you need to on your network to fix that. If you can't reach the archive server by name, from the Pi but you can by IP address, then use its IP address, below, in place of its name.
Run these commands, subsituting your values. The last line is the percent of the drive you want to allocate for dashcam storage. The remaining percentage will be allocated for music.
```
export archiveserver=Nautilus
export sharename=SailfishCam
export shareuser=sailfish
export sharepassword=pa$$w0rd
export campercent=100
```
If you'd like to receive a text message when your Pi finishes archiving clips follow these Instructions.

Run these commands:

wget https://raw.githubusercontent.com/cimryan/teslausb/master/windows_archive/setup-teslausb
chmod +x setup-teslausb
./setup-teslausb

Run this command:
```
halt
```
Disconnect the Pi from the computer.

On the next boot, the Pi hostname will become teslausb, so future ssh sessions will be ssh pi@teslausb.local.

Your Pi is now ready to be plugged into your Tesla. If you want to add music to the Pi, follow the instructions in the next section.

(Optional) Add music to the Pi

Connect the Pi to a computer. If you're using a cable be sure to use the port labeled "USB" on the circuitboard.

Wait for the Pi to show up on the computer as a USB drive.
Copy any music you'd like to the drive labeled MUSIC.
Eject the drives.
Unplug the Pi from the PC.
Plug the Pi into your Tesla.

Making changes to the system after setup

The setup process configures the Pi with read-only file systems for the operating system but with read-write access through the USB interface. This means that you'll be able to record dashcam video and add and remove music files but you won't be able to make changes to files on / or on /boot. This is to protect against corruption of the operating system when the Tesla cuts power to the Pi.

To make changes to the system partitions:

ssh pi@teslausb.
sudo -i
/root/bin/remountfs_rw

Then make whatever changes you need to. The next time the system boots the partitions will once again be read-only.

ken830 / teslausb