This repository contains scripts for adding GMU-ASRC drivers and services to a Raspberry Pi-equipped Hiwonder TurboPi.

Part of the GMU-ASRC TurboPi cinematic universe:

• Provision (You are here)
• Driver
• Core Services

Research-related (not installed by main branch provision scripts):

• TurboPi management and simulations
• Managed Home Directory

This software has only been tested on the following hardware and software setup:

• Raspberry Pi 4 Model B
• Raspberry Pi OS (64-bit) Trixie (Debian 13)
• Hiwonder TurboPi with Mecanum wheels
• Hiwonder RasAdapter V3.6 or earlier (for Pi 4B)
  Note: Earlier versions of the RasAdapter may not have the silkscreened hardware revision label.

1. Use the Raspberry Pi Imager to flash the latest Raspberry Pi OS image to a microSD card.

   Use the following settings:

   • Device: Raspberry Pi 4
   • Operating System: Raspberry Pi OS (64-bit) Debian Trixie (recommended)
   • Customization:
     • Hostname: Enter a unique hostname and remember it.
     • Wi-Fi: If you want to connect to WiFi, enter your WiFi credentials here.
     • Enable SSH: Yes
       • Authentication mechanism: Use password authentication

2. Insert the microSD card into the Raspberry Pi. You'll need to undo the four screws on the metal ultrasonic sensor cover to access the micro SD card on the Raspberry Pi.

3. Insert two 18650 batteries into the bottom of the TurboPi. Make sure to heed the polarity indicator in the battery tray. Once inserted, we recommend using a battery cover.

4. Turn on the TurboPi. There are two switches that both must be in the "on" position:

   • The battery tray under the TurboPi has a switch.
   • The RasAdapter (black board under the metal shield) has a switch. ON is towards the USB ports, OFF is towards the front of the TurboPi.
   • Once on, the ultrasonic sensor should turn blue and remain that way. Unlike HiWonder's included OS image, the drivers and services are not installed yet, so the ultrasonic sensor LEDs will not turn off and there is no beep to indicate that the Pi has booted up.

5. Connect the Pi via ethernet or WiFi (previously configured in step 1).

6. SSH into the pi using the username and hostname you setup in step 1:

   ssh USERNAME@HOSTNAME.local

   Note: Depending on your router, you may need to remove the .local suffix from the hostname. (networks with MDNS/Bonjour support will work with .local, but some routers will support automatic hostname registration without the suffix. You can also try .lan).
   MacOS users will not be able to connect to the Pi via SSH without a suffix.

7. Run the following commands to install the GMU-ASRC drivers and services:

   curl -sSL https://raw.githubusercontent.com/GMU-ASRC/turbopi-provision/main/webinstall.sh | bash -s -- -b main