Patchwork [v2,1/2] i2c: sunxi: add P2WI DT bindings documentation

login
register
mail settings
Submitter Boris BREZILLON
Date May 7, 2014, 5:58 p.m.
Message ID <1399485515-11243-2-git-send-email-boris.brezillon@free-electrons.com>
Download mbox | patch
Permalink /patch/346756/
State New
Headers show

Comments

Boris BREZILLON - May 7, 2014, 5:58 p.m.
P2WI (Push/Pull 2 Wire Interface) is an SMBus like bus used to communicate
with some PMICs (like the AXP221).

Document P2WI DT bindings which are pretty much the same as the one defined
for the marvell's mv64xxx controller.

Signed-off-by: Boris BREZILLON <boris.brezillon@free-electrons.com>
---
 .../devicetree/bindings/i2c/i2c-sunxi-p2wi.txt     | 45 ++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 Documentation/devicetree/bindings/i2c/i2c-sunxi-p2wi.txt

Patch

diff --git a/Documentation/devicetree/bindings/i2c/i2c-sunxi-p2wi.txt b/Documentation/devicetree/bindings/i2c/i2c-sunxi-p2wi.txt
new file mode 100644
index 0000000..2574219
--- /dev/null
+++ b/Documentation/devicetree/bindings/i2c/i2c-sunxi-p2wi.txt
@@ -0,0 +1,45 @@ 
+
+* Allwinner P2WI (Push/Pull 2 Wire Interface) controller
+
+Required properties :
+
+ - reg             : Offset and length of the register set for the device.
+ - compatible      : Should one of the following:
+                     - "allwinner,sun6i-a31-p2wi"
+ - interrupts      : The interrupt line connected to the P2WI peripheral.
+ - clocks          : The gate clk connected to the P2WI peripheral.
+ - resets          : The reset line connected to the P2WI peripheral.
+
+Optional properties :
+
+ - clock-frequency : Desired P2WI bus clock frequency in Hz. If not set the
+default frequency is 100kHz
+
+A P2WI may contain one child node encoding a P2WI slave device.
+
+Slave device properties:
+  Required properties:
+   - reg                    : the I2C slave address used during the
+                              initialization process to switch from I2C to
+                              P2WI mode
+
+  Optional:
+   - allwinner,p2wi-mode-reg: the slave register used to select the device
+                              mode (either I2C or P2WI)
+   - allwinner,p2wi-mode-val: the P2WI mode val to set in the P2WI mode
+                              register in order to switch from I2C to P2WI
+                              mode
+
+   If one these optional properties is not specified, the driver assumes the
+   slave device is already configured in P2WI mode.
+
+Example:
+
+	p2wi@01f03400 {
+		compatible = "allwinner,sun6i-a31-p2wi";
+		reg = <0x01f03400 0x400>;
+		interrupts = <0 39 4>;
+		clocks = <&apb0_gates 3>;
+		clock-frequency = <6000000>;
+		resets = <&apb0_rst 3>;
+	};