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: 123064 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp7869121qgn; Mon, 1 Jan 2018 05:38:26 -0800 (PST) X-Google-Smtp-Source: ACJfBosiWZ7QZaYvq2D+d8nq8d+IT2Qcemk4CIcz8qSlD6ZQ2sejyUPeJqM9N582K/ky/OHbucLB X-Received: by 10.84.179.193 with SMTP id b59mr43018763plc.12.1514813906489; Mon, 01 Jan 2018 05:38:26 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1514813906; cv=none; d=google.com; s=arc-20160816; b=TuCFaeTznqqMHkTmBLSsX1bePBbwsFoLeLFRyQhIJyr4NeQPCpLlzwjZePPMrapjtj USYjlXQJvIPG3bVA6PY3rCU6SoXun2hlThBlydjBKH4LAMl9iat8E1UgzwwIpqBEFMJx glhQezMHZ97Lp+laodVWrcMu+S600I+ezx3rDW0wnNA1dzbqHgKXsS1lA/LfSw6n35V7 k7Taclu8N7UCwH2LtNskfhgicnenTCkEYKBqAtmNpFk1g3gAX0TS4kn6hbpu+Vad+tJv J5ueqN3AjzOEUkZAmbXppPQXpxVKepDwXOzazDBkdsEKiwY9edwsGahYti+0kROaC+Ji 3bJg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:dkim-signature:arc-authentication-results; bh=TC1s+41Pv8TIKWb6OAkdwT3yCKfx//cEUO4fm3mTxyM=; b=Hmlqg/ySZEMroH4h5T5d+swxUplqc7ZX0VWsQ5pjXM14ROsPYUuVfIaUQI5gAUpOfy HgaWv6gf23RhN8bEaJx0VsrRNdIuVr/Wa4lgA59bP4rIo6GwisVRORNJTzKwTZEQ+Hnb yeMxXTidPcAQFW95Dl2NbG68inQsjJdiRhgvioFhwBYLAcHiV+Q1TKW0lLytRPKPhpuO YSfn8t3Q4who8ZwMLsBVy7GNBCneno4y22TcFm9QbNh/yZe0ywGEDHX+PxA0Sij8oU5t fTcX/4fU99NFkj3KOKx3LV+zEv9UGkixcIFqdRkFA3xLdQxHLaum+dfPXs1b2wPhTi13 0PXQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=S1CmiADn; spf=pass (google.com: best guess record for domain of linux-spi-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-spi-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id f13si8470380pga.543.2018.01.01.05.38.26; Mon, 01 Jan 2018 05:38:26 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-spi-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@linaro.org header.s=google header.b=S1CmiADn; spf=pass (google.com: best guess record for domain of linux-spi-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-spi-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751379AbeAANi0 (ORCPT + 1 other); 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-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 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(-) -- 2.14.3 -- To unsubscribe from this list: send the line "unsubscribe linux-spi" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html 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>;