Diferencia entre revisiones de «Tutorial: Puerto serie en Linux en C++»

De WikiRobotics
Saltar a: navegación, buscar
(→‎Código fuente)
(→‎Instalación de libserial)
 
(No se muestran 3 ediciones intermedias del mismo usuario)
Línea 6: Línea 6:
  
 
Los ejemplos de este tutorial se han probado en la distribución de Linux '''Ubuntu 9.04'''
 
Los ejemplos de este tutorial se han probado en la distribución de Linux '''Ubuntu 9.04'''
 +
 +
== Instalación de libserial ==
 +
Para desarrollar programas que usen la libserial sólo hay que instalar el siguiente paquete:
 +
 +
sudo apt-get install libserial-dev
  
 
== Compilación ==
 
== Compilación ==
Línea 82: Línea 87:
  
 
  $ '''./send_receive /dev/ttyUSB0'''
 
  $ '''./send_receive /dev/ttyUSB0'''
 +
Serial port: /dev/ttyUSB0
 +
Opening...
 
  String sent------> ASCII Command test
 
  String sent------> ASCII Command test
−
  String received--> ASCII Command test (18 bytes)
+
  String received: ASCII Command test
  
 
Si no hay eco la salida será la siguiente:
 
Si no hay eco la salida será la siguiente:
−
 
+
  $ ./send_receive /dev/ttyUSB0
−
  $ '''./send_receive /dev/ttyUSB0'''
+
Serial port: /dev/ttyUSB0
 +
Opening...
 
  String sent------> ASCII Command test
 
  String sent------> ASCII Command test
−
  String received--> Timeout!
+
  String received: TIMEOUT!
  
 
=== Explicación ===
 
=== Explicación ===
−
Sólo se explicarán algunos fragmentos del código. Primero se abre el puerto serie, a la velocidad de 9600 baudios invocando la función ''serial_open()''. Se pasa como argumento el nombre del dispositivo serie obtenido de la línea de comandos. Se indica si ha ocurrido un error al abrirlo (por ejemplo si se especifica un dispositivo serie incorrecto):
+
Sólo se explicarán algunos fragmentos del código. Primero se crea un objeto de la '''clase SerialPort''' pasando como argumento el nombre del dispositivo serie y luego se invoca el método Open especificando los parámetros de configuración:
  
−
  serial_fd='''serial_open'''(argv[1],B9600);
+
SerialPort serial_port(argv[1]);
−
 
+
serial_port.Open(SerialPort::BAUD_9600,
−
  if (serial_fd==-1) {
+
                  SerialPort::CHAR_SIZE_8,
−
    printf ("Error opening the serial device: %s\n",argv[1]);
+
                  SerialPort::PARITY_NONE,
−
    perror("OPEN");
+
                  SerialPort::STOP_BITS_1,
−
    exit(0);
+
                  SerialPort::FLOW_CONTROL_NONE);
−
  }
+
 
 +
En caso de error saltará la excepción '''SerialPort::OpenFailed'''.
 +
 
 +
Luego se envía la cadena definida en la constante CMD:
 +
 
 +
serial_port.Write(CMD);
  
−
Luego se envía la cadena definida en la constante CMD y se espera recibir la misma
+
A continuación se queda esperando a recibir la cadena completa. Los datos recibidos se almacenan en un buffer de tipo '''SerialPort::DataBuffer''' (que es un vector de unsigned char):
  
−
   '''serial_send'''(serial_fd, CMD, CMD_LEN);
+
   SerialPort::DataBuffer buffer;
−
   printf ("String sent------> %s\n",CMD);
+
   serial_port.Read(buffer,CMD.size(),500);
−
 
−
  n='''serial_read'''(serial_fd,data,CMD_LEN,TIMEOUT);
 
  
−
La variable n contiene el número de bytes recibidos. Si n es 0 es porque habrá ocurrido un timeout. En caso contrario se imprimen en pantalla la cadena recibida.
+
El método Read se queda esperando a recibir CMD.size() bytes. Se especifica un TIMEOUT de 500ms. Si en ese tiempo no se ha recibido ningún carácter entonces se lanzará la excepción '''SerialPort::ReadTimeout'''.
  
−
Por último se cierra el puerto serie:
+
Finalmente se muestra por pantalla los caracteres recibidos y se cierra el puerto serie:
  
−
   serial_close(serial_fd);
+
for(int ii=0; ii < buffer.size(); ii++) {
 +
    cout << buffer[ii];
 +
  }
 +
  cout << endl;
 +
   serial_port.Close();
  
 
== Licencia ==
 
== Licencia ==

Revisión actual del 00:05 15 jul 2010

Tutorial-linux-serial-c++.png

Introducción

Breve tutorial sobre el manejo del puerto serie en Linux en lenguaje C++. Los ejemplos utilizan la librería libserial. Yo utilizo el puerto serie para comunicarme con microcontroladores externos y controlar mis robots desde el PC. Aunque nuestro ordenador no disponga de puerto serie, no hay problema. Se pueden utilizar conversores USB-serie.

Los ejemplos de este tutorial se han probado en la distribución de Linux Ubuntu 9.04

Instalación de libserial

Para desarrollar programas que usen la libserial sólo hay que instalar el siguiente paquete: 

sudo apt-get install libserial-dev

Compilación

Para compilar los ejemplos, seguir los siguientes pasos:

  1. Descargar el paquete con los ejemplos: serial-c++-1.0.zip
  2. Descomprimirlo
  3. Entrar en el directorio serial-c++-1.0
  4. Ejecutar make
$ make
g++  -Iserial  -c -o send_receive.o send_receive.cpp
g++ -o send_receive send_receive.o -lserial

Pruebas con el puerto serie

Para probar los ejemplos de este tutorial es necesario tener conectado un dispositivo al puerto serie que nos haga "eco" de todo lo recibido. De esta manera se puede verificar que el software del PC está funcionando correctamente.

Existen varias alternativas:

  • Alternativa 1: Utilizar un cable para unir los pines 2 y 3 del puerto serie. Todo lo que se envíe por el pin de transmisión (TX) se recibirá automáticamente por el de recepción (RX).
  • Alternativa 2: Utilizar un microcontrolador externo que ejecute un firmware para hacer eco. Esta es la opción que se ha usado para probar los ejemplos de este tutorial. Se ha utilizado la tarjeta Skypic

Pruebas con la tarjeta Skypic

  • Tarjeta Skypic, conectada al PC por medio de un cable serie o conversor USB-serie
  • El firmware grabado es el Servidor de eco
  • Si se conecta la tarjeta Freeleds al puerto B de la Skypic, se podrá ver en binario todo lo que se ha recibido.
  • La Skypic se configura muy fácilmente para este ejemplo ejecutando el programa Pydownloader-wx y pulsando el botón de "ECO", que descarga automáticamente el servidor de eco.
Pantallazo del programa Pydownloader. Pulsar el botón de ECO para descargar el firmware necesario para este tutorial
La tarjeta Freeleds conectada a la Skypic para hacer ejecutar los programas de este tutorial

Puerto serie y Linux

Los nombres que se dan en Linux a los dispositivos serie son:

Nombre del dispositivo Descripción
/dev/ttyS0 Primer puerto serie nativo. (Equivalente a COM1 en Windows)
/dev/ttyS1 Segundo puerto serie nativo. (Equivalente a COM2 en Windows)
/dev/ttySnn n-ésimo puerto serie nativo
/dev/ttyUSB0 Conversor USB-serie 1
/dev/ttyUSB1 Conversor USB-serie 2
/dev/ttyUSBnn n-ésimo conversor USB-serie
/dev/rfcommn n-ésimo puerto serie por bluetooth

Descarga de los ejemplos

serial-c++-1.0.zip Fuentes de los ejemplos

Ejemplo 1: enviar/recibir cadenas

Código fuente

send_receive.cpp Fuentes del ejemplo, en el SVN

Ejecución

Este ejemplo envía la cadena "ASCII Command test" por el puerto serie a la velocidad de 9600 baudios y espera recibir una cadena de respuesta.

Si se ha conectado un dispositivo que haga eco, el ejecutar este ejemplo se obtendrá: 

$ ./send_receive /dev/ttyUSB0
Serial port: /dev/ttyUSB0
Opening...
String sent------> ASCII Command test
String received: ASCII Command test

Si no hay eco la salida será la siguiente: 

$ ./send_receive /dev/ttyUSB0
Serial port: /dev/ttyUSB0
Opening...
String sent------> ASCII Command test
String received: TIMEOUT!

Explicación

Sólo se explicarán algunos fragmentos del código. Primero se crea un objeto de la clase SerialPort pasando como argumento el nombre del dispositivo serie y luego se invoca el método Open especificando los parámetros de configuración: 

SerialPort serial_port(argv[1]);
serial_port.Open(SerialPort::BAUD_9600,
                  SerialPort::CHAR_SIZE_8,
                  SerialPort::PARITY_NONE,
                  SerialPort::STOP_BITS_1,
                  SerialPort::FLOW_CONTROL_NONE);

En caso de error saltará la excepción SerialPort::OpenFailed.

Luego se envía la cadena definida en la constante CMD: 

serial_port.Write(CMD);

A continuación se queda esperando a recibir la cadena completa. Los datos recibidos se almacenan en un buffer de tipo SerialPort::DataBuffer (que es un vector de unsigned char): 

 SerialPort::DataBuffer buffer;
 serial_port.Read(buffer,CMD.size(),500);

El método Read se queda esperando a recibir CMD.size() bytes. Se especifica un TIMEOUT de 500ms. Si en ese tiempo no se ha recibido ningún carácter entonces se lanzará la excepción SerialPort::ReadTimeout.

Finalmente se muestra por pantalla los caracteres recibidos y se cierra el puerto serie: 

for(int ii=0; ii < buffer.size(); ii++) {
   cout << buffer[ii];
 }
 cout << endl;
 serial_port.Close();

Licencia

Cc logo.png This work is licensed under a Creative Commons Attribution-ShareAlike 3.0 Spain License.
150px El código está liberado bajo licencia GPLv3

Autor

Juan González Gómez

Enlaces

Repositorio

Para obtener la última versión del SVN: 

svn co http://svn.iearobotics.com/serial/serial-c++-1.0/

Noticias

  • 14/Julio/2010: Comenzada esta página
Obtenido de «http://www.iearobotics.com/wiki/index.php?title=Tutorial:_Puerto_serie_en_Linux_en_C%2B%2B&oldid=9691»