PhotonVision/docs/source/docs/quick-start/wiring.md

# Wiring

## Coprocessor with regulator

1. **IT IS STRONGLY RECOMMENDED** to use one of the recommended power regulators to prevent vision from cutting out from voltage drops while operating the robot. We recommend wiring the regulator directly to the power header pins using either of the two methods listed below or using a locking USB C cable.
    * Method 1: Soldering to GPIO Header Pins
        * Using 20 AWG or preferably 18 AWG wires, solder two wires from the regulator to the power header pins on the coprocessor and cover with heat-shrink tubing.
    * Method 2: Using a Wire-to-Board Connector
        * Using a wire-to-board connector with 20 AWG or preferably 18 AWG wires, connect two wires from the regulator to the power header pins on the coprocessor. To prevent the connector from becoming unseated, we recommend applying hot glue to the connector.

2. Run an ethernet cable from your coprocessor to your network switch / radio.

## Raspberry Pi and Orange Pi

This diagram shows how to use the recommended regulator to power a Raspberry Pi or Orange Pi.

::::{tab-set}

:::{tab-item} Orange Pi 5 Zinc V USB C

```{image} images/OrangePiZincUSBC.png
:alt: Wiring the opi5 to the pdp using the Redux Robotics Zinc V and usb c
```

:::

:::{tab-item} Orange Pi 5 Zinc V

```{image} images/OrangePiZinc.png
:alt: Wiring the opi5 to the pdp using the Redux Robotics Zinc V
```

:::

:::{tab-item} Orange Pi 5 Pololu S13V30F5

```{image} images/OrangePiPololu.png
:alt: Wiring the opi5 to the pdp using the Pololu S13V30F5
```

:::

:::{tab-item} Orange Pi 5 Pololu S13V30F5 Pigtail

```{image} images/OrangePiPololuPigtail.png
:alt: Wiring the opi5 to the pdp using the Pololu S13V30F5 and a usb c pigtail
```

:::

:::{tab-item} Raspberry Pi 5 Zinc V USB C

```{image} images/RPiZincUSBC.png
:alt: Wiring the RPI5 to the pdp using the Redux Robotics Zinc V and usb c
```

:::

:::{tab-item} Raspberry Pi 5 Zinc V

```{image} images/RPiZinc.png
:alt: Wiring the RPI5 to the pdp using the Redux Robotics Zinc V
```

:::

:::{tab-item} Raspberry Pi 5 Pololu S13V30F5

```{image} images/RPiPololu.png
:alt: Wiring the RPI5 to the pdp using the Pololu S13V30F5
```

:::

:::{tab-item} Raspberry Pi 5 Pololu S13V30F5 Pigtail

```{image} images/RPiPololuPigtail.png
:alt: Wiring the RPI5 to the pdp using the Pololu S13V30F5 and a usb c pigtail
```

:::

::::

Pigtails can be purchased from many sources we recommend [(USB C)](https://ctr-electronics.com/products/usb-type-c-wire-breakout?_pos=19&_sid=bf06b6a6b&_ss=r) [(Micro USB)](https://ctr-electronics.com/products/usb-micro-power-wire-breakout?pr_prod_strat=e5_desc&pr_rec_id=10bf36ce7&pr_rec_pid=7863771070637&pr_ref_pid=7863771103405&pr_seq=uniform)

## RUBIK Pi

The RUBIK Pi has very different power requirements than the Orange Pi (or standard Raspberry Pi). In particular it requires 12V inputs, and has
a higher maximum power draw than those coprocessors. [First Rubik](https://first-rubik.github.io/docs/power/) has recommendations for both
on-robot and off-robot scenarios.

## Limelight

Follow the wiring instructions located in the [Limelight Documentation](https://docs.limelightvision.io/) for your Limelight model.

## Coprocessor with Passive POE (Pi with SnakeEyes)

1. Plug the [passive POE injector](https://www.revrobotics.com/rev-11-1210/) into the coprocessor and wire it to PDP/PDH (NOT the VRM).
2. Add a breaker to relevant slot in your PDP/PDH
3. Run an ethernet cable from the passive POE injector to your network switch / radio.

## Off-Robot Wiring

Plugging your coprocessor into the wall via a power brick will suffice for off robot wiring.

:::{note}
Please make sure your chosen power supply can provide enough power for your coprocessor. Undervolting (where enough power isn't being supplied) can cause many issues.
:::