DynExp
Highly flexible laboratory automation for dynamically changing experiments.
Loading...
Searching...
No Matches
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
14namespace DynExpInstr
15{
16 class DigitalIn;
17
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:
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
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;
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
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
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 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
static constexpr auto Category() noexcept
Every derived class has to redefine this function.
Definition DigitalIn.h:152
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
static constexpr auto Name() noexcept
Every derived class has to redefine this function.
Definition DigitalIn.h:151
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 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...
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
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
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
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
Refer to DynExp::ParamsBase::dispatch_tag.
Refer to DynExp::ParamsBase::dispatch_tag.
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
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
Refer to DynExp::ParamsBase::dispatch_tag.
DynExp's instrument namespace contains the implementation of DynExp instruments which extend DynExp's...
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.