{"id":816332,"url":"http://patchwork.ozlabs.org/api/patches/816332/?format=json","web_url":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/fae3d29bba67825030c0077dd9c79534b6888512.1505916622.git.dave.stevenson@raspberrypi.org/","project":{"id":37,"url":"http://patchwork.ozlabs.org/api/projects/37/?format=json","name":"Devicetree Bindings","link_name":"devicetree-bindings","list_id":"devicetree.vger.kernel.org","list_email":"devicetree@vger.kernel.org","web_url":"","scm_url":"","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"","list_archive_url":null,"date":"2017-09-20T16:07:55","name":"[v3,2/4,media] dt-bindings: Document BCM283x CSI2/CCP2 receiver","commit_ref":null,"pull_url":null,"state":"changes-requested","archived":true,"hash":"2f31899400f83274ad664a72495a1848c007e9ba","submitter":{"id":72357,"url":"http://patchwork.ozlabs.org/api/people/72357/?format=json","name":"Dave Stevenson","email":"dave.stevenson@raspberrypi.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/fae3d29bba67825030c0077dd9c79534b6888512.1505916622.git.dave.stevenson@raspberrypi.org/mbox/","series":[{"id":4160,"url":"http://patchwork.ozlabs.org/api/series/4160/?format=json","web_url":"http://patchwork.ozlabs.org/project/devicetree-bindings/list/?series=4160","date":"2017-09-20T16:07:53","name":"BCM283x Camera Receiver driver","version":3,"mbox":"http://patchwork.ozlabs.org/series/4160/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/816332/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/816332/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming-dt@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming-dt@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=none (mailfrom) smtp.mailfrom=vger.kernel.org\n\t(client-ip=209.132.180.67; helo=vger.kernel.org;\n\tenvelope-from=devicetree-owner@vger.kernel.org; receiver=)","ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tsecure) header.d=raspberrypi.org header.i=@raspberrypi.org\n\theader.b=\"tEp7RHBg\"; \n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=raspberrypi-org.20150623.gappssmtp.com\n\theader.i=@raspberrypi-org.20150623.gappssmtp.com header.b=\"Lo7KzYza\"; \n\tdkim-atps=neutral"],"Received":["from vger.kernel.org (vger.kernel.org [209.132.180.67])\n\tby ozlabs.org (Postfix) with ESMTP id 3xy4Rg05z9z9s7c\n\tfor ;\n\tThu, 21 Sep 2017 02:08:47 +1000 (AEST)","(majordomo@vger.kernel.org) by vger.kernel.org via listexpand\n\tid S1751823AbdITQIq (ORCPT\n\t);\n\tWed, 20 Sep 2017 12:08:46 -0400","from mx08-00252a01.pphosted.com ([91.207.212.211]:41828 \"EHLO\n\tmx08-00252a01.pphosted.com\" rhost-flags-OK-OK-OK-OK)\n\tby vger.kernel.org with ESMTP id S1751813AbdITQIo (ORCPT\n\t); Wed, 20 Sep 2017 12:08:44 -0400","from pps.filterd (m0102629.ppops.net [127.0.0.1])\n\tby mx08-00252a01.pphosted.com (8.16.0.21/8.16.0.21) with SMTP id\n\tv8KG8Wh4006768\n\tfor ; Wed, 20 Sep 2017 17:08:43 +0100","from mail-wm0-f72.google.com (mail-wm0-f72.google.com\n\t[74.125.82.72])\n\tby mx08-00252a01.pphosted.com with ESMTP id 2d0reg260r-1\n\t(version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128\n\tverify=OK)\n\tfor ; Wed, 20 Sep 2017 17:08:43 +0100","by mail-wm0-f72.google.com with SMTP id m127so3266587wmm.3\n\tfor ;\n\tWed, 20 Sep 2017 09:08:43 -0700 (PDT)","from dave-VirtualBox.pitowers.org ([217.33.127.173])\n\tby smtp.googlemail.com with ESMTPSA id\n\tp15sm1937467wmi.2.2017.09.20.09.08.41\n\t(version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128);\n\tWed, 20 Sep 2017 09:08:42 -0700 (PDT)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/relaxed; d=raspberrypi.org;\n\th=from : to : cc :\n\tsubject : date : message-id : in-reply-to : references : in-reply-to\n\t:\n\treferences; s=pp; bh=lfPIlJ03XB/Fn5G9rnrHV4Fk11TTZiWkqgzo7w6fKow=;\n\tb=tEp7RHBg00CFxsF8GoARBHQ6Cs/nse0/I0ZrM+GhQ7UkFb5hkHMYk8zt1OSNxb9BycFm\n\tF7up4XRQ2PT33ALEcpkR7Z5iIYk3xvlqIFhv4a9Y9Z+/25kXzzT/pw4ltx7wAtYQIJzq\n\tRxlcvQQl6whGshnUJzBQIa4Q0iEI9xzjG5sOvgVp93nFp2nLK6B8/AcYDjqe694t0cek\n\trdZnlTQ/+/cLMhWpXpKVrwui0PmEOwqdStv8Bb7+y1Wj9/2wIY59QgZtimDojIsEGTPb\n\to7nLCL7Bw5CkpOrOuBSe9lgSiB0Tss97x3KyuPh+zpVRn7GqSI+5rsjw+uwKnZqnZVYL\n\tyQ== ","v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=raspberrypi-org.20150623.gappssmtp.com; s=20150623;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:in-reply-to:references;\n\tbh=lfPIlJ03XB/Fn5G9rnrHV4Fk11TTZiWkqgzo7w6fKow=;\n\tb=Lo7KzYzaEbMvrLg09oyz8vrEhl40nk/XkTB+j08XLzzJ8rJ1Y5R7iVCCVqZhNyQfBo\n\t1bGP/xlX3hW8H0PJKjPVX2gBvP5wqvsp3LfwG5EvMYc8Y6xrjFqhS8YwlNNKApFO92UK\n\tQL5z0uck33mPKvBNdD2YApA7JNgm/mSCdkMuZrn2MK0l2VwDHfSXPOUzuDPnSypTfFzq\n\tJqGPQtZpu9jLCct73snJRu98WZ42kOUsE+6Ovk6+fJEyfVqp6kIZnurt14//H3SKAiQ6\n\tb+aUMbfDLGj0zTHyrwItF3+5q5wDv5V3DPvpktnfxL77KY1zIARJZzJEmRY1sq0a6xOV\n\ttHUA=="],"X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references:in-reply-to:references;\n\tbh=lfPIlJ03XB/Fn5G9rnrHV4Fk11TTZiWkqgzo7w6fKow=;\n\tb=FqxUx+3hABeL9vuM32hmF4iEV+2y36fgJHi4B0ur7GQIW4zE8SQt0RtzQhVa8lkAz8\n\tCmT7S/SAknY+vdXkWXYkfb24U/iYCJBF1uvjnuQlvOD9tP8OltU/7rSwbG7fKK+EnKkP\n\tXABe+E0fgJ31CTRCsXSBLjuF30oA906G5ejWp4oIlem3cRM0o9pXdcc9BoOe16KCOz1v\n\tT9GEhlZlkyhQS67eDl4o6mky1M7SBizIQFj56VJoefYdNzD+NjsjNhr2gJZurbng/LJF\n\tv3yQ1kUX0ygtsDddaIAy0ent9PpkATAACzQSYUlB29V/+5WRN8tvpqq/wLNYdRK0zjIu\n\tBIMw==","X-Gm-Message-State":"AHPjjUg4+4/C8mQH3VAsM9lOjEFu9Jfc3drdS9Ii36OnExd60tR2SktA\n\tVwY3kdpGGqq03J0nrILWtqFVF4U+QsdAvN+9vC1usaPyPNEDX2lxOFji7e2PWeZiCt+6wOS3mOY\n\t6X2aSKjzRHOsZwV6bO0r8","X-Received":["by 10.28.57.215 with SMTP id g206mr4756028wma.117.1505923723022; \n\tWed, 20 Sep 2017 09:08:43 -0700 (PDT)","by 10.28.57.215 with SMTP id g206mr4756021wma.117.1505923722772; \n\tWed, 20 Sep 2017 09:08:42 -0700 (PDT)"],"X-Google-Smtp-Source":"AOwi7QC8IC69gr2U9RLnDtpSIEG/wcnO7Cr7M1RQBkPwl6yhmeHONgn63qjZ8WgPaZA1Ab1SjrdpTg==","From":"Dave Stevenson ","To":"Mauro Carvalho Chehab ,\n\tRob Herring , Hans Verkuil , \n\tEric Anholt , Stefan Wahren ,\n\tSakari Ailus ,\n\tlinux-media@vger.kernel.org, linux-rpi-kernel@lists.infradead.org,\n\tdevicetree@vger.kernel.org","Cc":"Dave Stevenson ","Subject":"[PATCH v3 2/4] [media] dt-bindings: Document BCM283x CSI2/CCP2\n\treceiver","Date":"Wed, 20 Sep 2017 17:07:55 +0100","Message-Id":"","X-Mailer":"git-send-email 2.7.4","In-Reply-To":["",""],"References":["",""],"X-Proofpoint-Virus-Version":"vendor=fsecure engine=2.50.10432:, ,\n\tdefinitions=2017-09-20_04:, , signatures=0","X-Proofpoint-Spam-Details":"rule=outbound_spam_notspam policy=outbound_spam\n\tscore=0 priorityscore=1501\n\tmalwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0\n\tclxscore=1015 lowpriorityscore=0 impostorscore=0 adultscore=0\n\tclassifier=spam adjust=0 reason=mlx scancount=1\n\tengine=8.0.1-1707230000\n\tdefinitions=main-1709200217","Sender":"devicetree-owner@vger.kernel.org","Precedence":"bulk","List-ID":"","X-Mailing-List":"devicetree@vger.kernel.org"},"content":"Document the DT bindings for the CSI2/CCP2 receiver peripheral\n(known as Unicam) on BCM283x SoCs.\n\nSigned-off-by: Dave Stevenson \n---\n\nChanges since v2\n- Removed all references to Linux drivers.\n- Reworded section about disabling the firmware driver.\n- Renamed clock from \"lp_clock\" to \"lp\" in description and example.\n- Referred to video-interfaces.txt and stated requirements on remote-endpoint\n and data-lanes.\n- Corrected typo in example from csi to csi1.\n- Removed unnecessary #address-cells and #size-cells in example.\n- Removed setting of status from the example.\n\n .../devicetree/bindings/media/bcm2835-unicam.txt | 85 ++++++++++++++++++++++\n 1 file changed, 85 insertions(+)\n create mode 100644 Documentation/devicetree/bindings/media/bcm2835-unicam.txt","diff":"diff --git a/Documentation/devicetree/bindings/media/bcm2835-unicam.txt b/Documentation/devicetree/bindings/media/bcm2835-unicam.txt\nnew file mode 100644\nindex 0000000..7714fb3\n--- /dev/null\n+++ b/Documentation/devicetree/bindings/media/bcm2835-unicam.txt\n@@ -0,0 +1,85 @@\n+Broadcom BCM283x Camera Interface (Unicam)\n+------------------------------------------\n+\n+The Unicam block on BCM283x SoCs is the receiver for either\n+CSI-2 or CCP2 data from image sensors or similar devices.\n+\n+The main platform using this SoC is the Raspberry Pi family of boards.\n+On the Pi the VideoCore firmware can also control this hardware block,\n+and driving it from two different processors will cause issues.\n+To avoid this, the firmware checks the device tree configuration\n+during boot. If it finds device tree nodes called csi0 or csi1 then\n+it will stop the firmware accessing the block, and it can then\n+safely be used via the device tree binding.\n+\n+Required properties:\n+===================\n+- compatible\t: must be \"brcm,bcm2835-unicam\".\n+- reg\t\t: physical base address and length of the register sets for the\n+\t\t device.\n+- interrupts\t: should contain the IRQ line for this Unicam instance.\n+- clocks\t: list of clock specifiers, corresponding to entries in\n+\t\t clock-names property.\n+- clock-names\t: must contain an \"lp\" entry, matching entries in the\n+\t\t clocks property.\n+\n+Unicam supports a single port node. It should contain one 'port' child node\n+with child 'endpoint' node. Please refer to the bindings defined in\n+Documentation/devicetree/bindings/media/video-interfaces.txt.\n+\n+Within the endpoint node the \"remote-endpoint\" and \"data-lanes\" properties\n+are mandatory.\n+Data lane reordering is not supported so the data lanes must be in order,\n+starting at 1. The number of data lanes should represent the number of\n+usable lanes for the hardware block. That may be limited by either the SoC or\n+how the platform presents the interface, and the lower value must be used.\n+\n+Lane reordering is not supported on the clock lane either, so the optional\n+property \"clock-lane\" will implicitly be <0>.\n+Similarly lane inversion is not supported, therefore \"lane-polarities\" will\n+implicitly be <0 0 0 0 0>.\n+Neither of these values will be checked.\n+\n+Example:\n+\tcsi1: csi1@7e801000 {\n+\t\tcompatible = \"brcm,bcm2835-unicam\";\n+\t\treg = <0x7e801000 0x800>,\n+\t\t <0x7e802004 0x4>;\n+\t\tinterrupts = <2 7>;\n+\t\tclocks = <&clocks BCM2835_CLOCK_CAM1>;\n+\t\tclock-names = \"lp\";\n+\n+\t\tport {\n+\t\t\tcsi1_ep: endpoint {\n+\t\t\t\tremote-endpoint = <&tc358743_0>;\n+\t\t\t\tdata-lanes = <1 2>;\n+\t\t\t};\n+\t\t};\n+\t};\n+\n+\ti2c0: i2c@7e205000 {\n+\t\ttc358743: csi-hdmi-bridge@0f {\n+\t\t\tcompatible = \"toshiba,tc358743\";\n+\t\t\treg = <0x0f>;\n+\n+\t\t\tclocks = <&tc358743_clk>;\n+\t\t\tclock-names = \"refclk\";\n+\n+\t\t\ttc358743_clk: bridge-clk {\n+\t\t\t\tcompatible = \"fixed-clock\";\n+\t\t\t\t#clock-cells = <0>;\n+\t\t\t\tclock-frequency = <27000000>;\n+\t\t\t};\n+\n+\t\t\tport {\n+\t\t\t\ttc358743_0: endpoint {\n+\t\t\t\t\tremote-endpoint = <&csi1_ep>;\n+\t\t\t\t\tclock-lanes = <0>;\n+\t\t\t\t\tdata-lanes = <1 2>;\n+\t\t\t\t\tclock-noncontinuous;\n+\t\t\t\t\tlink-frequencies =\n+\t\t\t\t\t\t/bits/ 64 <297000000>;\n+\t\t\t\t};\n+\t\t\t};\n+\t\t};\n+\t};\n","prefixes":["v3","2/4","media"]}