From patchwork Tue Dec 2 08:36:21 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Jai Luthra X-Patchwork-Id: 25284 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 32C97BD80A for ; Tue, 2 Dec 2025 08:36:55 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 1BCA360C73; Tue, 2 Dec 2025 09:36:54 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="NgYp/TLw"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id 9F24B609E0 for ; Tue, 2 Dec 2025 09:36:52 +0100 (CET) Received: from mail.ideasonboard.com (unknown [IPv6:2401:4900:1c30:14e0:17fd:e3c6:810:1656]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 1996B3E6; Tue, 2 Dec 2025 09:34:37 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1764664478; bh=ZFtPbPVEcDTxh/E8lSH5jvvsGQReJXa56BD4T6bZDUc=; h=From:To:Cc:Subject:Date:From; b=NgYp/TLwaH6i445XwYHqXNwYimRJvOO7Su6GoSwtGsQiiIu44uuHM3QyMWAhN4JN1 yzxA0nXqFue86OUURaDM8C/bASeTTUo50RTMrPPF3RJVYnUv6E0KFfoEPTzQMxVcKU v0NAPCv2DlY+ysrbWQxJ9H3ZEBrr/tYJeR8Htrpg= From: Jai Luthra To: libcamera-devel@lists.libcamera.org Cc: Jai Luthra , Kieran Bingham , Stefan Klug Subject: [PATCH v4] Documentation: Add ISP feature support matrix Date: Tue, 2 Dec 2025 14:06:21 +0530 Message-ID: <20251202083627.3513891-1-jai.luthra@ideasonboard.com> X-Mailer: git-send-email 2.51.1 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. Acked-by: Kieran Bingham Reviewed-by: Stefan Klug Signed-off-by: Jai Luthra --- Changes since v3: - Add Stefan's suggestions along with his R-by. - Add Dan's suggestions - Update IPU3's global tone mapping and gamma support - Clean up grammar in the notes section below the table - Link to v3: https://patchwork.libcamera.org/patch/25213/ --- Documentation/index.rst | 1 + Documentation/isp-feature-matrix.rst | 103 +++++++++++++++++++++++++++ Documentation/meson.build | 1 + 3 files changed, 105 insertions(+) create mode 100644 Documentation/isp-feature-matrix.rst -- 2.51.1 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..7f3657f9 --- /dev/null +++ b/Documentation/isp-feature-matrix.rst @@ -0,0 +1,103 @@ +.. 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. + +.. table:: ISP Feature Support by Platform + + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + | Feature | i.MX8MP | RK3399, RK3288 | Raspberry Pi 4 | Raspberry Pi 5 | Intel 6th/7th Gen (IPU3) | Renesas V2H/V2N* | Software ISP (CPU)** | + +=============================================+===========+================+====================+================+==========================+==================+======================+ + | Auto Gain Control Stats (AGC) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + | Auto Focus (AF) | 🛠️ (CDAF) | 🛠️ (CDAF) | ✅ (CDAF/PDAF) | ✅ (CDAF/PDAF) | ✅ (CDAF) | 🛠️ | ❓ | + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + | HDR Stitching | ✅ | 🚫 | ✅ (Software only) | ✅ | ❓ | 🛠️ | ❓ | + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + | 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 | 🛠️ | 🛠️ | ❓ | ❓ | ❓ | ❓ | ❓ | + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + | Downscaling | ✅ | ✅ | ✅ | ✅ | ❓ | ✅ | ✅ | + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + | Multi-context | 🚫 | 🚫 | 🛠️ | 🛠️ | ❓ | 🛠️ | ❓ | + +---------------------------------------------+-----------+----------------+--------------------+----------------+--------------------------+------------------+----------------------+ + + +.. note:: + + **\*** Based on ARM's Mali C55 ISP, therefore easily extendable to other + SoCs that integrate that ISP + + **\*\*** CPU-based image processing, therefore extendable to any platform. + Currently the following are supported: + + * Intel 11th-14th Gen (IPU6) + * Intel 15th Gen (IPU7) + * Texas Instruments J7x/AM6x + * Qualcomm Snapdragon (CamSS) + +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. + +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. diff --git a/Documentation/meson.build b/Documentation/meson.build index fe53ebcf..a84304dd 100644 --- a/Documentation/meson.build +++ b/Documentation/meson.build @@ -164,6 +164,7 @@ if sphinx.found() 'index.rst', 'internal-api/index.rst', 'introduction.rst', + 'isp-feature-matrix.rst', 'lens_driver_requirements.rst', 'libcamera_architecture.rst', 'mali-c55.dot',