Skip to content

WPILibPi 2024.1.1 Beta 1

Pre-release
Pre-release
Compare
Choose a tag to compare
@PeterJohnson PeterJohnson released this 09 Mar 05:52
· 0 commits to main since this release
cb31e54

This is the initial beta release of WPILibPi for 2024. The major update for 2024 is the OS is now Bookworm-based and supports the Raspberry Pi 5.

Known issues:

  • Only the base vision processing image is implemented (Romi is not yet complete)
  • Network settings via the web dashboard does not work
  • The Python example still uses CameraServer.setSize(), this should be replaced with CameraServer.removeCamera("unused")

About WPILibPi

This Raspberry Pi OS-based Raspberry Pi image includes C++, Java, and Python libraries required for vision coprocessor development for FRC (e.g. opencv, cscore, ntcore, robotpy-cscore, pyntcore, Java 17, etc).

The image has been tested with the Raspberry Pi 5, but should also work on other models.

Features

  • Web dashboard for configuring the rPi (e.g. changing network settings), monitoring the vision program (console, restart), changing CameraServer and NetworkTables settings, and uploading vision processing applications, all without the need for SSH
  • Default application that performs simple streaming of multiple cameras as well as camera switching; the image is "plug and play" for FRC dashboard streaming (just set your team number in the rPi web dashboard)
  • Includes example C++, Java, and Python programs to use as a basis for vision processing code
  • Designed for robustness to hard power offs by defaulting the filesystem to read only mode; safe to power directly from the VRM without an external battery
  • Boots (power applied to vision program running) in less than 20 seconds
  • All wireless functionality disabled (both WiFi and Bluetooth), so legal for competition use out of the box.

Getting Started

See https://docs.wpilib.org/en/stable/docs/software/vision-processing/wpilibpi/index.html (for the base image) for visual step-by-step installation instructions and additional documentation.

  1. Download WPILibPi_image-2024.1.1-beta-1.zip and use Etcher (https://www.balena.io/etcher/) to image a micro SD card. The micro SD card needs to be at least 8 GB. Note: a micro SD to USB dongle such as https://www.amazon.com/gp/product/B0779V61XB works well for writing to micro SD cards.

  2. Put the micro SD card in a rPi and apply power. The initial boot may take as long as a couple of minutes (depending on SD card size), but later boots will be much faster (20 seconds or less).

Base image: Connect the rPi ethernet to a LAN or PC. Open a web browser and connect to http://wpilibpi.local/ to open the web dashboard. Note the image boots up read-only by default, so it's necessary to click the "writable" button to make changes.

What's Changed Since 2023.2.1

  • Update to Bookworm
  • Raspberry Pi 5 support
  • Update to WPILib 2024.3.1 and RobotPy 2024.3.1
  • Only a 64-bit image is provided