From patchwork Mon Dec 16 17:16:14 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Jacopo Mondi X-Patchwork-Id: 11294829 X-Patchwork-Delegate: kieran@bingham.xyz Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 7021C930 for ; Mon, 16 Dec 2019 17:14:20 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 4DCA720717 for ; Mon, 16 Dec 2019 17:14:20 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726637AbfLPROU (ORCPT ); Mon, 16 Dec 2019 12:14:20 -0500 Received: from relay2-d.mail.gandi.net ([217.70.183.194]:41705 "EHLO relay2-d.mail.gandi.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726427AbfLPROU (ORCPT ); Mon, 16 Dec 2019 12:14:20 -0500 X-Originating-IP: 2.224.242.101 Received: from uno.lan (2-224-242-101.ip172.fastwebnet.it [2.224.242.101]) (Authenticated sender: jacopo@jmondi.org) by relay2-d.mail.gandi.net (Postfix) with ESMTPSA id 3FE7040005; Mon, 16 Dec 2019 17:14:17 +0000 (UTC) From: Jacopo Mondi To: kieran.bingham+renesas@ideasonboard.com, laurent.pinchart@ideasonboard.com, niklas.soderlund@ragnatech.se Cc: Jacopo Mondi , linux-renesas-soc@vger.kernel.org Subject: [RFC 05/11] fixup! dt-bindings: media: i2c: Add bindings for IMI RDACM20 Date: Mon, 16 Dec 2019 18:16:14 +0100 Message-Id: <20191216171620.372683-6-jacopo+renesas@jmondi.org> X-Mailer: git-send-email 2.24.0 In-Reply-To: <20191216171620.372683-1-jacopo+renesas@jmondi.org> References: <20191216171620.372683-1-jacopo+renesas@jmondi.org> MIME-Version: 1.0 Sender: linux-renesas-soc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-renesas-soc@vger.kernel.org --- .../bindings/media/i2c/imi,rdacm20.txt | 66 ---------- .../bindings/media/i2c/imi,rdacm20.yaml | 113 ++++++++++++++++++ 2 files changed, 113 insertions(+), 66 deletions(-) delete mode 100644 Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt create mode 100644 Documentation/devicetree/bindings/media/i2c/imi,rdacm20.yaml diff --git a/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt b/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt deleted file mode 100644 index 4731aafed63f..000000000000 --- a/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt +++ /dev/null @@ -1,66 +0,0 @@ -IMI D&D RDACM20 Automotive Camera Platform ------------------------------------------- - -The IMI D&D RDACM20 is a GMSL-compatible camera designed for automotive -applications. It encloses a Maxim Integrated MAX9271 GMSL serializer, an -Omnivision OV10635 camera sensor and an embedded MCU, and connects to a remote -GMSL endpoint through a coaxial cable. - - IMI RDACM20 - --------------- -------------------------------- -| GMSL | <--- Video Stream | <- Video--------\ | -| |< ====== GMSL Link ======== >|MAX9271<- I2C bus-> <-->OV10635 | -| de-serializer | <--- I2C messages ---> | \<-->MCU | - --------------- -------------------------------- - -The RDACM20 transmits video data generated by the embedded camera sensor on the -GMSL serial channel to a remote GMSL de-serializer, as well as it receives and -transmits I2C messages encapsulated in the GMSL bidirectional control channel. - -All I2C traffic received on the GMSL link not directed to the serializer is -propagated on the local I2C bus to the embedded camera sensor and MCU. All -I2C traffic generated on the local I2C bus not directed to the serializer is -propagated to the remote de-serializer encapsulated in the GMSL control channel. - -The RDACM20 DT node should be a direct child of the GMSL Deserializer's I2C bus -corresponding to the GMSL link that the camera is attached to. - -Required Properties: - -- compatible: Shall be "imi,rdacm20". -- reg: I2C device addresses, the first to be assigned to the serializer - the second to be assigned to the camera sensor. An optional third address can - be provided to specify the MCU address if present. - -Connection to the remote GMSL endpoint are modelled using the OF graph bindings -in accordance with the video interface bindings defined in -Documentation/devicetree/bindings/media/video-interfaces.txt. - -The device node contains a single "port" child node with a single "endpoint" -sub-device. - -Required endpoint properties: - -- remote-endpoint: phandle to the remote GMSL endpoint sub-node in the remote - node port. - -Example: -------- - - i2c@0 { - #address-cells = <1>; - #size-cells = <0>; - reg = <0>; - - camera@51 { - compatible = "imi,rdacm20"; - reg = <0x31 0x41 0x51>; - - port { - rdacm20_out0: endpoint { - remote-endpoint = <&max9286_in0>; - }; - }; - - }; - }; diff --git a/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.yaml b/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.yaml new file mode 100644 index 000000000000..76740e285f44 --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.yaml @@ -0,0 +1,113 @@ +# SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause +# Copyright (C) 2019 Renesas Electronics Corp. +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/i2c/imi,rdacm20.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: IMI D&D RDACM20 Automotive Camera Platform + +maintainers: + - Jacopo Mondi + - Kieran Bingham + - Laurent Pinchart + - Niklas Söderlund + +description: -| + The IMI D&D RDACM20 is a GMSL-compatible camera designed for automotive + applications. It encloses a Maxim Integrated MAX9271 GMSL serializer, an + Omnivision OV10635 camera sensor and an embedded MCU, and connects to a remote + GMSL endpoint through a coaxial cable. + + IMI RDACM20 + +---------------+ +--------------------------------+ + | GMSL | <- Video Stream | <- Video--------\ | + | |< === GMSL Link ====== >|MAX9271<- I2C bus-> <-->OV10635 | + | de-serializer | <- I2C messages -> | \<-->MCU | + +---------------+ +--------------------------------+ + + The RDACM20 transmits video data generated by the embedded camera sensor on + the GMSL serial channel to a remote GMSL de-serializer, as well as it receives + and transmits I2C messages encapsulated in the GMSL bidirectional control + channel. + + All I2C traffic received on the GMSL link not directed to the serializer is + propagated on the local I2C bus to the embedded camera sensor and MCU. All I2C + traffic generated on the local I2C bus not directed to the serializer is + propagated to the remote de-serializer encapsulated in the GMSL control + channel. + + The RDACM20 DT node should be a direct child of the GMSL Deserializer's I2C + bus corresponding to the GMSL link that the camera is attached to. + +properties: + '#address-cells': + const: 1 + + '#size-cells': + const: 0 + + compatible: + const: imi,rdacm20 + + reg: + description: -| + I2C device addresses, the first to be assigned to the serializer the + second to be assigned to the camera sensor. An optional third address can + be provided to specify the MCU address if present. + minItems: 2 + maxItems: 3 + + port: + type: object + additionalProperties: false + description: -| + Connection to the remote GMSL endpoint are modelled using the OF graph + bindings in accordance with the video interface bindings defined in + Documentation/devicetree/bindings/media/video-interfaces.txt. + + The device node contains a single "port" child node with a single + "endpoint" sub-device. + + properties: + endpoint: + type: object + additionalProperties: false + + properties: + remote-endpoint: + description: -| + phandle to the remote GMSL endpoint sub-node in the remote node + port. + maxItems: 1 + + required: + - remote-endpoint + + required: + - endpoint + +required: + - compatible + - reg + - port + +examples: + - | + i2c@e66d8000 { + #address-cells = <1>; + #size-cells = <0>; + + reg = <0 0xe66d8000 0 0x40>; + + camera@31 { + compatible = "imi,rdacm20"; + reg = <0x31>, <0x41>, <0x51>; + + port { + rdacm20_out0: endpoint { + remote-endpoint = <&max9286_in0>; + }; + }; + }; + };