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/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/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..525c9c8 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -4,9 +4,13 @@ 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 + - Spare Parts: p1/parts.md + - LumaSwitch: + - lumaswitch/index.md markdown_extensions: - attr_list - admonition