cinosdacchannels.h

Go to the documentation of this file.

//******************************************************************************
//******************************************************************************
 
#ifndef INC_CINOSDACCHANNELS_H
#define INC_CINOSDACCHANNELS_H
 
//------------------------------------------------------------------------------
// defines
//------------------------------------------------------------------------------
//
#define DF_INOS_IMAGE_ANALOG_OUTPUTS_NUMBER DF_INOS_PROCESSIMAGE_ANALOG_OUTPUTS_NUMBER  // def. number of ana outputs
//
#define DF_INOS_DAC_RANGE_BIP_10000mV       0   // dac range number +-10000 mV
#define DF_INOS_DAC_RANGE_BIP_1000mV        1   // dac range number +-1000 mV
#define DF_INOS_DAC_RANGE_BIP_100mV         2   // dac range number +-100 mV
#define DF_INOS_DAC_RANGE_BIP_10mV          3   // dac range number +-10 mV
#define DF_INOS_DAC_RANGE_UNI_10000mV       4   // dac range number 0..+10000 mV
#define DF_INOS_DAC_RANGE_UNI_1000mV        5   // dac range number 0..+1000 mV
#define DF_INOS_DAC_RANGE_UNI_100mV         6   // dac range number 0..+100 mV
#define DF_INOS_DAC_RANGE_UNI_10mV          7   // dac range number 0..+10 mV
//
#define DF_INOS_DAC_RANGE_BIP_5000mV        8   // dac range number +-5000 mV
#define DF_INOS_DAC_RANGE_BIP_500mV         9   // dac range number +-500 mV
#define DF_INOS_DAC_RANGE_BIP_50mV          10  // dac range number +-50 mV
#define DF_INOS_DAC_RANGE_BIP_5mV           11  // dac range number +-5 mV
#define DF_INOS_DAC_RANGE_UNI_5000mV        12  // dac range number 0..+5000 mV
#define DF_INOS_DAC_RANGE_UNI_500mV         13  // dac range number 0..+500 mV
#define DF_INOS_DAC_RANGE_UNI_50mV          14  // dac range number 0..+50 mV
#define DF_INOS_DAC_RANGE_UNI_5mV           15  // dac range number 0..+5 mV
//
#define DF_INOS_DAC_RANGE_UNI_20mA          32  // dac range number 0..+20mA
//
#define DF_INOS_DAC_RANGE_BIP_48000mV       128 // dac range number +-48000 mV
 
#define DF_INOS_DAC_RANGE_DISABLED          255 // dac disabled
//
//------------------------------------------------------------------------------
// includes
//------------------------------------------------------------------------------
//
// system
//
// C++
//
// project
//
//------------------------------------------------------------------------------
// class definition
//------------------------------------------------------------------------------
//
class CINOSDacChannels : public CINOSProcessImageValues
{
    //--- user interface ---------------------------------------------------
 
    // public member functions
    public :
        ICACHE virtual void Set(uint16 auNumber, real64 arValue) override;
            //; set channel 'auNumber' to arValue
        ICACHE virtual real64 Get(uint16 auNumber) override;
            //; get value of channel 'auNumber'
        ICACHE real64 GetValue(uint16 auNumber);
            //; return value of channel auNumber (mV, °C, ...) [real32]
        ICACHE real64 GetValue64(uint16 auNumber);
            //; return value of channel auNumber (mV, °C, ...) [real64]
        #if defined(INOS_PROCESSIMAGE_OVERWRITE)
        ICACHE void SetValue(uint16 auNumber, real64 arValue, bool abOverwrite = false);
            //; set value of channel auNumber to afValue
            //; (abOverwrite=true -> value always set, abOverwrite=false -> value
            //; set if channel is NOT in overwrite mode)
        ICACHE void SetValue64(uint16 auNumber, real64 arValue, bool abOverwrite = false);
            //; set value of channel auNumber to arValue
            //; (abOverwrite=true -> value always set, abOverwrite=false -> value
            //; set if channel is NOT in overwrite mode)
        #else
        ICACHE void SetValue(uint16 auNumber, real64 arValue);
            //; set value of channel auNumber to afValue
        ICACHE void SetValue64(uint16 auNumber, real64 arValue);
            //; set value of channel auNumber to arValue
        #endif
        real32 GetRawValue(uint16 auNumber, uint32 auStage=0);
            //; return raw value of channel auNumber before hook number 'auStage'
        CINOSDacChannel* Find(const char* apName,
            uint32 auSimulate = DF_INOS_IMAGE_CHN_SIM_DEF);
            //; return pointer to channel with apName or NULL if not found
        CINOSDacChannel* Find(uint16 auNumber,
            uint32 auSimulate = DF_INOS_IMAGE_CHN_SIM_DEF);
            //; return pointer to channel with auNumber or NULL if not found
        void SetRange(uint16 auNumber, uint8 auRange);
            //; set channel range
        uint8 GetRange(uint16 auNumber);
            //; get channel range
 
        CINOSDacChannel* CreateVirtual(const char* apName,
            uint16 auType   = defType_double,
            real64 arLower  = REAL64MIN,
            real64 arUpper  = REAL64MAX,
            char* apUnit    = nullptr,
            uint16 auCharacteristics = defCharShowFix + SHOW_DIGIT(4)
        );
            //; creates a new DAC channel that does not directly translate to hardware
            //; useful to add custom channels to the process image
 
    //--- internals --------------------------------------------------------
 
    // constructor / destructor
    public :
        CINOSDacChannels (char* apName, uint32 auNumber, void* apImage);
            //; object constructor
 
    // public member functions but just for internal use
    public:
        static void Create();
            //; check if process image already exists, if no create one
};
 
//
//------------------------------------------------------------------------------
// global variables
//------------------------------------------------------------------------------
//
#define g_pDacChannels ((CINOSDacChannels *) g_pImage[DF_PROCESS_IMAGE_ANALOG_OUTPUTS])
//
//------------------------------------------------------------------------------
// end of file
//------------------------------------------------------------------------------
 
#endif  // INC_CINOSDACCHANNELS_H