From patchwork Mon Jan 23 22:51:04 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Joshua Clayton X-Patchwork-Id: 9533679 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 B09066042D for ; Mon, 23 Jan 2017 22:51:17 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id A633B205D6 for ; Mon, 23 Jan 2017 22:51:17 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 99FF622376; Mon, 23 Jan 2017 22:51:17 +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 063772756B for ; Mon, 23 Jan 2017 22:51:17 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751890AbdAWWvQ (ORCPT ); Mon, 23 Jan 2017 17:51:16 -0500 Received: from mail-pf0-f193.google.com ([209.85.192.193]:35824 "EHLO mail-pf0-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751861AbdAWWvO (ORCPT ); Mon, 23 Jan 2017 17:51:14 -0500 Received: by mail-pf0-f193.google.com with SMTP id f144so10777644pfa.2; Mon, 23 Jan 2017 14:51:13 -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=1b0Wrd1qd1g8Zvlm9J1UT9qOLZSzVJz+RgTuSWXV+js=; b=VjNrVOGzjvM8dgEnK7acm517u+VDI0zKkc+h7efxIxkN2a9y2JLb90NS4b3+HWrcLB /VUgD6A36e9HtSLhAVhj7hhYAb/rDtwgcQlZxFA+5vBw1j0o6YjwEcz02WIWoQXMSdnC A5hIasVIi6MsRUAQhusxZQHyz0ZCfF4opVMnrG3OOga2LKok9ypX5HHmO0OJtC8LgQ/M G6SYDy5kTxOdPnzarsXxGTU0Y9bKaYIZfZKvyNqjjsXnoayruon8DgKjy1vzvI4s/YWE 5+4WV2S23sqTfSTDC4GPlGYRExpBymwSOccAGVUbZW8DsjCta+uHrUwOizB2rYfy6rxX DbDA== 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=1b0Wrd1qd1g8Zvlm9J1UT9qOLZSzVJz+RgTuSWXV+js=; b=Y+0vIEoNL/oY9L4mYp3Z8u8E7i8e/9kbLOSWzC56Cv9wd5PxAiGbmWLcPqQu+osM+I /S/BZHp9w4ePmFTALtQ33Kg5bkosEERqF0ooaRXKmiYEZAdDEsYHV4InMxfUYLE+RRmK de1Dc3JlAQP8PbaKE65Rr1lo4sDEiwbXksOiql2Cq7llFpu78EEO0ZTgsDDvPqhcqkWX 9H5wzvoGw/GzK382A7YLTkbqOyGk63CbyrMI6ONe7IWx6b8UTjbhQDwgfcHxvn5OTNPL rdPnal7tJ2vY8OyKhJt6Ce+i4Ub+wHLNu4qv4kN1vHSnRg48yaSZLNtmEGg9G3LO/sH5 tO3g== X-Gm-Message-State: AIkVDXIyRr55gP4hL7lTNJu4H8Sa/yiCu31Zcv/hXZZGyA6fp2qrxQMjDwAuPzaPgdIIWg== X-Received: by 10.99.56.94 with SMTP id h30mr35672690pgn.23.1485211873506; Mon, 23 Jan 2017 14:51:13 -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 d69sm39353003pfd.11.2017.01.23.14.51.11 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 23 Jan 2017 14:51:12 -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 v8 1/3] doc: dt: add cyclone-ps-spi binding document Date: Mon, 23 Jan 2017 14:51:04 -0800 Message-Id: <6b7883678d1e343d103302c77863bf69ca836637.1485211400.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 | 25 ++++++++++++++++++++++ 1 file changed, 25 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..b5f0bb5 --- /dev/null +++ b/Documentation/devicetree/bindings/fpga/altera-passive-serial.txt @@ -0,0 +1,25 @@ +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 +- nstat-gpios: status pin (referred to as nSTATUS in the cyclone manual) +- nconfig-gpios: config pin (referred to as nCONFIG in the cyclone manual) +- 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>; + };