Diffstat (limited to 'libopie2/opiebluez/obluetooth.h') (more/less context) (ignore whitespace changes)
| -rw-r--r-- | libopie2/opiebluez/obluetooth.h | 40 |
1 files changed, 39 insertions, 1 deletions
diff --git a/libopie2/opiebluez/obluetooth.h b/libopie2/opiebluez/obluetooth.h index 4423a55..ee4a90d 100644 --- a/libopie2/opiebluez/obluetooth.h +++ b/libopie2/opiebluez/obluetooth.h @@ -1,149 +1,187 @@ /* This file is part of the Opie Project Copyright (C) 2005 Michael 'Mickey' Lauer <mickey@Vanille.de> =. Copyright (C) The Opie Team <opie-devel@handhelds.org> .=l. .>+-= _;:, .> :=|. This program is free software; you can .> <`_, > . <= redistribute it and/or modify it under :`=1 )Y*s>-.-- : the terms of the GNU Library General Public .="- .-=="i, .._ License as published by the Free Software - . .-<_> .<> Foundation; version 2 of the License. ._= =} : .%`+i> _;_. .i_,=:_. -<s. This program is distributed in the hope that + . -:. = it will be useful, but WITHOUT ANY WARRANTY; : .. .:, . . . without even the implied warranty of =_ + =;=|` MERCHANTABILITY or FITNESS FOR A _.=:. : :=>`: PARTICULAR PURPOSE. See the GNU ..}^=.= = ; Library General Public License for more ++= -. .` .: details. : = ...= . :.=- -. .:....=;==+<; You should have received a copy of the GNU -_. . . )=. = Library General Public License along with -- :-=` this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ #ifndef OBLUETOOTH_H #define OBLUETOOTH_H #include <qobject.h> #include <qdict.h> namespace Opie { namespace Bluez { class OBluetoothInterface; +class OBluetoothDevice; /** * @brief A container class for all bluetooth interfaces * * This class provides access to all available bluetooth interfaces of your computer. * * @author Michael 'Mickey' Lauer <mickey@vanille.de> */ class OBluetooth : public QObject { Q_OBJECT public: typedef QDict<OBluetoothInterface> InterfaceMap; typedef QDictIterator<OBluetoothInterface> InterfaceIterator; public: /** * @returns the number of available interfaces */ int count() const; /** * @returns a pointer to the (one and only) @ref OBluetooth instance. */ static OBluetooth* instance(); /** * @returns an iterator usable for iterating through all network interfaces. */ InterfaceIterator iterator() const; /** * @returns true, if the @a interface is present. */ bool isPresent( const char* interface ) const; /** * @returns true, if the @a interface supports the wireless extension protocol. */ bool isWirelessInterface( const char* interface ) const; /** * @returns a pointer to the @ref OBluetoothInterface object for the specified @a interface or 0, if not found. * @see OBluetoothInterface */ OBluetoothInterface* interface( const QString& interface ) const; /** * @internal Rebuild the internal interface database * @note Sometimes it might be useful to call this from client code, * e.g. after issuing a cardctl insert */ void synchronize(); protected: OBluetooth(); private: static OBluetooth* _instance; InterfaceMap _interfaces; class OBluetoothPrivate; OBluetoothPrivate *d; int _fd; }; /*====================================================================================== * OBluetoothInterface *======================================================================================*/ /** * @brief An bluetooth interface wrapper. * - * This class provides a wrapper for an infrared interface. All the cumbersome details of + * This class provides a wrapper for a bluetooth HCI device. All the cumbersome details of * Linux ioctls are hidden under a convenient high-level interface. * @warning Most of the setting methods contained in this class require the appropriate * process permissions to work. * * @author Michael 'Mickey' Lauer <mickey@vanille.de> */ class OBluetoothInterface : public QObject { + Q_OBJECT + public: + typedef QDict<OBluetoothDevice> DeviceMap; + typedef QDictIterator<OBluetoothDevice> DeviceIterator; + public: /** * Constructor. Normally you don't create @ref OBluetoothInterface objects yourself, * but access them via @ref OBluetooth::interface(). */ OBluetoothInterface( QObject* parent, const char* name, void* devinfo, int ctlfd ); /** * Destructor. */ virtual ~OBluetoothInterface(); /** * @return the MAC address of the interfaces */ QString macAddress() const; /** * Setting an interface to up enables it to receive packets. */ bool setUp( bool ); /** * @returns true if the interface is up. */ bool isUp() const; + /** + * @returns an iterator usable for iterating through the devices in range + */ + DeviceIterator neighbourhood(); private: + DeviceMap _devices; class Private; Private *d; }; +/*====================================================================================== + * OBluetoothDevice + *======================================================================================*/ + +/** + * @brief An bluetooth (remote) device abstraction. + * + * This class resembles a (remote) bluetooth device. + * @author Michael 'Mickey' Lauer <mickey@vanille.de> + */ +class OBluetoothDevice : public QObject +{ + Q_OBJECT + public: + /** + * Constructor. + */ + OBluetoothDevice( QObject* parent, const char* name ); + /** + * Destructor. + */ + virtual ~OBluetoothDevice(); + /** + * @returns the MAC address of the device's interface + */ + QString macAddress() const; +}; } } #endif |