Adding the spy command to an RTEMS/EPICS application

Several files need minor modifications to add the spy command to an application.

1. Add the full path to the RTEMS utilities support directory to the application configure/RELEASE file:
   RTEMS_UTILS=xxxx/modules/soft/rtemsutils-<release>
   Where <release> is the release number of of the RTEMS utility support.
2. Add spy support to application database definition file
   The application database definition file must include the database definition files for the spy support. 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 definition file in that file:
     include "base.dbd"
     include "spy.dbd"
     
   • If you are building your application database definition file from the application Makefile you specify the aditional database definition file there:
     xxx_DBD += base.dbd
     xxx_DBD += spy.dbd
     
3. Add the RTEMS utility support libraries to the application
   You must link the RTEMS utility support library with the application. Add the following line:
   xxx_LIBS += rtemsutils
   before the
   xxx_LIBS += $(EPICS_BASE_IOC_LIBS)
   in the application Makefile.

Note that the task priority column is the RTEMS priority, not the EPICS priority, of the task.

Installation and Building

1. Place the distribution file into the modules/soft directory.
2. Execute the following commands:
   cd modules/soft
   gunzip rtemsutils-<release>.tar.gz
   tar xf rtemsutils-<release>.tar
   cd rtemsutils-<release>
   Where <release> is the release number of of the RTEMS utility support.
3. Edit the configure/RELEASE file and set the path to your installation of EPICS base.
4. Execute make in the top level directory.