Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries. Thanks for all your past and future contributions.

Custom targets for controlling notification lights in S60 Eseries devices

From Wiki
Jump to: navigation, search

Archived.pngArchived: This article is archived because it is not considered relevant for third-party developers creating commercial solutions today. If you think this article is still relevant, let us know by adding the template {{ReviewForRemovalFromArchive|user=~~~~|write your reason here}}.

The article is believed to be still valid for the original topic scope.

Article Metadata
Tested with
Devices(s): Nokia E75
Nokia E52
Platform(s): S60 3rd Edition, FP2
S60 5th Edition
S60 5th Edition
S60 3rd Edition FP2
Keywords: CHWRMLight
Created: User:Kbwiki (29 Jun 2010)
Last edited: lpvalente (05 Feb 2013)


The HWRM (Hardware Resource Manager) Light API provides the ability to control the device display light as well as the keyboard illumination. Along with these, other types of custom targets such as notification light, breathing light, etc. can also be controlled.

The custom targets vary for different devices and it is not necessary to reserve the target before calling the function LightOnL().


The following piece of code is sufficient for controlling the notification light.

 CHRRMLight* light = CHWRMLight::NewL();
// Turn on the notification light for ten seconds
light->LightOnL( CHWRMLight::ECustomTarget1, 10000 );
 // Turn off the notification light
light->LightOffL( CHWRMLight::ECustomTarget1 );

The mapping of custom targets to specific lights is device-dependent.

For E75,

  • ECustomTarget1 corresponds to the notification light
  • ECustomTarget2 corresponds to the breathing light

For E52,

  • ECustomTarget4 corresponds to the notification light
  • ECustomTarget3 corresponds to the breathing light
This page was last modified on 5 February 2013, at 21:02.
26 page views in the last 30 days.