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

jfrux
Jan 09·4 min read

Installing a Fork of Openpilot with Workbench

Image

Go to the profile of jfrux

So as many of you know, I once wrote an article about Installing a Fork of Openpilot which involved setting up your EON and Computer to connect to it via SSH and jump through hoops anytime you wanted to do any little old thing.

Well that is NO MORE with the release of Workbench.
It doesn’t matter if you’ve setup SSH before, Workbench takes care of it. Even if you’re on a random computer on some random network.

As long as EON is on your network, you can connect to it with Workbench.

IMPORTANT: Your EON needs to have had Openpilot already installed via the Comma install process found here prior to doing this guide.
https://medium.com/@jfrux/comma-eon-initial-setup-with-openpilot-2b5ea58354a

Grab the latest version of Workbench from https://opc.ai/workbench

If you experience issues with Workbench, please submit them to https://github.com/openpilot-community/workbench/issues or hit me up in #workbench on Comma Slack.

This is required for Workbench to connect successfully and run its commands for you.

If you’re connected to the same network as your EON and your network doesn’t have any real restrictions put in place about device communication, it should detect it really quickly.

Workbench v0.1.1

If for some reason it doesn’t find it, try closing Workbench and re-opening it. Some have found it fails to find it if you’ve scanned and it failed before. I’ve had mixed experiences as well. If all else fails, close and try again. I’ve found it to be fairly reliable.

EON will show a green checkmark when it has been successfully reached.

Since the release of Workbench, nobody has to worry about SSH keys, terminals, anymore due to its convenient instant setup of the SSH key, finding EON, and entering commands for you automatically.

Enter Yes if prompted, otherwise you’re good.

If this is a new IP, your computer will still prompt you to add it to Known Hosts by typing in yes in the console.

If all is successful yours should look like the above animation.

Now for the hardest part of the entire guide, don’t worry it’ll be over soon.

Locate the Git URL for the Openpilot fork you would like to use.
For me, this is going to be the great kegman fork which enables better follow distance adjustments for my 2017 Honda Pilot.

So I visit https://github.com/kegman/openpilot and click the clone button to copy the full Git url.

Then, I go back over to Workbench and proceed with the next step.

This is where it gets even more fun. Now you don’t have to remember those pesky git commands.

Under Console on the left click on Install Openpilot

A drawer should slide out from the right.

Paste the full Git URL copied from the Clone button on the Github site like above, (it must have the .git) on the end of it. You cannot use just any URL, it must be the one from the animation image above.

Now go back to the Github page, determine the branch you need to install from the Branch list.

You’ll need to type it exactly as it is in this list, or find a place on the Github page to copy it from…

Enter it into the Branch field back inside of the Workbench drawer and then press the blueRun button.

If you did it successfully, you should see that it’s cloning the repo as normal.

After it looks to be completed with the cloning process, simply click on Reboot under Console on the left and press Run.

Your EON should reboot.

error: pathspec ‘<branchname>’ did not match any file(s) known to git.

If you receive the above message, check the name of the branch you used and ensure its typed correctly. It is case-sensitive.

Feel free to reach out with questions & feedback on the community Discord at with Workbench in the #workbench channel.