From patchwork Mon Jan 1 13:37:47 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Linus Walleij X-Patchwork-Id: 10138545 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id E045860362 for ; Mon, 1 Jan 2018 13:38:26 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id D1CCC28811 for ; Mon, 1 Jan 2018 13:38:26 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id C50902889B; Mon, 1 Jan 2018 13:38:26 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 60AEA28811 for ; Mon, 1 Jan 2018 13:38:26 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751379AbeAANi0 (ORCPT ); Mon, 1 Jan 2018 08:38:26 -0500 Received: from mail-wr0-f194.google.com ([209.85.128.194]:38187 "EHLO mail-wr0-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751111AbeAANiZ (ORCPT ); Mon, 1 Jan 2018 08:38:25 -0500 Received: by mail-wr0-f194.google.com with SMTP id y9so4384160wrb.5 for ; Mon, 01 Jan 2018 05:38:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=gmqN+Cw0eBublKbk+kINGFVrNtb7j9+bnyAXAo7+PcA=; b=S1CmiADnjpfM0Mru3cdNxtR9S6pWxDTQlH/qHJLqCZRmSFefzcA0w02HrLWOlf6t+4 RyDcw4gl8qIE4UivZ5d0ep9C6RDGpvjQxaRrjVcNMS/xnQRz7/dRILIozhZ15PAktfMT S1sNS027veg0dK0sxJGshGJxBrzO1CH3aOSis= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=gmqN+Cw0eBublKbk+kINGFVrNtb7j9+bnyAXAo7+PcA=; b=f7X85Yk/wfChqdGL1oWuhLfnQaxfb+nrL8HqKdxHOkGXXNIgenTHsICKSGHo6MXYN6 0/u/y8/24PZpSibFaB7gBeyzZbC17UKhm3RbN8Lm6sEXr5sw6CryFUjSyoXT76yV6al8 HR5pyEhM/rKMBf5VjgJtisG9tI8PJnijw61d/YTO4YflSMbWcNqucmcWEOea13IG2tS3 39+GoxvFqizwHJ4+GeDtHIOIGh1Em638kRJl+wy4c7+mutpToT1w+dqnvdiEHPF7ReUb /lkuSHs+UhkAU1FtcDg9EFkyP+pS75MpAlhonZrmUeZM7A1iNG1gIz9SA4wrU1nE1ug2 r0rw== X-Gm-Message-State: AKGB3mLQ2reQs486UxwElim+FCImoeuoM2AR8KvjLJoXVptk/LuLDOlu g99RcIiNsFUq+LX2/dGLXc8SFw== X-Google-Smtp-Source: ACJfBovQq7zef5gnDrDjk3PDhlJdfLt8SK0EalH6fPBnA78Soc9TXggFGsNY5GsbIu/1r5lqKNV84w== X-Received: by 10.223.208.136 with SMTP id y8mr16841569wrh.71.1514813904265; Mon, 01 Jan 2018 05:38:24 -0800 (PST) Received: from localhost.localdomain (catv-80-98-14-92.catv.broadband.hu. [80.98.14.92]) by smtp.gmail.com with ESMTPSA id d7sm53491267wrd.54.2018.01.01.05.38.23 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 01 Jan 2018 05:38:23 -0800 (PST) From: Linus Walleij To: Mark Brown , linux-spi@vger.kernel.org Cc: Linus Walleij , Rob Herring Subject: [PATCH 3/5] spi: spi-gpio: Augment device tree bindings Date: Mon, 1 Jan 2018 14:37:47 +0100 Message-Id: <20180101133749.29567-4-linus.walleij@linaro.org> X-Mailer: git-send-email 2.14.3 In-Reply-To: <20180101133749.29567-1-linus.walleij@linaro.org> References: <20180101133749.29567-1-linus.walleij@linaro.org> Sender: linux-spi-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-spi@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP After we augmented the core to handle "gpio-sck"/"sck-gpios", "gpio-mosi"/"mosi-gpios", "gpio-miso"/"miso-gpios" alike, deprecate the old binding and put the strict modern and recommended binding practice into place as the default for GPIO-based SPI. Cc: Rob Herring Signed-off-by: Linus Walleij --- Documentation/devicetree/bindings/spi/spi-gpio.txt | 24 ++++++++++++++++------ 1 file changed, 18 insertions(+), 6 deletions(-) diff --git a/Documentation/devicetree/bindings/spi/spi-gpio.txt b/Documentation/devicetree/bindings/spi/spi-gpio.txt index a95603bcf6ff..52db562f17a4 100644 --- a/Documentation/devicetree/bindings/spi/spi-gpio.txt +++ b/Documentation/devicetree/bindings/spi/spi-gpio.txt @@ -1,18 +1,30 @@ SPI-GPIO devicetree bindings +This represents a group of 3-n GPIO lines used for bit-banged SPI on dedicated +GPIO lines. + Required properties: - compatible: should be set to "spi-gpio" - #address-cells: should be set to <0x1> - ranges - - gpio-sck: GPIO spec for the SCK line to use - - gpio-miso: GPIO spec for the MISO line to use - - gpio-mosi: GPIO spec for the MOSI line to use + - sck-gpios: GPIO spec for the SCK line to use + - miso-gpios: GPIO spec for the MISO line to use + - mosi-gpios: GPIO spec for the MOSI line to use - cs-gpios: GPIOs to use for chipselect lines. Not needed if num-chipselects = <0>. - num-chipselects: Number of chipselect lines. Should be <0> if a single device with no chip select is connected. +Deprecated bindings: + +These legacy GPIO line bindings can alternatively be used to define the +GPIO lines used, they should not be used in new device trees. + + - gpio-sck: GPIO spec for the SCK line to use + - gpio-miso: GPIO spec for the MISO line to use + - gpio-mosi: GPIO spec for the MOSI line to use + Example: spi { @@ -20,9 +32,9 @@ Example: #address-cells = <0x1>; ranges; - gpio-sck = <&gpio 95 0>; - gpio-miso = <&gpio 98 0>; - gpio-mosi = <&gpio 97 0>; + sck-gpios = <&gpio 95 0>; + miso-gpios = <&gpio 98 0>; + mosi-gpios = <&gpio 97 0>; cs-gpios = <&gpio 125 0>; num-chipselects = <1>;