From patchwork Mon Feb 19 07:24:20 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Joel Stanley X-Patchwork-Id: 874993 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="o8fiYaz4"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3zlFcy425mz9s0w for ; Mon, 19 Feb 2018 18:24:50 +1100 (AEDT) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751976AbeBSHYt (ORCPT ); Mon, 19 Feb 2018 02:24:49 -0500 Received: from mail-pl0-f65.google.com ([209.85.160.65]:36764 "EHLO mail-pl0-f65.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751467AbeBSHYr (ORCPT ); Mon, 19 Feb 2018 02:24:47 -0500 Received: by mail-pl0-f65.google.com with SMTP id v3so5217117plg.3; Sun, 18 Feb 2018 23:24:46 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references; bh=tZFg/IZta6nugTj/dTirBEO0g/WAhdCuEkjt5MXATSc=; b=o8fiYaz4ls/B/HzMk7dUISonem0pYCZaB078KAoYSVBoNrQz7IG5CjZxQWmWzMoMam lccm7Acm9Lw+svVIr9mPi8af+PJGGpK+kwNLKQvXEsOzccwxkE12xrSqbifBYr0Uqnv8 bgZccxZK/m5B6qzUC8V8n+f9RNpv/km6qxWSpk355sqjUjwekAnOUjuKniwYtYC1Hsn3 jaeH6gt0iRzBN/mqRiXWzu8aoyzUM880A574Hs8LIDRK8OVJCwneuumNy5lVrnNL6JN8 xwyAMhROMW9RFyieraRHbJ/dKD+0Ty+Hmv7fbWA4n1hv45h+ZGGs6NX6gGSyX54omWbu EHkQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:from:to:cc:subject:date:message-id :in-reply-to:references; bh=tZFg/IZta6nugTj/dTirBEO0g/WAhdCuEkjt5MXATSc=; b=fOaS4CHKjbWMjqXO/w4i5hurJuTztZxqNfIK9ou37n2AVLEpIOp1yZCLKzKFRbT3mu XKit4e2VJCfJqi+Ps39SzJ1Zgq2WXJ4Ysi6n/PFsM5AVFchJlbDhsIDdERrg+SoOpiDC z57r7ha6Z/WdWwqw28niENneJZ1IeCie+WRFrGRdhCrSHtZIQcsf0mV/8DtattyzaEny O7U67rZ4aGrOzX+1ld+hlnTh90F7DAlQ0QxJZEoz7uMb3WU1O5PaZ4/2yvQ6Pr9wh1Ti IDrLc4EQbkWAnhrKQXGQuGUdUHyKrXykeyXlUdICKure2udLM+00/Rmk3mCkvfO+x9fx nPSA== X-Gm-Message-State: APf1xPBiIX7MWT6OH8kXiJ5NvcaxsJhBNx/yfM3+547DPkAKqLI6tfuE smkWieJN5MT4khgF6/p29og= X-Google-Smtp-Source: AH8x226YRJazxhB8OYNr6PeWbjs9uhsPg1frRisNM2NIE1WlYmpXPr3WDh8ICgD4QhhITTjovXS5rA== X-Received: by 2002:a17:902:6b82:: with SMTP id p2-v6mr13585014plk.30.1519025086283; Sun, 18 Feb 2018 23:24:46 -0800 (PST) Received: from aurora.jms.id.au ([45.124.203.19]) by smtp.gmail.com with ESMTPSA id f10sm50102664pgr.33.2018.02.18.23.24.40 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 18 Feb 2018 23:24:45 -0800 (PST) Received: by aurora.jms.id.au (sSMTP sendmail emulation); Mon, 19 Feb 2018 17:54:36 +1030 From: Joel Stanley To: Lee Jones , Greg Kroah-Hartman , Rob Herring , Mark Rutland Cc: Arnd Bergmann , devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Andrew Jeffery , Cyril Bur , Benjamin Herrenschmidt , Ryan Chen , Lei YU Subject: [PATCH v2 1/3] dt-bindings: aspeed-lpc: Document LPC Host Interface Controller Date: Mon, 19 Feb 2018 17:54:20 +1030 Message-Id: <20180219072422.22733-2-joel@jms.id.au> X-Mailer: git-send-email 2.15.1 In-Reply-To: <20180219072422.22733-1-joel@jms.id.au> References: <20180219072422.22733-1-joel@jms.id.au> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org The LPC Host Interface Controller is part of a BMC SoC that is used for communication with the host. Reviewed-by: Rob Herring Signed-off-by: Joel Stanley --- v2: - Move the content to below the Host Node Children heading - Add Rob's review tag --- .../devicetree/bindings/mfd/aspeed-lpc.txt | 41 ++++++++++++++++++++++ 1 file changed, 41 insertions(+) diff --git a/Documentation/devicetree/bindings/mfd/aspeed-lpc.txt b/Documentation/devicetree/bindings/mfd/aspeed-lpc.txt index 514d82ced95b..69aadee00d5f 100644 --- a/Documentation/devicetree/bindings/mfd/aspeed-lpc.txt +++ b/Documentation/devicetree/bindings/mfd/aspeed-lpc.txt @@ -109,9 +109,50 @@ lpc: lpc@1e789000 { }; }; +BMC Node Children +================== + + Host Node Children ================== +LPC Host Interface Controller +------------------- + +The LPC Host Interface Controller manages functions exposed to the host such as +LPC firmware hub cycles, configuration of the LPC-to-AHB mapping, UART +management and bus snoop configuration. + +Required properties: + +- compatible: One of: + "aspeed,ast2400-lpc-ctrl"; + "aspeed,ast2500-lpc-ctrl"; + +- reg: contains offset/length values of the host interface controller + memory regions + +- clocks: contains a phandle to the syscon node describing the clocks. + There should then be one cell representing the clock to use + +- memory-region: A phandle to a reserved_memory region to be used for the LPC + to AHB mapping + +- flash: A phandle to the SPI flash controller containing the flash to + be exposed over the LPC to AHB mapping + +Example: + +lpc-host@80 { + lpc_ctrl: lpc-ctrl@0 { + compatible = "aspeed,ast2500-lpc-ctrl"; + reg = <0x0 0x80>; + clocks = <&syscon ASPEED_CLK_GATE_LCLK>; + memory-region = <&flash_memory>; + flash = <&spi>; + }; +}; + LPC Host Controller -------------------