DynExp
Highly flexible laboratory automation for dynamically changing experiments.
NIDAQAnalogOut.h
Go to the documentation of this file.
1 // This file is part of DynExp.
2 
9 #pragma once
10 
11 #include "stdafx.h"
12 #include "DynExpCore.h"
15 
16 namespace DynExpInstr
17 {
18  class NIDAQAnalogOut;
19 
20  namespace NIDAQAnalogOutTasks
21  {
23  {
26  };
27 
29  {
32  };
33 
35  {
38  };
39 
40  class WriteTask : public DynExp::TaskBase
41  {
42  public:
44 
45  private:
47  };
48 
49  class ClearTask : public DynExp::TaskBase
50  {
51  public:
53 
54  private:
56  };
57 
58  class StartTask : public DynExp::TaskBase
59  {
60  public:
62 
63  private:
65  };
66 
67  class StopTask : public DynExp::TaskBase
68  {
69  public:
71 
72  private:
74  };
75 
77  {
78  public:
80 
81  private:
83  };
84  }
85 
87  {
88  public:
89  NIDAQAnalogOutData() = default;
90  virtual ~NIDAQAnalogOutData() = default;
91 
94 
95  private:
96  void ResetImpl(dispatch_tag<AnalogOutData>) override final;
98  };
99 
101  {
102  public:
105  virtual ~NIDAQAnalogOutParams() = default;
106 
107  virtual const char* GetParamClassTag() const noexcept override { return "NIDAQAnalogOutParams"; }
108 
110  "HardwareAdapter", "NIDAQmx controller", "Underlying hardware adapter of this instrument", DynExpUI::Icons::HardwareAdapter };
111  Param<ParamsConfigDialog::TextType> ChannelName = { *this, "ChannelName", "Channel name",
112  "Path of the analog out channel to be used", true, "Dev1/ao0" };
113 
115 
116  private:
119  };
120 
122  {
123  public:
126 
128  virtual ~NIDAQAnalogOutConfigurator() = default;
129 
130  private:
131  virtual DynExp::ParamsBasePtrType MakeParams(DynExp::ItemIDType ID, const DynExp::DynExpCore& Core) const override { return DynExp::MakeParams<NIDAQAnalogOutConfigurator>(ID, Core); }
132  };
133 
134  class NIDAQAnalogOut : public AnalogOut
135  {
136  public:
140 
141  constexpr static auto Name() noexcept { return "NIDAQ Analog Out"; }
142 
144  virtual ~NIDAQAnalogOut() {}
145 
146  virtual std::string GetName() const override { return Name(); }
147 
148  constexpr static DataStreamInstrumentData::ValueType HardwareMinValue() noexcept { return -10; }
149  constexpr static DataStreamInstrumentData::ValueType HardwareMaxValue() noexcept { return 10; }
150  constexpr static DataStreamInstrumentData::ValueType HardwareResolution() noexcept { return 1e-3; }
151 
152  virtual DataStreamInstrumentData::ValueType GetHardwareMinValue() const noexcept override { return HardwareMinValue(); }
153  virtual DataStreamInstrumentData::ValueType GetHardwareMaxValue() const noexcept override { return HardwareMaxValue(); }
154  virtual DataStreamInstrumentData::ValueType GetHardwareResolution() const noexcept override final { return HardwareResolution(); }
158 
159  virtual void WriteData(DynExp::TaskBase::CallbackType CallbackFunc) const override { MakeAndEnqueueTask<NIDAQAnalogOutTasks::WriteTask>(CallbackFunc); }
160  virtual void ClearData(DynExp::TaskBase::CallbackType CallbackFunc = nullptr) const override { MakeAndEnqueueTask<NIDAQAnalogOutTasks::ClearTask>(CallbackFunc); }
161  virtual void Start(DynExp::TaskBase::CallbackType CallbackFunc = nullptr) const override { MakeAndEnqueueTask<NIDAQAnalogOutTasks::StartTask>(CallbackFunc); }
162  virtual void Stop(DynExp::TaskBase::CallbackType CallbackFunc = nullptr) const override { MakeAndEnqueueTask<NIDAQAnalogOutTasks::StopTask>(CallbackFunc); }
163  virtual void Restart(DynExp::TaskBase::CallbackType CallbackFunc = nullptr) const override { MakeAndEnqueueTask<NIDAQAnalogOutTasks::RestartTask>(CallbackFunc); }
164  virtual Util::OptionalBool HasFinished() const override;
165  virtual void SetDefault(DynExp::TaskBase::CallbackType CallbackFunc = nullptr) const override;
166 
167  private:
168  virtual void OnErrorChild() const override;
169 
170  void ResetImpl(dispatch_tag<AnalogOut>) override final;
172 
174 
175  virtual std::unique_ptr<DynExp::InitTaskBase> MakeInitTask() const override { return DynExp::MakeTask<NIDAQAnalogOutTasks::InitTask>(); }
176  virtual std::unique_ptr<DynExp::ExitTaskBase> MakeExitTask() const override { return DynExp::MakeTask<NIDAQAnalogOutTasks::ExitTask>(); }
177  virtual std::unique_ptr<DynExp::UpdateTaskBase> MakeUpdateTask() const override { return DynExp::MakeTask<NIDAQAnalogOutTasks::UpdateTask>(); }
178  };
179 }
Defines a meta instrument for a single analog output port to write a data stream consisting of analog...
Defines DynExp's core module as an interface between the UI and DynExp objects.
Implementation of a hardware adapter to control National Instruments NIDAQmx hardware.
NIDAQTask::ChannelHandleType ChannelHandleType
Configurator class for AnalogOut.
Definition: AnalogOut.h:162
Data class for AnalogOut.
Definition: AnalogOut.h:79
Parameter class for AnalogOut.
Definition: AnalogOut.h:107
Defines a task for deinitializing an instrument within an instrument inheritance hierarchy....
Definition: AnalogOut.h:52
Defines a task for initializing an instrument within an instrument inheritance hierarchy....
Definition: AnalogOut.h:27
Defines a task for updating an instrument within an instrument inheritance hierarchy....
Definition: AnalogOut.h:65
Meta instrument for a single analog output port based on the data stream, function generator,...
Definition: AnalogOut.h:176
UnitType
Units which can be used for data stream instruments.
double ValueType
Data type to represent hardware limits on the sample values to write to the hardware adapter assigned...
virtual DynExp::ParamsBasePtrType MakeParams(DynExp::ItemIDType ID, const DynExp::DynExpCore &Core) const override
Override to make derived classes call DynExp::MakeParams with the correct configurator type derived f...
virtual ~NIDAQAnalogOutData()=default
DynExpHardware::NIDAQHardwareAdapter::ChannelHandleType ChannelHandle
void ResetImpl(dispatch_tag< AnalogOutData >) override final
DynExp::LinkedObjectWrapperContainer< DynExpHardware::NIDAQHardwareAdapter > HardwareAdapter
virtual void ResetImpl(dispatch_tag< NIDAQAnalogOutData >)
void ConfigureParamsImpl(dispatch_tag< AnalogOutParams >) override final
Called by DynExp::ParamsBase::ConfigureParams() as a starting point for the tag dispatch mechanism to...
DynExpHardware::NIDAQOutputPortParamsExtension NIDAQOutputPortParams
NIDAQAnalogOutParams(DynExp::ItemIDType ID, const DynExp::DynExpCore &Core)
Param< ParamsConfigDialog::TextType > ChannelName
Param< DynExp::ObjectLink< DynExpHardware::NIDAQHardwareAdapter > > HardwareAdapter
virtual void ConfigureParamsImpl(dispatch_tag< NIDAQAnalogOutParams >)
virtual const char * GetParamClassTag() const noexcept override
This function is intended to be overridden once in each derived class returning the name of the respe...
virtual ~NIDAQAnalogOutParams()=default
virtual DynExp::TaskResultType RunChild(DynExp::InstrumentInstance &Instance) override
Runs the task. Override RunChild() to define a derived task's action(s). Any exception leaving RunChi...
ClearTask(CallbackType CallbackFunc) noexcept
virtual void ExitFuncImpl(dispatch_tag< ExitTask >, DynExp::InstrumentInstance &Instance)
void ExitFuncImpl(dispatch_tag< AnalogOutTasks::ExitTask >, DynExp::InstrumentInstance &Instance) override final
Deinitializes the respective instrument within the instrument inheritance hierarchy....
void InitFuncImpl(dispatch_tag< AnalogOutTasks::InitTask >, DynExp::InstrumentInstance &Instance) override final
Initializes the respective instrument within the instrument inheritance hierarchy....
virtual void InitFuncImpl(dispatch_tag< InitTask >, DynExp::InstrumentInstance &Instance)
RestartTask(CallbackType CallbackFunc) noexcept
virtual DynExp::TaskResultType RunChild(DynExp::InstrumentInstance &Instance) override
Runs the task. Override RunChild() to define a derived task's action(s). Any exception leaving RunChi...
StartTask(CallbackType CallbackFunc) noexcept
virtual DynExp::TaskResultType RunChild(DynExp::InstrumentInstance &Instance) override
Runs the task. Override RunChild() to define a derived task's action(s). Any exception leaving RunChi...
virtual DynExp::TaskResultType RunChild(DynExp::InstrumentInstance &Instance) override
Runs the task. Override RunChild() to define a derived task's action(s). Any exception leaving RunChi...
StopTask(CallbackType CallbackFunc) noexcept
void UpdateFuncImpl(dispatch_tag< AnalogOutTasks::UpdateTask >, DynExp::InstrumentInstance &Instance) override final
Updates the respective instrument within the instrument inheritance hierarchy. Call UpdateFuncImpl() ...
virtual void UpdateFuncImpl(dispatch_tag< UpdateTask >, DynExp::InstrumentInstance &Instance)
WriteTask(CallbackType CallbackFunc) noexcept
virtual DynExp::TaskResultType RunChild(DynExp::InstrumentInstance &Instance) override
Runs the task. Override RunChild() to define a derived task's action(s). Any exception leaving RunChi...
constexpr static DataStreamInstrumentData::ValueType HardwareMinValue() noexcept
virtual DataStreamInstrumentData::ValueType GetHardwareMaxValue() const noexcept override
Indicates the maximal value the underlying hardware can generate. Also refer to GetUserMaxValue().
void ResetImpl(dispatch_tag< AnalogOut >) override final
Refer to DynExp::Object::Reset(). Using tag dispatch mechanism to ensure that ResetImpl() of every de...
virtual void ClearData(DynExp::TaskBase::CallbackType CallbackFunc=nullptr) const override
Enqueues a task to clear the underlying hardware adapter's buffer.
virtual NumericSampleStreamParamsExtension::ValueType GetNumericSampleStreamParams() const override
Retrieves sample stream settings of the instrument's data stream from the instrument's or from the un...
virtual DataStreamInstrumentData::UnitType GetValueUnit() const noexcept override
Determines which unit corresponds to the values managed by this DataStreamInstrument instance....
virtual void Stop(DynExp::TaskBase::CallbackType CallbackFunc=nullptr) const override
Enqueues a task to make the underlying hardware adapter stop data acquisition or writing data.
virtual void SetDefault(DynExp::TaskBase::CallbackType CallbackFunc=nullptr) const override
Writes AnalogOutParams::DefaultValue to the sample stream. CallbackFunc gets called after the task Da...
virtual DataStreamInstrumentData::ValueType GetHardwareMinValue() const noexcept override
Indicates the minimal value the underlying hardware can generate. Also refer to GetUserMinValue().
virtual void WriteData(DynExp::TaskBase::CallbackType CallbackFunc) const override
Enqueues a task to write data from the data stream to the hardware.
virtual void OnErrorChild() const override
Derived classes can perform critical shutdown actions after an error has occurred....
virtual std::unique_ptr< DynExp::UpdateTaskBase > MakeUpdateTask() const override
Factory function for an update task (UpdateTaskBase). Override to define the desired update task in d...
virtual DataStreamInstrumentData::ValueType GetHardwareResolution() const noexcept override final
Indicates the value's resolution the underlying hardware can generate.
virtual Util::OptionalBool HasFinished() const override
Determines whether the underlying hardware adapter finished data acquisition or writing data.
constexpr static DataStreamInstrumentData::ValueType HardwareMaxValue() noexcept
virtual Util::FeatureTester< WaveformCapsType > GetWaveformCapsChild() const override
Returns the waveform types the function generator is able to produce.
NIDAQAnalogOut(const std::thread::id OwnerThreadID, DynExp::ParamsBasePtrType &&Params)
virtual std::string GetName() const override
Returns the name of this Object type.
virtual std::unique_ptr< DynExp::InitTaskBase > MakeInitTask() const override
Factory function for an init task (InitTaskBase). Override to define the desired initialization task ...
virtual void Restart(DynExp::TaskBase::CallbackType CallbackFunc=nullptr) const override
Enqueues a task to make the underlying hardware adapter restart data acquisition or writing data....
virtual StreamSizeParamsExtension::ValueType GetStreamSizeParams() const override
Retrieves the size of the instrument's data stream from the instrument parameters....
constexpr static auto Name() noexcept
virtual void Start(DynExp::TaskBase::CallbackType CallbackFunc=nullptr) const override
Enqueues a task to make the underlying hardware adapter start data acquisition or writing data.
virtual std::unique_ptr< DynExp::ExitTaskBase > MakeExitTask() const override
Factory function for an exit task (ExitTaskBase). Override to define the desired deinitialization tas...
constexpr static DataStreamInstrumentData::ValueType HardwareResolution() noexcept
virtual void ResetImpl(dispatch_tag< NIDAQAnalogOut >)
Type containing the values of all the parameters belonging to NumericSampleStreamParamsExtension.
Type containing the values of all the parameters belonging to StreamSizeParamsExtension.
DynExp's core class acts as the interface between the user interface and DynExp's internal data like ...
Definition: DynExpCore.h:127
Refer to DynExp::ParamsBase::dispatch_tag.
Definition: Instrument.h:1151
Refer to DynExp::ParamsBase::dispatch_tag.
Definition: Instrument.h:1120
Base class for instruments. Instruments comprise virtual devices (meta instruments) and physial devic...
Definition: Instrument.h:451
Configurator class for InstrumentBase.
Definition: Instrument.h:435
Data structure to contain data which is synchronized in between different threads....
Definition: Instrument.h:135
Refer to ParamsBase::dispatch_tag.
Definition: Instrument.h:146
Defines data for a thread belonging to a InstrumentBase instance. Refer to RunnableInstance.
Definition: Instrument.h:772
Parameter class for InstrumentBase.
Definition: Instrument.h:401
const std::thread::id OwnerThreadID
Thread id of the thread which has constructed (and owns) this Object instance.
Definition: Object.h:2302
const ParamsBasePtrType Params
Pointer to the parameter class instance belonging to this Object instance.
Definition: Object.h:2303
Refer to ParamsBase::dispatch_tag.
Definition: Object.h:2018
const ItemIDType ID
ID of the Object this parameter class instance belongs to.
Definition: Object.h:1779
const auto & GetCore() const noexcept
Returns a reference to DynExp's core.
Definition: Object.h:1677
const DynExpCore & Core
Reference to DynExp's core.
Definition: Object.h:1780
Tag for function dispatching mechanism within this class used when derived classes are not intended t...
Definition: Object.h:349
Base class for all tasks being processed by instruments. The class must not contain public virtual fu...
Definition: Instrument.h:892
std::function< void(const TaskBase &, ExceptionContainer &)> CallbackType
Type of a callback function which is invoked when a task has finished, failed or has been aborted....
Definition: Instrument.h:939
TaskBase(CallbackType CallbackFunc=nullptr) noexcept
Constructs an instrument task.
Definition: Instrument.h:979
const CallbackType CallbackFunc
This callback function is called after the task has finished (either successfully or not) with a refe...
Definition: Instrument.h:1072
Defines the return type of task functions.
Definition: Instrument.h:824
Refer to DynExp::ParamsBase::dispatch_tag.
Definition: Instrument.h:1182
Holds a bitset containing flags to indicate which features a certain instrument/ module etc....
Definition: Util.h:1231
Data type which stores an optional bool value (unknown, false, true). The type evaluates to bool whil...
Definition: Util.h:549
DynExp's instrument namespace contains the implementation of DynExp instruments which extend DynExp's...
Definition: Instrument.h:1254
constexpr auto HardwareAdapter
std::unique_ptr< ParamsBase > ParamsBasePtrType
Alias for a pointer to the parameter system base class ParamsBase.
Definition: Object.h:1807
size_t ItemIDType
ID type of objects/items managed by DynExp.
Accumulates include statements to provide a precompiled header.