The QBluetoothSocket class provides a Bluetooth socket. More...
#include <QBluetoothSocket>
Inherits: QIODevice.
This class was introduced in Qt Mobility 1.2.
| enum | SocketError { UnknownSocketError, NoSocketError, ConnectionRefusedError, RemoteHostClosedError, ..., NetworkError } |
| enum | SocketState { UnconnectedState, ServiceLookupState, ConnectingState, ConnectedState, ..., ListeningState } |
| enum | SocketType { UnknownSocketType, L2capSocket, RfcommSocket } |
| QBluetoothSocket ( SocketType socketType, QObject * parent = 0 ) | |
| QBluetoothSocket ( QObject * parent = 0 ) | |
| virtual | ~QBluetoothSocket () |
| void | abort () |
| void | connectToService ( const QBluetoothServiceInfo & service, OpenMode openMode = ReadWrite ) |
| void | connectToService ( const QBluetoothAddress & address, const QBluetoothUuid & uuid, OpenMode openMode = ReadWrite ) |
| void | connectToService ( const QBluetoothAddress & address, quint16 port, OpenMode openMode = ReadWrite ) |
| void | disconnectFromService () |
| SocketError | error () const |
| QString | errorString () const |
| QBluetoothAddress | localAddress () const |
| QString | localName () const |
| quint16 | localPort () const |
| QBluetoothAddress | peerAddress () const |
| QString | peerName () const |
| quint16 | peerPort () const |
| bool | setSocketDescriptor ( int socketDescriptor, SocketType socketType, SocketState socketState = ConnectedState, OpenMode openMode = ReadWrite ) |
| int | socketDescriptor () const |
| SocketType | socketType () const |
| SocketState | state () const |
| virtual qint64 | bytesAvailable () const |
| virtual qint64 | bytesToWrite () const |
| virtual bool | canReadLine () const |
| virtual void | close () |
| virtual bool | isSequential () const |
| void | connected () |
| void | disconnected () |
| void | error ( QBluetoothSocket::SocketError error ) |
| void | stateChanged ( QBluetoothSocket::SocketState state ) |
| void | doDeviceDiscovery ( const QBluetoothServiceInfo & service, OpenMode openMode ) |
| void | setSocketError ( SocketError error_ ) |
| void | setSocketState ( SocketState state ) |
| virtual qint64 | readData ( char * data, qint64 maxSize ) |
| virtual qint64 | writeData ( const char * data, qint64 maxSize ) |
The QBluetoothSocket class provides a Bluetooth socket.
QBluetoothSocket supports two socket types, L2CAP and RFCOMM.
L2CAP is a low level datagram-oriented Bluetooth socket.
RFCOMM is a reliable, stream-oriented socket. RFCOMM sockets emulate an RS-232 serial port.
To create a connection to a Bluetooth service create a socket of the appropriate type and call connectToService() passing the Bluetooth address and port number. QBluetoothSocket will emit the connected() signal when the connection is established.
This enum describes Bluetooth socket error types.
| Constant | Value | Description |
|---|---|---|
| QBluetoothSocket::UnknownSocketError | QAbstractSocket::UnknownSocketError | An unknown error has occurred. |
| QBluetoothSocket::NoSocketError | -2 | No error. Used for testing. |
| QBluetoothSocket::ConnectionRefusedError | QAbstractSocket::ConnectionRefusedError | Connection refused or device not available. |
| QBluetoothSocket::RemoteHostClosedError | QAbstractSocket::RemoteHostClosedError | The remote host closed the socket |
| QBluetoothSocket::HostNotFoundError | QAbstractSocket::HostNotFoundError | Could not find the remote host |
| QBluetoothSocket::ServiceNotFoundError | QAbstractSocket::SocketAddressNotAvailableError | Could not find the service UUID on remote host |
| QBluetoothSocket::NetworkError | QAbstractSocket::NetworkError | Attempt to read or write from socket returned an error |
This enum describes the state of the Bluetooth socket.
| Constant | Value | Description |
|---|---|---|
| QBluetoothSocket::UnconnectedState | QAbstractSocket::UnconnectedState | Socket is not connected. |
| QBluetoothSocket::ServiceLookupState | QAbstractSocket::HostLookupState | Socket is querying connection parameters. |
| QBluetoothSocket::ConnectingState | QAbstractSocket::ConnectingState | Socket is attempting to connect to a device. |
| QBluetoothSocket::ConnectedState | QAbstractSocket::ConnectedState | Socket is connected to a device. |
| QBluetoothSocket::BoundState | QAbstractSocket::BoundState | 242.nmp.nokia.com _IceTransSocketUNIXConnect: Cannot connect to non-local host saisd Socket is bound to a local address and port. |
| QBluetoothSocket::ClosingState | QAbstractSocket::ClosingState | Socket is connected and will be closed once all pending data is written to the socket. |
| QBluetoothSocket::ListeningState | QAbstractSocket::ListeningState | Socket is listening for incoming connections. |
This enum describes the Bluetooth socket type.
| Constant | Value | Description |
|---|---|---|
| QBluetoothSocket::UnknownSocketType | -1 | Unknown socket type. |
| QBluetoothSocket::L2capSocket | 0 | L2CAP socket. |
| QBluetoothSocket::RfcommSocket | 1 | RFCOMM socket. |
Constructs a Bluetooth socket of socketType type, with parent.
Constructs a Bluetooth socket with parent.
Destroys the Bluetooth socket.
Aborts the current connection and resets the socket. Unlike disconnectFromService(), this function immediately closes the socket, discarding any pending data in the write buffer.
See also disconnectFromService() and close().
Reimplemented from QIODevice::bytesAvailable().
Returns the number of incoming bytes that are waiting to be read.
See also bytesToWrite() and read().
Reimplemented from QIODevice::bytesToWrite().
Returns the number of bytes that are waiting to be written. The bytes are written when control goes back to the event loop.
Reimplemented from QIODevice::canReadLine().
Returns true if you can read at least one line from the device
Reimplemented from QIODevice::close().
Disconnects the socket's connection with the device.
Attempts to connect to the service described by service.
The socket is opened in the given openMode.
The socket first enters ConnectingState and attempts to connect to the device providing service. If a connection is established, QBluetoothSocket enters ConnectedState and emits connected().
At any point, the socket can emit error() to siganl that an error occurred.
See also state() and disconnectFromService().
Attempts to make a connection to the service identified by uuid on the device with address address.
The socket is opened in the given openMode.
The socket first enters the ServiceLookupState and queries the connection parameters for uuid. If the service parameters are successfully retrieved the socket enters ConnectingState, and attempts to connect to address. If a connection is established, QBluetoothSocket enters Connected State and emits connected().
At any point, the socket can emit error() to signal that an error occurred.
See also state() and disconnectFromService().
Attempts to make a connection with address on the given port.
The socket is opened in the given openMode.
The socket first enters ConnectingState, and attempts to connect to address. If a connection is established, QBluetoothSocket enters ConnectedState and emits connected().
At any point, the socket can emit error() to signal that an error occurred.
See also state() and disconnectFromService().
This signal is emitted when a connection is established.
See also QBluetoothSocket::ConnectedState and stateChanged().
Attempts to close the socket. If there is pending data waiting to be written QBluetoothSocket will enter ClosingState and wait until all data has been written. Eventually, it will enter UnconnectedState and emit the disconnected() signal.
See also connectToService().
This signal is emitted when the socket is disconnected.
See also QBluetoothSocket::UnconnectedState and stateChanged().
Start device discovery for service and open the socket with openMode. If the socket is created with a service uuid device address we must use service discovery to find the port number to connect to.
Returns the last error.
This signal is emitted when an error occurs.
See also error().
Returns a user displayable text string for the error.
Reimplemented from QIODevice::isSequential().
Returns the address of the local device.
Returns the name of the local device.
Returns the port number of the local socket if available; otherwise returns 0.
Returns the address of the peer device.
Returns the name of the peer device.
Return the port number of the peer socket if available; otherwise returns 0.
Reimplemented from QIODevice::readData().
Set the socket to use socketDescriptor with a type of socketType which is in state socketState and mode openMode.
Returns true on success
See also socketDescriptor().
Sets the type of error that last occurred to error_.
Sets the socket state to state.
Returns the platform specific socket descriptor, if available
See also setSocketDescriptor().
Returns the socket type.
Returns the current state of the socket.
This signal is emitted when the socket state changes to state.
See also connected(), disconnected(), state(), and QBluetoothSocket::SocketState.
Reimplemented from QIODevice::writeData().
© 2008-2011 Nokia Corporation and/or its subsidiaries. Nokia, Qt and their respective logos are trademarks of Nokia Corporation in Finland and/or other countries worldwide.
All other trademarks are property of their respective owners. Privacy Policy
Licensees holding valid Qt Commercial licenses may use this document in accordance with the Qt Commercial License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Nokia.
Alternatively, this document may be used under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation.