/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Copyright 2013 - 2020, nymea GmbH * Contact: contact@nymea.io * * This file is part of nymea. * This project including source code and documentation is protected by * copyright law, and remains the property of nymea GmbH. All rights, including * reproduction, publication, editing and translation, are reserved. The use of * this project is subject to the terms of a license agreement to be concluded * with nymea GmbH in accordance with the terms of use of nymea GmbH, available * under https://nymea.io/license * * GNU General Public License Usage * Alternatively, this project may be redistributed and/or modified under the * terms of the GNU General Public License as published by the Free Software * Foundation, GNU version 3. This project 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 * this project. If not, see . * * For any further details and any questions please contact us under * contact@nymea.io or see our FAQ/Licensing Information on * https://nymea.io/license/faq * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ #ifndef THING_H #define THING_H #include #include #include "params.h" #include "states.h" #include "statesproxy.h" class ThingClass; class ThingManager; class Thing : public QObject { Q_OBJECT Q_PROPERTY(QUuid id READ id CONSTANT) Q_PROPERTY(QUuid thingClassId READ thingClassId CONSTANT) Q_PROPERTY(QUuid parentId READ parentId CONSTANT) Q_PROPERTY(bool isChild READ isChild CONSTANT) Q_PROPERTY(QString name READ name NOTIFY nameChanged) Q_PROPERTY(ThingSetupStatus setupStatus READ setupStatus NOTIFY setupStatusChanged) Q_PROPERTY(QString setupDisplayMessage READ setupDisplayMessage NOTIFY setupStatusChanged) Q_PROPERTY(Params *params READ params NOTIFY paramsChanged) Q_PROPERTY(Params *settings READ settings NOTIFY settingsChanged) Q_PROPERTY(States *states READ states NOTIFY statesChanged) Q_PROPERTY(ThingClass *thingClass READ thingClass CONSTANT) public: enum ThingSetupStatus { ThingSetupStatusNone, ThingSetupStatusInProgress, ThingSetupStatusComplete, ThingSetupStatusFailed }; Q_ENUM(ThingSetupStatus) enum ThingError { ThingErrorNoError, ThingErrorPluginNotFound, ThingErrorVendorNotFound, ThingErrorThingNotFound, ThingErrorThingClassNotFound, ThingErrorActionTypeNotFound, ThingErrorStateTypeNotFound, ThingErrorEventTypeNotFound, ThingErrorThingDescriptorNotFound, ThingErrorMissingParameter, ThingErrorInvalidParameter, ThingErrorSetupFailed, ThingErrorDuplicateUuid, ThingErrorCreationMethodNotSupported, ThingErrorSetupMethodNotSupported, ThingErrorHardwareNotAvailable, ThingErrorHardwareFailure, ThingErrorAuthenticationFailure, ThingErrorThingInUse, ThingErrorThingInRule, ThingErrorThingIsChild, ThingErrorPairingTransactionIdNotFound, ThingErrorParameterNotWritable, ThingErrorItemNotFound, ThingErrorItemNotExecutable, ThingErrorUnsupportedFeature, ThingErrorTimeout, }; Q_ENUM(ThingError) explicit Thing(ThingManager *thingManager, ThingClass *thingClass, const QUuid &parentId = QUuid(), QObject *parent = nullptr); QUuid id() const; void setId(const QUuid &id); QString name() const; void setName(const QString &name); QUuid thingClassId() const; QUuid parentId() const; bool isChild() const; Thing::ThingSetupStatus setupStatus() const; QString setupDisplayMessage() const; void setSetupStatus(Thing::ThingSetupStatus setupStatus, const QString &displayMessage); Params *params() const; void setParams(Params *params); Params *settings() const; void setSettings(Params *settings); States *states() const; void setStates(States *states); void setStateValue(const QUuid &stateTypeId, const QVariant &value); ThingClass *thingClass() const; Q_INVOKABLE bool hasState(const QUuid &stateTypeId) const; Q_INVOKABLE State *state(const QUuid &stateTypeId) const; Q_INVOKABLE State *stateByName(const QString &stateName) const; Q_INVOKABLE QVariant stateValue(const QUuid &stateTypeId) const; Q_INVOKABLE Param *param(const QUuid ¶mTypeId) const; Q_INVOKABLE Param *paramByName(const QString ¶mName) const; Q_INVOKABLE virtual int executeAction(const QString &actionName, const QVariantList ¶ms); signals: void nameChanged(); void setupStatusChanged(); void paramsChanged(); void settingsChanged(); void statesChanged(); void eventTriggered(const QUuid &eventTypeId, const QVariantList ¶ms); signals: void executeActionReply(int commandId, Thing::ThingError thingError, const QString &displayMessage); protected: ThingManager *m_thingManager = nullptr; QString m_name; QUuid m_id; QUuid m_parentId; ThingSetupStatus m_setupStatus = ThingSetupStatusNone; QString m_setupDisplayMessage; Params *m_params = nullptr; Params *m_settings = nullptr; States *m_states = nullptr; ThingClass *m_thingClass = nullptr; QList m_pendingActions; }; Q_DECLARE_METATYPE(Thing::ThingError) QDebug operator<<(QDebug &dbg, Thing* thing); #endif // THING_H