| cliechti | c1c3760 | 2009-07-21 01:34:57 +0000 | [diff] [blame] | 1 | ============ |
| 2 | pyParallel |
| 3 | ============ |
| 4 | |
| 5 | .. note:: This module is in development (since years ;-) |
| 6 | |
| 7 | Overview |
| 8 | ======== |
| 9 | This module encapsulates the access for the parallel port. It provides backends |
| 10 | for Python running on Windows and Linux. Other platforms are possible too but |
| 11 | not yet integrated. |
| 12 | |
| 13 | This module is still under development. But it may be useful for developers. |
| 14 | |
| 15 | (C) 2001-2003 Chris Liechti <cliechti@gmx.net> |
| 16 | |
| 17 | Here is the `project page on SourceForge`_ and here is the `SVN repository`_. |
| 18 | |
| 19 | .. _`project page on SourceForge`: http://sourceforge.net/projects/pyserial/ |
| 20 | .. _`SVN repository`: http://sourceforge.net/svn/?group_id=46487 |
| 21 | |
| 22 | |
| 23 | Features |
| 24 | -------- |
| 25 | * same class based interface on all supported platforms |
| 26 | * port numbering starts at zero, no need to know the port name in the user program |
| 27 | * port string (device name) can be specified if access through numbering is inappropriate |
| 28 | |
| 29 | Requirements |
| 30 | ------------ |
| 31 | * Python 2.2 or newer |
| 32 | * "Java Communications" (JavaComm) extension for Java/Jython |
| 33 | |
| 34 | Installation |
| 35 | ------------ |
| 36 | Extract files from the archive, open a shell/console in that directory and let |
| 37 | Distutils do the rest: ``python setup.py install`` |
| 38 | |
| 39 | The files get installed in the "Lib/site-packages" directory in newer Python versions. |
| 40 | |
| 41 | The windows version needs a compiled extension and the giveio.sys driver for |
| 42 | Windows NT/2k/XP. The extension module can be compiled with distutils with |
| 43 | either MSVC or GCC/mingw32. |
| 44 | |
| 45 | It is released under a free software license, see LICENSE.txt for more details. |
| 46 | |
| 47 | |
| 48 | Short introduction |
| 49 | ================== |
| 50 | :: |
| 51 | |
| 52 | >>> import parallel |
| 53 | >>> p = parallel.Parallel() # open LPT1 |
| 54 | >>> p.setData(0x55) |
| 55 | |
| 56 | Examples |
| 57 | -------- |
| 58 | Please look in the SVN Repository. There is an example directory where you can |
| 59 | find a simple terminal and more. |
| 60 | http://pyserial.svn.sourceforge.net/viewvc/pyserial/trunk/pyparallel/examples/ |
| 61 | |
| 62 | References |
| 63 | ---------- |
| 64 | * Python: http://www.python.org/|http://www.python.org |
| 65 | * Jython: http://www.jython.org/|http://www.jython.org |
| 66 | * Java@IBM http://www-106.ibm.com/developerworks/java/jdk/ (JavaComm links are on the download page for the respective platform jdk) |
| 67 | * Java@SUN http://java.sun.com/products/ |