Re: Re: [PATCH 2/3] dt: rfkill-gpio: add bindings documentation

Hi Olof,

Am Sonntag, 5. Februar 2012, 14:00:25 schrieb Olof Johansson:

Hi,

On Sun, Feb 5, 2012 at 9:18 AM, Marc Dietrich [off-list ref] wrote:

quoted

Add device tree bindings information for rfkill gpio switches.

Cc: linux-wireless-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
Cc: "John W. Linville" <redacted>
Cc: Johannes Berg <redacted>
Cc: Rhyland Klein <redacted>
Cc: Grant Likely <grant.likely-s3s/WqlpOiPyB63q8FvJNQ@public.gmane.org>
Signed-off-by: Marc Dietrich <redacted>

Please cc devicetree-discuss-uLR06cmDAlY/bJ5BZ2RsiQ@public.gmane.org on device tree bindings;
not everyone monitors the linux mailing lists.

done.

quoted

diff --git a/Documentation/devicetree/bindings/gpio/rfkill.txt

b/Documentation/devicetree/bindings/gpio/rfkill.txt new file mode 100644
index 0000000..22bf22a

--- /dev/null
+++ b/Documentation/devicetree/bindings/gpio/rfkill.txt

@@ -0,0 +1,38 @@
+RFKILL switches connected to GPIO lines
+
+Required properties:
+- compatible : should be "rfkill-gpio".
+
+Each rfkill switch is represented as a sub-node of the rfkill-gpio device.
+Each node has a label property which represents the name of the corresponding
+rfkill device.
+
+RFKILL sub-node properties:
+- label :  (optional) The label for this rfkill switch.  If omitted, the label

is +  taken from the node name (excluding the unit address).
+- reset-gpio, shutdown-gpio :  Should specify the rfkill gpios for reset and
+  shutdown (see "Specifying GPIO information for devices" in
+  Documentation/devicetree/booting-without-of.txt).
+- type : enumerated type of the gpio (see include/linux/rfkill.h).
+- clock : (optional) name of the clock name associated with the rfkill switch
+  (see include/linux/rfkill-gpio.h)

Sorry, but this is going about things the wrong way.

A device tree binding is meant to describe hardware. For example, the
type and clock properties are clearly linux specifics that shouldn't
be expressed that way in the device tree.

instead, think about what you actually need to provide for a driver to
do its work. Does the wifi device have a gpio to control power (and
one for providing reset outside of the standard interface)? Well, then
that should probably be defined in the node that describes the device
-- i.e. under the sdhci node in question here.

well, that doesn't work in case of paz00 because nearly all devices (including wifi) 
are connected via usb. Only the rfkill switch is controlled via the gpios.

That doesn't fit the rfkill device/driver model perfectly, since it
doesn't have something to bind against, so the rfkill platform device
needs to be instantiated from somewhere else. It's possible that best
match is to have the wifi driver handle it, which should be OK, I
think?

You are right, but in case of usb devices which are not instantiated via device tree 
there is no parent. It doesn't make much sense for me to put it under the usb 
controller because it is independent to it. One may argue that the rfkill switch is a 
separate device, which is controlled via gpio lines. The wifi driver itself has no 
way to modify the gpios itself, it can only read out its status. I'm a bit lost here, 
maybe you have a better solution.

Thanks

Marc