From ae4b9c9780b31c60ef78787586318cdc7bfc7e4a Mon Sep 17 00:00:00 2001 From: Michael Jansen Date: Mon, 29 Dec 2025 19:18:20 -0500 Subject: [PATCH 1/2] Update P1 docs and add switch placeholder --- docs/index.md | 3 +++ docs/lumaswitch/index.md | 1 + docs/p1/flashing.md | 2 +- docs/p1/parts.md | 19 +++++++++++++++++++ docs/p1/wiring.md | 9 +++++++-- mkdocs.yml | 3 +++ 6 files changed, 34 insertions(+), 3 deletions(-) create mode 100644 docs/lumaswitch/index.md create mode 100644 docs/p1/parts.md diff --git a/docs/index.md b/docs/index.md index 01c0ff9..6cd5f01 100644 --- a/docs/index.md +++ b/docs/index.md @@ -2,3 +2,6 @@ ## Vision Systems * [Luma P1](p1/index.md) + +## Ethernet Switches +* [LumaSwitch](lumaswitch/index.md) diff --git a/docs/lumaswitch/index.md b/docs/lumaswitch/index.md new file mode 100644 index 0000000..226eef0 --- /dev/null +++ b/docs/lumaswitch/index.md @@ -0,0 +1 @@ +# LumaSwitch \ No newline at end of file diff --git a/docs/p1/flashing.md b/docs/p1/flashing.md index 0ca7c58..a52dbc6 100644 --- a/docs/p1/flashing.md +++ b/docs/p1/flashing.md @@ -10,7 +10,7 @@ * Windows: [Download](https://github.com/raspberrypi/usbboot/raw/master/win32/rpiboot_setup.exe) * Mac/Linux: [Build from source](https://github.com/raspberrypi/usbboot) 2. Download and install [balenaEtcher](https://etcher.balena.io/) -3. Download the [latest PhotonVision image for Luma P1](https://github.com/PhotonVision/photonvision/releases/download/v2026.0.0-alpha-2/photonvision-v2026.0.0-alpha-2-linuxarm64_luma_p1.img.xz) or other raspberry pi compatible vision solutions +3. Download the [latest PhotonVision image for Luma P1](https://github.com/PhotonVision/photonvision/releases) or other raspberry pi compatible vision solutions ## Put P1 in Flash Mode 1. Ensure P1 is not powered diff --git a/docs/p1/parts.md b/docs/p1/parts.md new file mode 100644 index 0000000..b8bd39b --- /dev/null +++ b/docs/p1/parts.md @@ -0,0 +1,19 @@ +# Spare Parts + +The following parts are available as either spares, or to repair damaged P1 cameras. + +* [P1 Mainboard](https://luma.vision/products/p1-mainboard) +* [P1 Enclosure](https://luma.vision/products/p1-enclosure) +* OV9281 CSI Camera + * [Waveshare](https://www.waveshare.com/ov9281-110-camera.htm) (Ships from China) + * [Amazon](https://www.amazon.com/TUOPUONE-OV9281-110-Compatible-Raspberry-Shutter/dp/B0CKQWSVTH) + * [Robot Shop](https://www.robotshop.com/products/ov9281-110-mono-camera-for-raspberry-pi-global-shutter-1mp) +* Raspberry Pi CM5 (2+ GB RAM w/ EMMC) + * [DigiKey](https://www.digikey.com/en/products/detail/raspberry-pi/SC1558/25805572) + * [Mouser](https://www.mouser.com/ProductDetail/Raspberry-Pi/SC1558?qs=3vio67wFuYr91IGuMTzW2w%3D%3D) +* CM5 Cooling Fan (will need threads drilled out with a 3/16" drill bit) + * [Waveshare](https://www.waveshare.com/cm5-fan-3007-5v.htm) (Ships from China) + * [Amazon](https://www.amazon.com/dp/B0DPNF442Y) +* 50mm Flex Cable (15 Pin, 1mm pitch, Reverse) + * [DigiKey](https://www.digikey.com/en/products/detail/gct/10-15-D-0050-C-4-08-4-T/21854192) + * [Amazon](https://www.amazon.com/uxcell-Flexible-Cable-Ribbon-Player/dp/B0FH6WLZPS) diff --git a/docs/p1/wiring.md b/docs/p1/wiring.md index 549570d..bbbd9cf 100644 --- a/docs/p1/wiring.md +++ b/docs/p1/wiring.md @@ -1,12 +1,17 @@ # Wiring Options -## Radio PoE (Recommended) -The simplest and most reliable method of wiring P1 is by utilizing the Vivid Hosting radio's PoE output. +## Radio PoE or LumaSwitch (Recommended) +The simplest and most reliable method of wiring P1 is by utilizing the Vivid Hosting radio or [LumaSwitch](https://luma.vision/products/lumaswitch)'s PoE output. ![Radio PoE Diagram](img/Radio%20PoE%20Diagram.png){width="600"} + +### Radio Simply connect the radio to P1 with an ethernet cable and switch on the [PoE dipswitch](https://frc-radio.vivid-hosting.net/overview/wiring-your-radio#power-over-ethernet-poe-for-downstream-devices) for the port its plugged into. +### LumaSwitch +Connect an ethernet cable between P1 and one of the PoE ports on LumaSwitch. Use a 5A fuse to enable PoE on the chosen slot. + !!! warning When powering P1 via PoE, ensure you are using an ethernet cable that uses at least 24 AWG wire for each conductor. DO NOT use "low profile" ethernet cable. diff --git a/mkdocs.yml b/mkdocs.yml index da0e174..c0c3f3c 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -7,6 +7,9 @@ nav: - Mounting: p1/mounting.md - Wiring: p1/wiring.md - Flashing: p1/flashing.md + - Spare Parts: p1/parts.md + - LumaSwitch: + - lumaswitch/index.md markdown_extensions: - attr_list - admonition From ecdee5cb9dcf1d9eb774a6feb7f1918ca10eb628 Mon Sep 17 00:00:00 2001 From: Michael Jansen Date: Mon, 29 Dec 2025 19:34:23 -0500 Subject: [PATCH 2/2] add a P1 getting started page --- docs/p1/getting_started.md | 10 ++++++++++ mkdocs.yml | 1 + 2 files changed, 11 insertions(+) create mode 100644 docs/p1/getting_started.md diff --git a/docs/p1/getting_started.md b/docs/p1/getting_started.md new file mode 100644 index 0000000..97074cb --- /dev/null +++ b/docs/p1/getting_started.md @@ -0,0 +1,10 @@ +# Getting Started With P1 + +1. P1 ships pre-flashed with the latest PhotonVision image available at the time it was assembled. It is not required to flash PhotonVision out of the box unless a new version has been released. In that case, follow the [flashing instructions](flashing.md) to update the PhotonVision installation. +2. Wire P1 to your robot or test bench following the [wiring instructions](wiring.md). If you are setting up multiple devices, it is recommended to only set up/power one at a time to make it easier to find each device on the robot network. +3. Power up the robot and get comms. Navigate to `photonvision.local:5800` in your browser, this will bring you to the PhotonVision web configuration. + + !!! warning + If you have multiple PhotonVision devices on the robot, this address may point to any of them. It is recommended to set up each device one at a time, giving each a static IP and unique hostname as outlined in the [PhotonVision networking documentation](https://docs.photonvision.org/en/latest/docs/quick-start/networking.html#networking) + +4. Follow the [PhotonVision docs](https://docs.photonvision.org/en/latest/index.html) to finish setting up and using PhotonVision. \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index c0c3f3c..525c9c8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -4,6 +4,7 @@ nav: - Home: index.md - P1: - p1/index.md + - Getting Started: p1/getting_started.md - Mounting: p1/mounting.md - Wiring: p1/wiring.md - Flashing: p1/flashing.md