diff options
author | Gatis Paeglis <gatis.paeglis@theqtcompany.com> | 2014-11-06 18:06:49 +0100 |
---|---|---|
committer | Gatis Paeglis <gatis.paeglis@theqtcompany.com> | 2014-12-02 12:39:18 +0200 |
commit | fc2f6ac9d7e7ac8ab343c11786f7437610fa0a19 (patch) | |
tree | 1f11946d6641ccffd42e8b078ede641775debc53 /src/wifi/qwificonfiguration.h | |
parent | 5e83898cff3991d1c08f628d2687f7e2038f182b (diff) |
[Wifi] graduate from Qt.labs.wifi 0.1 to B2Qt.Wifi 1.0
- Make wifi library available from c++
1) included with "#include <B2QtWifi>", available classes are:
QWifiDevice, QWifiManager, QWifiConfiguration
- Re-design of API:
1) connectedSSID -> currentSSID
get current network from this property instead of networks state change events
2) networkStateChanaged(QWifiNetwork *) -> networkStateChanged(NetworkState)
Don't expose QWifiNetwork objects to library users, use data model roles
instead, no need to pollute API with "read-only" class. The flaws of exposing
QWifiNetwork become apparent when looking at C++ API.
3) New BackendState enum for backend state changes events, backendStateChanged(BackendState)
Initializing backend can be lengthy operation and can block GUI thread,
same is true for DHCP requests, now these operations are moved into a separate thread
and backend state change events are delivered asynchronously.
4) Make WifiManager a Singleton, we don't want several instances starting
and stopping system processes and it makes global state handling simpler.
5) Rename Interface -> WifiDevice
6!) Introducing QWifiConfiguration. This abstraction allows for easy
way to add new features, whatever we choose to support from:
http://w1.fi/cgit/hostap/plain/wpa_supplicant/wpa_supplicant.conf
The idea for it is to be a Qt-style wrapper for "network {}" configurations
from wpa_supplicant.conf.
Also this makes life simpler for developers if they know what network they
will be using, they can omit scanning, listing, selecting parts and do something
like this instead:
WifiConfiguration {
id: config
ssid: "network name"
passphrase: "12345678"
}
if (!WifiManager.connect(config))
print("failed to connect: " + WifiManager.lastError)
- Optimizations:
1) Async. event delivery.
2) eLinux: Don't use "ifup", it is slow because it starts dhcp
request even before any network has been configured. Use
start-stop-daemon and ifconfig directly.
- Bug fixes (many), but most importantly:
1) Get backend state properly when WifiManager is created.
- Public header cleanup
- Other:
1) Added categorized logging.
2) Methods to get/set wifi interface name. Not exposed to qml.
- Missing parts that will be added as a separate patch:
* [doc] Getting started guide for c++ and qml
* [doc] Update for qml docs and new docs for c++. The current docs
are out-of-date.
Task-number: QTEE-649
Task-number: QTEE-810
Change-Id: I7dc8709aed2de622828a119749aef31534a4296d
Reviewed-by: Laszlo Agocs <laszlo.agocs@theqtcompany.com>
Diffstat (limited to 'src/wifi/qwificonfiguration.h')
-rw-r--r-- | src/wifi/qwificonfiguration.h | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/src/wifi/qwificonfiguration.h b/src/wifi/qwificonfiguration.h new file mode 100644 index 0000000..2253fbb --- /dev/null +++ b/src/wifi/qwificonfiguration.h @@ -0,0 +1,54 @@ +/**************************************************************************** +** +** Copyright (C) 2014 Digia Plc +** All rights reserved. +** For any questions to Digia, please use the contact form at +** http://www.qt.io +** +** This file is part of Qt Enterprise Embedded. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** the contact form at http://www.qt.io +** +****************************************************************************/ +#ifndef QWIFICONFIGURATION_H +#define QWIFICONFIGURATION_H + +#include <QtCore/QObject> +#include <QtCore/QString> + +class QWifiConfigurationPrivate; + +QT_BEGIN_NAMESPACE + +class Q_DECL_EXPORT QWifiConfiguration : public QObject +{ + Q_OBJECT + Q_PROPERTY(QString ssid READ ssid WRITE setSsid) + Q_PROPERTY(QString passphrase READ passphrase WRITE setPassphrase) + Q_PROPERTY(QString protocol READ protocol WRITE setProtocol) +public: + explicit QWifiConfiguration(QObject *parent = 0); + virtual ~QWifiConfiguration(); + + void setSsid(const QString &ssid); + QString ssid() const; + void setPassphrase(const QString &psk); + QString passphrase() const; + void setProtocol(const QString &protocol); + QString protocol() const; + +private: + Q_DISABLE_COPY(QWifiConfiguration) + Q_DECLARE_PRIVATE(QWifiConfiguration) + QWifiConfigurationPrivate *const d_ptr; +}; + +QT_END_NAMESPACE + +#endif // QWIFICONFIGURATION_H |