From patchwork Mon May 18 20:33:15 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sergei Shtylyov X-Patchwork-Id: 200393 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=-5.3 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI, SIGNED_OFF_BY, SPF_HELO_NONE, SPF_PASS,USER_AGENT_SANE_1 autolearn=unavailable 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 CDFEDC433E0 for ; Mon, 18 May 2020 20:33:19 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id A89BF20835 for ; Mon, 18 May 2020 20:33:19 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=cogentembedded-com.20150623.gappssmtp.com header.i=@cogentembedded-com.20150623.gappssmtp.com header.b="Z9kyWJ0b" Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726349AbgERUdT (ORCPT ); Mon, 18 May 2020 16:33:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:58502 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726250AbgERUdS (ORCPT ); Mon, 18 May 2020 16:33:18 -0400 Received: from mail-lj1-x244.google.com (mail-lj1-x244.google.com [IPv6:2a00:1450:4864:20::244]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7619EC061A0C for ; Mon, 18 May 2020 13:33:18 -0700 (PDT) Received: by mail-lj1-x244.google.com with SMTP id z18so3101934lji.12 for ; Mon, 18 May 2020 13:33:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cogentembedded-com.20150623.gappssmtp.com; s=20150623; h=subject:from:to:cc:references:organization:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=liHKqxPDfHVVAMe49jNM18y8LkLl/eTVodLyOf08iew=; b=Z9kyWJ0bCSMgkNVQNprs0p9ElBUZMWunXXKovi1gCeePt63EGFWNOTIXJNiK7RxICM pYnXnqFK6CCyk7o8AgTlQr2X866t+Cb6InifE37VtBOmN9CWjjJ1uAfEiveCErasJyXc KDlmX2WTwI0FXaadpDBfy/v759Oo/Ya2xcUs34N/Nj84R/zYQFXEP/bwJAiL4Qwt82gL rFjKt6XPCaYRb5LR8Ng1T5c4uEsKgxbl/5Au5rHAwQGt5CBhJOpM+tg2FE+cshWVl3/R WdVSSHY4q4XwdCnIr2VVD1aXsfqS+CZcEqPCRXISnKU0ojZH6QRH/YALN6/9kVZfM/RB D4OQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:from:to:cc:references:organization :message-id:date:user-agent:mime-version:in-reply-to :content-language:content-transfer-encoding; bh=liHKqxPDfHVVAMe49jNM18y8LkLl/eTVodLyOf08iew=; b=kJ3l/oVVI/fBZkXhDW3xN6G1STJqHfbeo7N/HUbcVfNIIhQlaPFC+r+pPdD6Wy9b0h 6XpPgenox0Mm7OzdAuZbdxzq2ZLNM5aBoempEX+Y7TDkufxRRUO42q2UTEONMiEWgaDV i4pNWRXhzfRhApevAsDZYM0jg/Z/SmpYgHFP8gTQ1P5x8dFyGEPda8ntmU7tZpljfn/y i9EgzZce9lKHAwJNTmeHZln3aoC9xJb0GDGbahWsqloSlLRjxqZynzIp/qp1z9glYiq9 EtzY/rduWt+KVRIVkwOSzUVxnBVDOfrYKyVvgJEUItIbKQlG1ssrUz7unAX3966dwEEY qTfw== X-Gm-Message-State: AOAM532jDvJ7Hdvk2uoglPttcTOcy9N4Rf5iG+kC2G42mJw3/+dYXcbQ 1wXx3kAyOXsXiso2VZEa3bZvNg== X-Google-Smtp-Source: ABdhPJygyemdqFQlq/o6Y01iMbh3GsruajVNklcTckAaeWeAzQSjVCpFhoglBRdLyzrg1ftL9kUoEQ== X-Received: by 2002:a2e:1451:: with SMTP id 17mr10680226lju.30.1589833996859; Mon, 18 May 2020 13:33:16 -0700 (PDT) Received: from wasted.cogentembedded.com ([2a00:1fa0:4650:c10:49f1:792f:a411:29a7]) by smtp.gmail.com with ESMTPSA id d8sm7514470lfl.51.2020.05.18.13.33.15 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Mon, 18 May 2020 13:33:16 -0700 (PDT) Subject: [PATCH v3 1/2] dt-bindings: memory: document Renesas RPC-IF bindings From: Sergei Shtylyov To: Rob Herring , devicetree@vger.kernel.org Cc: Philipp Zabel , Mason Yang , linux-spi@vger.kernel.org, Chris Brandt , "linux-mtd@lists.infradead.org" References: <26faf5e8-26eb-cceb-a500-f0fd64609737@cogentembedded.com> Organization: Cogent Embedded Message-ID: Date: Mon, 18 May 2020 23:33:15 +0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.2.1 MIME-Version: 1.0 In-Reply-To: <26faf5e8-26eb-cceb-a500-f0fd64609737@cogentembedded.com> Content-Language: en-MW Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Renesas Reduced Pin Count Interface (RPC-IF) allows a SPI flash or HyperFlash connected to the SoC to be accessed via the external address space read mode or the manual mode. Document the device tree bindings for the Renesas RPC-IF found in the R-Car gen3 SoCs. Based on the original patch by Mason Yang . Signed-off-by: Sergei Shtylyov --- Changes in version 3: - fixed up the whitespace and added hyphens in the "compatible" prop text, also removed the comments; - specified the subnode name as "flash", and used "enum" in the subnode text; - fixed up the SPDX-License-Identifier: tag. Changes in version 2: - rewrote the bindings in YAML. Documentation/devicetree/bindings/memory-controllers/renesas,rpc-if.yaml | 88 ++++++++++ 1 file changed, 88 insertions(+) Index: linux/Documentation/devicetree/bindings/memory-controllers/renesas,rpc-if.yaml =================================================================== --- /dev/null +++ linux/Documentation/devicetree/bindings/memory-controllers/renesas,rpc-if.yaml @@ -0,0 +1,88 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/memory-controllers/renesas,rpc-if.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Renesas Reduced Pin Count Interface (RPC-IF) + +maintainers: + - Sergei Shtylyov + +description: | + Renesas RPC-IF allows a SPI flash or HyperFlash connected to the SoC to + be accessed via the external address space read mode or the manual mode. + + The flash chip itself should be represented by a subnode of the RPC-IF node. + The flash interface is selected based on the "compatible" property of this + subnode: + - if it contains "jedec,spi-nor", then SPI is used; + - if it contains "cfi-flash", then HyperFlash is used. + +allOf: + - $ref: "/schemas/spi/spi-controller.yaml#" + +properties: + compatible: + items: + - enum: + - renesas,r8a77980-rpc-if + - renesas,r8a77995-rpc-if + - enum: + - renesas,rcar-gen3-rpc-if # a generic R-Car gen3 device + + reg: + items: + - description: RPC-IF registers + - description: direct mapping read mode area + - description: write buffer area + + reg-names: + items: + - const: regs + - const: dirmap + - const: wbuf + + clocks: + maxItems: 1 + + power-domains: + maxItems: 1 + + resets: + maxItems: 1 + +patternProperties: + "flash@[0-9a-f]+$": + type: object + properties: + compatible: + - enum: + - cfi-flash + - jedec,spi-nor + +examples: + - | + #include + #include + + spi@ee200000 { + compatible = "renesas,r8a77995-rpc-if", "renesas,rcar-gen3-rpc-if"; + reg = <0 0xee200000 0 0x200>, + <0 0x08000000 0 0x4000000>, + <0 0xee208000 0 0x100>; + reg-names = "regs", "dirmap", "wbuf"; + clocks = <&cpg CPG_MOD 917>; + power-domains = <&sysc R8A77995_PD_ALWAYS_ON>; + resets = <&cpg 917>; + #address-cells = <1>; + #size-cells = <0>; + + flash@0 { + compatible = "jedec,spi-nor"; + reg = <0>; + spi-max-frequency = <40000000>; + spi-tx-bus-width = <1>; + spi-rx-bus-width = <1>; + }; + };