System Properties

System Properties Definitions

This specification defines the following property values (in addition to those defined in the underlying configuration that MUST be made available to the application using java.lang.System.getProperty. Other properties may be available from other configurations, profiles, or from the implementation.

System Properties
System Property	Description
`microedition.deviceid`	A unique hardware device identifier that MAY correspond to a value of one of the microedition.deviceid.* values.
`microedition.deviceid.uuid`	A unique hardware device identifier corresponding to a UUID
`microedition.deviceid.imei`	A unique hardware device identifier corresponding to the device's IMEI
`microedition.deviceid.esn`	A unique hardware device identifier corresponding to the device's ESN
`microedition.deviceid.meid`	A unique hardware device identifier corresponding to the device's MEID
`microedition.deviceid.pesn`	A unique hardware device identifier corresponding to the device's pESN
`microedition.deviceid.isunique`	A property indicating whether the device with this MEEP 8 implementation has or has not a unique device id.
`microedition.devicevendor`	An identifier for the vendor of the device with this MEEP 8 implementation.
`microedition.devicevendor.isunique`	A property indicating whether the device with this MEEP 8 implementation has or has not a unique vendor.
`microedition.locale`	The current locale of the device, MUST NOT be `null`
`microedition.profiles`	A blank (Unicode U+0020) separated list of the Java ME profiles that this device supports. For a device implementing a certain ME profile version, this property MUST contain at least a string identifying the recent profile version.
`microedition.platform`	Name of the host platform or device
`microedition.security.authentication`	A string representing the active Authentication Provider.
`microedition.security.policy`	A string representing the active Security Policy Provider.
`microedition.commports`	A comma separated list of available logical serial ports
`microedition.hostname`	The local hostname (if available)
`microedition.lui`	`true` if the javax.microedition.lui (Line-oriented UI) package is implemented in this implementation, not available otherwise
`microedition.key`	`true` if the javax.microedition.key (Key input support) package is implemented in this implementation, not available otherwise
`microedition.rms`	`true` if the javax.microedition.rms (Record Management System) package is implemented in this implementation, not available otherwise
`microedition.media.audio`	`true` if the javax.microedition.media and javax.microedition.media.control (Audio Media Support) packages are implemented in this implementation, not available otherwise
`microedition.io`	`true` if the javax.microedition.io (Connectivity) package is implemented in this implementation, not available otherwise
`microedition.io.gcf`	`true` if GCF is supported by the underlying CLDC 8 implementation, not available otherwise
`microedition.swm`	`true` if the javax.microedition.swm (Software Management System) package is implemented in this implementation, not available otherwise
`microedition.cellular`	`true` if the javax.microedition.cellular (Cellular Network) package is implemented in this implementation, not available otherwise
`microedition.event`	`true` if the javax.microedition.event package (Event Management) is implemented in this implementation, not available otherwise
`microedition.power`	`true` if the javax.microedition.power package (Power Management) is implemented in this implementation, not available otherwise

Device Identifier System Properties

The microedition.deviceid property MUST always provide a value. Since there is no standard for device IDs in the embedded world, this value MAY correspond to one of the microedition.deviceid.* values if present, or it MAY contain another value. If the value presents a device ID being guaranteed unique, the microedition.deviceid.isunique property MUST contain the value true.

As in the embedded world a unique device ID is not mandatory, the value of microedition.deviceid MAY also be microedition.deviceid.UNKNOWN. In this case or if it contains the value of a device ID, but this device ID cannot be guaranteed to be unique, the value of the microedition.deviceid.isunique property MUST be false.
The microedition.deviceid.uuid property MAY contain a UUID string value that can be used to uniquely identify the device. The format of the value of this property, if present, MUST correspond to a Universally Unique Identifier (UUID) as defined in [RFC4122]. This value MUST consist of 32 hexadecimal digits. Implementations SHOULD use UUID version 1 if a 48 bit IEEE address is available; otherwise, implementations SHOULD use version 4 UUID using a randomly or pseudo-randomly generated 48 bit value. The value of this property, if present, MUST be identical for all concurrently executing or consecutively invoked applications on a device.
The microedition.deviceid.imei property MAY contain an IMEI string value that can be used to uniquely identify the device. The format of the value of this property, if present, MUST correspond to an International Mobile Station Equipment Identity (IMEI) as defined in [3GPP-TS23.003].
The microedition.deviceid.esn property MAY contain an ESN string value that can be used to uniquely identify the device. The format of the value of this property, if present, MUST correspond to an Electronic Serial Number (ESN) as defined in [TIA-ESN] and MUST consist of 8 hexadecimal digits.
The microedition.deviceid.meid property MAY contain an MEID string value that can be used to uniquely identify the device. The format of the value of this property, if present, MUST correspond to a Mobile Equipment Identifier (MEID) as defined in [3GPP2 S.R0048-A] and MUST consist of 14 hexadecimal digits.
The microedition.deviceid.pesn property MAY contain a pESN string value that can be used to uniquely identify the device. The format of the value of this property, if present, MUST correspond to a Pseudo Electronic Serial Number (pESN) as defined in [3GPP2 X.S0008-0] and MUST consist of 8 hexadecimal digits.
The microedition.deviceid.isunique property MUST contain a value true or false. If the value of the corresponding system property microedition.deviceid is guaranteed to be a deviceid being unique, the value MUST be true. If the value of the corresponding system property microedition.deviceid is microedition.deviceid.UNKNOWN or represents a device ID not being guaranteed to be unique, the value MUST be false.

Device Vendor System Properties

The microedition.devicevendor property MUST always provide a value. Since there is no standard for unique device vendors in the embedded world, the value MAY be microedition.devicevendor.UNKNOWN. In this case or if it contains a name of a vendor that cannot be guaranteed to be unique, the value of the microedition.deviceid.isunique property MUST be false, otherwise it MUST be true.
The microedition.devicevendor.isunique property MUST contain a value true or false. If the value of the corresponding system property microedition.devicevendor is guaranteed to be unique, the value MUST be true. If the value of the corresponding system property microedition.devicevendor is microedition.devicevendor.UNKNOWN or represents a vendor name not being guaranteed to be unique, the value MUST be false.

microedition.locale

The microedition.locale property MUST include at least the language code, and SHOULD also include the country code, followed by an OPTIONAL variant, separated by "-" (Unicode U+002D). For example, fr-FR or en-US or zh-CN-Hans.

The language codes MUST be the lower-case, two-letter codes as defined by ISO 639-1:2002.

The country codes MUST be the upper-case, two-letter codes as defined by ISO 3166-1:1997.

(Note: Former versions of ME profiles used the HTTP formatting of language tags as defined in [RFC3066], Tags for the Identification of Languages. This is different from the Java SE definition for java.util.Locale printed strings where fields are separated by "_" (Unicode U+005F).)

microedition.profiles

The microedition.profiles system property MUST NOT contain different versions of the same profile. In particular, previous profile versions MUST NOT be listed, only the recent one.

microedition.platform

The value of the microedition.platform system property MUST conform to the following syntax (BNF):

<property value>	::= <Manufacturer Name>"/" <Device Model Identifier> ["/"<Version Identifier> ["/"<Additional Comment>]]
<Manufacturer Name>	::= Manufacturer Name
<Device Model Identifier>	::= Device Model Identifier
<Version Identifier>	::= Version Identifier
<Additional Comment>	::= Additional Comment

Manufacturer name and device model number are mandatory and MUST be separated with a forward slash (/). Optional version identifier MAY be present. In case there is a version identifier, additional comments MAY be present as well. The version identifier and optional additional comments MUST be separated from the rest of the string with a forward slash (/) each. The value of the property MUST NOT contain any forward slash (/) characters other than those that are used as delimiters. For the sake of readability, it is recommended that the property string does not contain white spaces.

Examples for recommended values of microedition.platform system property are:

CompanyA/ABC123
CompanyB/Z456/23E-4.1Advanced
CompanyB/Z456/23E-4.1Advanced/EuropaVersion

microedition.commports

The value of the microedition.commports system property MUST contain a comma separated list of available logical port names, any of which can be combined with a comm: prefix as the URL string to be used to open a serial port connection. See javax.microedition.io.CommConnection for more information.

microedition.hostname

The value of the microedition.hostname system property MUST contain the host name of the local device, if it is available.

Remark : System properties describing subscriber IDs that used to be available in former profile versions have been replaced by properties in the newly introduced Cellular API and can be retrieved via Subscriber#getProperties() method.

Optional package system properties

For every optional package in MEEP 8 and every component being optional in the underlying CLDC 8 configuration (such as GCF), there exists a system property with the boolean value true if the respective optional package / component is implemented in the recent CLDC 8 plus MEEP 8 software stack, otherwise the respective system property is not available so that a call to System.getProperty would return null.

@since IMP 1.0