CaWave user`s guide Page: 1 of 19
This report is part of the collection entitled: Office of Scientific & Technical Information Technical Reports and was provided to Digital Library by the UNT Libraries Government Documents Department.
The following text was automatically extracted from the image on this page using optical character recognition software:
CaWave User's Guide =L L ED
(by Ben-chin Cha) FED 4 ' 9
CaWave User's Guide explains how to use the CaWave functions which were specifically writtQ S T I
in PV-WAVE command language and C language for EPICS users. CaWave consists of a special
set of external channel access functions which provides the PV-WAVE users with easy and flexible
access of channel information across the IOC networks. It also provides a completes set of process
variable event monitoring functions.
This document also gives examples how a PV-WAVE user can interface to channel access devices.
It is assumed that the user is already familiar with using PV-WAVE[ 1 ]. Few simple example mod-
ules of using PV-WAVE command language with CaWave functions are also given in this
1. External CaWave Link Modules
Two types of modules are defined in CaWave: function and procedure. The function module returns
a value or an array of values to PV-WAVE. The procedure module returns nothing. To call a CaWave
function a user has to use the 'print' value command or define a PV-WAVE variable equal to the
return value of the called function. To call a CaWave procedure a user can directly type in the com-
The functions defined in CaWave conform to the following naming convention: all function names
begins with the prefix "Ca", and functions operating on a list of channel names end with the string
"List" . In general functions operating on a single channel return a single value and functions
operating on a list of channel names return a list of values.
The module names used in PV-WAVE CL version is not case sensitive, therefore a user can use low-
er case, upper case or mixed case. However, the string names or string values entered for parameter
or argument are case sensitive. The string used in CaWave is exact the same as user entered.
1. 1 Overview
The available CaWave link functions can be grouped into four categoriess: functions operating on
a single channel, functions operating on a list of channels, monitoring functions operating on a
single or multiple channels, and general functions for debugging or error handling. A user must
make sure that the channel name entered is defined in the database and the IOC is operating normally
when using values returned by these functions in his control program.
The single channel functions include CaGet, CaPut, CaGetString, CaPutString, CaGetValue,
CaInfo, CaStatus, CaGetStatus, CaGetCount, CaGetWF, and CaPutWF. They can be used
interactively to get a value back for a single channel or to set the value of a specified channel name.
The functions operating on a list of multiple channels include CaGetList, CaPutList,
CaGetStringList, CaPutStringList, CaInfoList, CaStatusList, CaGetStatusList, and
CaGetValueList. These functions can be used to get a list of values back for specified devices or
to set values for a specified list of devices.
DISTRIBUTION OF THIS DOCUMENT IS UNLIMITED,3 1 M A ST ER
CaWave User's Guide
September 1, 1993
Here’s what’s next.
This report can be searched. Note: Results may vary based on the legibility of text within the document.
Tools / Downloads
Get a copy of this page or view the extracted text.
Citing and Sharing
Basic information for referencing this web page. We also provide extended guidance on usage rights, references, copying or embedding.
Reference the current page of this Report.
Cha, Ben-chin. CaWave user`s guide, report, September 1, 1993; Illinois. (https://digital.library.unt.edu/ark:/67531/metadc670362/m1/1/: accessed April 22, 2019), University of North Texas Libraries, Digital Library, https://digital.library.unt.edu; crediting UNT Libraries Government Documents Department.