From patchwork Fri Mar 6 13:07:17 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Serge Semin X-Patchwork-Id: 11423891 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 5FD5618B8 for ; Fri, 6 Mar 2020 13:13:01 +0000 (UTC) Received: by mail.kernel.org (Postfix) id 573B821775; Fri, 6 Mar 2020 13:13:01 +0000 (UTC) Delivered-To: soc@kernel.org Received: from mail.baikalelectronics.ru (mail.baikalelectronics.com [87.245.175.226]) by mail.kernel.org (Postfix) with ESMTP id E625F20866 for ; Fri, 6 Mar 2020 13:13:00 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org E625F20866 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=baikalelectronics.ru Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=Sergey.Semin@baikalelectronics.ru Received: from localhost (unknown [127.0.0.1]) by mail.baikalelectronics.ru (Postfix) with ESMTP id 3FD2C8030706; Fri, 6 Mar 2020 13:07:33 +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 zlcMDz8CAUmd; Fri, 6 Mar 2020 16:07:32 +0300 (MSK) From: To: Rob Herring , Mark Rutland List-Id: CC: Serge Semin , Serge Semin , Alexey Malahov , Thomas Bogendoerfer , Paul Burton , Ralf Baechle , Arnd Bergmann , Olof Johansson , , , Subject: [PATCH 2/6] dt-bindings: Add Baikal-T1 APB-bus EHB dts bindings file Date: Fri, 6 Mar 2020 16:07:17 +0300 In-Reply-To: <20200306130721.10347-1-Sergey.Semin@baikalelectronics.ru> References: <20200306130721.10347-1-Sergey.Semin@baikalelectronics.ru> MIME-Version: 1.0 X-ClientProxiedBy: MAIL.baikal.int (192.168.51.25) To mail (192.168.51.25) Message-Id: <20200306130733.3FD2C8030706@mail.baikalelectronics.ru> From: Serge Semin This is a specific block embedded into the Baikal-T1 SoC, which is dedicated to detect APB-bus protocol errors and tune the peripheral access timeout. So the dts bindings implies that corresponding dts node would be equipped with "be,bt1-apb-ehb" compatible string, MMIO region of registers space and of space with no device mapped, interrupts property and with an APB-reference clock handler. Signed-off-by: Serge Semin Signed-off-by: Alexey Malahov Cc: Thomas Bogendoerfer Cc: Paul Burton Cc: Ralf Baechle Cc: Arnd Bergmann Cc: Olof Johansson Cc: soc@kernel.org --- .../soc/baikal-t1/be,bt1-apb-ehb.yaml | 66 +++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 Documentation/devicetree/bindings/soc/baikal-t1/be,bt1-apb-ehb.yaml diff --git a/Documentation/devicetree/bindings/soc/baikal-t1/be,bt1-apb-ehb.yaml b/Documentation/devicetree/bindings/soc/baikal-t1/be,bt1-apb-ehb.yaml new file mode 100644 index 000000000000..e262aead2fb5 --- /dev/null +++ b/Documentation/devicetree/bindings/soc/baikal-t1/be,bt1-apb-ehb.yaml @@ -0,0 +1,66 @@ +# SPDX-License-Identifier: GPL-2.0 +# +# Copyright (C) 2019 - 2020 BAIKAL ELECTRONICS, JSC +# +# Baikal-T1 APB-bus Errors Handler Block Device Tree Bindings. +# +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/soc/baikal-t1/be,bt1-apb-ehb.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Baikal-T1 APB-bus Errors Handler Block + +maintainers: + - Serge Semin + +description: | + Configuration registers of Baikal-T1 SoC peripheral interfaces are accessed + by means of the APB-bus. In case of any APB protocol collisions, slave device + not responding on timeout an IRQ is raised with an erroneous address reported + to the APB terminator (EHB) sub-block described by this bindings file. + +properties: + compatible: + const: be,bt1-apb-ehb + + reg: + items: + - description: APB EHB MMIO registers. + - description: APB MMIO region with no any device mapped. + + interrupts: + maxItems: 1 + + clocks: + description: APB reference clock. + maxItems: 1 + + clock-names: + const: ref + +additionalProperties: false + +required: + - compatible + - reg + - interrupts + - clocks + - clock-names + +examples: + - | + #include + #include + + apb_ehb: ehb@1F059000 { + compatible = "be,bt1-apb-ehb"; + reg = <0x1F059000 0x1000>, + <0x1D000000 0x2040000>; + + interrupts = ; + + clocks = <&ccu_sys CCU_SYS_APB_CLK>; + clock-names = "ref"; + }; +...