OS Installation

Materials

  • Raspberry Pi 5

  • USB drive (see BOM)

Prepare USB drive

From your desktop / laptop:

  1. Download and install Raspberry Pi Imager (Do not use Balena Etcher).

    Select Raspberry.Pi.Imager.1.8.5.dmg for Mac or imager-1.8.5.exe for Windows etc.

  2. Download the “full” PiOS image (pupOS_pios_full_[version]) from Google Drive here

  3. Plug in USB drive to your computer

  4. Open Pi Imager and you should see menu like below (skip updates if prompted, latest version 1.9.6 is broken):

  5. Click “Choose Device” and select Raspberry Pi 5 as shown below:

  6. Click “Choose OS”, scroll down and select “Use custom” and then select our custom PiOS image you downloaded earlier:

  7. Click “Choose Storage” and select the USB drive you plugged in as shown below:

  8. Click “Next” and then click “Edit Settings”

  9. Set OS customizations

    1. Set the hostname to pupper & username to pi as shown.

    2. Set your password (our default is rhea123).

    3. Replace “Pebble” with your own WiFi name and enter its password. If you want to use a WiFi network with a login screen (like Stanford networks), deselect “Configure Wireless LAN” and configure the WiFi after completing the rest of this setup guide and booting up the Raspberry Pi 5 with the USB drive.

    4. Change the locale settings as desired.

    5. Go to the “Services” tab and check the “Enable SSH” box. Enable password authentication instead of public key authentication.

    6. Click “Save”.

    ../_images/pi_imager_os_customizations.png

  10. Click “Yes” on OS customizations screen

  11. Click “Yes” again when it asks to confirm to flash

  12. Once done flashing, insert the USB drive into one of the blue USB 3 ports on the Raspberry Pi 5 and you’re done!

First-time setup

  1. Turn on Pupper

  2. Pair PS5 controller
    • Option 1: Use mouse to pair PS5 controller to Raspberry Pi (see BOM for recommended wireless integrated keyboard & trackpad)

      1. Plug mouse into the Raspberry Pi 5

      2. Click the Bluetooth icon on the top-right menu bar of the PiOS desktop and click “Add device”

      3. Put the controller into pairing mode by pressing and holding the \|/ looking button on the top left of the gamepad and the playstation logo button at the same time until you get flashing lights as shown. If the controller turns on not in pairing mode, turn it off by pressing the playstation logo for 10s.

        ../_images/pair_controller.png

      4. Select the gamepad from the list of devices and click “Pair”

      5. After a few seconds the controller should display solid blue lights and a white light above the PS logo as shown below:

    • Option 2: Use PS5 controller connected over USB-C to USB-A cable to pair to Raspberry Pi (more difficult option)

      1. Connect the controller to the Raspberry Pi 5 using a USB-C to USB-A cable

      2. Click the Bluetooth icon on the top-right menu bar of the PiOS desktop and click “Add device”

      3. Unplug controller from the Raspberry Pi 5

      4. Put the controller into pairing mode by pressing and holding the \|/ looking button on the top left of the gamepad and the playstation logo button at the same time until you get flashing lights

      5. Plug the controller back into the Raspberry Pi 5 using the USB-C to USB-A cable

      6. Select the gamepad from the list of devices and click “Pair”

      7. Turn off the controller by holding the playstation logo button for 10 seconds

      8. Unplug the controller from the Raspberry Pi 5

      9. Turn on the controller by pressing the playstation logo button

      10. After a few seconds the controller should display solid blue lights and a white light above the PS logo.

      11. Click “Ok” on the “Connection successful” menu.

    • Option 3: Pair PS5 controller via SSH (only available on newer images)

      1. SSH into the Raspberry Pi 5

      2. Run the script:

        sudo ~/pupperv3-monorepo/robot/utils/pair_ps5_controller.sh

      3. Put the controller into pairing mode by pressing and holding the \|/ looking button on the top left of the gamepad and the playstation logo button at the same time until you get flashing lights

      4. After a few seconds the controller should display solid blue lights and a white light above the PS logo.

We are working to make these steps unnecessary in the future.