iio: accel: adxl345: Implement event scaling and ABI compliance
Subsystems (3)
v5 cover iio: accel: adxl345: Implement event scaling and ABI compliance
This series addresses ADXL345 driver non-compliance with the IIO ABI.
Currently, the driver exposes raw threshold values without a scale factor to convert them to SI units (m/s^2). It also hides the double tap threshold value because it shares a hardware register with single tap, which violates ABI expectations.
This series implements IIO_EV_INFO_SCALE in the IIO core and applies it to the ADXL345 driver. It also exposes the missing IIO_EV_INFO_VALUE for double tap, ensuring userspace can correctly interpret all events, and cleans up related documentation.
Changes in v5:
- Split the series into 5 patches for better logical separation.
- Patch 1: Moved alphabetical sorting of the event attribute table here (David Lechner).
- Patch 3 (new): Expose IIO_EV_INFO_VALUE for the double tap event to ensure ABI compliance (Jonathan Cameron).
- Patch 5: Add the newly exposed in_accel_gesture_doubletap_value to the documentation.
Changes in v4:
- Fixed missing IIO_EV_INFO_SCALE handling for MAG/MAG_ADAPTIVE events.
- Explicitly rejected writes to IIO_EV_INFO_SCALE with -EINVAL.
- Fixed bitmask ordering and whitespace alignment.
- Updated documentation with exact sysfs scale attributes.
Changes in v3:
- Reverted "axis" to "axes" in documentation.
- Removed repetitive scale values from documentation table.
Changes in v2:
- Added core infrastructure for IIO_EV_INFO_SCALE.
- Implemented event scaling (0.612915 m/s^2) for ADXL345.
Thanks to David Lechner for the structural patch feedback and Jonathan Cameron for the architectural guidance on ABI compliance.
Taha Ed-Dafili (5):
docs: iio: adxl345: grammar and formatting cleanups
iio: core: Add IIO_EV_INFO_SCALE to event info
iio: accel: adxl345: Expose IIO_EV_INFO_VALUE for double tap
iio: accel: adxl345: Implement event scaling for ABI compliance
docs: iio: adxl345: update event attributes and scaling math
Documentation/iio/adxl345.rst | 81 ++++++++++++++++++++------------ drivers/iio/accel/adxl345_core.c | 38 ++++++++++----- drivers/iio/industrialio-event.c | 1 + include/linux/iio/types.h | 1 + 4 files changed, 81 insertions(+), 40 deletions(-)
Signature · 1 line
2.47.3
PATCH v5 1/5 docs: iio: adxl345: grammar and formatting cleanups
Correct several grammatical errors, typos, and pluralization issues throughout the ADXL345 documentation.
Key changes include:
- Changing 'generic' to 'general-purpose'
- Correcting 'axis' to 'axes' in multiple tables and descriptions
- Improving phrasing in the device attributes section
- Fixing 'latent' to 'latency' in usage examples
- Sorting the existing event attribute table alphabetically for better readability and to establish a clean baseline for future additions.
--- Documentation/iio/adxl345.rst | 36 +++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-)
Documentation/iio/adxl345.rst +18 -18
@@ -12,16 +12,16 @@ This driver supports Analog Device's ADXL345/375 on SPI/I2C bus. * `ADXL345 <https://www.analog.com/ADXL345>`_ * `ADXL375 <https://www.analog.com/ADXL375>`_ -The ADXL345 is a generic purpose low power, 3-axis accelerometer with selectable +The ADXL345 is a general-purpose, low-power, 3-axis accelerometer with selectable measurement ranges. The ADXL345 supports the ±2 g, ±4 g, ±8 g, and ±16 g ranges. 2. Device Attributes ==================== -Each IIO device, has a device folder under ``/sys/bus/iio/devices/iio:deviceX``, +Each IIO device has a device folder under ``/sys/bus/iio/devices/iio:deviceX``, where X is the IIO index of the device. Under these folders reside a set of device files, depending on the characteristics and features of the hardware -device in questions. These files are consistently generalized and documented in +device in question. These files are consistently generalized and documented in the IIO ABI documentation. The following table shows the ADXL345 related device files, found in the
@@ -42,7 +42,7 @@ specific device folder path ``/sys/bus/iio/devices/iio:deviceX``. +-------------------------------------------+----------------------------------------------------------+ | in_accel_x_raw | Raw X-axis accelerometer channel value. | +-------------------------------------------+----------------------------------------------------------+ -| in_accel_y_calibbias | y-axis acceleration offset correction | +| in_accel_y_calibbias | Y-axis acceleration offset correction | +-------------------------------------------+----------------------------------------------------------+ | in_accel_y_raw | Raw Y-axis accelerometer channel value. | +-------------------------------------------+----------------------------------------------------------+
@@ -68,7 +68,7 @@ present, simply assume its value is 0. +-------------------------------------+---------------------------+ | Channel type | Measurement unit | +-------------------------------------+---------------------------+ -| Acceleration on X, Y, and Z axis | Meters per second squared | +| Acceleration on X, Y, and Z axes | Meters per second squared | +-------------------------------------+---------------------------+ Sensor Events
@@ -78,8 +78,8 @@ Specific IIO events are triggered by their corresponding interrupts. The sensor driver supports either none or a single active interrupt (INT) line, selectable from the two available options: INT1 or INT2. The active INT line should be specified in the device tree. If no INT line is configured, the sensor defaults -to FIFO bypass mode, where event detection is disabled and only X, Y, and Z axis -measurements are available. +to FIFO bypass mode, where event detection is disabled and only individual +X, Y, and Z axis measurements are available. The table below lists the ADXL345-related device files located in the device-specific path: ``/sys/bus/iio/devices/iio:deviceX/events``.
@@ -90,37 +90,37 @@ listed. +---------------------------------------------+---------------------------------------------+ | Event handle | Description | +---------------------------------------------+---------------------------------------------+ -| in_accel_gesture_doubletap_en | Enable double tap detection on all axis | +| in_accel_gesture_doubletap_en | Enable double tap detection on all axes | +---------------------------------------------+---------------------------------------------+ | in_accel_gesture_doubletap_reset_timeout | Double tap window in [us] | +---------------------------------------------+---------------------------------------------+ -| in_accel_gesture_doubletap_tap2_min_delay | Double tap latent in [us] | +| in_accel_gesture_doubletap_tap2_min_delay | Double tap latency in [us] | +---------------------------------------------+---------------------------------------------+ | in_accel_gesture_singletap_timeout | Single tap duration in [us] | +---------------------------------------------+---------------------------------------------+ | in_accel_gesture_singletap_value | Single tap threshold value in 62.5/LSB | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_falling_period | Inactivity time in seconds | +| in_accel_mag_adaptive_falling_period | AC coupled inactivity time in seconds | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_falling_value | Inactivity threshold value in 62.5/LSB | +| in_accel_mag_adaptive_falling_value | AC coupled inactivity threshold in 62.5/LSB | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_adaptive_rising_en | Enable AC coupled activity on X axis | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_adaptive_falling_period | AC coupled inactivity time in seconds | +| in_accel_mag_adaptive_rising_value | AC coupled activity threshold in 62.5/LSB | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_adaptive_falling_value | AC coupled inactivity threshold in 62.5/LSB | +| in_accel_mag_falling_period | Inactivity time in seconds | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_adaptive_rising_value | AC coupled activity threshold in 62.5/LSB | +| in_accel_mag_falling_value | Inactivity threshold value in 62.5/LSB | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_rising_en | Enable activity detection on X axis | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_rising_value | Activity threshold value in 62.5/LSB | +---------------------------------------------+---------------------------------------------+ -| in_accel_x_gesture_singletap_en | Enable single tap detection on X axis | +| in_accel_x&y&z_mag_adaptive_falling_en | Enable AC coupled inactivity on all axes | +---------------------------------------------+---------------------------------------------+ -| in_accel_x&y&z_mag_falling_en | Enable inactivity detection on all axis | +| in_accel_x&y&z_mag_falling_en | Enable inactivity detection on all axes | +---------------------------------------------+---------------------------------------------+ -| in_accel_x&y&z_mag_adaptive_falling_en | Enable AC coupled inactivity on all axis | +| in_accel_x_gesture_singletap_en | Enable single tap detection on X axis | +---------------------------------------------+---------------------------------------------+ | in_accel_y_gesture_singletap_en | Enable single tap detection on Y axis | +---------------------------------------------+---------------------------------------------+
@@ -330,7 +330,7 @@ Configure one or several events: ## doubletap, window [us] root:/sys/bus/iio/devices/iio:device0> echo 0.025 > ./events/in_accel_gesture_doubletap_reset_timeout - ## doubletap, latent [us] + ## doubletap, latency [us] root:/sys/bus/iio/devices/iio:device0> echo 0.025 > ./events/in_accel_gesture_doubletap_tap2_min_delay ## AC coupled activity, enable
Signature · 1 line
2.47.3
PATCH v5 2/5 iio: core: Add IIO_EV_INFO_SCALE to event info
In reply to Taha Ed-DafiliImplement support for IIO_EV_INFO_SCALE in the internal enum iio_event_info to allow proper ABI compliance.
This allows drivers (like the ADXL345) to expose event scale attributes using the standard IIO ABI rather than manual device attributes.
--- drivers/iio/industrialio-event.c | 1 + include/linux/iio/types.h | 1 + 2 files changed, 2 insertions(+)
drivers/iio/industrialio-event.c +1 -0
@@ -256,6 +256,7 @@ static const char * const iio_ev_info_text[] = { [IIO_EV_INFO_TAP2_MIN_DELAY] = "tap2_min_delay", [IIO_EV_INFO_RUNNING_PERIOD] = "runningperiod", [IIO_EV_INFO_RUNNING_COUNT] = "runningcount", + [IIO_EV_INFO_SCALE] = "scale", };static enum iio_event_direction iio_ev_attr_dir (struct iio_dev_attr *attr)
include/linux/iio/types.h +1 -0
@@ -21,6 +21,7 @@ enum iio_event_info {IIO_EV_INFO_TAP2_MIN_DELAY ,IIO_EV_INFO_RUNNING_PERIOD ,IIO_EV_INFO_RUNNING_COUNT , + IIO_EV_INFO_SCALE, };#define IIO_VAL_INT 1
Signature · 1 line
2.47.3
PATCH v5 3/5 iio: accel: adxl345: Expose IIO_EV_INFO_VALUE for double tap
In reply to Taha Ed-DafiliThe ADXL345 uses a single hardware register (ADXL345_REG_THRESH_TAP) to store the threshold for both single tap and double tap events.
Currently, the driver only exposes the IIO_EV_INFO_VALUE attribute for the single tap event.
However, the IIO ABI dictates that if an event is supported, its associated configuration attributes should be exposed to userspace. This applies even if writing to one channel property alters the value of another due to shared underlying hardware state.
Add IIO_EV_INFO_VALUE to the double tap event specification to ensure full ABI compliance.
--- drivers/iio/accel/adxl345_core.c | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-)
drivers/iio/accel/adxl345_core.c +4 -2
@@ -235,8 +235,10 @@ static const struct iio_event_spec adxl345_events[] = {/* double tap */ .type = IIO_EV_TYPE_GESTURE, .dir = IIO_EV_DIR_DOUBLETAP, - .mask_shared_by_type =BIT (IIO_EV_INFO_ENABLE ) | -BIT (IIO_EV_INFO_RESET_TIMEOUT ) | + .mask_shared_by_type = +BIT (IIO_EV_INFO_ENABLE ) | +BIT (IIO_EV_INFO_VALUE ) | +BIT (IIO_EV_INFO_RESET_TIMEOUT ) | BIT(IIO_EV_INFO_TAP2_MIN_DELAY), }, };
Signature · 1 line
2.47.3
Re: [PATCH v5 3/5] iio: accel: adxl345: Expose IIO_EV_INFO_VALUE for double tap
Quoted 13 lines · Taha Ed-Dafili
The ADXL345 uses a single hardware register (
ADXL345_REG_THRESH_TAP) to store the threshold for both single tap and double tap events.Currently, the driver only exposes the
IIO_EV_INFO_VALUEattribute for the single tap event.However, the IIO ABI dictates that if an event is supported, its associated configuration attributes should be exposed to userspace. This applies even if writing to one channel property alters the value of another due to shared underlying hardware state.
Add
IIO_EV_INFO_VALUEto the double tap event specification to ensure full ABI compliance.
...
drivers/iio/accel/adxl345_core.c static const struct iio_event_spec adxl345_events[] = { · line 241
Quoted 3 lines
drivers/iio/accel/adxl345_core.c +1
-1- BIT(IIO_EV_INFO_RESET_TIMEOUT) | + BIT(IIO_EV_INFO_RESET_TIMEOUT) |
I do not see a reason why the amount of spaces should be increased. The original one space is a gold standard in such cases as it makes independent on the line length. With the formatted | it becomes a burden for maintenance: each time one adds longer line, all lines need to be adjusted for no good reason.
Signature · 2 lines
With Best Regards, Andy Shevchenko
Re: [PATCH v5 3/5] iio: accel: adxl345: Expose IIO_EV_INFO_VALUE for double tap
Quoted 1 line · Andy Shevchenko
On Tue, Feb 24, 2026 at 02:03:46PM +0000, Taha Ed-Dafili wrote:
Side note, in all your emails the Cc list has
whatever it means. This address is bouncing and should not be used. (I removed from my reply as it reminded me again with tons of bounces.)
Signature · 2 lines
With Best Regards, Andy Shevchenko
Re: [PATCH v5 3/5] iio: accel: adxl345: Expose IIO_EV_INFO_VALUE for double tap
Hi Andy,
Thanks for the reviews.
Regarding the bouncing email: it is an archive address for the Linux Foundation Kernel Mentorship Program. The guidelines recommend CCing it for the program application to help with the selection process. However, since it's bouncing, I've dropped it from my CC list, sorry for the spam.
I will send out v6 shortly.
Thanks,
Taha
Re: [PATCH v5 3/5] iio: accel: adxl345: Expose IIO_EV_INFO_VALUE for double tap
Quoted 7 lines · Taha Ed-Dafili
Thanks for the reviews.
Regarding the bouncing email: it is an archive address for the Linux Foundation Kernel Mentorship Program. The guidelines recommend CCing it for the program application to help with the selection process. However, since it's bouncing, I've dropped it from my CC list, sorry for the spam.
Do it Bcc if it's needed.
Signature · 2 lines
With Best Regards, Andy Shevchenko
PATCH v5 4/5 iio: accel: adxl345: Implement event scaling for ABI compliance
In reply to Taha Ed-DafiliThe ADXL345 uses a fixed threshold resolution of 62.5 mg/LSB for event-related registers. Previously, the driver reported raw values without a scale factor.
Implement IIO_EV_INFO_SCALE for all event types to provide the conversion factor (0.612915 m/s^2) as required by the IIO ABI.
Consequently, remove the obsolete comment in adxl345_read_event_value() which stated that the scale factor is not applied.
Add explicit write rejection for IIO_EV_INFO_SCALE in adxl345_write_event_value() returning -EINVAL.
--- drivers/iio/accel/adxl345_core.c | 32 +++++++++++++++++++++++--------- 1 file changed, 23 insertions(+), 9 deletions(-)
drivers/iio/accel/adxl345_core.c +23 -9
@@ -213,7 +213,8 @@ static const struct iio_event_spec adxl345_events[] = { .dir = IIO_EV_DIR_RISING, .mask_shared_by_type = BIT(IIO_EV_INFO_ENABLE) | - BIT(IIO_EV_INFO_VALUE), + BIT(IIO_EV_INFO_VALUE) | + BIT(IIO_EV_INFO_SCALE), }, {/* activity, ac bit set */
@@ -221,14 +222,17 @@ static const struct iio_event_spec adxl345_events[] = { .dir = IIO_EV_DIR_RISING, .mask_shared_by_type = BIT(IIO_EV_INFO_ENABLE) | - BIT(IIO_EV_INFO_VALUE), + BIT(IIO_EV_INFO_VALUE) | + BIT(IIO_EV_INFO_SCALE), }, {/* single tap */ .type = IIO_EV_TYPE_GESTURE, .dir = IIO_EV_DIR_SINGLETAP, .mask_separate = BIT(IIO_EV_INFO_ENABLE), - .mask_shared_by_type = BIT(IIO_EV_INFO_VALUE) | + .mask_shared_by_type = + BIT(IIO_EV_INFO_VALUE) | + BIT(IIO_EV_INFO_SCALE) | BIT(IIO_EV_INFO_TIMEOUT), }, {
@@ -238,6 +242,7 @@ static const struct iio_event_spec adxl345_events[] = { .mask_shared_by_type =BIT (IIO_EV_INFO_ENABLE ) |BIT (IIO_EV_INFO_VALUE ) | +BIT (IIO_EV_INFO_SCALE ) |BIT (IIO_EV_INFO_RESET_TIMEOUT ) | BIT(IIO_EV_INFO_TAP2_MIN_DELAY), },
@@ -277,6 +282,7 @@ static const struct iio_event_spec adxl345_fake_chan_events[] = { .mask_separate = BIT(IIO_EV_INFO_ENABLE), .mask_shared_by_type = BIT(IIO_EV_INFO_VALUE) | + BIT(IIO_EV_INFO_SCALE) | BIT(IIO_EV_INFO_PERIOD), }, {
@@ -286,6 +292,7 @@ static const struct iio_event_spec adxl345_fake_chan_events[] = { .mask_separate = BIT(IIO_EV_INFO_ENABLE), .mask_shared_by_type =BIT (IIO_EV_INFO_VALUE ) | +BIT (IIO_EV_INFO_SCALE ) | BIT(IIO_EV_INFO_PERIOD), }, };
@@ -1343,6 +1350,16 @@ static int adxl345_read_event_value(struct iio_dev *indio_dev,unsigned int tap_threshold;int ret; +/* +* The event threshold LSB is fixed at 62.5 mg/LSB +* 0.0625 * 9.80665 = 0.612915625 m/s^2 +*/ +if (info ==IIO_EV_INFO_SCALE ) { + *val =0 ; + *val2 =612915 ; +return IIO_VAL_INT_PLUS_MICRO ; + } +switch (type) {case IIO_EV_TYPE_MAG : return adxl345_read_mag_value(st, dir, info,
@@ -1357,12 +1374,6 @@ static int adxl345_read_event_value(struct iio_dev *indio_dev,case IIO_EV_TYPE_GESTURE :switch (info) {case IIO_EV_INFO_VALUE : -/* -* The scale factor would be 62.5mg/LSB (i.e. 0xFF = 16g) but -* not applied here. In context of this general purpose sensor, -* what imports is rather signal intensity than the absolute -* measured g value. -*/ ret =regmap_read (st->regmap,ADXL345_REG_THRESH_TAP , &tap_threshold);if (ret)
@@ -1403,6 +1414,9 @@ static int adxl345_write_event_value(struct iio_dev *indio_dev,if (ret)return ret; +if (info ==IIO_EV_INFO_SCALE ) +return -EINVAL ; +switch (type) {case IIO_EV_TYPE_MAG : ret = adxl345_write_mag_value(st, dir, info,
Signature · 1 line
2.47.3
Re: [PATCH v5 4/5] iio: accel: adxl345: Implement event scaling for ABI compliance
Quoted 12 lines · Taha Ed-Dafili
The ADXL345 uses a fixed threshold resolution of 62.5 mg/LSB for event-related registers. Previously, the driver reported raw values without a scale factor.
Implement
IIO_EV_INFO_SCALEfor all event types to provide the conversion factor (0.612915 m/s^2) as required by the IIO ABI.Consequently, remove the obsolete comment in
adxl345_read_event_value()which stated that the scale factor is not applied.Add explicit write rejection for
IIO_EV_INFO_SCALEinadxl345_write_event_value()returning-EINVAL.
...
drivers/iio/accel/adxl345_core.c static const struct iio_event_spec adxl345_events[] = { · line 217
Quoted 5 lines
drivers/iio/accel/adxl345_core.c +2
-1.mask_shared_by_type =BIT (IIO_EV_INFO_ENABLE ) | - BIT(IIO_EV_INFO_VALUE), +BIT (IIO_EV_INFO_VALUE ) | + BIT(IIO_EV_INFO_SCALE),
Why SCALE can't be squeezed before VALUE? This change brings unneeded churn.
Signature · 2 lines
With Best Regards, Andy Shevchenko
PATCH v5 5/5 docs: iio: adxl345: update event attributes and scaling math
In reply to Taha Ed-DafiliUpdate the documentation to reflect the recent driver additions for event scaling and the double tap threshold value, alongside correcting existing technical errors in scale calculations.
Key changes:
- Fix the 62.5 g/LSB typo to 62.5 mg/LSB and add SI unit conversion.
- Correct decimal precision of in_accel_scale and in_accel_scale_available to match the actual SI unit (m/s^2) values reported by the driver.
- Document the newly generated event scale attributes in the ABI table (e.g., in_accel_mag_rising_scale, in_accel_gesture_singletap_scale).
- Document the newly exposed in_accel_gesture_doubletap_value attribute.
- Add a sysfs example showing how to read and interpret the newly implemented event scale factor.
--- Documentation/iio/adxl345.rst | 51 +++++++++++++++++++++++++---------- 1 file changed, 37 insertions(+), 14 deletions(-)
Documentation/iio/adxl345.rst +37 -14
@@ -13,7 +13,12 @@ This driver supports Analog Device's ADXL345/375 on SPI/I2C bus. * `ADXL375 <https://www.analog.com/ADXL375>`_ The ADXL345 is a general-purpose, low-power, 3-axis accelerometer with selectable -measurement ranges. The ADXL345 supports the ±2 g, ±4 g, ±8 g, and ±16 g ranges. +measurement ranges. The ADXL345 supports the following ranges: + +- ±2g (approx. ±19.61 m/s^2) +- ±4g (approx. ±39.23 m/s^2) +- ±8g (approx. ±78.45 m/s^2) +- ±16g (approx. ±156.91 m/s^2) 2. Device Attributes ====================
@@ -94,27 +99,41 @@ listed. +---------------------------------------------+---------------------------------------------+ | in_accel_gesture_doubletap_reset_timeout | Double tap window in [us] | +---------------------------------------------+---------------------------------------------+ +| in_accel_gesture_doubletap_scale | Double tap gesture threshold scale. | ++---------------------------------------------+---------------------------------------------+ | in_accel_gesture_doubletap_tap2_min_delay | Double tap latency in [us] | +---------------------------------------------+---------------------------------------------+ +| in_accel_gesture_doubletap_value | Double tap threshold value | ++---------------------------------------------+---------------------------------------------+ +| in_accel_gesture_singletap_scale | Single tap gesture threshold scale. | ++---------------------------------------------+---------------------------------------------+ | in_accel_gesture_singletap_timeout | Single tap duration in [us] | +---------------------------------------------+---------------------------------------------+ -| in_accel_gesture_singletap_value | Single tap threshold value in 62.5/LSB | +| in_accel_gesture_singletap_value | Single tap threshold value | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_adaptive_falling_period | AC coupled inactivity time in seconds | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_adaptive_falling_value | AC coupled inactivity threshold in 62.5/LSB | +| in_accel_mag_adaptive_falling_scale | AC coupled inactivity threshold scale. | ++---------------------------------------------+---------------------------------------------+ +| in_accel_mag_adaptive_falling_value | AC coupled inactivity threshold | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_adaptive_rising_en | Enable AC coupled activity on X axis | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_adaptive_rising_value | AC coupled activity threshold in 62.5/LSB | +| in_accel_mag_adaptive_rising_scale | AC coupled activity threshold scale. | ++---------------------------------------------+---------------------------------------------+ +| in_accel_mag_adaptive_rising_value | AC coupled activity threshold | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_falling_period | Inactivity time in seconds | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_falling_value | Inactivity threshold value in 62.5/LSB | +| in_accel_mag_falling_scale | DC coupled inactivity threshold scale. | ++---------------------------------------------+---------------------------------------------+ +| in_accel_mag_falling_value | Inactivity threshold value | +---------------------------------------------+---------------------------------------------+ | in_accel_mag_rising_en | Enable activity detection on X axis | +---------------------------------------------+---------------------------------------------+ -| in_accel_mag_rising_value | Activity threshold value in 62.5/LSB | +| in_accel_mag_rising_scale | DC coupled activity threshold scale. | ++---------------------------------------------+---------------------------------------------+ +| in_accel_mag_rising_value | Activity threshold value | +---------------------------------------------+---------------------------------------------+ | in_accel_x&y&z_mag_adaptive_falling_en | Enable AC coupled inactivity on all axes | +---------------------------------------------+---------------------------------------------+
@@ -140,8 +159,8 @@ When changing the **g range** configuration, the driver attempts to estimate appropriate activity and inactivity thresholds by scaling the default values based on the ratio of the previous range to the new one. The resulting threshold will never be zero and will always fall between 1 and 255, corresponding to up -to 62.5 g/LSB as specified in the datasheet. However, you can override these -estimated thresholds by setting explicit values. +to 62.5 mg/LSB (0.612915 m/s^2/LSB) as specified in the datasheet. However, +you can override these estimated thresholds by setting explicit values. When **activity** and **inactivity** events are enabled, the driver automatically manages hysteresis behavior by setting the **link** and
@@ -270,13 +289,13 @@ Scale range configuration: .. code-block:: bash root:/sys/bus/iio/devices/iio:device0> cat ./in_accel_scale - 0.478899 + 0.004789 root:/sys/bus/iio/devices/iio:device0> cat ./in_accel_scale_available - 0.478899 0.957798 1.915595 3.831190 + 0.004789 0.009578 0.019156 0.038312 - root:/sys/bus/iio/devices/iio:device0> echo 1.915595 > ./in_accel_scale + root:/sys/bus/iio/devices/iio:device0> echo 0.019156 > ./in_accel_scale root:/sys/bus/iio/devices/iio:device0> cat ./in_accel_scale - 1.915595 + 0.019156 Set output data rate (ODR):
@@ -312,10 +331,14 @@ Configure one or several events: root:/sys/bus/iio/devices/iio:device0> echo 24 > ./buffer0/length - ## AC coupled activity, threshold [62.5/LSB] + ## Check the event scale factor (0.0625 * 9.80665) + root:/sys/bus/iio/devices/iio:device0> cat ./events/in_accel_gesture_doubletap_scale + 0.612915 + + ## AC coupled activity, threshold [0.612915 m/s^2/LSB] root:/sys/bus/iio/devices/iio:device0> echo 6 > ./events/in_accel_mag_adaptive_rising_value - ## AC coupled inactivity, threshold, [62.5/LSB] + ## AC coupled inactivity, threshold, [0.612915 m/s^2/LSB] root:/sys/bus/iio/devices/iio:device0> echo 4 > ./events/in_accel_mag_adaptive_falling_value ## AC coupled inactivity, time [s]
Signature · 1 line
2.47.3