xref: /OK3568_Linux_fs/kernel/Documentation/devicetree/bindings/gpio/gpio-max3191x.txt (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593SmuzhiyunGPIO driver for Maxim MAX3191x industrial serializer
2*4882a593Smuzhiyun
3*4882a593SmuzhiyunRequired properties:
4*4882a593Smuzhiyun - compatible:		Must be one of:
5*4882a593Smuzhiyun			"maxim,max31910"
6*4882a593Smuzhiyun			"maxim,max31911"
7*4882a593Smuzhiyun			"maxim,max31912"
8*4882a593Smuzhiyun			"maxim,max31913"
9*4882a593Smuzhiyun			"maxim,max31953"
10*4882a593Smuzhiyun			"maxim,max31963"
11*4882a593Smuzhiyun - reg: 		Chip select number.
12*4882a593Smuzhiyun - gpio-controller:	Marks the device node as a GPIO controller.
13*4882a593Smuzhiyun - #gpio-cells: 	Should be two. For consumer use see gpio.txt.
14*4882a593Smuzhiyun
15*4882a593SmuzhiyunOptional properties:
16*4882a593Smuzhiyun - #daisy-chained-devices:
17*4882a593Smuzhiyun			Number of chips in the daisy-chain (default is 1).
18*4882a593Smuzhiyun - maxim,modesel-gpios: GPIO pins to configure modesel of each chip.
19*4882a593Smuzhiyun			The number of GPIOs must equal "#daisy-chained-devices"
20*4882a593Smuzhiyun			(if each chip is driven by a separate pin) or 1
21*4882a593Smuzhiyun			(if all chips are wired to the same pin).
22*4882a593Smuzhiyun - maxim,fault-gpios: 	GPIO pins to read fault of each chip.
23*4882a593Smuzhiyun			The number of GPIOs must equal "#daisy-chained-devices"
24*4882a593Smuzhiyun			or 1.
25*4882a593Smuzhiyun - maxim,db0-gpios:	GPIO pins to configure debounce of each chip.
26*4882a593Smuzhiyun			The number of GPIOs must equal "#daisy-chained-devices"
27*4882a593Smuzhiyun			or 1.
28*4882a593Smuzhiyun - maxim,db1-gpios:	GPIO pins to configure debounce of each chip.
29*4882a593Smuzhiyun			The number of GPIOs must equal "maxim,db0-gpios".
30*4882a593Smuzhiyun - maxim,modesel-8bit:	Boolean whether the modesel pin of the chips is
31*4882a593Smuzhiyun			pulled high (8-bit mode).  Use this if the modesel pin
32*4882a593Smuzhiyun			is hardwired and consequently "maxim,modesel-gpios"
33*4882a593Smuzhiyun			cannot be specified.  By default if neither this nor
34*4882a593Smuzhiyun			"maxim,modesel-gpios" is given, the driver assumes
35*4882a593Smuzhiyun			that modesel is pulled low (16-bit mode).
36*4882a593Smuzhiyun - maxim,ignore-undervoltage:
37*4882a593Smuzhiyun			Boolean whether to ignore undervoltage alarms signaled
38*4882a593Smuzhiyun			by the "maxim,fault-gpios" or by the status byte
39*4882a593Smuzhiyun			(in 16-bit mode).  Use this if the chips are powered
40*4882a593Smuzhiyun			through 5VOUT instead of VCC24V, in which case they
41*4882a593Smuzhiyun			will constantly signal undervoltage.
42*4882a593Smuzhiyun
43*4882a593SmuzhiyunFor other required and optional properties of SPI slave nodes please refer to
44*4882a593Smuzhiyun../spi/spi-bus.txt.
45*4882a593Smuzhiyun
46*4882a593SmuzhiyunExample:
47*4882a593Smuzhiyun	gpio@0 {
48*4882a593Smuzhiyun		compatible = "maxim,max31913";
49*4882a593Smuzhiyun		reg = <0>;
50*4882a593Smuzhiyun		gpio-controller;
51*4882a593Smuzhiyun		#gpio-cells = <2>;
52*4882a593Smuzhiyun
53*4882a593Smuzhiyun		maxim,modesel-gpios = <&gpio2 23>;
54*4882a593Smuzhiyun		maxim,fault-gpios   = <&gpio2 24 GPIO_ACTIVE_LOW>;
55*4882a593Smuzhiyun		maxim,db0-gpios     = <&gpio2 25>;
56*4882a593Smuzhiyun		maxim,db1-gpios     = <&gpio2 26>;
57*4882a593Smuzhiyun
58*4882a593Smuzhiyun		spi-max-frequency = <25000000>;
59*4882a593Smuzhiyun	};
60