docs/source/docs/troubleshooting/networking-troubleshooting.md

# Networking Troubleshooting

Before reading further, ensure that you follow all the recommendations {ref}`in our networking section <docs/quick-start/networking:Physical Networking>`. You should follow these guidelines in order for PhotonVision to work properly; other networking setups are not officially supported.

## Checklist

A few issues make up the majority of support requests. Run through this checklist quickly to catch some common mistakes.

- Is your camera connected to the robot's radio through a {ref}`network switch <docs/quick-start/networking:Physical Networking>`?
  - Ethernet straight from a laptop to a coprocessor will not work (most likely), due to the unreliability of link-local connections.
  - Even if there's a switch between your laptop and coprocessor, you'll still want a radio or router in the loop somehow.
  - The FRC radio is the _only_ router we will officially support due to the innumerable variations between routers.
- (Raspberry Pi, Orange Pi & Limelight only) have you flashed the correct image, and is it [up to date](https://github.com/PhotonVision/photonvision/releases/latest)?
- Is your robot code using a **2026** version of WPILib, and is your coprocessor using the most up to date **2026** release?
  - 2022, 2023, 2024, 2025, and 2026 versions of either cannot be mix-and-matched!
  - Your PhotonVision version can be checked on the settings tab.
- Is your team number correctly set on the settings tab?

### photonvision.local Not Found

Use [Angry IP Scanner](https://angryip.org/) and look for an IP that has port 5800 open. Then go to your web browser and do \<IP ADDRESS>:5800.

Alternatively, you can plug your coprocessor into a display, plug in a keyboard, and run `hostname -I` in the terminal. This should give you the IP Address of your coprocessor, then go to your web browser and do \<IP ADDRESS>:5800.

If nothing shows up, ensure your coprocessor has power, and you are following all of our networking recommendations, feel free to {ref}`contact us <index:contact us>` and we will help you.

### Can't Connect To Robot

Please check that:
1\. You don't have the NetworkTables Server on (toggleable in the settings tab). Turn this off when doing work on a robot.
2\. You have your team number set properly in the settings tab.
3\. Your camera name in the `PhotonCamera` constructor matches the name in the UI.
4\. You are using the 2026 version of WPILib and RoboRIO image.
5\. Your robot is on.

If all of the above are met and you still have issues, feel free to {ref}`contact us <index:contact us>` and provide the following information:

- The WPILib version used by your robot code
- PhotonLib vendor dependency version
- PhotonVision version (from the UI)
- Your settings exported from your coprocessor (if you're able to access it)
- How your RoboRIO/coprocessor are networked together
Switch from RST to MyST Markdown (#1395) 2024-08-18 14:05:23 -04:00			`# Networking Troubleshooting`

[docs] Create quick-start guide (#1528) Add a quick-start guide to help answer more questions with fewer words. --------- Co-authored-by: Matt M <matthew.morley.ca@gmail.com> 2024-11-14 22:56:02 -05:00			Before reading further, ensure that you follow all the recommendations {ref}`in our networking section <docs/quick-start/networking:Physical Networking>`. You should follow these guidelines in order for PhotonVision to work properly; other networking setups are not officially supported.
Switch from RST to MyST Markdown (#1395) 2024-08-18 14:05:23 -04:00
			`## Checklist`

			`A few issues make up the majority of support requests. Run through this checklist quickly to catch some common mistakes.`

[docs] Create quick-start guide (#1528) Add a quick-start guide to help answer more questions with fewer words. --------- Co-authored-by: Matt M <matthew.morley.ca@gmail.com> 2024-11-14 22:56:02 -05:00			- Is your camera connected to the robot's radio through a {ref}`network switch <docs/quick-start/networking:Physical Networking>`?
			`- Ethernet straight from a laptop to a coprocessor will not work (most likely), due to the unreliability of link-local connections.`
			`- Even if there's a switch between your laptop and coprocessor, you'll still want a radio or router in the loop somehow.`
			`- The FRC radio is the _only_ router we will officially support due to the innumerable variations between routers.`
2025 Doc Cleanup (#1650) 2025-01-02 21:44:50 -06:00			`- (Raspberry Pi, Orange Pi & Limelight only) have you flashed the correct image, and is it [up to date](https://github.com/PhotonVision/photonvision/releases/latest)?`
Bump wpilib to 2026 beta (#2192) ## Description <!-- What changed? Why? (the code + comments should speak for itself on the "how") --> <!-- Fun screenshots or a cool video or something are super helpful as well. If this touches platform-specific behavior, this is where test evidence should be collected. --> <!-- Any issues this pull request closes or pull requests this supersedes should be linked with `Closes #issuenumber`. --> Bump to wpilib 2026 beta. This does not bump our pythonlib, as robotpy hasn't come out yet. ## Meta Merge checklist: - [ ] Pull Request title is [short, imperative summary](https://cbea.ms/git-commit/) of proposed changes - [ ] The description documents the _what_ and _why_ - [ ] This PR has been [linted](https://docs.photonvision.org/en/latest/docs/contributing/linting.html). - [ ] If this PR changes behavior or adds a feature, user documentation is updated - [ ] If this PR touches photon-serde, all messages have been regenerated and hashes have not changed unexpectedly - [ ] If this PR touches configuration, this is backwards compatible with settings back to v2025.3.2 - [ ] If this PR touches pipeline settings or anything related to data exchange, the frontend typing is updated - [ ] If this PR addresses a bug, a regression test for it is added --------- Co-authored-by: Gold856 <117957790+Gold856@users.noreply.github.com> 2025-12-11 23:53:54 -06:00			`- Is your robot code using a 2026 version of WPILib, and is your coprocessor using the most up to date 2026 release?`
			`- 2022, 2023, 2024, 2025, and 2026 versions of either cannot be mix-and-matched!`
2025 Doc Cleanup (#1650) 2025-01-02 21:44:50 -06:00			`- Your PhotonVision version can be checked on the settings tab.`
			`- Is your team number correctly set on the settings tab?`
Switch from RST to MyST Markdown (#1395) 2024-08-18 14:05:23 -04:00
			`### photonvision.local Not Found`

			`Use [Angry IP Scanner](https://angryip.org/) and look for an IP that has port 5800 open. Then go to your web browser and do \<IP ADDRESS>:5800.`

			Alternatively, you can plug your coprocessor into a display, plug in a keyboard, and run `hostname -I` in the terminal. This should give you the IP Address of your coprocessor, then go to your web browser and do \<IP ADDRESS>:5800.

			If nothing shows up, ensure your coprocessor has power, and you are following all of our networking recommendations, feel free to {ref}`contact us <index:contact us>` and we will help you.

			`### Can't Connect To Robot`

			`Please check that:`
			`1\. You don't have the NetworkTables Server on (toggleable in the settings tab). Turn this off when doing work on a robot.`
			`2\. You have your team number set properly in the settings tab.`
			3\. Your camera name in the `PhotonCamera` constructor matches the name in the UI.
Bump wpilib to 2026 beta (#2192) ## Description <!-- What changed? Why? (the code + comments should speak for itself on the "how") --> <!-- Fun screenshots or a cool video or something are super helpful as well. If this touches platform-specific behavior, this is where test evidence should be collected. --> <!-- Any issues this pull request closes or pull requests this supersedes should be linked with `Closes #issuenumber`. --> Bump to wpilib 2026 beta. This does not bump our pythonlib, as robotpy hasn't come out yet. ## Meta Merge checklist: - [ ] Pull Request title is [short, imperative summary](https://cbea.ms/git-commit/) of proposed changes - [ ] The description documents the _what_ and _why_ - [ ] This PR has been [linted](https://docs.photonvision.org/en/latest/docs/contributing/linting.html). - [ ] If this PR changes behavior or adds a feature, user documentation is updated - [ ] If this PR touches photon-serde, all messages have been regenerated and hashes have not changed unexpectedly - [ ] If this PR touches configuration, this is backwards compatible with settings back to v2025.3.2 - [ ] If this PR touches pipeline settings or anything related to data exchange, the frontend typing is updated - [ ] If this PR addresses a bug, a regression test for it is added --------- Co-authored-by: Gold856 <117957790+Gold856@users.noreply.github.com> 2025-12-11 23:53:54 -06:00			`4\. You are using the 2026 version of WPILib and RoboRIO image.`
Switch from RST to MyST Markdown (#1395) 2024-08-18 14:05:23 -04:00			`5\. Your robot is on.`

			If all of the above are met and you still have issues, feel free to {ref}`contact us <index:contact us>` and provide the following information:

			`- The WPILib version used by your robot code`
			`- PhotonLib vendor dependency version`
			`- PhotonVision version (from the UI)`
			`- Your settings exported from your coprocessor (if you're able to access it)`
			`- How your RoboRIO/coprocessor are networked together`