Overhaul README.md

[apollokit]

This:

• merges in the stuff from the software steps document in the main repo
• Incorporates my updates from getting Ubuntu 18.04 up and going on the rover

Not ready for merge yet, need #107 to be merged first and to reconcile my changes here with that.

[apollokit]

Note that I made Ubuntu 18.04 the recommended default OS. Are we happy with that?

[Achllle]

Great work! I made a few comments. We'll have to open up a PR in the open-source-rover repo to refer to documentation here instead

[gfosmire]

Wow Kit great work, thanks for putting the time into this. I haven't had a chance to go over everything you've done here, but this looks like a great first step in fixing and making the readme more usable.

[apollokit]

Per my comment above, I need to vet all this again on a clean SD card. Didn't have time to do this weekend.

[apollokit]

Also, need to address the RPi user name in the instructions...does it have to be "ubuntu"?

[apollokit]

@Achllle , @ericjunkins , @gfosmire, I'm done with major work on this, I think. Needs review from you gentlemen. Would be best too if at least one person could go through all the setup steps along the 18.04 path and confirm they work for you. I've done it all myself again, per the instructions here, but always possible that I assumed or skipped something inadvertently.

Note that I've baked in 18.04 as the default now. I haven't taken the time myself to verify remote desktop functionality (as was mentioned before), but my understanding is that it's well-supported on 18.04, given that you're willing to install all the desktop components (I don't really want to on my Ubuntu server image). I have confirmed that X11 forwarding works though, via ssh -X ubuntu@pi-ip-addr

[ericjunkins]

@apollokit I ran through these instructions today up having all the catkin directories etc setup on the pi, and the following are a few notes I have

• Instructions at 3.2: Clone and build the rover code should have you cd .. to leave the src directory so that catkin_make works

• One thing also we might want to link to is instead of an ubuntu server image that then they can install a desktop version on, could also supply the link to the ubuntu mate page, the lack of a desktop can be daunting for a first-time user. https://ubuntu-mate.org/ports/raspberry-pi/

• We should be careful saying download the 64 bit version even for the server ubuntu 18.04, I thought I read that that won't work with older version of the rpi, like a 3b etc.

[Achllle]

With these suggestions I think this will be ready to go in. Tested these on Ubuntu20.04

[apollokit]

@ericjunkins covered all your points for above in commit 3de57a8. I added Ubuntu Mate as the default. But I cannot tell a lie...I have not gone through all the steps with Mate like I did with the server image.

[Achllle]

Hold on - why install Ubuntu Mate if we can just use Ubuntu + GNOME or some other desktop? To get the desktop, all you would need to do is add a few extra lines. See for example here

[apollokit]

Hold on - why install Ubuntu Mate if we can just use Ubuntu + GNOME or some other desktop? To get the desktop, all you would need to do is add a few extra lines. See for example here

Yeah agreed, that's a better approach. I'll put that in the instructions, and remove the Ubuntu Mate stuff.

[apollokit]

Ok, I think this is pretty much polished off. Still testing installing a GNOME GUI on my rpi at the moment, will confirm after that's done. At that point I think this'll be ready to go.

[apollokit]

Confirmed the GNOME GUI works after installing on ubuntu server. Think this is ready to go now.

[apollokit]

Whoops, hadn't resolved some of Achille's stuff. Think it's all done now. At least, from what I can tell.

[Achllle]

great work, thanks again!