Eyelink Toolbox - How To Install
The precise procedure depends on your OS and the EyelinkToolbox version. We assume you have already installed the PsychToolbox and are familiar with the basics of Matlab. We are also assuming that the operator PC is functioning properly, and that the subject PC/Mac and operator PC are connected properly via ethernet (check the documentation provided by SR Research if you're not sure about this).
Apple Macintosh
Macintosh OSX (EyelinkToolbox 2, OpenGL version)
If you have downloaded and installed the latest version of the Psychophysics Toolbox (version 3) you already have the Eyelink Toolbox! It's in the PsychHardware/EyelinkToolbox folder.
Before you can actually use the toolbox with your Eyelink Gazetracker, you need to install some libraries provided by SR Research. (If you are opening this site for the first time, you need to register and login first. On the forum, go to the download section, and click on the "Eyelink Display Software" section. In this section, go to the "Mac OSX C Display Software" section and download the "Eyelink_Developers_Kit_For_MacOSX_beta.zip" (or the "Eyelink DV and Developers Kit for macosx.zip" but this version will only work on Powerpc Macs). The kit contains an installer that will install the required libraries in /Libraries/Frameworks).
Once installed, you are ready to track!
To get familiar with the toolbox, try out some of the demos (in PsychHardware/EyelinkToolbox/EyelinkDemos subdirectory).
Typing Eyelink at the Matlab prompt provides an overview of possible Eyelink commands.
Macintosh OS9 (EyelinkToolbox 1)
Download the OS9 EyelinkToolbox for Macintosh.
Put it in your favorite place, e.g. in the same directory were you also keep the PsychToolbox.
Make sure you add the directory that contains the EyelinkToolbox to your Matlab path.
You are ready to track!
To get familiar with the toolbox, try out some of the demos (in the EyelinkDemos subdirectory).
Typing eyelink at the Matlab prompt provides an overview of possible Eyelink commands.
Microsoft Windows
EyelinkToolbox 2 (OpenGL version) for PsychToolbox-3
If you have downloaded and installed the latest version of the Psychophysics Toolbox (version 3) you already have the Eyelink Toolbox! It's in the PsychHardware/EyelinkToolbox folder.
Thanks to Mario Kleiner, as of 25-10-2006, the beta version of the PsychToolbox-3 includes an Eyelink.dll which is based on the same code as the OS-X version, i.e. EyelinkToolbox 2.
Before you can actually use the toolbox with your Eyelink Gazetracker, you need to install libraries provided by SR Research. (If you are opening their site for the first time, you need to register and login first. On the forum, go to the download section, and click on the "Eyelink Display Software" section. In this section, go to the "Mac OSX C Display Software" section and download the "Eyelinkdevkit_win32_1.5.59.zip". The kit will install the required libraries.
Note that if you already use the old Eyelink.dll from the old ETB (see below), you'll have to delete or rename the file before starting the update, otherwise the update will fail.
To get familiar with the toolbox, try out some of the demos (in the EyelinkDemos subdirectory).
Typing Eyelink at the Matlab prompt provides an overview of possible eyelink commands.
EyelinkToolbox 1 for PsychToolbox 2
Download the EyelinkToolbox for Windows.
Put it in your favorite place, e.g. in the same directory were you also keep the PsychToolbox.
Make sure you add the directory that contains the EyelinkToolbox to your Matlab path.
The windows version also requires that you have the libraries (dll's) installed that came with the Eyelink software. Not having the proper dll's installed may lead to somewhat obscure error messages. Follow this link for info.
You should be ready to track!
To get familiar with the toolbox, try out some of the demos (in the EyelinkDemos subdirectory).
Typing eyelink at the Matlab prompt provides an overview of possible eyelink commands.
EyelinkToolbox 1 for PsychToolbox-3
The old Eyelink toolbox is not a 100% compatible with the PsychToolbox-3 Screen version. Most likely you want to consider using the EyelinkToolbox 2 (OpenGL version) for PsychToolbox-3 (see above). Nevertheless, if you insist, to get basic functionality you could try the following:
1. Use the code from the EyelinkToolbox 2 (standard included with PsychToolbox-3), as the M-Files are adapted to work with the new Screen command.
2. Download the Eyelink-1 Toolbox for Windows and copy the Eyelink.dll mex-file into the new EyelinkToolbox's path (Psychtoolbox/PsychHardware/EyelinkToolbox/EyelinkBasic/; note capitalizing Eyelink.dll is important), so that it gets called by the new EyelinkToolbox.
3. Cross your fingers. At least basic functionality should work.
To get familiar with the toolbox, try out some of the demos (in the EyelinkDemos subdirectory).
(There were still some issues with the demos. There is a temporary cross-platform demo available.)
Typing eyelink at the Matlab prompt provides an overview of possible eyelink commands.
But, as said, we recommend using the EyelinkToolbox 2 (OpenGL version).
