====== Habit sEEG Protocol ======

===== Administering =====


 TODO: MATLAB INSTRUCTIONS


===== Retrieving Data =====

Initially stored on Able's OneDrive. Data copied to ''Hera''.
<code>
/Volumes/Hera/Raw/sEEG/
</code>
===== Photodiode =====

2024-08-20 SM
  * We have acquired a new photodiode that plugs directly into the ripple device (analog input 3) 
  * Runs smoothly with no issues so far
  * The diode lives in a ring box with a whole drilled into it and command strips to the task computer


===== Administering Web Browser version =====

Initially run XXX but replaced by Matlab/psychtoolbox version in mid 2024.

<WRAP alert>Documentation below for posterity only.</WRAP>

  * Give headphones to participant and make sure the audio cable is plugged into the task computer 
  * Log into lncd account on the task computer 
    * Password: same as Taylor's lab
  * Open new terminal window
  * cd in luna folder if you want to run:
    * To check if the rt box is working <code> python ./http_ttl.py test_rtbox </code> 
    * To test the DAQ pulses <code> ./http_ttl.py test_DAQ </code>
    * If you run <code> ./http_ttl.py </code> without any input arguments a help message will appear with a list of options including test_rtbox, test_DAQ
  * To run the habit task <code> ./habit </code>
    * "RTBox serial port not found" if button box chord is loose. Check connections and try again
    * If still running but need to restart
      * Hold "ctrl" tap "c" (ctrl+c) to stop. Push up and enter to try again 
    * usb_1208FS/DAQ errors: check DAQ usb connection 
    * Reboot computers if all else fails
  * Enter subject ID and push "Go"
  * Either drag task to the monitor or press f8 to mirror the laptop
  * Press f11 to go full screen
  * If not mirroring the laptop make sure the mouse is on the monitor to bring focus there
  * Read each instruction page to the participant 
    * Participant should be able to use the up button to cycle through and choose an avatar
  * Botton box should advance the instructions
  * Black and white squares in upper left will change between instruction slides and should trigger the photodiode/ send DAQ/ TTL triggers to the recording
  * On the final page of instruction click "test sound" to make sure the audio is working 
  * During the task, button pushes should send DAQ pulse to signal recording
  * Click "download task data" on the task's finish screen. Save task .json file to computer 


===== Debugging =====

2024-02-20 WF SM
  * in ''~/luna_habit/choice-landscape''. run ''./http_ttl.py test_rtbox''. 
    * confirm keyboard sends using focused ''xev''
    * move photodiode from light to dark window to test (see "L" in output)
  * switched to chromium-browser b/c firefox snap cant get keys
  * test daq:
   - turn nomad riplle on (hold down for a while to turn off)
   - run trellis: wired, tcp. keep raster window focused
  * photo diode connect to button box telescopes/turtles. it shouldn't. need to make sure connection is good