Skip to content

DOCS-3745: Update RPI camera instructions #4124

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Mar 24, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 3 additions & 18 deletions docs/operate/reference/components/camera/webcam.md
Original file line number Diff line number Diff line change
Expand Up @@ -236,8 +236,9 @@ If you are capturing camera data, it can happen that the camera captures and syn
{{% /expand%}}

{{% expand "CSI Camera not working on a Raspberry Pi" %}}
If you are using a CSI camera v1.3 or v2.0 on a Raspberry Pi, you need to [enable legacy mode](/operate/reference/prepare/rpi-setup/#enable-communication-protocols).
If you are using a CSI camera v3.0, you need to use the [`viam:camera:csi` module](https://github.com/viamrobotics/csi-camera/) instead.

If you are using a CSI camera v1.3 or v2.0, or v3.0, use the [`viam:camera:csi` module](https://github.com/viamrobotics/csi-camera/) instead.

For Raspberry Pi AI cameras like the IMX500 AI camera, you can use a module such as [this `viam-pi-ai-camera` vision service](https://github.com/HipsterBrown/viam-pi-ai-camera).
Note that this module is not officially supported by Viam.
For more information about the vision service, see [run inference](https://docs.viam.com/data-ai/ai/run-inference/).
Expand All @@ -248,22 +249,6 @@ Each camera stream you add uses CPU on the device it is connected to and there i
You can limit the CPU usage by reducing the image resolution.
{{% /expand%}}

{{% expand "Timeout errors on a Raspberry Pi" %}}

If you are getting "timeout" errors from GRPC when adding a `webcam` model on a Raspberry Pi, make sure the webcam port is enabled on the Pi (common if you are using a fresh Pi right out of the box).

To enable the webcam port on a Raspberry Pi, run the following command:

```sh {class="command-line" data-prompt="$"}
sudo raspi-config
```

Then, select: **Interface Options -> Camera -> Enable Camera**.

Restart the Pi to complete the configuration.

{{% /expand%}}

## Next steps

For more configuration and usage info, see:
Expand Down
1 change: 0 additions & 1 deletion docs/operate/reference/prepare/rpi-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -223,7 +223,6 @@ If you are using hardware that requires these protocols, you must enable support

- If you are using an analog-to-digital converter (ADC), motor, or other device that requires the SPI protocol, enable **SPI**.
- If you are using an accelerometer, sensor, or other device that requires the I<sup>2</sup>C protocol, enable **I2C**.
- If you are using a CSI v1.3 or v2.0 camera, enable **Legacy Camera** support.
- If you are using a sensor, motor, or other device that communicates over the serial port, enable **Serial Port**.

Check the documentation for your specific component to verify the communication protocols it requires.
Expand Down
Loading