xref: /freebsd/sys/contrib/device-tree/Bindings/iio/accel/lis302.txt (revision ccb59683b98360afaf5b5bb641a68fea22c68d0b)
1LIS302 accelerometer devicetree bindings
2
3This device is matched via its bus drivers, and has a number of properties
4that apply in on the generic device (independent from the bus).
5
6
7Required properties for the SPI bindings:
8 - compatible: 		should be set to "st,lis3lv02d-spi"
9 - reg:			the chipselect index
10 - spi-max-frequency:	maximal bus speed, should be set to 1000000 unless
11			constrained by external circuitry
12 - interrupts:		the interrupt generated by the device
13
14Required properties for the I2C bindings:
15 - compatible:		should be set to "st,lis3lv02d"
16 - reg:			i2c slave address
17 - Vdd-supply:		The input supply for Vdd
18 - Vdd_IO-supply:	The input supply for Vdd_IO
19
20
21Optional properties for all bus drivers:
22
23 - st,click-single-{x,y,z}:	if present, tells the device to issue an
24				interrupt on single click events on the
25				x/y/z axis.
26 - st,click-double-{x,y,z}:	if present, tells the device to issue an
27				interrupt on double click events on the
28				x/y/z axis.
29 - st,click-thresh-{x,y,z}:	set the x/y/z axis threshold
30 - st,click-click-time-limit:	click time limit, from 0 to 127.5msec
31				with step of 0.5 msec
32 - st,click-latency:		click latency, from 0 to 255 msec with
33				step of 1 msec.
34 - st,click-window:		click window, from 0 to 255 msec with
35				step of 1 msec.
36 - st,irq{1,2}-disable:		disable IRQ 1/2
37 - st,irq{1,2}-ff-wu-1:		raise IRQ 1/2 on FF_WU_1 condition
38 - st,irq{1,2}-ff-wu-2:		raise IRQ 1/2 on FF_WU_2 condition
39 - st,irq{1,2}-data-ready:	raise IRQ 1/2 on data ready contition
40 - st,irq{1,2}-click:		raise IRQ 1/2 on click condition
41 - st,irq-open-drain:		consider IRQ lines open-drain
42 - st,irq-active-low:		make IRQ lines active low
43 - st,wu-duration-1:		duration register for Free-Fall/Wake-Up
44				interrupt 1
45 - st,wu-duration-2:		duration register for Free-Fall/Wake-Up
46				interrupt 2
47 - st,wakeup-{x,y,z}-{lo,hi}:	set wakeup condition on x/y/z axis for
48				upper/lower limit
49 - st,wakeup-threshold:		set wakeup threshold
50 - st,wakeup2-{x,y,z}-{lo,hi}:	set wakeup condition on x/y/z axis for
51				upper/lower limit for second wakeup
52				engine.
53 - st,wakeup2-threshold:	set wakeup threshold for second wakeup
54				engine.
55 - st,highpass-cutoff-hz=:	1, 2, 4 or 8 for 1Hz, 2Hz, 4Hz or 8Hz of
56				highpass cut-off frequency
57 - st,hipass{1,2}-disable:	disable highpass 1/2.
58 - st,default-rate=:		set the default rate
59 - st,axis-{x,y,z}=:		set the axis to map to the three coordinates.
60				Negative values can be used for inverted axis.
61 - st,{min,max}-limit-{x,y,z}	set the min/max limits for x/y/z axis
62				(used by self-test)
63
64
65Example for a SPI device node:
66
67	accelerometer@0 {
68		compatible = "st,lis302dl-spi";
69		reg = <0>;
70		spi-max-frequency = <1000000>;
71		interrupt-parent = <&gpio>;
72		interrupts = <104 0>;
73
74		st,click-single-x;
75		st,click-single-y;
76		st,click-single-z;
77		st,click-thresh-x = <10>;
78		st,click-thresh-y = <10>;
79		st,click-thresh-z = <10>;
80		st,irq1-click;
81		st,irq2-click;
82		st,wakeup-x-lo;
83		st,wakeup-x-hi;
84		st,wakeup-y-lo;
85		st,wakeup-y-hi;
86		st,wakeup-z-lo;
87		st,wakeup-z-hi;
88	};
89
90Example for a I2C device node:
91
92	lis331dlh: accelerometer@18 {
93		compatible = "st,lis331dlh", "st,lis3lv02d";
94		reg = <0x18>;
95		Vdd-supply = <&lis3_reg>;
96		Vdd_IO-supply = <&lis3_reg>;
97
98		st,click-single-x;
99		st,click-single-y;
100		st,click-single-z;
101		st,click-thresh-x = <10>;
102		st,click-thresh-y = <10>;
103		st,click-thresh-z = <10>;
104		st,irq1-click;
105		st,irq2-click;
106		st,wakeup-x-lo;
107		st,wakeup-x-hi;
108		st,wakeup-y-lo;
109		st,wakeup-y-hi;
110		st,wakeup-z-lo;
111		st,wakeup-z-hi;
112		st,min-limit-x = <120>;
113		st,min-limit-y = <120>;
114		st,min-limit-z = <140>;
115		st,max-limit-x = <550>;
116		st,max-limit-y = <550>;
117		st,max-limit-z = <750>;
118	};
119
120