EyeLinkâ II Installation Guide Version 2.0
Copyright ã1994-2002, SR Research Ltd. EyeLink is a registered trademark of SR Research Ltd, Mississauga, Canada
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.
EyeLinkII Installation Guide (12/2/2003) ã 2002 SR Research Ltd. ii 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 EyeLinkII 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 EyeLinkII System Cabling...... 8 3. Software Installation...... 10 3.1 Host PC...... 10 3.1.1 Operating System Setup...... 10 3.1.2 Installing to a Computer Running Windows NT/2000/XP...... 10 3.1.3 Testing the Host PC installation ...... 23 3.2 Display PC ...... 25 3.3 Windows Installation...... 25 3.3.1 Installing the EyeLinkII Experiment Programming Kit...... 25 3.3.2 Installing the IO Port Access Driver...... 25 3.3.3 Setting up EyeLinkII Network Connection...... 26 3.3.4 System and Programming Tools Required ...... 27 4. Final Installation steps...... 28 4.1 Configuring the physical.ini file for standard display monitors...... 28 4.2 Configuring physical.ini for non-standard display monitors...... 29 4.2.1 Measuring the marker_phys_coords ...... 29 4.2.2 Measuring screen_phys_coords...... 31 4.2.3 Entering values into physical.ini...... 32
EyeLinkII Installation Guide (12/2/2003) ã 2002 SR Research Ltd. iii 5. Troubleshooting...... 33 5.1 Problem 1: Receive error 203 when Partition Magic is creating 1024 MB partition space ...... 33 5.2 Problem 2: BootMagic Error Message ...... 33 5.3 Problem 3: Incomplete File Copying ...... 35 5.4 Converting file sytem from FAT32 to NTFS ...... 36
Figures
Figure 1-1: Suggested EyeLinkII System Layout ...... 2 Figure 2-1 EyeLinkII PCI Card Connectors...... 6 Figure 2-2: Marker Set-up on EyeLinkII Display Monitor...... 8 Figure 2-3: System Set-up and Cabling...... 9 Figure 3-1: PartitionMagic Application Window with Partition to Resize Selected ...... 12 Figure 3-2: PartitionMagic Application Window before Applying Resize Change ...... 13 Figure 3-3: PartitionMagic Resize/Move Partition Dialog...... 13 Figure 3-4: PartitionMagic Create Partition Dialog...... 14 Figure 3-5: PartitionMagic Application Window after EyeLinkII Partition has been created...... 15 Figure 3-6: BootMagic Partition Properties...... 16 Figure 3-7: BootMagic Boot Item Properties Dialog...... 17 Figure 3-8: BootMagic Application Window after Adding EyeLinkII Boot Option...... 18 Figure 3-9: Windows Explorer Tools ® Folder Options… Dialog...... 20 Figure 3-10: PartitionMagic Resize/Move Partition Dialog for EyeLinkII Data Partition...... 21 Figure 3-11: PartitionMagic Create Partition Dialog for DATA Partition...... 22 Figure 3-12: EyeLinkII Tracker Application in Offline Mode at Startup...... 23 Figure 3-13: EyeLinkII Tracker Application Camera Setup Screen...... 24 Figure 4-1: Marker Set-up on EyeLinkII Display Monitor...... 30 Figure 4-2: Marker_Phys_coords 1,2 ...... 30 Figure 4-3: Marker_Phys_coords 3,4 ...... 30 Figure 4-4: Marker_Phys_coords 5,6 ...... 31 Figure 4-5: Marker_Phys_coords 7,8 ...... 31 Figure 4-6: Measuring screen_phys_coords...... 32 Figure 5-1: Run dialog box...... 34 Figure 5-2: Find key entries...... 34 Figure 5-3: Select the Fat32 partition...... 36
EyeLinkII Installation Guide (12/2/2003) ã 2002 SR Research Ltd. iv Figure 5-4: Select NTFS File System ...... 37 Figure 5-5: Select the OK after reading the Warning Notice ...... 37 Figure 5-6: Apply Conversion ...... 38
EyeLinkII Installation Guide (12/2/2003) ã 2002 SR Research Ltd. v 1. Introduction
IMPORTANT: Before proceeding with the EyeLinkII installation ensure you have backed up all important data on your Host PC.
The basic steps in installing the EyeLinkII system are:
1) Unpack and Install the EyeLinkII Hardware. This includes connecting the Host PC to the Display PC via an Ethernet link.
2) Install necessary Operating System and EyeLinkII Host Application software on the PC your have selected to act as your Host PC.
3) Install the EyeLinkII 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 EyeLinkII 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-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.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 1
Figure 1-1: Suggested EyeLinkII 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 highlighted in Figure 1-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 EyeLinkII friendly chair.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 2 · 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 EyeLinkII documentation: while the EyeLinkII 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. EyeLinkII system:
a. PCI card
b. Headband
c. Button Box
d. Marker cables
2. “EyeLinkII Software” CD
3. 1 WIN98SE Boot floppy (included with your EyeLinkII 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 EyeLinkII 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.)
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 3
NOTE: The analog card and Overlay Device are additional extras which do not come with the standard EyeLinkII system. These EyeLinkII input devices can be purchased and installed at a later date if required.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 4 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 EyeLinkII 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 EyeLinkII system. A medical-grade power supply is required for medical (601-1 and equivalent) standard compliance. · A PS/2 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 EyeLinkII 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 EyeLinkII 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
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 5 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 > 100kHz. · Ethernet card to connect Display PC to EyeLinkII Host PC. · Optional Ethernet card for use on local network (a separate network card should be used to connect to the EyeLinkII 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 EyeLinkII PCI Card
Open the EyeLinkII host PC, and insert the EyeLinkII 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-1 EyeLinkII PCI Card Connectors
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 6
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 EyeLinkII 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 EyeLinkII card (see Figure 2-1), 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 as illustrated in Figure 2-2. 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 EyeLinkII card, and secure with the screw posts (do not over-tighten, this is just to prevent connector from coming loose).
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 7 Figure 2-2: Marker Set-up on EyeLinkII 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 EyeLinkII 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 EyeLinkII 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 EyeLinkII System Cabling
For system set-up, please follow the wiring diagram in Figure 2-3.
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 EyeLinkII card.
4. Attach the ends of the Ethernet cable to the Ethernet cards in the two PCs.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 8
Figure 2-3: System Set-up and Cabling.
5. Plug the EyeLinkII headband cable directly into the EyeLinkII 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.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 9 3. Software Installation
Both the Host PC and Display PC need to be configured for use with the EyeLinkII system.
3.1 Host PC
3.1.1 Operating System Setup
The first step in preparing your Host PC for the EyeLinkII is to install the Win98 SE operating system that the EyeLinkII system runs on.
3.1.2 Installing to a Computer Running Windows NT/2000/XP.
The version of Win98 SE that is provide with the EyeLinkII 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 EyeLinkII system and a second partition to store your EyeLinkII 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 EyeLinkII installation.
3.1.2.1 Install Partition Magic
Install Partition Magic. Your EyeLinkII system came with a copy of the required PartitionMagic software.
1. Insert the “EyeLinkII Software” CD into your CD drive
2. Open the “Host PC Installation folder on the CD and run the partitionmagic.bat file by double clicking on it with your mouse.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 10 3. 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 EyeLinkII 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.
4. Reboot your computer.
3.1.2.2 Create the EyeLinkII Host Application Disk Partition
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.
1. Start PartitionMagic by selecting Programs ® PowerQuest PartitionMagic 8.0 ® PartitionMagic 8.0.
2. Select the drive you want to create the EyeLinkII partition on as illustrated in Figure 3-1. The drive you select must have at least 20 GB of space allocated to it.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 11 Figure 3-1: PartitionMagic Application Window with Partition to Resize Selected
3. Select Menu Operations ® Resize/Move.
4. Enter 1024 MB in the “Free Space Before” field.
5. Press OK on the “Resize/Move” Dialog as illustrated in Figure 3-3.
NOTE: PartitionMagic will adjust the partition size you entered slightly. This is expected and is not an issue. See Figure 3-2 as confirmation that local drive has been resized and new partition outlined.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 12 Figure 3-2: PartitionMagic Application Window before Applying Resize Change
Figure 3-3: PartitionMagic Resize/Move Partition Dialog
6. From the PartitionMagic application window select General ® Apply . Select Yes to “Apply New Changes”. PartitionMagic will now reboot system. The process of resizing your partition can take up to 20 minutes, so be patient.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 13 7. Once the operation is complete, your computer will automatically restart. Once the original OS boots back up as expected, continue with the installation, otherwise contact SR Research Ltd. technical support.
3.1.2.3 Create the ELII Host Application partition
1. Start PartitionMagic by selecting Programs ® PowerQuest PartitionMagic 8.0 ® PartitionMagic 8.0.
2. Select the 1024 MB partition created in the previous step, as illustrated in Figure 3-2.
3. From the PartitionMagic application window select Partition ® Create. Enter the following information and then press OK as illustrated in Figure 3-4.
Create As Primary Partition
Type FAT32
Label EyeLinkII
Figure 3-4: PartitionMagic Create Partition Dialog.
4. Select menu General ® Apply. Press Yes to “Apply New Changes” Dialog.
5. Restart your computer and ensure that your original OS still boots fine.
6. Open PartitionMagic and check that it has correctly formatted the FAT32, EyeLinkII partition as illustrated in Figure 3-5.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 14
Figure 3-5: PartitionMagic Application Window after EyeLinkII Partition has been created.
3.1.2.4 Install Boot Magic
The EyeLinkII system came with a copy of the required BootMagic software.
1. Insert the “EyeLinkII Software” CD into your CD drive.
2. Open the “Host PC Installation folder on the CD and run the bootmagic.bat file by double clicking on it with your mouse.
3. Follow the instructions to install the BootMagic software.
IMPORTANT: Create the BootMagic rescue disk when prompted during BootMagic installation. We have included a blank floppy disk with your
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 15 system for this purpose.
4. DO NOT REBOOT COMPUTER.
3.1.2.5 Make the EyeLinkII Partition Bootable
1. Start the BootMagic application.
2. Highlight Win98/MS-Dos partition
3. Select Properties.
4. In the Name box, rename bootable partition to EyeLinkII as illustrated in Figure 3-6.
Figure 3-6: BootMagic Partition Properties
5. Press OK.
6. For each partition listed in BootMagic other than the EyeLinkII partition:
i. Select the partition
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 16 ii. Select Properties
iii. Select the “Visible Partitions” tab on the partition and select the “Override Default Selections” checkbox as illustrated in Figure 3-7.
iv. Check all available partitions.
v. Press OK.
Figure 3-7: BootMagic Boot Item Properties Dialog
Figure 3-8 shows the BootMagic application window after adding EyeLinkII boot option.
7. Press the “Save/Exit” button.
8. Restart the computer. You should be able to select the EyeLinkII partition (NOTE: since we have not yet installed the OS on this partition, the computer will just hang after selecting the EyeLinkII partition).
9. Restart the computer again and select the Windows NT / 2000 / XP partition.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 17
Figure 3-8: BootMagic Application Window after Adding EyeLinkII Boot Option
3.1.2.6 Install the EyeLinkII Operating System and program files.
1. Insert the floppy disk labeled “WIN98SE Boot Disk”, that came with the EyeLinkII system, into your floppy drive.
2. Reboot the computer.
3. 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 EyeLinkII partition you created above after booting with the WIN98se Boot Disk. Determine this by using the dir command (e.g. dir c:) for each drive to find the EyeLinkII drive label and substitute that drive letter (c:, d:, etc) in place of {EYELINKII_DRIVE} below. It is likely that the drive letter will be either c: or d:
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 18 4. At the command prompt type the following commands:
cd {EYELINKII_DRIVE} [ENTER]
sys {EYELINKII_DRIVE} [ENTER]
5. Remove the floppy disk from the floppy drive.
6. Reboot the computer and select the EyeLinkII partition to boot at the BootMagic dialog. You should see a c:\> prompt at the command line. If you do not, the EyeLinkII partition is not bootable and you should repeat the steps in this section from the point of booting from the WIN98se Boot disk.
7. Reboot your computer and start your original NT / 2000 / XP partition.
8. Start Windows Explorer. You should see a drive representing the EyeLinkII partition.
9. Copy the EyeLinkII OS files to the EyeLinkII drive. Your EyeLinkII system came with a copy of all the files required for the EyeLinkII OS partition.
i. Insert the “EyeLinkII Software” CD into your CD drive
ii. Open the “Host PC Installation ® Host 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….” as illustrated in Figure 3-9
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 19
Figure 3-9: Windows Explorer Tools ® Folder Options… Dialog.
viii. Press OK. ix. Select all files in the “Host Partition” folder. x. Copy these files to the root directory of the EyeLinkII drive on your computer. xi. Select the Tools ® Folder Options… menu in Windows Explorer. xii. Select the View tab. xiii. Deselect the “Show hidden files and folders” option under Hidden files and folders. xiv. Ensure “Hide extensions for known file types” is selected. xv. Check the “Hide protected Operating system files….”
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 20 xvi. Reboot your computer. You should be able to select the EyeLinkII drive and boot into the EyeLinkII OS. If this is successful, a command prompt will be displayed.
3.1.2.7 Create the EyeLinkII Data Partition
Resize existing partition and create new partition to store ELII data files.
1. Start Partition Magic by selecting Programs ® PowerQuest PartitionMagic 8.0 ® PartitionMagic 8.0.
2. Select the partition you want to split to create the EyeLinkII 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.
3. Select Partition ® Resize/Move.
4. Enter 5000 in the Free Space After field, as illustrated in Figure 3-10
Figure 3-10: PartitionMagic Resize/Move Partition Dialog for EyeLinkII Data Partition
5. Press “OK”.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 21 6. 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.
7. Start Partition Magic again.
8. Select the unallocated space you just created.
9. Select Partition ® Create. Enter the information from the following table as illustrated in Figure 3-11.
Create As Logical Partition
Type FAT32
Label DATA
Figure 3-11: PartitionMagic Create Partition Dialog for DATA Partition.
10. Select General ® Apply Changes.
11. Reboot the system after Partition Magic has completed necessary operations. Select the EyeLinkII 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.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 22 3.1.3 Testing the Host PC installation The Host PC is now ready to test. Start the EyeLinkII Tracker application by typing
cd c:\ [Enter] t [Enter]
The EyeLinkII Host application should start and you should see the EyeLinkII Host screen illustrated by Figure 3-12.
Figure 3-12: EyeLinkII 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. 1. Put the headband in front of the head camera markers and see that the head camera is picking up the markers. 2. Put on the headband and see that the eye cameras are picking up image as illustrated in Figure 3-13.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 23
Figure 3-13: EyeLinkII Tracker Application Camera Setup Screen.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 24 3.2 Display PC
The Display PC is used to run experiment application software for control of the EyeLinkII tracker and stimulus presentation through the EyeLinkII API. This API is available on Windows, MacOS and Linux platforms. The Display PC installation process is much less complicated than the Host PC installation and should not take more than 15 minutes. Installation instructions for each platform are detailed below.
3.3 Windows Installation
To integrate the EyeLinkII system with Windows, the C API and sample experiments need to be installed on the Display computer. The installation process consists of the following basic steps:
· Install the EyeLink Experiment Programming Kit
· Install the supplied IO Port Access Driver.
· Setup the network connection to the EyeLinkII Host PC.
3.3.1 Installing the EyeLinkII Experiment Programming Kit
The Windows toolkit (API and example files) is available on the “EyeLinkII Software” CD in the “Display PC Installation” directory. To install the toolkit, follow these instructions.
1. Insert CD marked EyeLinkII Software
2. Open the “Display PC Installation ? Windows” folder
3. Run the eyelink_display1.0.exe program by double clicking the icon
4. Follow the instructions from the InstallShield Wizard to install the display software
5. Wait for the InstallShield Wizard to finish, and click FINISH to complete installation
3.3.2 Installing the IO Port Access Driver
For proper access to IO ports on the Display PC, an access driver must be installed. The EyeLinkII Windows API relies on this driver for IO port access so installation is mandatory.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 25 1. To install the driver, click Start ? Programs ? SR Research EyeLink ? Ulilities ? PORT95NT.
2. Follow the on screen instructions.
3. Reboot your computer when prompted.
3.3.3 Setting up EyeLinkII Network Connection
You must have an Ethernet card installed in your Display Computer. 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 EyeLinkII 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 EyeLinkII tracker and start the track application by clicking on its icon in the EyelinkII_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 EyeLinkII
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 26 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.3.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.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 27 4. Final Installation steps
This section lists the final installation steps to fine tune your EyeLinkII installation.
4.1 Configuring the physical.ini file for standard display monitors
The EyelinkII 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 EyeLinkII API at the start of an experiment. If the EyeLinkII 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 EyeLinkII 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.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 28 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 monitor be non-standard.
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 EyeLinkII 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 Figure 4-1. Obtain the measurements as described in the following steps and record these values for inclusion into the physical.ini file.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 29
Figure 4-1: Marker Set-up on EyeLinkII Display Monitor
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 4-2.
Figure 4-2: 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 4-3
Figure 4-3: Marker_Phys_coords 3,4
Step 3:
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 30 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 4-4.
Figure 4-4: Marker_Phys_coords 5,6
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 4-5.
Figure 4-5: Marker_Phys_coords 7,8
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 4-6.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 31
Figure 4-6: Measuring screen_phys_coords
The new settings for the screen_phys_coords in the physical.ini file are determined by screen_phys_coords = -1, 2, 3, -4
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 EyeLinkII GUI. If you are in the EyeLinkII 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
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 32 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 EyeLinkII 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 EyeLinkII 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.
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\
4. Remove the directory where BootMagic was installed (i.e., E:\Btmagic.pq).
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 33 5. Run Regedit, Click Start ® Run. In the Run dialog box, type Regedit and click the ‘OK’ button as illustrated in Figure 5-1.
Figure 5-1: 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 as illustrated in Figure 5-2.
Figure 5-2: Find key entries
Step 2: make the EyeLinkII Partition visible
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 34 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 EyeLinkII partition bootable.
5.3 Problem 3: Incomplete File Copying
When the host PC reboots from the EyeLinkII 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 EyeLinkII by BIOS
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 35
Solution: Redo section 3.1.2.6 Install the EyeLinkII Operating System and program files. Make sure that “Show hidden files and folders” option of the Windows Explorer is enabled.
5.4 Converting file sytem from FAT32 to NTFS
To convert a file system from FAT32 to NTFS, follow the steps outlined below.
1. Start PartitionMagic by selecting Programs ® PowerQuest PartitionMagic 8.0 ® PartitionMagic 8.0.
2. Select the Fat32 partition you want to convert as illustrated in Figure 5-3.
Figure 5-3: Select the Fat32 partition
3. From the Partition menu select Convert.
4. Select the NTFS file system as shown in Figure 5-4.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 36
Figure 5-4: Select NTFS File System
5. Select “OK” if you can read the text as stated in the Warning message.
Figure 5-5: Select the OK after reading the Warning Notice
6. Select “Yes” to apply the conversion.
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 37 Figure 5-6: Apply Conversion
EyeLink II Installation Guide (12/2/2003) ã 2002 SR Research Ltd. 38