This program was designed for use with chambers like these:
... though less well-equipped chambers are support (through WhiskerServer's support for 'fake' devices) and better-equipped chambers are also supported (e.g. those with peristaltic pumps and lick sensors).
The program requires to claim devices in groups named box0, box1, box2… with device names as listed below in bold:
# ---------------- Box 0 definition
# INPUTS
# Lick sensors are used with peristaltic pump reinforcement.
line 0 box0 LICKSENSOR
line 3 box0 FLOORPANEL_REAR
line 6 box0 MAGNOSEPOKE_CENTRE
line 9 box0 MAGNOSEPOKE_REAR
line 12 box0 LOCOBEAM_LEFT
line 15 box0 LOCOBEAM_CENTRE
line 18 box0 LOCOBEAM_RIGHT
# OUTPUTS
# The houselight is on during the tasks.
# Pumps and/or pellet dispensers are used for reward.
# "Pump" delivers nice juice; "Pump2" delivers punishment (e.g. saline).
# The "extra reward device" might be a tone generator installed in the box, to be associated with reward.
# The "extra punishment device" can be activated when the subject is punished.
line 24 box0 HOUSELIGHT
line 27 box0 PUMP
line 30 box0 PELLET_CENTRE
line 33 box0 PELLET_REAR
line 36 box0 TRAYLIGHT_REAR
line 39 box0 EXTRAREWARDDEVICE
line 42 box0 EXTRAPUNISHMENTDEVICE
line 45 box0 PUMP2
# DISPLAY
# This is the monitor with a touchscreen attached to it.
display 0 box0 SCREEN
# AUDIO
# This is one of the computer's sound device (typically connected to a loudspeaker in the box).
# Used to reward successful rats with Mozart.
audio 0 box0 SOUND
audio 0 box0 LEFTSOUND
audio 1 box0 RIGHTSOUND
# ... and so on for other boxes
Please ensure that these devices are available and listed in the device definition file in use by the server. (The snippet above shows an extract from a typical definition file.) If you do not have a particular device, and do not need it, then you should configure "fake" lines on the Whisker server, and assign the non-existent device to a fake line.
Special note on monophonic and stereophonic sound systems
I suggest that if you have two speakers, left and right (e.g. audio devices 0 and 1), you do this:
audio 0 box0 SOUND
audio 0 box0 LEFTSOUND
audio 1 box0 RIGHTSOUND
... and tick the Stereo system: play centred sounds to LEFTSOUND+RIGHTSOUND (rather than SOUND) device box in the General Parameters. On the other hand, if you have a single speaker (e.g. audio device 0), you should untick this box and do this in the device definition file:
audio 0 box0 SOUND
audio 0 box0 LEFTSOUND
audio 0 box0 RIGHTSOUND
... and bear in mind that lateralized sound discrimination tasks won't work!