======================================
Drivers python para el módulo MDAQ107
======================================

El módulo :mod:`mdaq` del paquete mdaq107 contiene los drivers de bajo nivel
para interactuar con el Hardware.

El módulo es un traductor de los comandos nativos del hardware mdaq [#mdaqblog]_.
Se cumple que casi todo comando del Hardware tiene un equivalente como método
de la clase :class:`mdaq.Instrument`. Es decir con una instancia de 
:class:`mdaq.Instrument` conectatada al hardware MDAQ107 es posible por ejemplo
leer y cambiar la forma de onda, leer los contadores cambiar los parámetros etc.

Tiene además un par de funciones utilitarias asociadas a la conversión de strings
y lectura de archivos con formas de ondas.

:mod:`mdaq` hace uso del paquete serial de Cris Lichetti 
[#pyserial]_. Por lo tanto este ya debe estar correctamente instalado 
(disponible).

--------------
Primeros pasos
--------------

Desde un shell interactivo de python [#pythonshell]_ importar el módulo.

    >>> from mdaq107 import mdaq
    Python Drivers for Mössbauer system MDAQ107-MAC

Generar un objeto Instrument conectado al hardware. 

    >>> hw = mdaq.Instrument('/dev/ttyS0')

El único argumento para iniciar un Instrument es el puerto. El cual debe enviarse 
como string. Los más comunes son '/dev/ttyS0' para los puertos serie propios del 
equipo que esté usando o '/dev/ttyUSB0' para los puertos serie generados por 
conversores USB a RS232.

Luego para probar que está funcionando correctamente resetear el Hardware desde 
la consola: 

    >>> hw.reset()
    reset.. OK

Si la respuesta es la indicada es porque la conección fue exitosa.

Para obtener un help en modo interactivo correr:

    >>> help(hw)


-----------
Referencias
-----------
.. [#mdaqblog] http://mossdaq.blogspot.com/
.. [#pyserial] Cris Lichetti, módulo pyserial drivers python para manejar 
    los puertos serie. http://pyserial.sourceforge.net/
.. [#pythonshell] python, ipython http://ipython.org/ o otro