EPICS V4 README
This README file describes the download files available for EPICS V4.
Status: This is the 08-Feb-2011 version of the README, and pertains to the
1.0-BETA release of EPICS V4. This differs from the 11-Jan-2012 version
in that it re-includes the pvService jar file for Java, again
necessary for RPC.
Author: 28-Nov-2011 Greg White (gregory.white @ psi.ch) for EPICS
V4 team [1]
Mod: 20-Dec-2011, Greg White, for 1.0-BETA, Java and C++.
11-Jan-2012, Greg White, for EPICSv4-Java-1.0-BETA.tar.gz
08-Feb-2012, Greg White, for EPICSv4-Java-1.0-1-BETA.tar.gz
-----------------------------------------------------------------
EPICS V4 [1] is a software toolkit for developing advanced control
systems on top of EPICS [2], and fast service oriented architectures.
epics-pvdata is a sourceForge project for managing the development of
EPICS version 4.
SUMMARY
-------
The C++ implementation of EPICS V4 is in 1.0-BETA/EPICSv4-1.0-BETA.tar.gz
The Java implementation of EPICS V4 is in 1.0-BETA/EPICSv4-Java-1.0-1-BETA.tar.gz
See the document "Getting Started with EPICS V4,"
http://epics-pvdata.sourceforge.net/gettingStarted.html
FILES FOR EPICS V4 C++ IMPLEMENTATION
-------------------------------------
The file EPICSv4-1.0-BETA.tar.gz includes all (and only) the C++
implementation of EPICS V4, plus a make system based on EPICS V3's
makefiles. This is available under folder 1.0-BETA/. Build instructions
and example usage are given in [16].
MINIMUM FILES FOR EPICS V4 JAVA IMPLEMENTATION
----------------------------------------------
The file EPICSv4-Java-1.0.1-BETA.tar.gz includes all (and only) the Java
implementation of EPICS V4. On Unix systems, the tar file might be
unpacked with the command:
% tar xvfz EPICSv4-Java-1.0.1-BETA.tar.gz
Specifically the tar includes the following JAR files, plus the source
for some examples (in examplesJava/) plus necessary XML files and scripts.
pvAccess-1.0.1-BETA.jar * The EPICS V4 "wire protocol" [6] [7]
pvData-1.0.1-BETA.jar * The EPICS V4 support for high
performance data interchange [8]
pvIOC-1.0.1-BETA.jar * The EPICS V4 Input/Output Processor
(IOC). I.e. the server side [9]
pvService-1.0.1-BETA.jar * RPC support.
(*) The specific version number may change following modification of
this README. It was last updated when the 1.0-BETA was released.
See instructions in "Getting Started with EPICS V4" [16]. This
includes both how to build the Java distribution from sources downloaded
from the Mercurial repositories at SourceForge, and the alternative of
downloading the tar.gz.
FOR CONNECTING EPICS V4 to EPICS V3 IN JAVA
--------------------------------------------
The pvAccess server (part of pvAccess, above) allows an existing
Channel Access client to access a javaIOC database. The client allows
the javaIOC to communicate with a Version 3 server, i.e. a javaIOC
database can have links to records in a V3 IOC database. For these
functions you will need the following files:
These are available from the epics-pvdata sourceforge download site,
or you can get them from the references provided.
caj-1.1.8.jar The native java Channel Access [5] library [3]
jca-2.3.5.jar The API for the Java code interaction with
EPICS Channel Access [4]
USEFUL EXTERNAL SOFTWARE
------------------------
These are NOT available from the epics-pvdata sourceforge download
site.
1. oncrpc is an implementation of sun rpc which is required for VXI11
support. Find a JAR for it at
https://sourceforge.net/apps/trac/remotetea/wiki/WikiStart [10]. Our
pvIOC SNAPSHOT uses version 1.0.7.
2. For testing EPICS V4 it is very useful use the "SWTshell" GUI
application [11] that helps you interactively configure the EPICS V4
interface. For this you need to the swt.jar. To get it, you can eiher
install Eclipse and find swt*.jar in your eclipse install around
.../eclipse/plugins/org.eclipse.swt**.jar, or download it from
http://www.eclipse.org/swt/ [12]. See the EPICS V4 helloWorld example
service's runner script [13] for an example of including swt for Mac
OS Cocoa at runtime.
References
----------
[1] The EPICS V4 homepage, http://epics-pvdata.sourceforge.net
[2] EPICS homepage, http://www.aps.anl.gov/epics
[3] CAJ homepage, such as it is, http://epics-jca.sourceforge.net/caj/
[4] JCA homepage, http://epics-jca.sourceforge.net/jca/
[5] Channel Access Reference,
http://www.aps.anl.gov/epics/base/R3-14/8-docs/CAref.html
[6] pvAccess Specification,
http://epics-pvdata.sourceforge.net/pvAccess_Protocol_Specification.html
[7] pvAccess Java documentation,
http://epics-pvdata.hg.sourceforge.net/hgweb/epics-pvdata/pvAccessJava/raw-file/tip/documentation/pvAccessJava.html
[8] pvData Java documentation,
http://epics-pvdata.hg.sourceforge.net/hgweb/epics-pvdata/pvDataJava/raw-file/tip/documentation/pvDataJava.html
[9] pvIOC Java documentation,
http://epics-pvdata.hg.sourceforge.net/hgweb/epics-pvdata/pvIOCJava/raw-file/tip/documentation/pvIOCJava.html
[10] RemoteTeo implementation of ONC/RPC,
https://sourceforge.net/apps/trac/remotetea/wiki/WikiStart
[11] SWTShell for pvIOC,
http://epics-pvdata.sourceforge.net/doc/pvIOCJava/swtshell.html
[12] SWT: Standard Widget Toolkit, http://www.eclipse.org/swt/
[13] helloWorld runtime setup script,
http://epics-pvdata.hg.sourceforge.net/hgweb/epics-pvdata/exampleJava/file/576e59c105e9/src/helloWorld/helloWorld_setup.bash
[14] exampleJava, examples of use of EPICS V4 java binding,
http://epics-pvdata.hg.sourceforge.net/hgweb/epics-pvdata/exampleJava/file/tip/src
[15] ChannelRPC facility javadoc in pvIOC, http://epics-pvdata.sourceforge.net/doc/pvIOCJava/rpcSupport.html
[16] Getting Started with EPICS V4, http://epics-pvdata.sourceforge.net/gettingStarted.html
