DynExp
Highly flexible laboratory automation for dynamically changing experiments.
DigitalIn.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 "InputPort.h"
13 
14 namespace DynExpInstr
15 {
16  class DigitalIn;
17 
21  namespace DigitalInTasks
22  {
27  {
29 
34  };
35 
40  {
42 
47  };
48 
53  {
55 
60  };
61  }
62 
67  {
68  public:
70 
77  DigitalInData(size_t BufferSizeInSamples = 1) : InputPortData(std::make_unique<SampleStreamType>(BufferSizeInSamples)) {}
78 
83 
84  virtual ~DigitalInData() = default;
85 
86  private:
87  void ResetImpl(dispatch_tag<InputPortData>) override final;
89  };
90 
95  {
96  public:
102  : InputPortParams(ID, Core) {}
103 
104  virtual ~DigitalInParams() = 0;
105 
106  virtual const char* GetParamClassTag() const noexcept override { return "DigitalInParams"; }
107 
108  protected:
109  void DisableUserEditable();
110 
111  private:
114 
115  DummyParam Dummy = { *this };
116  };
117 
122  {
123  public:
126 
128  virtual ~DigitalInConfigurator() = 0;
129  };
130 
135  class DigitalIn : public InputPort
136  {
137  public:
141 
150 
151  constexpr static auto Name() noexcept { return "Digital In"; }
152  constexpr static auto Category() noexcept { return "I/O"; }
153 
158  : InputPort(OwnerThreadID, std::move(Params)) {}
159 
160  virtual ~DigitalIn() = 0;
161 
162  virtual std::string GetName() const override { return Name(); }
163  virtual std::string GetCategory() const override { return Category(); }
164 
170  virtual DataStreamInstrumentData::ValueType GetHardwareMinValue() const noexcept override final { return 0; }
171  virtual DataStreamInstrumentData::ValueType GetHardwareMaxValue() const noexcept override final { return 1; }
172  virtual DataStreamInstrumentData::ValueType GetHardwareResolution() const noexcept override final { return 1; }
174 
183 
190 
197 
205 
206  private:
207  void ResetImpl(dispatch_tag<InputPort>) override final;
208  virtual void ResetImpl(dispatch_tag<DigitalIn>) = 0;
209 
210  virtual std::unique_ptr<DynExp::InitTaskBase> MakeInitTask() const override { return DynExp::MakeTask<DigitalInTasks::InitTask>(); }
211  virtual std::unique_ptr<DynExp::ExitTaskBase> MakeExitTask() const override { return DynExp::MakeTask<DigitalInTasks::ExitTask>(); }
212  virtual std::unique_ptr<DynExp::UpdateTaskBase> MakeUpdateTask() const override { return DynExp::MakeTask<DigitalInTasks::UpdateTask>(); }
213  };
214 }
Defines a generic input port meta instrument which is used to read data from hardware and to write th...
SampleT SampleType
Alias for SampleT.
UnitType
Units which can be used for data stream instruments.
@ LogicLevel
Logic level (TTL) units (1 or 0)
double ValueType
Data type to represent hardware limits on the sample values to write to the hardware adapter assigned...
const DataStreamBasePtrType SampleStream
Refer to DynExp::InstrumentDataBase::Reset(). Using tag dispatch mechanism to ensure that ResetImpl()...
Configurator class for DigitalIn.
Definition: DigitalIn.h:122
Data class for DigitalIn.
Definition: DigitalIn.h:67
virtual void ResetImpl(dispatch_tag< DigitalInData >)
Definition: DigitalIn.h:88
DigitalInData(DataStreamBasePtrType &&SampleStream)
Constructs a DataStreamInstrumentData instance.
Definition: DigitalIn.h:82
virtual ~DigitalInData()=default
void ResetImpl(dispatch_tag< InputPortData >) override final
Definition: DigitalIn.cpp:8
DigitalInData(size_t BufferSizeInSamples=1)
Constructs a DataStreamInstrumentData instance.
Definition: DigitalIn.h:77
Parameter class for DigitalIn.
Definition: DigitalIn.h:95
virtual void ConfigureParamsImpl(dispatch_tag< DigitalInParams >)
Called by DynExp::ParamsBase::ConfigureParams() as a starting point for the tag dispatch mechanism to...
Definition: DigitalIn.h:113
DummyParam Dummy
Dummy parameter which is to be owned once by parameter classes that do not contain any other paramete...
Definition: DigitalIn.h:115
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...
Definition: DigitalIn.h:106
void ConfigureParamsImpl(dispatch_tag< InputPortParams >) override final
Called by DynExp::ParamsBase::ConfigureParams() as a starting point for the tag dispatch mechanism to...
Definition: DigitalIn.h:112
void DisableUserEditable()
Calls DynExp::ParamsBase::DisableUserEditable() on all bundled parameters.
Definition: DigitalIn.cpp:37
DigitalInParams(DynExp::ItemIDType ID, const DynExp::DynExpCore &Core)
Constructs the parameters for a DigitalIn instance.
Definition: DigitalIn.h:101
Defines a task for deinitializing an instrument within an instrument inheritance hierarchy....
Definition: DigitalIn.h:40
virtual void ExitFuncImpl(dispatch_tag< ExitTask >, DynExp::InstrumentInstance &Instance)
Deinitializes the respective instrument within the instrument inheritance hierarchy....
Definition: DigitalIn.h:46
void ExitFuncImpl(dispatch_tag< InputPortTasks::ExitTask >, DynExp::InstrumentInstance &Instance) override final
Deinitializes the respective instrument within the instrument inheritance hierarchy....
Definition: DigitalIn.h:41
Defines a task for initializing an instrument within an instrument inheritance hierarchy....
Definition: DigitalIn.h:27
void InitFuncImpl(dispatch_tag< InputPortTasks::InitTask >, DynExp::InstrumentInstance &Instance) override final
Initializes the respective instrument within the instrument inheritance hierarchy....
Definition: DigitalIn.h:28
virtual void InitFuncImpl(dispatch_tag< InitTask >, DynExp::InstrumentInstance &Instance)
Initializes the respective instrument within the instrument inheritance hierarchy....
Definition: DigitalIn.h:33
Defines a task for updating an instrument within an instrument inheritance hierarchy....
Definition: DigitalIn.h:53
void UpdateFuncImpl(dispatch_tag< InputPortTasks::UpdateTask >, DynExp::InstrumentInstance &Instance) override final
Updates the respective instrument within the instrument inheritance hierarchy. Call UpdateFuncImpl() ...
Definition: DigitalIn.h:54
virtual void UpdateFuncImpl(dispatch_tag< UpdateTask >, DynExp::InstrumentInstance &Instance)
Updates the respective instrument within the instrument inheritance hierarchy. Call UpdateFuncImpl() ...
Definition: DigitalIn.h:59
Meta instrument for a single digital input port based on the data stream and generic input port meta ...
Definition: DigitalIn.h:136
virtual std::string GetName() const override
Returns the name of this Object type.
Definition: DigitalIn.h:162
virtual DigitalInData::SampleStreamType::SampleType GetSync() const
Synchronized version of Get(), which blocks until a DataStreamInstrument::ReadData() task getting enq...
Definition: DigitalIn.cpp:23
virtual std::string GetCategory() const override
Returns the category of this Object type.
Definition: DigitalIn.h:163
virtual std::unique_ptr< DynExp::ExitTaskBase > MakeExitTask() const override
Factory function for an exit task (ExitTaskBase). Override to define the desired deinitialization tas...
Definition: DigitalIn.h:211
virtual ~DigitalIn()=0
Definition: DigitalIn.cpp:45
virtual NumericSampleStreamParamsExtension::ValueType GetNumericSampleStreamParams() const
Retrieves sample stream settings of the instrument's data stream from the instrument's or from the un...
Definition: DigitalIn.h:181
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...
Definition: DigitalIn.h:212
virtual void ResetImpl(dispatch_tag< DigitalIn >)=0
Refer to DynExp::Object::Reset(). Using tag dispatch mechanism to ensure that ResetImpl() of every de...
constexpr static auto Name() noexcept
Every derived class has to redefine this function.
Definition: DigitalIn.h:151
virtual DataStreamInstrumentData::ValueType GetHardwareResolution() const noexcept override final
Indicates the value's resolution the underlying hardware can record.
Definition: DigitalIn.h:172
virtual DataStreamInstrumentData::UnitType GetValueUnit() const noexcept override final
Determines which unit corresponds to the values managed by this DataStreamInstrument instance....
Definition: DigitalIn.h:173
virtual DigitalInData::SampleStreamType::SampleType Get(DynExp::TaskBase::CallbackType CallbackFunc=nullptr) const
Reads one sample from the sample stream. CallbackFunc gets called after the task DataStreamInstrument...
Definition: DigitalIn.cpp:13
DigitalIn(const std::thread::id OwnerThreadID, DynExp::ParamsBasePtrType &&Params)
Constructs an instrument instance.
Definition: DigitalIn.h:157
void ResetImpl(dispatch_tag< InputPort >) override final
Refer to DynExp::Object::Reset(). Using tag dispatch mechanism to ensure that ResetImpl() of every de...
Definition: DigitalIn.cpp:49
constexpr static auto Category() noexcept
Every derived class has to redefine this function.
Definition: DigitalIn.h:152
virtual DataStreamInstrumentData::ValueType GetHardwareMinValue() const noexcept override final
Indicates the minimal value the underlying hardware can record.
Definition: DigitalIn.h:170
virtual DataStreamInstrumentData::ValueType GetHardwareMaxValue() const noexcept override final
Indicates the maximal value the underlying hardware can record.
Definition: DigitalIn.h:171
virtual std::unique_ptr< DynExp::InitTaskBase > MakeInitTask() const override
Factory function for an init task (InitTaskBase). Override to define the desired initialization task ...
Definition: DigitalIn.h:210
Configurator class for InputPort.
Definition: InputPort.h:143
Data class for InputPort.
Definition: InputPort.h:98
Parameter class for InputPort.
Definition: InputPort.h:116
Defines a task for deinitializing an instrument within an instrument inheritance hierarchy....
Definition: InputPort.h:54
Defines a task for initializing an instrument within an instrument inheritance hierarchy....
Definition: InputPort.h:27
Defines a task for updating an instrument within an instrument inheritance hierarchy....
Definition: InputPort.h:67
Generic input port meta instrument based on the data stream meta instrument to read data from hardwar...
Definition: InputPort.h:157
Type containing the values of all the parameters belonging to NumericSampleStreamParamsExtension.
Implements a circular data stream based on Util::circularbuf using samples of an arithmetic type Samp...
DynExp's core class acts as the interface between the user interface and DynExp's internal data like ...
Definition: DynExpCore.h:127
Defines a task for deinitializing an instrument within an instrument inheritance hierarchy....
Definition: Instrument.h:1144
Refer to DynExp::ParamsBase::dispatch_tag.
Definition: Instrument.h:1151
Defines a task for initializing an instrument within an instrument inheritance hierarchy....
Definition: Instrument.h:1113
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
Dummy parameter which is to be owned once by parameter classes that do not contain any other paramete...
Definition: Object.h:522
const ItemIDType ID
ID of the Object this parameter class instance belongs to.
Definition: Object.h:1779
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
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
Defines a task for updating an instrument within an instrument inheritance hierarchy....
Definition: Instrument.h:1175
Refer to DynExp::ParamsBase::dispatch_tag.
Definition: Instrument.h:1182
DynExp's instrument namespace contains the implementation of DynExp instruments which extend DynExp's...
Definition: Instrument.h:1254
NumericSampleStream< uint8_t > DigitalSampleStream
Alias for a numeric sample stream of uint8_t (single byte) samples.
DataStreamPtrType< DataStreamBase > DataStreamBasePtrType
Type of a pointer owning a DataStreamBase instance.
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.