Manual Software EasyUSB IO

Software Visual Basic .NET (API)

Comandos Serial TTL

EasyUSB IO 2

Revisión por Federico Lugo Revision A1

2011 FETRONICS

EasyUSB IO 3

MODE-USB Software VB .Net (API)

La interface de la tarjeta EasyUSB IO se basa en Software de Código Abierto y libre distribución, con funciones y procedimientos ya listas para ser usadas dentro de un proyecto. Las funciones y procedimiento tienen una estructura muy simple de tal manera que permite manipular los datos de entrada y salida de la tarjeta. La plataforma de programación es en Visual Basic .NET 2008.

La comunicación de la tarjeta a través del puerto USB se basa en dos librerías (LibHID.dll y Library Easy USB IO.dll) estas deben ser copiadas dentro del directorio donde se encuentre el ejecutable de la aplicación.

Dentro del CD que acompaña a la tarjeta, en la Carpeta Software/API Template se encuentran el proyecto del Software de la EasyUSB IO listo para ser abierto en Visual Basic .NET. NOTA: Antes de compilar su aplicación asegúrese de que dentro de su proyecto del Software tenga la referencia de la librería Library Easy USB IO.dll de lo contrario marcara errores a la hora de compilar.

Las siguientes tablas describen a detalle las funciones y procedimientos empleados en el Software.

EasyUSB IO 4

Salidas Digitales

Función Procedimiento

Public Sub OUT1(ByVal Bit As Boolean) Public Sub OUT2(ByVal Bit As Boolean) Public Sub OUT3(ByVal Bit As Boolean) Public Sub OUT4(ByVal Bit As Boolean)

Retorno Ninguno

Descripción Procedimiento que pone en 0 ó 1 (estado alto o bajo) la salida[1..4] de la tarjeta.

Requisito USB Conectado

Ejemplo

Dim bit As Boolean OUT1(1) 'Se prende la salida 1 ... bit = 0 OUT2(bit) 'Se apaga la salida 2

Entradas Lógicas


Public Function IN1() As Boolean Public Function IN2() As Boolean Public Function IN3() As Boolean Public Function IN4() As Boolean

Retorno 1 ; Cuando la entrada tiene un nivel alto. 0 ; Cuando la entrada tiene un nivel bajo.

Descripción Función que obtiene el estado de la entrada[1..4] de la tarjeta.


Ejemplo

Dim mi_variable As Boolean ... mi_variable = IN1() 'Se asigna el estado de la 'Entrada 1 a la variable

Salidas a Relevador


Public Sub RL1(ByVal Bit As Boolean) Public Sub RL2(ByVal Bit As Boolean)

Retorno Ninguno

Descripción Procedimiento que activa o desactiva el Relevador [1,2] de la tarjeta.


Ejemplo

Dim mi_variable As booblean RL1(1) 'Se activa el Relvador 1 ... mi_variable = 0 RL2(mi_variable) 'Se apaga el relevador 2

EasyUSB IO 5

Configuración de Voltajes de Referencia


Public Sub Vref_AN(ByVal status As Boolean)

Retorno Ninguno

Descripción

Procedimiento que configura los Voltajes de referencia para los canales Analógicos. 0 ; Establece que el Voltaje de Referencia positivo será de 5V y el Voltaje de Referencia negativo será de 0V (GND) esta configuración se encuentra por defecto. 1 ; Establece que los canales analógicos tomaran como referencia los valores de Vref- y Vref+ (terminales de conexión de la tarjeta) definidos por el Usuario. NOTA: Cuando se decide usar Voltajes de referencia (Vrerf- y Vref+) solo quedan disponibles los canales AN1 y AN2.


Ejemplo

Vref_AN(1) 'Se activan los Voltajes de 'referencia Vref- y Vref+ ... Vref_AN(0) 'Se desactivan los voltajes de 'regencia Vref- y Vref+

Entradas Analógicas


Public Function AN1() As Integer Public Function AN2() As Integer Public Function AN3() As Integer Public Function AN4() As Integer

Retorno Valor de 0 a 1023 correspondiente a valor de la entrada Analógica [1..4].

Descripción

Función que obtiene el valor de la entrada Analógica[1..4] con resolución de 10 bits (0 a 1023). NOTA: El valor varía respecto a los voltajes de referencia Vref- y Vref+.


Ejemplo

Dim mi_var As Integer ... mi_var = ADC1() if mi_var < 512 the RL1(1) 'Se activa el Relevador 1 else if mi_var >= 512 then RL1(0) 'Se apaga el Relevador 1 End If

EasyUSB IO 6

Transmisión Serial TTL


Public Sub Serial_Tx(ByVal Data As String)

Retorno Ninguno

Descripción Procedimiento que envía la cadena como argumento por el Modulo Serial TTL de la tarjeta.


Ejemplo

Dim mi_cadena As String ... mi_cadena = "Hola Mundo" Send_Tx(mi_cadena)

Recepción Serial TTL

*Definición Public Serial_Rx As Char

Retorno Carácter ASCCI

Descripción *Variable que obtiene el carácter recibido por el Modulo Serial TTL de la tarjeta.


Ejemplo

... Timer1.Enabled = True 'Se prende el timer de recepción Timer1.Interval = 1 'Con intervalo de 1ms ... Private Sub Timer1_Tick(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Timer1.Tick If Serial_Rx = "1" Then 'Comparamos el carácter recibido RL1(1) 'Se prende el Relevador 1 ElseIf Serial_Rx = "0" Then RL1(0) 'Se apaga apaga el Relevador 1 End If End Sub

EasyUSB IO 7

MODE-Serial Comandos Serial TTL

La EasyUSB IO en este modo se convierte en una tarjeta multiplataforma, ya que su Modulo Serial prácticamente se puede comunicar con cualquier Software de Programación que maneje un Puerto Serial; como MatLab, Labview, Java, Visual Basic, .NET , C, C++, etc; a través de comandos ya definidos. Es importante mencionar que la Comunicación Serial TTL debe cumplir con el protocolo de 9600 baudios, 8 bits de datos, sin paridad y un bit de stop (9600-8-N-1) de lo contrario no se efectuara la comunicación. La comunicación de la tarjeta debe de cumplir con la siguiente estructura de conexión.

En las siguientes secciones se describen los comandos de operación para este modo de la tarjeta.

EasyUSB IO 8

Comandos para Salidas Digitales

Comando 1

Tipo de Dato ASCII char

Retorno Ninguno

Descripción Pone en 1 (estado alto) la Salida 1 (OUT1) de la tarjeta.

Comando 2


Retorno Ninguno

Descripción Pone en 0 (estado bajo) la Salida 1 (OUT1) de la tarjeta.

Comando 3


Retorno Ninguno


Comando 4


Retorno Ninguno


Comando 5


Retorno Ninguno


Comando 6


Retorno Ninguno


Comando 7


Retorno Ninguno


Comando 8


Retorno Ninguno


EasyUSB IO 9

Comandos para Salidas a Relevador

Comando A


Retorno Ninguno

Descripción Activa el Relevador 1 (RL1) de la tarjeta.

Comando B


Retorno Ninguno

Descripción Desactiva el Relevador 1 (RL1) de la tarjeta.

Comando C


Retorno Ninguno

Descripción Activa el Relevador 2 (RL2) de la tarjeta.

Comando D


Retorno Ninguno

Descripción Desactiva el Relevador 2 (RL2) de la tarjeta.

EasyUSB IO 10

Comandos para Lectura de Entradas Lógicas.

Comando a


Retorno 0 ó 1 como Caracter

Descripción Obtiene el estado de la Entrada 1 (IN1).

Comando b




Comando c




Comando d




Comandos de configuración de Voltajes de Referencia

Comando x


Retorno Cadena “Vref=OFF”

Descripción Establece que el Voltaje de Referencia positivo será de 5V y el Voltaje de Referencia negativo será de 0V (GND) esta configuración se encuentra por defecto.

Comando y


Retorno Cadena “Vref=ON”

Descripción

Establece que el Voltaje de Referencia positivo (Vref+) y Voltaje de Referencia negativo (Vref-) será establecido por el usuario en las terminales de conexión de la tarjeta. NOTA: Cuando se decide usar Voltajes de referencia (Vrerf- y Vref+) solo quedan disponibles los canales AN1 y AN2.

EasyUSB IO 11

Comandos para Lectura de Entradas Analógicas.

Comando e


Retorno Valor de 0 a 1023 como Cadena

Descripción Obtiene el valor del ADC de la entrada Analógica 1 (AN1). NOTA: Los canales analógicos de la tarjeta tienen una resolución de 10 bits.

Comando f




Comando g



Descripción Obtiene el valor del ADC de la entrada Analógica (AN3). NOTA: Los canales analógicos de la tarjeta tienen una resolución de 10 bits.

Comando h




Comando de Lectura General

Comando z


Retorno All=([IN1], [IN2], [IN3], [IN4], [AN1], [AN2], [AN3], [AN4]) como Cadena

Descripción Este comando obtiene la lectura de las Entradas 1..4 y las Entradas Analógicas 1…4 y lo emite en una solo trama.

NOTA: Los “Retornos” de los comandos de Lectura están precedidos y procedidos (al inicio y al final de la trama) por un retorno de carro CR.

EasyUSB IO 12

[email protected]

Manual Software EasyUSB IO

Documents

Transcript of Manual Software EasyUSB IO