From patchwork Thu May 25 06:49:23 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Brendan Higgins X-Patchwork-Id: 766846 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 3wYKfF0f59z9s8P for ; Thu, 25 May 2017 16:50:45 +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="CzeKL7xK"; dkim-atps=neutral Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1423403AbdEYGun (ORCPT ); Thu, 25 May 2017 02:50:43 -0400 Received: from mail-pf0-f172.google.com ([209.85.192.172]:33552 "EHLO mail-pf0-f172.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1423374AbdEYGuE (ORCPT ); Thu, 25 May 2017 02:50:04 -0400 Received: by mail-pf0-f172.google.com with SMTP id e193so158489740pfh.0 for ; Wed, 24 May 2017 23:49:54 -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=07xCGHzxVwY8KU8LipaOqXkM0AlKm9KhcDajvm+43G4=; b=CzeKL7xKhdysRXJNIZ1yOp/vXGfqOvjETVTycLMU48xyVvSQ/Nc4nU+103n9sys2jc 0kcmrlAcMJ9SemedlPWpc4+X3AIkNmSDRN479VElViEaC/1WCdoveisinvsL4Gdk+5J3 OLGA2IRQboxpwbk586zeQYYoRUUa1XNGtD3xZfTdMcDDgTldNOLpQvCimuTXgkfRnGcC OX49KavAeFp6iYIL7El0g8yO3mO27b9YV9ZL2ALtxi2ujggjwGE05Gg0pWdepwavoDGI pvlsHmzE0YPXSIU2hL9vkjDaYcckeqVHRJ7+u1J7ZXYdqu+32TKghrMAGibcLp/8fEXp mIJA== 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=07xCGHzxVwY8KU8LipaOqXkM0AlKm9KhcDajvm+43G4=; b=uG0OJZrmPGhcF6ZrWgZ3sWhHvGvm1mqw0KJmO0O5SaAwjK/81QlWasQqBkMvZax5+C iQNVeWwzLL0fWX7a5HZtNRzu1lokgRynDZXMCJob7lw1epO5gWBY5l2x0QdL/RB3oi40 VPXA7OV43zcm8No4w08yi9hGhL+HrcgFqt7OAE3kaERFWNJH1yRyEioBso7TyLgQ/iB7 zaJ3wyp1dKMLcsyEwAI0VI6/eGgmmkOlMR2DC7M248c8SQODXwfNr9aDRyTc77T9fHUD ZzFyH0H0dywwSEQ6m2lmkm5Q6UKP3dh7KInSD2pFQp7Np/+G54Br18Ootv9Ea+Ds0wAF r1Bw== X-Gm-Message-State: AODbwcAYfuYJ7P8MEaqBmA4bmIpUAEB5IRUMr/rnxh7ro7yXAUHJlrQf sFCu6pmVx5htozjB X-Received: by 10.98.70.198 with SMTP id o67mr41863850pfi.79.1495694988250; Wed, 24 May 2017 23:49:48 -0700 (PDT) Received: from mactruck.svl.corp.google.com ([100.123.242.94]) by smtp.gmail.com with ESMTPSA id g63sm10995700pgc.59.2017.05.24.23.49.47 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Wed, 24 May 2017 23:49:47 -0700 (PDT) From: Brendan Higgins To: wsa@the-dreams.de, robh+dt@kernel.org, mark.rutland@arm.com, tglx@linutronix.de, jason@lakedaemon.net, marc.zyngier@arm.com, joel@jms.id.au, vz@mleia.com, mouse@mayc.ru, clg@kaod.org, 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 v8 3/5] i2c: aspeed: added documentation for Aspeed I2C driver Date: Wed, 24 May 2017 23:49:23 -0700 Message-Id: <20170525064925.16867-4-brendanhiggins@google.com> X-Mailer: git-send-email 2.13.0.219.gdb65acc882-goog In-Reply-To: <20170525064925.16867-1-brendanhiggins@google.com> References: <20170525064925.16867-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 --- Changes 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 --- .../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>; + }; +};