Getting Started

This guide will show you how to start contributing to our codebase. Please note that you may experience issues not mentioned in here and we recommend reaching out to our your local nerd.

Getting the Code

This project uses the Pedro Pathing QuickStart as a base. Follow these steps to clone, build, and deploy your code to your Control Hub or Android Phone.

Prerequisites

Requirement	Details
Android Studio	Ladybug (2024.2.1) or newer recommended
JDK	17+ (should be bundled in with android studio)
ADB Platform Tool	Required for wireless deployment
USB-A to USB-C Cable	Required for First Connect

Cloning the Repository

1. Open Android Studio and click Clone Repository in the upper right corner.

2. In the URL field, paste the team repository link:

    https://gitlab.com/shhs-2026-robotics/ChicagoStateInvitationals.git

3. Click the clone button in the bottom right corner.

First Time Build

USB Connection Required

On your first ever build you will need to do it using a USB cable to allow the appropriate packages to be downloaded for future offline building over Wi-Fi using ADB

Build & Deploy

1. Connect to the Robot You can connect to the Control Hub in one of two ways:

   • Option A (USB): Plug a USB-A to USB-C cable directly from your laptop into the Control Hub
   • Option B (Wireless via ADB): Connect your laptop to the robot’s Wi-Fi network, open your terminal, and navigate to your platform-tools directory. \n

   To connect via ADB on Windows, navigate to your platform tools directory:

   C:/Users/%your-user%/AppData/Local/Android/Sdk/platform-tools

   Once your terminal is open in your platform tools directory run the connection command

   ./adb connect 192.168.43.1:5555

2. Deploy the Code

   Once your successfully connected to the Robot you should notice that next to your run module the device will say something along the lines of REV Control Hub

   This means that you are ready to push your code, just press the run button and wait till it launches on your control hub and you successfully updated the code on your control hub.