On 10/10/16 08:20, Brian Masney wrote:
> Add ABI documentation from the ISL29018 Data Sheet (FN6619.4, Oct 8,
> 2012) about the infrared suppression that can be controlled
> with the proximity_on_chip_ambient_infrared_suppression sysfs attribute.
> 
> Signed-off-by: Brian Masney <masn...@onstation.org>
I'm going to let this and the final move out of staging sit on the
list a while longer to gather reviews.

It does feel like the below is rather cryptic and it might be possible
to use a simpler description...  Maybe this is the best we can do.
The naming makes it sound generic, but in reality it's a nasty bit
of custom filtering that is not well described anywhere.

Jonathan
> ---
>  .../ABI/testing/sysfs-bus-iio-light-isl29018          | 19 
> +++++++++++++++++++
>  1 file changed, 19 insertions(+)
>  create mode 100644 Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> 
> diff --git a/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018 
> b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> new file mode 100644
> index 0000000..f0ce0a0
> --- /dev/null
> +++ b/Documentation/ABI/testing/sysfs-bus-iio-light-isl29018
> @@ -0,0 +1,19 @@
> +What:                
> /sys/bus/iio/devices/iio:deviceX/proximity_on_chip_ambient_infrared_suppression
> +Date:                January 2011
> +KernelVersion:       2.6.37
> +Contact:     linux-...@vger.kernel.org
> +Description:
> +             From ISL29018 Data Sheet (FN6619.4, Oct 8, 2012) regarding the
> +             infrared suppression:
> +
> +             Scheme 0, makes full n (4, 8, 12, 16) bits (unsigned) proximity
> +             detection. The range of Scheme 0 proximity count is from 0 to
> +             2^n. Logic 1 of this bit, Scheme 1, makes n-1 (3, 7, 11, 15)
> +             bits (2's complementary) proximity_less_ambient detection. The
> +             range of Scheme 1 proximity count is from -2^(n-1) to 2^(n-1).
> +             The sign bit is extended for resolutions less than 16. While
> +             Scheme 0 has wider dynamic range, Scheme 1 proximity detection
> +             is less affected by the ambient IR noise variation.
> +
> +             0 Sensing IR from LED and ambient
> +             1 Sensing IR from LED with ambient IR rejection
> 

_______________________________________________
devel mailing list
de...@linuxdriverproject.org
http://driverdev.linuxdriverproject.org/mailman/listinfo/driverdev-devel

Reply via email to