M2kHardwareTrigger: Add trigger out for analogical interface.

Both DACs share the same trigger mechanism - only one DAC should be used
in order to configure the triggering system.
Implement the functionalities based on the generic definitions.

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

Author: Teo Perisanu

include/libm2k/m2khardwaretrigger.hpp

@@ -446,6 +446,48 @@ class LIBM2K_API M2kHardwareTrigger
 	 * @return the trigger condition
 	 */
 	virtual M2K_TRIGGER_CONDITION_DIGITAL getDigitalOutCondition() const = 0;
+
+
+	/**
+	 * @brief Select which interface triggers the AnalogOut.
+	 * @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 setAnalogOutSource(M2K_TRIGGER_OUT_SOURCE src) = 0;
+
+
+	/**
+	 * @brief Retrieve the source of the AnalogOut 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 getAnalogOutSource() const = 0;
+
+
+	/**
+	 * @brief Set the trigger condition for the TI/TO in order to trigger the AnalogOut 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 setAnalogOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) = 0;
+
+
+	/**
+	 * @brief Get the trigger condition of the TI/TO pins that triggers the AnalogOut interface
+	 * @return the trigger condition
+	 */
+	virtual M2K_TRIGGER_CONDITION_DIGITAL getAnalogOutCondition() const = 0;
 };
 }
 

src/m2khardwaretrigger_impl.cpp

@@ -594,3 +594,27 @@ M2K_TRIGGER_CONDITION_DIGITAL M2kHardwareTriggerImpl::getDigitalOutCondition() c
 	THROW_M2K_EXCEPTION("Invalid firmware version. Minimum required version: v0.26", libm2k::EXC_INVALID_FIRMWARE_VERSION);
 	return NO_TRIGGER_DIGITAL;
 }
+
+void M2kHardwareTriggerImpl::setAnalogOutSource(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::getAnalogOutSource() const
+{
+	THROW_M2K_EXCEPTION("Invalid firmware version. Minimum required version: v0.26", libm2k::EXC_INVALID_FIRMWARE_VERSION);
+	return SRC_OUT_NONE;
+}
+
+void M2kHardwareTriggerImpl::setAnalogOutCondition(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::getAnalogOutCondition() 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

@@ -111,6 +111,11 @@ class M2kHardwareTriggerImpl : public M2kHardwareTrigger
 	M2K_TRIGGER_OUT_SOURCE getDigitalOutSource() const override;
 	void setDigitalOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) override;
 	M2K_TRIGGER_CONDITION_DIGITAL getDigitalOutCondition() const override;
+	void setAnalogOutSource(M2K_TRIGGER_OUT_SOURCE src) override;
+	M2K_TRIGGER_OUT_SOURCE getAnalogOutSource() const override;
+	void setAnalogOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) override;
+	M2K_TRIGGER_CONDITION_DIGITAL getAnalogOutCondition() const override;
+
 protected:
 	struct iio_device *m_trigger_device;
 	std::vector<Channel *> m_analog_channels;

src/m2khardwaretrigger_v0.26_impl.cpp

@@ -51,15 +51,27 @@ libm2k::M2kHardwareTriggerV026Impl::M2kHardwareTriggerV026Impl(struct iio_contex
 	bool hasTriggerSource;
 	bool hasTriggerCondition;
 	m_digital_trigger_device = make_shared<libm2k::utils::DeviceOut>(ctx, "m2k-logic-analyzer-tx");
+	// both dac a and dac b share the same trigger
+	m_analog_trigger_device = make_shared<libm2k::utils::DeviceOut>(ctx, "m2k-dac-a");
 	if (!m_digital_trigger_device) {
 		THROW_M2K_EXCEPTION("No digital TX trigger available", libm2k::EXC_RUNTIME_ERROR);
 	}
+	if (!m_analog_trigger_device) {
+        THROW_M2K_EXCEPTION("No analog 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);
 	}
 
+	hasTriggerSource = m_analog_trigger_device->hasGlobalAttribute(m_source_attr);
+	hasTriggerCondition = m_analog_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();
 	}
@@ -69,6 +81,8 @@ void libm2k::M2kHardwareTriggerV026Impl::reset() {
 	M2kHardwareTriggerV024Impl::reset();
 	setDigitalOutSource(SRC_OUT_NONE);
 	setDigitalOutCondition(NO_TRIGGER_DIGITAL);
+	setAnalogOutSource(SRC_OUT_NONE);
+	setAnalogOutCondition(NO_TRIGGER_DIGITAL);
 }
 
 void libm2k::M2kHardwareTriggerV026Impl::setDigitalOutSource(libm2k::M2K_TRIGGER_OUT_SOURCE src)
@@ -91,6 +105,26 @@ libm2k::M2K_TRIGGER_CONDITION_DIGITAL libm2k::M2kHardwareTriggerV026Impl::getDig
 	return getTriggerOutCondition(m_digital_trigger_device);
 }
 
+void libm2k::M2kHardwareTriggerV026Impl::setAnalogOutSource(libm2k::M2K_TRIGGER_OUT_SOURCE src)
+{
+	setTriggerOutSource(src, m_analog_trigger_device);
+}
+
+libm2k::M2K_TRIGGER_OUT_SOURCE libm2k::M2kHardwareTriggerV026Impl::getAnalogOutSource() const
+{
+	return getTriggerOutSource(m_analog_trigger_device);
+}
+
+void libm2k::M2kHardwareTriggerV026Impl::setAnalogOutCondition(libm2k::M2K_TRIGGER_CONDITION_DIGITAL cond)
+{
+	setTriggerOutCondition(cond, m_analog_trigger_device);
+}
+
+libm2k::M2K_TRIGGER_CONDITION_DIGITAL libm2k::M2kHardwareTriggerV026Impl::getAnalogOutCondition() const
+{
+	return getTriggerOutCondition(m_analog_trigger_device);
+}
+
 void libm2k::M2kHardwareTriggerV026Impl::setTriggerOutSource(libm2k::M2K_TRIGGER_OUT_SOURCE src,
 							    const std::shared_ptr<libm2k::utils::DeviceOut>& device)
 {

src/m2khardwaretrigger_v0.26_impl.hpp

@@ -44,13 +44,22 @@ class M2kHardwareTriggerV026Impl : public M2kHardwareTriggerV024Impl {
 
 	M2K_TRIGGER_CONDITION_DIGITAL getDigitalOutCondition() const override;
 
+	void setAnalogOutSource(M2K_TRIGGER_OUT_SOURCE src) override;
+
+	M2K_TRIGGER_OUT_SOURCE getAnalogOutSource() const override;
+
+	void setAnalogOutCondition(M2K_TRIGGER_CONDITION_DIGITAL cond) override;
+
+	M2K_TRIGGER_CONDITION_DIGITAL getAnalogOutCondition() 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;
+	std::shared_ptr<libm2k::utils::DeviceOut> m_analog_trigger_device;
 
 	static std::vector<std::string> m_trigger_source;
 	static std::vector<std::string> m_trigger_cond;