Skip to Content
getting-startedsetup-guide

Last Updated: 3/9/2026

Setup Guide

This guide will help you set up the BREAD5940 2025 FRC robot code development environment.

Prerequisites

Required Software

  1. WPILib 2025.3.2 - The FRC development suite

  2. Git - Version control system

  3. Java Development Kit 17

    • Included with WPILib installation
    • Required for compilation
  • AdvantageScope - Log file viewer and analysis tool
  • PathPlanner - Autonomous path planning GUI
  • Phoenix Tuner X - CTRE motor controller configuration
  • PhotonVision - Vision processing configuration

Repository Setup

Clone the Repository

git clone https://github.com/BREAD5940/2025-Public.git
cd 2025-Public

Open in VS Code

  1. Launch WPILib VS Code (2025)
  2. File → Open Folder
  3. Select the 2025-Public directory
  4. Wait for Gradle to sync (check bottom-right status bar)

Build the Project

Using VS Code

  1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
  2. Type “WPILib: Build Robot Code”
  3. Press Enter

Alternatively, use the WPILib icon in the top-right corner.

Using Command Line

# Windows
.\gradlew build
 
# macOS/Linux
./gradlew build

Deploy to Robot

Prerequisites

  • Robot powered on and connected via USB or WiFi
  • Team number configured in .wpilib/wpilib_preferences.json

Deployment Steps

  1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
  2. Type “WPILib: Deploy Robot Code”
  3. Press Enter
  4. Wait for deployment to complete

Command Line Deployment

# Windows
.\gradlew deploy
 
# macOS/Linux
./gradlew deploy

Run Robot Simulator

The project includes desktop simulation support for testing without hardware.

Start Simulation

  1. Press Ctrl+Shift+P (or Cmd+Shift+P on Mac)
  2. Type “WPILib: Simulate Robot Code”
  3. Select “Desktop” as the simulation type
  4. The simulation GUI will launch

Simulation Features

  • Driver Station - Control robot modes (Teleop, Auto, Test)
  • Robot GUI - Visualize subsystem states
  • Field Visualization - View robot position and trajectories

Project Dependencies

The project uses several vendor libraries:

Vendor Dependencies

  • CTRE Phoenix 6 - Motor controller and sensor libraries
  • PathPlanner - Autonomous path planning
  • PhotonVision - Vision processing
  • AdvantageKit - Logging framework
  • Jama 1.0.3 - Matrix mathematics library

Managing Vendor Dependencies

Vendor dependencies are stored in the vendordeps/ directory. To update:

  1. Press Ctrl+Shift+P
  2. Type “WPILib: Manage Vendor Libraries”
  3. Select “Check for updates (online)“

Troubleshooting

Build Failures

Issue: Gradle sync fails

  • Solution: Delete .gradle folder and rebuild
  • Run: ./gradlew clean build

Issue: Java version mismatch

  • Solution: Ensure WPILib VS Code is using JDK 17
  • Check: Ctrl+Shift+P → “Java: Configure Java Runtime”

Deployment Issues

Issue: Cannot connect to robot

  • Solution: Verify team number in .wpilib/wpilib_preferences.json
  • Check network connection (USB or WiFi)
  • Ensure robot is powered and radio is configured

Issue: Code deploys but doesn’t run

  • Solution: Check Driver Station for error messages
  • View RoboRIO logs via Driver Station
  • Verify main class: frc.robot.Main

Next Steps

Additional Resources

Overviewproject-structure