>Psychtoolbox>PsychHardware

Syntax: PortNumber = FindSerialPort([PortString][, forIOPort=1][, dontFail=0])

Purpose: Find serial port number/name associated with a particular input string.

If the optional parameter ‘PortString’ is omitted, the routine will use a
built-in list of default serial port names to search for. Otherwise it
will try to find a serial port with a name matching ‘PortString’.

The optional flag ‘forIOPort’ has no meaning anymore, is ignored, and only
exists for backwards compatibility with ancient code. This function will
always return a serial port device string in ‘PortNumber’ suitable for use
with the IOPort serial port driver which works on all operating systems and
runtime environments.

By default, the function will abort with an error message if it doesn’t
find a matching useable port, or if it finds multiple matches, ie. if the
mapping is ambiguous. If you set the optional flag ‘dontFail’ to 1, it
will continue in such cases without any error message: It will simply
return an empty [] PortNumber if no matching port can be found, or the
1st detected matching port, if multiple matches exist.

For intersting in-depths comments on the use of this function with PR-650
style photometers, read the source code of this file.