xref: /freebsd/sys/contrib/device-tree/Bindings/gpio/wd,mbl-gpio.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel VadotBindings for the Western Digital's MyBook Live memory-mapped GPIO controllers.
2*c66ec88fSEmmanuel Vadot
3*c66ec88fSEmmanuel VadotThe Western Digital MyBook Live has two memory-mapped GPIO controllers.
4*c66ec88fSEmmanuel VadotBoth GPIO controller only have a single 8-bit data register, where GPIO
5*c66ec88fSEmmanuel Vadotstate can be read and/or written.
6*c66ec88fSEmmanuel Vadot
7*c66ec88fSEmmanuel VadotRequired properties:
8*c66ec88fSEmmanuel Vadot	- compatible: should be "wd,mbl-gpio"
9*c66ec88fSEmmanuel Vadot	- reg-names: must contain
10*c66ec88fSEmmanuel Vadot		"dat" - data register
11*c66ec88fSEmmanuel Vadot	- reg: address + size pairs describing the GPIO register sets;
12*c66ec88fSEmmanuel Vadot		order must correspond with the order of entries in reg-names
13*c66ec88fSEmmanuel Vadot	- #gpio-cells: must be set to 2. The first cell is the pin number and
14*c66ec88fSEmmanuel Vadot			the second cell is used to specify the gpio polarity:
15*c66ec88fSEmmanuel Vadot			0 = active high
16*c66ec88fSEmmanuel Vadot			1 = active low
17*c66ec88fSEmmanuel Vadot	- gpio-controller: Marks the device node as a gpio controller.
18*c66ec88fSEmmanuel Vadot
19*c66ec88fSEmmanuel VadotOptional properties:
20*c66ec88fSEmmanuel Vadot	- no-output: GPIOs are read-only.
21*c66ec88fSEmmanuel Vadot
22*c66ec88fSEmmanuel VadotExamples:
23*c66ec88fSEmmanuel Vadot	gpio0: gpio0@e0000000 {
24*c66ec88fSEmmanuel Vadot		compatible = "wd,mbl-gpio";
25*c66ec88fSEmmanuel Vadot		reg-names = "dat";
26*c66ec88fSEmmanuel Vadot		reg = <0xe0000000 0x1>;
27*c66ec88fSEmmanuel Vadot		#gpio-cells = <2>;
28*c66ec88fSEmmanuel Vadot		gpio-controller;
29*c66ec88fSEmmanuel Vadot	};
30*c66ec88fSEmmanuel Vadot
31*c66ec88fSEmmanuel Vadot	gpio1: gpio1@e0100000 {
32*c66ec88fSEmmanuel Vadot		compatible = "wd,mbl-gpio";
33*c66ec88fSEmmanuel Vadot		reg-names = "dat";
34*c66ec88fSEmmanuel Vadot		reg = <0xe0100000 0x1>;
35*c66ec88fSEmmanuel Vadot		#gpio-cells = <2>;
36*c66ec88fSEmmanuel Vadot		gpio-controller;
37*c66ec88fSEmmanuel Vadot		no-output;
38*c66ec88fSEmmanuel Vadot	};
39