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/