Skip to content
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

DOCS-3745: Update RPI camera instructions #4124

Merged
merged 3 commits into from
Mar 24, 2025
Merged
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
@@ -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/).
@@ -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:
1 change: 0 additions & 1 deletion docs/operate/reference/prepare/rpi-setup.md
Original file line number Diff line number Diff line change
@@ -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.