On 17/01/17 13:50, Andreas Klinger wrote: > Add sysfs-bus-iio-distance-srf08 for individual attributes of the driver, > especially: > - sensitivity which the device documentation calls gain for amplifying the > signal > - max_range for limiting the maximum distance for expected echos and > therefore limiting the time waiting for telegrams > > Signed-off-by: Andreas Klinger <[email protected]> > --- > .../ABI/testing/sysfs-bus-iio-distance-srf08 | 27 > ++++++++++++++++++++++ > 1 file changed, 27 insertions(+) > create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > > diff --git a/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > new file mode 100644 > index 000000000000..e96c28064748 > --- /dev/null > +++ b/Documentation/ABI/testing/sysfs-bus-iio-distance-srf08 > @@ -0,0 +1,27 @@ > +What /sys/bus/iio/devices/iio:deviceX/in_distance_raw > +Date: January 2017 > +KernelVersion: 4.11 > +Contact: [email protected] > +Description: > + Get the current distance in meters between the sensor and > + the first object recognized Generally no need to document what are effectively standard elements. Just leads to the possibility of disagreements in the docs! Still no harm here really. > + > +What /sys/bus/iio/devices/iio:deviceX/sensor_sensitivity > +Date: January 2017 > +KernelVersion: 4.11 > +Contact: [email protected] > +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 > +Contact: [email protected] > +Description: > + Show or set the maximum range between the sensor and the > + first object echoed in millimeters. > + This setting limits the time the driver is waiting for a > + echo. > + Can be set between 43 and 11008 in a grid of 43 mm. > + default 6020 This needs to be in the same units as the range - so m. I'm not 100% sure this is the best ABI we can do for this. However, supporting this as a legacy abi if we come up with something more general will be a very small burden, so lets not stall the driver on this!
Jonathan >
