2.3.1 Objetos conexión

En todos los métodos de conexión que toman un argumento timeout (tiempo de espera máximo), un valor de -1 es indefinido, lo que significa que se espera hasta que la orden se ejecute completamente.

callback: Si se da un valor diferente de None a este miembro debería apuntar a una función de un solo argumento (el objeto conexión). Esto hará que todos los métodos de los objetos conexión funcionen de manera asíncrona, llamándose a la rutina de respuesta tras la finalización de la ejecución.
Nota: por motivos que escapan a mi conocimiento, en la actualizad nunca se llama a esta función. Queda desaconsejado, por el momento, el uso asíncrono de las llamadas.

Open (timeout): Abre una conexión saliente, esperando como máximo timeout segundos hasta que se establezca la conexión.

Listen (timeout): Espera una conexión entrante. Se detiene tras timeout segundos. Esta llamada sólo tiene sentido en ciertas herramientas.

accept (yesno): Acepta (cuando yesno tiene un valor de cierto) o rechaza una llamada entrante tras volver de Listen().

Close (timeout, now): Cierra una conexión. Cuando now es cero, el cierre es ordenado (es decir, salen los datos de salida pendientes, etc.) con un tiempo de espera máximo de timeout segundos. Cuando now tiene un valor de cierto el cierre es inmediato y se descartan los datos de salida pendientes.

Read (len, chan, timeout): Lee len bytes, o hasta que transcurran timeout segundos, del canal chan (que vale cmData, cmCntl o cmAttn). Devuelve una dupla: los datos leídos y el indicador de fin de mensaje, cmFlagsEOM.

Write (buf, chan, timeout, eom): Escribe buf al canal chan, con un tiempo de escritura máximo de timeout segundos. Cuando eom vale cmFlagsEOM, se escribirá un indicador de fin de mensaje tras los datos (si ha lugar para la herramienta de comunicaciones en cuestión). Este método devuelve el número de bytes escrito.

Status (): Devuelve el estado de la conexión como dupla: (longitudes, indicadores). longitudes es una tupla de 6 valores que informan de los tamaños de tampón actuales utilizados (consultar CMNew()), indicadores es un conjunto de bits que describe el estado de la conexión.

GetConfig (): Devuelve la cadena de configuración de la herramienta de comunicación. Estas cadenas de configuración son dependientes de la herramienta, pero suelen ser fáciles de analizar y modificar.

SetConfig (str): Establece la cadena de configuración'on para la herramienta. Las cadenas se analizan de izquierda a derecha, teniendo precedencia los valores posteriores. Esto significa que se puede modificar parámetros de configuración individuales simplemente concatenando algo como 'baud 4800' al final de la cadena devuelta por GetConfig() y pasando el resultado a este método. El método devuelve el número de caracteres realmente analizado por la herramienta antes de encontrar un error (o el final de la cadena).

Choose (): Presenta un diálogo al usuario para elegir una herramienta de comunicaciones y configurarla. Si hay una conexión pendiente, algunas de las opciones (como seleccionar una herramienta diferente) pueden interrumpir la conexión. El valor devuelto (una de las constantes de choose*) indicará esta circunstancia.

Idle (): Da a la herramienta una oportunidad de usar el procesador. Hay que llamar a este método regularmente.

Abort (): Interrumpe una llamada asíncrona a Open() o Listen().

Reset (): Reinicia una conexión. El significado concreto depende de la herramienta.

Break (length): Envía un corte. El significado de esto y la interpretación del parámetro length dependen de la herramienta activa.

Ver Sobre este documento... para obtener información sobre sugerencias.