From patchwork Tue Jan 24 22:19:32 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Joshua Clayton X-Patchwork-Id: 9536015 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 A7A546042D for ; Tue, 24 Jan 2017 22:20:46 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 955C026E96 for ; Tue, 24 Jan 2017 22:20:46 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 8A2B127DF9; Tue, 24 Jan 2017 22:20:46 +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.3 required=2.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED, FREEMAIL_FROM, RCVD_IN_DNSWL_HI, RCVD_IN_SORBS_SPAM, 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 099C926E96 for ; Tue, 24 Jan 2017 22:20:46 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751066AbdAXWT4 (ORCPT ); Tue, 24 Jan 2017 17:19:56 -0500 Received: from mail-pg0-f66.google.com ([74.125.83.66]:33514 "EHLO mail-pg0-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751065AbdAXWTy (ORCPT ); Tue, 24 Jan 2017 17:19:54 -0500 Received: by mail-pg0-f66.google.com with SMTP id 194so17666263pgd.0; Tue, 24 Jan 2017 14:19:44 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references :in-reply-to:references; bh=xUJRkcIymALegtiZk/0AIMP7t3DY/m6h4UKHCMXZ4eY=; b=bS6VF5v9/ELPhWwMWjZVH8lWLwj8wA52Yk2GwxOihNk0ulcfXqRUK1Xz0VwIBaN4JW jMUnX8FLHFvNm/FF19gwzE22u4lxDP6rTd9nmwGxZ+Kk44Z60yEeZFO0UdOAr/Q+Waew /VrOmmn1UXmVDU0Hflyq1eDg5FZR8MQbia1v/TfqQgKqpBiNqD6AHtaKlw60FsXUXZSK 14kswYq6qyYqoitp7QeemZ3Ocp/B2CzJaFDqG6LgDuIElZHSqbRnolkAIj8U3RaA5ZBU zavHhJIVK1o7JmldgvF/sCixodJJH5WihKSLohN3jtPhWBqaYCI5/eRB8BdfiykBgxuo oTzg== 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:in-reply-to:references; bh=xUJRkcIymALegtiZk/0AIMP7t3DY/m6h4UKHCMXZ4eY=; b=tbcOkTyf43ZcHFHMhPQMgpALcxWDCWpd2pxVo+R8ASJjqNpZGjY1QGSprocO6fuBIQ TxvYMrfy/zLCHdFfYFKP8qWauhBq5q/M/BYMMfjzCTa1r2+TarfImS2OdKxU5Gi8t4bO QP0Sbi1sBnqJdXF5gexGMtwBwO20tBqocFGFbFKUEeBcFA9V2Pi+MWNYG9BifScBHbbO y3fjIPDMJCqYl62hjv5MmJoGhs88QxGeyPXm4mU/s2WU/WKcnwA+DPlzDTC0P0OLTLFK FEaasaPCiFdOhodGaya83Ct71xcqpE913efJMnS1ieCA3FoOFqdzAYX5lI/IVik/3SNA nqYw== X-Gm-Message-State: AIkVDXIj8i7aQcj5WWJdnpjPL3qTwxb0XaR96tx0LqZAe2lb8sJuabqeKIPVsMbopuxeIw== X-Received: by 10.98.10.69 with SMTP id s66mr41801895pfi.146.1485296383670; Tue, 24 Jan 2017 14:19:43 -0800 (PST) Received: from jclayton-pc.columbia.uniwest.com (68-185-59-186.static.knwc.wa.charter.com. [68.185.59.186]) by smtp.gmail.com with ESMTPSA id g11sm27711627pfe.38.2017.01.24.14.19.41 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 24 Jan 2017 14:19:42 -0800 (PST) From: Joshua Clayton To: Alan Tull , Moritz Fischer , Russell King , Shawn Guo , Sascha Hauer , Fabio Estevam Cc: Mark Rutland , Rob Herring , Anatolij Gustschin , Joshua Clayton , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-fpga@vger.kernel.org Subject: [PATCH v9 1/3] doc: dt: add cyclone-ps-spi binding document Date: Tue, 24 Jan 2017 14:19:32 -0800 Message-Id: <910cf70128e0303d3642d6ff527a069ad6e18bf7.1485295905.git.stillcompiling@gmail.com> X-Mailer: git-send-email 2.9.3 In-Reply-To: References: In-Reply-To: References: Sender: linux-fpga-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-fpga@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Describe a cyclone-ps-spi devicetree entry, required features Signed-off-by: Joshua Clayton Acked-by: Rob Herring --- .../bindings/fpga/altera-passive-serial.txt | 29 ++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 Documentation/devicetree/bindings/fpga/altera-passive-serial.txt diff --git a/Documentation/devicetree/bindings/fpga/altera-passive-serial.txt b/Documentation/devicetree/bindings/fpga/altera-passive-serial.txt new file mode 100644 index 0000000..774e6a7 --- /dev/null +++ b/Documentation/devicetree/bindings/fpga/altera-passive-serial.txt @@ -0,0 +1,29 @@ +Altera Cyclone Passive Serial SPI FPGA Manager + +Altera Cyclone FPGAs support a method of loading the bitstream over what is +referred to as "passive serial". +The passive serial link is not technically spi, and might require extra +circuits in order to play nicely with other spi slaves on the same bus. + +See https://www.altera.com/literature/hb/cyc/cyc_c51013.pdf + +Required properties: +- compatible: should contain "altr,fpga-passive-serial" +- reg: spi chip select of the FPGA +- nconfig-gpios: config pin (referred to as nCONFIG in the cyclone manual) +- nstat-gpios: status pin (referred to as nSTATUS in the cyclone manual) + +Optional properties: +- confd-gpios: confd pin (referred to as CONF_DONE in the cyclone manual) + + + +Example: + fpga_spi: evi-fpga-spi@0 { + compatible = "altr,cyclone-ps-spi-fpga-mgr"; + spi-max-frequency = <20000000>; + reg = <0>; + nconfig-gpios = <&gpio4 9 GPIO_ACTIVE_LOW>; + nstat-gpios = <&gpio4 11 GPIO_ACTIVE_LOW>; + confd-gpios = <&gpio4 12 GPIO_ACTIVE_LOW>; + };