M2kHardwareTrigger: Add trigger out for digital interface.

Add the digital device. Implement the functionalities based on the generic
definitions.

Signed-off-by: Teo Perisanu <[email protected]>

Author: Teo Perisanu

include/libm2k/m2khardwaretrigger.hpp

@@ -404,6 +404,48 @@ class LIBM2K_API M2kHardwareTrigger
 	 * @note Only available from firmware v0.24.
 	 */
 	virtual M2K_TRIGGER_SOURCE_DIGITAL getDigitalSource() const;
+
+
+	/**
+	 * @brief Select which interface triggers the DigitalOut.
+	 * @param src: of type M2K_TRIGGER_OUT_SOURCE:\n
+	 * 	SRC_OUT_NONE - no trigger events
+	 * 	SRC_OUT_TRIGGER_IN - trigger events on the TI(trigger in) pin trigger the DigitalOut interface;\n
+	 * 	SRC_OUT_TRIGGER_OUT - trigger events on the TO(trigger out) pin trigger the DigitalOut interface;\n
+	 * 	SRC_OUT_ANALOG_IN - trigger events on the AnalogIn interface trigger the DigitalOut interface;\n
+	 * 	SRC_OUT_DIGITAL_IN - trigger events on the DigitalIn interface trigger the DigitalOut interface;\n
+	 * @note Only available from firmware v0.26.
+	 */
+	virtual void setDigitalOutSource(M2K_TRIGGER_OUT_SOURCE src) = 0;
+
+
+	/**
+	 * @brief Retrieve the source of the DigitalOut interface trigger event.
+	 * @return M2K_TRIGGER_OUT_SOURCE :\n
+	 *	SRC_OUT_NONE;\n
+	 *	SRC_OUT_TRIGGER_IN;\n
+	 *	SRC_OUT_TRIGGER_OUT;\n
+	 *	SRC_OUT_ANALOG_IN;\n
+	 *	SRC_OUT_DIGITAL_IN;\n
+	 * @note Only available from firmware v0.26.
+	 */
+	virtual M2K_TRIGGER_OUT_SOURCE getDigitalOutSource() const = 0;
+
+
+	/**
+	 * @brief Set the trigger condition for the TI/TO in order to trigger the DigitalOut interface
+	 * @param cond the specific trigger condition
+	 *
+	 * @note to have any effect the digital out source must be set to TI or TO
+	 */
+	virtual void setDigitalOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) = 0;
+
+
+	/**
+	 * @brief Get the trigger condition of the TI/TO pins that triggers the DigitalOut interface
+	 * @return the trigger condition
+	 */
+	virtual M2K_TRIGGER_CONDITION_DIGITAL getDigitalOutCondition() const = 0;
 };
 }
 

src/m2khardwaretrigger_impl.cpp

@@ -570,3 +570,27 @@ void M2kHardwareTriggerImpl::setCalibParameters(unsigned int chnIdx, double scal
 	m_scaling[chnIdx] = scaling;
 	m_offset[chnIdx] = offset;
 }
+
+void M2kHardwareTriggerImpl::setDigitalOutSource(M2K_TRIGGER_OUT_SOURCE src)
+{
+	UNUSED(src);
+	THROW_M2K_EXCEPTION("Invalid firmware version. Minimum required version: v0.26", libm2k::EXC_INVALID_FIRMWARE_VERSION);
+}
+
+M2K_TRIGGER_OUT_SOURCE M2kHardwareTriggerImpl::getDigitalOutSource() const
+{
+	THROW_M2K_EXCEPTION("Invalid firmware version. Minimum required version: v0.26", libm2k::EXC_INVALID_FIRMWARE_VERSION);
+	return SRC_OUT_NONE;
+}
+
+void M2kHardwareTriggerImpl::setDigitalOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond)
+{
+	UNUSED(cond);
+	THROW_M2K_EXCEPTION("Invalid firmware version. Minimum required version: v0.26", libm2k::EXC_INVALID_FIRMWARE_VERSION);
+}
+
+M2K_TRIGGER_CONDITION_DIGITAL M2kHardwareTriggerImpl::getDigitalOutCondition() const
+{
+	THROW_M2K_EXCEPTION("Invalid firmware version. Minimum required version: v0.26", libm2k::EXC_INVALID_FIRMWARE_VERSION);
+	return NO_TRIGGER_DIGITAL;
+}

src/m2khardwaretrigger_impl.hpp

@@ -107,6 +107,10 @@ class M2kHardwareTriggerImpl : public M2kHardwareTrigger
 	M2K_TRIGGER_CONDITION_DIGITAL getDigitalCondition(DIO_CHANNEL chn);
 	void setDigitalCondition(DIO_CHANNEL chn, M2K_TRIGGER_CONDITION_DIGITAL cond);
 
+	void setDigitalOutSource(M2K_TRIGGER_OUT_SOURCE src) override;
+	M2K_TRIGGER_OUT_SOURCE getDigitalOutSource() const override;
+	void setDigitalOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) override;
+	M2K_TRIGGER_CONDITION_DIGITAL getDigitalOutCondition() const override;
 protected:
 	struct iio_device *m_trigger_device;
 	std::vector<Channel *> m_analog_channels;

src/m2khardwaretrigger_v0.26_impl.cpp

@@ -48,14 +48,47 @@ std::vector<std::string> libm2k::M2kHardwareTriggerV026Impl::m_trigger_cond = {
 libm2k::M2kHardwareTriggerV026Impl::M2kHardwareTriggerV026Impl(struct iio_context *ctx, bool init) :
 	M2kHardwareTriggerV024Impl(ctx)
 {
+	bool hasTriggerSource;
+	bool hasTriggerCondition;
+	m_digital_trigger_device = make_shared<libm2k::utils::DeviceOut>(ctx, "m2k-logic-analyzer-tx");
+	if (!m_digital_trigger_device) {
+		THROW_M2K_EXCEPTION("No digital TX trigger available", libm2k::EXC_RUNTIME_ERROR);
+	}
+	hasTriggerSource = m_digital_trigger_device->hasGlobalAttribute(m_source_attr);
+	hasTriggerCondition = m_digital_trigger_device->hasGlobalAttribute(m_condition_attr);
+	if (!hasTriggerSource || !hasTriggerCondition) {
+		THROW_M2K_EXCEPTION("Analog TX trigger is not available", libm2k::EXC_RUNTIME_ERROR);
+	}
+
 	if (init) {
 		reset();
 	}
 }
 
-void libm2k::M2kHardwareTriggerV026Impl::reset()
-{
+void libm2k::M2kHardwareTriggerV026Impl::reset() {
 	M2kHardwareTriggerV024Impl::reset();
+	setDigitalOutSource(SRC_OUT_NONE);
+	setDigitalOutCondition(NO_TRIGGER_DIGITAL);
+}
+
+void libm2k::M2kHardwareTriggerV026Impl::setDigitalOutSource(libm2k::M2K_TRIGGER_OUT_SOURCE src)
+{
+	setTriggerOutSource(src, m_digital_trigger_device);
+}
+
+libm2k::M2K_TRIGGER_OUT_SOURCE libm2k::M2kHardwareTriggerV026Impl::getDigitalOutSource() const
+{
+	return getTriggerOutSource(m_digital_trigger_device);
+}
+
+void libm2k::M2kHardwareTriggerV026Impl::setDigitalOutCondition(libm2k::M2K_TRIGGER_CONDITION_DIGITAL cond)
+{
+	setTriggerOutCondition(cond, m_digital_trigger_device);
+}
+
+libm2k::M2K_TRIGGER_CONDITION_DIGITAL libm2k::M2kHardwareTriggerV026Impl::getDigitalOutCondition() const
+{
+	return getTriggerOutCondition(m_digital_trigger_device);
 }
 
 void libm2k::M2kHardwareTriggerV026Impl::setTriggerOutSource(libm2k::M2K_TRIGGER_OUT_SOURCE src,

src/m2khardwaretrigger_v0.26_impl.hpp

@@ -36,12 +36,22 @@ class M2kHardwareTriggerV026Impl : public M2kHardwareTriggerV024Impl {
 
 	void reset() override;
 
+	void setDigitalOutSource(M2K_TRIGGER_OUT_SOURCE src) override;
+
+	M2K_TRIGGER_OUT_SOURCE getDigitalOutSource() const override;
+
+	void setDigitalOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) override;
+
+	M2K_TRIGGER_CONDITION_DIGITAL getDigitalOutCondition() const override;
+
 protected:
 	void setTriggerOutSource(M2K_TRIGGER_OUT_SOURCE src, const std::shared_ptr<libm2k::utils::DeviceOut>& device);
 	M2K_TRIGGER_OUT_SOURCE getTriggerOutSource(const std::shared_ptr<libm2k::utils::DeviceOut>& device) const;
 	void setTriggerOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond, const std::shared_ptr<libm2k::utils::DeviceOut>& device);
 	M2K_TRIGGER_CONDITION_DIGITAL getTriggerOutCondition(const std::shared_ptr<libm2k::utils::DeviceOut>& device) const;
 
+	std::shared_ptr<libm2k::utils::DeviceOut> m_digital_trigger_device;
+
 	static std::vector<std::string> m_trigger_source;
 	static std::vector<std::string> m_trigger_cond;