|
EPICS Base
7.0.6.1
|
|
EPICS Base
7.0.6.1
|
Link Support Entry Table. More...
#include <dbLink.h>
Public Attributes | |
| const unsigned | isConstant:1 |
| link constancy More... | |
| const unsigned | isVolatile:1 |
| link volatility More... | |
| void(* | openLink )(struct link *plink) |
| activate link More... | |
| void(* | removeLink )(struct dbLocker *locker, struct link *plink) |
| deactivate link More... | |
| long(* | loadScalar )(struct link *plink, short dbrType, void *pbuffer) |
| load constant scalar from link type More... | |
| long(* | loadLS )(struct link *plink, char *pbuffer, epicsUInt32 size, epicsUInt32 *plen) |
| load constant long string from link type More... | |
| long(* | loadArray )(struct link *plink, short dbrType, void *pbuffer, long *pnRequest) |
| load constant array from link type More... | |
| int(* | isConnected )(const struct link *plink) |
| return link connection status More... | |
| int(* | getDBFtype )(const struct link *plink) |
| get data type of link destination More... | |
| long(* | getElements )(const struct link *plink, long *pnElements) |
| get array size of an input link More... | |
| long(* | getValue )(struct link *plink, short dbrType, void *pbuffer, long *pnRequest) |
| get value from an input link More... | |
| long(* | getControlLimits )(const struct link *plink, double *lo, double *hi) |
| get the control range for an output link More... | |
| long(* | getGraphicLimits )(const struct link *plink, double *lo, double *hi) |
| get the display range from an input link More... | |
| long(* | getAlarmLimits )(const struct link *plink, double *lolo, double *lo, double *hi, double *hihi) |
| get the alarm limits from an input link More... | |
| long(* | getPrecision )(const struct link *plink, short *precision) |
| get the precision from an input link More... | |
| long(* | getUnits )(const struct link *plink, char *units, int unitsSize) |
| get the units string from an input link More... | |
| long(* | getAlarm )(const struct link *plink, epicsEnum16 *status, epicsEnum16 *severity) |
| get the alarm condition from an input link More... | |
| long(* | getTimeStamp )(const struct link *plink, epicsTimeStamp *pstamp) |
| get the time-stamp from an input link More... | |
| long(* | putValue )(struct link *plink, short dbrType, const void *pbuffer, long nRequest) |
| put a value to an output link More... | |
| long(* | putAsync )(struct link *plink, short dbrType, const void *pbuffer, long nRequest) |
| put a value to an output link with asynchronous completion More... | |
| void(* | scanForward )(struct link *plink) |
| trigger processing of a forward link More... | |
| long(* | doLocked )(struct link *plink, dbLinkUserCallback rtn, void *priv) |
| execute a callback routine with link locked More... | |
| long(* | getAlarmMsg )(const struct link *plink, epicsEnum16 *status, epicsEnum16 *severity, char *msgbuf, size_t msgbuflen) |
| Extended version of getAlarm. More... | |
| long(* | getTimeStampTag )(const struct link *plink, epicsTimeStamp *pstamp, epicsUTag *ptag) |
| Extended version of getTimeStamp. More... | |
This structure provides information about and methods for an individual link type. A pointer to this structure is included in every link's lset field, and is used to perform operations on the link. For JSON links the pointer is obtained by calling pjlink->pif->get_lset() at link initialization time, immediately before calling dbLinkOpen() to activate the link.
| const unsigned lset::isConstant |
| const unsigned lset::isVolatile |
| void(* lset::openLink)(struct link *plink) |
| void(* lset::removeLink)(struct dbLocker *locker, struct link *plink) |
| long(* lset::loadScalar)(struct link *plink, short dbrType, void *pbuffer) |
Usually called during IOC initialization, constant link types must copy a scalar value of the indicated data type to the buffer provided and return 0. A non-constant link type can use this method call as an early hint that subsequent calls to dbGetLink() will request scalar data of the indicated type, although the type might change.
| plink | the link |
| dbrType | data type code |
| pbuffer | where to put the value |
| long(* lset::loadLS)(struct link *plink, char *pbuffer, epicsUInt32 size, epicsUInt32 *plen) |
Usually called during IOC initialization, constant link types must copy a nil-terminated string up to size characters long to the buffer provided, and write the length of that string to the plen location. A non-constant link type can use this as an early hint that subsequent calls to dbGetLink() will request long string data, although this might change.
| plink | the link |
| pbuffer | where to put the string |
| size | length of pbuffer in chars |
| plen | set to number of chars written |
| long(* lset::loadArray)(struct link *plink, short dbrType, void *pbuffer, long *pnRequest) |
Usually called during IOC initialization, constant link types must copy an array value of the indicated data type to the buffer provided, update the pnRequest location to indicate how many elements were loaded, and return 0. A non-constant link type can use this method call as an early hint that subsequent calls to dbGetLink() will request array data of the indicated type and max size, although the request might change.
| plink | the link |
| dbrType | data type code |
| pbuffer | where to put the value |
| pnRequest | Max elements on entry, actual on exit |
| int(* lset::isConnected)(const struct link *plink) |
Return an indication whether this link is connected or not. This routine is polled by the calcout and some external record types. Not required for non-volatile link types, which are by definition always connected.
| plink | the link |
| int(* lset::getDBFtype)(const struct link *plink) |
Called on both input and output links by long string support code to decide whether to use DBR_CHAR/DBR_UCHAR or DBR_STRING for a subsequent dbPutLink() or dbGetLink() call. Optional, but if not provided long strings cannot be transported over this link type, and no warning or error will appear to explain why. Not required for constant link types.
| plink | the link |
| long(* lset::getElements)(const struct link *plink, long *pnElements) |
| long(* lset::getValue)(struct link *plink, short dbrType, void *pbuffer, long *pnRequest) |
Called to fetch data from the link, which must be converted into the given data type and placed in the buffer indicated. The actual number of elements retrieved should be updated in the pnRequest location. If this method returns an error status value, the link's record will be placed into an Invalid severity / Link Alarm state by the dbGetLink() routine that calls this method.
| plink | the link |
| dbrType | data type code |
| pbuffer | where to put the value |
| pnRequest | max elements on entry, actual on exit |
| long(* lset::getControlLimits)(const struct link *plink, double *lo, double *hi) |
Called to fetch the control range for the link target, as a pair of double values for the lowest and highest values that the target will accept. This method is not used at all by the IOC or built-in record types, although external record types may require it.
| plink | the link |
| lo | lowest accepted value |
| hi | highest accepted value |
| long(* lset::getGraphicLimits)(const struct link *plink, double *lo, double *hi) |
Called to fetch the display range for an input link target, as a pair of double values for the lowest and highest values that the PV expects to return. This method is used by several built-in record types to obtain the display range for their generic input links.
| plink | the link |
| lo | lowest accepted value |
| hi | highest accepted value |
| long(* lset::getAlarmLimits)(const struct link *plink, double *lolo, double *lo, double *hi, double *hihi) |
Called to fetch the alarm limits for an input link target, as four double values for the warning and alarm levels that the PV checks its value against. This method is used by several built-in record types to obtain the alarm limits for their generic input links.
| plink | the link |
| lolo | low alarm value |
| lo | low warning value |
| hi | high warning value |
| hihi | high alarm value |
| long(* lset::getPrecision)(const struct link *plink, short *precision) |
| long(* lset::getUnits)(const struct link *plink, char *units, int unitsSize) |
Called to fetch the units string for an input link target. This method is used by several built-in record types to obtain the units string for their generic input links.
| plink | the link |
| units | where to put the answer |
| unitsSize | buffer size for the answer |
| long(* lset::getAlarm)(const struct link *plink, epicsEnum16 *status, epicsEnum16 *severity) |
Called to fetch the alarm status and severity for an input link target. Either status or severity pointers may be NULL when that value is not needed by the calling code. This method is used by several built-in record types to obtain the alarm condition for their generic input links.
| plink | the link |
| status | where to put the alarm status (or NULL) |
| severity | where to put the severity (or NULL) |
| long(* lset::getTimeStamp)(const struct link *plink, epicsTimeStamp *pstamp) |
| long(* lset::putValue)(struct link *plink, short dbrType, const void *pbuffer, long nRequest) |
| long(* lset::putAsync)(struct link *plink, short dbrType, const void *pbuffer, long nRequest) |
Called to send nRequest elements of type dbrType found at pbuffer to an output link target. If the return status is zero, the link type will later indicate the put has completed by calling dbLinkAsyncComplete() from a background thread, which will be used to continue the record process operation from where it left off.
| plink | the link |
| dbrType | data type code |
| pbuffer | where to put the value |
| nRequest | number of elements to send |
| void(* lset::scanForward)(struct link *plink) |
Called to trigger processing of the record pointed to by a forward link. This routine is optional, but if not provided no warning message will be shown when called by dbScanFwdLink(). JSON link types that do not support this operation should return NULL from their jlif::alloc_jlink() method if it gets called with a dbfType of DBF_FWDLINK.
| plink | the link |
| long(* lset::doLocked)(struct link *plink, dbLinkUserCallback rtn, void *priv) |
Called on an input link when multiple link attributes need to be fetched in an atomic fashion. The link type must call the callback routine and prevent any background I/O from updating any cached link data until that routine returns. This method is used by most input device support to fetch the timestamp along with the value when the record's TSE field is set to epicsTimeEventDeviceTime.
| plink | the link |
| rtn | routine to execute |
| long(* lset::getAlarmMsg)(const struct link *plink, epicsEnum16 *status, epicsEnum16 *severity, char *msgbuf, size_t msgbuflen) |
Equivalent of getAlarm() and also copy out alarm message string. The msgbuf argument may be NULL and/or msgbuflen==0, in which case the effect must be the same as a call to getAlarm().
Implementations must write a trailing nil to msgbuf whenever
.
| long(* lset::getTimeStampTag)(const struct link *plink, epicsTimeStamp *pstamp, epicsUTag *ptag) |
Equivalent of getTimeStamp() and also copy out time tag. ptag may be NULL.
1.8.5
