From ce693e13120eba86e5591d0d270ed7a0d703a87b Mon Sep 17 00:00:00 2001 From: Anton Viktorov Date: Sun, 15 Mar 2026 21:32:14 +0100 Subject: [PATCH] [lis2dh12] Add base accelerometer component documentation (I2C) --- public/images/lis2dh12.jpg | Bin 0 -> 11510 bytes src/content/docs/components/index.mdx | 1 + .../docs/components/sensor/lis2dh12.mdx | 83 ++++++++++++++++++ 3 files changed, 84 insertions(+) create mode 100644 public/images/lis2dh12.jpg create mode 100644 src/content/docs/components/sensor/lis2dh12.mdx diff --git a/public/images/lis2dh12.jpg b/public/images/lis2dh12.jpg new file mode 100644 index 0000000000000000000000000000000000000000..dedb6bb2753ecc655d2b0d8a3713c84458586881 GIT binary patch literal 11510 zcmb7qWmFunv+v?gf#Obq;uL3*EwZq&2ds{k;7_zm7$JY3?p1aC=6 zh{@QsWK z|Bn&`5>irHN?I{`da-alMZNIj*SRWo%We8&@%NJLC8sh(fg z!|UtWF?2@{H9RRmoc95mWrNhW;?_GI*5vH;AZ1@~7{9+naNPa}(wMez()xzk&}f z_q3~YW-27wX4a((#Ow6T{#9!@4L+er?4$6N@?--fz&V7)@W*Kqc_8alKet z?#)cXVsfJ^8N?(?xP(qH)YkiS=>I)Xi?a$w>e6J9PzLCEbkiT8j6RKaA)r2BAzX#; zJ)1uvrl>$WHF1>6=sM2;R%hyKk7l-Ek!5WgHl0=z3O?P)?>{;jz5vE()-gDrD0bP= zCMeQg00jOBOrv)nu2k+(Wb)`t4Eh9VC9dJV-6{>yjyR<61-+WE9j5BWwnrwbDVf#+ zqMI83P-@LYzBh^1I7uAJkLjaB4>AL`myJU05eB7{_O=5K4fqdQ7Hz+4(cEki8LK8@ z2C*tz0hkJkaz1?)6d58Y30E!txT-mD%nf`)oKPrKW7^w;B7iK3SH|;|@pWIpalK13 z8^k3w#oJB|a%8BEj7}2Lf29iU28**ew|=1|O7Sb5$}jaPLLT!Vz4f9QCqhzJtW?NO zn^sbxFf?X#&$>T-QZuk3T*S0Bo&qWbRp#(OBP&Pt!N-&=cLrwFGmYkH>n9x!f9Kv1 zQU*`?eR6hk<{o1_48jUj$O;?n_7P_yRhUO}+8mnlvaq#bj4MPA^ky$eNAWUq9m4p7 z_4R1{_l|nanR3*40$&R`$liHmj75v6CZ)KV)aGELz(wb3{|b~$r%>9opc$toe!20) zlxtQU*XF81b2_=%Qb%-XG>n|+O3x$yecJ@^$i<1dO61Wq66KfEo-VqTUBu@=IzisL!IM zP4+41>9Muc@K{VLk{ga0`*_AQe}~+wQiV>LtP$=tgk*3*Rk;G349M7<87(iK^p~M8 z+hy8KOS>u&#}ywQ*_XT`LlwlI)OZL5J8R0{_fpYkEo9fb#B=WT8aro|xB=6fzu#J15U7;9�O=QdB!dXBZC&2vwUX1wX@NGxanv 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 + +## Component/Hub + +The `lis2dh12` sensor platform allows you to use your ST LIS2DH12 ultra-low-power tri-axial +accelerometer ([datasheet](https://www.st.com/resource/en/datasheet/lis2dh12.pdf)) +with ESPHome via the [I²C](/components/i2c) bus. + +LIS2DH12 is a high-performance accelerometer with selectable resolution (12-bit, 10-bit, or 8-bit) +and configurable output data rates from 1 Hz to 5376 Hz. + +This component provides acceleration data in m/s². XYZ axes can be +calibrated and transformed to match the physical orientation of the sensor. + +```yaml +# Example I2C configuration +lis2dh12_i2c: + range: 4G + resolution: high + output_data_rate: 100Hz + update_interval: 10s +``` + +### Configuration variables + +- **update_interval** (*Optional*, [Time](/guides/configuration-types#time)): The interval for updating acceleration sensors. + Defaults to `10s`. + +- **range** (*Optional*, string): The range of the sensor measurements. One of `2G`, `4G`, `8G`, `16G`. + Defaults to `2G` which means it picks up accelerations between `-2g` and `2g`. + +- **resolution** (*Optional*, string): ADC resolution mode. One of `high` (12-bit), `medium` (10-bit), `low` (8-bit). + Defaults to `high`. + +- **output_data_rate** (*Optional*, string): Output data rate. One of `1Hz`, `10Hz`, `25Hz`, `50Hz`, `100Hz`, + `200Hz`, `400Hz`, `1620Hz`, `5376Hz`. Defaults to `100Hz`. + +- **calibration** (*Optional*): + + - **offset_x** (*Optional*, float): X-axis zero position calibration, in m/s². From -4.5 to 4.5. Defaults to `0`. + - **offset_y** (*Optional*, float): Y-axis zero position calibration, in m/s². From -4.5 to 4.5. Defaults to `0`. + - **offset_z** (*Optional*, float): Z-axis zero position calibration, in m/s². From -4.5 to 4.5. Defaults to `0`. + +- **transform** (*Optional*): + + - **mirror_x** (*Optional*, boolean): Mirror X-axis. Defaults to `false`. + - **mirror_y** (*Optional*, boolean): Mirror Y-axis. Defaults to `false`. + - **mirror_z** (*Optional*, boolean): Mirror Z-axis. Defaults to `false`. + - **swap_xy** (*Optional*, boolean): Swap X and Y axis. Defaults to `false`. + +- All options from [I²C Device](/components/i2c#i2c-device). Default address is `0x19`. + +## Sensor + +Acceleration data is available through sensors configuration. +You can use shorthand notation like `acceleration_x: "Acceleration X"` or use regular notation. For +regular notation only the **name** is required. All options from [Sensor](/components/sensor). + +```yaml +sensor: + - platform: lis2dh12_base + acceleration_x: Accel X + acceleration_y: Accel Y + acceleration_z: Accel Z +``` + +### Configuration variables + +- **acceleration_x** (*Optional*): X-axis acceleration, m/s². +- **acceleration_y** (*Optional*): Y-axis acceleration, m/s². +- **acceleration_z** (*Optional*): Z-axis acceleration, m/s². + +## See Also + +- [Sensor Filters](/components/sensor#sensor-filters) +-