--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/wlanutilities/wlanqtutilities/base/inc/wlanqtutilsap.h Tue Aug 31 16:18:40 2010 +0300
@@ -0,0 +1,178 @@
+/*
+* Copyright (c) 2009-2010 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:
+* WLAN AP (Access Point, unknown network) class.
+*/
+
+#ifndef WLANQTUTILSAP_H
+#define WLANQTUTILSAP_H
+
+// System includes
+
+#include <QObject>
+#include <QMetaType>
+#include <QVariant>
+#include <QScopedPointer>
+
+// User includes
+
+// Forward declarations
+
+class WlanQtUtilsApPrivate;
+
+// External data types
+
+// Constants
+
+//! Library interface export macro
+#ifdef BUILD_WLANQTUTILITIES_DLL
+#define WLANQTUTILSAP_EXPORT Q_DECL_EXPORT
+#else
+#define WLANQTUTILSAP_EXPORT Q_DECL_IMPORT
+#endif
+
+// Class declaration
+
+class WLANQTUTILSAP_EXPORT WlanQtUtilsAp
+{
+
+public:
+
+ // Data types
+
+ /*!
+ Configuration IDs that can be read and set in this class.
+
+ ConfID's available for scan results:
+ - ConfIdSsid
+ - ConfIdBssid
+ - ConfIdSignalStrength
+ - ConfIdConnectionMode
+ - ConfIdSecurityMode
+ - ConfIdWpaPskUse
+ - ConfIdWpsSupported
+
+ ConfID's for IAP creation and updates, these are
+ mandatory for all security modes:
+ - ConfIdSsid
+ - ConfIdConnectionMode
+ - ConfIdSecurityMode
+ - ConfIdWepKey1 (Empty if not used)
+ - ConfIdWepKey2 (Empty if not used)
+ - ConfIdWepKey3 (Empty if not used)
+ - ConfIdWepKey4 (Empty if not used)
+ - ConfIdWepDefaultIndex
+ - ConfIdWpaPskUse
+ - ConfIdWpaPsk (Empty if not used)
+ - ConfIdHidden
+ - ConfIdWlanScanSSID
+ */
+ enum ConfId {
+ //! QString: WLAN Network Name (SSID)
+ ConfIdSsid = 0,
+ //! QByteArray: Basic Service Set Identifier
+ ConfIdBssid = 1,
+ //! int: signal strength in RSSI (dBm)
+ ConfIdSignalStrength = 2,
+ //! int: (CMManagerShim::WlanNetMode)
+ ConfIdConnectionMode = 3,
+ //! int: (CMManagerShim::WlanSecMode)
+ ConfIdSecurityMode = 4,
+ //! bool: true - WPA PSK, false - WPA EAP
+ ConfIdWpaPskUse = 5,
+ //! QString: Pre-Shared Key for WPA
+ //! Length: 8-63 - Ascii key
+ //! Length: 64 - Hex key
+ ConfIdWpaPsk = 6,
+ //! QString: WEP Key for index 1:
+ //! HEX:
+ //! - 64 bit: allowed key length = 10
+ //! - 128 bit: allowed key length = 26
+ //!
+ //! ASCII:
+ //! - 64 bit: allowed key length = 5
+ //! - 128 bit: allowed key length = 13
+ ConfIdWepKey1 = 7,
+ //! QString: WEP Key for index 2
+ ConfIdWepKey2 = 8,
+ //! QString: WEP Key for index 3
+ ConfIdWepKey3 = 9,
+ //! QString: WEP Key for index 4
+ ConfIdWepKey4 = 10,
+ //! int: (CMManagerShim::WlanWepKeyIndex): Default WEP Key index
+ ConfIdWepDefaultIndex = 11,
+ //! bool: Is WLAN hidden (CMManagerShim::CmHidden).
+ ConfIdHidden = 12,
+ //! bool: Does WLAN AP need explicit scanning (CMManagerShim::WlanScanSSID)
+ ConfIdWlanScanSSID = 13,
+ //! bool: true - Wifi Protected setup is supported, false - not
+ ConfIdWpsSupported = 14
+ };
+
+ /*!
+ Function pointer type for string comparison operation customization.
+ Used for AP comparison in \a compare.
+
+ @param [in] string1 String #1 to compare.
+ @param [in] string2 String #2 to compare.
+
+ @return Zero (0), if strings are considered to be same,
+ Positive (>0) if string1 is considered to be "greater than" string2.
+ Negative (<0) if string1 is considered to be "less than" string2.
+ */
+ typedef int (*StringComparator)(
+ const QString &string1,
+ const QString &string2);
+
+ WlanQtUtilsAp();
+
+ WlanQtUtilsAp(const WlanQtUtilsAp &ref);
+
+ virtual ~WlanQtUtilsAp();
+
+ QVariant value(int identifier) const;
+
+ void setValue(int identifier, QVariant value);
+
+ static int compare(
+ const WlanQtUtilsAp *ap1,
+ const WlanQtUtilsAp *ap2,
+ StringComparator comparator = 0);
+
+signals:
+
+public slots:
+
+protected:
+
+protected slots:
+
+private:
+
+ // Disabling implicit assignment operator
+ WlanQtUtilsAp &operator=(const WlanQtUtilsAp &);
+
+private slots:
+
+private: // data
+
+ QScopedPointer<WlanQtUtilsApPrivate> d_ptr; //!< Private implementation
+
+ // Friend classes
+};
+
+// Metatype support is needed since we use this class with QVariant
+Q_DECLARE_METATYPE(WlanQtUtilsAp)
+
+#endif // WLANQTUTILSAP_H