linux-toradex.git/include/linux/iio/iio.h, branch v7.0-rc3

iio: core: Add cleanup.h support for iio_device_claim_*()

2026-01-22T20:53:17+00:00

Add guard classes for iio_device_claim_*() conditional locks. This will
aid drivers write safer and cleaner code when dealing with some common
patterns.

These classes are not meant to be used directly by drivers (hence the
__priv__ prefix). Instead, documented wrapper macros are provided to
enforce the use of ACQUIRE() or guard() semantics and avoid the
problematic scoped guard.

Suggested-by: Andy Shevchenko 
Reviewed-by: David Lechner 
Reviewed-by: Nuno Sá 
Acked-by: Andy Shevchenko 
Signed-off-by: Kurt Borja 
Signed-off-by: Jonathan Cameron

iio: core: Match iio_device_claim_*() semantics and implementation

2026-01-22T20:53:17+00:00

Implement iio_device_claim_buffer_mode() fully inline with the use of
__iio_dev_mode_lock(), which takes care of sparse annotations.

To completely match iio_device_claim_direct() semantics, we need to
also change iio_device_claim_buffer_mode() return semantics to usual
true/false conditional lock semantics.

Additionally, to avoid silently breaking out-of-tree drivers, rename
iio_device_claim_buffer_mode() to iio_device_claim_try_buffer_mode().

Reviewed-by: David Lechner 
Reviewed-by: Nuno Sá 
Signed-off-by: Kurt Borja 
Signed-off-by: Jonathan Cameron

iio: core: Refactor iio_device_claim_direct() implementation

2026-01-22T20:53:17+00:00

In order to eventually unify the locking API, implement
iio_device_claim_direct() fully inline, with the use of
__iio_dev_mode_lock(), which takes care of sparse annotations.

Reviewed-by: David Lechner 
Reviewed-by: Nuno Sá 
Signed-off-by: Kurt Borja 
Signed-off-by: Jonathan Cameron

iio: core: Add and export __iio_dev_mode_lock()

2026-01-22T20:53:17+00:00

Add unconditional wrappers around the internal IIO mode lock.

As mentioned in the documentation, this is not meant to be used by
drivers, instead this will aid in the eventual addition of cleanup
classes around conditional locks.

Reviewed-by: David Lechner 
Reviewed-by: Nuno Sá 
Signed-off-by: Kurt Borja 
Signed-off-by: Jonathan Cameron

iio: core: switch info_mask fields to unsigned long to match find_bit helpers

2025-08-25T10:07:17+00:00

for_each_set_bit()/find_*_bit() expect arrays of unsigned long (see
include/linux/find.h), but industrialio-core passed const long * into
iio_device_add_info_mask_type{,_avail}().

These masks are used purely as bit arrays and are populated via BIT()
(1UL << n). Switch the info_mask_* fields and the corresponding function
parameters to unsigned long so the types match the helpers. This removes
sparse warnings about signedness mismatches (seen with 'make C=1'
CF='-Wsparse-all') without changing behavior or struct layout.

No functional change intended.

Suggested-by: Jonathan Cameron 
Signed-off-by: Junjie Cao 
Reviewed-by: Andy Shevchenko 
Link: https://patch.msgid.link/20250820004755.69627-1-junjie.cao@intel.com
Signed-off-by: Jonathan Cameron

iio: fix iio_push_to_buffers_with_ts() typo

2025-08-16T10:57:05+00:00

Replace iio_push_to_buffer_with_ts() with iio_push_to_buffers_with_ts()
in some documentation comments in iio.h. The latter is the correct name
of the function, the former doesn't exist.

Signed-off-by: David Lechner 
Link: https://patch.msgid.link/20250722-iio-fix-iio_push_to_buffer_with_ts-typo-v1-1-6ac9efb856d3@baylibre.com
Signed-off-by: Jonathan Cameron

iio: introduce IIO_DECLARE_BUFFER_WITH_TS macros

2025-05-21T13:20:31+00:00

Add new macros to help with the common case of declaring a buffer that
is safe to use with iio_push_to_buffers_with_ts(). This is not trivial
to do correctly because of the alignment requirements of the timestamp.
This will make it easier for both authors and reviewers.

To avoid double __align() attributes in cases where we also need DMA
alignment, add a 2nd variant IIO_DECLARE_DMA_BUFFER_WITH_TS().

Reviewed-by: Nuno Sá 
Signed-off-by: David Lechner 
Link: https://patch.msgid.link/20250507-iio-introduce-iio_declare_buffer_with_ts-v6-2-4aee1b9f1b89@baylibre.com
Signed-off-by: Jonathan Cameron

iio: make IIO_DMA_MINALIGN minimum of 8 bytes

2025-05-21T13:20:31+00:00

Add a condition to ensure that IIO_DMA_MINALIGN is at least 8 bytes.
On some 32-bit architectures, IIO_DMA_MINALIGN is 4. In many cases,
drivers are using this alignment for buffers that include a 64-bit
timestamp that is used with iio_push_to_buffers_with_ts(), which expects
the timestamp to be aligned to 8 bytes. To handle this, we can just make
IIO_DMA_MINALIGN at least 8 bytes.

Reviewed-by: Nuno Sá 
Signed-off-by: David Lechner 
Link: https://patch.msgid.link/20250507-iio-introduce-iio_declare_buffer_with_ts-v6-1-4aee1b9f1b89@baylibre.com
Signed-off-by: Jonathan Cameron

iio: Adjust internals of handling of direct mode claiming to suit new API.

2025-04-22T18:10:01+00:00

Now there are no remaining callers of iio_device_claim_direct_mode()
and iio_device_release_direct_mode() rename those functions to ensure
they are not used in new drivers. Also make them now return booleans
in line with the sparse friendly static inline wrappers.

Reviewed-by: David Lechner 
Reviewed-by: Marcelo Schmitt 
Link: https://patch.msgid.link/20250331121317.1694135-38-jic23@kernel.org
Signed-off-by: Jonathan Cameron

iio: Drop iio_device_claim_direct_scoped() and related infrastructure

2025-02-17T13:04:09+00:00

Scoped conditional automated cleanup turned out to be harder to work
with than expected. Despite several attempts to find a better solution
non have surfaced. As such rip it out of the IIO code.

Reviewed-by: David Lechner 
Reviewed-by: Nuno Sa 
Link: https://patch.msgid.link/20250209180624.701140-28-jic23@kernel.org
Signed-off-by: Jonathan Cameron