nymea/libguh/plugin/deviceplugin.h

/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
 *                                                                         *
 *  Copyright (C) 2015 Simon Stuerz <simon.stuerz@guh.guru>                *
 *  Copyright (C) 2014 Michael Zanetti <michael_zanetti@gmx.net>           *
 *                                                                         *
 *  This file is part of guh.                                              *
 *                                                                         *
 *  Guh is free software: you can redistribute it and/or modify            *
 *  it under the terms of the GNU General Public License as published by   *
 *  the Free Software Foundation, version 2 of the License.                *
 *                                                                         *
 *  Guh 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 General Public License for more details.                           *
 *                                                                         *
 *  You should have received a copy of the GNU General Public License      *
 *  along with guh. If not, see <http://www.gnu.org/licenses/>.            *
 *                                                                         *
 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */

#ifndef DEVICEPLUGIN_H
#define DEVICEPLUGIN_H

#include "devicemanager.h"
#include "deviceclass.h"

#include "libguh.h"
#include "typeutils.h"

#include "types/event.h"
#include "types/action.h"
#include "types/vendor.h"
#include "types/param.h"

#ifdef BLUETOOTH_LE
#include <QBluetoothDeviceInfo>
#endif

#include <QObject>
#include <QJsonObject>

class DeviceManager;
class Device;

class LIBGUH_EXPORT DevicePlugin: public QObject
{
    Q_OBJECT
public:
    DevicePlugin(QObject *parent = 0);
    virtual ~DevicePlugin();

    virtual void init() {}

    QString pluginName() const;
    PluginId pluginId() const;
    QList<Vendor> supportedVendors() const;
    QList<DeviceClass> supportedDevices() const;

    virtual DeviceManager::HardwareResources requiredHardware() const = 0;

    virtual void startMonitoringAutoDevices();
    virtual DeviceManager::DeviceError discoverDevices(const DeviceClassId &deviceClassId, const ParamList &params);

    virtual DeviceManager::DeviceSetupStatus setupDevice(Device *device);
    virtual void postSetupDevice(Device *device);
    virtual void deviceRemoved(Device *device);

    virtual DeviceManager::DeviceError displayPin(const PairingTransactionId &pairingTransactionId, const DeviceDescriptor &deviceDescriptor);
    virtual DeviceManager::DeviceSetupStatus confirmPairing(const PairingTransactionId &pairingTransactionId, const DeviceClassId &deviceClassId, const ParamList &params, const QString &secret);

    virtual DeviceManager::DeviceError executeAction(Device *device, const Action &action);

    // Hardware input
    virtual void radioData(const QList<int> &rawData) {Q_UNUSED(rawData)}
    virtual void guhTimer() {}
    virtual void upnpDiscoveryFinished(const QList<UpnpDeviceDescriptor> &upnpDeviceDescriptorList) {Q_UNUSED(upnpDeviceDescriptorList)}
    virtual void upnpNotifyReceived(const QByteArray &notifyData) {Q_UNUSED(notifyData)}

    virtual void networkManagerReplyReady(QNetworkReply *reply) {Q_UNUSED(reply)}

    #ifdef BLUETOOTH_LE
    virtual void bluetoothDiscoveryFinished(const QList<QBluetoothDeviceInfo> &deviceInfos) {Q_UNUSED(deviceInfos)}
    #endif

    // Configuration
    virtual QList<ParamType> configurationDescription() const;
    DeviceManager::DeviceError setConfiguration(const ParamList &configuration);
    ParamList configuration() const;
    QVariant configValue(const QString &paramName) const;
    DeviceManager::DeviceError setConfigValue(const QString &paramName, const QVariant &value);


signals:
    void emitEvent(const Event &event);
    void devicesDiscovered(const DeviceClassId &deviceClassId, const QList<DeviceDescriptor> &deviceDescriptors);
    void deviceSetupFinished(Device *device, DeviceManager::DeviceSetupStatus status);
    void pairingFinished(const PairingTransactionId &pairingTransactionId, DeviceManager::DeviceSetupStatus status);
    void actionExecutionFinished(const ActionId &id, DeviceManager::DeviceError status);
    void configValueChanged(const QString &paramName, const QVariant &value);
    void autoDevicesAppeared(const DeviceClassId &deviceClassId, const QList<DeviceDescriptor> &deviceDescriptors);

protected:
    DeviceManager *deviceManager() const;
    QList<Device*> myDevices() const;
    Device* findDeviceByParams(const ParamList &params) const;

    // Radio 433
    bool transmitData(int delay, QList<int> rawData);

    // Bluetooth LE discovery
    #ifdef BLUETOOTH_LE
    bool discoverBluetooth();
    #endif

    // Network manager
    QNetworkReply *networkManagerGet(const QNetworkRequest &request);
    QNetworkReply *networkManagerPost(const QNetworkRequest &request, const QByteArray &data);
    QNetworkReply *networkManagerPut(const QNetworkRequest &request, const QByteArray &data);

private:
    void initPlugin(const QJsonObject &metaData, DeviceManager *deviceManager);

    QList<ParamType> parseParamTypes(const QJsonArray &array) const;

    QStringList verifyFields(const QStringList &fields, const QJsonObject &value) const;

    Types::Unit unitStringToUnit(const QString &unitString) const;
    Types::InputType inputTypeStringToInputType(const QString &inputType) const;
    DeviceClass::BasicTag basicTagStringToBasicTag(const QString &basicTag) const;

    DeviceManager *m_deviceManager;

    ParamList m_config;

    QJsonObject m_metaData;

    friend class DeviceManager;
};

Q_DECLARE_INTERFACE(DevicePlugin, "guru.guh.DevicePlugin")

#endif // DEVICEPLUGIN_H