2.2.3.45 DeviceInformation
The DeviceInformation element is an optional child element of the Settings element in Settings command requests and responses, and an optional child element of the Provision element in Provision command requests. In Settings and Provision command requests, it is a container node that is used for sending the client device's properties to the server. In Settings command responses, it is a container node that is used to return the status of the request.
All elements referenced in this section are defined in the Settings namespace.
|
Command request/response |
Parent elements |
Child elements |
Data type |
Number allowed |
|---|---|---|---|---|
|
Settings command request (section 2.2.1.18) |
Settings (section 2.2.3.168.2) |
Set (section 2.2.3.167) |
container ([MS-ASDTYPE] section 2.2) |
0...1 (optional) |
|
Settings command response |
Settings |
Status (section 2.2.3.177.15) |
container |
0...1 (optional) |
|
Provision command request ([MS-ASPROV] section 2.2) |
Provision ([MS-ASPROV] section 2.2.2.44) |
Set |
container |
0...1 (optional) |
If the protocol version is not 14.1, the client uses the Settings command to send DeviceInformation to the server, as specified in section 3.1.5.2. More details about the protocol versions are provided at the end of this section.
The DeviceInformation element allows the following information about a client device to be sent to the server:
§ Device model
§ International Mobile Equipment Identity (IMEI)
§ Device friendly name
§ Device operating system
§ Telephone number
§ Device operating system language
§ User Agent
§ Whether to enable outbound SMS (see [MS-ASMS])
§ Mobile operator name
The device information is represented as a list of settings under the DeviceInformation node in the Settings command request and the Provision command request. The DeviceInformation element has only one child element, Set, which contains the list of device information items in the request and the status in the response. The DeviceInformation element supports only the Set element because the device information is write-only from the device.
Protocol Versions
The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.
|
Protocol version |
Element support, Settings |
Element support, Provision |
|---|---|---|
|
2.5 |
|
|
|
12.0 |
Yes |
|
|
12.1 |
Yes |
|
|
14.0 |
Yes |
|
|
14.1 |
Yes |
Yes |
|
16.0 |
Yes |
Yes |
|
16.1 |
Yes |
Yes |
When protocol version 14.1, 16.0, or 16.1 is used, the DeviceInformation element MUST be present as a child element of the Provision element in the initial Provision command request. When protocol version 14.0, 12.1, or 12.0 is used, the DeviceInformation element MUST NOT be present as a child element of the Provision element in the initial Provision command request. In this case, the client uses the Settings command to send the device's properties to the server.