On Sun, Jan 17, 2021 at 7:40 AM Jonathan Cameron <jic23@xxxxxxxxxx> wrote: > > From: Jonathan Cameron <Jonathan.Cameron@xxxxxxxxxx> > > This control on the gain of a measurement used for time of flight sensing > is standard but the expected values for different enviroments may not be. > As we cannot have the same ABI element documented in two files, add a > generic version to sysfs-bus-iio-proximity and a note on the expected > value vs measuring environment for the as3935. > > Fixes: > $ scripts/get_abi.pl validate > Warning: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity is defined 2 times: ./Documentation/ABI/testing/sysfs-bus-iio-distance-srf08:0 ./Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935:8 > > Cc: Matt Ranostay <matt.ranostay@xxxxxxxxxxxx> > Reported-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx> > Signed-off-by: Jonathan Cameron <Jonathan.Cameron@xxxxxxxxxx> Reviewed-by: Matt Ranostay <matt.ranostay@xxxxxxxxxxxx> > --- > .../ABI/testing/sysfs-bus-iio-distance-srf08 | 8 -------- > Documentation/ABI/testing/sysfs-bus-iio-proximity | 14 ++++++++++++++ > .../ABI/testing/sysfs-bus-iio-proximity-as3935 | 9 --------- > 3 files changed, 14 insertions(+), 17 deletions(-) > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > index 40df5c9fef99..9dae94aa880b 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > @@ -1,11 +1,3 @@ > -What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > -Date: January 2017 > -KernelVersion: 4.11 > -Contact: linux-iio@xxxxxxxxxxxxxxx > -Description: > - Show or set the gain boost of the amp, from 0-31 range. > - default 31 > - > What: /sys/bus/iio/devices/iio:deviceX/sensor_max_range > Date: January 2017 > KernelVersion: 4.11 > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-proximity b/Documentation/ABI/testing/sysfs-bus-iio-proximity > index 2172f3bb9c64..3aac6dab8775 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-proximity > +++ b/Documentation/ABI/testing/sysfs-bus-iio-proximity > @@ -8,3 +8,17 @@ Description: > considered close to the device. If the value read from the > sensor is above or equal to the value in this file an object > should typically be considered near. > + > +What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > +Date: March 2014 > +KernelVersion: 3.15 > +Contact: linux-iio@xxxxxxxxxxxxxxx > +Description: > + Proximity sensors sometimes have a controllable amplifier > + on the signal from which time of flight measurements are > + taken. > + The appropriate values to take is dependent on both the > + sensor and it's operating environment: > + * as3935 (0-31 range) > + 18 = indoors (default) > + 14 = outdoors > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 b/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 > index c59d95346341..1e5c40775a6c 100644 > --- a/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 > +++ b/Documentation/ABI/testing/sysfs-bus-iio-proximity-as3935 > @@ -6,15 +6,6 @@ Description: > Get the current distance in meters of storm (1km steps) > 1000-40000 = distance in meters > > -What: /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > -Date: March 2014 > -KernelVersion: 3.15 > -Contact: Matt Ranostay <matt.ranostay@xxxxxxxxxxxx> > -Description: > - Show or set the gain boost of the amp, from 0-31 range. > - 18 = indoors (default) > - 14 = outdoors > - > What /sys/bus/iio/devices/iio:deviceX/noise_level_tripped > Date: May 2017 > KernelVersion: 4.13 > -- > 2.30.0 >