QtMobility Reference Documentation

QBluetoothDeviceInfo Class Reference

The QBluetoothDeviceInfo class provides information about Bluetooth devices. More...

 #include <QBluetoothDeviceInfo>

This class was introduced in Qt Mobility 1.2.

Public Types

enum DataCompleteness { DataComplete, DataIncomplete, DataUnavailable }
enum MajorDeviceClass { MiscellaneousDevice, ComputerDevice, PhoneDevice, LANAccessDevice, ..., UncategorizedDevice }
enum MinorAudioVideoClass { UncategorizedAudioVideoDevice, WearableHeadsetDevice, HandsFreeDevice, Microphone, ..., GamingDevice }
enum MinorComputerClass { UncategorizedComputer, DesktopComputer, ServerComputer, LaptopComputer, ..., WearableComputer }
enum MinorHealthClass { UncategorizedHealthDevice, HealthBloodPressureMonitor, HealthThermometer, HealthWeightScale, ..., HealthStepCounter }
enum MinorImagingClass { UncategorizedImagingDevice, ImageDisplay, ImageCamera, ImageScanner, ImagePrinter }
enum MinorMiscellaneousClass { UncategorizedMiscellaneous }
enum MinorNetworkClass { NetworkFullService, NetworkLoadFactorOne, NetworkLoadFactorTwo, NetworkLoadFactorThree, ..., NetworkNoService }
enum MinorPeripheralClass { UncategorizedPeripheral, KeyboardPeripheral, PointingDevicePeripheral, KeyboardWithPointingDevicePeripheral, ..., CardReaderPeripheral }
enum MinorPhoneClass { UncategorizedPhone, CellularPhone, CordlessPhone, SmartPhone, WiredModemOrVoiceGatewayPhone, CommonIsdnAccessPhone }
enum MinorToyClass { UncategorizedToy, ToyRobot, ToyVehicle, ToyDoll, ToyController, ToyGame }
enum MinorWearableClass { UncategorizedWearableDevice, WearableWristWatch, WearablePager, WearableJacket, WearableHelmet, WearableGlasses }
enum ServiceClass { NoService, PositioningService, NetworkingService, RenderingService, ..., AllServices }
flags ServiceClasses

Public Functions

QBluetoothDeviceInfo ()
QBluetoothDeviceInfo ( const QBluetoothAddress & address, const QString & name, quint32 classOfDevice )
QBluetoothDeviceInfo ( const QBluetoothDeviceInfo & other )
~QBluetoothDeviceInfo ()
QBluetoothAddress address () const
bool isCached () const
bool isValid () const
MajorDeviceClass majorDeviceClass () const
QByteArray manufacturerSpecificData ( bool * available = 0 ) const
quint8 minorDeviceClass () const
QString name () const
qint16 rssi () const
ServiceClasses serviceClasses () const
QList<QBluetoothUuid> serviceUuids ( DataCompleteness * completeness = 0 ) const
DataCompleteness serviceUuidsCompleteness () const
void setCached ( bool cached )
void setManufacturerSpecificData ( const QByteArray & data )
void setRssi ( qint16 signal )
void setServiceUuids ( const QList<QBluetoothUuid> & uuids, DataCompleteness completeness )
QBluetoothDeviceInfo & operator= ( const QBluetoothDeviceInfo & other )
bool operator== ( const QBluetoothDeviceInfo & other ) const

Detailed Description

The QBluetoothDeviceInfo class provides information about Bluetooth devices.

QBluetoothDeviceInfo provides information about a Bluetooth device's name, address and class of device.

Member Type Documentation

enum QBluetoothDeviceInfo::DataCompleteness

This enum describes the completeness of the received data.

QBluetoothDeviceInfo::DataComplete0The data is complete.
QBluetoothDeviceInfo::DataIncomplete1The data is incomplete. Addition datum is available via other interfaces.
QBluetoothDeviceInfo::DataUnavailable2No data is available.

enum QBluetoothDeviceInfo::MajorDeviceClass

This enum describes a Bluetooth device's major device class.

QBluetoothDeviceInfo::MiscellaneousDevice0A miscellaneous device.
QBluetoothDeviceInfo::ComputerDevice1A computer device or PDA.
QBluetoothDeviceInfo::PhoneDevice2A telephone device.
QBluetoothDeviceInfo::LANAccessDevice3A device that provides access to a local area network.
QBluetoothDeviceInfo::AudioVideoDevice4A device capable of playback or capture of audio and/or video.
QBluetoothDeviceInfo::PeripheralDevice5A peripheral device such as a keyboard, mouse, etc.
QBluetoothDeviceInfo::ImagingDevice6An imaging device such as a display, printer, scanner or camera.
QBluetoothDeviceInfo::WearableDevice7A wearable device such as a watch or pager.
QBluetoothDeviceInfo::ToyDevice8A toy.
QBluetoothDeviceInfo::HealthDevice9A health reated device such as heart rate, or temperature.
QBluetoothDeviceInfo::UncategorizedDevice31A device that does not fit into any of the other device classes.

enum QBluetoothDeviceInfo::MinorAudioVideoClass

This enum describes the minor device classes for audio/video devices.

QBluetoothDeviceInfo::UncategorizedAudioVideoDevice0An uncategorized audio/video device.
QBluetoothDeviceInfo::WearableHeadsetDevice1A wearable headset device.
QBluetoothDeviceInfo::HandsFreeDevice2A hands free device.
QBluetoothDeviceInfo::Microphone4A microphone.
QBluetoothDeviceInfo::Loudspeaker5A loudspeaker.
QBluetoothDeviceInfo::PortableAudioDevice7A portable audio device.
QBluetoothDeviceInfo::CarAudio8A car audio device.
QBluetoothDeviceInfo::SetTopBox9A set top box.
QBluetoothDeviceInfo::HiFiAudioDevice10A HiFi audio device.
QBluetoothDeviceInfo::Vcr11A video cassette recorder.
QBluetoothDeviceInfo::VideoCamera12A video camera.
QBluetoothDeviceInfo::Camcorder13A video camera.
QBluetoothDeviceInfo::VideoMonitor14A video monitor.
QBluetoothDeviceInfo::VideoDisplayAndLoudspeaker15A video display with built-in loudspeaker.
QBluetoothDeviceInfo::VideoConferencing16A video conferencing device.
QBluetoothDeviceInfo::GamingDevice18A gaming device.

enum QBluetoothDeviceInfo::MinorComputerClass

This enum describes the minor device classes for computer devices.

QBluetoothDeviceInfo::UncategorizedComputer0An uncategorized computer device.
QBluetoothDeviceInfo::DesktopComputer1A desktop computer.
QBluetoothDeviceInfo::ServerComputer2A server computer.
QBluetoothDeviceInfo::LaptopComputer3A laptop computer.
QBluetoothDeviceInfo::HandheldClamShellComputer4A clamshell handheld computer or PDA.
QBluetoothDeviceInfo::HandheldComputer5A handheld computer or PDA.
QBluetoothDeviceInfo::WearableComputer6A wearable computer.

enum QBluetoothDeviceInfo::MinorHealthClass

This enum describes the minor device classes for health devices.

QBluetoothDeviceInfo::UncategorizedHealthDevice0An uncategorized health device.
QBluetoothDeviceInfo::HealthBloodPressureMonitor0x1A blood pressure monitor.
QBluetoothDeviceInfo::HealthThermometer0x2A Thermometer.
QBluetoothDeviceInfo::HealthWeightScale0x3A scale.
QBluetoothDeviceInfo::HealthGlucoseMeter0x4A glucose meter.
QBluetoothDeviceInfo::HealthPulseOximeter0x5A blood oxygen saturation meter.
QBluetoothDeviceInfo::HealthDataDisplay0x7A data display.
QBluetoothDeviceInfo::HealthStepCounter0x8A pedometer.

enum QBluetoothDeviceInfo::MinorImagingClass

This enum describes the minor device classes for imaging devices.

QBluetoothDeviceInfo::UncategorizedImagingDevice0An uncategorized imaging device.
QBluetoothDeviceInfo::ImageDisplay0x04A device capable of displaying images.
QBluetoothDeviceInfo::ImageCamera0x08A camera.
QBluetoothDeviceInfo::ImageScanner0x10An image scanner.
QBluetoothDeviceInfo::ImagePrinter0x20A printer.

enum QBluetoothDeviceInfo::MinorMiscellaneousClass

This enum describes the minor device classes for miscellaneous Bluetooth devices.

QBluetoothDeviceInfo::UncategorizedMiscellaneous0An uncategorized miscellaneous device.

enum QBluetoothDeviceInfo::MinorNetworkClass

This enum describes the minor device classes for local area network access devices. Local area network access devices use the minor device class to specify the current network utilization.

QBluetoothDeviceInfo::NetworkFullService0x00100% of the total bandwidth is available.
QBluetoothDeviceInfo::NetworkLoadFactorOne0x080 - 17% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorTwo0x1017 - 33% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorThree0x1833 - 50% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorFour0x2050 - 67% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorFive0x2867 - 83% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkLoadFactorSix0x3083 - 99% of the total bandwidth is currently being used.
QBluetoothDeviceInfo::NetworkNoService0x38No network service available.

enum QBluetoothDeviceInfo::MinorPeripheralClass

This enum describes the minor device classes for peripheral devices.

QBluetoothDeviceInfo::UncategorizedPeripheral0An uncategorized peripheral device.
QBluetoothDeviceInfo::KeyboardPeripheral0x10A keyboard.
QBluetoothDeviceInfo::PointingDevicePeripheral0x20A pointing device, for example a mouse.
QBluetoothDeviceInfo::KeyboardWithPointingDevicePeripheral0x30A keyboard with built-in pointing device.
QBluetoothDeviceInfo::JoystickPeripheral0x01A joystick.
QBluetoothDeviceInfo::GamepadPeripheral0x02A game pad.
QBluetoothDeviceInfo::RemoteControlPeripheral0x03A remote control.
QBluetoothDeviceInfo::SensingDevicePeripheral0x04A sensing device.
QBluetoothDeviceInfo::DigitizerTabletPeripheral0x05A digitizer tablet peripheral.
QBluetoothDeviceInfo::CardReaderPeripheral0x06A card reader peripheral.

enum QBluetoothDeviceInfo::MinorPhoneClass

This enum describes the minor device classes for phone devices.

QBluetoothDeviceInfo::UncategorizedPhone0An uncategorized phone device.
QBluetoothDeviceInfo::CellularPhone1A cellular phone.
QBluetoothDeviceInfo::CordlessPhone2A cordless phone.
QBluetoothDeviceInfo::SmartPhone3A smart phone.
QBluetoothDeviceInfo::WiredModemOrVoiceGatewayPhone4A wired modem or voice gateway.
QBluetoothDeviceInfo::CommonIsdnAccessPhone5A device that provides ISDN access.

enum QBluetoothDeviceInfo::MinorToyClass

This enum describes the minor device classes for toy devices.

QBluetoothDeviceInfo::UncategorizedToy0An uncategorized toy.
QBluetoothDeviceInfo::ToyRobot1A toy robot.
QBluetoothDeviceInfo::ToyVehicle2A toy vehicle.
QBluetoothDeviceInfo::ToyDoll3A toy doll or action figure.
QBluetoothDeviceInfo::ToyController4A controller.
QBluetoothDeviceInfo::ToyGame5A game.

enum QBluetoothDeviceInfo::MinorWearableClass

This enum describes the minor device classes for wearable devices.

QBluetoothDeviceInfo::UncategorizedWearableDevice0An uncategorized wearable device.
QBluetoothDeviceInfo::WearableWristWatch1A wristwatch.
QBluetoothDeviceInfo::WearablePager2A pager.
QBluetoothDeviceInfo::WearableJacket3A jacket.
QBluetoothDeviceInfo::WearableHelmet4A helmet.
QBluetoothDeviceInfo::WearableGlasses5A pair of glasses.

enum QBluetoothDeviceInfo::ServiceClass
flags QBluetoothDeviceInfo::ServiceClasses

This enum describes the service class of the Bluetooth device. The service class is used as a rudimentary form of service discovery. It is meant to provide a rudimentary list of the types of services that the device might provide.

QBluetoothDeviceInfo::NoService0x0000The device does not provide any services.
QBluetoothDeviceInfo::PositioningService0x0001The device provides positioning services.
QBluetoothDeviceInfo::NetworkingService0x0002The device provides networking services.
QBluetoothDeviceInfo::RenderingService0x0004The device provides rendering services.
QBluetoothDeviceInfo::CapturingService0x0008The device provides capturing services.
QBluetoothDeviceInfo::ObjectTransferService0x0010The device provides object transfer services.
QBluetoothDeviceInfo::AudioService0x0020The device provides audio services.
QBluetoothDeviceInfo::TelephonyService0x0040The device provides telephony services.
QBluetoothDeviceInfo::InformationService0x0080The device provides information services.
QBluetoothDeviceInfo::AllServices0x07ffThe device provides services of all types.

The ServiceClasses type is a typedef for QFlags<ServiceClass>. It stores an OR combination of ServiceClass values.

Member Function Documentation

QBluetoothDeviceInfo::QBluetoothDeviceInfo ()

Constructs an invalid QBluetoothDeviceInfo object.

QBluetoothDeviceInfo::QBluetoothDeviceInfo ( const QBluetoothAddress & address, const QString & name, quint32 classOfDevice )

Constructs a QBluetoothDeviceInfo object with Bluetooth address address, device name name and the encoded class of device classOfDevice.

The classOfDevice parameter is encoded in the following format

0 - 12Unused, set to 0.
2 - 76Minor device class.
8 - 125Major device class.
13 - 2311Service class.

QBluetoothDeviceInfo::QBluetoothDeviceInfo ( const QBluetoothDeviceInfo & other )

Constructs a QBluetoothDeviceInfo that is a copy of other.

QBluetoothDeviceInfo::~QBluetoothDeviceInfo ()

Destroys the QBluetoothDeviceInfo.

QBluetoothAddress QBluetoothDeviceInfo::address () const

Returns the address of the device.

bool QBluetoothDeviceInfo::isCached () const

Returns true if the QBluetoothDeviceInfo object is created from cached data

bool QBluetoothDeviceInfo::isValid () const

Returns true if the QBluetoothDeviceInfo object is valid, otherwise returns false.

MajorDeviceClass QBluetoothDeviceInfo::majorDeviceClass () const

Returns the major device class of the device.

QByteArray QBluetoothDeviceInfo::manufacturerSpecificData ( bool * available = 0 ) const

Returns the manufacturer specific data. If available is not 0 it is set to true if manufacturer specific data is available; otherwise it is set to false.

Unsupported on all platforms at this time. Always return QByteArry();

See also setManufacturerSpecificData().

quint8 QBluetoothDeviceInfo::minorDeviceClass () const

Returns the minor device class of the device.

QString QBluetoothDeviceInfo::name () const

Returns the name assigned to the device.

qint16 QBluetoothDeviceInfo::rssi () const

Returns the signal strength when the device was last scanned

See also setRssi().

ServiceClasses QBluetoothDeviceInfo::serviceClasses () const

Returns the service class of the device.

QList<QBluetoothUuid> QBluetoothDeviceInfo::serviceUuids ( DataCompleteness * completeness = 0 ) const

Returns the list of service UUIDS supported by the device. If completeness is not 0 it will be set to DataComplete if the returned list is the complete list of UUIDs supported by the device. DataIncomplete if additional service UUIDs are supported by the device and DataUnavailable if no service UUID information is available.

This function requires both Bluetooth devices to support the 2.1 specification.

See also setServiceUuids().

DataCompleteness QBluetoothDeviceInfo::serviceUuidsCompleteness () const

Returns the completeness of the service UUID list. If DataComplete is returned then serviceUuids() will return a complete list of service UUIDs supported by the device. Otherwise serviceUuids() will only return a partial or empty list of service UUIDs. To get a full list of services supported by the device a full service discovery needs to be performed.

void QBluetoothDeviceInfo::setCached ( bool cached )

Used by the system to set the cached flag if the QBluetoothDeviceInfo is created from cached data. Cached information may not be as accurate as data read from a live device.

See also isCached().

void QBluetoothDeviceInfo::setManufacturerSpecificData ( const QByteArray & data )

Sets the manufacturer specific data returned by Extended Inquiry Responses to data.

Unsupported on all platforms at this time.

See also manufacturerSpecificData().

void QBluetoothDeviceInfo::setRssi ( qint16 signal )

Set the signal strength value, used internally.

See also rssi().

void QBluetoothDeviceInfo::setServiceUuids ( const QList<QBluetoothUuid> & uuids, DataCompleteness completeness )

Sets the list of service UUIDs to uuids and the completeness of the data to completeness.

See also serviceUuids().

QBluetoothDeviceInfo & QBluetoothDeviceInfo::operator= ( const QBluetoothDeviceInfo & other )

Makes a copy of the other and assigns it to this QBluetoothDeviceInfo object.

bool QBluetoothDeviceInfo::operator== ( const QBluetoothDeviceInfo & other ) const

Returns true if the other QBluetoothDeviceInfo object and this are identical


Thank you for giving your feedback.

Make sure it is related to this specific page. For more general bugs and requests, please use the Qt Bug Tracker.