Update for 3.14.0beta2
This commit is contained in:
Marty Kraimer
@@ -1,322 +1,308 @@
|
||||
<!doctype html public "-//w3c//dtd html 4.0 transitional//en">
|
||||
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
|
||||
"http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||||
<meta name="Author" content="jba">
|
||||
<meta name="GENERATOR" content="Mozilla/4.78 [en] (X11; U; SunOS 5.8 sun4u) [Netscape]">
|
||||
<title></title>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
||||
<meta name="Author" content="jba">
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<center>
|
||||
<h2>
|
||||
Converting an EPICS R3.13 application to R3.14.0.beta2</h2></center>
|
||||
<h2>Converting an EPICS R3.13 application to R3.14.0.beta2</h2>
|
||||
</center>
|
||||
|
||||
<p><br>This document describes how to convert a R3.13 vxWorks application
|
||||
so that it builds with release R3.14.0beta2. It describes procedures
|
||||
such that:
|
||||
<p><br>
|
||||
This document describes how to convert a R3.13 vxWorks application so that it
|
||||
builds with release R3.14.0beta2. It describes procedures such that:</p>
|
||||
<ul>
|
||||
<li>
|
||||
The application uses the configure rules which are new to R3.14.</li>
|
||||
<li>The application uses the configure rules which are new to R3.14.</li>
|
||||
</ul>
|
||||
<ul>
|
||||
<li>The OSI (Operating System Independent) features of R3.14 are available,
|
||||
i.e. iocCore products can be build for vxWorks as well as other
|
||||
platforms, e.g. solaris and linux.</li>
|
||||
</ul>
|
||||
|
||||
<h3>Gnumake clean uninstall</h3>
|
||||
|
||||
<p>First do a gnumake clean uninstall in the application's root directory to
|
||||
remove all files created by earlier builds.</p>
|
||||
|
||||
<h3>Create a new R3.14 application</h3>
|
||||
<pre>mkdir <top>
|
||||
cd <top>
|
||||
<full path to 3.14 base>/bin/<host_arch>/makeBaseApp.pl -t example junk
|
||||
/bin/rm -fr junkApp</pre>
|
||||
|
||||
<h3>Copy all *App and iocBoot directories and files to the new <top>
|
||||
directory</h3>
|
||||
<pre>cd <oldtop>
|
||||
find *App iocBoot -print | cpio -pvmd <fullpath name to new top></pre>
|
||||
|
||||
<h3>Modify <top>/configure/RELEASE</h3>
|
||||
|
||||
<p>Copy definitions of external modules excluding EPICS_BASE and
|
||||
TEMPLATES_TOP from old application RELEASE file. <br>
|
||||
If sequence programs (*.st or *.stt files) exist in your application, add the
|
||||
SNCSEQ location definition for the R3.14 seq external module</p>
|
||||
|
||||
<p><tt>SNCSEQ =<full path to seq module top></tt></p>
|
||||
The R3.14 seq module must exist and be built with EPICS base R3.14.0beta2
|
||||
|
||||
<h3>Modify the Makefiles in <top>/*App directories.</h3>
|
||||
|
||||
<p>Change <tt>"include $(TOP)/config/CONFIG_APP"</tt> to <tt>"include
|
||||
$(TOP)/configure/CONFIG"</tt></p>
|
||||
|
||||
<p>Change " i<tt>nclude $(TOP)/config/RULES_DIRS</tt>" to "<tt>include
|
||||
$(TOP)/configure/RULES_DIRS"</tt></p>
|
||||
|
||||
<h3>Modify the Makefiles in <top>/*App/*Db directories.</h3>
|
||||
|
||||
<p>Remove existing Makefile <br>
|
||||
Rename Makefile.Host to Makefile <br>
|
||||
Modify Makefile as follows:</p>
|
||||
|
||||
<p>Change "<tt>TOP=../../.."</tt> to "<tt>TOP=../.."</tt></p>
|
||||
|
||||
<p>Change "i<tt>nclude $(TOP)/config/CONFIG_APP</tt>" to "<tt>include
|
||||
$(TOP)/configure/CONFIG"</tt></p>
|
||||
|
||||
<p>Change "<tt>include $(TOP)/config/RULES.Db" </tt>to <tt>"include
|
||||
$(TOP)/configure/RULES"</tt></p>
|
||||
|
||||
<p>Place all definitions between the include lines.</p>
|
||||
|
||||
<p>Place any rules after the last include line.</p>
|
||||
|
||||
<h3>Modify the Makefiles in <top>/*App/src directories.</h3>
|
||||
|
||||
<p>This is the hardest step. The definitions in Makefile.Host and Makefile.Vx
|
||||
must be manually converted to the new configure definitions.</p>
|
||||
|
||||
<p>First replace Makefile with a template Makefile from base.</p>
|
||||
<pre>rm Makefile
|
||||
cp <base>/templates/makeBaseApp/top/exampleApp/src/Makefile .</pre>
|
||||
|
||||
<p>This new Make file has comments explaining how to build the various host
|
||||
and ioc products. Lets consider some examples</p>
|
||||
<ul>
|
||||
<li>
|
||||
The OSI (Operating System Independent) features of R3.14 are available,
|
||||
i.e. iocCore products can be build for vxWorks as well as other platforms,
|
||||
e.g. solaris and linux.</li>
|
||||
<li>Host programs
|
||||
<p>Makefile.Host contains definitions like:</p>
|
||||
<pre>PROD += caExample
|
||||
caExample_SRCS += caExample.c
|
||||
</pre>
|
||||
<p>In Makefile these are:</p>
|
||||
<pre>PROD_HOST += caExample
|
||||
caExample_SRCS += caExample.c
|
||||
caExample_LIBS += ca
|
||||
caExample_LIBS += Com
|
||||
</pre>
|
||||
</li>
|
||||
<li>Record Support - generate xxxRecord.h file
|
||||
<p>Makefile.Host (or perhaps Makefile.Vx) contains:</p>
|
||||
<pre>RECTYPES += xxxRecord.h
|
||||
</pre>
|
||||
<p>In Makefile this is:</p>
|
||||
<pre>DBDINC += xxxRecord
|
||||
</pre>
|
||||
</li>
|
||||
<li>Generating the .dbd file for all record/device/driver support
|
||||
<p>Makefile.Host (or perhaps Makefile.Vx) contains:</p>
|
||||
<pre>DBDEXPAND = exampleInclude.dbd
|
||||
DBDNAME = exampleApp.dbd
|
||||
</pre>
|
||||
<p>In Makefile this is:</p>
|
||||
<pre>DBD += example.dbd
|
||||
</pre>
|
||||
<p>NOTES: Change exampleApp.dbd to example.dbd in all st.cmd files. Also
|
||||
this definition assumes that file exampleInclude.dbd exists.</p>
|
||||
</li>
|
||||
<li>Create the ioc application:
|
||||
<p>Makefile.Vx contains statements like:</p>
|
||||
<pre>SRCS.c += ../xxxRecord.c
|
||||
SRCS.c += ../devXxxSoft.c
|
||||
|
||||
LIBOBJS += xxxRecord.o
|
||||
LIBOBJS += devXxxSoft.o
|
||||
LIBOBJS += sncExample.o
|
||||
|
||||
include ../baseLIBOBJS
|
||||
|
||||
LIBNAME = exampleLib
|
||||
INSTALLS += iocCore seq
|
||||
</pre>
|
||||
<p>In Makefile these become:</p>
|
||||
<pre>PROD_IOC_vxWorks = example
|
||||
example_SRCS += xxxRecord.c
|
||||
example_SRCS += devXxxSoft.c
|
||||
example_SRSC += sncExample.stt
|
||||
example_SRCS += example_registerRecordDeviceDriver.cpp
|
||||
example_OBJS_vxWorks += $(EPICS_BASE_BIN)/vxComLibrary
|
||||
|
||||
#The following are for sequence programs
|
||||
example_LIBS += seq
|
||||
example_LIBS += pv
|
||||
seq_DIR = $(SNCSEQ_LIB)
|
||||
pv_DIR = $(SNCSEQ_LIB)
|
||||
|
||||
example_LIBS += recIoc
|
||||
example_LIBS += softDevIoc
|
||||
example_LIBS += testDevIoc
|
||||
example_LIBS += iocsh
|
||||
example_LIBS += miscIoc
|
||||
example_LIBS += rsrvIoc
|
||||
example_LIBS += dbtoolsIoc
|
||||
example_LIBS += asIoc
|
||||
example_LIBS += dbIoc
|
||||
example_LIBS += registryIoc
|
||||
example_LIBS += dbStaticIoc
|
||||
example_LIBS += ca
|
||||
example_LIBS += Com
|
||||
</pre>
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h3>
|
||||
Gnumake clean uninstall</h3>
|
||||
<p>After these changes are made the following files are no longer needed:
|
||||
baseLIBOBS, Makefile.Host, and Makefile.Vx</p>
|
||||
|
||||
<blockquote>First do a gnumake clean uninstall in the application's root
|
||||
directory to remove all files created by earlier builds.</blockquote>
|
||||
<h3>Modify the Makefiles in <top>/iocBoot directory.</h3>
|
||||
|
||||
<h3>
|
||||
Create a new R3.14 application</h3>
|
||||
<p>Change " i<tt>nclude $(TOP)/config/CONFIG_APP" </tt>to "<tt>include
|
||||
$(TOP)/configure/CONFIG"</tt></p>
|
||||
|
||||
<blockquote><tt>mkdir <top></tt>
|
||||
<br><tt>cd <top></tt>
|
||||
<br><tt><full path to R3.14.0beta2 base>/bin/<host_arch>/makeBaseApp.pl
|
||||
-t example example</tt><tt></tt>
|
||||
<p><tt>You can remove the newly created exampleApp directory now.</tt></blockquote>
|
||||
<p>Remove the line "<tt>DIRS += $(wildcard *ioc*"</tt></p>
|
||||
|
||||
<h3>
|
||||
Copy all *App and iocBoot directories and files to the new <top> directory</h3>
|
||||
<p>Change <tt>"include $(TOP)/config/RULES.iocBoot" </tt>to "i<tt>nclude
|
||||
$(TOP)/configure/RULES.iocBoot"</tt></p>
|
||||
|
||||
<blockquote><tt>cd <oldtop></tt>
|
||||
<br><tt>find *App iocBoot -print | cpio -pvmd <fullpath name to new
|
||||
top></tt></blockquote>
|
||||
<h3>Modify the Makefiles in <top>/iocBoot/ioc* directories.</h3>
|
||||
|
||||
<h3>
|
||||
Modify <top>/configure/RELEASE</h3>
|
||||
<p>Change <tt>"include $(TOP)/config/CONFIG_APP" </tt>to "<tt>include
|
||||
$(TOP)/configure/CONFIG"</tt></p>
|
||||
|
||||
<blockquote>Copy definitions of external modules excluding EPICS_BASE and
|
||||
TEMPLATES_TOP from old application RELEASE file.
|
||||
<br>If sequence programs (*.st or *.stt files) exist in your application,
|
||||
add the SNCSEQ location definition for the R3.14 seq external module
|
||||
<blockquote><tt>SNCSEQ =<full path to seq module top></tt></blockquote>
|
||||
The R3.14 seq module must exist and be built with EPICS base R3.14.0beta2.</blockquote>
|
||||
<p>Change</p>
|
||||
|
||||
<h3>
|
||||
Modify the Makefiles in <top>/*App directories.</h3>
|
||||
<p><tt>include ARCH = <old arch specification e.g. mv167></tt></p>
|
||||
|
||||
<blockquote>Change <tt>include $(TOP)/config/CONFIG_APP</tt>
|
||||
<br>to <tt>include $(TOP)/configure/CONFIG</tt>
|
||||
<p>Change i<tt>nclude $(TOP)/config/RULES_DIRS</tt>
|
||||
<br>to <tt>include $(TOP)/configure/RULES_DIRS</tt></blockquote>
|
||||
<p>to</p>
|
||||
|
||||
<h3>
|
||||
Modify the Makefiles in <top>/*App/*Db directories.</h3>
|
||||
<p>"<tt>include ARCH = <new arch specification e.g.
|
||||
vxWorks-68040>"</tt></p>
|
||||
|
||||
<blockquote>Remove existing Makefile
|
||||
<br>Rename Makefile.Host to Makefile
|
||||
<br>Modify Makefile as follows:
|
||||
<p>Change <tt>TOP=../../..</tt>
|
||||
<br>to <tt>TOP=../..</tt>
|
||||
<p>Change i<tt>nclude $(TOP)/config/CONFIG_APP</tt>
|
||||
<br>to <tt>include $(TOP)/configure/CONFIG</tt>
|
||||
<p>Change <tt>include $(TOP)/config/RULES.Db</tt>
|
||||
<br>to <tt>include $(TOP)/configure/RULES</tt>
|
||||
<p>Place all definitions between the include lines.
|
||||
<p>Place any rules after the last include line.</blockquote>
|
||||
<p>Change "<tt>include $(TOP)/config/RULES.ioc</tt>" to "<tt>include
|
||||
$(TOP)/configure/RULES.ioc"</tt></p>
|
||||
|
||||
<h3>
|
||||
Modify the Makefiles in <top>/*App/src directories.</h3>
|
||||
<p>If it exists remove the line</p>
|
||||
|
||||
<blockquote>Remove existing Makefile
|
||||
<br>Rename Makefile.Host to Makefile
|
||||
<br>Modify Makefile as follows:
|
||||
<p>Change <tt>TOP=../../..</tt>
|
||||
<br>to <tt>TOP=../..</tt>
|
||||
<p>Change <tt>include $(TOP)/config/CONFIG_APP</tt>
|
||||
<br>to <tt>include $(TOP)/configure/CONFIG</tt>
|
||||
<p>Change i<tt>nclude $(TOP)/config/RULES.Host</tt>
|
||||
<br>to <tt>include $(TOP)/configure/RULES</tt>
|
||||
<p>Change <tt>PROD_LIBS = <name></tt>
|
||||
<br>to <tt> <prod name>_LIBS = dbStaticHost</tt>
|
||||
<br>where <tt><prod name></tt> is a specified product to be built.
|
||||
<p>Change library name <tt>Db</tt> to <tt>dbStaticHost.</tt>
|
||||
<br>Change<tt> PROD_LIBS = Db</tt>
|
||||
<br>to <tt> <prodname>_LIBS += dbStaticHost</tt>
|
||||
<br>and <tt>Db_DIR = $(EPICS_BASE_LIB)</tt>
|
||||
<br>to <tt>dbStaticHost_DIR = $(EPICS_BASE_LIB)</tt>
|
||||
<p>Change <tt>USER_DBDFLAGS</tt>
|
||||
<br>to <tt>USR_DBDFLAGS</tt>
|
||||
<p>Change <tt>RECTYPES += xxxRecord.h</tt>
|
||||
<br>to <tt>DBDINC += xxxRecord</tt>
|
||||
<p>Change <tt>DBDNAME = <name>App.dbd</tt>
|
||||
<br>to <tt>DBD += <name>.dbd</tt>
|
||||
<p>Remove all <tt>DBDEXPAND</tt> lines.
|
||||
<p>Change <tt>PROD = <prodname></tt>
|
||||
<br>to <tt>PROD_HOST = <prodname></tt>
|
||||
<p>Change <tt>SRCS.c += <name></tt>
|
||||
<br>to <tt><prodname>_SRCS += <name></tt>
|
||||
<br>or<tt> <libname>_SRCS += <name></tt>
|
||||
<p>Add the contents of Makefile.Vx to Makefile removing the include lines
|
||||
and the TOP definition.</blockquote>
|
||||
<p><tt>buildInstall: cdCommands</tt></p>
|
||||
|
||||
<blockquote>Change <tt>LIBNAME = <libname>Lib</tt>
|
||||
<br>to <tt>PROD_vxWorks = <libname></tt>
|
||||
<p>Remove line <tt> -include ../baseLIBOBJS</tt>
|
||||
<p>Remove line <tt>INSTALLS = iocCore seq</tt>
|
||||
<p>Change all <tt>SRCS.c += ../<name>.c </tt>lines
|
||||
<br>to <font face="Arial,Helvetica"><prodname>_SRCS += <name>.c</font>
|
||||
<br>if the source files exist in the current directory.
|
||||
<p>Change all <tt>*OBJS += <name>.o</tt>
|
||||
lines
|
||||
<br>to <font face="Arial,Helvetica"><prodname>_SRCS += <name>.c</font>
|
||||
<br>or <font face="Arial,Helvetica"> <prodname>_SRCS += <name>.cc</font>
|
||||
<br>if the c/c++ source files exist in the current directory.
|
||||
<p>Remove any duplicate <font face="Arial,Helvetica">prodname>_SRCS definitions.</font>
|
||||
<p>Change <tt>LIBOBJS += <seq_program_name>.o</tt>
|
||||
lines
|
||||
<br>to <tt><prodname>_SRCS += <seq_program_name>.stt</tt>
|
||||
<br>or <tt><prodname>_SRCS += <seq_program_name>.st</tt>
|
||||
<p>Add the lines
|
||||
<blockquote># <name>_registerRecordDeviceDriver.cpp will be created
|
||||
from <name>.dbd
|
||||
<br><name>_SRCS += <name>_registerRecordDeviceDriver.cpp
|
||||
<p>#The following adds support from base/src/vxWorks
|
||||
<br><name>_OBJS_vxWorks += $(EPICS_BASE_BIN)/vxComLibrary
|
||||
<p><tt>#<name>_LIBS += seq</tt>
|
||||
<br><tt>#<name>_LIBS += pv</tt>
|
||||
<br><tt>#seq_DIR = $(SNCSEQ_LIB)</tt>
|
||||
<br><tt>#pv_DIR = $(SNCSEQ_LIB)</tt>
|
||||
<p><tt><name>_LIBS += recIoc</tt>
|
||||
<br><tt><name>_LIBS += softDevIoc</tt>
|
||||
<br><tt><name>_LIBS += testDevIoc</tt>
|
||||
<br><tt><name>_LIBS += iocsh</tt>
|
||||
<br><tt><name>_LIBS += miscIoc</tt>
|
||||
<br><tt><name>_LIBS += rsrvIoc</tt>
|
||||
<br><tt><name>_LIBS += dbtoolsIoc</tt>
|
||||
<br><tt><name>_LIBS += asIoc</tt>
|
||||
<br><tt><name>_LIBS += dbIoc</tt>
|
||||
<br><tt><name>_LIBS += registryIoc</tt>
|
||||
<br><tt><name>_LIBS += dbStaticIoc</tt>
|
||||
<br><tt><name>_LIBS += ca</tt>
|
||||
<br><tt><name>_LIBS += Com</tt></blockquote>
|
||||
where <tt><name></tt> is the name in the <tt>PROD_vxWorks</tt>
|
||||
definition, and uncomment the first four lines if you have sequence programs
|
||||
(.st or .stt files) in the current directory.
|
||||
<p>Place all macro definitions between the include lines.
|
||||
<p>Place any rules after the last include line.
|
||||
<p>Remove the file Makefile.Vx.</blockquote>
|
||||
<h3>Modify st.cmd in <top>/iocBoot/ioc* directories.</h3>
|
||||
|
||||
<h3>
|
||||
Modify the Makefiles in <top>/iocBoot directory.</h3>
|
||||
<p>Remove the lines</p>
|
||||
<pre>ld < seq
|
||||
ld < iocCore</pre>
|
||||
|
||||
<blockquote>Change i<tt>nclude $(TOP)/config/CONFIG_APP</tt>
|
||||
<br>to <tt>include $(TOP)/configure/CONFIG</tt>
|
||||
<p>Remove the line <tt>DIRS += $(wildcard *ioc*)</tt>
|
||||
<p>Change <tt>include $(TOP)/config/RULES.iocBoot</tt>
|
||||
<br>to i<tt>nclude $(TOP)/configure/RULES.iocBoot</tt></blockquote>
|
||||
<p>Change "<tt>ld < <libname>Lib</tt>" to "<tt>ld <
|
||||
<libname>.munch"</tt></p>
|
||||
|
||||
<h3>
|
||||
Modify the Makefiles in <top>/iocBoot/ioc* directories.</h3>
|
||||
<p>Change the statement:</p>
|
||||
|
||||
<blockquote>Change <tt>include $(TOP)/config/CONFIG_APP</tt>
|
||||
<br>to <tt>include $(TOP)/configure/CONFIG</tt>
|
||||
<p>Change <tt>include ARCH = <old arch specification e.g. mv167></tt>
|
||||
<br>to <tt>include ARCH = <new arch specificatio
|
||||
e.g. vxWorks-68040></tt>
|
||||
<p><tt>Add the following macro definition</tt>
|
||||
<br><tt>TARGETS = cdCommands</tt>
|
||||
<p>Place all macro definitions between the include lines.
|
||||
<p>Change <tt>include $(TOP)/config/RULES.ioc</tt>
|
||||
<br>to <tt>include $(TOP)/configure/RULES.ioc</tt>
|
||||
<p><tt>If it exists, remove the line</tt>
|
||||
<br><tt>buildInstall: cdCommands</tt>
|
||||
<br> </blockquote>
|
||||
|
||||
<h3>
|
||||
Modify st.cmd in <top>/iocBoot/ioc* directories.</h3>
|
||||
|
||||
<blockquote>Remove the lines</blockquote>
|
||||
|
||||
<blockquote>
|
||||
<blockquote>
|
||||
<pre>ld < seq</pre>
|
||||
|
||||
<pre>ld < iocCore</pre>
|
||||
</blockquote>
|
||||
Change <tt>ld < <libname>Lib</tt>
|
||||
<br>to <tt>ld < <libname>.munch</tt>
|
||||
<p>Change load statements for db and dbd files from
|
||||
<blockquote><tt>cd startup</tt>
|
||||
<br><tt>dbLoadDatabase("../../dbd/<name>App.dbd")</tt></blockquote>
|
||||
<p><tt>dbLoadDatabase("../../dbd/exampleApp.dbd")</tt> <br>
|
||||
</p>
|
||||
to
|
||||
<blockquote><tt>cd top</tt>
|
||||
<br><tt>dbLoadDatabase("dbd/<name>.dbd")</tt>
|
||||
<br><tt></tt> </blockquote>
|
||||
<tt>Add the following line immediately after the dbLoadDatabase lines.</tt>
|
||||
<blockquote><tt>registerRecordDeviceDriver(pdbbase)</tt></blockquote>
|
||||
<tt>Change all</tt>
|
||||
<blockquote><tt>dbLoadRecords("../../db/<name>.db)</tt></blockquote>
|
||||
<tt>lines to</tt>
|
||||
<blockquote><tt>dbLoadRecords("db/<name>.db)</tt>
|
||||
<br><tt></tt> </blockquote>
|
||||
</blockquote>
|
||||
<pre>dbLoadDatabase("../../dbd/<name>.dbd")
|
||||
registerRecordDeviceDriver(pdbbase)</pre>
|
||||
|
||||
<h3>
|
||||
recGbl calls</h3>
|
||||
<h3>recGbl calls</h3>
|
||||
|
||||
<blockquote>You will need to add the line "#include "recGbl.h" to
|
||||
any source files that have recGbl* calls so that the file will compile
|
||||
without "implicit declaration of function" warnings and the library will
|
||||
load in the ioc without "undefined symbol: _recGblSetSevr" errors.</blockquote>
|
||||
<p>If any source file makes calls to recGbl routines make sure it has <span
|
||||
style="font-family: courier">"#include "recGbl.h"</span>. If it doesn't the
|
||||
compiler will issue warning messages and the ioc may issue the message:
|
||||
"undefined symbol: _recGblSetSevr".</p>
|
||||
|
||||
<h3>
|
||||
Record support changes</h3>
|
||||
<h3>Record support changes</h3>
|
||||
|
||||
<blockquote>The steppermotor, scan, and pid records are no longer in base.
|
||||
If these records are not used in your application, comment out references
|
||||
to them in base.dbd. If these record types are used at your site, they
|
||||
should be downloaded and built with base R3.14 by your EPICS administrator.
|
||||
To update the R3.14 location of these record types in your application
|
||||
you must add appropriate module definitions to your application's
|
||||
config/RELEASE file and change the <tt>LIBOBJS</tt> definitions.
|
||||
<p>For example add</blockquote>
|
||||
<p>The steppermotor, scan, and pid records are no longer in base. If these
|
||||
records are not used in your application, comment out references to them in
|
||||
base.dbd. If these record types are used at your site, they should be
|
||||
downloaded and built with base R3.14 by your EPICS administrator. To update
|
||||
the R3.14 location of these record types in your application you must add
|
||||
appropriate module definitions to your application's config/RELEASE file and
|
||||
change the <tt>LIBOBJS</tt> definitions.</p>
|
||||
|
||||
<blockquote> <tt>PID=<full
|
||||
path to modules directory>/pid</tt>
|
||||
<p>to config/RELEASE.
|
||||
<br>Remove</blockquote>
|
||||
<p>For example add</p>
|
||||
|
||||
<blockquote> <tt>LIBOBJS
|
||||
+= $(EPICS_BASE_BIN)/pidRecord.o</tt>
|
||||
<p>from baseLIBOBJS, and add</blockquote>
|
||||
<p> <tt>PID=<full path to modules directory>/pid</tt></p>
|
||||
|
||||
<blockquote>
|
||||
<blockquote><tt>LIBOBJS += $(PID_BIN)/pidRecord.o</tt></blockquote>
|
||||
to your application src/Makefile.</blockquote>
|
||||
<p>to config/RELEASE. <br>
|
||||
Remove</p>
|
||||
|
||||
<blockquote>You should consider changing any existing old steppermotor
|
||||
records to the new EPICS motor record module supported by Beamline
|
||||
Controls and Data Acquisition at APS.</blockquote>
|
||||
<p> <tt>LIBOBJS += $(EPICS_BASE_BIN)/pidRecord.o</tt></p>
|
||||
|
||||
<h3>
|
||||
RecDynLink.o and devPtSoft changes</h3>
|
||||
<p>from baseLIBOBJS, and add</p>
|
||||
|
||||
<blockquote>recDynLink.o and devPtSoft.o are no longer in EPICS base and
|
||||
now exist as separate EPICS modules. If these are not used in your application,
|
||||
comment out references to them in base.dbd and baseLIBOBJS. If they are
|
||||
used, you must now add the appropriate module full path definitions to
|
||||
your application config/RELEASE file, and change
|
||||
<tt>LIBOBJS</tt> location
|
||||
definition <tt>$(EPICS_BASE_BIN)</tt> to the module definition bin directory
|
||||
in your application src directory files. See "Hardware support changes"
|
||||
below for instructions.</blockquote>
|
||||
<p></p>
|
||||
|
||||
<h3>
|
||||
Hardware support changes</h3>
|
||||
<p><tt>LIBOBJS += $(PID_BIN)/pidRecord.o</tt></p>
|
||||
to your application src/Makefile.
|
||||
|
||||
<blockquote>All hardware support (dev, drv and dbd files) except soft support
|
||||
has been unbundled from base R3.14. This support includes the files symb.dbd,
|
||||
<p>You should consider changing any existing old steppermotor records to the
|
||||
new EPICS motor record module supported by Beamline Controls and Data
|
||||
Acquisition at APS.</p>
|
||||
|
||||
<h3>RecDynLink.o and devPtSoft changes</h3>
|
||||
|
||||
<p>recDynLink.o and devPtSoft.o are no longer in EPICS base and now exist as
|
||||
separate EPICS modules.You must now add the appropriate module full path
|
||||
definitions to your application config/RELEASE file, and change
|
||||
<tt>LIBOBJS</tt> location definition <tt>$(EPICS_BASE_BIN)</tt> to the module
|
||||
definition bin directory in your application src directory files. See
|
||||
"Hardware support changes" below for instructions.</p>
|
||||
|
||||
<h3>Hardware support changes</h3>
|
||||
|
||||
<p>All hardware support (dev, drv and dbd files) except soft support has been
|
||||
unbundled from base R3.14. This support includes the files symb.dbd,
|
||||
drvHp1404a.o, drvEpvxiMsg.o, and drvEpvxi.o. If these are not used by your
|
||||
application, comment out references to them in base.dbd and baseLIBOBJS.</blockquote>
|
||||
application, comment out references to them in base.dbd.</p>
|
||||
|
||||
<blockquote>Hardware support now exists as separate EPICS modules. The
|
||||
hardware support for your site should be downloaded and built with base
|
||||
R3.14 by your EPICS administrator. You must now add the appropriate module
|
||||
full path definitions to your application config/RELEASE file, and change
|
||||
<tt>LIBOBJS</tt>
|
||||
location from <tt>$(EPICS_BASE_BIN) </tt>to the module bin directory
|
||||
in your application src directory files.
|
||||
<p>For example, remove</blockquote>
|
||||
<p>Hardware support now exists as separate EPICS modules. The hardware
|
||||
support for your site should be downloaded and built with base R3.14 by your
|
||||
EPICS administrator. You must now add the appropriate module full path
|
||||
definitions to your application config/RELEASE file, and change
|
||||
<tt>LIBOBJS</tt> location from <tt>$(EPICS_BASE_BIN) </tt>to the module bin
|
||||
directory in your application src directory files.</p>
|
||||
|
||||
<blockquote> <tt>LIBOBJS+=$(EPICS_BASE_BIN)/symb</tt></blockquote>
|
||||
<p>For example, remove</p>
|
||||
|
||||
<blockquote>from baseLIBOBJS and add</blockquote>
|
||||
<p> <tt>LIBOBJS+=$(EPICS_BASE_BIN)/symb</tt></p>
|
||||
|
||||
<blockquote> <tt>LIBOBJS+=$(SYMB_BIN)/symb</tt></blockquote>
|
||||
<p>from baseLIBOBJS and add</p>
|
||||
|
||||
<blockquote>to your application src/Makefile,
|
||||
<br>and add the line</blockquote>
|
||||
<p> <tt>LIBOBJS+=$(SYMB_BIN)/symb</tt></p>
|
||||
|
||||
<blockquote>
|
||||
<blockquote><tt>SYMB=<full path definition for the built module SYMB></tt></blockquote>
|
||||
</blockquote>
|
||||
<p>to your application src/Makefile, <br>
|
||||
and add the line</p>
|
||||
|
||||
<blockquote>into your application config/RELEASE file .</blockquote>
|
||||
<p><tt>SYMB=<full path definition for the built module SYMB></tt></p>
|
||||
|
||||
<h3>
|
||||
dbLoadtemplate tool changes</h3>
|
||||
<p>into your application config/RELEASE file .</p>
|
||||
|
||||
<blockquote>The host tool dbLoadTemplate has been replace by a new EPICS
|
||||
extension, msi, which should be downloaded and built with base R3.14 by
|
||||
your EPICS administrator. dbLoadTemplate is still supported on iocs.
|
||||
If, in your application, db files are created from template and substitution
|
||||
files you should must have the msi executable in your path.</blockquote>
|
||||
<h3>dbLoadtemplate tool changes</h3>
|
||||
|
||||
<blockquote>
|
||||
<blockquote> </blockquote>
|
||||
<p>The host tool dbLoadTemplate has been replace by a new EPICS extension,
|
||||
msi, which should be downloaded and built with base R3.14 by your EPICS
|
||||
administrator. dbLoadTemplate is still supported on iocs. If, in your
|
||||
application, db files are created from template and substitution files you
|
||||
should add the definition</p>
|
||||
|
||||
<blockquote>
|
||||
<pre></pre>
|
||||
</blockquote>
|
||||
</blockquote>
|
||||
<p><tt>EPICS_EXTENSIONS=<full path name to epics extensions
|
||||
directory></tt></p>
|
||||
|
||||
<br>
|
||||
</body>
|
||||
<p>to your application config/RELEASE file.</p>
|
||||
<br>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
Reference in New Issue
Block a user