HardwareInfo

#include <bb/device/HardwareInfo>

To link against this class, add the following line to your .pro file: LIBS += -lbbdevice

Provides access to information about the device hardware.

The HardwareInfo class provides access to information about the configuration, availability, or general values about the device hardware. Many of the methods are protected by permissions because they can be used to uniquely identify a device. Be sure to check the description of individual methods before using them, and ensure that the required permissions have been requested.

Since:

BlackBerry 10.0.0

Properties Index

QStringpin [read-only]
QStringserialNumber [read-only]
QStringimei [read-only]
QStringmeid [read-only]
QStringhardwareId [read-only]
QStringdeviceName [read-only]
QStringmodelName [read-only]
QStringmodelNumber [read-only]
boolisPhysicalKeyboardDevice [read-only]
bb::device::HdmiConnector::TypehdmiConnector [read-only]

Public Functions Index

HardwareInfo (QObject *parent=0)
virtual ~HardwareInfo ()
QStringpin () const
QStringserialNumber () const
QStringimei () const
QStringmeid () const
QStringhardwareId () const
QStringdeviceName () const
intprocessorCount () const
PRIVATE intprocessorSpeed (int cpuNumber) const
PRIVATE QStringprocessorModel (int cpuNumber) const
PRIVATE QStringmodelName () const
QStringmodelNumber () const
boolisPhysicalKeyboardDevice () const
bb::device::HdmiConnector::TypehdmiConnector () const

Properties

QString pin[read-only]

The unique identifier for the device.

Since:

BlackBerry 10.0.0

QString serialNumber[read-only]

The serial number for the device.

Since:

BlackBerry 10.0.0

QString imei[read-only]

International mobile equipment identity (IMEI) of the device.

Since:

BlackBerry 10.0.0

QString meid[read-only]

Mobile equipment identifier (MEID) of the device.

Since:

BlackBerry 10.0.0

QString hardwareId[read-only]

Hardware identifier of the device.

Since:

BlackBerry 10.0.0

QString deviceName[read-only]

Name of the device.

Since:

BlackBerry 10.0.0

QString modelName[read-only]

The device model name.

Since:

BlackBerry 10.0.0

QString modelNumber[read-only]

The device model number.

Since:

BlackBerry 10.0.0

bool isPhysicalKeyboardDevice[read-only]

Indicates if the device is a physical keyboard device or not.

Since:

BlackBerry 10.0.0

bb::device::HdmiConnector::Type hdmiConnector[read-only]

Indicates what kind of HDMI connector the device has, if any.

Since:

BlackBerry 10.1.0

Public Functions

HardwareInfo (

Constructs a HardwareInfo object.

Constructs a HardwareInfo object that can be used to retrieve information about the device.

Parameters
parent

If not 0, the supplied parent is responsible for deleting this instance.
Since:

BlackBerry 10.0.0

virtual~HardwareInfo ()

Destructor.

Since:

BlackBerry 10.0.0

QString pin ()

Retrieves the device PIN.

This function lets you retrieve the PIN of the BlackBerry device, which is a unique identifier for the device.

Some examples of PIN number values are:

  • "0x08A34C0A"

  • "0x31C45EF8"

  • "0x89912341"

Permissions:

The application must have the read_device_identifying_information permission to access the device PIN.

Return:

Returns the PIN of the device, or an empty string if the calling function does not have sufficient permission to read the PIN value.

Since:

BlackBerry 10.0.0

QString serialNumber ()

Retrieves the device serial number.

This function retrieves the serial number of the device as a QString. When displayed as a string it typically takes the form of a 22 digit base 10 number.

Some examples of serial number values are:

  • "0000000000134300329165"

  • "0000000000134300213459"

  • "0000000000134300118234"

Permissions:

The application must have the read_device_identifying_information permission to access the serial number.

Return:

Returns the serial number of the device, or an empty string if the calling function does not have sufficient permission.

Since:

BlackBerry 10.0.0

QString imei ()

Retrieves the international mobile equipment identity (IMEI) of the device.

The IMEI uniquely identifies a device that connects to a GSM cellular network. The IMEI is composed of 14 decimal digits, plus a check digit. For more information about the structure of the IMEI, see 3GPP TS 23.003.

Permissions:

The application must have the read_device_identifying_information permission to access the deivce's IMEI.

Return:

Returns the IMEI of the device encoded as a string, an empty string in the case where either the calling function does not have sufficient permission to read the IMEI, or if the device has no IMEI.

Since:

BlackBerry 10.0.0

QString meid ()

Retrieves the mobile equipment identifier (MEID) of the device.

The MEID uniquely identifies a device that connects to a CDMA cellular network. The MEID is composed of 14 hexadecimal digits. For more information about the structure of the MEID, see 3GPP2 report S.R0048.

Permissions:

The application must have the read_device_identifying_information permission to access the device's MEID.

Return:

The MEID of the device encoded as a string, or an empty string in the case where either the calling function does not have sufficient permission to read the MEID, or if the device has no MEID.

Since:

BlackBerry 10.0.0

QString hardwareId ()

Retrieves the hardware identifier of the device.

The hardware identifier provides a value that is identical across all devices of similar configuration.

An example of a hardware identifier is:

  • "0x04002607".

All devices with this identifier will have the same characteristics, such as radio, screen size, processor, etc.

Return:

The hardware identifier of the device encoded as a string.

Since:

BlackBerry 10.0.0

QString deviceName ()

Retrieves the 'name' identifier attached to the device model.

The device name provides a value that helps to identify the device.

Return:

The name of the device encoded as a string.

Since:

BlackBerry 10.0.0

int processorCount ()

Returns the number of processors on the device.

Return:

The number of processors on the device, or 0 on error.

Since:

BlackBerry 10.0.0

PRIVATE int processorSpeed (
  • intcpuNumber)

Returns the CPU clock speed of the processor at the supplied index, in MHz.

Parameters
cpuNumber

The index of the CPU for which the clock speed is requested. Valid indices are greater than or equal to 0 and less than the number of available processors (as given by HardwareInfo::processorCount()).
Return:

The clock speed of the processor at the provided index, or 0 on error.

Since:

BlackBerry 10.0.0

PRIVATE QString processorModel (
  • intcpuNumber)

Returns the CPU model of the processor at the supplied index.

Parameters
cpuNumber

The index of the CPU for the model requested. Valid indices are greater than or equal to 0 and less than the number of available processors (as given by HardwareInfo::processorCount()).
Return:

Returns the model of the processor at the index provided, and an empty string otherwise.

Since:

BlackBerry 10.0.0

PRIVATE QString modelName ()

Returns the model name of the device.

Permissions:

The application must have the access_device_model_name permission to access the model name of the device.

Return:

Returns the model name of the device, or an empty string otherwise.

Since:

BlackBerry 10.0.0

QString modelNumber ()

Returns the model number of the device.

Permissions:

The application must have the access_device_model_name permission to access the model number of the device.

Return:

Returns the model number of the device, or an empty string otherwise.

Since:

BlackBerry 10.0.0

bool isPhysicalKeyboardDevice ()

Returns whether or not a physical keyboard is present on the device.

Return:

Returns true if the device has a physical keyboard, and false otherwise.

Since:

BlackBerry 10.0.0

bb::device::HdmiConnector::Type hdmiConnector ()

Indicates whether the device possesses an HDMI connector, and if so what type.

Return:

Returns one of bb::device::HdmiConnector::Type.

Since:

BlackBerry 10.1.0