Matlab Channel Access (mca)
This is an EPICS Channel Access client interface for Matlab.
- Andrei Terebilo (SLAC) is the original author.
- Several people provided enhancements, see release notes.
The package provides interfaces to most of the EPICS Channel Access functionality (get/put/monitor). Refer to the matlab online help of the mca*.m files for usage.
Source Code snapshots
The sources are in the CVS repository under extensions/mca.
For anonymous read-only access, try
cvs -d:pserver:firstname.lastname@example.org:/cvsroot/epics login cvs -z3 -d:pserver:email@example.com:/cvsroot/epics co -P extensions/mca
For write access, use your SF account:
cvs -z3 -d :ext:YOUR_NAME@epics.cvs.sourceforge.net:/cvsroot/epics co -P extensions/mca
A list of functions
The following functions will be available in Matlab (or Octave), each with their own online help accessible within Matlab:
|mcaopen||open a Channel Access connection to an EPICS Process Variable (PV)|
|mcaisopen||Check if a channel to a PV is open with mcaopen|
|mcacheckopen||returns handle(s) to PV(s). If the channel was not open, a new connection is opened.|
|mcaclose||permanently closes channels|
|mcatimeout||set or display MCA timeout settings|
|mcastate||returns an array of connection states for open channels|
|mcacheck||Same as mcastate|
|mcaput||Write values to EPICS Process Variables, wait for put to finish (completion callback)|
|mcaputnowait||Write values to EPICS Process Variables, do not wait for completion|
|mcaget||Read values from PV's|
|mcagets||Read values from PV's, with string output for ENUMs|
|mcapoll||Poll channel access|
|mcamon||Install or replace monitor on a PV|
|mcaclearmon||Uninstall monitors, previously installed with mcamon|
|mcamonevents||Returns the number of monitor events which have occurred for channels since the last call to MCACACHE.|
|mcamontimer||Controls the initialization and termination of the MATLAB timer used to poll the MCA monitor command queue|
|mcacache||Reads locally cached value of a PV.|
|mcainfo||Get connection status and other information about a PV|
|mcaalarm||Read alarm status and severity for PVs previously read with MCAGET or MCAMON|
|mcatime||Read timestamps for PVs previously read with MCAGET or MCAMON|
|mcaenums||Read enum strings from PV's|
|mcaegu||Read engineering units from PV's|
|mcaprec||Read precision from PV's|
|mcaversion||Get version info|
|mcaunlock||Unlocks the MCAMAIN mex-file|
|mcaexit||Shut down channel access|