Backlight services: Difference between revisions

P-sam (talk | contribs)
m add note about float lux output from GetAmbientLightSensorValue
No edit summary
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
= lbl =
= lbl =
This is "nn::lbl::detail::ILblController".
This is "nn::lbl::detail::ILblController".
This was moved to [[PTM_services|PTM]] with [10.0.0+].


{| class="wikitable" border="1"
{| class="wikitable" border="1"
Line 38: Line 40:
| 15 || SetAmbientLightSensorValue
| 15 || SetAmbientLightSensorValue
|-
|-
| 16 || GetAmbientLightSensorValue
| 16 || [[#GetAmbientLightSensorValue]]
|-
|-
| 17 || SetBrightnessReflectionDelayLevel
| 17 || SetBrightnessReflectionDelayLevel
Line 63: Line 65:
|-
|-
| 28 || [3.0.0+] [[#IsVrModeEnabled]]
| 28 || [3.0.0+] [[#IsVrModeEnabled]]
|-
| 29 || [7.0.0+] IsAutoBrightnessControlSupported
|}
|}


== GetAmbientLightSensorValue ==
== GetAmbientLightSensorValue ==
No input. Returns an output float of the current ambient light sensor value (unit: lux). Note: float seems to be preceded by an u32 int (zeroes)
No input. Before 5.x, outputs lux in float. (5.0.0+) Returns an output struct:
{| class="wikitable" border="1"
|-
! Offset || Size || Description
|-
| 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.
|}
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 ==
Line 89: Line 102:
== IsVrModeEnabled ==
== IsVrModeEnabled ==
No input. Returns an output u8 bool set by the above commands.
No input. Returns an output u8 bool set by the above commands.
= 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.


[[Category:Services]]
[[Category:Services]]