Changes

627 bytes added ,  01:21, 15 January 2019
no edit summary
Line 38: Line 38:  
| 15 || SetAmbientLightSensorValue
 
| 15 || SetAmbientLightSensorValue
 
|-
 
|-
| 16 || GetAmbientLightSensorValue
+
| 16 || [[#GetAmbientLightSensorValue]]
 
|-
 
|-
 
| 17 || SetBrightnessReflectionDelayLevel
 
| 17 || SetBrightnessReflectionDelayLevel
Line 64: Line 64:  
| 28 || [3.0.0+] [[#IsVrModeEnabled]]
 
| 28 || [3.0.0+] [[#IsVrModeEnabled]]
 
|}
 
|}
 +
 +
== Ambient Light Sensor Notes ==
 +
The BH1730 outputs 2 values. Visible light and IR light. This is then calculated through an algorithm that checks for Gain, Measurement time, filter qualities and ouputs lux (max correct measurement of 100K lux).
 +
The default values are Gain 64x and ITIME of 38 (256 - 218). This allows for a max lux value of 17972 lux when visible light value is maximum and IR light is 0. When both of them are on their limit, the output is 1192 lux.
 +
The sensor is fully configurable.
    
== GetAmbientLightSensorValue ==
 
== GetAmbientLightSensorValue ==
Line 71: Line 76:  
! Offset || Size || Description
 
! Offset || Size || Description
 
|-
 
|-
| 0x0 || 0x4 || bAbove13k. (u32) Equals to 1 if fLux >= 13000.
+
| 0x0 || 0x4 || bOverLimit. (u32) Equals to 1 if visible or IR light data is over 65534.
 
|-
 
|-
 
| 0x4 || 0x4 || fLux. (float) Value in lux from the ambient light sensor.
 
| 0x4 || 0x4 || fLux. (float) Value in lux from the ambient light sensor.
 
|}
 
|}
Note: if bAbove13k = 1 then the real lux value equals to (13000 - fLux) + 13000 and caps out at ~25000.
+
Note: if bOverLimit=1 and the default ALS configuration is used, the measurement of fLux should not be considered and the actual max value depends on the type of light. Ranges from 12.5K - 17.5K.
    
== GetCurrentBrightnessSetting ==
 
== GetCurrentBrightnessSetting ==
9

edits