Skip to content
This repository has been archived by the owner on Feb 9, 2024. It is now read-only.

Advanced: Build Moabian v3 from source with a blank microSD card (step 1)

Scott Stanfield (MSFT) edited this page Sep 5, 2022 · 2 revisions

Turn a blank Raspberry Pi OS Lite image into the Moabian image developer machine (in about 25 minutes).

Make a bootable Raspberry Pi OS microSD card

  1. Download the Raspberry Pi Imager (v1.7.2 as of this time)

  2. For the OS, choose "Raspberry Pi OS (other)" and select Raspberry Pi OS Lite (Legacy). Debian "Buster" 2022-04-04. This is tested with release 2020-08-20 (Linux Kernel 5.10).

image
  1. You'll need an 8GB microSD card or greater. Insert and choose that storage device.

  2. Click the GEAR icon, enable SSH, and set the password for the pi user. Typically raspberry has been used, but you can change it here. Leave the default username pi.

image

It's at this point, you may pre-configure your Wi-Fi:

image

1. SSH into the pi

Install the Raspberry Pi OS Lite chip into your Moab and boot it. Then from your host machine:

ssh [email protected]
password: raspberry

2. Clone Moabian and install

sudo apt update -y && sudo apt upgrade -y
sudo apt install -y git
git clone --depth=1 https://github.com/microsoft/moabian moab
sudo moab/os/setup  # takes 12 minutes: it will fail on step 8 by design
sudo reboot now     # log back in

# after 2nd login:
sudo moab/os/flash  # second pass now has the HAT wired up to the Pi for flashing
sudo reboot now

# after 3rd login:
splash
diagnose
brains

4. (Optional) Install the moab/brain docker image if missing

cd
wget https://github.com/microsoft/moabian/releases/download/v.2.4.0/brain.77b0.tar.gz
docker load < brain.77b0.tar.gz
docker tag 77b0 moab/brain:latest
rm brain.77b0.tar.gz
docker images
sudo moab/bin/flash moab/fw/v3.bin
sudo reboot 0
diagnose

5. Test it

The command line utilities splash, diagnose and brains are useful for quick tests.

image

Calibrate your Moab. Then run Joystick, PID and Brain mode.