Merge pull request #30 from AZ-First/develop

Merge `develop` into `main` for v1.0.0-rc1 release

Author: tbowers7

.github/dependabot.yml

@@ -10,8 +10,10 @@ updates:
   - package-ecosystem: "github-actions"
     # Workflow files stored in the default location of `.github/workflows`. (You don't need to specify `/.github/workflows` for `directory`. You can use `directory: "/"`.)
     directory: "/"
+    labels:
+      - "github_actions"
     schedule:
-      interval: "weekly"
+      interval: "monthly"
 
   # Maintain dependencies for gradle
   - package-ecosystem: "gradle"
@@ -20,4 +22,4 @@ updates:
     labels:
       - "gradle dependencies"
     schedule:
-      interval: "monthly"
+      interval: "weekly"

.github/workflows/main.yml

@@ -6,9 +6,9 @@ name: CI
 # events but only for the main branch.
 on:
   push:
-    branches: [ main ]
+    branches: [ main, develop ]
   pull_request:
-    branches: [ main ]
+    branches: [ main, develop ]
 
 # A workflow run is made up of one or more jobs that can run sequentially or in parallel
 jobs:

.vscode/settings.json

@@ -36,6 +36,36 @@
   "spotlessGradle.format.enable": true,
   "spotlessGradle.diagnostics.enable": false,
   "java.import.gradle.annotationProcessing.enabled": false,
+  "java.completion.favoriteStaticMembers": [
+    "org.junit.Assert.*",
+    "org.junit.Assume.*",
+    "org.junit.jupiter.api.Assertions.*",
+    "org.junit.jupiter.api.Assumptions.*",
+    "org.junit.jupiter.api.DynamicContainer.*",
+    "org.junit.jupiter.api.DynamicTest.*",
+    "org.mockito.Mockito.*",
+    "org.mockito.ArgumentMatchers.*",
+    "org.mockito.Answers.*",
+    "edu.wpi.first.units.Units.*"
+  ],
+  "java.completion.filteredTypes": [
+    "java.awt.*",
+    "com.sun.*",
+    "sun.*",
+    "jdk.*",
+    "org.graalvm.*",
+    "io.micrometer.shaded.*",
+    "java.beans.*",
+    "java.util.Base64.*",
+    "java.util.Timer",
+    "java.sql.*",
+    "javax.swing.*",
+    "javax.management.*",
+    "javax.smartcardio.*",
+    "edu.wpi.first.math.proto.*",
+    "edu.wpi.first.math.**.proto.*",
+    "edu.wpi.first.math.**.struct.*"
+  ],
   "editor.defaultFormatter": "richardwillis.vscode-spotless-gradle",
   "[json]": {
     "editor.defaultFormatter": "richardwillis.vscode-spotless-gradle"

.wpilib/wpilib_preferences.json

@@ -1,6 +1,6 @@
 {
   "enableCppIntellisense": false,
   "currentLanguage": "java",
-  "projectYear": "2025beta",
+  "projectYear": "2025",
   "teamNumber": 0
 }

AdvantageScope Swerve Calibration.json

@@ -122,7 +122,7 @@
                     }
                   }
                 ],
-                "game": "2024 Field",
+                "game": "2025 Field",
                 "origin": "blue"
               },
               "controllerUUID": "psf0y633oclnjyocus23hcnq1d4tpyte",

INSTALL.md

@@ -24,13 +24,26 @@ recommended to **not** select the "Include all branches" checkbox.
 
 --------
 
-### Setting up your new project
+### Software Requirements
+
+The Az-RBSI requires the [2025 WPILib Installer](
+https://github.com/wpilibsuite/allwpilib/releases) (VSCode and associated
+tools), 2025 firmware installed on all hardware (motors, encoders, power
+distribution, etc.), the [2025 NI FRC Game Tools](
+https://www.ni.com/en/support/downloads/drivers/download.frc-game-tools.html)
+(Driver Station and associated tools), and the [2025 CTRE Phoenix Tuner X](
+https://v6.docs.ctr-electronics.com/en/stable/docs/tuner/index.html).  Take a
+moment to update all software and firmware before attempting to load your new
+robot project.
+
+Please note that you need these _minimum_ versions of the following components:
+
+* WPILib `2025.1.1`
+* RoboRIO image `FRC_roboRIO_2025_v2.0`
 
-**The Az-RBSI requires the 2025 WPILib Installer (VSCode and associated tools),
-2025 firmware installed on all hardware (motors, encoders, power distribution,
-etc.), the 2025 NI FRC Game Tools (Driver Station and associated tools), and
-the 2025 CTRE Phoenix Tuner X.  Take a moment to update all software and
-firmware before attempting to load your new robot project.**
+--------
+
+### Setting up your new project
 
 When your new robot code respository is created, it will have a single commit
 that contains the entire Az-RBSI template for the current release.  (See the
@@ -42,9 +55,19 @@ steps you need to complete:
 
 1. Add your team number to the `.wpilib/wpilib_preferences.json` file.  The
    generic Az-RBSI template contains a team number "0", and your code will not
-   deploy properly if this variable is not set (*e.g.*, VSCode looks for the
-   RoboRIO on IP address `10.TE.AM.2`, and it will not find anything if it
-   tries to contact `10.0.0.2`.)
+   deploy properly if this variable is not set (*i.e.*, since VSCode looks for
+   the RoboRIO on IP address `10.TE.AM.2`, it will not find anything if it
+   tries to contact `10.0.0.2`.)  If you forget to change this value, you will
+   get an error message when deploying code to your robot like:
+
+   ```
+   Missing Target!
+   =============================================
+   Are you connected to the robot, and is it on?
+   =============================================
+   GradleRIO detected this build failed due to not being able to find "roborio"!
+   Scroll up in this error log for more information.
+   ```
 
 2. If you have an all-CTRE swerve base (*i.e.*, 8x TalonFX-controlled motors,
    4x CANCoders, and 1x Pigeon2), use Phoenix Tuner X to create a swerve
@@ -76,14 +99,24 @@ method are encouraged to submit bug reports and code fixes to the [Az-RBSI
 repository](https://github.com/AZ-First/Az-RBSI).
 
 6. The Az-RBSI expects an Xbox-style controller -- if you have a PS4 or other,
-   change this at the top of the `RobotContainer.java` file in the
-   `src/main/java/frc/robot` directory.
-
-7. Power ports...
+   substitute the proper command-based controller class for
+   `CommandXboxController` near the top of the `RobotContainer.java` file in
+   the `src/main/java/frc/robot` directory.
+
+7. Power monitoring by subsystem is included in the Az-RBSI.  In order to
+   properly match subsystems to ports on your Power Distribution Module,
+   carefully edit the `CANandPowerPorts` of `Constants.java` to include the
+   proper power ports for each motor in your drivetrain, and include any
+   motors from additional subsystems you add to your robot.  To include
+   additional subsystems in the monitoring, add them to the [`m_power`
+   instantiation](
+   https://github.com/AZ-First/Az-RBSI/blob/38f6391cb70c4caa90502710f591682815064677/src/main/java/frc/robot/RobotContainer.java#L154-L157) in the `RobotContainer.java` file.
 
 8. All of the constants for needed for tuning your robot should be in the
    `Constants.java` file in the `src/main/java/frc/robot` directory.  This file
-   should be thoroughly edited to match the particulars of your robot.
+   should be thoroughly edited to match the particulars of your robot.  Be sure
+   to work through each section of this file and include the proper values for
+   your robot.
 
 
 --------

README.md

@@ -53,3 +53,8 @@ effective logging for troubleshooting.
 * [PhotonVision](https://docs.photonvision.org/en/latest/) / [Limelight](
   https://docs.limelightvision.io/docs/docs-limelight/getting-started/summary)
   -- Robot vision / tracking
+
+## Further Reading
+
+For tips on command-based programming, see this post:
+https://bovlb.github.io/frc-tips/commands/best-practices.html

WPILib-License.md

@@ -1,4 +1,4 @@
-Copyright (c) 2009-2024 FIRST and other WPILib contributors
+Copyright (c) 2009-2025 FIRST and other WPILib contributors
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

build.gradle

@@ -1,6 +1,6 @@
 plugins {
     id "java"
-    id "edu.wpi.first.GradleRIO" version "2025.1.1-beta-2"
+    id "edu.wpi.first.GradleRIO" version "2025.2.1"
     id "com.peterabeles.gversion" version "1.10.3"
     id "com.diffplug.spotless" version "6.25.0"
     id "io.freefair.lombok" version "8.11"

settings.gradle

@@ -4,7 +4,7 @@ pluginManagement {
     repositories {
         mavenLocal()
         gradlePluginPortal()
-        String frcYear = '2024'
+        String frcYear = '2025'
         File frcHome
         if (OperatingSystem.current().isWindows()) {
             String publicFolder = System.getenv('PUBLIC')