From patchwork Sat Sep 10 01:55:51 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Brendan Higgins X-Patchwork-Id: 668329 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 3sWHHc5VBRz9sxb for ; Sat, 10 Sep 2016 11:56:44 +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=RP2n+cHZ; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751741AbcIJB4R (ORCPT ); Fri, 9 Sep 2016 21:56:17 -0400 Received: from mail-pa0-f42.google.com ([209.85.220.42]:35456 "EHLO mail-pa0-f42.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751788AbcIJB4Q (ORCPT ); Fri, 9 Sep 2016 21:56:16 -0400 Received: by mail-pa0-f42.google.com with SMTP id b2so33469573pat.2 for ; Fri, 09 Sep 2016 18:56:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=GSI8Pkkz0FNqFC7kvnhU65/EMrsVMyAYSOhI9eM0XJs=; b=RP2n+cHZJo+pY/8cJRvhIEIupcXnQhjIDuSM3wH41GT1DbMH0IseFMgpWqP/URQYbd WL/1n1InU8CIWjDVu5/Smz+Q58Jqn0QfGlvRPSorFDtni8eeWdo37XxrI4gmbaCiOpQb PqSeOzYoO2WAXn/KaSW8efDaPbupFY4gZleDuOHPcTHcbZkoEMQjWeULcXSv7xQMTQZ5 LiwmJUEMJEHiiuWFr0GI3xtDGNDtJ7IoT+8SoBXUQwzRopDGMLYd+tAMib3ewnvGORi0 PauyRVREP+cE6iNe+C0sTnlZxOfws9NZ8IZiZHmljwrVmsFI9d1Ch67TtWj6RxjUQy4y G6EA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=GSI8Pkkz0FNqFC7kvnhU65/EMrsVMyAYSOhI9eM0XJs=; b=DNYlr8EwGtfYO5sUSDEuMABlFhItdU0riQWMa5zv2kJe28+AY6wNoR5CRTJA++4328 bc0BP5aiEU2/P1o+WYYknHt9uTlyW9VYenKGTDtMyopIcbAaZeqW/XE2h0wVWudSVXt9 fGEMFYYTWe0XmeOMj91GrZCg/Cvgg7Porb9YueAH6/GgZugQXiY7UB2hdlXZ0DLUXxBv vtnFIpDi/d9Q79Q4pf9td5AXEantPZBLK2KoSfTTcTdYLOqNC01RryLnfemempOi+TP7 DAy2i7SmjlWj6AFDdD/B/0yP69TOjXPwCBHi7ISlJxfyaUF4XA1rbc4Lf+adqv8BCTEH kXjg== X-Gm-Message-State: AE9vXwNoFGzMKd64MNCPzGeWSdZ43ibv4s8rA63UnVcYtzDHgQm/VN+oG3m7cyxPQVy+04ed X-Received: by 10.67.7.170 with SMTP id dd10mr11965355pad.152.1473472575672; Fri, 09 Sep 2016 18:56:15 -0700 (PDT) Received: from mactruck.svl.corp.google.com ([100.123.242.94]) by smtp.gmail.com with ESMTPSA id p17sm7978206pfi.7.2016.09.09.18.56.14 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Fri, 09 Sep 2016 18:56:15 -0700 (PDT) From: Brendan Higgins To: wsa@the-dreams.de, robh+dt@kernel.org, mark.rutland@arm.com Cc: linux-i2c@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, openbmc@lists.ozlabs.org, joel@jms.id.au, jk@ozlabs.org, Brendan Higgins Subject: [PATCH v2 2/2] i2c: aspeed: added documentation for Aspeed I2C driver Date: Fri, 9 Sep 2016 18:55:51 -0700 Message-Id: <1473472551-11149-2-git-send-email-brendanhiggins@google.com> X-Mailer: git-send-email 2.8.0.rc3.226.g39d4020 In-Reply-To: <1473472551-11149-1-git-send-email-brendanhiggins@google.com> References: <201609100847.j1qUadzy%fengguang.wu@intel.com> <1473472551-11149-1-git-send-email-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 controller and busses. Signed-off-by: Brendan Higgins --- Changes for v2: - None --- .../devicetree/bindings/i2c/i2c-aspeed.txt | 63 ++++++++++++++++++++++ 1 file changed, 63 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 0000000..df68f2a --- /dev/null +++ b/Documentation/devicetree/bindings/i2c/i2c-aspeed.txt @@ -0,0 +1,63 @@ +Device tree configuration for the I2C controller and busses on the AST24XX +and AST25XX SoCs. + +Controller: + + Required Properties: + - #address-cells : should be 1 + - #size-cells : should be 1 + - #interrupt-cells : should be 1 + - compatible : should be "aspeed,ast2400-i2c-controller" + or "aspeed,ast2500-i2c-controller" + - reg : address start and range of controller + - ranges : defines address offset and range for busses + - interrupts : interrupt number + - clocks : root clock of bus, should reference the APB + clock + - clock-ranges : specifies that child busses can inherit clocks + - interrupt-controller : denotes that the controller receives and fires + new interrupts for child busses + +Bus: + + 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" + - bus : the bus's number + - interrupts : interrupt number + + Optional Properties: + - clock-frequency : frequency of the bus clock in Hz + defaults to 100 kHz when not specified + +Example: + +i2c: i2c@1e78a000 { + #address-cells = <1>; + #size-cells = <1>; + #interrupt-cells = <1>; + + compatible = "aspeed,ast2400-i2c-controller"; + reg = <0x1e78a000 0x40>; + ranges = <0 0x1e78a000 0x1000>; + interrupts = <12>; + clocks = <&clk_apb>; + clock-ranges; + interrupt-controller; + + i2c0: i2c-bus@40 { + #address-cells = <1>; + #size-cells = <0>; + reg = <0x40 0x40>; + compatible = "aspeed,ast2400-i2c-bus"; + bus = <0>; + clock-frequency = <100000>; + status = "disabled"; + interrupts = <0>; + interrupt-parent = <&i2c>; + }; +}; +