EyeLink System Documentation

EyeLink System Documentation
EyeLink II Installation Guide
Version 1.11
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.
EyeLink II Installation Guide (11/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
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
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.
5.
Display PC Installation (Windows)..................................................... 28
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
Troubleshooting...............................................................................................36
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
iii
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.
iv
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.
v
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
1
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
2
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 headmotion 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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
3
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.
EyeLink II Installation Guide (11/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 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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
5
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
6
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 overtighten, 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).
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
7
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
8
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.
EyeLink II Installation Guide (11/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
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
10
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
11
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
12
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).
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
13
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).
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
14
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
15
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
16
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
17
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).
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
18
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
19
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
20
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
21
Figure 16: BootMagic Application Window
Adding EyeLink II Boot Option
after
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:
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
22
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)
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
23
Figure 17: Windows
Options… Dialog.
Explorer
Tools
→
Folder
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
24
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
25
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
26
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).
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
27
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
28
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
29
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
30
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
31
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
32
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.
Figure 23: Marker_Phys_coords 3,4
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
33
Figure 24: 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 25.
Figure 25: 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 26.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
34
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
35
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 CDRom 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 {e9b100f7f36f-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}.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
36
4. Remove the
E:\Btmagic.pq).
directory
where
BootMagic
was
installed
(i.e.,
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
37
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
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
38
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.
EyeLink II Installation Guide (11/2/2003)  2002 SR Research Ltd.
39
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising