Comma EON: Getting Connected with SSH

Chat with Experts of Openpilot on Discord
Feel free to reach out with questions & feedback on the community Discord.
Join the Discussions
UPDATE OCT. 2018: To help out with this process, I’ve been building a new tool I’d like you to all try… it’s called Workbench and it’s specifically for finding EON on your network and connecting to it via SSH.

It sets up EON just like this article but it does it all for you.
It’s being tested on Windows, Mac, and Linux.

Fork and contribute to the project by following the link below.

Recently I’ve noticed loads of requests for a simpler guide to getting connected to EON. The “dashcam” device that is capable of running OpenPilot giving supported vehicles the ability to drive semi-autonomously.

Let’s get started.

Get one-on-one openpilot help & support by considering Becoming a Patreon supporter. Your financial support helps fund the opc.ai website, and gets you continued dedicated one-on-one support from myself and others that become a part of this effort. Visit https://www.patreon.com/openpilotcommunity today to help the efforts! Every little bit helps.

WINDOWS USERS START HERE!

Yes, I added those really lame 90’s internet gifs to get your attention. If you’re on Windows, please follow my guide on installing the tools needed.
I use pretty specific tools in the rest of this article that you may not have installed on your system.

Open Terminal / PowerShell

On Mac: CMD+SPACEBAR and type Terminal and press Return.

On Windows: Press theWINDOWS KEY on your keyboard and type PowerShell and Right click the result and click Run as Administrator or right click the Start Menu icon and go to Power Shell (Admin)

On Ubuntu: CTRL+ALT+T

You will remain in Terminal / PowerShell for the majority of this article series.

Installing the EON SSH Developer Key

Visit the Configuring OpenPilot page on the Comma Wiki.

Select and Copy the entire key from the page and return back here. I’ll wait.

Fetching the Private Key

Now that you’ve copied the key, let’s add it to a file on your computer.

Type in the following command to create the .ssh directory if it isn’t already created.

# Mac / Linux
mkdir -p ~/.ssh/
# Windows
md ~/.ssh/
By the way…
~/ is just a shortcut for your user directory.
On Windows: C:\Users\<username>\ 
On Mac: /Users/<Username> 
On Linux: /home/<Username>

Now we need to put the key we copied from the Wiki into a new file.

We can use the following command to open a new blank file for us to paste our key into:

vim ~/.ssh/openpilot_rsa

Paste (CMD+V / CTRL+V) the entire contents of the PRIVATE KEY just like the animation below.

After pasting it, press ESC on your keyboard, then type :wq! to save.

The file should be saved and closed and you should now see the prompt again.

Special note: 
Mac & Linux: you may have to run the following command so the machine knows the key is safe.
chmod 600 ~/.ssh/openpilot_rsa
Mac/Linux Only: Securing the SSH key with chmod

Connecting EON to WiFi

To continue on, we must ensure your EON is connected to the same wifi network as your computer. We also need to obtain the EON’s IP address so let’s do this.

With your EON in hand, (and hopefully within the comfort of your own home or office… no need to be in the car for this one…) tap the Settings button and scroll down to WiFi Settings.

Scrolling to Wi-Fi Settings

If you aren’t connected to the same Wifi, now is the time to go through the standard WiFi process. You know the drill… RIGHT?

If you find you are connected to the same network, click the ellipsis dots in the top right corner and click Advanced.

Scroll to the bottom of that screen to find the EON’s IP address.

Getting the IP Address in Advanced Menu

Now, back in the shell window on your computer. (PowerShell on Windows, Terminal on Mac / Linux).

Type the following command to test that you are able to connect to your EON:

ping <IP_ADDRESS_OF_EON>

If your ping appears successful, hit CTRL+C after about 4 pings (if on Mac). I believe Windows only pings 4 times by default.

If the pings were successful, proceed to connect to your EON by typing the following command:

ssh root@<IP_ADDRESS_OF_EON> -p 8022 -i ~/.ssh/openpilot_rsa

After entering this command for the first time, you will likely receive a prompt for adding the unknown host to the known hosts file. Simply type yes and press enter to proceed. See an example in the animation below.

First successful connection to EON via SSH

If you have any troubles with any of the steps above, feel free to leave a comment below or hit me up on the Community Discord. My username is @jfrux.

What’s next?

Now that you’re connected to SSH, you can do many different tasks within your EON.