Tom Rini | 53633a8 | 2024-02-29 12:33:36 -0500 | [diff] [blame] | 1 | LIS302 accelerometer devicetree bindings |
| 2 | |
| 3 | This device is matched via its bus drivers, and has a number of properties |
| 4 | that apply in on the generic device (independent from the bus). |
| 5 | |
| 6 | |
| 7 | Required 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 | |
| 14 | Required 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 | |
| 21 | Optional 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 | |
| 65 | Example 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 | |
| 90 | Example 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 | |