Port QBluetoothLocalDevice and QBluetoothDeviceDiscoveryAgent to OS X.

QBluetoothLocalDevice and QBluetoothDeviceDiscoveryAgent for OS X -
Bluetooth Classic (the implementation based on IOBluetooth).
+ a very simple non-gui test (requires QApplication to work though).

Update 0: style issues reported by Qt-Bot + fix a test.
Update 1: QBluetoothLocalDevice - display confirmation
Update 2: Device discovery agent - follow the expected logic
          and apply suggested fixes.
Update 3: started/finished delegate methods seems to be synchronous and immediately follow
          start/stop calls on an inquiry.
Update 4: remove unused function and redundant error message.
Update 5: the first attempt to fix pairingStatus/requestPairing on a local device.
Update 6: on OS X it's impossible (with a given public API) to request 'Unpaired'.
          I was only able to find some quite terrible hacks with private APIs or
          even worse - playing with SystemConfiguration frameworks and changing
          System Preferencies programmatically (requires authorization and looks like a
          total hack, since it has nothing to do with Bluetooth framework).
Update 7: A very limited support for deviceConnected and connectedDevices.
Update 8: Fix an invalid invokeMethod's argument.
Update 9: Subject changed.
Update 10: fixes in a documentation.
Update 11: asserts in a coding convetion/style.
Update 12: "fix" asserts + emit errors if a start/stop failed.
Update 13: deviceDisconnected implemented.
Update 14: use not only paired && connected devices (QBluetoothLocalDevice::connectedDevices),
           but also devices discovered by the connection monitor.
Update 15: remove a test, not required (there are 'auto' tests).
Update 16: fix private headers - they MUST have _p suffix :(
Update 17: tests are known to fail (at the moment) - IOBluetooth
           requires adjustment (QApplication instead of QCoreApplication,
           lack of ability to power on/off a device (not possible on Mac) +
           other things).

Change-Id: Iea1c8a98f1fd719f4560ec8920d00cc07eaa8146
Reviewed-by: Alex Blasche <alexander.blasche@digia.com>
Reviewed-by: Timur Pocheptsov <Timur.Pocheptsov@digia.com>

1 files changed, 148 insertions, 0 deletions

diff --git a/src/bluetooth/osx/osxbtutility_p.h b/src/bluetooth/osx/osxbtutility_p.h
new file mode 100644
index 00000000..cf267fc9
--- /dev/null
+++ b/src/bluetooth/osx/osxbtutility_p.h
@@ -0,0 +1,148 @@
+/****************************************************************************
+**
+** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the QtBluetooth module of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Digia.  For licensing terms and
+** conditions see http://qt.digia.com/licensing.  For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Digia gives you certain additional
+** rights.  These rights are described in the Digia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** GNU General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU
+** General Public License version 3.0 as published by the Free Software
+** Foundation and appearing in the file LICENSE.GPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU General Public License version 3.0 requirements will be
+** met: http://www.gnu.org/copyleft/gpl.html.
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+#ifndef OSXBTUTILITY_P_H
+#define OSXBTUTILITY_P_H
+
+#include <QtCore/qloggingcategory.h>
+#include <QtCore/qscopedpointer.h>
+#include <QtCore/qglobal.h>
+
+#include <Foundation/Foundation.h>
+#include <IOBluetooth/Bluetooth.h>
+
+QT_BEGIN_NAMESPACE
+
+namespace OSXBluetooth {
+
+struct NSObjectDeleter {
+    static void cleanup(NSObject *obj)
+    {
+        [obj release];
+    }
+};
+
+template<class T>
+class ObjCScopedPointer : public QScopedPointer<NSObject, NSObjectDeleter>
+{
+public:
+    explicit ObjCScopedPointer(T *ptr = Q_NULLPTR) : QScopedPointer(ptr){}
+    operator T*() const
+    {
+        return static_cast<T *>(this->data());
+    }
+};
+
+typedef ObjCScopedPointer<NSAutoreleasePool> AutoreleasePool;
+#define QT_BT_MAC_AUTORELEASEPOOL const OSXBluetooth::AutoreleasePool pool([[NSAutoreleasePool alloc] init])
+
+template<class T>
+class ObjCStrongReference {
+public:
+    explicit ObjCStrongReference(T *obj, bool retain)
+    {
+        if (retain)
+            m_ptr = [obj retain];
+        else
+            m_ptr = obj; // For example, created with initWithXXXX.
+    }
+    ObjCStrongReference(const ObjCStrongReference &rhs)
+    {
+        m_ptr = [rhs.m_ptr retain];
+    }
+    ObjCStrongReference &operator = (const ObjCStrongReference &rhs)
+    {
+        // "Old-style" implementation:
+        if (this != &rhs && m_ptr != rhs.m_ptr) {
+            [m_ptr release];
+            m_ptr = [rhs.m_ptr retain];
+        }
+
+        return *this;
+    }
+
+#ifdef Q_COMPILER_RVALUE_REFS
+    ObjCStrongReference(ObjCStrongReference &&xval)
+    {
+        m_ptr = xval.m_ptr;
+        xval.m_ptr = nil;
+    }
+
+    ObjCStrongReference &operator = (ObjCStrongReference &&xval)
+    {
+        m_ptr = xval.m_ptr;
+        xval.m_ptr = nil;
+        return *this;
+    }
+#endif
+
+    ~ObjCStrongReference()
+    {
+        [m_ptr release];
+    }
+
+    void reset(T *newVal)
+    {
+        if (m_ptr != newVal) {
+            [m_ptr release];
+            m_ptr = [newVal retain];
+        }
+    }
+
+    operator T *() const
+    {
+        return m_ptr;
+    }
+private:
+    T *m_ptr;
+};
+
+QString qt_bt_address(NSString *address);
+class QBluetoothAddress qt_bt_address(const BluetoothDeviceAddress *address);
+BluetoothDeviceAddress iobluetooth_address(const QBluetoothAddress &address);
+
+} // namespace OSXBluetooth
+
+Q_DECLARE_LOGGING_CATEGORY(QT_BT_OSX)
+
+QT_END_NAMESPACE
+
+#endif