====== EyeLink Task Computer Setup ======
This page outlines steps needed to setup [[hardware:eyetracking:eyelink]] for in-scanner eye tracking. Also see the SR Research [[https://www.youtube.com/watch?v=OZHtPKEAir8&list=PLOdF-B36TwspbBsOFSAjtzVSpmUeFI7N_&index=9|participant setup video]] ((and to a lesser extent  the [[https://youtu.be/4qGTlSmbRuE?list=PLOdF-B36TwspbBsOFSAjtzVSpmUeFI7N_|Siemens Tray Mount]] and [[https://youtu.be/63iPjlb8vQE?list=PLOdF-B36TwspbBsOFSAjtzVSpmUeFI7N_|Eye Tracker Positioning (illuminator)]] video)).

A nascent (2025-04-03) checklist document is on [[https://pitt-my.sharepoint.com/:w:/g/personal/foran_pitt_edu/EUq9qIbe90RHgg6xfreaYEQBqpSPc8B1DNOb1FEzOmqYYA?e=QCrecM|here]]

Once the camera and task PC are setup, you likely want to run [[hardware:eyetracking:eyelink:calibration|SR Research EyeLink Calibration]]. 

Other eye tracking topics include [[hardware:eyetracking:eyelink:task_integration]],   [[hardware:eyetracking:eyelink:analysis]], and [[hardware:eyetracking:eyelink:install]].

===== Setup Steps =====
[[:scan:P1]] and [[:scan:P2]] have slightly different EyeLink configurations. In either, the two major steps are the same. You want to
  - [[hardware:eyetracking:eyelink:connection|connect]] the EyeLink Host PC to the Task computer (EPrime PC or Laptop) using the provided Ethernet cable and
  - present the camera view to the projector for the technologist using ''control64.exe'' ((desktop icon links to ''C:\Program Files (x86)\SR Research\EyeLink\SampleExperiments\'' from the [[https://www.sr-research.com/support/thread-13.html|EyeLink SDK]])).

<WRAP important> The Ethernet connection must be **attached before** starting and **removed after** finishing __each scan__ that will use eye tracking. ((A connected Ethernet cable can be problematical for [[:software:eprime]])). We'll also need to pull out and put back the EyeLink Mouse and Keyboard every time they are used. ((Multiple keyboards will be very confusing for other users.)) </WRAP>

{{ :hardware:eyetracking:eyelink:eyelinkatmrrc.svg?300 | }}
==== Prisma 1 ====
  - Display your laptop or the MRRC <wrap important>Win11</wrap> computer to the projector.
     * {{:hardware:eyetracking:eyelink:pasted:20250519-121045.png?200}}
  - Turn **on** the //EyeLink "Host PC"// tower under the desk \\ {{:hardware:eyetracking:eyelink:pasted:20250519-113853.png?direct&200}}
  - Attach the Ethernet cable to the <wrap important>bottom</wrap> yellow labeled "eyelink" port on the back of the Eyelink Host PC. \\ {{:hardware:eyetracking:eyelink:pasted:20250519-114024.png?100}} {{:hardware:eyetracking:eyelink:pasted:20250519-114210.png?200}}
  - Use **EPrime PC/Laptop** to connect to **EyeLink** with ''control64.exe'' \\ {{:hardware:eyetracking:eyelink:pasted:20250519-120059.png?300}} \\ {{:hardware:eyetracking:eyelink:pasted:20250519-115138.png?300}}
    * Blue eye icon on desktop OR ''C:\Program Files (x86)\SR Research\EyeLink\SampleExample\'' (from [[:hardware:eyetracking:eyelink:task_integration|SDK]])
    * <WRAP alert> If EPrime PC says "**Connection failed**" or EyeLink PC says "**CABLE FAULT**", check Ethernet cable from earlier is fully plugged in and in the bottom port. {{:hardware:eyetracking:eyelink:pasted:20250519-115624.png?200}} {{:hardware:eyetracking:eyelink:pasted:20250519-115823.png?200}} </WRAP>
    * <WRAP info>You should see a blank **gray screen** on the **EPrime PC** and **Link Open** on EyeLink  {{:hardware:eyetracking:eyelink:pasted:20250519-132142.png?100}}</WRAP>
  - Pull out the EyeLink keyboard and mouse \\ {{:hardware:eyetracking:eyelink:pasted:20250519-114822.png?200}}
  - Display the full eye image on the projector (cloned EPrime PC display) to help the technologist setup.
     * Push ''Enter'' to stream the EyeLink camera on the EPrime computer \\ {{:hardware:eyetracking:eyelink:pasted:20250519-122012.png?200}}
     * Push ''➡'' (right arrow key) to show the full image \\ {{hardware:eyetracking:eyelink:pasted:20241028-205802.png?150}} \\ <WRAP tip>The EyeLink display will contiue to show both views {{:hardware:eyetracking:eyelink:pasted:20250519-121710.png?200}} </WRAP>
  - Adjust and [[hardware:eyetracking:eyelink:calibration|Calibrate]]
  - Exit ''control64.exe''
    - tap ''Escape''
    - hold ''Control'' and tap ''c'' (ie. push ''Ctrl+c'')
      * Ctrl+c only works from the EPrime PC keyboard. Use **''Camera Setup''** & toggle **''Image->display''** from the EyeLink interface \\ {{:hardware:eyetracking:eyelink:pasted:20250519-132918.png?100}} {{:hardware:eyetracking:eyelink:pasted:20250519-132849.png?100}}
==== Prisma 2 ====

  - Use the EPrime PC
    * switch the eye tracking kvm box to ''1''  ((may be on display #2, showing screen for Avotech/Arrington eye tracking))  {{hardware:eyetracking:eyelink:pasted:20241028-210418.png?150}}
  - Ensure the EyeLink host PC (farthest left tower on lowest shelf) is on
  - Plug the "EyeLink" blue sticky labeled Ethernet cord into the **bottom** "EyeLink" labeled port. 
    * you may need to move the green tape to uncover the port \\ {{hardware:eyetracking:eyelink:pasted:20241027-152116.png}} {{hardware:eyetracking:eyelink:pasted:20241027-152059.png?150}} 
  - click the blue eye icon "calibration" (''control.exe'') on the desktop to run the eye video presenting software
  - show video once launched and gray screen is presented
    - push **enter** on the keyboard to display the eye video
    - push **right arrow** to see the full (un-zoomed) video collected by the tracker  {{hardware:eyetracking:eyelink:pasted:20241028-205802.png?150}}
  - confirm eye is in focus and good thresholds can be set (see [[hardware:eyetracking:eyelink:calibration]])
  - exit the video screen
    - push the **Escape** key
    - hold **control** and tap **c**, release all keys