Revision as of 20:23, 10 December 2008 by seppo_fn (Talk | contribs)

Controlling Light settings in Java ME

From Nokia Developer Wiki
Jump to: navigation, search

Article Metadata
Tested with
Devices(s): Nokia 6131, Nokia N81
Platform(s): Series 40 3rd Edition, FP1, S60 3rd Edition, S60 3rd Edition, FP1, S60 3rd Edition, FP2
Series 40
Series 40 DP 2.0
Series 40 DP 1.1
Nokia Belle
Java Runtime 2.3 for Symbian
Keywords: com.nokia.mid.ui.DeviceControl, DeviceControl.setLights()
Created: (31 Oct 2008)
Last edited: seppo_fn (10 Dec 2008)


This snippet shows how to control lighting on devices through setLights() method of DeviceControl class.

Source file: ControllingLightMIDlet.java

import com.nokia.mid.ui.DeviceControl;
import javax.microedition.lcdui.Command;
import javax.microedition.lcdui.CommandListener;
import javax.microedition.lcdui.Display;
import javax.microedition.lcdui.Displayable;
import javax.microedition.lcdui.Form;
import javax.microedition.midlet.MIDlet;

public class ControllingLightMIDlet extends MIDlet implements CommandListener {
* Command for setting light

private Command controllingLightCommand;
* exit midlet command

private Command exitCommand;
private Form mainForm;
* The ControllingLightMIDlet constructor.

public ControllingLightMIDlet() {
//Empty implementation
* Performs an action assigned to the Mobile Device - MIDlet Started point.

public void startMIDlet() {
* Switches a current displayable in a display. The Display instance is
* taken from getDisplay() method. This method is used by all actions
* in the design for switching displayable.
* @param nextDisplayable the Displayable to be set

public void switchDisplayable(Displayable nextDisplayable) {
Display display = getDisplay();
* From CommandListener.
* Called by a system to indicated that a command has been invoked on a
* particular displayable.
* @param command the Command that was invoked
* @param displayable the Displayable where the command was invoked

public void commandAction(Command command, Displayable displayable) {
if (displayable == mainForm) {
if (command == exitCommand) {
} else if(command == controllingLightCommand) {
//up light level from 0 to 100
for(int i = 0; i < 100; i++) {
// void setLights(int num, int level) is a static function of
//com.nokia.mid.ui.DeviceControl class that
//activates and deactivates the lights on the device.
//Parameter num indicates the number of the device light
//to control. Currently only one num parameter value is
//specified: num value 0 is used for controlling the
//screen backlight. Parameter level is a value between
//0-100, which indicates the brightness of the light.
//In many implementations, there are only two levels:
//on or off(Sony Ericsson). Value 0 indicates lights off
//for monochrome displays or the minimum brightness setting
//for color displays. All other level values (1-100) are
//used for turning the lights on, possibly with different
//brightness levels, depending on the value. A larger value
//always results in either the same brightness setting as a
//lower one, or a brighter setting. For many products,
//values 1-100 will just turn the lights on.
DeviceControl.setLights(0, i);
try {
} catch (InterruptedException ex) {
* Returns an initiliazed instance of mainForm component.
* @return the initialized component instance

public Form getForm() {
if (mainForm == null) {
mainForm = new Form("Lighting test!");
exitCommand = new Command("Exit", Command.EXIT, 0);
controllingLightCommand = new Command("Light", Command.SCREEN, 0);
return mainForm;
* Returns a display instance.
* @return the display instance.

public Display getDisplay () {
return Display.getDisplay(this);
* Exits MIDlet.

public void exitMIDlet() {
* From MIDlet.
* Called when MIDlet is started.
* Checks whether the MIDlet have been already started and
* initialize/starts or resumes the MIDlet.

public void startApp() {
* From MIDlet.
* Called when MIDlet is paused.

public void pauseApp() {
//Empty implementation
* From MIDlet.
* Called to signal the MIDlet to terminate.
* @param unconditional if true, then the MIDlet has to be unconditionally
* terminated and all resources has to be released.

public void destroyApp(boolean unconditional) {
//Empty implementation


This Midlet implements a simple example of controlling light property.

Turns off the light then rise light level from 1 to 100.

Supplementary material

You can download this application and source code here - Controlling Light Settings.zip

Other related articles: http://wiki.forum.nokia.com/index.php/CS000957_-_Flashing_the_backlighthttp://wiki.forum.nokia.com/index.php/How_to_block_the_screen_saver

216 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.


Thank you!

We appreciate your feedback.