| Message ID | 20241127-ad411x_calibration-v2-2-66412dac35aa@baylibre.com (mailing list archive) |
|---|---|
| State | Changes Requested |
| Headers | show |
| Series | iio: adc: ad7173: add calibration support to chip family | expand |
On Wed, 27 Nov 2024 10:06:14 +0100 Guillaume Ranquet <granquet@baylibre.com> wrote: > Add common calibration nodes for sigma delta adc. > > Signed-off-by: Guillaume Ranquet <granquet@baylibre.com> Hi Guillaume. I think there are some issues with the old docs that should be tidied up whilst we are here :( Just fix them up in this patch then mention it in the patch description. Or if you prefer move and then fix in separate patches. Jonathan > --- > .../ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta | 23 +++++++++++++++++++++ > Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 | 24 ---------------------- > 2 files changed, 23 insertions(+), 24 deletions(-) > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta > new file mode 100644 > index 0000000000000000000000000000000000000000..c2c55a966163736aea8d46fc5089c08dac747b84 > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta > @@ -0,0 +1,23 @@ > +What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration in_voltageY_sys_calibration (as indices are capital letters and X is used earlier). > +KernelVersion: Make an estimate of this I'll never remember to fill them in whilst applying. It should make the next merge window I hope! > +Contact: linux-iio@vger.kernel.org > +Description: > + This attribute, if available, initiates the system calibration procedure. This is done on a > + single channel at a time. Write '1' to start the calibration. > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode_available > +KernelVersion: > +Contact: linux-iio@vger.kernel.org > +Description: > + This attribute, if available, returns a list with the possible calibration modes. > + There are two available options: > + "zero_scale" - calibrate to zero scale > + "full_scale" - calibrate to full scale > + > +What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode > +KernelVersion: > +Contact: linux-iio@vger.kernel.org > +Description: > + This attribute, if available, sets up the calibration mode used in the system calibration > + procedure. Reading returns the current calibration mode. > + Writing sets the system calibration mode. > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 > index f8315202c8f0df2bd4b7216f5cf8d3c2780fcf3f..28be1cabf1124ac7593392e17e4759ddfac829e8 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 > @@ -19,33 +19,9 @@ Description: > the bridge can be disconnected (when it is not being used > using the bridge_switch_en attribute. > > -What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration Huh. That would explain the x above. I assume it is per channel? > -KernelVersion: > -Contact: linux-iio@vger.kernel.org > -Description: > - Initiates the system calibration procedure. This is done on a > - single channel at a time. Write '1' to start the calibration. > - > What: /sys/bus/iio/devices/iio:deviceX/in_voltage2-voltage2_shorted_raw > KernelVersion: > Contact: linux-iio@vger.kernel.org > Description: > Measure voltage from AIN2 pin connected to AIN(+) > and AIN(-) shorted. > - > -What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode_available > -KernelVersion: > -Contact: linux-iio@vger.kernel.org > -Description: > - Reading returns a list with the possible calibration modes. > - There are two available options: > - "zero_scale" - calibrate to zero scale > - "full_scale" - calibrate to full scale > - > -What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode > -KernelVersion: > -Contact: linux-iio@vger.kernel.org > -Description: > - Sets up the calibration mode used in the system calibration > - procedure. Reading returns the current calibration mode. > - Writing sets the system calibration mode. >
diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta new file mode 100644 index 0000000000000000000000000000000000000000..c2c55a966163736aea8d46fc5089c08dac747b84 --- /dev/null +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta @@ -0,0 +1,23 @@ +What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration +KernelVersion: +Contact: linux-iio@vger.kernel.org +Description: + This attribute, if available, initiates the system calibration procedure. This is done on a + single channel at a time. Write '1' to start the calibration. + +What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode_available +KernelVersion: +Contact: linux-iio@vger.kernel.org +Description: + This attribute, if available, returns a list with the possible calibration modes. + There are two available options: + "zero_scale" - calibrate to zero scale + "full_scale" - calibrate to full scale + +What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode +KernelVersion: +Contact: linux-iio@vger.kernel.org +Description: + This attribute, if available, sets up the calibration mode used in the system calibration + procedure. Reading returns the current calibration mode. + Writing sets the system calibration mode. diff --git a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 index f8315202c8f0df2bd4b7216f5cf8d3c2780fcf3f..28be1cabf1124ac7593392e17e4759ddfac829e8 100644 --- a/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 +++ b/Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 @@ -19,33 +19,9 @@ Description: the bridge can be disconnected (when it is not being used using the bridge_switch_en attribute. -What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration -KernelVersion: -Contact: linux-iio@vger.kernel.org -Description: - Initiates the system calibration procedure. This is done on a - single channel at a time. Write '1' to start the calibration. - What: /sys/bus/iio/devices/iio:deviceX/in_voltage2-voltage2_shorted_raw KernelVersion: Contact: linux-iio@vger.kernel.org Description: Measure voltage from AIN2 pin connected to AIN(+) and AIN(-) shorted. - -What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode_available -KernelVersion: -Contact: linux-iio@vger.kernel.org -Description: - Reading returns a list with the possible calibration modes. - There are two available options: - "zero_scale" - calibrate to zero scale - "full_scale" - calibrate to full scale - -What: /sys/bus/iio/devices/iio:deviceX/in_voltagex_sys_calibration_mode -KernelVersion: -Contact: linux-iio@vger.kernel.org -Description: - Sets up the calibration mode used in the system calibration - procedure. Reading returns the current calibration mode. - Writing sets the system calibration mode.
Add common calibration nodes for sigma delta adc. Signed-off-by: Guillaume Ranquet <granquet@baylibre.com> --- .../ABI/testing/sysfs-bus-iio-adc-ad-sigma-delta | 23 +++++++++++++++++++++ Documentation/ABI/testing/sysfs-bus-iio-adc-ad7192 | 24 ---------------------- 2 files changed, 23 insertions(+), 24 deletions(-)