From patchwork Fri May 8 09:36:20 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Serge Semin X-Patchwork-Id: 11536155 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 51EEE81 for ; Fri, 8 May 2020 09:37:00 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 43B4B20A8B for ; Fri, 8 May 2020 09:37:00 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726636AbgEHJhA (ORCPT ); Fri, 8 May 2020 05:37:00 -0400 Received: from mail.baikalelectronics.com ([87.245.175.226]:41196 "EHLO mail.baikalelectronics.ru" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725775AbgEHJg7 (ORCPT ); Fri, 8 May 2020 05:36:59 -0400 Received: from localhost (unknown [127.0.0.1]) by mail.baikalelectronics.ru (Postfix) with ESMTP id EA034803078D; Fri, 8 May 2020 09:36:55 +0000 (UTC) X-Virus-Scanned: amavisd-new at baikalelectronics.ru Received: from mail.baikalelectronics.ru ([127.0.0.1]) by localhost (mail.baikalelectronics.ru [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Sntf7onvlSVj; Fri, 8 May 2020 12:36:54 +0300 (MSK) From: Serge Semin To: Mark Brown , Rob Herring CC: Serge Semin , Serge Semin , Ramil Zaripov , Alexey Malahov , Thomas Bogendoerfer , Paul Burton , Ralf Baechle , John Garry , Chuanhong Guo , Tomer Maimon , Lee Jones , Miquel Raynal , Arnd Bergmann , , , , Subject: [PATCH 1/2] dt-bindings: spi: Add Baikal-T1 System Boot SPI Controller binding Date: Fri, 8 May 2020 12:36:20 +0300 Message-ID: <20200508093621.31619-2-Sergey.Semin@baikalelectronics.ru> In-Reply-To: <20200508093621.31619-1-Sergey.Semin@baikalelectronics.ru> References: <20200508093621.31619-1-Sergey.Semin@baikalelectronics.ru> MIME-Version: 1.0 X-ClientProxiedBy: MAIL.baikal.int (192.168.51.25) To mail (192.168.51.25) Sender: linux-mips-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-mips@vger.kernel.org Baikal-T1 Boot SPI is a part of the SoC System Controller and is responsible for the system bootup from an external SPI flash. It's a DW APB SSI-based SPI-controller with no interrupts, no DMA, with just one native chip-select available and a single reference clock. Since Baikal-T1 SoC is normally booted up from an external SPI flash this SPI controller in most of the cases is supposed to be connected to a single SPI-nor flash. Additionally in order to provide a transparent from CPU point of view initial code execution procedure the system designers created an IP block which physically maps the SPI flash found at CS0 to a memory region. Co-developed-by: Ramil Zaripov Signed-off-by: Ramil Zaripov Signed-off-by: Serge Semin Cc: Alexey Malahov Cc: Thomas Bogendoerfer Cc: Paul Burton Cc: Ralf Baechle Cc: John Garry Cc: Chuanhong Guo Cc: Tomer Maimon Cc: Lee Jones Cc: Miquel Raynal Cc: Arnd Bergmann Cc: linux-mips@vger.kernel.org Cc: linux-spi@vger.kernel.org --- .../bindings/spi/baikal,bt1-sys-ssi.yaml | 100 ++++++++++++++++++ 1 file changed, 100 insertions(+) create mode 100644 Documentation/devicetree/bindings/spi/baikal,bt1-sys-ssi.yaml diff --git a/Documentation/devicetree/bindings/spi/baikal,bt1-sys-ssi.yaml b/Documentation/devicetree/bindings/spi/baikal,bt1-sys-ssi.yaml new file mode 100644 index 000000000000..d9d3257d78f4 --- /dev/null +++ b/Documentation/devicetree/bindings/spi/baikal,bt1-sys-ssi.yaml @@ -0,0 +1,100 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +# Copyright (C) 2020 BAIKAL ELECTRONICS, JSC +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/spi/baikal,bt1-sys-ssi.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Baikal-T1 System Boot SSI Controller + +description: | + Baikal-T1 System Controller includes a Boot SPI Controller, which is + responsible for loading chip bootup code from an external SPI flash. In order + to do this transparently from CPU point of view there is a dedicated IP block + mapping the 16MB flash to a dedicated MMIO range. The controller is based on + the DW APB SSI IP-core but equipped with very limited resources: no IRQ, + no DMA, a single native CS being necessarily connected to a 16MB SPI flash + (otherwise the system won't bootup from the flash), internal Tx/Rx FIFO of + just 8 bytes depth. Access to DW APB SSI controller registers is mutually + exclusive from normal MMIO interface and from physically mapped SPI Flash + memory. So either one or another way of using the controller functionality + can be enabled at a time. + +maintainers: + - Serge Semin + +allOf: + - $ref: spi-controller.yaml# + +properties: + compatible: + const: baikal,bt1-sys-ssi + + reg: + items: + - description: Baikal-T1 Boot Controller configuration registers + - description: Physically mapped SPI flash ROM found at CS0 + + reg-names: + items: + - const: config + - const: map + + clocks: + description: SPI Controller reference clock source + maxItems: 1 + + clock-names: + items: + - const: ssi_clk + + num-cs: + const: 1 + +patternProperties: + "^.*@[0-9a-f]+": + type: object + properties: + reg: + minimum: 0 + maximum: 0 + + spi-rx-bus-width: + const: 1 + + spi-tx-bus-width: + const: 1 + +unevaluatedProperties: false + +required: + - compatible + - reg + - reg-names + - "#address-cells" + - "#size-cells" + - clocks + +examples: + - | + spi@1f040000 { + compatible = "baikal,bt1-sys-ssi"; + reg = <0x1f040000 0x1000>, + <0x1c000000 0x1000000>; + reg-names = "config", "map"; + #address-cells = <1>; + #size-cells = <0>; + + clocks = <&ccu_sys>; + clock-names = "ssi_clk"; + + boot_flash: flash@0 { + compatible = "jedec,spi-nor"; + #address-cells = <1>; + #size-cells = <1>; + reg = <0>; + + spi-max-frequency = <25000000>; + }; + }; +...