From patchwork Wed Jul 13 15:05:05 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tommaso Merciai X-Patchwork-Id: 2137 Return-Path: X-Original-To: linux-amarula@patchwork.amarulasolutions.com Delivered-To: linux-amarula@patchwork.amarulasolutions.com Received: from mail-wm1-f72.google.com (mail-wm1-f72.google.com [209.85.128.72]) by ganimede.amarulasolutions.com (Postfix) with ESMTPS id 75B723F1F7 for ; Wed, 13 Jul 2022 17:05:20 +0200 (CEST) Received: by mail-wm1-f72.google.com with SMTP id 130-20020a1c0288000000b003a2fe999093sf298993wmc.6 for ; Wed, 13 Jul 2022 08:05:20 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1657724720; cv=pass; d=google.com; s=arc-20160816; b=WqT2d7IVa7GmYFRGUlweZGR/KYcfrlu+IVKzqz84Jiqsk8bgbABq3V4T2+qXORDPAA 2HBs0wXRUWb87OgSJNFR1Tqk7vD/UJ4BCQNQgpGUsjHSeoa739S6T0dIKBOG+U248Ej4 rpETEUc00RakSSXJ5t46pATomuY1gTIUStp45ntSWGbsIBkD7gb1+2s8ZgYHldV2yPYe T4kwylY+5D1mwe45KJ6B+1bK3Innf+d9MBADgPeO33BBhBKVBur8tkxWvrSm5ZlpyKqN 72MLBsSCYo6wXP8IC91d6n3FJbXFgsz7DAM50zdBwunAJOK6fqV3CnxZFMAxjcEx+XNu 1+Cg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-archive:list-help:list-post:list-id :mailing-list:precedence:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=mYpgoldDgUlHl4c7sSfrQJTRPSsap1PkAgzkQiyT7i8=; b=Kx1sE/Mh5FtdlB4nHo65oFmhlDO4ax2nGxmo5DxMJuCrVoKCPVWUh3LeFs/1W1GsIj FQ8fIhT/sHyq16I4N80eQwJSvXUz8y1frXMjb8s2wh9r3myGi1SZ/3KJrWitBrBiORyG dYDoknRxA5mQtG6ERImrMHkbMn43F/tsIvdbmmyt630FsERMgXw0i9sNmjsvTCF+/KqY xjM+jXtaSagUgT6Kj6M9hAfgova9Ph8L04XpVj8Z+GLeX3+HyethwbSl/svp3ZtfL0CE nhR47DV+EFld6v6ESklQaSsz3UVF8h84Ic/1V8N7X9k5g6IWQkcOH5jYQyn7ncKUeYuf u0yA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=pWJ2mDSt; spf=pass (google.com: domain of tommaso.merciai@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=tommaso.merciai@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amarulasolutions.com; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-unsubscribe; bh=mYpgoldDgUlHl4c7sSfrQJTRPSsap1PkAgzkQiyT7i8=; b=P7q8pIFvP0oDZ/3Jm13ZjyyjNWRsGv8tjX4hLMajNemLvMqZOOx9CAdaKz9dQNds3M woEaQy9/XbyR/JwK/q+m1UUa/YjwexK7HfvGtdoYgWCbL8fkNekc4zemjOS/hyFuII0N JaTzbDi/5u7kbR5VzaIj+2TptomGrMpfjlIf0= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-unsubscribe; bh=mYpgoldDgUlHl4c7sSfrQJTRPSsap1PkAgzkQiyT7i8=; b=AOHya2raCgnoMCBqwuipkOSLcLaxdTZbMCMhNu5K69/ehntTE2PsR/2jiDmoO1+uRN yKPrWSFnyw7kQJ9A5ThV+9UJTKWWtjBRFR7Kgna0LEVl0xxvKt9dt68p3imDmt6rj3EB GhAehFx5UJxRz2JEk/hT5VzPp42H3OPzOGxB9bESEujeYlHyTjm2DQZTS6P6IlJd3O5+ zXKWiuUe5f18xmJLgQdTaSwSLIWnj6vUNMm3xV0a9xl+8f2AvntG+usD2PCFjPqohOaG jRfRShzWwtqz3n5awdeydQSkeq2JalSPuU2BpoO2BlWmBPO/YqeD8bQ7u6LJRBByQkp8 TS9A== X-Gm-Message-State: AJIora+AXrnfHTfSJmBOnVrO6vlMNaxpFWTklY+UkxmArnM2+K8Ru0sw YO2sbE78IsvF5b7sEw065C9XxTO/ X-Google-Smtp-Source: AGRyM1vrvSjowFR4xLPtl2HiFqBDl4juv4lSdtdOb5TTMjn/8P78gyOfSsOhXumKqhMheBq1fNjclA== X-Received: by 2002:adf:fc8d:0:b0:21d:9ba5:d2c1 with SMTP id g13-20020adffc8d000000b0021d9ba5d2c1mr3519611wrr.148.1657724720212; Wed, 13 Jul 2022 08:05:20 -0700 (PDT) X-BeenThere: linux-amarula@amarulasolutions.com Received: by 2002:a05:600c:34c6:b0:3a0:4f27:977f with SMTP id d6-20020a05600c34c600b003a04f27977fls3085162wmq.2.gmail; Wed, 13 Jul 2022 08:05:19 -0700 (PDT) X-Received: by 2002:adf:d1c2:0:b0:21d:b3a7:ffcf with SMTP id b2-20020adfd1c2000000b0021db3a7ffcfmr3556940wrd.523.1657724719038; Wed, 13 Jul 2022 08:05:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1657724719; cv=none; d=google.com; s=arc-20160816; b=O5m625kvD8VJGgudgIlt3/RuMU7i6vFMjDZxp6cABfEpRWuwZVrRFur/a7PUMyocJR vVT1X2QWLA9Ou6ihjJGltL68cW56iZBbiw5J0cAv/qcZgeB5zzwhbKvSX1uIXu3OgWlv OYr415wZJfJd2S6+gkI7jsuV+oRlDgxZ15LvT82oYUvRSli81krHEb5jZzilq/SI/YKV xfGPPhQUMB22AyXeQgtQLkyDSvkBGUAvXAixWp/ena42jHBTm2w+Cyl5zIJq7i/xAIP+ YhHIGX/7qCNHO/Js2v0nWKz3JOLYkuzRnra3zBk7jZninA3vx7LD5Ejh4KpuRaF9IuwA 7+3w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:dkim-signature; bh=SFLYTnxGltOS1OadQL4iHNlIKerC7uXMw8HZbX2h5Bw=; b=HI7/h+M4q6aSmdNCfZKd6isQ2hefvG3unMLPixuZBZkeajp+sUjtLmQzYVe4nxAB1J jfFnulNiTn7xRSuxP2gKHbqSVlOcvczcyX07vApGAQCb1Fo1ZlqFHmPmGYgW13ShxpbB IbaahiNbPFvI20uTNfVTAXVgKInzqOFCJAqCA4d4COB8Qn1P7EextWN2UHJfggYVj8nh W3WT3Bjnt05wA2v8xl+7MZ5scgFvQ1/c1+PrEZYqlvNgxH2sIuSwDiprlqhHKsj5hGdL CwoBSqLwhQKldX3GqG7wTbWavJCh7d/0tHriavMfZ7wggaxFDs71cIXSeQxN3RjPeqOP 2/cw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=pWJ2mDSt; spf=pass (google.com: domain of tommaso.merciai@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=tommaso.merciai@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com Received: from mail-sor-f41.google.com (mail-sor-f41.google.com. [209.85.220.41]) by mx.google.com with SMTPS id ib6-20020a05600ca14600b003a12e4d1e2csor621377wmb.43.2022.07.13.08.05.19 for (Google Transport Security); Wed, 13 Jul 2022 08:05:19 -0700 (PDT) Received-SPF: pass (google.com: domain of tommaso.merciai@amarulasolutions.com designates 209.85.220.41 as permitted sender) client-ip=209.85.220.41; X-Received: by 2002:a1c:a1c7:0:b0:3a2:f171:8d68 with SMTP id k190-20020a1ca1c7000000b003a2f1718d68mr4139777wme.111.1657724718777; Wed, 13 Jul 2022 08:05:18 -0700 (PDT) Received: from tom-ThinkPad-T14s-Gen-2i.station (net-188-217-51-7.cust.vodafonedsl.it. [188.217.51.7]) by smtp.gmail.com with ESMTPSA id f17-20020a05600c4e9100b003a2d87aea57sm1465537wmq.10.2022.07.13.08.05.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Jul 2022 08:05:18 -0700 (PDT) From: Tommaso Merciai To: tommaso.merciai@amarulasolutions.com Cc: linuxfancy@googlegroups.com, linux-amarula@amarulasolutions.com, quentin.schulz@theobroma-systems.com, Krzysztof Kozlowski , Daniel Scally , Mauro Carvalho Chehab , Rob Herring , Krzysztof Kozlowski , linux-media@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH v7 5/6] media: dt-bindings: ov5693: document YAML binding Date: Wed, 13 Jul 2022 17:05:05 +0200 Message-Id: <20220713150506.2085214-6-tommaso.merciai@amarulasolutions.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220713150506.2085214-1-tommaso.merciai@amarulasolutions.com> References: <20220713150506.2085214-1-tommaso.merciai@amarulasolutions.com> MIME-Version: 1.0 X-Original-Sender: tommaso.merciai@amarulasolutions.com X-Original-Authentication-Results: mx.google.com; dkim=pass header.i=@amarulasolutions.com header.s=google header.b=pWJ2mDSt; spf=pass (google.com: domain of tommaso.merciai@amarulasolutions.com designates 209.85.220.41 as permitted sender) smtp.mailfrom=tommaso.merciai@amarulasolutions.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=amarulasolutions.com Content-Type: text/plain; charset="UTF-8" Precedence: list Mailing-list: list linux-amarula@amarulasolutions.com; contact linux-amarula+owners@amarulasolutions.com List-ID: X-Spam-Checked-In-Group: linux-amarula@amarulasolutions.com X-Google-Group-Id: 476853432473 List-Post: , List-Help: , List-Archive: List-Unsubscribe: , Add documentation of device tree in YAML schema for the OV5693 CMOS image sensor from Omnivision Signed-off-by: Tommaso Merciai Reviewed-by: Krzysztof Kozlowski --- Changes since v1: - Fix allOf position as suggested by Krzysztof - Remove port description as suggested by Krzysztof - Fix EOF as suggested by Krzysztof Changes since v2: - Fix commit body as suggested by Krzysztof Changes since v3: - Add reviewed-by tags, suggested by Jacopo, Krzysztof Changes since v4: - Remove wrong Sakari reviewed-by tag, suggested by Krzysztof, Sakari Changes since v5: - Remove dovdd-supply, avdd-supply, dvdd-supply from required properties as suggested by Jacopo Changes since v6: - Add missing port node as suggested by Sakari, Rob bot .../bindings/media/i2c/ovti,ov5693.yaml | 124 ++++++++++++++++++ MAINTAINERS | 1 + 2 files changed, 125 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/i2c/ovti,ov5693.yaml diff --git a/Documentation/devicetree/bindings/media/i2c/ovti,ov5693.yaml b/Documentation/devicetree/bindings/media/i2c/ovti,ov5693.yaml new file mode 100644 index 000000000000..359dc08440a8 --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/ovti,ov5693.yaml @@ -0,0 +1,124 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright (c) 2022 Amarulasolutions +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/i2c/ovti,ov5693.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Omnivision OV5693 CMOS Sensor + +maintainers: + - Tommaso Merciai + +description: | + The Omnivision OV5693 is a high performance, 1/4-inch, 5 megapixel, CMOS + image sensor that delivers 2592x1944 at 30fps. It provides full-frame, + sub-sampled, and windowed 10-bit MIPI images in various formats via the + Serial Camera Control Bus (SCCB) interface. + + OV5693 is controlled via I2C and two-wire Serial Camera Control Bus (SCCB). + The sensor output is available via CSI-2 serial data output (up to 2-lane). + +allOf: + - $ref: /schemas/media/video-interface-devices.yaml# + +properties: + compatible: + const: ovti,ov5693 + + reg: + maxItems: 1 + + clocks: + description: + System input clock (aka XVCLK). From 6 to 27 MHz. + maxItems: 1 + + dovdd-supply: + description: + Digital I/O voltage supply, 1.8V. + + avdd-supply: + description: + Analog voltage supply, 2.8V. + + dvdd-supply: + description: + Digital core voltage supply, 1.2V. + + reset-gpios: + description: + The phandle and specifier for the GPIO that controls sensor reset. + This corresponds to the hardware pin XSHUTDN which is physically + active low. + maxItems: 1 + + port: + description: MIPI CSI-2 transmitter port + $ref: /schemas/graph.yaml#/$defs/port-base + additionalProperties: false + + properties: + endpoint: + $ref: /schemas/media/video-interfaces.yaml# + unevaluatedProperties: false + + properties: + link-frequencies: true + + data-lanes: + minItems: 1 + maxItems: 2 + + required: + - data-lanes + - link-frequencies + +required: + - compatible + - reg + - clocks + - port + +unevaluatedProperties: false + +examples: + - | + #include + #include + #include + + i2c { + #address-cells = <1>; + #size-cells = <0>; + + ov5693: camera@36 { + compatible = "ovti,ov5693"; + reg = <0x36>; + + reset-gpios = <&gpio2 RK_PB1 GPIO_ACTIVE_LOW>; + pinctrl-names = "default"; + pinctrl-0 = <&cif_clkout_m0>; + + clocks = <&cru SCLK_CIF_OUT>; + assigned-clocks = <&cru SCLK_CIF_OUT>; + assigned-clock-rates = <19200000>; + + avdd-supply = <&vcc_1v8>; + dvdd-supply = <&vcc_1v2>; + dovdd-supply = <&vcc_2v8>; + + rotation = <90>; + orientation = <0>; + + port { + ucam_out: endpoint { + remote-endpoint = <&mipi_in_ucam>; + data-lanes = <1 2>; + link-frequencies = /bits/ 64 <450000000>; + }; + }; + }; + }; + +... diff --git a/MAINTAINERS b/MAINTAINERS index f679152bdbad..61c2d28aff4f 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -14838,6 +14838,7 @@ M: Daniel Scally L: linux-media@vger.kernel.org S: Maintained T: git git://linuxtv.org/media_tree.git +F: Documentation/devicetree/bindings/media/i2c/ovti,ov5693.yaml F: drivers/media/i2c/ov5693.c OMNIVISION OV5695 SENSOR DRIVER