Skip to contentSkip to conversation

doc: iio: Document intensity scale as poorly defined

PATCH Applied Marek Vasut 2 participants 3 messages Dec 7, 2023 – Dec 10, 2023 IIO

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: iio: Document intensity scale as poorly defined

Add comment about intensity scale being poorly defined and having no proper units.

---
Cc: Jonathan Cameron <[email protected]>
Cc: Lars-Peter Clausen <[email protected]>
Cc: [email protected]

---
 Documentation/ABI/testing/sysfs-bus-iio | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
Documentation/ABI/testing/sysfs-bus-iio +3 -1
index 0d3ec5fc45f2f..94b8d8461b7c7 100644
@@ -618,7 +618,9 @@ KernelVersion:	2.6.35
 Contact:	[email protected]
 Description:
 		If a discrete set of scale values is available, they
-		are listed in this attribute.
+		are listed in this attribute. Unlike illumination,
+		multiplying intensity by intensity_scale does not
+		yield value with any standardized unit.
 
 What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
 What:		/sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain
Signature · 1 line
2.42.0
maintainer Applied
#1 lore raw
Quoted 4 lines · On Thu, 7 Dec 2023 14:41:50 +0100 Marek Vasut <[email protected]> wrote:

Add comment about intensity scale being poorly defined and having no proper units.

Applied. Thanks for cleaning this up.

Jonathan

Quoted 23 lines

---
Cc: Jonathan Cameron <[email protected]>
Cc: Lars-Peter Clausen <[email protected]>
Cc: [email protected]

---
 Documentation/ABI/testing/sysfs-bus-iio | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)
Documentation/ABI/testing/sysfs-bus-iio +3 -1
index 0d3ec5fc45f2f..94b8d8461b7c7 100644
@@ -618,7 +618,9 @@ KernelVersion:	2.6.35
 Contact:	[email protected]
 Description:
 		If a discrete set of scale values is available, they
-		are listed in this attribute.
+		are listed in this attribute. Unlike illumination,
+		multiplying intensity by intensity_scale does not
+		yield value with any standardized unit.
 
 What:		/sys/bus/iio/devices/iio:deviceX/out_voltageY_hardwaregain
 What:		/sys/bus/iio/devices/iio:deviceX/in_intensity_hardwaregain
#2 lore raw
Quoted 8 lines · Jonathan Cameron
Quoted 4 lines · On Thu, 7 Dec 2023 14:41:50 +0100 Marek Vasut <[email protected]> wrote:

Add comment about intensity scale being poorly defined and having no proper units.

Applied. Thanks for cleaning this up.

Glad I could help. Thanks for your help with it.