linux-toradex.git/include/linux/iio/imu, branch master

iio: imu: adis: fix all kernel-doc warnings in header file

2025-11-09T12:57:04+00:00

Correct and add to adis.h to resolve all kernel-doc warnings:

- add a missing struct member description
- change one non-kernel-doc comment to use /* instead of /**
- correct function parameter @value to @val (7 locations)
- add function return value comments (13 locations)

Warning: include/linux/iio/imu/adis.h:97 struct member 'has_fifo'
 not described in 'adis_data'
Warning: include/linux/iio/imu/adis.h:139 Incorrect use of kernel-doc
 format: * The state_lock is meant to be used during operations that
 require
Warning: include/linux/iio/imu/adis.h:158 struct member '"__adis_"'
 not described in 'adis'
Warning: include/linux/iio/imu/adis.h:264 function parameter 'val'
 not described in 'adis_write_reg'
Warning: include/linux/iio/imu/adis.h:371 No description found for
 return value of 'adis_update_bits_base'

Signed-off-by: Randy Dunlap 
Reviewed-by: Nuno Sá 
Reviewed-by: Andy Shevchenko 
Signed-off-by: Jonathan Cameron

iio: imu: adis: Add DIAG_STAT register

2025-02-22T12:23:49+00:00

Some devices may have more than 16 bits of status. This patch allows the
user to specify the size of the DIAG_STAT register. It defaults to 2 if
not specified. This is mainly for backward compatibility.

Co-developed-by: Ramona Gradinariu 
Signed-off-by: Ramona Gradinariu 
Co-developed-by: Antoniu Miclaus 
Signed-off-by: Antoniu Miclaus 
Co-developed-by: Nuno Sá 
Signed-off-by: Nuno Sá 
Signed-off-by: Robert Budai 
Link: https://patch.msgid.link/20250217105753.605465-4-robert.budai@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis: Add reset to custom ops

2025-02-22T12:23:19+00:00

This patch allows the custom definition of reset functionality for adis object.
It is useful in cases where the driver does not need to sleep after the reset
since it is handled by the library.

Co-developed-by: Ramona Gradinariu 
Signed-off-by: Ramona Gradinariu 
Co-developed-by: Antoniu Miclaus 
Signed-off-by: Antoniu Miclaus 
Co-developed-by: Nuno Sá 
Signed-off-by: Nuno Sá 
Signed-off-by: Robert Budai 
Link: https://patch.msgid.link/20250217105753.605465-3-robert.budai@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis: Add custom ops struct

2025-02-22T12:22:45+00:00

This patch introduces a custom ops struct letting users define custom read and
write functions. Some adis devices might define a completely different spi
protocol from the one used in the default implementation.

Co-developed-by: Ramona Gradinariu 
Signed-off-by: Ramona Gradinariu 
Co-developed-by: Antoniu Miclaus 
Signed-off-by: Antoniu Miclaus 
Co-developed-by: Nuno Sá 
Signed-off-by: Nuno Sá 
Signed-off-by: Robert Budai 
Link: https://patch.msgid.link/20250217105753.605465-2-robert.budai@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis: Remove documented not used elements

2024-12-07T17:49:11+00:00

This patch removes elements from adis.h that are documented
but not used anymore.

Signed-off-by: Robert Budai 
Link: https://patch.msgid.link/20241125133520.24328-2-robert.budai@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis: remove legacy lock helpers

2024-06-25T20:04:50+00:00

Since all users were converted to the new cleanup based helper,
adis_dev_lock() and adis_dev_unlock() can now be removed from the lib.

Signed-off-by: Nuno Sa 
Link: https://patch.msgid.link/20240618-dev-iio-adis-cleanup-v1-9-bd93ce7845c7@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis: add cleanup based lock helpers

2024-06-25T20:04:49+00:00

Add two new lock helpers that make use of the cleanup guard() and
scoped_guard() macros. Thus, users won't have to worry about unlocking
which is less prone to errors and allows for simpler error paths.

Signed-off-by: Nuno Sa 
Link: https://patch.msgid.link/20240618-dev-iio-adis-cleanup-v1-3-bd93ce7845c7@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis: move to the cleanup magic

2024-06-25T20:04:49+00:00

This makes locking and handling error paths simpler.

Signed-off-by: Nuno Sa 
Link: https://patch.msgid.link/20240618-dev-iio-adis-cleanup-v1-2-bd93ce7845c7@analog.com
Signed-off-by: Jonathan Cameron

iio: imu: adis_trigger: Allow level interrupts for FIFO readings

2024-06-04T18:53:09+00:00

Currently, adis library allows configuration only for edge interrupts,
needed for data ready sampling.
This patch removes the restriction for level interrupts for devices
which have FIFO support.
Furthermore, in case of devices which have FIFO support,
devm_request_threaded_irq is used for interrupt allocation, to avoid
flooding the processor with the FIFO watermark level interrupt, which
is active until enough data has been read from the FIFO.

Reviewed-by: Nuno Sa 
Signed-off-by: Ramona Gradinariu 
Link: https://lore.kernel.org/r/20240527142618.275897-7-ramona.bolboaca13@gmail.com
Signed-off-by: Jonathan Cameron

iio: imu: adis_buffer: Add buffer setup API with buffer attributes

2024-06-04T18:53:09+00:00

Add new API called devm_adis_setup_buffer_and_trigger_with_attrs() which
also takes buffer attributes as a parameter.
Rewrite devm_adis_setup_buffer_and_trigger() implementation such that it
calls devm_adis_setup_buffer_and_trigger_with_attrs() with buffer
attributes parameter NULL

Reviewed-by: Nuno Sa 
Signed-off-by: Ramona Gradinariu 
Link: https://lore.kernel.org/r/20240527142618.275897-4-ramona.bolboaca13@gmail.com
Signed-off-by: Jonathan Cameron