From patchwork Sat Jan 28 11:27:36 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jacopo Mondi X-Patchwork-Id: 13119836 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id E3C32C61D97 for ; Sat, 28 Jan 2023 11:27:58 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231575AbjA1L15 (ORCPT ); Sat, 28 Jan 2023 06:27:57 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35396 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230110AbjA1L1z (ORCPT ); Sat, 28 Jan 2023 06:27:55 -0500 Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 8943586AB; Sat, 28 Jan 2023 03:27:50 -0800 (PST) Received: from uno.homenet.telecomitalia.it (host-212-171-97-20.pool212171.interbusiness.it [212.171.97.20]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id E00EB5A9; Sat, 28 Jan 2023 12:27:47 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1674905268; bh=TAW6i2myVpNO7kFpXLP5KznGOEQvjw3iGn708vIufk0=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=Vbyc6qRWeE1wDytx6Hmib7qoIjmPM7W7bppb2pE6Uxn5kvtkYvcpG2UTyLOhsqAYT WpTm3T2QtxjeSwKOazNdRY1u6xlw6R1DSRsVBct/Bck8Wfv8zROciiN9iJZ64/n/At EVDokccISULC0dtrEpdB2sTa+cwOi8OPt+FOIKJA= From: Jacopo Mondi To: chiranjeevi.rapolu@intel.com, luca@z3ntu.xyz, robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org Cc: laurent.pinchart@ideasonboard.com, sakari.ailus@iki.fi, mchehab@kernel.org, linux-media@vger.kernel.org, devicetree@vger.kernel.org, Jacopo Mondi Subject: [PATCH v6.1] media: dt-bindings: Add OV5670 Date: Sat, 28 Jan 2023 12:27:36 +0100 Message-Id: <20230128112736.8000-1-jacopo.mondi@ideasonboard.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230126165909.121302-2-jacopo.mondi@ideasonboard.com> References: <20230126165909.121302-2-jacopo.mondi@ideasonboard.com> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org Add the bindings documentation for Omnivision OV5670 image sensor. Signed-off-by: Jacopo Mondi Reviewed-by: Krzysztof Kozlowski --- v6->6.1 - Use additionalProperties: false for endpoint properties from video-interfaces.yaml - List 'remote-endpoint' among the accepted endpoint properties now that we use additionalProperties: false --- .../bindings/media/i2c/ovti,ov5670.yaml | 93 +++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 94 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/i2c/ovti,ov5670.yaml -- 2.39.0 diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov5670.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov5670.yaml new file mode 100644 index 000000000000..6e089fe1d613 --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov5670.yaml @@ -0,0 +1,93 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/i2c/ovti,ov5670.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Omnivision OV5670 5 Megapixels raw image sensor + +maintainers: + - Jacopo Mondi + +description: |- + The OV5670 is a 5 Megapixels raw image sensor which provides images in 10-bits + RAW BGGR Bayer format on a 2 data lanes MIPI CSI-2 serial interface and is + controlled through an I2C compatible control bus. + +properties: + compatible: + const: ovti,ov5670 + + reg: + maxItems: 1 + + clocks: + description: System clock. From 6 to 27 MHz. + maxItems: 1 + + powerdown-gpios: + description: Reference to the GPIO connected to the PWDNB pin. Active low. + + reset-gpios: + description: Reference to the GPIO connected to the XSHUTDOWN pin. Active low. + maxItems: 1 + + avdd-supply: + description: Analog circuit power. Typically 2.8V. + + dvdd-supply: + description: Digital circuit power. Typically 1.2V. + + dovdd-supply: + description: Digital I/O circuit power. Typically 2.8V or 1.8V. + + port: + $ref: /schemas/graph.yaml#/$defs/port-base + additionalProperties: false + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + additionalProperties: false + + properties: + data-lanes: + minItems: 1 + maxItems: 2 + items: + enum: [1, 2] + + clock-noncontinuous: true + remote-endpoint: true + +required: + - compatible + - reg + - clocks + - port + +additionalProperties: false + +examples: + - | + i2c { + #address-cells = <1>; + #size-cells = <0>; + + ov5670: sensor@36 { + compatible = "ovti,ov5670"; + reg = <0x36>; + + clocks = <&sensor_xclk>; + + port { + ov5670_ep: endpoint { + remote-endpoint = <&csi_ep>; + data-lanes = <1 2>; + clock-noncontinuous; + }; + }; + }; + }; + +... diff --git a/MAINTAINERS b/MAINTAINERS index f61eb221415b..38d8d1d5d536 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -15468,6 +15468,7 @@ M: Chiranjeevi Rapolu L: linux-media@vger.kernel.org S: Maintained T: git git://linuxtv.org/media_tree.git +F: Documentation/devicetree/bindings/media/i2c/ovti,ov5670.yaml F: drivers/media/i2c/ov5670.c OMNIVISION OV5675 SENSOR DRIVER