[PATCH v2 1/3] i2c: hix5hd2: add devicetree documentation

On Tuesday 30 September 2014 17:25:25 zhangfei wrote:

On 09/30/2014 05:01 PM, Arnd Bergmann wrote:

quoted

On Sunday 28 September 2014 12:22:07 Zhangfei Gao wrote:

quoted

+
+Required properties:
+- compatible: Must be "hisilicon,hix5hd2-i2c"
+  Specifically, the following versions of the chipset are supported:
+         Hi3716CV200 (support six I2C module)
+         Hi3719CV100 (support six I2C module)
+         Hi3718CV100 (support six I2C module)
+         Hi3719MV100 (support two I2C module)
+         Hi3718MV100 (support two I2C module)

How do you detect the specific model? Is there a hardware register that
lets you know the type?
If you have a device specific "compatible" string, you should list all
the known strings.

In fact, no need to distinguish these hardware, the only difference is 
i2c module number.
The same compatible is used.

Ah, so you have multiple nodes in those cases, not just one node with
a variable number of I2C hosts. I was a bit confused by the
description

These info can be removed to remove the confusion.

Yes, I think that would be better, both because it avoids the confusion,
and because it means you can use the driver for future machines without
having to update the binding each time.

	Arnd