From patchwork Tue Jun 20 21:15:14 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Brendan Higgins X-Patchwork-Id: 778486 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3wsgcj1pC2z9s7v for ; Wed, 21 Jun 2017 07:16:05 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=google.com header.i=@google.com header.b="Qpsxh0Hi"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752542AbdFTVPl (ORCPT ); Tue, 20 Jun 2017 17:15:41 -0400 Received: from mail-pg0-f46.google.com ([74.125.83.46]:36840 "EHLO mail-pg0-f46.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752588AbdFTVPe (ORCPT ); Tue, 20 Jun 2017 17:15:34 -0400 Received: by mail-pg0-f46.google.com with SMTP id u62so48619751pgb.3 for ; Tue, 20 Jun 2017 14:15:33 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=HXNtfM0aeeFqJOUAZghFRWcTqGFZWObQIgDo7KMzvdY=; b=Qpsxh0Hi72geBpBtGKmPSlkB19IX01IjBoLiMG8ogOYg8oWb6DhVkve2qYufsP58oB xMenmyDP1NVq10fmlKHGKM1/4NcE0T2BiBku8NVZQO5BbCGxMfSND1xT1pI695u2ouoo Nrr11YkFoe6PsMS/Ktw8BtCE8/+kw1k3AGW13dPiF5BsQRNvC3R6f537NTRG7SdY8Ogo LOWrBzijgN31neWVN4YrL/xJkq+4pOW9KEXHBAvsZVpAtXX2xnF3Yb3t1PSyfZZF6Wde XbhwKWIcnMplhBBPqD05S6J3xh5el6X2V3jV1gScaiFvZZWQP+fGaElE+Kv5hmvEcN7x 1ikg== 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; bh=HXNtfM0aeeFqJOUAZghFRWcTqGFZWObQIgDo7KMzvdY=; b=bFLduaxiN8KDJFYzm6JfejP7Q9KZc9MPlkhuQBQ3VFXOGYrvq3bLqQfhGHz29X1inI +dDPbKVrYHvBVqlw4BBWHGFIXBvFPwhMf7Kn8aLc2UmWQbwsJt3XPFoKlVS9bE27Bva/ 12an8U2qYMbOKYoQ2qzJsuFlpztSCpUA7DFfFoJIA86ao1J+n8pSRDxKs2PE4lUHl62s zCRNypXlKU2vPEy5WDx5UYtaCcryL4EdPMrE91Q/Tc9Tld4LA/zc9Mdq3TPzsGeORkhH mpXgv3lIYcXGdHZjrMd2R1NdC4X6SquA0mjs1PJr1yOkjFIwlLJMI2d08ICcBZrfngNW F31w== X-Gm-Message-State: AKS2vOwv4r2inhlje2teRcvPiNkjSVty3ySlioEnVfwrq+tq7Aqi3uQE djuOW9kscF5rDt1c X-Received: by 10.99.2.78 with SMTP id 75mr24914907pgc.120.1497993333309; Tue, 20 Jun 2017 14:15:33 -0700 (PDT) Received: from mactruck.svl.corp.google.com ([100.123.242.94]) by smtp.gmail.com with ESMTPSA id a69sm29012015pfg.91.2017.06.20.14.15.32 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 20 Jun 2017 14:15:32 -0700 (PDT) From: Brendan Higgins To: wsa@the-dreams.de, robh+dt@kernel.org, mark.rutland@arm.com, gregkh@linuxfoundation.org, davem@davemloft.net, mchehab@kernel.org, joel@jms.id.au, martin.petersen@oracle.com, benh@kernel.crashing.org Cc: linux-i2c@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, openbmc@lists.ozlabs.org, Brendan Higgins Subject: [PATCH v11 2/4] i2c: aspeed: added documentation for Aspeed I2C driver Date: Tue, 20 Jun 2017 14:15:14 -0700 Message-Id: <20170620211516.13095-3-brendanhiggins@google.com> X-Mailer: git-send-email 2.13.1.611.g7e3b11ae1-goog In-Reply-To: <20170620211516.13095-1-brendanhiggins@google.com> References: <20170620211516.13095-1-brendanhiggins@google.com> Sender: linux-i2c-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-i2c@vger.kernel.org Added device tree binding documentation for Aspeed I2C busses. Signed-off-by: Brendan Higgins Acked-by: Rob Herring --- hanges for v2: - None Changes for v3: - Removed reference to "bus" device tree param Changes for v4: - None Changes for v5: - None Changes for v6: - Replaced the controller property with and interrupt controller, leaving only the busses in the I2C documentation. Changes for v7: - Changed clock-frequency to bus-frequency in device tree Changes for v8: - Added multi-master property to device tree Changes for v9: - None Changes for v10: - None Changes for v11: - None --- .../devicetree/bindings/i2c/i2c-aspeed.txt | 48 ++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 Documentation/devicetree/bindings/i2c/i2c-aspeed.txt diff --git a/Documentation/devicetree/bindings/i2c/i2c-aspeed.txt b/Documentation/devicetree/bindings/i2c/i2c-aspeed.txt new file mode 100644 index 000000000000..bd6480b19535 --- /dev/null +++ b/Documentation/devicetree/bindings/i2c/i2c-aspeed.txt @@ -0,0 +1,48 @@ +Device tree configuration for the I2C busses on the AST24XX and AST25XX SoCs. + +Required Properties: +- #address-cells : should be 1 +- #size-cells : should be 0 +- reg : address offset and range of bus +- compatible : should be "aspeed,ast2400-i2c-bus" + or "aspeed,ast2500-i2c-bus" +- clocks : root clock of bus, should reference the APB + clock +- interrupts : interrupt number +- interrupt-parent : interrupt controller for bus, should reference a + aspeed,ast2400-i2c-ic or aspeed,ast2500-i2c-ic + interrupt controller + +Optional Properties: +- bus-frequency : frequency of the bus clock in Hz defaults to 100 kHz when not + specified +- multi-master : states that there is another master active on this bus. + +Example: + +i2c { + compatible = "simple-bus"; + #address-cells = <1>; + #size-cells = <1>; + ranges = <0 0x1e78a000 0x1000>; + + i2c_ic: interrupt-controller@0 { + #interrupt-cells = <1>; + compatible = "aspeed,ast2400-i2c-ic"; + reg = <0x0 0x40>; + interrupts = <12>; + interrupt-controller; + }; + + i2c0: i2c-bus@40 { + #address-cells = <1>; + #size-cells = <0>; + #interrupt-cells = <1>; + reg = <0x40 0x40>; + compatible = "aspeed,ast2400-i2c-bus"; + clocks = <&clk_apb>; + bus-frequency = <100000>; + interrupts = <0>; + interrupt-parent = <&i2c_ic>; + }; +};