Custom targets for controlling notification lights in S60 Eseries devices

Article Metadata

---

Tested with

Devices(s): Nokia E75
Nokia E52

---

Compatibility

Platform(s): S60 3rd Edition, FP2
S60 5th Edition

---

Article

Keywords: CHWRMLight

Created: User:Kbwiki (29 Jun 2010)

Last edited: lpvalente (19 Sep 2012)

Description

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().

Solution

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