NDS3  1.0.0
API reference manual
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
nds::PVBase Class Reference

Detailed Description

Base class for objects that process a single PV (or attribute in Tango parlance).

In NDS you can define Input PVs (represented by the class PVBaseIn and its derivates) or Output PVs (represented by the class PVBaseOut and its derivates).

The data in the input records are written by the device support and read by the control system, while the output records are written by the control system and read by the device support.

#include <pvBase.h>

Inheritance diagram for nds::PVBase:
nds::Base nds::PVBaseIn nds::PVBaseOut nds::PVDelegateIn< T > nds::PVVariableIn< T > nds::PVAction nds::PVDelegateOut< T > nds::PVVariableOut< T >

Public Member Functions

void setDescription (const std::string &description)
 Set a human readable description of the PV. More...
 
void setUnits (const std::string &units)
 Set the engineering units of the PV. More...
 
void setInterfaceName (const std::string &interfaceName)
 Set the name of the PV as seen by the control system. More...
 
void setScanType (const scanType_t scanType, const double periodSeconds=1)
 Set how the PV value is retrieved by the control system. More...
 
void setMaxElements (const size_t maxElements)
 If the data type of the PV is a vector then set the maximum number of elements that the vector will contain. More...
 
void setEnumeration (const enumerationStrings_t &enumerations)
 If the data type is an integer then assigns a list of strings that enumerate the values (starting from zero). More...
 
void processAtInit (const bool bProcessAtInit)
 Specifies if the read() function of the PV should be called during the device initialization. More...
 
- Public Member Functions inherited from nds::Base
 Base (const Base &right)
 Copy constructor. The copy will refer to the same implementation object referenced in the copied object. More...
 
Baseoperator= (const Base &right)
 Copy operator. The copy will refer to the same implementation object referenced in the copied object. More...
 
void setExternalName (const std::string &externalName)
 Set the string to pass to the naming rules in order to build the full node name as seen by the control system. More...
 
virtual Port getPort ()
 Get the Node that communicate with the device (ASYN port on EPICS, Device on Tango). Query the parent nodes if necessary. More...
 
const std::string & getComponentName () const
 Return the node's name. More...
 
const std::string & getFullName () const
 Return the full node's name, prepending the parents' names if necessary (e.g. "ROOT-CHANNEL1-THISNODE") More...
 
const std::string & getFullExternalName () const
 Return the full node's name as seen by the control system clients. More...
 
const std::string & getFullNameFromPort () const
 Return the node's name as seen by the parent Port node (the node that communicates with the device). More...
 
timespec getTimestamp () const
 Get the current time. More...
 
void setTimestampDelegate (getTimestampPlugin_t timestampDelegate)
 Specify the delegate function to call to get the timestamp. More...
 
std::ostream & getLogger (const logLevel_t logLevel)
 Retrieve a logging stream for the specified log level. More...
 
bool isLogLevelEnabled (const logLevel_t logLevel) const
 Returns true if the logging for a particular severity level has been enabled. More...
 
void setLogLevel (const logLevel_t logLevel)
 Enable the logging for a particular severity level. More...
 
void defineCommand (const std::string &command, const std::string &usage, const size_t numParameters, const command_t function)
 Define a command specific for the node. More...
 
Thread runInThread (const std::string &name, threadFunction_t function)
 Create and run a thread using the control system facilities. More...
 
Thread runInThread (threadFunction_t function)
 Create and run a thread using the control system facilities. The created thread will have the node's name. More...
 

Additional Inherited Members

- Protected Member Functions inherited from nds::Base
 Base ()
 Initializes an empty base class.
 

Member Function Documentation

void nds::PVBase::processAtInit ( const bool  bProcessAtInit)

Specifies if the read() function of the PV should be called during the device initialization.

Parameters
bProcessAtInitif true the the PVBaseIn::read() or PVBaseOut::read() function of the PV should be called during the device initialization.
void nds::PVBase::setDescription ( const std::string &  description)

Set a human readable description of the PV.

Parameters
descriptionthe PV description
void nds::PVBase::setEnumeration ( const enumerationStrings_t enumerations)

If the data type is an integer then assigns a list of strings that enumerate the values (starting from zero).

Parameters
enumerationslist of strings that enumerate the PV's values
void nds::PVBase::setInterfaceName ( const std::string &  interfaceName)

Set the name of the PV as seen by the control system.

By default correspond to the name given in the constructor.

Parameters
interfaceNamethe name of the PV as seen by the control system
void nds::PVBase::setMaxElements ( const size_t  maxElements)

If the data type of the PV is a vector then set the maximum number of elements that the vector will contain.

Parameters
maxElementsthe maximum number of elements that the vector will contain
void nds::PVBase::setScanType ( const scanType_t  scanType,
const double  periodSeconds = 1 
)

Set how the PV value is retrieved by the control system.

Parameters
scanTypethe method used by the control system to retrieve the value
periodSecondsif the scanType is set to scanType_t::periodic then specifies the amount of seconds between the polling, otherwise it is ignored
void nds::PVBase::setUnits ( const std::string &  units)

Set the engineering units of the PV.

Parameters
unitsthe PV's engineering units

The documentation for this class was generated from the following file: