asynDriver: Asynchronous Driver Support - Known Problems

Release 4-12


This patch fixes a problem in asynRecord.c that was introduced when the readRaw and writeRaw functions were removed from asynOctet in R4-10. The problem causes binary writes and reads to fail if the underlying asynOctet driver or interpose interface does not implement both the getOutputEos or getInputEos methods.

Release 4-11

A problem was introduced in R4-11 by not starting the autoconnect process until iocInit(), and operations that do not use the XXXSyncIO functions thus fail before iocInit(). This means, for example, that calls to asynSetOption() to set serial port parameters fail if done in a startup script before iocInit(). This is fixed in R4-12.

Release 4-9


There is a bug with autoconnecting to devices. The following change to asynManager.c fixes the problem:

@@ -605,7 +607,7 @@
-        pport->dpc.autoConnectActive = FALSE;
+        pdevice->dpc.autoConnectActive = FALSE;
     return pdevice->dpc.connected;


The change that was done in R4-9 with direct calls to dbScanLock and process in the interrupt callback functions can lead to deadlocks in some unusual circumstances. This is fixed in R4-10.

Release 4-6


There is a null pointer dereference problem for all device support when SCAN=I/O Intr and asyn port could not be found.


There is buffer overflow problem if NRRD is set to more than 40 in ASCII input mode.


Does not yet support new timeout semantics (timeout<0 means wait forever, timeout=0 means return characters immediately available). Support for timeout values less than zero will be part of the next release.

Release 4-5


The wrong interrupt callback routine was being called.

UDF is not set false when the VAL field is modified.

Index: devAsynFloat64.c
RCS file: /net/phoebus/epicsmgr/cvsroot/epics/modules/soft/asyn/asyn/devEpics/devAsynFloat64.c,v
retrieving revision 1.18
retrieving revision 1.20
diff -u -r1.18 -r1.20
--- devAsynFloat64.c    13 Apr 2006 17:16:46 -0000      1.18
+++ devAsynFloat64.c    11 May 2006 23:25:15 -0000      1.20
@@ -41,13 +41,6 @@
 #include "asynFloat64.h"
 #include <epicsExport.h>
-typedef enum {
-    typeAiFloat64,
-    typeAiFloat64Average,
-    typeAiFloat64Interrupt,
-    typeAoFloat64
 typedef struct devPvt{
     dbCommon          *pr;
     asynUser          *pasynUser;
@@ -56,7 +49,6 @@
     void              *float64Pvt;
     void              *registrarPvt;
     int               canBlock;
-    asynAnalogDevType devType;
     epicsMutexId      mutexId;
     asynStatus        status;
     int               gotValue;
@@ -303,7 +295,7 @@
     dbCommon *pr = pPvt->pr;
     asynPrint(pPvt->pasynUser, ASYN_TRACEIO_DEVICE,
-        "%s devAsynFloat64::interruptCallbackInput new value=%lu\n",
+        "%s devAsynFloat64::interruptCallbackAverage new value=%f\n",
         pr->name, value);
@@ -399,7 +391,7 @@
     devPvt *pPvt;
     status = initCommon((dbCommon *)pai,&pai->inp,
-        0,interruptCallbackInput);
+        0,interruptCallbackAverage);
     if (status != asynSuccess) return 0;
     pPvt = pai->dpvt;
     status = pPvt->pfloat64->registerInterruptUser(
@@ -417,13 +409,16 @@
     devPvt *pPvt = (devPvt *)pai->dpvt;
-    if (pPvt->numAverage == 0) pPvt->numAverage = 1;
+    if (pPvt->numAverage == 0) 
+        pPvt->numAverage = 1;
+    else
+        pai->udf = 0;
     pai->val = pPvt->sum/pPvt->numAverage;
     pPvt->numAverage = 0;
     pPvt->sum = 0.;
     asynPrint(pPvt->pasynUser, ASYN_TRACEIO_DEVICE,
-              "%s devAsynAnalog::callbackAiAverage val=%f\n",
+              "%s devAsynFloat64::callbackAiAverage val=%f\n",
               pai->name, pai->val);
     return 2;


NULL pointer dereference. How this one slipped through testing is quite surprising.

Index: asyn/drvAsynSerial/drvAsynIPPort.c
RCS file: /net/phoebus/epicsmgr/cvsroot/epics/modules/soft/asyn/asyn/drvAsynSerial/drvAsynIPPort.c,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- asyn/drvAsynSerial/drvAsynIPPort.c	25 Apr 2006 17:50:02 -0000	1.30
+++ asyn/drvAsynSerial/drvAsynIPPort.c	11 May 2006 21:12:45 -0000	1.31
@@ -386,7 +386,7 @@
         status = asynError;
-    *gotEom = 0;
+    if (gotEom) *gotEom = 0;
 #ifdef USE_POLL
         struct pollfd pollfd;
Index: asyn/drvAsynSerial/drvAsynSerialPort.c
RCS file: /net/phoebus/epicsmgr/cvsroot/epics/modules/soft/asyn/asyn/drvAsynSerial/drvAsynSerialPort.c,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- asyn/drvAsynSerial/drvAsynSerialPort.c	3 Apr 2006 23:38:19 -0000	1.34
+++ asyn/drvAsynSerial/drvAsynSerialPort.c	11 May 2006 21:12:45 -0000	1.35
@@ -778,7 +778,7 @@
     tty->timeoutFlag = 0;
-    *gotEom = 0;
+    if (gotEom) *gotEom = 0;
     for (;;) {
 #ifdef vxWorks


If a client calls asynCommon->connect when the asyn port is already connected to the IP port, then the asyn port will be disconnected from the IP port for all clients. The correct behavior in this case is to simply return an asynError status.

The following change fix can be made to drvAsynIPPort.c to fix the problem:

corvette> cvs diff -rR4-5 drvAsynIPPort.c
Index: drvAsynIPPort.c
RCS file: /net/phoebus/epicsmgr/cvsroot/epics/modules/soft/asyn/asyn/drvAsynSerial/drvAsynIPPort.c,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- drvAsynIPPort.c     3 Apr 2006 23:38:19 -0000       1.27
+++ drvAsynIPPort.c     17 Apr 2006 15:36:40 -0000      1.28
@@ -206,6 +206,11 @@
      * Sanity check
+    if (tty->fd >= 0) {
+        epicsSnprintf(pasynUser->errorMessage,pasynUser->errorMessageSize,
+                              "%s: Link already open!", tty->serialDeviceName);
+        return asynError;
+    }
     asynPrint(pasynUser, ASYN_TRACE_FLOW,
               "Open connection to %s\n", tty->serialDeviceName);

Release 4-3


This fails for fast processors like the 2700 and 5100


UDF is not set false when the VAL field is modified.

Release 4-2


Device support is not returning 2 (do not convert) for ai records when it should. This means that the VAL field is being set back to 0 by the record after device support writes to it.


The record sometimes does not read the current input and output EOS values from the driver when it connects.

Release 4-1


If read reads maxchars, it forces the last character to be 0 and returns asynOverflow if it wasn't.

drvAsynSerialPort,drvAsynIPPort - Error reporting

These do not properly set an error message in asynUser.errorMessage when they return asynError.


This calls setOption for clocal. This only works on vxWorks because vxWorks uses the name CLOCAL for what POSIX calls CRTSCTS.


If a call to a low level driver, which registered itself as canBlock, completes without blocking then the asynchronous completion may never occur. This will be fixed in the next release.

drvAsynIPPort and drvAsynSerialPort

The problem reported for version 4 about segmentation faults on cygwin-x86 has been fixed.

Release 4-0


asynRecord (and other code) use epicsStrSnPrintEscaped. In EPICS 3.14.6 the files epicsVsnprintf on vxWorks (which gets called by several other epicsXXXprintf routines) and epicsStrSnPrintEscaped each have a bug could cause buffer overflow. These bugs are guaranteed to lead to corruption in asynRecord if the received string is longer than 40 characters.




Release 3-3


If vxiName is specified as "inst" then the driver incorrectly says that it does not block.


If asynRecord is attached to a port that does not implement asynOctet, then asynRecord crashes of it attempt to send/receive a message.


The next release gaurantees that when queueRequest is called:

  1. Exactly one of the following occurs:
  2. If either the queue or timeout callback is active when cancelRequest is called, it will not return until the callback completes.

Release 3-2

Mac OS X (Darwin)

The RPC library on Mac OS X 10.3.3 does not handle device timeouts properly and may cause core dumps. A bug report has been filed with Apple. A workaround is to use the GNU glibc RPC/XDR routines.


Attempting to change the trace file to "stdout" does not work becuase vxWorks has per-task standard output streams.

Release 3-1

EPICS Base R3.14.6

When building with EPICS Base R3.14.6 or greater, comment out the epicsInterruptibleSyscall.h and epicsInterruptibleSyscall.c lines in asyn/Makefile:

@@ -19,10 +19,10 @@
 SRC_DIRS += $(ASYN)/asynDriver
 INC += asynDriver.h
 INC += epicsInterruptibleSyscall.h
-INC += epicsString1.h
+#INC += epicsString1.h
 asyn_SRCS += asynManager.c
 asyn_SRCS += epicsInterruptibleSyscall.c
-asyn_SRCS += epicsString1.c
+#asyn_SRCS += epicsString1.c
 SRC_DIRS += $(ASYN)/asynGpib
 INC += asynGpibDriver.h

Mac OS X (Darwin)

The RPC library on Mac OSD 10.3.3 does not handle device timeouts properly and may cause core dumps. A bug report has been filed with Apple. A workaround is to use the GNU glibc RPC/XDR routines.

Interrupt Callback

If a user callback calls a low level driver with an infinite or very long timeout, there is no way to make the call terminate. Is there a generic way to abort the call?

Greensprings IP488

Does not support GPIB specific functions.

NI1014 VME Gpib driver

This needs to be implemented for asynDriver.

Generic EPICS device support

Think about creating generic support for connecting to EPICS records.

Network Protocols

Consider generic support for various network protocals: Modbus, etherIP, etc.