AsynDribble Support

This module provides an Asyn Interpose layer for asynOctet that inserts a delay between each transmitted character.

Follow the instructions under Installation and Building below once to build the module at your site, then the Using instructions to add it to each IOC application.

Release Notes

Version 1.2 — ANJ — 2011-03-07

Modified the configuration routine to expect the delay interval as an integer in milli-seconds, which is compatible with use from the vxWorks target shell. Added documentation for the configuration command, these release notes, and the LICENSE file.

Version 1.1 — WEN — 2009-09-17

Initial release.

Using AsynDribble support in an application

Several files need minor modifications to use AsynDribble support in an IOC application.

1. Add the full path to the asynDribble support directory to the application's configure/RELEASE file:
   ASYNDRIBBLE=/path/to/asynDribble-1.2
2. Add support to application database definition file
   The application database definition file must include the database definition files for asynDribble and any needed ASYN drivers. There are two ways that this can be done:
   • If you are building your application database definition file from an xxxInclude.dbd file you include the additional database definitions in that file:
     include "base.dbd"
     include "asynInterposeDribble.dbd"
     
   • If you are building your application database definition file from the application Makefile you specify the aditional database definitions there:
     xxx_DBD += base.dbd
     xxx_DBD += asynInterposeDribble.dbd
     
3. Add the asynDribble support library to the application, before the Asyn and Base libraries. Add the line shown in bold below to the application's src/Makefile (the other lines or their equivalent should already be present if you are already using Asyn):
   xxx_LIBS += asynInterposeDribble
   xxx_LIBS += asyn
   xxx_LIBS += $(EPICS_BASE_IOC_LIBS)
4. To use the Asyn Interpose layer on a particular Asyn port, add the following command to the IOC's startup script:
   asynInterposeDribbleConfig "port name", addr, interval
   where the port name and address specify the Asyn port to dribble and interval is the inter-character time delay in milliseconds. The interval defaults to 100ms if negative, zero or not provided.

Installation and Building

After obtaining a copy of the distribution, it must be installed and built for use at your site.

1. Copy the distribution file into a suitable installation directory.
2. Execute the following commands:
   tar xfz asynDribble-1.2.tar.gz
   cd asynDribble-1.2
3. Edit the configure/RELEASE file and set the paths to your installation of EPICS Base and ASYN.
4. Execute make in the top level directory.