Class that demonstrates the use of the asynPortDriver base class to greatly simplify the task of writing an asyn port driver. More...

#include <testAsynPortDriver.h>

Inheritance diagram for testAsynPortDriver:

Public Member Functions
	testAsynPortDriver (const char *portName, int maxArraySize)
	Constructor for the testAsynPortDriver class. More...

virtual asynStatus	writeInt32 (asynUser *pasynUser, epicsInt32 value)
	Called when asyn clients call pasynInt32->write(). More...

virtual asynStatus	writeFloat64 (asynUser *pasynUser, epicsFloat64 value)
	Called when asyn clients call pasynFloat64->write(). More...

virtual asynStatus	readFloat64Array (asynUser pasynUser, epicsFloat64 value, size_t nElements, size_t *nIn)
	Called when asyn clients call pasynFloat64Array->read(). More...

virtual asynStatus	readEnum (asynUser pasynUser, char strings[], int values[], int severities[], size_t nElements, size_t *nIn)
	Called when asyn clients call pasynEnum->read(). More...

void	simTask (void)
	Simulation task that runs as a separate thread. More...

Public Member Functions inherited from asynPortDriver
	asynPortDriver (const char *portName, int maxAddr, int interfaceMask, int interruptMask, int asynFlags, int autoConnect, int priority, int stackSize)
	Constructor for the asynPortDriver class. More...

	asynPortDriver (const char *portName, int maxAddr, int paramTableSize, int interfaceMask, int interruptMask, int asynFlags, int autoConnect, int priority, int stackSize) EPICS_DEPRECATED
	Legacy constructor for the asynPortDriver class (DEPRECATED - please use the one above instead). More...

virtual	~asynPortDriver ()
	Destructor for asynPortDriver class; frees resources allocated when port driver is created. More...

virtual asynStatus	lock ()
	Locks the driver to prevent multiple threads from accessing memory at the same time. More...

virtual asynStatus	unlock ()
	Unlocks the driver; called when an asyn client or driver is done accessing common memory. More...

virtual asynStatus	getAddress (asynUser pasynUser, int address)
	Returns the asyn address associated with a pasynUser structure. More...

virtual asynStatus	readInt32 (asynUser pasynUser, epicsInt32 value)
	Called when asyn clients call pasynInt32->read(). More...

virtual asynStatus	readUInt32Digital (asynUser pasynUser, epicsUInt32 value, epicsUInt32 mask)
	Called when asyn clients call pasynUInt32Digital->read(). More...

virtual asynStatus	writeUInt32Digital (asynUser *pasynUser, epicsUInt32 value, epicsUInt32 mask)
	Called when asyn clients call pasynUInt32Digital->write(). More...

virtual asynStatus	setInterruptUInt32Digital (asynUser *pasynUser, epicsUInt32 mask, interruptReason reason)
	Called when asyn clients call pasynUInt32Digital->setInterrupt(). More...

virtual asynStatus	clearInterruptUInt32Digital (asynUser *pasynUser, epicsUInt32 mask)
	Called when asyn clients call pasynUInt32Digital->clearInterrupt(). More...

virtual asynStatus	getInterruptUInt32Digital (asynUser pasynUser, epicsUInt32 mask, interruptReason reason)
	Called when asyn clients call pasynUInt32Digital->getInterrupt(). More...

virtual asynStatus	getBounds (asynUser pasynUser, epicsInt32 low, epicsInt32 *high)
	Called when asyn clients call pasynInt32->getBounds(), returning the bounds on the asynInt32 interface for drivers that use raw units. More...

virtual asynStatus	readFloat64 (asynUser pasynUser, epicsFloat64 value)
	Called when asyn clients call pasynFloat64->read(). More...

virtual asynStatus	readOctet (asynUser pasynUser, char value, size_t maxChars, size_t nActual, int eomReason)
	Called when asyn clients call pasynOctet->read(). More...

virtual asynStatus	writeOctet (asynUser pasynUser, const char value, size_t maxChars, size_t *nActual)
	Called when asyn clients call pasynOctet->write(). More...

virtual asynStatus	flushOctet (asynUser *pasynUser)
	Called when asyn clients call pasynOctet->flush(). More...

virtual asynStatus	setInputEosOctet (asynUser pasynUser, const char eos, int eosLen)
	Called when asyn clients call pasynOctet->setInputEos(). More...

virtual asynStatus	getInputEosOctet (asynUser pasynUser, char eos, int eosSize, int *eosLen)
	Called when asyn clients call pasynOctet->getInputEos(). More...

virtual asynStatus	setOutputEosOctet (asynUser pasynUser, const char eos, int eosLen)
	Called when asyn clients call pasynOctet->setOutputEos(). More...

virtual asynStatus	getOutputEosOctet (asynUser pasynUser, char eos, int eosSize, int *eosLen)
	Called when asyn clients call pasynOctet->getOutputEos(). More...

virtual asynStatus	readInt8Array (asynUser pasynUser, epicsInt8 value, size_t nElements, size_t *nIn)
	Called when asyn clients call pasynInt8Array->read(). More...

virtual asynStatus	writeInt8Array (asynUser pasynUser, epicsInt8 value, size_t nElements)
	Called when asyn clients call pasynInt8Array->write(). More...

virtual asynStatus	doCallbacksInt8Array (epicsInt8 *value, size_t nElements, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynInt8Array interface. More...

virtual asynStatus	readInt16Array (asynUser pasynUser, epicsInt16 value, size_t nElements, size_t *nIn)
	Called when asyn clients call pasynInt16Array->read(). More...

virtual asynStatus	writeInt16Array (asynUser pasynUser, epicsInt16 value, size_t nElements)
	Called when asyn clients call pasynInt16Array->write(). More...

virtual asynStatus	doCallbacksInt16Array (epicsInt16 *value, size_t nElements, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynInt16Array interface. More...

virtual asynStatus	readInt32Array (asynUser pasynUser, epicsInt32 value, size_t nElements, size_t *nIn)
	Called when asyn clients call pasynInt32Array->read(). More...

virtual asynStatus	writeInt32Array (asynUser pasynUser, epicsInt32 value, size_t nElements)
	Called when asyn clients call pasynInt32Array->write(). More...

virtual asynStatus	doCallbacksInt32Array (epicsInt32 *value, size_t nElements, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynInt32Array interface. More...

virtual asynStatus	readFloat32Array (asynUser pasynUser, epicsFloat32 value, size_t nElements, size_t *nIn)
	Called when asyn clients call pasynFloat32Array->read(). More...

virtual asynStatus	writeFloat32Array (asynUser pasynUser, epicsFloat32 value, size_t nElements)
	Called when asyn clients call pasynFloat32Array->write(). More...

virtual asynStatus	doCallbacksFloat32Array (epicsFloat32 *value, size_t nElements, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynFloat32Array interface. More...

virtual asynStatus	writeFloat64Array (asynUser pasynUser, epicsFloat64 value, size_t nElements)
	Called when asyn clients call pasynFloat64Array->write(). More...

virtual asynStatus	doCallbacksFloat64Array (epicsFloat64 *value, size_t nElements, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynFloat64Array interface. More...

virtual asynStatus	readGenericPointer (asynUser pasynUser, void pointer)
	Called when asyn clients call pasynGenericPointer->read(). More...

virtual asynStatus	writeGenericPointer (asynUser pasynUser, void pointer)
	Called when asyn clients call pasynGenericPointer->write(). More...

virtual asynStatus	doCallbacksGenericPointer (void *pointer, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynGenericPointer interface. More...

virtual asynStatus	readOption (asynUser pasynUser, const char key, char *value, int maxChars)
	Called when asyn clients call pasynOption->read(). More...

virtual asynStatus	writeOption (asynUser pasynUser, const char key, const char *value)
	Called when asyn clients call pasynOption->write(). More...

virtual asynStatus	writeEnum (asynUser pasynUser, char strings[], int values[], int severities[], size_t nElements)
	Called when asyn clients call pasynEnum->write(). More...

virtual asynStatus	doCallbacksEnum (char *strings[], int values[], int severities[], size_t nElements, int reason, int addr)
	Called by driver to do the callbacks to registered clients on the asynEnum interface. More...

virtual asynStatus	drvUserCreate (asynUser pasynUser, const char drvInfo, const char *pptypeName, size_t psize)
	Called by asynManager to pass a pasynUser structure and drvInfo string to the driver; Assigns pasynUser->reason based on the value of the drvInfo string. More...

virtual asynStatus	drvUserGetType (asynUser pasynUser, const char pptypeName, size_t psize)
	Returns strings associated with driver-specific commands. More...

virtual asynStatus	drvUserDestroy (asynUser *pasynUser)
	Frees any resources allocated by drvUserCreate. More...

virtual void	report (FILE *fp, int details)
	Reports on status of the driver. More...

virtual asynStatus	connect (asynUser *pasynUser)
	Connects driver to device; The base class implementation simply calls pasynManager->exceptionConnect if address is valid Derived classes can reimplement this function for real connection management. More...

virtual asynStatus	disconnect (asynUser *pasynUser)
	Disconnects driver from device; the base class implementation simply calls pasynManager->exceptionDisconnect. More...

virtual asynStatus	createParam (const char name, asynParamType type, int index)
	Creates a parameter in the parameter library. More...

virtual asynStatus	createParam (int list, const char name, asynParamType type, int index)
	Creates a parameter in the parameter library. More...

virtual asynStatus	findParam (const char name, int index)
	Finds a parameter in the parameter library. More...

virtual asynStatus	findParam (int list, const char name, int index)
	Finds a parameter in the parameter library. More...

virtual asynStatus	getParamName (int index, const char **name)
	Returns the name of a parameter in the parameter library. More...

virtual asynStatus	getParamName (int list, int index, const char **name)
	Returns the name of a parameter in the parameter library. More...

virtual asynStatus	getParamType (int index, asynParamType *type)
	Returns the asynParamType of a parameter in the parameter library*. More...

virtual asynStatus	getParamType (int list, int index, asynParamType *type)
	Returns the asynParamType of a parameter in the parameter library. More...

virtual asynStatus	setParamStatus (int index, asynStatus status)
	Sets the status for a parameter in the parameter library. More...

virtual asynStatus	setParamStatus (int list, int index, asynStatus status)
	Sets the status for a parameter in the parameter library. More...

virtual asynStatus	getParamStatus (int index, asynStatus *status)
	Gets the status for a parameter in the parameter library. More...

virtual asynStatus	getParamStatus (int list, int index, asynStatus *status)
	Gets the status for a parameter in the parameter library. More...

virtual asynStatus	setParamAlarmStatus (int index, int status)
	Sets the alarmStatus for a parameter in the parameter library. More...

virtual asynStatus	setParamAlarmStatus (int list, int index, int status)
	Sets the alarmStatus for a parameter in the parameter library. More...

virtual asynStatus	getParamAlarmStatus (int index, int *status)
	Gets the alarmStatus for a parameter in the parameter library. More...

virtual asynStatus	getParamAlarmStatus (int list, int index, int *status)
	Gets the alarmStatus for a parameter in the parameter library. More...

virtual asynStatus	setParamAlarmSeverity (int index, int severity)
	Sets the alarmSeverity for a parameter in the parameter library. More...

virtual asynStatus	setParamAlarmSeverity (int list, int index, int severity)
	Sets the alarmSeverity for a parameter in the parameter library. More...

virtual asynStatus	getParamAlarmSeverity (int index, int *severity)
	Gets the alarmSeverity for a parameter in the parameter library. More...

virtual asynStatus	getParamAlarmSeverity (int list, int index, int *severity)
	Gets the alarmSeverity for a parameter in the parameter library. More...

virtual void	reportSetParamErrors (asynStatus status, int index, int list, const char *functionName)
	Reports errors when setting parameters. More...

virtual void	reportGetParamErrors (asynStatus status, int index, int list, const char *functionName)
	Reports errors when getting parameters. More...

virtual asynStatus	setIntegerParam (int index, int value)
	Sets the value for an integer in the parameter library. More...

virtual asynStatus	setIntegerParam (int list, int index, int value)
	Sets the value for an integer in the parameter library. More...

virtual asynStatus	setUIntDigitalParam (int index, epicsUInt32 value, epicsUInt32 valueMask)
	Sets the value for a UInt32Digital in the parameter library. More...

virtual asynStatus	setUIntDigitalParam (int list, int index, epicsUInt32 value, epicsUInt32 valueMask)
	Sets the value for a UInt32Digital in the parameter library. More...

virtual asynStatus	setUIntDigitalParam (int index, epicsUInt32 value, epicsUInt32 valueMask, epicsUInt32 interruptMask)
	Sets the value for a UInt32Digital in the parameter library. More...

virtual asynStatus	setUIntDigitalParam (int list, int index, epicsUInt32 value, epicsUInt32 valueMask, epicsUInt32 interruptMask)
	Sets the value for a UInt32Digital in the parameter library. More...

virtual asynStatus	setUInt32DigitalInterrupt (int index, epicsUInt32 mask, interruptReason reason)
	Sets the interrupt mask and reason in the parameter library Calls paramList::setUInt32Interrupt (0, index, mask, reason) i.e. More...

virtual asynStatus	setUInt32DigitalInterrupt (int list, int index, epicsUInt32 mask, interruptReason reason)
	Sets the interrupt mask and reason in the parameter library Calls paramList::setUInt32Interrupt (index, mask, reason) for the parameter list indexed by list. More...

virtual asynStatus	clearUInt32DigitalInterrupt (int index, epicsUInt32 mask)
	Clears the interrupt mask in the parameter library Calls paramList::clearUInt32Interrupt (0, index, mask) i.e. More...

virtual asynStatus	clearUInt32DigitalInterrupt (int list, int index, epicsUInt32 mask)
	Clears the interrupt mask in the parameter library Calls paramList::clearUInt32Interrupt (index, mask) for the parameter list indexed by list. More...

virtual asynStatus	getUInt32DigitalInterrupt (int index, epicsUInt32 *mask, interruptReason reason)
	Gets the interrupt mask and reason in the parameter library Calls paramList::getUInt32Interrupt (0, index, mask, reason) i.e. More...

virtual asynStatus	getUInt32DigitalInterrupt (int list, int index, epicsUInt32 *mask, interruptReason reason)
	Gets the interrupt mask and reason in the parameter library Calls paramList::getUInt32Interrupt (index, mask, reason) for the parameter list indexed by list. More...

virtual asynStatus	setDoubleParam (int index, double value)
	Sets the value for a double in the parameter library. More...

virtual asynStatus	setDoubleParam (int list, int index, double value)
	Sets the value for a double in the parameter library. More...

virtual asynStatus	setStringParam (int index, const char *value)
	Sets the value for a string in the parameter library. More...

virtual asynStatus	setStringParam (int list, int index, const char *value)
	Sets the value for a string in the parameter library. More...

virtual asynStatus	setStringParam (int index, const std::string &value)
	Sets the value for a string in the parameter library. More...

virtual asynStatus	setStringParam (int list, int index, const std::string &value)
	Sets the value for a string in the parameter library. More...

virtual asynStatus	getIntegerParam (int index, epicsInt32 *value)
	Returns the value for an integer from the parameter library. More...

virtual asynStatus	getIntegerParam (int list, int index, epicsInt32 *value)
	Returns the value for an integer from the parameter library. More...

virtual asynStatus	getUIntDigitalParam (int index, epicsUInt32 *value, epicsUInt32 mask)
	Returns the value for an UInt32Digital parameter from the parameter library. More...

virtual asynStatus	getUIntDigitalParam (int list, int index, epicsUInt32 *value, epicsUInt32 mask)
	Returns the value for an UInt32Digital parameter from the parameter library. More...

virtual asynStatus	getDoubleParam (int index, double *value)
	Returns the value for a double from the parameter library. More...

virtual asynStatus	getDoubleParam (int list, int index, double *value)
	Returns the value for a double from the parameter library. More...

virtual asynStatus	getStringParam (int index, int maxChars, char *value)
	Returns the value for a string from the parameter library. More...

virtual asynStatus	getStringParam (int list, int index, int maxChars, char *value)
	Returns the value for a string from the parameter library. More...

virtual asynStatus	getStringParam (int index, std::string &value)
	Returns the value for a string from the parameter library. More...

virtual asynStatus	getStringParam (int list, int index, std::string &value)
	Returns the value for a string from the parameter library. More...

virtual asynStatus	callParamCallbacks ()
	Calls callParamCallbacks(0, 0) i.e. More...

virtual asynStatus	callParamCallbacks (int addr)
	Calls callParamCallbacks(addr, addr) i.e. More...

virtual asynStatus	callParamCallbacks (int list, int addr)
	Calls paramList::callCallbacks(addr) for a specific parameter list. More...

virtual asynStatus	updateTimeStamp ()
	Updates the timestamp for this port in pasynManager. More...

virtual asynStatus	updateTimeStamp (epicsTimeStamp *pTimeStamp)
	Updates the timestamp for this port in pasynManager, and returns this timestamp. More...

virtual asynStatus	getTimeStamp (epicsTimeStamp *pTimeStamp)
	Gets the most recent timestamp for this port from pasynManager. More...

virtual asynStatus	setTimeStamp (const epicsTimeStamp *pTimeStamp)
	Sets the timestamp for this port in pasynManager. More...

asynStandardInterfaces *	getAsynStdInterfaces ()
	Returns the asynStdInterfaces structure used by asynPortDriver. More...

virtual void	reportParams (FILE *fp, int details)
	Calls paramList::report(fp, details) for each parameter list that the driver supports. More...

void	callbackTask ()

Protected Attributes
int	P_Run
	Values used for pasynUser->reason, and indexes into the parameter library. More...

int	P_MaxPoints

int	P_TimePerDiv

int	P_TimePerDivSelect

int	P_VertGain

int	P_VertGainSelect

int	P_VoltsPerDiv

int	P_VoltsPerDivSelect

int	P_VoltOffset

int	P_TriggerDelay

int	P_NoiseAmplitude

int	P_UpdateTime

int	P_Waveform

int	P_TimeBase

int	P_MinValue

int	P_MaxValue

int	P_MeanValue

Protected Attributes inherited from asynPortDriver
asynUser *	pasynUserSelf
	asynUser connected to ourselves for asynTrace More...

asynStandardInterfaces	asynStdInterfaces
	The asyn interfaces this driver implements. More...

Additional Inherited Members
Public Attributes inherited from asynPortDriver
char *	portName
	The name of this asyn port. More...

int	maxAddr
	The maximum asyn address (addr) supported by this driver. More...

Protected Member Functions inherited from asynPortDriver
void	initialize (const char *portNameIn, int maxAddrIn, int interfaceMask, int interruptMask, int asynFlags, int autoConnect, int priority, int stackSize)
	The following function is required to initialize from two constructors. More...

Detailed Description

Class that demonstrates the use of the asynPortDriver base class to greatly simplify the task of writing an asyn port driver.

This class does a simple simulation of a digital oscilloscope. It computes a waveform, computes statistics on the waveform, and does callbacks with the statistics and the waveform data itself. I have made the methods of this class public in order to generate doxygen documentation for them, but they should really all be private.

Constructor & Destructor Documentation

testAsynPortDriver::testAsynPortDriver	(	const char *	portName,
		int	maxPoints
	)

Constructor for the testAsynPortDriver class.

Calls constructor for the asynPortDriver base class.

Parameters

[in]	portName	The name of the asyn port driver to be created.
[in]	maxPoints	The maximum number of points in the volt and time arrays

Member Function Documentation

asynStatus testAsynPortDriver::readEnum	(	asynUser *	pasynUser,
		char *	strings[],
		int	values[],
		int	severities[],
		size_t	nElements,
		size_t *	nIn
	)

virtual

Called when asyn clients call pasynEnum->read().

The base class implementation simply prints an error message. Derived classes may reimplement this function if required.

Parameters

[in]	pasynUser	pasynUser structure that encodes the reason and address.
[in]	strings	Array of string pointers.
[in]	values	Array of values
[in]	severities	Array of severities
[in]	nElements	Size of value array
[out]	nIn	Number of elements actually returned

Reimplemented from asynPortDriver.

asynStatus testAsynPortDriver::readFloat64Array	(	asynUser *	pasynUser,
		epicsFloat64 *	value,
		size_t	nElements,
		size_t *	nIn
	)

virtual

Called when asyn clients call pasynFloat64Array->read().

Returns the value of the P_Waveform or P_TimeBase arrays.

Parameters

[in]	pasynUser	pasynUser structure that encodes the reason and address.
[in]	value	Pointer to the array to read.
[in]	nElements	Number of elements to read.
[out]	nIn	Number of elements actually read.

Reimplemented from asynPortDriver.

void testAsynPortDriver::simTask ( void )

Simulation task that runs as a separate thread.

When the P_Run parameter is set to 1 to rub the simulation it computes a 1 kHz sine wave with 1V amplitude and user-controllable noise, and displays it on a simulated scope. It computes waveforms for the X (time) and Y (volt) axes, and computes statistics about the waveform.

asynStatus testAsynPortDriver::writeFloat64	(	asynUser *	pasynUser,
		epicsFloat64	value
	)

virtual

Called when asyn clients call pasynFloat64->write().

This function sends a signal to the simTask thread if the value of P_UpdateTime has changed. For all parameters it sets the value in the parameter library and calls any registered callbacks.

Parameters

[in]	pasynUser	pasynUser structure that encodes the reason and address.
[in]	value	Value to write.

Reimplemented from asynPortDriver.

asynStatus testAsynPortDriver::writeInt32	(	asynUser *	pasynUser,
		epicsInt32	value
	)

virtual

Called when asyn clients call pasynInt32->write().

This function sends a signal to the simTask thread if the value of P_Run has changed. For all parameters it sets the value in the parameter library and calls any registered callbacks..

Parameters

[in]	pasynUser	pasynUser structure that encodes the reason and address.
[in]	value	Value to write.

Reimplemented from asynPortDriver.

Member Data Documentation

int testAsynPortDriver::P_MaxPoints

protected

int testAsynPortDriver::P_MaxValue

protected

int testAsynPortDriver::P_MeanValue

protected

int testAsynPortDriver::P_MinValue

protected

int testAsynPortDriver::P_NoiseAmplitude

protected

int testAsynPortDriver::P_Run

protected

Values used for pasynUser->reason, and indexes into the parameter library.

int testAsynPortDriver::P_TimeBase

protected

int testAsynPortDriver::P_TimePerDiv

protected

int testAsynPortDriver::P_TimePerDivSelect

protected

int testAsynPortDriver::P_TriggerDelay

protected

int testAsynPortDriver::P_UpdateTime

protected

int testAsynPortDriver::P_VertGain

protected

int testAsynPortDriver::P_VertGainSelect

protected

int testAsynPortDriver::P_VoltOffset

protected

int testAsynPortDriver::P_VoltsPerDiv

protected

int testAsynPortDriver::P_VoltsPerDivSelect

protected

int testAsynPortDriver::P_Waveform

protected

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

/home/epics/devel/asyn-R4-33/testAsynPortDriverApp/src/testAsynPortDriver.h
/home/epics/devel/asyn-R4-33/testAsynPortDriverApp/src/testAsynPortDriver.cpp

Public Member Functions

Protected Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation