All of lore.kernel.org
 help / color / mirror / Atom feed
* [PATCH 00/17] staging/iio: Clean up AD7746 CDC driver and move from staging.
@ 2022-04-18 19:28 Jonathan Cameron
  2022-04-18 19:28 ` [PATCH 01/17] iio: core: Increase precision of IIO_VAL_FRACTIONAL_LOG2 Jonathan Cameron
                   ` (16 more replies)
  0 siblings, 17 replies; 21+ messages in thread
From: Jonathan Cameron @ 2022-04-18 19:28 UTC (permalink / raw)
  To: linux-iio
  Cc: Michael Hennerich, Lars-Peter Clausen, Vincent Whitchurch,
	Jonathan Cameron

From: Jonathan Cameron <Jonathan.Cameron@huawei.com>

This started out as an experiment with Vincent Whitchurch's roadtest
testing framework [1] and that worked well so I carried on cleaning up the
driver.

Mostly this is standard tidy up, move to new interfaces, then move the driver
out of staging, but there are a few other things in here.

1) Precision improvement for IIO_VAL_FRACTIONAL_LOG2.
   The ad7746 is a 24 bit sensor and this highlighted that 9 decimal
   places wasn't enough to keep the error introduced by
   _raw * _scale from growing too large over the whole range (I couldn't
   write a sensible test for it).  So I've proposed increasing the precision
   of the calculation used to provide the sysfs attributes with this value
   type and printing a few more decimal places (12).
2) _inputoffset ABI addition.  This driver had an odd use of _offset for
   the case of differential channels that applied the offset to both
   of the differential pair (hence usespace shouldn't not apply it when
   converting to the base units. That isn't inline with the existing
   documentation for _offset and it wasn't clear to me that it made sense
   at all.  To avoid confusion I've added this new ABI (_inputoffset) for t
3) roadtest file - note this is not a complete test set for the driver and
   mainly focused on the main channel reads and places I thought I might
   have broken things whilst working on the driver.

My conclusion on roadtest - Very useful indeed. I'd encourage others to
consider developing some basic sanity tests for drivers they are working on.
Hopefully my python code isn't too hideous to understand at least!
Vincent, it might be worth thinking about some generic code to handle the
'variants' on correct ABI like I introduce here because I switched from
a shared by type scale to an individual one per channel for the voltages.
Both were ABI compliant so that sort of change is fine most of the time
though we have to be careful with it.

All comments welcome.  Note there may be changes that make more sense
to do after moving this out of staging as long as there are no ABI changes involved
etc.  Feel free to highlight those sorts of changes as well as anything more
significant.

[1] https://lore.kernel.org/all/20220311162445.346685-9-vincent.whitchurch@axis.com/

Jonathan Cameron (17):
  iio: core: Increase precision of IIO_VAL_FRACTIONAL_LOG2
  iio: ABI: Fix wrong format of differential capacitance channel ABI.
  staging: iio: cdc: ad7746: Use explicit be24 handling.
  staging: iio: cdc: ad7746: Push handling of supply voltage scale to
    userspace.
  staging: iio: cdc: ad7746: Use local buffer for multi byte reads.
  staging: iio: cdc: ad7746: Factor out ad7746_read_channel()
  staging: iio: cdc: ad7764: Push locking down into case statements in
    read/write_raw
  staging: iio: cdc: ad7746: Break up use of chan->address and use
    FIELD_PREP etc
  staging: iio: cdc: ad7746: Drop usused i2c_set_clientdata()
  staging: iio: cdc: ad7746: Use _raw and _scale for temperature
    channels.
  iio: core: Introduce _inputoffset for differential channels
  staging: iio: cdc: ad7746: Switch from _offset to _inputoffset for
    differential channels.
  staging: iio: cdc: ad7746: Use read_avail() rather than opencoding.
  staging: iio: ad7746: White space cleanup
  iio: cdc: ad7746: Add device specific ABI documentation.
  iio: cdc: ad7746: Move driver out of staging.
  RFC: iio: cdc: ad7746: Add roadtest

 Documentation/ABI/testing/sysfs-bus-iio       |  15 +-
 .../ABI/testing/sysfs-bus-iio-cdc-ad7746      |  11 +
 drivers/iio/cdc/Kconfig                       |  10 +
 drivers/iio/cdc/Makefile                      |   1 +
 drivers/iio/cdc/ad7746.c                      | 818 ++++++++++++++++++
 drivers/iio/industrialio-core.c               |  24 +-
 drivers/staging/iio/cdc/ad7746.c              | 767 ----------------
 include/linux/iio/types.h                     |   1 +
 .../roadtest/tests/iio/cdc/__init__.py        |   0
 .../roadtest/roadtest/tests/iio/cdc/config    |   1 +
 .../roadtest/tests/iio/cdc/test_ad7746.py     | 323 +++++++
 11 files changed, 1195 insertions(+), 776 deletions(-)
 create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-cdc-ad7746
 create mode 100644 drivers/iio/cdc/ad7746.c
 delete mode 100644 drivers/staging/iio/cdc/ad7746.c
 create mode 100644 tools/testing/roadtest/roadtest/tests/iio/cdc/__init__.py
 create mode 100644 tools/testing/roadtest/roadtest/tests/iio/cdc/config
 create mode 100644 tools/testing/roadtest/roadtest/tests/iio/cdc/test_ad7746.py

-- 
2.35.3


^ permalink raw reply	[flat|nested] 21+ messages in thread

end of thread, other threads:[~2022-04-28 18:41 UTC | newest]

Thread overview: 21+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2022-04-18 19:28 [PATCH 00/17] staging/iio: Clean up AD7746 CDC driver and move from staging Jonathan Cameron
2022-04-18 19:28 ` [PATCH 01/17] iio: core: Increase precision of IIO_VAL_FRACTIONAL_LOG2 Jonathan Cameron
2022-04-26 12:00   ` Peter Rosin
2022-04-28 18:49     ` Jonathan Cameron
2022-04-18 19:28 ` [PATCH 02/17] iio: ABI: Fix wrong format of differential capacitance channel ABI Jonathan Cameron
2022-04-18 19:28 ` [PATCH 03/17] staging: iio: cdc: ad7746: Use explicit be24 handling Jonathan Cameron
2022-04-26 10:58   ` Andy Shevchenko
2022-04-18 19:28 ` [PATCH 04/17] staging: iio: cdc: ad7746: Push handling of supply voltage scale to userspace Jonathan Cameron
2022-04-18 19:28 ` [PATCH 05/17] staging: iio: cdc: ad7746: Use local buffer for multi byte reads Jonathan Cameron
2022-04-18 19:28 ` [PATCH 06/17] staging: iio: cdc: ad7746: Factor out ad7746_read_channel() Jonathan Cameron
2022-04-18 19:28 ` [PATCH 07/17] staging: iio: cdc: ad7764: Push locking down into case statements in read/write_raw Jonathan Cameron
2022-04-18 19:28 ` [PATCH 08/17] staging: iio: cdc: ad7746: Break up use of chan->address and use FIELD_PREP etc Jonathan Cameron
2022-04-18 19:28 ` [PATCH 09/17] staging: iio: cdc: ad7746: Drop usused i2c_set_clientdata() Jonathan Cameron
2022-04-18 19:29 ` [PATCH 10/17] staging: iio: cdc: ad7746: Use _raw and _scale for temperature channels Jonathan Cameron
2022-04-18 19:29 ` [PATCH 11/17] iio: core: Introduce _inputoffset for differential channels Jonathan Cameron
2022-04-18 19:29 ` [PATCH 12/17] staging: iio: cdc: ad7746: Switch from _offset to " Jonathan Cameron
2022-04-18 19:29 ` [PATCH 13/17] staging: iio: cdc: ad7746: Use read_avail() rather than opencoding Jonathan Cameron
2022-04-18 19:29 ` [PATCH 14/17] staging: iio: ad7746: White space cleanup Jonathan Cameron
2022-04-18 19:29 ` [PATCH 15/17] iio: cdc: ad7746: Add device specific ABI documentation Jonathan Cameron
2022-04-18 19:29 ` [PATCH 16/17] iio: cdc: ad7746: Move driver out of staging Jonathan Cameron
2022-04-18 19:29 ` [PATCH 17/17] RFC: iio: cdc: ad7746: Add roadtest Jonathan Cameron

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.