From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-8.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_PASS,URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id E168FC65C22 for ; Fri, 2 Nov 2018 15:47:36 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id A8C312081F for ; Fri, 2 Nov 2018 15:47:36 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="cGaGXFPL" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org A8C312081F Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=ideasonboard.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728015AbeKCAzE (ORCPT ); Fri, 2 Nov 2018 20:55:04 -0400 Received: from perceval.ideasonboard.com ([213.167.242.64]:47888 "EHLO perceval.ideasonboard.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727277AbeKCAzE (ORCPT ); Fri, 2 Nov 2018 20:55:04 -0400 Received: from localhost.localdomain (cpc89242-aztw30-2-0-cust488.18-1.cable.virginm.net [86.31.129.233]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 492F01ACE; Fri, 2 Nov 2018 16:47:29 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1541173649; bh=nCv3jmOV1FbrdSGmFfK28B2KPbD9DHQOkCIJ+eoaqW4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=cGaGXFPLa6MvOwCXAnFTsZXelfChlAgJ9sfGgLpWlw10efD8DR7yXctypbg+IETI4 c2k52YBZmxc6FyChkTFMBYHS+0Wtyssj0XSkk20r5HBbNSAzjq8vOcPkWEO6VSnwRc Fq3Nt6aHhZcrx1n6c5yzNhYNnk//ILJvt/1Z4hVw= From: Kieran Bingham To: linux-renesas-soc@vger.kernel.org, linux-media@vger.kernel.org, devicetree@vger.kernel.org, sakari.ailus@iki.fi Cc: =?UTF-8?q?Niklas=20S=C3=B6derlund?= , Jacopo Mondi , Laurent Pinchart , Kieran Bingham , linux-kernel@vger.kernel.org, Jacopo Mondi Subject: [PATCH v4 2/4] dt-bindings: media: i2c: Add bindings for IMI RDACM20 Date: Fri, 2 Nov 2018 15:47:21 +0000 Message-Id: <20181102154723.23662-3-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20181102154723.23662-1-kieran.bingham@ideasonboard.com> References: <20181102154723.23662-1-kieran.bingham@ideasonboard.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Jacopo Mondi The IMI RDACM20 is a Gigabit Multimedia Serial Link (GMSL) camera capable of transmitting video and I2C control messages on a coax cable physical link for automotive applications. Document its device tree binding interface. Signed-off-by: Jacopo Mondi Signed-off-by: Kieran Bingham Reviewed-by: Laurent Pinchart --- v2: - Provide imi vendor prefix - Fix minor spelling v3: - update binding descriptions --- .../bindings/media/i2c/imi,rdacm20.txt | 65 +++++++++++++++++++ .../devicetree/bindings/vendor-prefixes.txt | 1 + 2 files changed, 66 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt diff --git a/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt b/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt new file mode 100644 index 000000000000..23915da4c3bf --- /dev/null +++ b/Documentation/devicetree/bindings/media/i2c/imi,rdacm20.txt @@ -0,0 +1,65 @@ +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: Pair of I2C device addresses, the first to be assigned to the serializer + the second to be assigned to the camera sensor. + +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 = <0x51 0x61>; + + port { + rdacm20_out0: endpoint { + remote-endpoint = <&max9286_in0>; + }; + }; + + }; + }; diff --git a/Documentation/devicetree/bindings/vendor-prefixes.txt b/Documentation/devicetree/bindings/vendor-prefixes.txt index 2c3fc512e746..34b0ed876850 100644 --- a/Documentation/devicetree/bindings/vendor-prefixes.txt +++ b/Documentation/devicetree/bindings/vendor-prefixes.txt @@ -171,6 +171,7 @@ idt Integrated Device Technologies, Inc. ifi Ingenieurburo Fur Ic-Technologie (I/F/I) ilitek ILI Technology Corporation (ILITEK) img Imagination Technologies Ltd. +imi Integrated Micro-Electronics Inc. infineon Infineon Technologies inforce Inforce Computing ingenic Ingenic Semiconductor -- 2.17.1