[APP] BLN control - the official BLN settings app by neldar

Search This thread

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
This app does only work, if you have a kernel with BacklightNotification (bln) mod on your phone installed.

Go and get BLN for Samsung i9000 Eclair, Froyo or Gingerbread or any other kernel/rom with BacklightNotification support.
Or visit this page to view a list with supported phones by BLN.


What is the BLN mod?
The BLN mod turns the touchkey backlights into a notification led.
It enables the notification led api for any android application that supports notifications by led.
If you dont have the BLN mod installed, the app provides you instructions how to install the BLN mod.

What does this app?
This application gives you control over the BacklightNotification (bln) mod settings on your phone.

What features does the Free version have?
  • enable/disable BacklightNotification function (without uninstalling bln)
  • test BacklightNotification
  • update notification (notifies you about new BLN app, liblights or kernel releases)

Additional features in the Pro version:
  • widget
  • scheduler (disable BLN at night, ...)
  • locale plug-in(s) for: bln status, blinking, scheduler, static led, notification led
  • adjustable timeout of static led notification
  • blinking**:
    • adjustable on/off led period
    • adjustable overall blinking duration (5-60 minutes or unlimited)
    • select led status after blinking ends(on/off)
    • stop blinking if battery is below a selectable % level
  • adds led notifications for:
    • missed calls

** Please notice that blinking consumes more energy than static backlight!

Download the app from market:
Free | Pro
attachment.php


The price for the Pro version is 0.99€ (~ 1.99 US$).
The Pro version is available at the android market (creditcard) and at androidpit (paypal, clickandbuy).

If you find an issue, please report it here in the thread.


Which features will be added to future Pro versions?
  • suggest me a feature

What permissions are used for which features?
  • RECEIVE_BOOT_COMPLETED: to activate BLN at boot and start the services
  • INTERNET: for update notification (new BLN app, liblights or kernel releases - you can disable the notification in the update settings) and for the compatibility check (the app receive instructions for you, if the app detects that something is wrong with the BLN setup)
  • READ_PHONE_STATE: to detect if an incoming call could become a missed call
  • WAKE_LOCK: services & schedule (reactivating interrupted led notifications, froyo only)

Translations already done:
  • Dutch
  • French
  • German
  • Japanese
  • Korean
  • Russian
  • Spanish
  • Swedish

The initial translations into Dutch, French, Russian and Spanish have been realized at crowdin.net with the help of adequacy, andifds, elroy911, HERVEG, HTCDevil, Jaax, jbnitro, ravexx, Rebel2k and Shaymelmed. Thank you.
The translations into Japanese, Korean and Swedish have been realized at icanlocalize.com.

Translations pending:
  • Chinese (Simplified) - suspended, no sufficient Chinese market service
  • Chinese (Traditional) - see above
  • Czech
  • Italian
  • Polish

Kernel-devs / rom cookers: Please do only integrate the FREE version of this app into your releases.
 

Attachments

  • free_qr_code.png
    free_qr_code.png
    1.9 KB · Views: 550,320
  • pro_qr_code.png
    pro_qr_code.png
    2.1 KB · Views: 543,511
  • bln_icon_80_v2-animated.png
    bln_icon_80_v2-animated.png
    12.6 KB · Views: 851,424
Last edited:

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
FAQ:

How do i enable led notification for ...?
  • touchwiz sms: notification is only possible if you use another sms app (e.g. Go SMS) or if you use a patched sms app or a patched services.jar
  • touchwiz email: notification by default
  • gmail: notification by default
  • Google talk: notification by default
  • calendar: download "Calendar notifier" app from market (alternative)
  • call: BLN control - Pro from market
  • any other apps:
    ask the author of the app for notification led support

The led notification is enabled in app xyz, but it still dont work, why?
This only a problem of Android >= 2.3. Led notifications in Android >= 2.3 do only work if the screen is powered off. You can not trigger a led notification while the screen is powered on and any led notification is automatically dismissed if the screen becomes powered on. This is a general "problem" of all gingerbread phones. This behavior is a design decision of the asop team and they think this is not important enough to be mentioned in the Android SDK documentation. The BLN control app has a workaround implemented for the internal call, locale/tasker plug-in & test notification. Any other apps may have also a option to disable the screen before these apps try to trigger led notifications (e.g. Go SMS).

How much does this modification affect battery life?
With backlight notification permanently powered on, the battery lasts around 82 hours (around 3,5 days, 1,22% per hour). This means, that activated backlights will increase battery usage by about 0,18% per hour. If there is no backlight notification ongoing, battery life is normal (around 96 hours, 1,04% per hour). Measurements were made on a i9000 (eclair) with enabled flight mode.

The sgs2 does currently (6th august 2011) rely on a kernel wakelock, that does affect the battery more than on other phones.
This is an exception from the general bln behavior and may hopefully change in future.

How do you test the battery consumption? This is a common and reliable method.

Could you add a fade feature?
That is only possible on some phones, most hardware is limited (by controller firmware) to simple on/off. Maybe I add these capability in the future.

The blinking or the missed call notification of the pro app are not reliably working, what is wrong?
The lowmemorykiller of your phone is configured with too aggressive settings, thereby the app services are killed and not restarted.
Either you use less aggressive settings or you have to live with the fact that your settings make things unreliable.
Btw, it is better to have less free ram in android. A lot of free ram on a android device indicates that it is inefficiently working.
 
Last edited:

EarlZ

Senior Member
Jun 21, 2010
6,290
327
Just a wild guess but the prox sensor might drain more power than the touch buttons
 

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
Gonna it work with Universal Lagfix Kernel (0.3)???

A answer would be nice..

Of course, every kernel that incorporates bln with version greater than 1.0 should work.
edit: Btw, if you are unsure about that, just install the app. It will notify you, if BLN is not installed.
 
Last edited:

Fihlvein

Senior Member
Aug 19, 2010
672
133
Can we forget about seperate applications for missed calls and calendar events with this application or will we always need to count on third party solutions?

That's the biggest downside for me especially as there seems not to be any calendar solution that would be invisible to user, instead they all want to display their own calendar interface when LED is configured to be used.
 

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
Can we forget about seperate applications for missed calls and calendar events with this application or will we always need to count on third party solutions?

That's the biggest downside for me especially as there seems not to be any calendar solution that would be invisible to user, instead they all want to display their own calendar interface when LED is configured to be used.

My plan is that this app can detect calendar and call notfications. And beside that you should be able to enable/disable led notification for the other touchwiz apps, that already support led notifications.
But that is not implemented yet.
 

SysTem-X

Senior Member
Aug 24, 2010
350
19
Penang
neldar, i tested this with gmail and it works. Have not tried call/sms yet. And hardcore kernel has BLN already also :D

edit: call working also!
 
Last edited:

Fihlvein

Senior Member
Aug 19, 2010
672
133
So, native BLN call & calendar notifications ready?!

Sorry, just being annoying in purpose. I just cannot wait for this. :)
 

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
So, native BLN call & calendar notifications ready?!

Sorry, just being annoying in purpose. I just cannot wait for this. :)

The schedule feature is planned for v0.8.
The feature list in post 1 is not sorted by priority... install/repair is more important to me. But you can change priority for scheduler feature implementation, that lacks only 6 votes. ;)
 
Last edited:

NunxPT

Senior Member
Jul 18, 2010
485
314
Lisbon
www.cubocreation.net
First of all, great job neldar :)

I think I found a bug, I'm currently with:

- froyo JPM ROM
- BacklightNotification settings app v0.6
- BacklightNotification v2.2
- OCLF 2.0

I go to the settings app and untick "Activate BLN" to disable it for a while (eg. at night), when I press back and then return to the app, that particular setting is selected again, so I can't actually disable it.

Is it a bug or am I doing anything wrong? :)
 

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
First of all, great job neldar :)

I think I found a bug, I'm currently with:

- froyo JPM ROM
- BacklightNotification settings app v0.6
- BacklightNotification v2.2
- OCLF 2.0

I go to the settings app and untick "Activate BLN" to disable it for a while (eg. at night), when I press back and then return to the app, that particular setting is selected again, so I can't actually disable it.

Is it a bug or am I doing anything wrong? :)

It is a bug in the app, i have chosen another (and supposed to be a faster) method to write to sysfs, but it seems to fail. :mad:

That will be fixed in v0.6.7, that may be released tomorrow or monday.
 

neldar

Retired Recognized Developer
Jul 4, 2010
569
363
twitter.com
feature suggestion:
breathing buttons, if possible :).
also calendar and missed call native support would be great.
What are breathing buttons?


Btw, new BLN settings app version released:
v0.6.6
*fixed: enable/disable of BLN function (sometimes?) broken

*added: update function

See the first post for apk.

The update function will check for an update of the app and the BLN mod.
You can deactivate it in the update settings category.
The function will only check for updates on app start and only every 48 hours.
The update check on boot is not yet implemented (and will stay disabled by default in future releases).
You can also manually trigger an update check, dont use that excessively!
 
Last edited:

Top Liked Posts

  • There are no posts matching your filters.
  • 49
    This app does only work, if you have a kernel with BacklightNotification (bln) mod on your phone installed.

    Go and get BLN for Samsung i9000 Eclair, Froyo or Gingerbread or any other kernel/rom with BacklightNotification support.
    Or visit this page to view a list with supported phones by BLN.


    What is the BLN mod?
    The BLN mod turns the touchkey backlights into a notification led.
    It enables the notification led api for any android application that supports notifications by led.
    If you dont have the BLN mod installed, the app provides you instructions how to install the BLN mod.

    What does this app?
    This application gives you control over the BacklightNotification (bln) mod settings on your phone.

    What features does the Free version have?
    • enable/disable BacklightNotification function (without uninstalling bln)
    • test BacklightNotification
    • update notification (notifies you about new BLN app, liblights or kernel releases)

    Additional features in the Pro version:
    • widget
    • scheduler (disable BLN at night, ...)
    • locale plug-in(s) for: bln status, blinking, scheduler, static led, notification led
    • adjustable timeout of static led notification
    • blinking**:
      • adjustable on/off led period
      • adjustable overall blinking duration (5-60 minutes or unlimited)
      • select led status after blinking ends(on/off)
      • stop blinking if battery is below a selectable % level
    • adds led notifications for:
      • missed calls

    ** Please notice that blinking consumes more energy than static backlight!

    Download the app from market:
    Free | Pro
    attachment.php


    The price for the Pro version is 0.99€ (~ 1.99 US$).
    The Pro version is available at the android market (creditcard) and at androidpit (paypal, clickandbuy).

    If you find an issue, please report it here in the thread.


    Which features will be added to future Pro versions?
    • suggest me a feature

    What permissions are used for which features?
    • RECEIVE_BOOT_COMPLETED: to activate BLN at boot and start the services
    • INTERNET: for update notification (new BLN app, liblights or kernel releases - you can disable the notification in the update settings) and for the compatibility check (the app receive instructions for you, if the app detects that something is wrong with the BLN setup)
    • READ_PHONE_STATE: to detect if an incoming call could become a missed call
    • WAKE_LOCK: services & schedule (reactivating interrupted led notifications, froyo only)

    Translations already done:
    • Dutch
    • French
    • German
    • Japanese
    • Korean
    • Russian
    • Spanish
    • Swedish

    The initial translations into Dutch, French, Russian and Spanish have been realized at crowdin.net with the help of adequacy, andifds, elroy911, HERVEG, HTCDevil, Jaax, jbnitro, ravexx, Rebel2k and Shaymelmed. Thank you.
    The translations into Japanese, Korean and Swedish have been realized at icanlocalize.com.

    Translations pending:
    • Chinese (Simplified) - suspended, no sufficient Chinese market service
    • Chinese (Traditional) - see above
    • Czech
    • Italian
    • Polish

    Kernel-devs / rom cookers: Please do only integrate the FREE version of this app into your releases.
    10
    BLN pro will work for JVP version (gingerbread 2.3.4 ) ? :confused:

    For all having trouble with JVP, i compiled a patched services.jar. It contains both liblights and services.jar, to have BLN working with any kernel supporting it on JVP. To be installed from CWM recovery.

    Tried on Juwe's 5.0 working with stock sms, calls, mail, etc.

    Hope it helps!

    Thanks to neldar for his great job.
    Thanks to Virnik for his update package & script.
    6
    FAQ:

    How do i enable led notification for ...?
    • touchwiz sms: notification is only possible if you use another sms app (e.g. Go SMS) or if you use a patched sms app or a patched services.jar
    • touchwiz email: notification by default
    • gmail: notification by default
    • Google talk: notification by default
    • calendar: download "Calendar notifier" app from market (alternative)
    • call: BLN control - Pro from market
    • any other apps:
      ask the author of the app for notification led support

    The led notification is enabled in app xyz, but it still dont work, why?
    This only a problem of Android >= 2.3. Led notifications in Android >= 2.3 do only work if the screen is powered off. You can not trigger a led notification while the screen is powered on and any led notification is automatically dismissed if the screen becomes powered on. This is a general "problem" of all gingerbread phones. This behavior is a design decision of the asop team and they think this is not important enough to be mentioned in the Android SDK documentation. The BLN control app has a workaround implemented for the internal call, locale/tasker plug-in & test notification. Any other apps may have also a option to disable the screen before these apps try to trigger led notifications (e.g. Go SMS).

    How much does this modification affect battery life?
    With backlight notification permanently powered on, the battery lasts around 82 hours (around 3,5 days, 1,22% per hour). This means, that activated backlights will increase battery usage by about 0,18% per hour. If there is no backlight notification ongoing, battery life is normal (around 96 hours, 1,04% per hour). Measurements were made on a i9000 (eclair) with enabled flight mode.

    The sgs2 does currently (6th august 2011) rely on a kernel wakelock, that does affect the battery more than on other phones.
    This is an exception from the general bln behavior and may hopefully change in future.

    How do you test the battery consumption? This is a common and reliable method.

    Could you add a fade feature?
    That is only possible on some phones, most hardware is limited (by controller firmware) to simple on/off. Maybe I add these capability in the future.

    The blinking or the missed call notification of the pro app are not reliably working, what is wrong?
    The lowmemorykiller of your phone is configured with too aggressive settings, thereby the app services are killed and not restarted.
    Either you use less aggressive settings or you have to live with the fact that your settings make things unreliable.
    Btw, it is better to have less free ram in android. A lot of free ram on a android device indicates that it is inefficiently working.
    4
    Just wonderign, is there going to be support for normal notifcations, like third party apps etc

    No, if you are wondering about the reason, then you might want to understand the functional principle of bln by looking at the following "art":

    |android application| --> |notification service| --> |bln liblights| --> |bln driver| --> |touchkey leds|

    legend:
    --> : x calls y (unidirectional)
    android application: any android application
    notification service: public api, part of the Android SDK
    liblights: conjunction between the android OS and the Linux kernel
    bln driver: provides interface to control the touchkey led hardware
    touchkey leds: light emitting diodes behind the touchkeys...

    The bln mod (blue parts) just adds the (modified) liblights and the bln driver in that chain, these components are missing in the original stock ROM from Samsung.
    Any android application that should trigger the leds just have to implement the call (the red arrow) of the functions of the notification service .

    And the gentle reader may now notice that the control app is missing in that flowchart. Well, the control app consists of 2 parts, one part actually accesses the bln driver to adjust some settings. The second part detects missed calls and acts like any other android application to issue a (hidden) notification with the led flag.


    PS: The flowchart includes only the necessary components and conjunctions between the application and the leds. There are a few more components involved, but you don't need to know them all.
    4
    On the AT&T GS2, I am getting constant wakelocks for wlProximityEvents, and I do not even have the new Proximity feature enabled.

    I just unplugged the charger 5 minutes ago, I have no notifications, and it's been in constant wakelock since then. (See the screen shot).

    Since the last update, my battery life has been very bad and deep sleep has gone down significantly.

    UPDATE: Attached is my wakelocks.txt file.

    Thank you for the informations about the wakelock, these infos helped me to resolve the problem.
    An update is now available at the market. I want to apologize to those who may have had problems because of this issue.