diff --git a/README.md b/README.md index 56e8138..58d103c 100644 --- a/README.md +++ b/README.md @@ -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: diff --git a/doc/INSTALL.md b/doc/INSTALL.md index a1a4518..c3c2372 100644 --- a/doc/INSTALL.md +++ b/doc/INSTALL.md @@ -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 @@ -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. + 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 +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` -------- diff --git a/doc/RBSI-GSG.md b/doc/RBSI-GSG.md index 11d93d4..fcd0dcf 100644 --- a/doc/RBSI-GSG.md +++ b/doc/RBSI-GSG.md @@ -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.