Libreria PanamaHitek_Arduino Files

Librería PanamaHitek_Arduino, versión 2.7.0

Por Antony García González 
Estudiante de Ingeniería Electromecánica y Asistente de Investigación de la Universidad Tecnológica de Panamá 
Fundador y Co-propietario del sitio web htp://panamahitek.com junto a Kiara Navarro y el Panama Hitek Creative Team

email: antony.garcia.gonzalez@gmail.com
whatsapp: +50767347398
facebook: http://facebook.com/panamahitek
twitter: @panamahitek

La librería incluye dos clases, la clase PanamaHitek_Arduino y la clase PanamaHitek_MultiMessage.
La clase PanamaHitek_Arduino es la encargada de manejar todas las conexiones y la comunicación con Arduino.
La clase PanamaHitek_MultiMessage incluye las herramientas necesarias para recibir múltiples mensajes de forma simultánea en Java.

También se incluyen las clases que pertenecen a la librería RXTX, sobre la cual está construida la librería PanamaHitek_Arduino.
Hasta su versión 2.5.0, esta librería se conocía bajo el nombre de Librería Arduino para Java.

Versión 2.7.0
---------------------
Antes de esta versión era necesario tener instalados los drivers rxtxSerial.dll en la ruta de JAVA_HOME. 
A partir de la versión 2.7.0, en cada ejecución la librería verifica si los drivers están instalados en la ruta C:/JavaRXTX.
Si no existen dichos ficheros, la librería los crea. Si el directorio no existe, se encargar de armar la estructura para el almacenamiento
de los archivos *.dll (Windows) necesarios para que el programa cargue sin problemas.

Este feature SÓLO FUNCIONA EN WINDOWS. Invitamos a los usuarios de Linux a que nos ayuden a expandir estas capacidades a otras plataformas.
Nuestro repositorio en GitHub contiene todos los archivos de esta librería: https://github.com/PanamaHitek/Arduino-JavaAPI


Versión 2.6.0
---------------------
Grandes cambios. La librería ya no se llama Arduino para Java, sino que la hemos renombrado PanamaHitek_Arduino.
Se ha modificado algunos métodos. Procedo a detallar los cambios:

  -- Se ha aplicado el lower Camel Case a todos los métodos. Lo que antes llamábamos ArduinoRXTX ahora se cambió por arduinoRXTX.
  -- Se ha despreciado el método NameSerialPortsAt(). Ahora se utiliza getSerialPorts().
  -- Se ha despreciado el método SerialPortsAvailable(). Ahora se utiliza getPortsAvailable().
  -- Se renombró el método MessageAvailable() a isMessageAvailable().
  -- Se ha hecho innecesario el establecimiento del TimeOut como parámetro de entrada para los métodos ArduinoRX, ArduinoTX y ArduinoRXTX.
  -- Se ha documentado todos los métodos y clases con el JavaDoc.
  -- Se ha hecho público el código de la librería en nuestro repositorio de Github (https://github.com/PanamaHitek/Arduino-JavaAPI).
  

Incluye los nuevos métodos en la clase PanamaHitek_Arduino:
  -- List<String> getSerialPorts()
     Devuelve una lista con los dispositivos conectados en el Puerto Serie.
  -- int getPortsAvailable()
     Devuelve la cantidad de dispositivos conectados en el Puerto Serie.

La clase PanamaHitek_MultiMessage incluye un nuevo método:
  -- List<String> getMessageList()
     Entrega los mensajes recibidos como una Lista.

Versión 2.5.0
---------------------
Incluye los nuevos métodos en la clase Arduino:
  -- void ShowMessageDialogs(boolean input)
     Permite activar o desactivar las ventanas emergentes cuando se produce algún error en tiempo de ejecución

  -- void SendByte(int input)
     Envía Bytes a Arduino por medio del puerto Serie.

Versiones Anteriores
---------------------
Métodos incluidos en la librería, en la clase Arduino.
  -- void ArduinoTX(String PORT_NAME, int TIME_OUT, int DATA_RATE)
     Permite establecer una conexión entre Arduino y Java, donde sólo se puede enviar información de Java a Arduino
     por medio de comunicación serial.

  -- void ArduinoRX(String PORT_NAME, int TIME_OUT, int DATA_RATE, SerialPortEventListener evento)
     Permite establecer una conexión entre Arduino y Java, donde sólo se puede enviar información de Arduino a Java
     por medio de comunicación serial. Se requiere instanciar la clase SerialPortEventListener, de la librería RXTX.

  -- void ArduinoRXTX(String PORT_NAME, int TIME_OUT, int DATA_RATE, SerialPortEventListener evento)
     Permite establecer una conexión entre Arduino y Java, donde se puede enviar y recibir información entre Arduino y Java
     por medio de comunicación serial. Se requiere instanciar la clase SerialPortEventListener, de la librería RXTX.

  -- void SendData(String data)
     Permite enviar una cadena de caracteres desde Java hacia Arduino

  -- String ReceiveData()
     Permite recibir información directamente desde Arduino por medio de Comunicación Serial.

  -- boolean MessageAvailable()
     Devuelve true cuando se ha terminado de recibir un mensaje desde Arduino, utilizando Serial.println().
  
  -- String PrintMessage()
     Devuelve un string con el mensaje que se haya enviado desde Arduino, solamente cuando MessageAvailable() devuelva true.

  -- int SerialPortsAvailable()
     Devielve la cantidad de puertos serie disponibles y activos en la computadora

  -- String NameSerialPortAt(int index)
     Nombra los puertos serie disponibles

  -- void KillArduinoConnection()
     Finaliza la conexión entre Arduino y Java.

Para una documentación completa sobre este proyecto, visita:
http://panamahitek.com/libreria-arduino-para-java/