s/opieshower/opiebluez/, infrared better goes through opienet

there's the need of a connection abstraction library which bases on opienet
and opiebluez in the future. It's for discussion if it makes sense in Opie 1.x

1 files changed, 141 insertions, 0 deletions

diff --git a/libopie2/opiebluez/obluetooth.h b/libopie2/opiebluez/obluetooth.h
new file mode 100644
index 0000000..30fdd18
--- a/dev/null
+++ b/libopie2/opiebluez/obluetooth.h
@@ -0,0 +1,141 @@
+/*
+                             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 Shower {
+
+class OBluetoothInterface;
+
+/**
+ * @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
+ * 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
+{
+  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 );
+    /**
+     * Destructor.
+     */
+    virtual ~OBluetoothInterface();
+    /**
+     * @return the MAC address of the interfaces
+     */
+    QString macAddress() const;
+
+  private:
+    class Private;
+    Private *d;
+};
+
+
+
+}
+}
+#endif
+