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
Source Repository
The sources are in the CVS repository under extensions/mca.
For anonymous read-only access, try
cvs -d:pserver:anonymous@epics.cvs.sourceforge.net:/cvsroot/epics login cvs -z3 -d:pserver:anonymous@epics.cvs.sourceforge.net:/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 |
| mcadebug | Enable/disable debugging |
| mcaversion | Get version info |
| mcaunlock | Unlocks the MCAMAIN mex-file |
| mcaexit | Shut down channel access |
