Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 12 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,18 +44,25 @@ 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
* [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:
Expand Down
32 changes: 28 additions & 4 deletions doc/INSTALL.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,30 @@
# 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 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.

--------

### 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
Expand Down Expand Up @@ -29,11 +54,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.

<img src="dependency_enable.png" alt="Enable Dependency Graph" width="50%" />

--------

### 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
Expand All @@ -45,10 +72,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`

--------

Expand Down
39 changes: 39 additions & 0 deletions doc/RBSI-GSG.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,3 +91,42 @@ 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)
* 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)

**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.

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.