1. Introduction
This manual provides detailed instructions for the Arducam 12MP IMX477 HQ Camera module (Model B0271). This high-quality camera is designed for use with various Raspberry Pi models, offering superior image resolution and sensitivity. Please read this manual thoroughly before installation and operation to ensure proper use and optimal performance.

Image 1.1: Arducam 12MP IMX477 HQ Camera module with its flexible ribbon cable.
2. Product Overview
The Arducam 12MP IMX477 HQ Camera features a 1/2.3" 12 Megapixel IMX477 sensor, capable of capturing sharp images with a maximum still resolution of 4056 x 3040 pixels. Its compact size (25x24mm) and mounting holes are consistent with the Raspberry Pi Camera Module V2, but it offers enhanced resolution and improved low-light performance due to a larger pixel area. The camera includes an interchangeable M12 lens with a 75°(H) Field of View (FOV) and low distortion, suitable for capturing Ultra HD images.

Image 2.1: Overview of the Arducam Mini Raspberry Pi HQ Camera, highlighting its IMX477 CMOS sensor, 12MP resolution (4056x3040), and 75°(H) M12 lens.
3. What's in the Box
The package for your Arducam 12MP IMX477 HQ Camera includes the following components:
- 1 x Arducam 12MP IMX477 HQ Camera Module with M12 Lens
- 1 x 150mm/5.9inch 15pin to 22pin FPC cable
- 1 x 80mm/3.1inch 22pin camera cable

Image 3.1: Contents of the Arducam HQ Camera package, showing the camera module and included FPC cables.
4. Specifications
| Feature | Detail |
|---|---|
| Brand | Arducam |
| Model Number | B0271 |
| Sensor | 1/2.3" 12 Megapixel IMX477 CMOS |
| Maximum Still Resolution | 4056 x 3040 pixels |
| Lens Type | Interchangeable M12 Lens |
| Field of View (FOV) | 75° (Horizontal) |
| Maximum Focal Length | 24 Millimeters |
| Maximum Aperture | 1.39 Millimeters |
| Connectivity Technology | I2C |
| Special Features | Low Light Performance |
| Dimensions (Camera Board) | 25 x 24 mm |
| Item Weight | 0.634 ounces |
5. Setup Instructions
This section guides you through connecting and configuring your Arducam 12MP IMX477 HQ Camera with your Raspberry Pi.
5.1 Hardware Connection
- Power Off Raspberry Pi: Ensure your Raspberry Pi is completely powered off and disconnected from its power source before proceeding.
- Locate Camera Port: Identify the CSI (Camera Serial Interface) port on your Raspberry Pi board. This is typically a long, narrow connector.
- Connect Ribbon Cable: Gently lift the plastic clip on the CSI connector. Insert the flexible ribbon cable from the camera module into the connector, ensuring the silver contacts on the cable face the silver contacts in the connector. Push the plastic clip back down to secure the cable.
- Secure Camera Module: Position the camera module as desired, ensuring the ribbon cable is not bent sharply or under tension.

Image 5.1: Arducam HQ Camera module properly connected to a Raspberry Pi.
5.2 Software Configuration (Raspberry Pi OS Bullseye and later)
The Arducam IMX477 camera module supports the latest Raspberry Pi OS Bullseye (released Jan 28th, 2022) and libcamera applications. It is not compatible with previous Pi OS (Legacy) versions.
- Edit
config.txt: Open theconfig.txtfile for editing. You can do this via the terminal:sudo nano /boot/config.txt - Add Camera Overlay: Add the following line to the
config.txtfile:dtoverlay=imx477 - Disable Automatic Camera Detection (Bullseye users): To override automatic camera detection, Bullseye users must also delete or change the
camera_auto_detectentry to0. Find the line:
And change it to:camera_auto_detect=1camera_auto_detect=0 - Enable Glamor Acceleration (for Pi Zero-3 Bullseye users): If you are using a Raspberry Pi Zero, Pi 1, Pi 2, or Pi 3 with Bullseye OS, you may need to enable Glamor acceleration for optimal performance.
Navigate to Advanced Options → Glamor → Enabled.sudo raspi-config - Save and Reboot: Save the changes to
config.txt(Ctrl+O, then Enter, then Ctrl+X in nano) and reboot your Raspberry Pi:sudo reboot
6. Operating Instructions
After successful setup, you can use the libcamera tools to capture images and videos with your Arducam HQ Camera.
6.1 Basic Image Capture
To capture a still image, use the libcamera-still command:
libcamera-still -o image.jpgThis command will capture an image and save it as image.jpg in your current directory.
6.2 Basic Video Recording
To record a video, use the libcamera-vid command. For example, to record a 10-second video:
libcamera-vid -t 10000 -o video.h264This command records video for 10 seconds (10000 milliseconds) and saves it as video.h264.
6.3 Further libcamera Usage
The libcamera suite offers many options for resolution, frame rate, exposure, white balance, and more. For advanced usage and a full list of commands and parameters, refer to the official Raspberry Pi documentation for libcamera tools.
libcamera-still --help: Displays options for still image capture.libcamera-vid --help: Displays options for video recording.libcamera-raw --help: Displays options for raw image capture.libcamera-hello --help: Displays options for a preview window.
7. Maintenance
Proper maintenance ensures the longevity and optimal performance of your Arducam HQ Camera.
- Lens Cleaning: Use a soft, lint-free microfiber cloth specifically designed for optics to clean the lens. For stubborn smudges, a small amount of lens cleaning solution can be applied to the cloth (not directly to the lens). Avoid abrasive materials or harsh chemicals.
- Dust Removal: Use a blower brush or compressed air (designed for electronics) to remove dust from the sensor and board. Do not touch the sensor directly.
- Handling: Always handle the camera module by its edges to avoid touching the lens or the sensitive electronic components on the board.
- Storage: When not in use, store the camera in a clean, dry, and anti-static environment, preferably in its original packaging or a protective case.
- Environmental Conditions: Avoid exposing the camera to extreme temperatures, high humidity, or direct sunlight for extended periods.

Image 7.1: Top view of the Arducam HQ Camera module, showing the lens and board components.
8. Troubleshooting
If you encounter issues with your Arducam HQ Camera, refer to the following common problems and solutions.
8.1 Camera Not Detected
- Check Cable Connection: Ensure the ribbon cable is securely inserted into both the camera module and the Raspberry Pi's CSI port, with the silver contacts facing correctly. The plastic clip on the CSI connector should be fully closed.
- Verify Software Configuration: Double-check that you have correctly added
dtoverlay=imx477to/boot/config.txtand setcamera_auto_detect=0(for Bullseye). Reboot the Raspberry Pi after making changes. - Operating System Compatibility: Confirm you are running Raspberry Pi OS Bullseye or a later version. This camera is not compatible with older (Legacy) OS versions.
- Power Supply: Ensure your Raspberry Pi has an adequate power supply. Insufficient power can sometimes lead to peripheral detection issues.
8.2 Poor Image Quality / Focus Issues
- Adjust Focus: The M12 lens is interchangeable and may require manual focusing. Gently rotate the lens barrel to achieve sharp focus. Use a test pattern or a known object at a specific distance to aid focusing.
- Clean Lens: Ensure the lens surface is clean and free from dust, smudges, or fingerprints. Refer to the Maintenance section for cleaning instructions.
- Lighting Conditions: While the IMX477 has improved low-light performance, extremely dark environments will still result in noisy images. Ensure adequate lighting for best results.
- Software Settings: Experiment with
libcameraparameters such as exposure, gain, and white balance to optimize image quality for your specific environment.

Image 8.1: Arducam HQ Camera module on a test chart, useful for checking focus and image quality.
8.3 Performance Issues (Lag, Low Frame Rate)
- Glamor Acceleration: For Pi Zero-3 users, ensure Glamor acceleration is enabled in
raspi-configas described in the Setup section. - Raspberry Pi Model: Older Raspberry Pi models (e.g., Pi Zero, Pi 1, Pi 2) may have limited processing power compared to newer models (Pi 4, Pi 5), which can affect frame rates at higher resolutions.
- Software Load: Close unnecessary applications running on your Raspberry Pi to free up system resources.
- Resolution and Frame Rate Settings: Reduce the capture resolution or frame rate in your
libcameracommands if you are experiencing lag.
9. Support and Warranty
For technical support, product inquiries, or warranty information, please contact Arducam directly through their official website or customer service channels. Refer to your purchase documentation for specific warranty terms and conditions.
Arducam Official Website: www.arducam.com





