% contents.m
% VVRC Matlab IFIS interface version 1.0  
% author: allen.w.ingling @vanderbilt.edu
%
% This set of functions executes from within Matlab on a Macintosh PowerPC, 
% communicating with hardware components of the IFIS system manufactured by Psychology
% Software Tools Inc. (PST).  If you use the Psychophysics Toolbox to generate
% stimuli during a functional MRI experiment, then use this package of functions 
% to record subject responses within Matlab and to align the record 
% of those responses with the MRI scanner record. 
%
% The VVRC interface to IFIS hardware consists of a National Instruments parallel 
% digital IO card (model PCI-DIO-96) and these functions.  The functions include 
% .mex files which control the National Instruments card  and .m files which 
% abstract out hardware details to offer a simple programming interface.%
%
%
%
% Miscellaneous files:
%
%   FMRIdemo.m           - simple experiment which demonstrates use of interface.
%   NiPS.m               - graphical display of bit state and transitions.  Useful for 
%                          hardware debug.
%   RectCenter.m		 - a new psychtoolbox function used by FMRIdemo.m (in case you haven't upgraded).
%   CenterRectOnPoint.m  - a new psychtoolbox function used by FMRIdemo.m (in case you haven't upgraded).
%  
% The following top-level functions are intended to be called from scripts controlling
% your experiment:
%
%   InitializeFMRI.m     - initializes the PCI-DIO-96 
%   GetButtons.m		 - reads the current state of the subject response buttons 
%   WaitScanner.m        - waits for the onset of the scanner, use to synchronize your reponse
%                          button records with the MRI scans.
%   ButtonName           - maps between button names and button codes.
%	
% The following subordinate functions are used by the top level functions above. You shouldn't 
% need to call them directly from your experiment scripts.  
%
%   Board_ID.m
%   Board_ID.mex         - returns the NI identification number of the board in a specified slot
%
%   DIG_In_Port.m
%   DIG_In_Port.mex      - reads the value of a port
%
%   DIG_Out_Port.m
%   DIG_Out_Port.mex     - set the value on a port (not used)
%
%   DIG_Prt_Config.m
%   DIG_Prt_Config.mex   - set the data direction of a port 
%
%   FindCard.m		     - finds the slot number of a specified card.
%
%   NiDeviceName.m       - maps between NI device names and numbers
%
%
%
%  
% history:
%  1/27/00 awi created file.
%  2/2/00  awi minor edits.


