diff --git a/README.md b/README.md index 8af77cc..492b339 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,83 @@ open source `openpilot` AI for "self-driving" cars. See `docs/` directory for more info. +# Setup +The default OpenPilot setup requires having accounts with proprietary +services. This can be worked around. + +## Setup SSH Without Proprietary Service on Comma Three +Here is HOWTO connect to a Comma Three device without using proprietary +services. + + + +The official CommaAI SSH wiki docs are here, but they note they are not for the +current version of OpenPilot: + +* https://github.com/commaai/openpilot/wiki/SSH + +The CommaAI proxy that OpenPilot uses is, sadly, github. +This is to be avoided. +Another set of docs here: + +* https://ssh.comma.ai/ + +The above docs are reference, but not how it will be performed below. +The hostname used will be `tici` as that is what the device is named upstream. + + +This is most easily done with a laptop or similar on the same wifi network +as the Comma Three. + + +This needs to be done on a new device, or a device that has been reset +to factory shipping. When the device boots up, go through all the initial +steps to get it connected to the Internet via wifi. Stop at the step +that reads `Choose Software to Install`. + + +At this point, the Comma Three is on the wifi network, and SSH is running +with a shared root ssh key by default. Get the device's IP address from +DHCP logs on the DHCP server (e.g. router/firewall). + + +On the laptop, set up `~/.ssh/config` thusly, using the device's IP from DHCP +in place of example `192.168.1.100` below: + +``` +Host tici + User comma + Hostname 192.168.1.100 + Identityfile ~/.ssh/key.pem + Port 8022 +``` + +You need to get that SHARED ROOT SSH KEY from github to log into the account: + +``` +wget -O ~/.ssh/key.pem https://raw.githubusercontent.com/commaai/openpilot/master/tools/ssh/id_rsa +``` + +Then make sure your SSH permissions are happy (and your homedir...): + +``` +chmod 700 ~/.ssh +chmod 600 ~/.ssh/key.pem ~/.ssh/config +``` + +Once that is set up, you should be able to SSH into the device thusly: + +``` +ssh tici +``` + + + +Another way to do this would be to hijack DNS on your own wifi to intercept +the Comma Three's connection to github, then redirect the connection to +your own server. It depends if it barfs on the SSL or not. + + # Unofficial This repository, documentation and code is unofficial, unaffiliated with Comma AI.