From patchwork Tue Mar 12 16:30:51 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Patrick Leis X-Patchwork-Id: 10849501 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 74B491390 for ; Tue, 12 Mar 2019 16:31:21 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 5BD6329704 for ; Tue, 12 Mar 2019 16:31:21 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 4FA55297A1; Tue, 12 Mar 2019 16:31:21 +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=-5.2 required=2.0 tests=BAYES_00,DKIM_ADSP_CUSTOM_MED, DKIM_SIGNED,DKIM_VALID,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id D522129704 for ; Tue, 12 Mar 2019 16:31:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:To:From:Subject:Mime-Version:Message-Id :Date:Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References: List-Owner; bh=Uz+5MIFwLRBcsntSJ5NCPxvyMwFN7Men5UC2t1SI6J4=; b=rMyrdOW9UgSb48 tdm5yIgH8GYSFFZSDQdHyQtTWsZrLNC3kPWYkLTYM7Rcf4WG36PXFaN9sPqxCxl68skpNVslMskQp /OLYCjOXEc2mhVrLavyV/ti1wU77LmwhBfwI2cVjg5F25J3lbfURc8Vtt2imzZitY711CiUG5lNnf Mdf/rW2kH4jlFEFxjDGFZFhZZ//p6BgqR5vIuKc40FewvsVRiKnR4UqYZGy+hXZcuRyG7fifDkp1w N/1rh1vEp+xP7kdgkQiBa4BJoOggTug6xDbGiu2bSMTE74yE59mmfc4SdsX/ohh/MiplSqziC5I1a z3vWXbzd9OQjWI4v/2FQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.90_1 #2 (Red Hat Linux)) id 1h3kJB-0002Fv-06; Tue, 12 Mar 2019 16:31:17 +0000 Received: from mail-pf1-x449.google.com ([2607:f8b0:4864:20::449]) by bombadil.infradead.org with esmtps (Exim 4.90_1 #2 (Red Hat Linux)) id 1h3kIr-0001rK-8r for linux-arm-kernel@lists.infradead.org; Tue, 12 Mar 2019 16:30:58 +0000 Received: by mail-pf1-x449.google.com with SMTP id a72so3565093pfj.19 for ; Tue, 12 Mar 2019 09:30:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=date:message-id:mime-version:subject:from:to:cc; bh=kqjBTmv26VIX9JTEJkSps2f67FmEYh7rx1GjvZ/U8pI=; b=LJWnPgkix8BIabxV1von5P4DriBG0kQECT+Xi4MDn0V3SB6+vCsJgnZSLKvLiCKOAg twG781De+59NaSoRkhBVWmG8Uhkg/u8+AfFf6XZd6JRjaXQACxi2+YJyyJ9/A7ialpO+ c7EvVBG6ERwgg2Z0Cjg6+XpT1QpZLexi0GFMbKacHA/QYmGNzWIKs2iwpDG6DrZvZxyY t8BI1IleBOqkGpWQ+QtoDNkrR3yodnZdWjK7jz4DXEYNQ2ulFjtwfxiASB5oxKZh0E7H 9HcwirRPavXd6Rcgh9gcXhMDEss25esPeUqWcwziqDFYyG+9ZPlPFYWp3f4D53WqhxJs cmcA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:message-id:mime-version:subject:from:to:cc; bh=kqjBTmv26VIX9JTEJkSps2f67FmEYh7rx1GjvZ/U8pI=; b=KxH9kCM03NFk04Ty45rCFoEk+L1k6PVLOW7AFLnIOrNVJ9Ce1krlGgIW4R1d2NGp2c j6IPGJ8GF0M8XwAE3iNs+0H1a5IjYPBT05pPn4ZVb+RBG6X+8Cyms/VV7IFk7VdFnyae QFdwsDO+OEVoPxe3L77+X7JlqGtc9VUGA4FjI+qJZ1eZwrU/pS33UJFkc5oPJ+yiTd2R Mr21ggEYDMIzoaH1GbrrZwPlaIJ/BrRGy8pyIonQXKydIDdLhjfG6EiBTcYwoB81krdj EurBejHiJPOlteF8PTGQPpuyA/df9RfhHsQ2Un1e/iOX0nBuNZI7SjKjRQ4DpOgddJCZ J9Jw== X-Gm-Message-State: APjAAAUG0sGhfMaLNHb3q+q6WdLTdcXvWe/hrJU3QVvOXJyk5vRgrjUm jsYy0+vwKYPhOdlAzoaqoHK0gnhTBIdH X-Google-Smtp-Source: APXvYqw3K1vvGTj3mos4O70xYaHCSOgRfg+3LTgTxrs/2YCDxjRpK3cbTwZOyq9YHDycN9NN60UHpfmgEexi X-Received: by 2002:a63:4e15:: with SMTP id c21mr15008108pgb.85.1552408255456; Tue, 12 Mar 2019 09:30:55 -0700 (PDT) Date: Tue, 12 Mar 2019 09:30:51 -0700 Message-Id: <20190312163051.155405-1-venture@google.com> Mime-Version: 1.0 X-Mailer: git-send-email 2.21.0.360.g471c308f928-goog Subject: [PATCH v7 1/2] dt-bindings: misc: aspeed-p2a-ctrl: add support From: Patrick Venture To: venture@google.com, robh+dt@kernel.org, mark.rutland@arm.com, joel@jms.id.au, andrew@aj.id.au, gregkh@linuxfoundation.org X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20190312_093057_337647_C94CC791 X-CRM114-Status: GOOD ( 13.48 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, linux-aspeed@lists.ozlabs.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP Document the ast2400, ast2500 PCI-to-AHB bridge control driver bindings. Signed-off-by: Patrick Venture Reviewed-by: Rob Herring --- Changes for v7: - Moved node under the syscon node it requires Changes for v6: - None Changes for v5: - None Changes for v4: - None Changes for v3: - None Changes for v2: - Added comment about syscon required parameter. --- .../bindings/misc/aspeed-p2a-ctrl.txt | 48 +++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt diff --git a/Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt b/Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt new file mode 100644 index 000000000000..088cc4e3dc54 --- /dev/null +++ b/Documentation/devicetree/bindings/misc/aspeed-p2a-ctrl.txt @@ -0,0 +1,48 @@ +====================================================================== +Device tree bindings for Aspeed AST2400/AST2500 PCI-to-AHB Bridge Control Driver +====================================================================== + +The bridge is available on platforms with the VGA enabled on the Aspeed device. +In this case, the host has access to a 64KiB window into all of the BMC's +memory. The BMC can disable this bridge. If the bridge is enabled, the host +has read access to all the regions of memory, however the host only has read +and write access depending on a register controlled by the BMC. + +Required properties: +=================== + + - compatible: must be one of: + - "aspeed,ast2400-p2a-ctrl" + - "aspeed,ast2500-p2a-ctrl" + + - syscon: handle to syscon device node controlling PCI. + +Optional properties: +=================== + +- memory-region: A phandle to a reserved_memory region to be used for the PCI + to AHB mapping + +The p2a-control node should be the child of a syscon node with the required +property: + +- compatible : Should be one of the following: + "aspeed,ast2400-scu", "syscon", "simple-mfd" + "aspeed,g4-scu", "syscon", "simple-mfd" + "aspeed,ast2500-scu", "syscon", "simple-mfd" + "aspeed,g5-scu", "syscon", "simple-mfd" + +Example: + +g4 Example +---------- + +syscon: scu@1e6e2000 { + compatible = "aspeed,ast2400-scu", "syscon", "simple-mfd"; + reg = <0x1e6e2000 0x1a8>; + + p2a: p2a-control { + compatible = "aspeed,ast2400-p2a-ctrl"; + memory-region = <&reserved_memory>; + }; +};