Metadata-Version: 2.3
Name: opensesame-plugin-parallel_port_trigger
Version: 4.2.0
Summary: An OpenSesame Plug-in for sending stimulus synchronization triggers through the parallel port to data acquisition systems
License: LICENSE.md
Author: Bob Rosbag
Author-email: debian@bobrosbag.nl
Requires-Python: >=3.7
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: pyparallel (>=0.2.2) ; sys_platform == "linux"
Project-URL: Homepage, https://github.com/dev-jam/opensesame-plugin-parallel_port_trigger
Project-URL: Repository, https://github.com/dev-jam/opensesame-plugin-parallel_port_trigger
Description-Content-Type: text/markdown

OpenSesame Plug-in: Parallel Port Trigger
==========

*An OpenSesame plug-in for sending stimulus synchronization triggers through the parallel port to data acquisition systems.*  

Copyright, 2022, Bob Rosbag  

Contributions: Code is based on the work of Per Sederberg. Debugged and polished by Edwin Dalmaijer.


## About

In EEG/ERP studies it is common to send triggers to mark the timestamp for significant events (e.g., the onset of a trial, presentation of a particular stimulus, etc.). Triggers are typically bytes that are sent via the parallel port to data acquisition systems.

The plug-in has an *init* item which should be placed at the beginning of an experiment and a *trigger* item for initiating triggers:

- *Dummy mode* for testing experiments.
- *Port address* for Windows: hexadecimal (0x378), for Linux: port number (0 in /dev/parport0).
- *Value* is a positive integer between 1-255 and specifies the trigger byte.
- *Enable duration* option to enable the duration parameter.
- *Duration* is the duration in ms.



Linux and Windows are supported (possible also OSX, not tested). For Windows the `DLPortIO.dll` driver is used to access the parallel port. No need for driver installation.


Documentation: <http://osdoc.cogsci.nl/devices/triggers/>


## License

This software is distributed under the terms of the GNU General Public License 3. The full license should be included in the file `COPYING`, or can be obtained from:

- <http://www.gnu.org/licenses/gpl.txt>

This plug-in contains works of others.


## Documentation

Installation instructions and documentation on OpenSesame are available on the documentation website:

- <http://osdoc.cogsci.nl/>

