From patchwork Fri Apr 24 01:34:18 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 11506927 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 6554C913 for ; Fri, 24 Apr 2020 01:34:56 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 4E64E2074F for ; Fri, 24 Apr 2020 01:34:56 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="R2aPi2Za" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726152AbgDXBez (ORCPT ); Thu, 23 Apr 2020 21:34:55 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34916 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-FAIL-OK-FAIL) by vger.kernel.org with ESMTP id S1726127AbgDXBez (ORCPT ); Thu, 23 Apr 2020 21:34:55 -0400 Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 10DFDC09B042 for ; Thu, 23 Apr 2020 18:34:55 -0700 (PDT) Received: from pendragon.bb.dnainternet.fi (81-175-216-236.bb.dnainternet.fi [81.175.216.236]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 966B2134B; Fri, 24 Apr 2020 03:34:51 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1587692091; bh=dkYtlCRVNSZRWandxSnugeev2fN87AO1Q4xcgIhzCU4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=R2aPi2Za+sTA5t7feZwFmSE8oMQVJvI39jb281O8Vs+FicX0NrC/eV/25Uu+8J8ZQ oEh8QC6L4IeIr00jKZJ9uKfX7Tg8nSxjIXtrV2ETlvABdWDcXmzPBAAG7269WjDLVB rdLNI1as2yPpdT1sBdXID3AnzHB3YXq8RddYzwdg= From: Laurent Pinchart To: linux-media@vger.kernel.org Cc: Dave Stevenson , Naushir Patuck Subject: [PATCH 4/5] dt-bindings: media: Document BCM283x CSI2/CCP2 receiver Date: Fri, 24 Apr 2020 04:34:18 +0300 Message-Id: <20200424013419.12954-5-laurent.pinchart@ideasonboard.com> X-Mailer: git-send-email 2.25.3 In-Reply-To: <20200424013419.12954-1-laurent.pinchart@ideasonboard.com> References: <20200424013419.12954-1-laurent.pinchart@ideasonboard.com> MIME-Version: 1.0 Sender: linux-media-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-media@vger.kernel.org From: Dave Stevenson Document the DT bindings for the CSI2/CCP2 receiver peripheral (known as Unicam) on BCM283x SoCs. Signed-off-by: Dave Stevenson Signed-off-by: Laurent Pinchart --- .../bindings/media/brcm,bcm2835-unicam.yaml | 155 ++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 Documentation/devicetree/bindings/media/brcm,bcm2835-unicam.yaml diff --git a/Documentation/devicetree/bindings/media/brcm,bcm2835-unicam.yaml b/Documentation/devicetree/bindings/media/brcm,bcm2835-unicam.yaml new file mode 100644 index 000000000000..6ffc900e8ae8 --- /dev/null +++ b/Documentation/devicetree/bindings/media/brcm,bcm2835-unicam.yaml @@ -0,0 +1,155 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright (C) 2020 Raspberry Pi (Trading) Ltd. +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/media/brcm,bcm2835-unicam.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Broadcom BCM283x Camera Interface (Unicam) + +maintainers: + - Dave Stevenson + - Raspberry Pi kernel list + +description: + The Unicam block on BCM283x SoCs is the receiver for either CSI-2 or CCP2 + data from image sensors or similar devices. + + The main platform using this SoC is the Raspberry Pi family of boards. On the + Pi the VideoCore firmware can also control this hardware block, and driving + it from two different processors will cause issues. To avoid this, the + firmware checks the device tree configuration during boot. If it finds device + tree nodes whose name starts with "csi" then it will stop the firmware + accessing the block, and it can then safely be used via the device tree + binding. + +properties: + compatible: + const: brcm,bcm2835-unicam + + reg: + items: + - description: Main registers block + - description: Clock registers block + + interrupts: + maxItems: 1 + + clocks: + minItems: 1 + maxItems: 2 + + clock-names: + minItems: 1 + items: + - const: lp + - const: core + + power-domains: + maxItems: 1 + + brcm,num-data-lanes: + description: + The number of data lanes supported by this Unicam instance. It may be + larger than the number of data lanes routed on the board, as described by + the data-lanes property of the endpoint. + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32" + - enum: [1, 2, 4] + + port: + type: object + description: + Input port node, as described in video-interfaces.txt. + + properties: + endpoint: + type: object + + properties: + clock-lanes: + items: + - const: 0 + + data-lanes: + description: + Lane reordering is not supported, items shall be in order, + starting at 1. + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32-array" + - maxItems: 1 + items: + minItems: 1 + maxItems: 4 + items: + - const: 1 + - const: 2 + - const: 3 + - const: 4 + + lane-polarities: + description: + Lane inversion is not supported. If the property is specified, it + shall contain all 0's. + allOf: + - $ref: "/schemas/types.yaml#/definitions/uint32-array" + - maxItems: 1 + items: + minItems: 2 + maxItems: 5 + items: + - const: 0 + - const: 0 + - const: 0 + - const: 0 + - const: 0 + + remote-endpoint: true + + required: + - data-lanes + - remote-endpoint + + additionalProperties: false + + required: + - endpoint + + additionalProperties: false + +required: + - compatible + - reg + - interrupts + - clocks + - clock-names + - power-domains + - brcm,num-data-lanes + - port + +additionalProperties: false + +examples: + - | + #include + #include + #include + + csi@7e801000 { + compatible = "brcm,bcm2835-unicam"; + reg = <0x7e801000 0x800>, + <0x7e802004 0x4>; + interrupts = <2 7>; + clocks = <&clocks BCM2835_CLOCK_CAM1>; + clock-names = "lp"; + power-domains = <&power RPI_POWER_DOMAIN_UNICAM1>; + brcm,num-data-lanes = <4>; + + port { + csi1_ep: endpoint { + remote-endpoint = <&imx219_0>; + data-lanes = <1 2>; + }; + }; + }; +...