Technical Note Forum.Nokia.

com

MIDP: System Properties

Version 1.1; November 30, 2005

Overview
This document lists system properties that can be retrieved by using the System.getProperty()
method call.

Detailed Description
CLDC 1.0 & 1.1, MIDP 1.0 & 2.0, and JTWI 1.0

String Description
microedition.profiles For MIDP 2.0 devices, this property MUST contain at
least “MIDP-2.0”.
microedition.configuration The J2ME configuration supported by this device.
For example, “CLDC-1.0”.
microedition.locale The name of the current locale on this device.
For example, “en-US”.
microedition.platform The name of the host platform or device. In Nokia
devices the name consists of “Nokia”, the device
model, and software version separated by “/”. There is
no space between “Nokia” and the model number nor
on either side of “/”. Formally, the syntax of the
platform string is: Nokia MODEL_NUMBER “/”
SW_VERSION.
For example, Nokia6310i/4.42 or
Nokia3510i/p1.25.
microedition.encoding Returns the platform’s default character encoding. In
Nokia devices this value is “ISO-8859-1”.
microedition.commports A comma-separated list of ports is returned which can
be combined with a comm: prefix as the URL string to
be used to open a serial port connection.
microedition.hostname Defined in MIDP 2.0
javax.microedition.io.SocketConnection
getLocalAddress() method. Returns the local
hostname, if it is available.
microedition.jtwi.version To identify a compliant device and the implemented
version of this specification, the value of the system
property microedition.jtwi.version must be
“1.0”.

MIDP: System Properties 1 (9)

 Technical Note Forum.Nokia.com

Package Discovery

String Description
microedition.media.version If the optional package is supported, a version string
is returned. Otherwise NULL.
microedition.pim.version If the optional package is supported, a version string
is returned. Otherwise NULL.
microedition.m3g.version If the optional package is supported, a version string
is returned. Otherwise NULL.
microedition.location.version If the optional package is supported, a version string
is returned. Otherwise NULL.
Bluetooth.api.version If the optional package is supported, a version string
is returned. Otherwise NULL.
microedition.io.file.FileConnect If the optional package is supported, a version string
ion.version is returned. Otherwise NULL.
microedition.global.version If the optional package is supported, a version string
is returned. Otherwise NULL.
microedition.chapi.version If the optional package is supported, a version string
is returned. Otherwise NULL.
microedition.sip.version If the optional package is supported, a version string
is returned. Otherwise NULL.

Mobile Media API

String Description
supports.mixing A query for whether audio mixing is supported. The
string returned is either “true” or “false”. If mixing is
supported, the following conditions are true:
• At least two tones can be played with
Manager.playTone simultaneously.
• Manager.playTone can be used at the
same time when at least one Player is playing
back audio.
• At least two Players can be used to play back
audio simultaneously.
supports.audio.capture A query for whether audio capture is supported. The
string returned is either “true” or “false”.
supports.video.capture A query for whether video capture is supported. The
string returned is “either” true or “false”.
supports.recording A query for whether recording is supported. The string
returned is either “true” or “false”.
audio.encodings The string returned specifies the supported capture
audio formats. Each format is specified in a special
syntax. The formats are delimited by at least one
space. For example, “encoding=audio/wav”.

MIDP: System Properties 2 (9)

 Technical Note Forum.Nokia.com

String Description
video.encodings The string returned specifies the supported capture
video formats. Each format is specified in a special
syntax. The formats are delimited by at least one
space. For example, “encoding=video/3gpp”.
video.snapshot.encodings Supported video snapshot formats for the
getSnapshot method in VideoControl. The
string returned specifies the supported capture image
formats. Each format is specified in a special syntax.
The formats are delimited by at least one space. For
example, “encoding=png”.
streamable.contents Returns formats that can be streamed. Returns null if
streamable formats do not exist. No formats support
streaming at the moment.

Wireless Messaging API

String Description
wireless.messaging.sms.smsc The address of the SMS expressed using the syntax
expressed by the msisdn item of the following BNF
definition:
msisdn ::== "+" digits | digits
digit ::== "0" | "1" | "2" | "3" | "4"
| "5" | "6" | "7" |"8" | "9"
digits ::== digit | digit digits

FileConnection API

String Description
fileconn.dir.photos This points to the directory where photos captured
with an integrated camera or other images are
stored. For example, “file:///c:/My
files/Images/”.
fileconn.dir.videos The same as the previous entry but with reference to
videos. Downloaded videos are also stored here by
default. For example, “file:///c:/My
files/Video clips/”.
fileconn.dir.tones Ring tones and other similar audio files are stored in
this directory. For example, “file:///c:/My
files/Tones/”.
fileconn.dir.memorycard Root directory of a memory card in case it is available.
For example, “file:///d:/”.
fileconn.dir.private Private work directory of MIDlet suite. For example,
(not supported in Series 40 devices) “file:///c:/System/MIDlets/[1015f294]/s
cratch”.
fileconn.dir.photos.name Localized UI name for the photos directory. For
example, “Images”.

MIDP: System Properties 3 (9)

 Technical Note Forum.Nokia.com

String Description
fileconn.dir.videos.name Localized UI name for the videos directory. For
example, “Video clips”.
fileconn.dir.tones.name Localized UI name for the sounds directory. For
example, “Sound clips”.
file.separator File separator character. In Nokia devices: “/”.
fileconn.dir.memorycard.name Localized UI name for the memory card directory. For
example, “Memory card”.

Java™ APIs for Bluetooth Wireless Technology (JSR-82)

Note : With the Bluetooth API, the LocalDevice.getProperty() method should be used to
retrieve system properties; for example:
LocalDevice.getProperty("bluetooth.connected.devices.max")

String Description
Bluetooth.l2cap.receiveMTU.max This points to the directory where photos captured
with an integrated camera or other images are
stored.
Bluetooth.connected.devices.max The maximum number of connected devices
supported (will include parked devices). The string
will be in Base10 digits.
Bluetooth.connected.inquiry Is inquiry allowed during a connection? Valid values
are “true” and “false”.
Bluetooth.connected.page Is paging allowed during a connection? Valid values
are “true” and “false”.
Bluetooth.connected.inquiry.scan Is inquiry scanning allowed during a connection?
Valid values are “true” and “false”.
Bluetooth.connected.page.scan Is page scanning allowed during a connection? Valid
values are “true” and “false”.
Bluetooth.master.switch Is master/slave switch allowed? Valid values are
“true” and “false”.
Bluetooth.sd.trans.max Maximum number of concurrent service discovery
transactions. The string will be in Base10 digits.
Bluetooth.sd.attr.retrievable.max Maximum number of service attributes to be
retrieved per service record. The string will be in
Base10 digits.

MIDP: System Properties 4 (9)

 Technical Note Forum.Nokia.com

Security and Trust Services API (SATSA) for Java™ 2 Platform, Micro Edition

String Description
microedition.smartcardslots Indicates the names of the smart card slots. The value
returned is a comma-separated list of the smart card
slots which can be used in the Connector.open()
string to identify the specific smart card slot.
A typical configuration for a cold-swappable SIM card
and a hot-swappable removable card would be:
microedition.smartcardslots: 0C,1H

Other

String Description
com.nokia.mid.dateformat The preferred date format indicated as a string
pattern, which is formatted according to the rules
defined in Java™ 2 Platform, Standard Edition, version
1.4.1, java.text.SimpleDateFormat class
documentation for date patterns. Only a subset of
SimpleDateFormat-defined pattern letters are
used in this system property.
com.nokia.mid.timeformat The preferred time format indicated as a string
(in Series 40 devices only) pattern, which is formatted according to the rules
defined in Java™ 2 Platform, Standard Edition, version
1.4.1, java.text.SimpleDateFormat class
documentation for time patterns. Only a subset of
SimpleDateFormat-defined pattern letters are
used in this system property.
com.nokia.network.access Returns the networking access point type. the
(in Series 40 devices only) possible values for this property are:
• pd — Packet data, for example GPRS
• csd — Circuit switched data, for example
GSM CSD/HSCSD data call
• bt_pan — Bluetooth PAN network
• na — Not applicable, the implementation
cannot determine the type
com.nokia.mid.imei Returns the device’s IMEI code. Note: The MIDlet must
(in Series 40 3rd Edition devices only, not in be signed, otherwise this value is NULL.
Nokia 6270 and Nokia 6101)

MIDP: System Properties 5 (9)

 Technical Note Forum.Nokia.com

SystemProperties MIDlet
This section includes the source code of the SystemProperties MIDlet for checking the system property
values listed above.

SystemProperties.java

import javax.microedition.lcdui.*;
import javax.microedition.midlet.*;

public class SystemProperties extends MIDlet implements CommandListener {

private static final String[] SYSPROPLISTS = {
"CLDC&MIDP", "Optional packages", "MMAPI", "Bluetooth API",
"FileConnection API", "WMA", "SATSA", "Other"};
private static final String[] CLDC_MIDPPROPS = {
"microedition.profiles", "microedition.configuration", "microedition.locale",
"microedition.platform", "microedition.encoding", "microedition.commports",
"microedition.hostname", "microedition.jtwi.version"};
private static final String[] OPT_SYSPROPS = {
"microedition.media.version", "microedition.pim.version",
"microedition.io.file.FileConnection.version", "microedition.m3g.version",
"microedition.location.version", "microedition.global.version",
"microedition.chapi.version", "microedition.sip.version"};
private static final String[] MMAPI_SYSPROPS = {
"supports.mixing", "supports.audio.capture", "supports.video.capture",
"supports.recording", "audio.encodings", "video.encodings",
"video.snapshot.encodings", "streamable.contents"};
private static final String[] BT_SYSPROPS = {
"bluetooth.api.version", "bluetooth.l2cap.receiveMTU.max",
"bluetooth.connected.devices.max", "bluetooth.connected.inquiry",
"bluetooth.connected.page", "bluetooth.connected.inquiry.scan",
"bluetooth.connected.page.scan", "bluetooth.master.switch",
"bluetooth.sd.trans.max", "bluetooth.sd.attr.retrievable.max"};
private static final String[] FILE_API_SYSPROPS = { "fileconn.dir.photos",
"fileconn.dir.videos", "fileconn.dir.tones", "fileconn.dir.memorycard",
"fileconn.dir.private", "fileconn.dir.photos.name", "fileconn.dir.videos.name",
"fileconn.dir.tones.name", "fileconn.dir.memorycard.name", "file.separator"};
private static final String[] WMA_SYSPROPS = {
"wireless.messaging.sms.smsc"};
private static final String[] SATSA_SYSPROPS = {
"microedition.smartcardslots"};
private static final String[] OTHER_SYSPROPS = {
"com.nokia.mid.dateformat", "com.nokia.mid.timeformat",
"com.nokia.network.access", "com.nokia.mid.imei"};
private List list;
private SysPropForm cldcmidpform;
private SysPropForm optform;
private SysPropForm mmapiform;
private SysPropForm btform;
private SysPropForm fileapiform;
private SysPropForm wmaform;
private SysPropForm satsaform;
private SysPropForm otherform;
private Command exitCommand;
protected boolean bt = false;

public SystemProperties() {
list = new List("System properties", List.IMPLICIT, SYSPROPLISTS, null);
exitCommand = new Command("Exit", Command.EXIT, 1);
list.addCommand(exitCommand);
list.setCommandListener(this);
Display.getDisplay(this).setCurrent(list);
}

protected void startApp() throws MIDletStateChangeException {

}

protected void pauseApp() {

}

protected void destroyApp(boolean p1) {

}

MIDP: System Properties 6 (9)

 Technical Note Forum.Nokia.com

public void commandAction(Command c, Displayable d) {

if (c == List.SELECT_COMMAND) {
int index = list.getSelectedIndex();
if (index == 0) {
cldcmidpform = new SysPropForm(SYSPROPLISTS[0], this, CLDC_MIDPPROPS);
Display.getDisplay(this).setCurrent(cldcmidpform);
}
if (index == 1) {
optform = new SysPropForm(SYSPROPLISTS[1], this, OPT_SYSPROPS);
Display.getDisplay(this).setCurrent(optform);
}
if (index == 2) {
mmapiform = new SysPropForm(SYSPROPLISTS[2], this, MMAPI_SYSPROPS);
Display.getDisplay(this).setCurrent(mmapiform);
}
if (index == 3) {
bt = true;
btform = new SysPropForm(SYSPROPLISTS[3], this, BT_SYSPROPS);
Display.getDisplay(this).setCurrent(btform);
}
if (index == 4) {
fileapiform = new SysPropForm(SYSPROPLISTS[4], this, FILE_API_SYSPROPS);
Display.getDisplay(this).setCurrent(fileapiform);
}
if (index == 5) {
wmaform = new SysPropForm(SYSPROPLISTS[5], this, WMA_SYSPROPS);
Display.getDisplay(this).setCurrent(wmaform);
}
if (index == 6) {
satsaform = new SysPropForm(SYSPROPLISTS[6], this, SATSA_SYSPROPS);
Display.getDisplay(this).setCurrent(satsaform);
}
if (index == 7) {
otherform = new SysPropForm(SYSPROPLISTS[7], this, OTHER_SYSPROPS);
Display.getDisplay(this).setCurrent(otherform);
}
}
if (c == exitCommand) {
quitApp();
}
}

public void quitApp() {

destroyApp(true);
notifyDestroyed();
}

protected void showList() {

Display.getDisplay(this).setCurrent(list);
}
}

SysPropForm.java

import javax.microedition.lcdui.*;
import javax.bluetooth.LocalDevice;

public class SysPropForm extends Form implements CommandListener {

private Command backCommand;
private Command exitCommand;
private SystemProperties midlet;

public SysPropForm(String title, SystemProperties midlet, String[] list) {

super(title);
this.midlet = midlet;
backCommand = new Command("Back", Command.BACK, 1);
exitCommand = new Command("Exit", Command.EXIT, 1);
addCommand(backCommand);
addCommand(exitCommand);
setCommandListener(this);

for (int i = 0; i < list.length; i++) {

append(list[i] + ":\n");
if (midlet.bt) {

MIDP: System Properties 7 (9)

 Technical Note Forum.Nokia.com

append(LocalDevice.getProperty(list[i]) + "\n");
}
else append(System.getProperty(list[i]) + "\n");
}
}

public void commandAction(Command c, Displayable d) {

if (c == backCommand) {
midlet.showList();
midlet.bt = false;
}
if (c == exitCommand) {
midlet.quitApp();
}
}
}

MIDP: System Properties 8 (9)

 Technical Note Forum.Nokia.com

Copyright © 2005 Nokia Corporation. All rights reserved.

Nokia and Nokia Connecting People are registered trademarks of Nokia Corporation. Java and all Java-based marks are
trademarks or registered trademarks of Sun Microsystems, Inc. Other product and company names mentioned herein
may be trademarks or trade names of their respective owners.

Disclaimer

The information in this document is provided “as is,” with no warranties whatsoever, including any warranty of
merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal,
specification, or sample. Furthermore, information provided in this document is preliminary, and may be changed
substantially prior to final release. This document is provided for informational purposes only.

Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to
implementation of information presented in this document. Nokia Corporation does not warrant or represent that
such use will not infringe such rights.

Nokia Corporation retains the right to make changes to this specification at any time, without notice.

License

A license is hereby granted to download and print a copy of this specification for personal use only. No other license to
any other intellectual property rights is granted herein.

MIDP: System Properties 9 (9)