i2c: mux: Add more warnings to i2c-arb-gpio-challenge docs
authorDoug Anderson <dianders@chromium.org>
Tue, 29 Apr 2014 17:30:51 +0000 (10:30 -0700)
committerWolfram Sang <wsa@the-dreams.de>
Thu, 22 May 2014 08:09:22 +0000 (10:09 +0200)
This adds some more warnings to the i2c-arb-gpio-challenge docs to
help encourage people not to use it in their designs unless they have
no choice.

Signed-off-by: Doug Anderson <dianders@chromium.org>
Signed-off-by: Wolfram Sang <wsa@the-dreams.de>
Documentation/devicetree/bindings/i2c/i2c-arb-gpio-challenge.txt

index 1ac8ea8ade1dc41195cadd93a96daf73acb3a29b..bfeabb843941e0c74f509f25a96e15f3daffa711 100644 (file)
@@ -8,6 +8,12 @@ the standard I2C multi-master rules.  Using GPIOs is generally useful in
 the case where there is a device on the bus that has errata and/or bugs
 that makes standard multimaster mode not feasible.
 
+Note that this scheme works well enough but has some downsides:
+* It is nonstandard (not using standard I2C multimaster)
+* Having two masters on a bus in general makes it relatively hard to debug
+  problems (hard to tell if i2c issues were caused by one master, another, or
+  some device on the bus).
+
 
 Algorithm: