iio-widgets: Add optional runtime reconfiguration

gui/include/gui/widgets/menucombo.h

@@ -19,6 +19,7 @@ class SCOPY_GUI_EXPORT MenuCombo : public QWidget
 	MenuCombo(QString title, QWidget *parent = nullptr);
 	virtual ~MenuCombo();
 
+	QLabel *label();
 	QComboBox *combo();
 	void applyStylesheet();
 

gui/src/widgets/menucombo.cpp

@@ -46,6 +46,8 @@ MenuCombo::MenuCombo(QString title, QWidget *parent)
 }
 
 MenuCombo::~MenuCombo() {}
+
+QLabel *MenuCombo::label() { return m_label; }
 QComboBox *MenuCombo::combo() { return m_combo; }
 
 void MenuCombo::applyStylesheet()

iio-widgets/include/iio-widgets/datastrategy/emptydatastrategy.h

@@ -0,0 +1,36 @@
+#ifndef EMPTYDATASTRATEGY_H
+#define EMPTYDATASTRATEGY_H
+
+#include <QObject>
+#include "datastrategy/datastrategyinterface.h"
+#include "scopy-iio-widgets_export.h"
+
+namespace scopy {
+class SCOPY_IIO_WIDGETS_EXPORT EmptyDataStrategy : public QObject, public DataStrategyInterface
+{
+	Q_OBJECT
+	Q_INTERFACES(scopy::DataStrategyInterface)
+public:
+	explicit EmptyDataStrategy(QObject *parent = nullptr);
+
+	QString data() override;
+	QString optionalData() override;
+
+public Q_SLOTS:
+	int write(QString data) override;
+	QPair<QString, QString> read() override;
+	void writeAsync(QString data) override;
+	void readAsync() override;
+
+Q_SIGNALS:
+	void sendData(QString data, QString dataOptions) override;
+	void aboutToWrite(QString oldData, QString newData) override;
+	void emitStatus(QDateTime timestamp, QString oldData, QString newData, int returnCode, bool isReadOp) override;
+
+private:
+	QString m_data;
+	QString m_previousData;
+};
+} // namespace scopy
+
+#endif // EMPTYDATASTRATEGY_H

iio-widgets/include/iio-widgets/guistrategy/comboguistrategy.h

@@ -49,6 +49,7 @@ class SCOPY_IIO_WIDGETS_EXPORT ComboAttrUi : public QObject, public GuiStrategyI
 
 public Q_SLOTS:
 	void receiveData(QString currentData, QString optionalData) override;
+	void changeName(QString name) override;
 
 Q_SIGNALS:
 	void displayedNewData(QString data, QString optionalData) override;
@@ -58,6 +59,8 @@ public Q_SLOTS:
 private:
 	QWidget *m_ui;
 	QComboBox *m_comboWidget;
+	MenuCombo *m_menuCombo;
+	QLabel *m_compactLabel;
 	bool m_isCompact;
 };
 } // namespace scopy

iio-widgets/include/iio-widgets/guistrategy/editableguistrategy.h

@@ -49,6 +49,7 @@ class SCOPY_IIO_WIDGETS_EXPORT EditableGuiStrategy : public QObject, public GuiS
 
 public Q_SLOTS:
 	void receiveData(QString currentData, QString optionalData) override;
+	void changeName(QString name) override;
 
 Q_SIGNALS:
 	void displayedNewData(QString data, QString optionalData) override;
@@ -57,6 +58,7 @@ public Q_SLOTS:
 
 private:
 	QWidget *m_ui;
+	QLabel *m_titleLabel;
 	MenuLineEdit *m_lineEdit;
 	QString m_lastEmittedText;
 };

iio-widgets/include/iio-widgets/guistrategy/guistrategyinterface.h

@@ -56,6 +56,12 @@ public Q_SLOTS:
 	 * */
 	virtual void receiveData(QString currentData, QString optionalData) = 0;
 
+	/**
+	 * @brief changeName Changes the title of the UI strategy
+	 * @param name The new name/title of the UI strategy
+	 */
+	virtual void changeName(QString name) = 0;
+
 Q_SIGNALS:
 	/**
 	 * @brief This signal is emitted when the ui strategy receives new data from external sources,

iio-widgets/include/iio-widgets/guistrategy/rangeguistrategy.h

@@ -52,6 +52,7 @@ class SCOPY_IIO_WIDGETS_EXPORT RangeAttrUi : public QObject, public GuiStrategyI
 
 public Q_SLOTS:
 	void receiveData(QString currentData, QString optionalData) override;
+	void changeName(QString name) override;
 
 Q_SIGNALS:
 	void displayedNewData(QString data, QString optionalData) override;

iio-widgets/include/iio-widgets/guistrategy/switchguistrategy.h

@@ -50,6 +50,7 @@ class SCOPY_IIO_WIDGETS_EXPORT SwitchAttrUi : public QObject, public GuiStrategy
 
 public Q_SLOTS:
 	void receiveData(QString currentData, QString optionalData) override;
+	void changeName(QString name) override;
 
 Q_SIGNALS:
 	void displayedNewData(QString data, QString optionalData) override;

iio-widgets/include/iio-widgets/iioconfigurationpopup.h

@@ -0,0 +1,48 @@
+#ifndef IIOCONFIGURATIONPOPUP_H
+#define IIOCONFIGURATIONPOPUP_H
+
+#include "iiowidgetselector.h"
+#include "scopy-iio-widgets_export.h"
+#include <gui/tintedoverlay.h>
+#include <iioutil/iioitem.h>
+#include <iio.h>
+#include <QWidget>
+#include <QLabel>
+#include <QPushButton>
+#include <QTreeView>
+
+namespace scopy {
+class SCOPY_IIO_WIDGETS_EXPORT IIOConfigurationPopup : public QWidget
+{
+	Q_OBJECT
+public:
+	explicit IIOConfigurationPopup(iio_context *ctx, QWidget *parent = nullptr);
+	explicit IIOConfigurationPopup(iio_device *dev, QWidget *parent = nullptr);
+	explicit IIOConfigurationPopup(iio_channel *chnl, QWidget *parent = nullptr);
+	~IIOConfigurationPopup();
+
+	void enableTintedOverlay(bool enable = true);
+
+Q_SIGNALS:
+	void selectButtonClicked(IIOItem *selected);
+	void emptyButtonClicked();
+	void exitButtonClicked();
+
+protected Q_SLOTS:
+	void modelSelectionChanged(const QItemSelection &selected, const QItemSelection &deselected);
+
+protected:
+	void init();
+	void initUI();
+
+	gui::TintedOverlay *m_tintedOverlay;
+	QLabel *m_titleLabel;
+	IIOWidgetSelector *m_widgetSelector;
+	QPushButton *m_exitButton;
+	QPushButton *m_selectButton;
+	QPushButton *m_emptyButton;
+	IIOItem *m_root;
+};
+} // namespace scopy
+
+#endif // IIOCONFIGURATIONPOPUP_H

iio-widgets/include/iio-widgets/iiowidget.h

@@ -22,11 +22,14 @@
 #define SCOPY_IIOWIDGET_H
 
 #include <QWidget>
+#include "iioconfigurationpopup.h"
 #include "iiowidgetdata.h"
 #include "utils.h"
 #include <gui/widgets/menucollapsesection.h>
 #include <gui/widgets/menusectionwidget.h>
 #include <gui/widgets/smallprogressbar.h>
+#include <gui/widgets/hoverwidget.h>
+#include <gui/widgets/popupwidget.h>
 #include "guistrategy/guistrategyinterface.h"
 #include "datastrategy/datastrategyinterface.h"
 #include "scopy-iio-widgets_export.h"
@@ -82,16 +85,11 @@ class SCOPY_IIO_WIDGETS_EXPORT IIOWidget : public QWidget
 	void writeAsync(QString data);
 
 	/**
-	 * @brief Returns the UI of the IIOWidget
-	 * @return GuiStrategyInterface
-	 * */
-	GuiStrategyInterface *getUiStrategy();
-
-	/**
-	 * @brief Returns the data save/load strategy
-	 * @return DataStretegyInterface
-	 * */
-	DataStrategyInterface *getDataStrategy();
+	 * @brief swapDataStrategy Disconnects the current Data Strategy and connects the new Data Strategy.
+	 * @param dataStrategy The new Data Strategy that will be connected to the UIC.
+	 * @return The old Data Strategy.
+	 */
+	DataStrategyInterface *swapDataStrategy(DataStrategyInterface *dataStrategy);
 
 	/**
 	 * @brief Returns the recipe that this widget is based on. This is optional, currently serves as a way to pass
@@ -126,16 +124,117 @@ class SCOPY_IIO_WIDGETS_EXPORT IIOWidget : public QWidget
 	 */
 	int lastReturnCode();
 
+	/**
+	 * @brief setUItoDataConversion Adds a function that is called before sending the data given as imput by the
+	 * user and modifies this data. The function receives as parameter a QString, converts it and returns the
+	 * converted string that will be sent to the DS after.
+	 * @param func std::function<QString(QString)>
+	 */
 	void setUItoDataConversion(std::function<QString(QString)> func);
+
+	/**
+	 * @brief setDataToUIConversion Adds a function that is called before sending the data read by the IIOWidget
+	 * and modifies this data. The function receives as parameter a QString, converts it and returns the
+	 * converted string that will be sent to the UI after.
+	 * @param func std::function<QString(QString)>
+	 */
 	void setDataToUIConversion(std::function<QString(QString)> func);
 
+	/**
+	 * @brief setConfigurable A configurable widget will have a wheel button on the right and it will allow the
+	 * use to modify the underlying data strategy at runtime.
+	 * @param isConfigurable If true, the widget is configurable at runtime. The default is false.
+	 */
+	void setConfigurable(bool isConfigurable);
+
+	/**
+	 * @brief setUIEnabled Enables/Disables the UI.
+	 * @param isEnabled True if the UI should be enabled, false if it should be disabled.
+	 */
+	void setUIEnabled(bool isEnabled);
+
+	/**
+	 * @brief optionalData Calls the optionalData function from the data strategy.
+	 * @return QString representing the optional data.
+	 */
+	QString optionalData() const;
+
+	/**
+	 * @brief data Calls the data functipm from the data strategy.
+	 * @return QString represrnting the data.
+	 */
+	QString data() const;
+
+	/**
+	 * @brief isDSInstanceOf Checks whether the current data strategy is an instance of the specified type.
+	 * @return True if the type specified coincides with the type of the data strategy.
+	 */
+	template <typename T>
+	bool isDSInstanceOf() const
+	{
+		return dynamic_cast<T *>(m_dataStrategy) != nullptr;
+	}
+
+	/**
+	 * @brief isUISInstanceO Checks wheter the current UI strategy is an instance of the specified type.
+	 * @return True if the type specified coincides with the type of the UI strategy.
+	 */
+	template <typename T>
+	bool isUISInstanceOf() const
+	{
+		return dynamic_cast<T *>(m_uiStrategy) != nullptr;
+	}
+
 Q_SIGNALS:
 	/**
 	 * @brief Emits the current state of the IIOWidget system and a string containing a more
 	 * elaborate explanation of the current state
 	 * */
 	void currentStateChanged(State currentState, QString explanation = "");
 
+	/**
+	 * @brief sendData Forwards the sendData signal from the Data Strategy (emits the newly read data).
+	 * @param data The data read.
+	 * @param dataOptions The data from the optional attribute read.
+	 */
+	void sendData(QString data, QString dataOptions);
+
+	/**
+	 * @brief emitStatus Forwarded signal from the Data Strategy for emitting the status of
+	 * the operation that was just performed.
+	 * @param timestamp QDateTime that holds the timestamp
+	 * @param oldData The data that is present in the iio-widget before the operation
+	 * @param newData The new data that was given to the operation
+	 * @param returnCode int representing the return code of that operation
+	 * @param isReadOp Boolean value set to true if the operation is a read
+	 * operation and false if it is a write operation.
+	 */
+	void emitStatus(QDateTime timestamp, QString oldData, QString newData, int returnCode, bool isReadOp);
+
+	/**
+	 * @brief This signal is emitted before a write operation
+	 * @param oldData String containing the data what is present before the write
+	 * @param newData String containing the data that will be written
+	 * */
+	void aboutToWrite(QString oldData, QString newData);
+
+	/**
+	 * @brief This will be the signal that the user changed the data, it is forwarded from the UI strategy.
+	 * */
+	void emitData(QString data);
+
+	/**
+	 * @brief This signal is emitted when the ui strategy receives new data from external sources,
+	 * not from the user.
+	 * @param data The data that will be displayed.
+	 * @param optionalData The data options, if available. Empty string if the parameter is not
+	 * necessary in this case.
+	 * */
+	void displayedNewData(QString data, QString optionalData);
+
+public Q_SLOTS:
+	void changeTitle(QString title);
+
 protected Q_SLOTS:
 	void saveData(QString data);
 	void emitDataStatus(QDateTime timestamp, QString oldData, QString newData, int returnCode, bool isReadOp);
@@ -148,14 +247,17 @@ protected Q_SLOTS:
 
 protected:
 	void initialize();
+	void reconfigure();
 
 	void setLastOperationTimestamp(QDateTime timestamp);
 	void setLastOperationState(IIOWidget::State state);
 
+	/* Core variables */
 	GuiStrategyInterface *m_uiStrategy;
 	DataStrategyInterface *m_dataStrategy;
 	IIOWidgetFactoryRecipe m_recipe;
 
+	/* Logged data */
 	QString m_lastData;
 	SmallProgressBar *m_progressBar;
 	QDateTime *m_lastOpTimestamp;
@@ -165,6 +267,11 @@ protected Q_SLOTS:
 	/* Conversion functions */
 	std::function<QString(QString)> m_UItoDS;
 	std::function<QString(QString)> m_DStoUI;
+
+	/* Optional configuration */
+	QPushButton *m_configBtn;
+	IIOConfigurationPopup *m_configPopup;
+	bool m_isConfigurable;
 };
 } // namespace scopy