EyeLink II Installation Guide · Ensure that the power supply setting on the back of the PC (Near the power jack) matches your local supply voltage! 2.1 Recommended Computer Configurations

EyeLink II Installation Guide Version 1.11

Copyright 1994-2002, SR Research Ltd.

EyeLink is a registered trademark of SR Research Ltd, Mississauga, Canada

EyeLink II Installation Guide (11/2/2003) 2002 SR Research Ltd. ii

Read instructions before use.

Type BF equipment (applied parts): Metal parts connected to chassis of computer may contact user. Compliance with 601-1 medical equipment standards requires use of a medical grade power supply.

Entela Safety Mark: Compliance of this product with UL 2601-1, CSA C22.2 N0.601.1 and IEC 60601-1 is certified by Entela, an independent testing body.

EyeLink II Installation Guide (11/2/2003) 2002 SR Research Ltd. iii

Table of Contents

1. Introduction........................................................................................................1 1.1 Suggested Equipment Layout ............................................................. 1 1.2 Pre-installation Checklist.................................................................... 3

2. Hardware Installation.........................................................................................5 2.1 Recommended Computer Configurations............................................ 5

2.1.1 Host PC........................................................................................................5 2.1.2 Display PC ...................................................................................................5

2.2 Unpacking .......................................................................................... 6 2.3 Configuration...................................................................................... 6

2.3.1 EyeLink II PCI Card......................................................................................6 2.3.2 Headband Installation...................................................................................7 2.3.3 Marker Cable installation..............................................................................7 2.3.4 Ethernet Cable .............................................................................................8 2.3.5 EyeLink System Cabling ..............................................................................8

3. Software Installation........................................................................................10 3.1 Host PC............................................................................................. 10

3.1.1 Operating System Setup ............................................................................10 3.1.2 Installing into an existing Windows 98 SE partition.....................................10 3.1.3 Installing to a Computer Running Windows NT/2000/XP............................11 3.1.4 Testing the Host PC installation .................................................................26

3.2 Display PC Installation (Windows)..................................................... 28 3.2.1 Installing the Experiment Programming Kit.................................................28 3.2.2 Installing the IO Port Access Driver............................................................29 3.2.3 Windows Network Setup ............................................................................29 3.2.4 System and Programming Tools Required.................................................30

4. Final Installation steps ....................................................................................31 4.1 Configuring the physical.ini file for standard display monitors ......... 31 4.2 Configuring physical.ini for non-standard display monitors.............. 32

4.2.1 Measuring the marker_phys_coords ..........................................................32 4.2.2 Measuring screen_phys_coords.................................................................34 4.2.3 Entering values into physical.ini .................................................................35

5. Troubleshooting...............................................................................................36

EyeLink II Installation Guide (11/2/2003) 2002 SR Research Ltd. iv

5.1 Problem 1: Receive error 203 when Partition Magic is creating 1024 MB partition space....................................................................................... 36 5.2 Problem 2: Boot Magic Error Message............................................... 36 5.3 Problem 3: Incomplete File Copying .................................................. 38

EyeLink II Installation Guide (11/2/2003) 2002 SR Research Ltd. v

List of Figures Figure 1: Suggested EyeLink System Layout ........................................................................ 2 Figure 2. Side View of EyeLink II PCI Card Connectors. ....................................................... 7 Figure 3: Marker Set-up on EyeLink Display Monitor ............................................................ 8 Figure 4: System Set-up and Cabling. .................................................................................. 9 Figure 5: PartitionMagic Application Window with the FAT32 Partition to Convert

Selected.........................................................................................................................13 Figure 6: Convert the Fat32 partition ....................................................................................14 Figure 7: Select NTFS as the Target Partition Format..........................................................14 Figure 8: Select OK after Reading the Warning Notice ........................................................15 Figure 9: Apply Conversion to NTFS File Format .................................................................15 Figure 10: PartitionMagic Application Window with Partition to Resize Selected ..................16 Figure 11: PartitionMagic Resize/Move Partition Dialog .......................................................17 Figure 12: PartitionMagic Create Partition Dialog. ................................................................18 Figure 13: PartitionMagic Application after EyeLink II Partition has been Created................19 Figure 14: BootMagic Add Boot Option Dialog .....................................................................20 Figure 15: BootMagic Boot Item Properties Dialog ...............................................................21 Figure 16: BootMagic Application Window after Adding EyeLink II Boot Option ...................22 Figure 17: Windows Explorer Tools → Folder Options… Dialog...........................................24 Figure 18: PartitionMagic Resize/Move Partition Dialog for EyeLink II Data Partition ...........25 Figure 19: PartitionMagic Create Partition Dialog for DATA Partition....................................26 Figure 20: EyeLink II Tracker Application in Offline Mode at Startup. ...................................27 Figure 21: EyeLink II Tracker Application Camera Setup Screen. ........................................28 Figure 22: Marker_Phys_coords 1,2....................................................................................33 Figure 23: Marker_Phys_coords 3,4....................................................................................33 Figure 24: Marker_Phys_coords 5,6....................................................................................34 Figure 25: Marker_Phys_coords 7,8....................................................................................34 Figure 26: Measuring screen_phys_coords ..........................................................................35 Figure 27: Run dialog box ....................................................................................................37 Figure 28: Find key entries ...................................................................................................37

EyeLink II Installation Guide (11/2/2003) 2002 SR Research Ltd. 1

1. Introduction

IMPORTANT: Before proceeding with the EyeLink II installation ensure you have backed up all important data on your Host PC.

The basic steps in installing the EyeLink II system are:

1) Unpack and Install the EyeLink II Hardware. This includes connecting the Host PC to the Display PC via an Ethernet link.

2) Install necessary Operating System and EyeLink II Host Application software on the PC your have selected to act as your Host PC.

3) Install the EyeLink II Windows Software (API and example experiments) on the Display PC.

4) Test the installation.

The installation process will take about 2 hours, so try and do it when you have this amount of time to dedicate to the process.

If you have questions or encounter a problem during the installation process, please contact SR Research through one of the contact channels listed at:

http://www.eyelinkinfo.com/contact.htm

If you would like to ensure that a technical representative is available for direct phone support during your installation, please contact your SR Research representative to book a time for installation phone support. We will ensure that a technical representative is available to speak on the phone with you if required during your installation if you inform us of your installation time with at least 1 weeks notice.

1.1 Suggested Equipment Layout

The layout of the EyeLink equipment is important if participant setup is to be convenient, and lighting problems are to be avoided. Before setting up equipment, check the arrangement of the room to be used against these suggestions. These will aid in the production of good experimental data.

• Set up the host and display monitors and PCs on tables arranged in an ‘L’ shape, as in Figure 1. This configuration allows the experimenter to set up


the headband and the participant’s left eye camera, while having access to both computer keyboards and monitors.

Figure 1: Suggested EyeLink System Layout

• Avoid windows or other bright light sources that could cause reflections on the host and display monitors. Windows or incandescent lights on the walls behind or near the display monitor may interfere with the head-tracking camera. The grey walls in Figure 1 are locations where bright light sources will cause reflections.

• Supply sufficient light in the room. Dim rooms cause participant’s pupils to dilate, which can cause setup problems with some participants. The best way to light the room is with ceiling-mounted fluorescent lights, above and no more than 2 meters behind the computer monitors. Painting the walls light colors or white will maximize ambient light as well.

• Avoid environmental distractions. Be sure the room can be kept quiet, that no posters or other items are on the wall seen by the participant, and so on. It is also a good idea to make sure the participant cannot see the host monitor, without turning their head (discourage this).

• Supply a comfortable, stable chair for the participants. It should not wobble or move when sat in, and the back should be firmly attached to the seat--springiness encourages some subjects to rock forwards and back. A chair with a concave back and seat also discourages shifting of the body, as does a high back. The top of the chair back should be just below the shoulders on an average participant. Finally, make sure participants can enter and leave


the chair easily, as the chair will be close to the table with the Display PC monitor. A fixed base reclining dental chair has proven to be an ideal participant and EyeLink friendly chair.

• Set up the Display PC monitor and chair so that the participant’s eyes will be at a distance from the monitor of about twice the width of the display area of the Display monitor. This distance gives a display area of 28° by 22°, and a resolution of about 22 pixels per visual degree at screen center. This standard distance is assumed in all EyeLink documentation: while the EyeLink system can measure and compensate for the eye-to-display distance, this is the ideal distance for both calibration accuracy and head-motion compensation.

1.2 Pre-installation Checklist

Ensure that you have the following resources available before you start installation:

1. EyeLink II system:

a. PCI card

b. Headband

c. Button Box

d. Marker cables

2. “EyeLink II Software” CD

3. 1 WIN98SE Boot floppy (included with your EyeLink II system) labeled “WIN98SE Boot Disk”

4. 3 blank floppy disks for creation of your PartitionMagic Rescue Disk 1, PartitionMagic Rescue Disk 2, and BootMagic Rescue Disk 1. (Included with your EyeLink II system)

5. A Host PC that meets the minimum required specifications. These specifications are listed in section 2.1.1.

6. A Display PC that meets the minimum required specifications. These specifications are listed in section 2.1.2.

7. Any tools required for accessing your Host PC’s case (usually a Phillips screwdriver will do).

8. Ethernet cable to connect Host and Display PC together.


9. Button Box or Game Pad if purchased. (Each has a floppy disk with relevant driver information.)

10. Analog card if purchased. (Has own instruction leaflet and installation floppy disk.)

NOTE: The analog card and Overlay Device are additional extras which do not come with the standard EyeLink II system. These EyeLink II input devices can be purchased and installed at a later date if required.


2. Hardware Installation

IMPORTANT: Switch off the PCs before connecting or disconnecting any cables, especially the headband connection! Ensure that the headband cable is properly connected and connectors are properly secured to the Host PC and the headband before use.

Ensure that the power supply setting on the back of the PC (Near the power jack) matches your local supply voltage!

2.1 Recommended Computer Configurations

2.1.1 Host PC The PC that will host the EyeLink II card must meet certain requirements. These are:

• 900 MHz or faster processor (Celeron, Pentium 3 or 4, AMD, etc). • 40-80 GB hard disk with 7,200rpm (hard disks larger than 80 GB must

be partitioned by version 8 of the disk partitioning software. Please make sure you have the latest version.)

• Video card supporting 1024x768 resolution, 256 color mode using the VESA 2.0 BIOS.

• A CD-ROM writer for software installation and data backup. • At least 512 MB RAM • At least one free PCI slot for a half-length PCI card (3 free slots

recommended) • Minimum 160W power supply (200W recommended), capable of

supplying at least 0.2A on the –12V output. See the Specifications for the full power requirements of the EyeLink II system. A medical-grade power supply is required for medical (601-1 and equivalent) standard compliance.

• A serial, PS/2 or USB mouse or other pointing device • A non-USB keyboard • Optional USB port for button box and mouse support (UHCI-compatible

only) • Optional operating system: Windows 95/98/NT/2000/XP for use in data

backup, maintenance and data analysis. • Optional Ethernet card for use on local network (the EyeLink card has

its own dedicated Ethernet port for direct connection to the display PC). • 14” or larger monitor

2.1.2 Display PC


The specifications for the PC that will be used for system calibration and experiment presentation depend greatly on the type of experimental paradigms that the EyeLink II will be used for. For example, gaze contingent paradigms generally require more computing power than simple cognitive paradigms because the computer display needs to be updates as quickly as possible. The following requirements are suggestions for a Display PC configuration that should be able to handle most experimental requirements. Please contact a SR Research Ltd. Representative if you have specific questions about your situation and would like our input.

• > 1 GHz or faster processor (Pentium 4 or AMD). We recommend at least 1.5 GHz processor.

• 40-80 GB hard disk with 7,200rpm • Video card supporting horizontal refresh rates of > 160Hz • A CD-ROM writer for software installation and data backup. • At least 256 MB RAM (512 MB recommended) • Windows 2000 or XP • 19” or larger monitor that supports horizontal refresh rates of > 160Hz

and vertical refresh rates of > 100kHz. • Ethernet card to connect Display PC to EyeLink II Host PC. • Optional Ethernet card for use on local network (a separate network card

should be used to connect to the EyeLink system) • A keyboard and mouse or other pointing device.

2.2 Unpacking

Open the shipping case. If the system has been stored or transported at a temperature below 10°C, allow all parts to warm to room temperature before proceeding.

IMPORTANT: Save the shipping case and all packing material for storage or in case the unit needs to be returned for repair.

2.3 Configuration

2.3.1 EyeLink II PCI Card Open the EyeLink II host PC, and insert the EyeLink II card into a free PCI slot. It is recommended that an open slot be left on one side of the card (preferably on the side with the large parts). Ensure the bracket is firmly attached to the PC.


Figure 2. Side View of EyeLink II PCI Card Connectors.

IMPORTANT: Do not insert VGA monitor cable into Marker connector.

2.3.2 Headband Installation

IMPORTANT: Do not let the headband 26-pin connector receive an electro-static shock from a carpeted floor or similar surface.

Remove the EyeLink II headband and cable from the case. Remove the cable tie from the headband cable. Hold the headband by the top clamp while gently letting the cable fall free, and allowing any twists in the cable to straighten. It is very important to avoid twists in this cable, as these will stiffen it and may shorten its lifespan. Plug the headband cable into the large connector on the EyeLink II card (see Figure 2), and secure with the screw posts (do not over-tighten, this is just to prevent connector from coming loose). Ensure the cable is laid out where it will not be twisted, stood on or rolled over by chairs, etc. Remove the camera covers from the eye cameras on the headband.

2.3.3 Marker Cable installation

Unpack and straighten the marker cable. Attach the 4 supplied Velcro patches to the corners of the Display monitor (see Figure 3). Route the marker cable behind the monitor, and run the 4 separate wires along the sides of the monitor. Attach the 4 markers to the Velcro patches, and dress wires as desired. Plug the marker cable into the second connector on the back of the EyeLink II card, and secure with the screw posts (do not over-tighten, this is just to prevent connector from coming loose).


Figure 3: Marker Set-up on EyeLink Display Monitor

2.3.4 Ethernet Cable

Unpack the supplied Ethernet cable, and plug the end with the black box into the Ethernet jack (between the two cables) on the back of the EyeLink II card. The supplied cable should connect directly to an Ethernet card in the display PC without using a hub. You will need a different cable and a low-speed hub to connect the EyeLink II card to multiple display computers. It is not recommended to use a high-speed or multi-speed hub, as this will cause dropped packets.

2.3.5 EyeLink System Cabling

For system set-up, please follow the wiring diagram below (see Figure 4).

The basic cabling steps are:

1. Attach the keyboards, mouse, power cords, etc. to the PCs. This has probably already been completed.

2. Connect the monitors. The 19” or greater monitor with markers is attached to the Display PC, and the 14” or greater monitor to the host PC. Some monitors have power cords that will plug into the switched socket on the PC power supply.

3. Plug the cable from the monitor markers into the 9-pin connector on the back of the EyeLink II card.


4. Attach the ends of the Ethernet cable to the Ethernet cards in the two PCs.

Figure 4: System Set-up and Cabling.

5. Plug the EyeLink II headband cable directly into the EyeLink adapter connector on the back of the PC.

6. Plug the supplied USB game pad into a USB port on the Host PC. Use the optional USB extender cable if the game pad needs to have a cord longer than 3 feet.

NOTE: The USB game pad must be directly connected to a USB port on the Host computer and cannot be connected through a USB hub.


3. Software Installation

Both the Host PC and Display PC need to be configured for use with the EyeLink II system.

3.1 Host PC

3.1.1 Operating System Setup

The first step in preparing your Host PC for the EyeLink II is to setup the win98 SE operating system that the EyeLink II system requires to run. If the Host PC you will be using already has the WIN98 second edition operating system on it, please follow the steps outlined in 3.1.2. If your Host PC runs a more recent operating system like windows 2000 or windows XP, follow the steps in 3.1.3.

3.1.2 Installing into an existing Windows 98 SE partition.

It is possible to configure an existing Windows 98 SE system to run the EyeLink Tracker software. This is achieved by changing your Windows 98 SE configuration to start in command line mode when your systems boots instead of immediately launching the Windows GUI. Three system files will need to be added or modified to your system. All files mentioned in this section can be found in the Installation→ Win98_installation folder of the EyeLink II Software CD. Follow these steps to update your system to run the EyeLink II Tracker application:

a) If there is an msdos.sys file in the root directory of your system; rename the file to msdos.sys.org.

b) Copy the msdos.sys found in the Win98_installation folder of the software CD to your root directory (c:\) on the Host PC.

c) If there is not an existing autoexec.bat file in your system root directory, copy the autoexec.bat file contained in the Win98_installation folder of the software CD to your root directory. If there is an autoexec.bat file in your system root directory, contact SR Research Ltd. to obtain information on how to modify this file. If you are comfortable with modifying this file yourself, first back it up, and then ensure the lines listed in the sample autoexec.bat file contained in the Win98_installation folder of the software CD are included in your autoexec.bat.


d) If there is not an existing config.sys file in your system root directory, copy the config.sys file contained in the Win98_installation folder of the software CD to your root directory. If there is a config.sys file in your system root directory, contact SR Research Ltd. to obtain information on how to modify this file. If you are comfortable with modifying this file yourself, first back it up, and then ensure the lines listed in the sample config.sys file contained in the Win98_installation folder of the software CD are included in your config.sys.

e) Copy the t.bat and mouse.exe files found in the Win98_installation folder of the software CD to your system root directory.

f) Copy the eyelink2 directory located in the Win98_installation folder of the software CD to your root directory.

g) Restart your system. You should be presented with a command prompt.

h) Go to section 3.1.3.5 (creating the EyeLink data partition) to continue with the installation process.

3.1.3 Installing to a Computer Running Windows NT/2000/XP.

The version of WIN98se that is provide with the EyeLink II system is a trimmed version of the OS that only runs in command line mode and loads the minimum set of files necessary. Therefore, you will want to keep your existing operating system accessible so that you can access your CDRW drive etc. when required. To achieve this you will create a partition on your hard drive using PartitionMagic that will host the WIN98se OS provided with your EyeLink II system and a second partition to store your EyeLink II data files. BootMagic will then be used to allow you to choose which operating system you wish to launch when you start the Host PC.

If your Host PC is a new computer, be sure you have started your computer and have gone through any necessary system setups steps (like configuring the computer for your network), before you proceed with the EyeLink II installation.

3.1.3.1 Install Partition Magic and Boot Magic

a) Install Partition Magic. Your EyeLink system came with a copy of the required PartitionMagic software.


i. Insert the “EyeLink II Software” CD into your CD drive

ii. Open the “Installation → PMagic” Folder on the CD and select the AUTORUN.exe icon by double clicking on it with your mouse.

iii. Select PartitionMagic and select Install. Follow the intructions to install the PartitionMagic software. The installation key for the software is PM800EN1-023031918. You are only licensed for 1 copy of this software for use on the EyeLink Host PC.

Important: Create the PartitionMagic rescue disks when prompted during PartitionMagic installation. We have included 2 blank floppy disks with your system for this purpose.

iv. Reboot your computer.

b) Install BootMagic. Your EyeLink system came with a copy of the required BootMagic software.

i. Insert the “EyeLink II Software” CD into your CD drive.

ii. Open the “Installation → PMagic” Folder on the CD and select the AUTORUN.exe icon by double clicking on it with your mouse.

iii. Select BootMagic and follow the instructions to install the BootMagic software.

NOTE: If you receive a message starting “BootMagic cannot be installed because there are no visible FAT16 or FAT32 primary partitions...” during installation, you will need to continue with the installation without installing BootMagic at this time. You will have to install BootMagic after a FAT32 partition is created.

IMPORTANT: Create the BootMagic rescue disk when prompted during BootMagic installation. We have included a blank floppy disk with your system for this purpose.


3.1.3.2 Create the EyeLink II Host Application Disk Partition from a Fat32 format Primary Partition

Partition Magic may experience problems with FAT32 Primary Partitioned hard drives. It is strongly recommend that you convert the FAT32 partition into a NTFS partition and then follow the next section entitled “Create the EyeLink II Host Application Disk Partition from a NTFS format Primary Partition”. This procedure should only take an estimated 20 minutes.

a) Start PartitionMagic by selecting Programs → PowerQuest PartitionMagic 8.0 → PartitionMagic 8.0.

b) Select the Fat32 partition you want to convert (see Figure 5).

Figure 5: PartitionMagic Application Window with the FAT32 Partition to Convert Selected

c) Right click on the mouse and select “Convert …” from the menu (see Figure 6).


Figure 6: Convert the Fat32 partition

d) Select NTFS as the target partition format (see Figure 7).

Figure 7: Select NTFS as the Target Partition Format

e) Select “OK” if you can read the text as stated in the warning message (see Figure 8).


Figure 8: Select OK after Reading the Warning Notice

f) Select “Yes” to complete the conversion (see Figure 9).

Figure 9: Apply Conversion to NTFS File Format

3.1.3.3 Create the EyeLink II Host Application Disk Partition from a NTFS Format Primary Partition

a) Resize existing partition to make space for ELII Host Application partition. In this installation example, we create a 1024 MB partition; this is an example only. You can create the partition with as little space as 256 MB if required.

i. Start PartitionMagic by selecting Programs → PowerQuest PartitionMagic 8.0 → PartitionMagic 8.0.

ii. Select the partition you want to split to create the EyeLink partition (see Figure 10). The partition you select to split should have at least 20 GB of space allocated to it.


Figure 10: PartitionMagic Application Window with Partition to Resize Selected

iii. Select Menu Operations → Resize/Move.

iv. Enter 1024 MB in the “Free Space Before” field.

v. Press OK on the “Resize/Move” Dialog (see Figure 11).

NOTE: PartitionMagic will adjust the partition size you entered slightly. This is expected and is not an issue.


Figure 11: PartitionMagic Resize/Move Partition Dialog

vi. Press “General → Apply” on the PartitionMagic application window. Press Yes to “Apply New Changes” Dialog. PartitionMagic will reboot your system before it proceeds. The process of resizing your partition can take up to 20 minutes, so be patient.

vii. Once the operation is complete, your computer will automatically be restart. If your original OS boots fine, continue with the installation, otherwise contact SR Research Ltd. technical support.

b) Create the ELII Host Application partition

i. Start PartitionMagic by selecting Programs → PowerQuest PartitionMagic 8.0 → PartitionMagic 8.0.

ii. Select the 1024 MB partition created in the previous step.

iii. Select menu Partition → Create. Enter the following information and then press OK (see Figure 12).

Create As Primary Partition

Type FAT32

Label EyeLink II


Figure 12: PartitionMagic Create Partition Dialog.

iv. Select menu General → Apply. Press Yes to “Apply New Changes” Dialog.

v. Restart your computer and ensure that your original OS still boots fine.

vi. Open PartitionMagic and check that it has correctly formatted the FAT32, EyeLink II hard drive partition. (see Figure 13).


Figure 13: PartitionMagic Application after EyeLink II Partition has been Created.

3.1.3.4 Make the EyeLink II Partition Bootable

NOTE: If you were not able to install BootMagic as instructed earlier, follow the BootMagic installation procedure now. BootMagic will install on the EYELINK II partition you just created. You cannot continue with the EYELINK II Host installation until BootMagic has been successfully installed.

IMPORTANT: Remember to create the BootMagic rescue disk during the BootMagic installation.


a) Start the BootMagic application.

b) Press the “Add” button.

c) Enter “EyeLink II” as the Name (see Figure 14).

Figure 14: BootMagic Add Boot Option Dialog

d) Press OK.

e) For each partition listed in Boot Magic other than the EyeLink II partition:

i. Select the partition

ii. Select Properties

iii. Select the “Visible Partitions” tab on the partition and select the “Override Default Selections” checkbox (see Figure 15).

iv. Check all available partitions.

v. Press OK.


Figure 15: BootMagic Boot Item Properties Dialog

f) Press the “Save/Exit” button.

g) Restart the computer. You should be able to select the EyeLink partition (NOTE: since we have not yet installed the OS on this partition, the computer will just hang after selecting the EyeLink partition).

h) Restart the computer again and select the Windows NT / 2000 / XP partition. Figure 16 shows the BootMagic application window after adding EyeLink II boot option.


Figure 16: BootMagic Application Window after Adding EyeLink II Boot Option

3.1.3.5 Install the EyeLink II Operating System and program files.

a) Insert the floppy disk labeled “WIN98SE Boot Disk”, that you received with your EyeLink II system, into your floppy drive.

b) Reboot the computer.

c) Select “Start Computer without CD-ROM support” when prompted.

IMPORTANT: The following step requires you to determine the correct drive letter (c:, d:, etc) for the EyeLink II partition you created above after booting with the WIN98se Boot Disk. Determine this by calling the dir command for each drive to find the EyeLink II drive label and substitute that drive letter (c:, d:, etc) in place of {EYELINK II_DRIVE} below. It is likely that the drive letter will be either c: or d:

d) At the command prompt (a:\>) type the following commands:


cd {EYELINK II_DRIVE} [ENTER]

sys {EYELINK II_DRIVE} [ENTER]

e) Remove the floppy disk from the floppy drive.

f) Reboot the computer and select the EyeLink II partition to boot at the BootMagic dialog. You should see a c:\> prompt at the command line. If you do not, the EyeLink II partition is not bootable and you should repeat the steps in this section from the point of booting from the WIN98se Boot disk.

g) Reboot your computer and start your original NT / 2000 / XP partition.

h) Start Windows Explorer. You should see a drive representing the EyeLink II partition.

i) Copy the EyeLink OS files to the EyeLink II drive. Your EyeLink II system came with a copy of all the files required for the EyeLink II OS partition.

i. Insert the “EyeLink II Software” CD into your CD drive

ii. Open the “Installation → Host PC Partition” folder.

iii. Select the Tools → Folder Options… menu in Windows Explorer.

iv. Select the View tab.

v. Select the “Show hidden files and folders” option under Hidden files and folders.

vi. Ensure “Hide extensions for known file types” is not selected.

vii. Uncheck the “Hide protected Operating system files….” (see Figure 17)


Figure 17: Windows Explorer Tools →→→→ Folder Options… Dialog.

viii. Press OK.

ix. Select all files in the “Host PC Partition” folder.

x. Copy these files to the root directory of the EyeLink II drive on your computer.

xi. Reboot your computer. You should be able to select the EyeLink drive and boot into the EyeLink OS. If this is successful, a command prompt will be displayed.

3.1.3.6 Create the EyeLink II Data Partition

a) Resize existing partition to make space for ELII Host Application partition.


i. Start Partition Magic by selecting Programs → PowerQuest PartitionMagic 8.0 → PartitionMagic 8.0.

ii. Select the partition you want to split to create the EyeLink Data partition. The space you can allocate for the Data partition depends on the size of the partition you select. Ensure that the space you allocate for the Data partition leaves enough room on the selected partition for it’s original purpose to still function. In this example, we will resize the primary NT / 2000 / XP partition and leave > 30GB for the OS to function in.

iii. Select Partition → Resize/Move.

iv. Enter the amount of space you want to allocate to the EyeLink Data partition in the Free Space After Field. Here we enter 30,000 MB (see Figure 18).

Figure 18: PartitionMagic Resize/Move Partition Dialog for EyeLink II Data Partition

v. Press “OK”.

vi. Select General → Apply Changes and allow Partition Magic to reboot your system. Ensure you select the NT / 2000 / XP partition on the Boot Magic menu.


b) Create the EyeLink Data Partition.

i. Start Partition Magic again.

ii. Select the unallocated space you just created.

iii. Select Partition → Create. Enter the following information (see Figure 19):

Create As Logical Partition

Type FAT32

Label DATA

Figure 19: PartitionMagic Create Partition Dialog for DATA Partition.

iv. Select General → Apply Changes.

v. Reboot the system after Partition Magic has completed necessary operations. Select the EyeLink II partition on the Boot Magic boot screen. You should now be able to select the d: drive and access the DATA partition you just created.

3.1.4 Testing the Host PC installation The Host PC is now ready to test. Start the EyeLink II Tracker application by typing


cd c:\ [Enter]

t [Enter] The EyeLink II Host application should start and you should see the EyeLink II Host screen (see Figure 20).

Figure 20: EyeLink II Tracker Application in Offline Mode at Startup.

Press [Enter] and you should be taken to the Setup Screen where you can see the 3 EyeLink camera images. a) Put the headband in front of the head camera markers and see that

the head camera is picking up the markers. b) Put on the headband and see that the eye cameras are picking up

image (see Figure 21).


Figure 21: EyeLink II Tracker Application Camera Setup Screen.

3.2 Display PC Installation (Windows)

To integrate with the EyeLink II system, the Windows API and sample experiments need to be installed on the Display computer. This process is much less complicated than the Host PC installation and should not take more than 15 minutes. The installation process consists of the following basic steps:

a) Install the EyeLink Windows Developers Kit

b) Install the supplied IO port access driver.

c) Setup the network connection to the EyeLink II Host PC.

3.2.1 Installing the Experiment Programming Kit

To install the sample experiments and useful EyeLink utilities, click on the “setup.exe” installer program on the “EyeLink II Software” CD. This will copy in


the source code, shared libraries, and utility programs. If you didn’t change any of the default settings of the installer program, the sample experiments and utilities can be found in the directory C:\Program Files\SR Research\Eyelink\. You shall still have to change the computers TCP/IP address for Ethernet communication with the EyeLink Host computer and may want to install a LINX I/O Driver as covered in the next two sections.

3.2.2 Installing the IO Port Access Driver

For proper access to IO ports on the Display PC, an access driver must be installed. This is normally auto-installed as part of the Windows API setup. The EyeLink II Windows API relies on this driver for IO port access so it’s installation is mandatory. To install the driver manually, start the PORT95NT.EXE executable that is located in the utilizes folder of the “EyeLink II_Win_API” directory. Follow the step by step installation, selecting the typical install option when prompted. Reboot your computer after the installation is complete. If you have installed the Windows API on your display PC the PORT95NT.EXE executable will be automatically stored in the Display PC’s EyeLink utilities folder. If you wish to quickly find this executable press the Windows button on your keyboard + “F” and type in PORT95NT.EXE, then double-click on the files found to install.

3.2.3 Windows Network Setup

You must have an Ethernet card installed in your PC. Allow Windows to install drivers for it (if it is a new card), then follow these instructions to install and configure the TCP/IP network protocol. These instructions are based on Windows XP, other Windows operating systems may vary slightly.

1. From the Start menu select the Control Panel.

2. Click on the Network and Internet Connections icon, then select the network Connections icon. Check the list of installed components to make sure a network card is installed. If not, install a driver for the card.

3. Double click on the network card icon that represents the network card that will be connected to the EyeLink II Host PC.

4. Select the properties button.

5. Check that “TCP/IP” is displayed in the list of components and that it is checked. If not, press the checkmark beside the option.


6. Select the “TCP/IP” component for the Ethernet card connected to the eye tracker PC, then click on the “Properties” button.

7. Select the “Use the following IP address” radio button. Enter the IP address of “100.1.1.2”. The last digit of the IP address can increase for other computers on the EyeLink network. Enter the subnet mask of “255.255.255.0”. Leave the default gateway and other setting blank.

8. Click on “OK” to return to the Properties dialog. Click “OK” again to save your changes. Click “Close” to exit from the network card dialog.

You should now restart Windows. If error messages appear at startup, you may need to reinstall the network card drivers. To be safe, open the Network dialog and remove all components, restart Windows, then install the network card driver and the TCP/IP protocol again.

To test the network, start the EyeLink tracker and start the track application by clicking on its icon in the EyeLink II_Win_API directory on the Display PC. The link should connect, and the screen will display instructions. This application allows you to practice participant setup and test the system, as described in the EyeLink II installation guide. If the message “Cannot initialize link” appears, the TCP/IP protocol is not properly configured. If the connection times out, it is probably due to the network card being improperly configured or because the network cable is not connected to both PCs.

3.2.4 System and Programming Tools Required

The experiment templates in this package were developed using Microsoft Visual C 6.0, which is the standard compiler for C applications today. Other 32-bit C and C++ compilers may be used, but you will have to translate the included make files to rebuild the experiments.

This release of the toolkit does not supply examples for C++ programming.


4. Final Installation steps

This section lists the final installation steps to fine tune your EyeLink II installation.

4.1 Configuring the physical.ini file for standard display monitors

The EyeLink II physical.ini file contains settings that tell the system about the physical size of the display monitor. By default the physical.ini file is setup to work with a 19” display monitor, and no adjustments are required to this file if the target system matches this setup. The settings for 17” and 21” monitors are also contained within the physical.ini file. The parameters in the physical.ini file that change depending on the size of the display monitor are: marker_phys_coord – specifies the physical coordinates of the IR markers, relative to the center of the screen. The order of these coordinates is top-left, bottom-left, top-right, bottom-right and are specified in millimeters. For the default case of a 19” monitor this parameter will read. marker_phys_coords = -210,140, -210,-140, 210,140, 210,-140 screen_phys_coord – specifies the physical distance of the four edges of the presentation surface, to the center of the screen. The order of these measurements is left, top, right, bottom and are specified in millimeters. For the default case of a 19” monitor this parameter will read. screen_phys_coords = -178.0, 135.0, 178.0, -135.0 screen_pixel_coord – specifies the resolution of the display surface. Normally this is programmatically adjusted by the EyeLink II API at the start of an experiment. If the EyeLink II API is not being used, then default value for this parameter will apply. The default value reads. screen_pixel_coords = 0.0, 0.0, 640.0, 480.0 To determine the display screen resolution, click anywhere on the Windows Desktop and press the mouse right button and select “properties”. Select Display Properties> Settings and make a note of the ‘Screen Area’. Should the target system differ from the default of 19” monitor and 640x480 pixels, the physical.ini file must be changed. To do this, open the EyeLink II application physical.ini file by typing the following at the command prompt cd c:\eyelink2\exe

attrib –R physical.ini

edit physical.ini


The settings for marker_phys_coords and screen_phys_coords for 17” and 21” monitors are already specified in the physical.ini file. The user needs only to remove the comment from the parameter required for the new setup. To do this.

1. Go to the marker_phys_coords parameter 2. Remove the comment by deleting the two semi-colons that precede the

required parameter 3. Insert two semi-colons before the old parameter 4. Repeat steps 1-3 for screen_phys_coords 5. Repeat steps 1-3 for screen_pixel_coords 6. Save changes and exit the file

Finish by typing the following at the command type

attrib +R physical.ini

4.2 Configuring physical.ini for non-standard display monitors.

This section details the changes that are required to the physical.ini file, should the dimensions of the display differ from those mentioned above. All screen marker measurements are in millimeters. It is recommended that a straight ruler and a sharp pencil be used to mark a reference line, half-way between the IR markers, on either side of the plastic surface of the monitor outer casing. These marks are required for accurate display screen measurement, and should be removed after the physical.ini file has been successfully amended.

IMPORTANT: If a display computer is not being used, then non-permanently mark the middle of the Display and follow the steps within this section of the manual. Use the pencil marked point as if it was the drift dot generated by the Display PC in track.exe.

Turn on both the EyeLink Host and Display PC and run track.exe on the Display PC. Type in “123” for the saved EDF file name and click the OK box. Press “Enter” on either keyboard twice. On the Host PC go to “Set Options” on the screen and select “mouse simulation” mode. This will now let you use the Host PC mouse to simulate eye movements. Check that the Calibration Type is set to a nine-point pattern. Press “Previous Screen” button to return to the camera setup screen. Now press “C” or the calibration button. A calibration dot should appear on the middle of the display monitor. Use this dot as the central reference point for all horizontal and vertical physical.ini measurements.

4.2.1 Measuring the marker_phys_coords


Ideally the IR markers should be placed on the screen as illustrated in Fig 1. Obtain the measurements as described in the following steps and record these values for inclusion into the physical.ini file. Step 1: Measure the distance from the calibration dot, to the reference line in the middle of the IR markers(1). Also, record half the distance between the IR markers(2) This is illustrated in Figure 22.

Figure 22: Marker_Phys_coords 1,2

Step 2: Measure the distance from the calibration dot, to the reference line in the middle of the IR markers(3). Also, record half the distance between the IR markers(4). This is illustrated in Figure 23.


Step 3: Measure the distance from the calibration dot, to the reference line in the middle of the IR markers(5). Also, record half the distance between the IR markers(6) This is illustrated in Figure 24.



Step 4: Measure the distance from the calibration dot, to the reference line in the middle of the IR markers(7). Also, record half the distance between the IR markers(8) This is illustrated in Figure 25.


The new settings for the marker_phys_coords in the physical.ini file are determined by: marker_phys_coords = -(1),(2), -(3),-(4), (5),(6), (7),-(8)

4.2.2 Measuring screen_phys_coords In the screen_phys_coors, measure the distance from the center of the dot to the end of the active part of the monitor screen. Start on the left side(S1) and follow round to the top(S2), right(S3) and bottom(S4). This is illustrated in Figure 26.


Figure 26: Measuring screen_phys_coords

The new settings for the screen_phys_coords in the physical.ini file are determined by: screen_phys_coords = -(S1), (S2), (S3), -(S4)

4.2.3 Entering values into physical.ini The newly acquired values for marker_phys_coords and screen_phys_coords must now be entered into the physical.ini located on the Host PC. Re-boot the Host PC and do not press “T” when in MS-Dos before running the EyeLink GUI. If you are in the EyeLink GUI press “Ctrl + Alt + Q” or the ‘Exit EyeLink’ Button. From the command prompt type the following cd c:\eyelink2\exe

attrib –R physical.ini

edit physical.ini

To enter the new values, follow these steps

1. Go to the marker_phys_coords parameter 2. Remove the comment by deleting the two semi-colons that precede the

‘for non-standard monitor’ parameter 3. Enter new values 4. Insert two semi-colons before the old parameter 5. Repeat steps 1-3 for screen_phys_coords 6. Save changes and exit the file

Finish by typing the following at the command type

attrib +R physical.ini


5. Troubleshooting

5.1 Problem 1: Receive error 203 when Partition Magic is creating 1024 MB partition space

Solution: Run chkdsk /f to fix disk issue and then redo the PartitionMagic operation.

5.2 Problem 2: BootMagic Error Message

Solution: Make sure that the EyeLink installation CD is in the Host CD-Rom drive. This problem with the BootMagic occurs when the user reboots the computer immediately after installing BootMagic. The solution is in the following 4 steps: 1) uninstall the BootMagic, 2) make the EyeLink partition visible, 3) re-install the BootMagic and DON'T REBOOT, and 4) configure the BootMagic settings.

Step 1: Uninstall the BootMagic

Special steps are required to un-install the BootMagic because the Windows Add/Remove program option will not work. The user must remove all BootMagic-related items from the system, including all items related to the product GUID for BootMagic. The product GUID for BootMagic 8.0 is {B838AD63-FD0C-482C-B124-7116748BAC45} and for BootMagic 7.0 is {e9b100f7-f36f-40e7-93d6-bb4c5377aae4}.

1. Start Windows explorer, select the Tools -> Folder Options… menu, select the View tab, and select the “Show hidden files and folders” option under Hidden files and folders (see Figure 17).

2. From the operating system where BootMagic is installed, go to C:\Program Files\InstallShield Installation Information and remove the directory {B838AD63-FD0C-482C-B124-7116748BAC45} or {e9b100f7-f36f-40e7-93d6-bb4c5377aae4}.

3. Go to the Temp directory (for example, C:\Windows\Temp if you are using Windows 98, or C:\Documents and Settings\<username used to install BootMagic>\Local Settings\Temp if you are using Windows XP) and remove the directory {B838AD63-FD0C-482C-B124-7116748BAC45} or {e9b100f7-f36f-40e7-93d6-bb4c5377aae4}.


4. Remove the directory where BootMagic was installed (i.e., E:\Btmagic.pq).

5. Run Regedit, Click Start → Run. In the Run dialog box, type Regedit and click the ‘OK’ button (see Figure 27).

Figure 27: Run dialog box

6. Start by highlighting “My Computer”, do a global search for the product GUID {B838AD63-FD0C-482C-B124-7116748BAC45} or {e9b100f7-f36f-40e7-93d6-bb4c5377aae4}, and remove all matching key entries (see Figure 31).

Figure 28: Find key entries


Step 2: make the EyeLink Partition visible

1. Highlight the EyeLink II Partition.

2. From the 'Operations' menu select 'Advanced' and then 'Unhide Partition'. This will unhide the EYELINK II partition.

3. Make sure to 'Apply Changes' before exiting Partition Magic. This is done from the 'General' menu then 'Apply Changes'.

4. Don't reboot the computer; otherwise, this will make the EyeLink II partition hidden again.

Step 3: Re-install the BootMagic

Follow the instruction given by the BootMagic. DO NO'T REBOOT the computer.

Step 4: Configure the BootMagic settings.

Follow the installation given in the installation guide to make the EyeLink partition bootable.

5.3 Problem 3: Incomplete File Copying

When the host PC reboots from the EyeLink partition, it gives out the following message: The following file is missing or corrupted: C:\WINDOWS\EMM386.EXE here is an error in your CONFIG.SYS file on line 2 The following file is missing or corrupted: C:\WINDOWS\SETVER.EXE here is an error in your CONFIG.SYS file on line 8 The following file is missing or corrupted: C:\WINDOWS\RAMDRIVE.SYS here is an error in your CONFIG.SYS file on line 12 The following file is missing or corrupted C:\WINDOWS\HIMEM.SYS The following file is missing or corrupted C:\WINDOWS\IFSHLP.SYS Warning: the high memory area (HMA) is not available. Additional low memory (below 640K) will be used instead


Also, when type in "t", the computer gives out the following message. BIOS did not enable DMA master access Improper configuration of EyeLink by BIOS Solution: Redo section 3.1.3.5 Install the EyeLink II Operating System and program files, make sure that “Show hidden files and folders” option of the Windows Explorer is enabled.