From 4e112f61b7bc9f28bd12d773964a12ced935ece4 Mon Sep 17 00:00:00 2001 From: Lewis Ruskin Date: Mon, 19 Jan 2026 18:11:18 -0700 Subject: [PATCH 1/4] added additional doc prep steps --- README.md | 8 +++----- doc/INSTALL.md | 23 +++++++++++++++++++---- 2 files changed, 22 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 56e8138..b2ad2d3 100644 --- a/README.md +++ b/README.md @@ -44,13 +44,11 @@ effective logging for troubleshooting. * [WPILib](https://docs.wpilib.org/en/stable/index.html) -- FIRST basic libraries * [AdvantageKit]( - https://docs.advantagekit.org/getting-start ed/what-is-advantagekit/) + https://docs.advantagekit.org/getting-started/what-is-advantagekit/) -- Logging * [CTRE Phoenix6]( - https://v6.docs.ctr-electronics.com/en/stable/docs/api-reference/mechanisms/swerve/swerve-overview.html) - / [YAGSL](https://docs.yagsl.com/) -- Swerve drive library -* [PathPlanner](https://pathplanner.dev/home.html) / [Choreo]( - https://sleipnirgroup.github.io/Choreo/) -- Autonomous path planning + https://v6.docs.ctr-electronics.com/en/stable/docs/api-reference/mechanisms/swerve/swerve-overview.html) -- Swerve drive library +* [PathPlanner](https://pathplanner.dev/home.html) -- Autonomous path planning * [PhotonVision](https://docs.photonvision.org/en/latest/) / [Limelight]( https://docs.limelightvision.io/docs/docs-limelight/getting-started/summary) -- Robot vision / tracking diff --git a/doc/INSTALL.md b/doc/INSTALL.md index a1a4518..917627b 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -1,5 +1,21 @@ # Az-RBSI Installation Instructions +### Pre install +Before you even think about Az-RBSI, you need these _minimum_ versions of the following components on your laptop and devices. + +* WPILib ` v2026.2.1` +* RoboRIO image `FRC_roboRIO_2026_v1.2` (comes from game tools from national instruments) +* Driver Station `Version 26.0` (comes from game tools from national instruments) +* CTRE Tunner X `26.2.4.0`, with all devices running `26.0` or newer. This includes the motors, canivore, pidgeon 2.0, and the cancoders! +* Rev Hardware Client `2.0`, with the pdh and all spark max's, and other devices on `26.1` or newer. +* Vivid hosting Radio `2.0` or newer is required for competition this year. +* Photon Vision (orange pi or other device) running `26.1` or newer (Make sure you are not acidentially running 25.3). We HIGHLY recomend downloading the image and re imaging the sd to your co-processor instead of trying to upgrade it. + +It is highly recommmended to update all you devices, and label what can id's or ip adresses and firmware versions they are running. This helps your team, and the FRC field staff quickly identify issues. + +-------- + +### Getting Az-RBSI The Az-RBSI is available as a [Template Repository]( https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template#creating-a-repository-from-a-template) for teams to use for creating their own 2026 FRC robot code. These instructions @@ -29,11 +45,13 @@ If you want to keep caught up on dependencies, you will need to ENABLE the Dependency Graph selection under the "Advanced Security" tab of the repository Settings. +* If you are struggling with this step, you may need the mentor or teacher that owns your github org to to it. + Enable Dependency Graph -------- -### Software Requirements +### Software Requirements (Update Everything to 2026!) The Az-RBSI requires the [2026 WPILib Installer]( https://github.com/wpilibsuite/allwpilib/releases) (VSCode and associated @@ -45,10 +63,7 @@ https://v6.docs.ctr-electronics.com/en/stable/docs/tuner/index.html). Take a moment to update all software and firmware to the latest versions before attempting to load your new robot project. -Please note that you need these _minimum_ versions of the following components: -* WPILib ` v2026.2.1` -* RoboRIO image `FRC_roboRIO_2026_v1.2` -------- From 417ba31697447d56fca1cac8b9039f39780b8b9a Mon Sep 17 00:00:00 2001 From: "Timothy P. Ellsworth Bowers" Date: Tue, 20 Jan 2026 09:03:56 -0700 Subject: [PATCH 2/4] Formatting & Links / 3D Print Info --- doc/INSTALL.md | 23 ++++++++++++++++------- doc/RBSI-GSG.md | 37 +++++++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+), 7 deletions(-) diff --git a/doc/INSTALL.md b/doc/INSTALL.md index 917627b..c3c2372 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -1,15 +1,24 @@ # Az-RBSI Installation Instructions ### Pre install -Before you even think about Az-RBSI, you need these _minimum_ versions of the following components on your laptop and devices. +Before you even think about Az-RBSI, you need these _minimum_ versions of the +following components on your laptop and devices. * WPILib ` v2026.2.1` -* RoboRIO image `FRC_roboRIO_2026_v1.2` (comes from game tools from national instruments) -* Driver Station `Version 26.0` (comes from game tools from national instruments) -* CTRE Tunner X `26.2.4.0`, with all devices running `26.0` or newer. This includes the motors, canivore, pidgeon 2.0, and the cancoders! -* Rev Hardware Client `2.0`, with the pdh and all spark max's, and other devices on `26.1` or newer. -* Vivid hosting Radio `2.0` or newer is required for competition this year. -* Photon Vision (orange pi or other device) running `26.1` or newer (Make sure you are not acidentially running 25.3). We HIGHLY recomend downloading the image and re imaging the sd to your co-processor instead of trying to upgrade it. +* RoboRIO image `FRC_roboRIO_2026_v1.2` (comes with the FRC Game Tools from + National Instruments) +* Driver Station `Version 26.0` (comes with the FRC Game Tools from National + Instruments) +* CTRE Tunner X `26.2.4.0`, with all devices running firmware `26.0` or newer. + This includes all motors, CANivore, Pigeon 2.0, and all CANcoders! +* Rev Hardware Client `2.0`, with the PDH and all SparkMax's, and other devices + running firmware `26.1` or newer. +* Vivid Hosting Radio firmware `2.0` or newer is required for competition this + year. +* Photon Vision ([Orange Pi or other device](https://docs.photonvision.org/en/latest/docs/quick-start/quick-install.html)) + **running `26.1` or newer** (make sure you are **not** acidentially running + `25.3`). We HIGHLY recomend downloading the image and re-imaging the SD Card + in your co-processor instead of trying to upgrade it. It is highly recommmended to update all you devices, and label what can id's or ip adresses and firmware versions they are running. This helps your team, and the FRC field staff quickly identify issues. diff --git a/doc/RBSI-GSG.md b/doc/RBSI-GSG.md index 11d93d4..21cec8e 100644 --- a/doc/RBSI-GSG.md +++ b/doc/RBSI-GSG.md @@ -91,3 +91,40 @@ Additionally, both [PhotonVision](https://docs.photonvision.org/en/latest/) and [Limelight]( https://docs.limelightvision.io/docs/docs-limelight/getting-started/summary) computer vision systems are supported in the present release. + +-------- + +### Included 3D Prints + +To help teams with standardized enclosures for their PhotonVision Orange Pi's +and CTRE CANivores, we include three 3D print files as part of the "Assets" +section of [each release](https://github.com/AZ-First/Az-RBSI/releases). + +* The [CANivore cable holder](https://github.com/AZ-First/Az-RBSI/releases/download/v26.0.0-rc2/Canivore.Cable.holder.STL) + is designed to hold a [right-angle USB-C cable](https://www.amazon.com/dp/B092ZS6SJG) + onto the CANivore in a way that won't get knocked loose if your robot hits + something. The entire assembly can be attached to the RoboRIO using + [double-sided mounting tape](https://www.amazon.com/dp/B00FUEN2GK). + +* The [Orange Pi Double Case](https://github.com/AZ-First/Az-RBSI/releases/download/v26.0.0-rc2/Orange.Pi.Double.case.STL) + and [Lid](https://github.com/AZ-First/Az-RBSI/releases/download/v26.0.0-rc2/Orange.Pi.Double.case.lid.STL) + are designed to hold two [Orange Pi 5](https://www.amazon.com/dp/B0BN17PWWB)'s + (not **B** or **Pro** or **Max**) (and connect up to 4 cameras). Also requires: + + * 2x [128 GB micro SD card](https://www.amazon.com/dp/B0B7NTY2S6) + * 4x [M2.5x6mm+6mm Male-Female Hex Standoff](https://www.amazon.com/gp/product/B08F2F96HM) (under the bottom Pi) + * 4x [M2.5x25mm+6mm Male-Female Hex Standoff](https://www.amazon.com/gp/product/B08F2DBNZW) (between the two Pi's) + * 4x [M2.5x20mm Female-Female Hex Standoff](https://www.amazon.com/gp/product/B08F2HZN4R) (atop the upper Pi) + * 8x [M2.5x8mm Machine Screws](https://www.amazon.com/gp/product/B07MLB1627) (through case and into standoffs) + * 2x [Cooling Fan 40mm 5V DC + Grill](https://www.amazon.com/gp/product/B08R1CXGCJ) (attaches to side of case) + * 2x [90-Degree USB-C to 2 Pin Bare Wire Open End Power Cord, 10 inch](https://www.amazon.com/gp/product/B0CY2J5H3K) (for powering Pi's) + * 1x [Pololu 5V, 5.5A Step-Down Voltage Regulator](https://www.pololu.com/product/4091) (Power regulation for the Pi's) + * 3x [M2x8mm Machine Screws](https://www.amazon.com/gp/product/B07M6RTWCC) (for attaching the Pololu to the lid) + + Power to the case can be 18/2 AWG black/red wire directly from the PDP to the + Pololu w/o or w/out intermediate connectors. + + **NOTE: Powering the case in this way requires soldering the USB-C cables and the + 18/2 AWG wires to the Pololu.** This requires patience. + + Mounting the case to the robot requires 4x 10-32 nylock nuts + 4x 10-32 bolts. From d6535d5dbd369d048eaaeef00655f7356e29b6ac Mon Sep 17 00:00:00 2001 From: "Timothy P. Ellsworth Bowers" Date: Tue, 20 Jan 2026 09:12:01 -0700 Subject: [PATCH 3/4] Add links for the 2026 Kickoff Workshop slides --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index b2ad2d3..58d103c 100644 --- a/README.md +++ b/README.md @@ -54,6 +54,15 @@ effective logging for troubleshooting. -- Robot vision / tracking * [Autopilot](https://therekrab.github.io/autopilot/index.html) -- Drive-to-Pose semi-autonomous movements +## 2026 Kickoff Slides + +Google Drive links for our 2026 Kickoff Workshops: + +* [AZ RBSI and Advantage Kit +](https://docs.google.com/presentation/d/1KOfODbdGbk8L_G25i7iYnaahoKr_Tzg54LJYN4yax_4/edit?usp=sharing) +* [Know Where You Are: PhotonVision for Alignment and Odometry +](https://docs.google.com/presentation/d/1JWYmwpZYA2zBuNIj9kKBUC_O-i0d1-SW_6qsVxgPdCA/edit?usp=sharing) + ## Further Reading For tips on command-based programming, see this post: From b028b4f8cf0a9a03250d02da795dbf0a968a7444 Mon Sep 17 00:00:00 2001 From: "Timothy P. Ellsworth Bowers" Date: Tue, 20 Jan 2026 09:31:09 -0700 Subject: [PATCH 4/4] Clarify Orange Pi powering options --- doc/RBSI-GSG.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/doc/RBSI-GSG.md b/doc/RBSI-GSG.md index 21cec8e..fcd0dcf 100644 --- a/doc/RBSI-GSG.md +++ b/doc/RBSI-GSG.md @@ -117,14 +117,16 @@ section of [each release](https://github.com/AZ-First/Az-RBSI/releases). * 4x [M2.5x20mm Female-Female Hex Standoff](https://www.amazon.com/gp/product/B08F2HZN4R) (atop the upper Pi) * 8x [M2.5x8mm Machine Screws](https://www.amazon.com/gp/product/B07MLB1627) (through case and into standoffs) * 2x [Cooling Fan 40mm 5V DC + Grill](https://www.amazon.com/gp/product/B08R1CXGCJ) (attaches to side of case) - * 2x [90-Degree USB-C to 2 Pin Bare Wire Open End Power Cord, 10 inch](https://www.amazon.com/gp/product/B0CY2J5H3K) (for powering Pi's) - * 1x [Pololu 5V, 5.5A Step-Down Voltage Regulator](https://www.pololu.com/product/4091) (Power regulation for the Pi's) + * 1x [Redux Robotics Zinc-V Regulator](https://shop.reduxrobotics.com/products/zinc-v) OR [Pololu 5V, 5.5A Step-Down Voltage Regulator](https://www.pololu.com/product/4091) OR [Pololu 5V, 3A Step-Up/Step-Down Voltage Regulator](https://www.pololu.com/product/4082) (Power regulation for the Pi's) + * 2x [90-Degree USB-C to USB-C Cable, 10 inch](https://www.amazon.com/dp/B0CG1PZMVG) for ZINC-V or [90-Degree USB-C to 2 Pin Bare Wire, 10 inch](https://www.amazon.com/gp/product/B0CY2J5H3K) for Pololu (for powering Pi's) * 3x [M2x8mm Machine Screws](https://www.amazon.com/gp/product/B07M6RTWCC) (for attaching the Pololu to the lid) - Power to the case can be 18/2 AWG black/red wire directly from the PDP to the - Pololu w/o or w/out intermediate connectors. + **NOTE: Powering the case with a Pololu requires soldering the USB-C cables + and the 18/2 AWG wires to the Pololu.** This requires patience. Using the + Zinc-V requires no soldering, but introduces an extra USB-C connection. - **NOTE: Powering the case in this way requires soldering the USB-C cables and the - 18/2 AWG wires to the Pololu.** This requires patience. + See the [PhotonVision Wiring documentation + ](https://docs.photonvision.org/en/latest/docs/quick-start/wiring.html) for + more details. Mounting the case to the robot requires 4x 10-32 nylock nuts + 4x 10-32 bolts.