Dear Community:
The Openpilot Community needs your help to continue to keep opc.ai's lights on and support the path to Workbench v0.2. With only a one person crew and without commercial funding it's not always financially feasible to fund these services out of pocket. Please consider becoming a Patreon supporter of the Openpilot Community project and receive exclusive perks and benefits!
Become a patreon Learn more Maybe Later

DISCLAIMER: This website is maintained by openpilot users and contributors. The content found here (including Workbench and Oppey the Bot) are not approved, supported, affiliated or funded by Comma.ai, Inc. Please DO NOT contact Comma.ai, Inc. staff about these things as they WILL NOT provide support. For support on openpilot, opc.ai, oppey, workbench, etc. please contact a community member on Discord.

jfrux
Sep 03, 2018·4 min read

Comma EON: Getting Connected with SSH

Image

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.

WINDOWS USERS START HERE!

img

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.

Comma EON: Installing Tools for Accessing EON via SSH on Windows
*On most unix-based platforms, including MacOS and Ubuntu you will have the tools you need to connect to your Comma EON…*medium.com

Open Terminal / PowerShell

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

img

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)

img

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.

imgFetching 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.

img

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

imgMac/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.

imgScrolling 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.

imgGetting 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>

img

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.

imgFirst 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 Comma Slack @jfrux

What’s next?

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

Comma EON: Installing a Fork of OpenPilot
*If your vehicle is not 100% supported by Comma, Inc. you may find yourself needing to use a slightly different version of OpenPilot rather…*medium.com