Backlight services: Difference between revisions
No edit summary |
No edit summary |
||
| (11 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 6: | Line 8: | ||
! Cmd || Name | ! Cmd || Name | ||
|- | |- | ||
| 0 || | | 0 || SaveCurrentSetting | ||
|- | |- | ||
| 1 || | | 1 || LoadCurrentSetting | ||
|- | |- | ||
| 2 || | | 2 || SetCurrentBrightnessSetting | ||
|- | |- | ||
| 3 || | | 3 || GetCurrentBrightnessSetting | ||
|- | |- | ||
| 4 || | | 4 || ApplyCurrentBrightnessSettingToBacklight | ||
|- | |- | ||
| 5 || | | 5 || GetBrightnessSettingAppliedToBacklight | ||
|- | |- | ||
| 6 || | | 6 || SwitchBacklightOn | ||
|- | |- | ||
| 7 || | | 7 || SwitchBacklightOff | ||
|- | |- | ||
| 8 || | | 8 || GetBacklightSwitchStatus | ||
|- | |- | ||
| 9 || | | 9 || EnableDimming | ||
|- | |- | ||
| 10 || | | 10 || DisableDimming | ||
|- | |- | ||
| 11 || | | 11 || IsDimmingEnabled | ||
|- | |- | ||
| 12 || | | 12 || EnableAutoBrightnessControl | ||
|- | |- | ||
| 13 || | | 13 || DisableAutoBrightnessControl | ||
|- | |- | ||
| 14 || | | 14 || IsAutoBrightnessControlEnabled | ||
|- | |- | ||
| 15 || | | 15 || SetAmbientLightSensorValue | ||
|- | |- | ||
| 16 || | | 16 || [[#GetAmbientLightSensorValue]] | ||
|- | |- | ||
| 17 || | | 17 || SetBrightnessReflectionDelayLevel | ||
|- | |- | ||
| 18 || | | 18 || GetBrightnessReflectionDelayLevel | ||
|- | |- | ||
| 19 || | | 19 || SetCurrentBrightnessMapping | ||
|- | |- | ||
| 20 || | | 20 || GetCurrentBrightnessMapping | ||
|- | |- | ||
| 21 || | | 21 || SetCurrentAmbientLightSensorMapping | ||
|- | |- | ||
| 22 || | | 22 || GetCurrentAmbientLightSensorMapping | ||
|- | |- | ||
| 23 || [3.0.0+] | | 23 || [3.0.0+] IsAmbientLightSensorAvailable | ||
|- | |- | ||
| 24 || [3.0.0+] | | 24 || [3.0.0+] SetCurrentBrightnessSettingForVrMode | ||
|- | |- | ||
| 25 || [3.0.0+] | | 25 || [3.0.0+] GetCurrentBrightnessSettingForVrMode | ||
|- | |- | ||
| 26 || [3.0.0+] [[#EnableVrMode]] | | 26 || [3.0.0+] [[#EnableVrMode]] | ||
| Line 62: | Line 64: | ||
| 27 || [3.0.0+] [[#DisableVrMode]] | | 27 || [3.0.0+] [[#DisableVrMode]] | ||
|- | |- | ||
| 28 || [3.0.0+] [[# | | 28 || [3.0.0+] [[#IsVrModeEnabled]] | ||
|- | |||
| 29 || [7.0.0+] IsAutoBrightnessControlSupported | |||
|} | |||
== GetAmbientLightSensorValue == | |||
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 == | |||
No input. Returns an output u32 int of the current backlight level. | |||
== GetBrightnessSettingAppliedToBacklight == | |||
No input. Returns an output u32 int of the backlight level computed from the ambient light sensor. | |||
==EnableVrMode== | == IsAutoBrightnessControlEnabled == | ||
No input. Returns an output u8 bool indicating whether auto brightness is enabled. | |||
== EnableVrMode == | |||
No input/output. Used by [[AM_services#SetVrModeEnabled]]. | No input/output. Used by [[AM_services#SetVrModeEnabled]]. | ||
Sets a global state field to 0x1. | Sets a global state field to 0x1. | ||
==DisableVrMode== | == DisableVrMode == | ||
No input/output. Used by [[AM_services#SetVrModeEnabled]]. | No input/output. Used by [[AM_services#SetVrModeEnabled]]. | ||
Sets the global state field used by [[#EnableVrMode]] to 0x0. | Sets the global state field used by [[#EnableVrMode]] to 0x0. | ||
== | == 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]] | ||