[APP] LUMOS v10 RC2 (Complete HTC Auto-Backlight replacement) [UPD.:05-04-2009]

[nik3r]

. . . . (current version 10 RC2)
More control. More battery. More comfort.



Lumos is fully customizable auto-backlight changer developed as a complete replacement for HTC built-in auto backlight service in newest HTC devices starting from HTC Diamond and Raphael. It focuses on minimal CPU usage (0.05-0.3%), maximum battery saving, low memory footprint and maximum backlight change smoothness and responsiveness. Lumos combines only the best from all currently available auto-backlight solutions and adds many extras

Features:
- simple and clean installation and uninstalation
- extremely low CPU usage when working, 0.05-0.3% on polling
- 0.00% CPU usage when display dims and in standby
- low memory usage considering all the options
- NO battery drainage overhead if you don't use your phone
- you don't lose configuration and calibration data between versions
- simple and reliable configuration GUI with calibration process
- many options that let you change every aspect of how your backlight works
- program exceptions to set different backlight for any application
- integrated tool to detect all active application names, leave it running on the background and it will log all application names you use
- configuration failsafe. No matter what you do, Lumos won't crash, just tell you what is wrong and use defaults.
- supports HTC Raphael, Diamond, Blackstone and Topaz
- should support Rhodium and newer devices


Just install the CAB, start LumosWizard from programs or soft reset and you're all set!
- Lumos always installs to the device (no matter what you chose)
- Installer will create auto-start entry (Lumos will start after a soft-reset)
- Installer will create a shortcut to LumosWizard in your programs

Program installs to \Program Files\Lumos\
Lumos.exe = starts/stops auto backlight service
LumosWizard.exe = graphical tool to configure all aspects of Lumos
settings.txt = configuration file is not included in the package, it will be automatically generated by LumosWizard after successful calibration, you can edit it manually in your PC or by using LumosWizard, text edits in device are probably no longer possible because of unicode encoding.
LumosStarter.exe = (re)starts Lumos service without any visual feedback (used for startup after soft-reset and for special issues)

Language modules install to \Program Files\Lumos\Languages
- this folder contains also a sample language for translations called DeveloperEN.lng
To make your own translation:
- Look to \Program Files\Lumos\Languages, copy DeveloperEN.lng to your PC.
- Rename the file to YourLanguageName.lng
- Edit the file with notepad and follow the instructions inside, it's fairly straightforward.
- To test your translation, copy the file back to \Program Files\Lumos\Languages on your device and change the language in LumosWizard.
When you're done, send it to me using THIS FORM or rapidshare or something and PM me a link. I will add it to the Language pack and the next version.

TROUBLESHOOTING:

You can take these simple steps to troubleshoot any problem, perform both steps and if your device reacts differently than described try fixes marked ">" one by one starting from the top. 1) Run LumosWizard, start Calibration and proceed to second step (max sensor), Lumos should report positive values as you move the device near to light source. > move the damn finger! xD > another application exclusively locked the sensor, try to disable other apps using light sensor > sensor drivers or sensor SDK is missing, try if different application like G-Light works, report the problem if it does, update ROM if it doesn't > your sensor may be defective, try some 100% compatible ROM like Energy just in case and consider RMA if unsuccessful 2) Run LumosWizard, start Calibration and proceed to third step (minimum and maximum backlight setting). The backlight should actually change as a preview when you move the slider. > check if windows built-in auto backlight is disabled in power settings > another application may be forcing the backlight level, try to soft reset and disable other apps that can change backlight level or manage backlight in user profiles > original HTC backlight utility DLLs may be missing in certain early WM6.5 ROMs, try to install BacklightHotfix.CAB attached to this post and reboot. If it just won't work, try another program like G-light, if you're still out of luck, try to contact your chef.

And lastly you can donate to support Lumos development or just as a 'thank you' if you use it and like it!
Donations will be used solely to buy muffins and hot chockolate and pizza so I can work faster
mmm


READ THE FAQ IN POST #2 BEFORE ASKING QUESTIONS

New files in additional languages pack:
Italian


DOWNLOAD:

[nik3r]

FAQ:
What exactly is the calibration for, backlight is still the same after calibration?
The calibration ensures Lumos can detect the detection range of your light sensor properly and lets you set minimum and maximum possible backlight easily.
It has 4 steps:
1) Minimum value the sensor can read (probably 0 on all devices)
2) Maximum value the sensor can read (expect this to be something around 1400), you need to use a light bulb tor this step.
3) Minimum brightness you want. Lumos will calculate everything with minimum value reported by your device, but it will not let the backlight go below this value. (like if you want to have backlight 2 in shade because 1 is too dark for you)
4) Maximum brightness you want. Lumos will calculate everything with maximum value reported by your device, but it will not let the backlight go above this value. (You may notice that backlight level 7 and 10 is a little difference and can be both read in direct light, however if you limit the maximum to only 7 here, you will save a lot of battery)
5) After you are done with the calibration, you can review your setting on the settings tab and click 'Apply+Save' to exit LumosWizard and actually start Lumos service. There is no auto-backlight while the configuration Wizard is open, it defaults at level 6!

How program exceptions work?
- Switch to the Windows tab and start for example tomtom, leave TT and click it's name in the window list, then specify the backlight you want for this app and tap Add.
- If you disable "Exc. for active window only" on settings tab, you need to specify exact window name and exception will be triggered even for inactive application (minimized for example).
- If you activate "Exc. for active window only" on settings tab, you only need to specify part of the window name in exception settings (useful in case part of the window name changes). If the window name is "AdobeReader - document.pdf", only add exception "AdobeReader -". Be aware enabling this option increases CPU requirements of Lumos by about 20%.
Note that you will probably need to enable "Exc. for active window only" on settings tab for exceptions to work on WM6.5.

How to set a program exception step by step?
1. run lumos wizard
2. switch to the tab "windows" (the last one) and let the wizard run in background
3. run your program(s) you want to add
4. close the program(s)
5. switch back to lumos wizard -- voila, all the window names you visited are there!
6. tap the program name you want in the window list, it will switch you to the "exceptions" tab and fill the form for you
7. set the backlight level you want (1-10) and tap add to exceptions


How backlight modes work?
- Backlight modes are individual equations used to determine proper backlight level from current sensor value.
- Linear - this mode is equally sensitive in dark and light environment.
- Root - this mode is more sensitive in dark environment and is best suitable for human eye and therefore default.
- Quadratic - this mode is more sensitive in light environment.
- Custom - this mode features customizable graph, you can draw a graph yourself with stylus or click on the blue area under each level number to input border sensor value manually.
Levels outside your min-max boundaries are hidden.
- Note that using custom mode do not affect CPU requirements in any way.


Backlight is not changing at all, it's the same all the time?
1) go to Start - Settings - System tab - Power - Backlight tab and DISABLE the 'Auto adjust backlight' feature.
2) close the configuration Wizard with "Save+Apply" button, auto-backlight service is disabled when you are configuring Lumos or when there is no configuration specified.

Program won't start at all?
You NEED .NET 3.5 Compact Framework Redistributable. It is faster and more stable and offers more stuff for developers than the 2.0 you probably have. It is rumored it may even make your device work faster (or at least .NET based apps).
Download it HERE (only about 3MB on device, don't be scared by the installer size as it contains support for more processors)



LUMOS CHANGES TRACKER:
(changes prior to RC1 version dropped)
! non linear backlight in the GLight style for people all over the net who are demanding this
! exceptions now need only part of the window name in "detect only active windows" mode
! recalibrated sensor readings for more sensitivity
! fixed bug in custom graph mode
! faster loading
! dropped DIM_TO_MINIMUM_PLUS_ONE_BELOW option
(below only in RC2 version)
! fixed custom mode alignment
(below only in RC3 version)
- add support for alternative backlight handling (WM default without HTC drivers)


WIZARD CHANGES TRACKER:
(changes prior to RC1 version dropped)
! support for setting linear, quadratic and root/logaritmic backlight
! support for custom backlight mode with interactive graph
! support for changing keyboard backlight delay on RAPH
! improved max/min detection in wizard
! forcing consistency between settings and graph plotting
! switching language in flight
! faster loading times
! support for language packs
! smaller text to allow better translations
! bigger tabs for better finger friendliness
! dropped DIM_TO_MINIMUM_PLUS_ONE_BELOW option
! fixed minor flaws from beta2 connected with translations
! improved settings tab scrolling redraw speed
! settings tab will back off from deploying soft keyboard
! added new languages: Bulgarian, Czech, Francais, Japanese, Nederlands
(below only in RC2 version)
! fixed Window detector taking you to the Mode tab instead of Exceptions
! fixed settings tab layout width
! added another failsafe mechanism against saving invalid min/max backlight and polling interval
! added warning message for options with potentially negative effect on battery
! added new languages - currently Bulgarian, Czech, French, German, Greek, Japanese, Dutch, Polish, Russian, Sim./Trad. Chinese
(below only in RC3 version)
- set "BL=1 below" option to be relative to the sensor minimum
- set calibration to disregard sensor minimum 0 until the driver is initialized
- add support to disable auto backlight for an application as exception
- add wizard warning if built-in auto backlight currently overrides Lumos control
- add support for relative level in exceptions
- add support to keep alive only as exception

- = bug / missing part
* = possible bug/not able to reproduce/not verified/idea
+ = fixed bug / completed part
! = fix/feature included in released version



NOTES:
Please disregard the hacks from previous versions and always set your sensor minimum and maximum to real values (0-xxxx)!

[DeepThought]

To admit it, I haven't installed it yet, but I'm tempted. Just one question which might also be of interest for others:

What's the advantage of your app compared with G-Light?

And not to forget:
Thank you for your work! I still find it amazing that many xda-devs are building programs for free just for a "thank you" by the community.

[nik3r]

Well I tried G-Light and LevelSight but will only compare it to G-Light as LevelSight does things a bit differently IMO. I set G light to 3s polling interval to make the comparsion accurate. I don't like to put dirt on someone elses app, G-Light is a fine piece of software and I encourage the developer to implement some of my ideas to match mine and make it even better


- G-Light can behave competely unpredictably, it pumps up the backlight when you're in shade (this is because of the luminosity spikes)
- Lumos eliminates any spikes by the 4-read interpolation keeping your backlight more comfortable and smooth
- Lumos uses a tolerance which further prevents the backlight to unexpectedly changing (and causing a CPU spike)

-G-light rarely reaches below 1% of CPU usage (1-7%usage is common) which can drain your battery as a side effect
- Lumos rarely crosses above 0.5% CPU usage on default settings (0.05-3% usage is common) (NOTE: this will even improve in future versions)

- in G-Light You cannot change how fast the luminance values are read from sensors, they are read on change = further battery drain. You can only change how often to set backlight
- In Lumos you can set sensor read interval and backlight change in its multiplies to save CPU and power while retaining smoothness.

- Memory usage: GLightRunner 595.43KB , Lumos 311.53KB (but this will get a bit more later)
- No noticable memory leak in either applicaiton

- G-Light has a frontend app to set up
- Lumos has none yet but you can change the configuration file

- Neither Lumos nor GLightRunner can be completely shut down without using task manager (Lumos will once it has frontend GUI).

- G-Light can exclude applications
- Lumos can't yet

-G-Light settings is pretty much still limited compared to Lumos


To sum up it's definitely worth trying

[DeepThought]

Originally Posted by nik3r To sum up it's definitely worth trying

Thank you for your long and precise answer, You definitely convinced me!

I'll try it right away!

[nik3r]

Lumos Version 02 has been released, all the changes are logged as (!) in the bug tracker above.

Default settings response time is shorten to 2s, while CPU usage is pretty much the same as v01 with 3s refresh.

Memory usage: 339.53KB
CPU usage: 0.05-0.25% on scan, 3.15% on backlight change
Power consumption is 2mA better than v01

If you want to achieve more sensitivity of backlight transition without CPU overhead, set tolerance to 0 (CPU usage bug is fixed now).

Configuration file is now idiot-proof, program will tell you what is wrong on syntax/logical error

EDIT: 02b contains one more bugfix, the auto backlight range cap finally works 100%

Enjoy

[patrickrivard]

nik3r
Quick question; does you app let the backlight go to 0% in full darkness, like LevelSight?

[nik3r]

Yes it in fact goes to 1 (backlight disable) as lowest on default. You may want to increase it to 2 in the config file if it's too dark for you.

The point of this app is YOU set how it should behave, there are virtually no limitations unless you enter a complete nonsense to the config. And even then the program should just notify you about the incorrect settings and not crash, so don't worry and edit!

The program needs to be restarted in order to apply new settings. Either kill it via process/task manager or soft reset if you don't have one. Note that this acts like a program, it won't start again automatically if you kill it or soft reset. And also it won't store anything in your registry or enywhere else on the device, so it's perfectly safe to "just try". I will make a manager app later that will let you setup and control this underlying process.
But FIRST we need to make sure the service is bug free and does everything we need before I even start building the front-end app

Also you may share your custom settings you find best with me and if it's performing well I can select that one as default for future.

[DeepThought]

Thank you Niker! V2 is working great for me. Only one thing:

The lightlevel changes linear as you've explained and that's basically working fine (and much more smoothly than G-Light for example). But it tends to get to dark. I've now changed the minimum setting to "3" to get the average backlight-level I prefer. BUT: I like to read late at night in bed and it would than be nice to have the backlight at level "1". So would it be possible to exclude light level 1 & 2 from the linear alignment and to only use those levels if it's "really dark"?

[DeepThought]

Just to give you a bit more information about my personal preferences and what I want to achieve:

I actually like the default HTC auto-backlight. It more tends to bright than to dark backlight and it's making the level changes very smoothly so you almost don't notice them.

The only thing i don't like about it is that the minimum level is hardcoded to level 3 which is too bright for me when I read in bed with no additional light in the room.

Of course those are my personal preferences and that of course doesn't necessarily mean that your app is meant to handle that way!