From patchwork Thu Nov 24 12:12:20 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jacopo Mondi X-Patchwork-Id: 17895 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 49E03BDE6B for ; Thu, 24 Nov 2022 12:12:39 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 08CED6331E; Thu, 24 Nov 2022 13:12:39 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org; s=mail; t=1669291959; bh=1Y9XURxrGeqSini5H73FcuTfYF7+giYbLY/41RfhXVs=; h=To:Date:In-Reply-To:References:Subject:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To: From; b=0WDXC+s+md/+5rzgDMmvuy2n0UvpHsg0kNCr3ubYEwoAziAE9FQnQJKmD/LjTa8Hg LOUPb/hQ3iQKFLqxlnhnHldoFnFBJoBRjBlEkBYDRDARo8R5QaLD1I1rRouUl/KCR4 JitfGgIxwxpi11mMIVaNbmG7e72OY313HzzNFUpJXJ6hlNaOrHFUjP0NGeLzLk0WSQ DYHww7plVxTUYxDsL8xsG4OoFgNiNbQSNZRC9InUrVfMcpp0L9h0c86e97SckLxl7q 87GsnDHK0GU9aOKycACBRJKgUx251E+P78bKnkU5WtXMEFPbBXDBnlmXh9nnEcTOxt Lm3/NbV9IT9fQ== Received: from relay2-d.mail.gandi.net (relay2-d.mail.gandi.net [217.70.183.194]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id B306D6331A for ; Thu, 24 Nov 2022 13:12:35 +0100 (CET) Received: (Authenticated sender: jacopo@jmondi.org) by mail.gandi.net (Postfix) with ESMTPSA id DECDC40002; Thu, 24 Nov 2022 12:12:34 +0000 (UTC) To: libcamera-devel@lists.libcamera.org Date: Thu, 24 Nov 2022 13:12:20 +0100 Message-Id: <20221124121220.47000-10-jacopo@jmondi.org> X-Mailer: git-send-email 2.38.1 In-Reply-To: <20221124121220.47000-1-jacopo@jmondi.org> References: <20221124121220.47000-1-jacopo@jmondi.org> MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH 9/9] documentation: sensor_drivers: Document H/V flip 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: , X-Patchwork-Original-From: Jacopo Mondi via libcamera-devel From: Jacopo Mondi Reply-To: Jacopo Mondi Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" Briefly document the optional requirement support for H/V flip controls. Signed-off-by: Jacopo Mondi --- Documentation/sensor_driver_requirements.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/sensor_driver_requirements.rst b/Documentation/sensor_driver_requirements.rst index b0854be3328a..e9f998ca8d31 100644 --- a/Documentation/sensor_driver_requirements.rst +++ b/Documentation/sensor_driver_requirements.rst @@ -55,6 +55,19 @@ The sensor driver should support the following V4L2 controls: The controls are used to register the camera location and rotation. +In order to support rotating the image according to the above registered +properties the sensor driver should support + +* `V4L2_CID_HFLIP`_ +* `V4L2_CID_VFLIP`_ + +.. _V4L2_CID_HFLIP: https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/control.html +.. _V4L2_CID_VFLIP: https://www.kernel.org/doc/html/latest/userspace-api/media/v4l/control.html + +and have them writable from userspace. In case of a RAW Bayer sensors, drivers +should correctly report if vertical/horizontal flips modify the Bayer pattern +ordering by reporting the `V4L2_CTRL_FLAG_MODIFY_LAYOUT` control flag. + The sensor driver should implement support for the V4L2 Selection API, specifically it should implement support for the `VIDIOC_SUBDEV_G_SELECTION`_ ioctl with support for the following selection