From patchwork Tue Sep 23 12:51:23 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Jai Luthra X-Patchwork-Id: 24438 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 1812ABDB1C for ; Tue, 23 Sep 2025 12:51:54 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id D52B06B5F9; Tue, 23 Sep 2025 14:51:52 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="eXhmGlV2"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id E73E06B5A2 for ; Tue, 23 Sep 2025 14:51:49 +0200 (CEST) Received: from mail.ideasonboard.com (unknown [IPv6:2401:4900:1c67:734b:c03:1342:d84:1f8c]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id B0A394C7; Tue, 23 Sep 2025 14:50:25 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1758631826; bh=5+CQJQPT/hCeAPC+C6N9iPMqcU1O6hjTYUj9ILo5A8U=; h=From:To:Cc:Subject:Date:From; b=eXhmGlV2eleCTeFVgLXoNkKfeZoCey1O11tL/ln3ogtBSpQXHIHi6slJDC270q4qz DuNPzic+gIDSi5GzA4rzhurS8HwYJJ44ifh6Riy3Jj8gQkhZs5HiVcG5cpvKkebrTO x1ouuB7Xay3J7ThRIwj0n/wNEgfWozc8C0nKkogo= From: Jai Luthra To: libcamera-devel@lists.libcamera.org Cc: Jai Luthra Subject: [RFC PATCH] Documentation: Add ISP feature support matrix Date: Tue, 23 Sep 2025 18:21:23 +0530 Message-ID: <20250923125125.3452787-1-jai.luthra@ideasonboard.com> X-Mailer: git-send-email 2.51.0 MIME-Version: 1.0 X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" Add a new living document presenting a matrix of image processing feature support across all currently supported platforms in libcamera. This will hopefuly help in answering questions like is HDR supported with Software ISP or is Auto Focus supported on Raspberry Pi? This matrix will be regularly updated as new features and platforms are added. Signed-off-by: Jai Luthra --- This matrix is a WIP, as you may see with the number of "?" unknown cells, thus marked this patch as an RFC, to get some early feedback. Also most users also care about if their particular sensor is well supported (and tuned) by libcamera for a particular platform. That is out-of-scope for this particular patch, but would be quite nice to have at some point. --- Documentation/index.rst | 1 + Documentation/isp-feature-matrix.rst | 238 +++++++++++++++++++++++++++ 2 files changed, 239 insertions(+) create mode 100644 Documentation/isp-feature-matrix.rst -- 2.51.0 diff --git a/Documentation/index.rst b/Documentation/index.rst index febd4e13..a74b8668 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -9,6 +9,7 @@ Introduction Feature Requirements Runtime configuration + ISP feature support matrix Application Writer's Guide Python Bindings Public API diff --git a/Documentation/isp-feature-matrix.rst b/Documentation/isp-feature-matrix.rst new file mode 100644 index 00000000..ca0a67bd --- /dev/null +++ b/Documentation/isp-feature-matrix.rst @@ -0,0 +1,238 @@ +.. SPDX-License-Identifier: CC-BY-SA-4.0 + +libcamera ISP Feature Support Matrix +===================================== + +The following table shows the current status of ISP feature support across +different platforms in libcamera. + +.. list-table:: ISP Feature Support by Platform + :header-rows: 1 + :stub-columns: 1 + + * - Feature + - i.MX8MP (RKISP) + - BCM2711 (Raspberry Pi 4) + - BCM2712 (Raspberry Pi 5) + - Intel IPU3 + - Mali C55 + - Software ISP (CPU) + + * - Auto Gain Control Stats (AGC) + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + + * - Auto Focus (AF) + - 🛠️ (CDAF) + - ✅ (PDAF with IMX708) + - ✅ (PDAF with IMX708) + - ✅ (CDAF) + - 🚫 + - ❓ + + * - HDR Stitching + - ✅ + - ✅ + - ✅ + - ❓ + - 🛠️ + - ❓ + + * - Companding + - ✅ + - 🚫 + - 🚫 + - ❓ + - ❓ + - ❓ + + * - Black Level Subtraction (BLS) + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + + * - Lens Shading Correction (LSC) + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + - ❓ + + * - Auto Whitebalance (AWB) + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + + * - Defective Pixel Correction (DPC) + - ✅ + - ❓ + - ✅ + - 🚫 + - ✅ + - ❓ + + * - 2D Noise Filtering + - ✅ + - ✅ + - ✅ + - ❓ + - 🛠️ + - ❓ + + * - Local Tone Mapping + - 🛠️ + - 🚫 + - 🚫 + - 🚫 + - 🚫 + - ❓ + + * - Demosaicing + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + + * - Chromatic Aberration Correction (CAC) + - 🛠️ + - 🚫 + - ✅ + - ❓ + - 🛠️ + - ❓ + + * - Sharpening + - ✅ + - ✅ + - ✅ + - ❓ + - 🛠️ + - ❓ + + * - Chroma Noise Reduction + - 🚫 + - ❓ + - ❓ + - ❓ + - ❓ + - ❓ + + * - 3D Noise Filtering + - 🚫 + - 🚫 + - 🚫 + - ❓ + - 🛠️ + - ❓ + + * - Color Correction Matrix (CCM) + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + - ✅ + + * - Global Tone Mapping + - 🛠️ + - ✅ + - ✅ + - ✅ + - 🛠️ + - ❓ + + * - Gamma Correction + - ✅ + - ✅ + - ✅ + - ❓ + - 🛠️ + - ✅ + + * - Color Space Conversion + - ✅ + - ✅ + - ✅ + - ❓ + - ❓ + - ✅ + + * - Image Stabilization + - 🛠️ + - ❓ + - ❓ + - ❓ + - ❓ + - ❓ + + * - Scaling + - ✅ + - ✅ + - ✅ + - ❓ + - ✅ + - ✅ + + * - Multi-context + - 🚫 + - 🛠️ + - 🛠️ + - ❓ + - 🛠️ + - ❓ + +Status Definitions +------------------ + +✅ **Supported** + Feature is fully implemented and working in libcamera. + +🛠️ **Needs Development** + Feature is planned or being developed and may have partial or no + functionality. + +🚫 **No Hardware** + The underlying hardware does not support this feature. + +❓ **Unknown** + Support status is unclear or has not been determined yet. + +Platform Notes +-------------- + +* **i.MX8MP (RKISP)**: Uses the Rockchip ISP IP core integrated in the NXP + i.MX8MP SoC +* **BCM2711/BCM2712**: Broadcom SoCs used in Raspberry Pi 4 and 5 respectively +* **Intel IPU3**: Intel Image Processing Unit version 3 +* **Mali C55**: ARM's camera ISP IP core +* **Software ISP (CPU)**: CPU-based image processing pipeline for platforms + without hardware ISP + +Contributing +------------ + +This feature matrix is maintained by the libcamera community and is updated as +new features are implemented or new platforms are supported. + +**Updating the Matrix** + When adding support for a new ISP feature or platform (SoC), please update + this matrix as part of the same patch or series. Ensure that the feature + support status for all relevant platforms reflects the changes introduced. + +**Reporting Updates** + If you notice any inaccuracies or outdated information in this matrix, + please open an issue or submit a patch. Refer to the contributing + guidelines in the :doc:`contributing` guide.