Sr box - opensesame documentation area

T his PDF was auto- generated on 2014- 03- 08 18:35:06 +0100. A more recent version of this page may T he serial response (SR) box is a button box, specifically designed for responsecollection in psychological experiments. T he original version, developed by PsychologySoftware Tools, has 5 buttons, 5 lights, and is connected to the PC trough the serialport. T here are also SR Box compatible devices by other manufacturers, which maydiffer in the number of buttons and lights and often use a USB connection, whichemulates a serial port. T he advantage of using an SR Box is that response times can bemeasured more accurately than using a garden variety keyboard. Of course, it alsolooks much more sciency. T he SR Box plug-in for OpenSesame allows you to use theSR Box or compatible device in your OpenSesame experiments. T he plug-in appears asan item in the item toolbar and you can simply drag it into your experiment.
By default, the plug-in tries to autodetect your SR Box. If this works, you don’t have tochange it. If your experiment freezes, OpenSesame has chosen the wrong serial portand you must enter the device name manually. Under Windows, the device is probablycalled something like Under Linux the device is probably called something like An SR Box or compatible device and OpenSesame 0.22 or higher.
As of 0.25, the srbox plugin is included with OpenSesame by default, so no installationis required.
If you insert the srbox plugin at the start of your experiment, an srbox objectautomatically becomes part of the experiment object and can be accessed from withinan inline_script item as exp.srbox. Below is a list of available functions.
class libsrbox
Function overview:

libsrbox.__init__(experiment, dev=None)
Constructor. Connects to the SR Box.
Arguments:
experiment → Opensesame experiment.
Keywords arguments:
dev → The srbox device port or None for auto-detect (default=None).
libsrbox.close()
Closes the connection to the srbox. T his is (sometimes?) required in order tore-use the SR Box in the same session of OpenSesame.
libsrbox.get_button_press(allowed_buttons=None, timeout=None)
Gets a button press from the SR box.
Keywords arguments:
allowed_buttons → A list of buttons that are accepted or None to accept all
buttons. Valid buttons are integers 1 through 8. (default=None)
timeout → A timeout value or None for no timeout. (default=None)
Returns:
A timestamp, buttonlist tuple. T he buttonlist consists of a list of button
numbers.
Example:
exp.srbox.start()
timestamp, buttonlist =
exp.srbox.get_button_press(allowed_buttons=[1,2])
if 1 in buttonlist:
print 'Button 1 was pressed!'
exp.srbox.stop()
libsrbox.send(ch)
Arguments:
ch → The character to send.
libsrbox.start()
Turns on sending mode, to start giving output.
Example:
exp.srbox.start()
timestamp, buttonlist =
exp.srbox.get_button_press(allowed_buttons=[1,2])
if 1 in buttonlist:
print 'Button 1 was pressed!'
exp.srbox.stop()
libsrbox.stop()
Turns of sending mode, to stop giving output.
Example:
exp.srbox.start()
timestamp, buttonlist =
exp.srbox.get_button_press(allowed_buttons=[1,2])
if 1 in buttonlist:
print 'Button 1 was pressed!'
exp.srbox.stop()
Copyright 2010- 2014 // // Revision on 2014- 03- 08 18:34:48 +0100

Source: http://osdoc.cogsci.nl/devices/srbox/index.pdf