![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-Set-Up-USB-Camera-OpenCV.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nPrerequisites<\/h2>\n\n\n\n
Before proceeding, make sure you check all the following prerequisites: <\/p>\n\n\n\n
- \n
- You need a Raspberry Pi board<\/a> and a USB Camera<\/a>.<\/li>\n\n\n\n
- You should have a Raspberry Pi running Raspberry Pi OS<\/a> (32-bit or 64-bit).<\/li>\n\n\n\n
- You should be able to establish a Remote Desktop Connection with your Raspberry Pi<\/a> – click here for Mac OS instructions<\/a>.<\/li>\n\n\n\n
- You should have OpenCV installed on your Raspberry Pi<\/a>.<\/li>\n<\/ul>\n\n\n\n
Raspberry Pi with USB Camera<\/h2>\n\n\n\n
In our OpenCV projects, we will be using the Raspberry Pi with a regular USB camera<\/a>, like the one shown in the picture below.<\/p>\n\n\n
\n![\"USB](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/USB-Camera-Webcam-Raspberry-Pi-compatible.jpg?resize=750%2C393&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nHere are a few advantages and disadvantages of using a USB camera:<\/p>\n\n\n\n
- \n
- If you already have a USB camera, you can try to use it with your OpenCV projects and you don’t need to spend any extra money on a Raspberry Pi-specific camera<\/a>.<\/li>\n\n\n\n
- If your OpenCV application requires high-quality image\/video, you can buy a USB camera that can offer more quality or other specific features that are required for your project needs (higher image quality, faster frame rates, and more flexibility in terms of mounting and lens options).<\/li>\n\n\n\n
- However, USB cameras might be a bit more tricky to set up since they can have driver incompatibility issues when used with the Raspberry Pi.<\/li>\n\n\n\n
- For Raspberry Pi projects using OpenCV, we recommend using a webcam from a well-known brand like Logitech<\/a> to prevent driver incompatibility issues.<\/li>\n<\/ul>\n\n\n\n
In summary, the best choice for you will depend on your project requirements. In this guide, we’ll show you how to set up OpenCV with a USB camera. <\/p>\n\n\n\n
Connect your camera to the Raspberry Pi USB port before proceeding.<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-USB-Camera-webcam-connected.jpg?resize=750%2C421&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nList Your USB Devices<\/h2>\n\n\n\n
On a Terminal window on your Raspberry Pi, run the next command to list all video devices:<\/p>\n\n\n\n
v4l2-ctl --list-devices<\/code><\/pre>\n\n\n\nIn our case, we are using an HD Pro Webcam C920 by Logitech<\/a> and we’ve highlighted it in the screenshot below.<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-list-all-USB-devices-to-find-id.png?resize=832%2C640&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nEven though it lists three video devices, usually the USB camera id is the one at the first line. In our case:<\/p>\n\n\n\n
\/dev\/video0<\/code><\/pre>\n\n\n\nThis means that for our OpenCV projects the camera id is 0<\/span>, yours might be different.<\/p>\n\n\n\n
OpenCV Test USB Camera – Python Script<\/h2>\n\n\n\n
We’ve created a simple OpenCV Python script to test if your USB camera is compatible with the Raspberry Pi and can be used in future projects.<\/p>\n\n\n\n
Start by creating a new file called opencv_test_usb_camera.py<\/em>, run the following command:<\/p>\n\n\n\n
nano opencv_test_usb_camera.py<\/code><\/pre>\n\n\n\nCopy the code to your newly created file:<\/p>\n\n\n
# Rui Santos & Sara Santos - Random Nerd Tutorials\n# Complete project details at https:\/\/RandomNerdTutorials.com\/set-up-usb-camera-opencv-raspberry-pi\/\n\nimport cv2\n\nvideo_capture = cv2.VideoCapture(0)\n\nwhile True:\n result, video_frame = video_capture.read() # read frames from the video\n if result is False:\n break # terminate the loop if the frame is not read successfully\n\n cv2.imshow(\n "USB Camera Test", video_frame\n )\n\n if cv2.waitKey(1) & 0xFF == ord("q"):\n break\n\nvideo_capture.release()\ncv2.destroyAllWindows()\n<\/code><\/pre>\n\tView raw code<\/a><\/p>\n\n\n\n
You need to change the id<\/strong> of the VideoCapture(id)<\/span> to the one you’ve found in the previous section. In our case, the camera id is 0<\/span> and it looks as follows:<\/p>\n\n\n\n
video_capture = cv2.VideoCapture(0)<\/code><\/pre>\n\n\n\nOnce you’ve made all the changes, press Ctrl<\/strong>+X<\/strong> to save your file, type Y<\/strong> and Enter<\/strong>.<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-OpenCV-script-edit-camera-id.png?resize=739%2C505&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nHow the Script Works<\/h3>\n\n\n\n
Let’s take a quick look at how the code works. Start by importing the OpenCV library.<\/p>\n\n\n\n
import cv2<\/code><\/pre>\n\n\n\nCreate a cv2.VideoCapture(0)<\/span> object with your USB’s camera id called video_capture<\/span>.<\/p>\n\n\n\n
video_capture = cv2.VideoCapture(0)<\/code><\/pre>\n\n\n\nCreate a loop that keeps capturing new frames from the USB camera and displays them in the preview window. You can also stop the script at any time by pressing the q<\/strong> key on your keyboard.<\/p>\n\n\n\n
while True:\n result, video_frame = video_capture.read() # read frames from the video\n if result is False:\n break # terminate the loop if the frame is not read successfully\n\n cv2.imshow(\n \"USB Camera Test\", video_frame\n )\n\n if cv2.waitKey(1) & 0xFF == ord(\"q\"):\n break<\/code><\/pre>\n\n\n\nWhen you stop the Python script it will stop the USB camera and close all the preview windows.<\/p>\n\n\n\n
video_capture.release()\ncv2.destroyAllWindows()<\/code><\/pre>\n\n\n\nWith your OpenCV Python environment activated, in our case:<\/p>\n\n\n\n
source projectsenv\/bin\/activate<\/code><\/pre>\n\n\n\nStart your script by running the following command:<\/p>\n\n\n\n
python opencv_test_usb_camera.py<\/code><\/pre>\n\n\n\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-OpenCV-run-opencv-test-usb-camera-python-script.png?resize=833%2C202&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nA preview window opens and the webcam will be streaming in your Raspberry Pi desktop.<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-OpenCV-test-USB-camera-webcam.png?resize=643%2C566&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nTroubleshooting<\/h2>\n\n\n\n
It might be a bit tricky to set up your USB camera, so we’ve compiled a list with 3 common issues that you might encounter and how to fix them.<\/p>\n\n\n\n
Wrong Camera ID<\/h3>\n\n\n\n
If your camera fails to start, you might be using the wrong camera id. You can try the second listed \/dev\/video<\/span> option, in our case 1.<\/p>\n\n\n\n
\/dev\/video1<\/code><\/pre>\n\n\n\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-list-all-USB-devices-try-different-id.png?resize=832%2C211&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nThen, pass 1<\/span> as the camera id in the video capture initialization and run the script again.<\/p>\n\n\n\n
video_capture = cv2.VideoCapture(1)<\/code><\/pre>\n\n\n\nLow Voltage<\/h3>\n\n\n\n
If you see the following message “Low voltage warning” at the top right corner of your Raspberry Pi Desktop, you might be using a power adapter that doesn’t provide enough power for the USB camera to run properly. Try to use a new power adapter that can provide enough power for your Raspberry Pi and camera.<\/p>\n\n\n
\n![\"Raspberry](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2024\/02\/Raspberry-Pi-low-voltage-warning-check-power-supply.png?resize=311%2C179&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\nUSB Camera is not Compatible<\/h3>\n\n\n\n
As we’ve mentioned earlier, some USB cameras might not be compatible with the Raspberry Pi OS due to driver incompatibilities. That’s why we recommend using a webcam from a well-known brand like Logitech<\/a> to prevent driver issues.<\/p>\n\n\n\n
Wrapping Up<\/h2>\n\n\n\n
In this quick guide, you learned how to set up a USB camera for your OpenCV projects with the Raspberry Pi. This will be useful for future OpenCV projects like face recognition, object detection, gesture detection, and more.<\/p>\n\n\n\n
We hope you\u2019ve found this tutorial useful. You can check all our Raspberry Pi projects on the following link:<\/p>\n\n\n\n
- You should have a Raspberry Pi running Raspberry Pi OS<\/a> (32-bit or 64-bit).<\/li>\n\n\n\n