La biblioteca está disponible como código fuente C/C++ en http://code.google.com/p/qextserialport/.

Para descargarla es necesaria una utilidad de gestión de versiones de código llamada Mercurial. En Linux, para conseguir descargar los fuentes, se deberá abrir un terminal y escribir:

hg clone https://qextserialport.googlecode.com/hg/ qextserialport

y se creará el directorio qextserialport con el código fuente del componente, los manuales y los ejemplos.

	Note
	Si la utilidad hg no está instalada, Ubuntu Linux nos dirá cómo instalarla.

En Windows, deberemos instalar antes alguna de las utilidades para Windows de Mercurial.

La manera "tradicional" de compilar algo para Qt es la que se vió en "Al grano con Qt" -> Compilando a pelo".

Como estamos más acostumbrados a los IDE, vamos a ilustrarlo aquí con Qt Creator.

Al descargar el componente se crea también el directorio html con el manual. Abriendo el archivo index.html se accede a la ayuda.

El manual es muy escueto y está orientado a conocedores del tema y que se entiendan bien con Qt.

Para centrar las cosas, indicar que QextSerialPort es una clase derivada de QIODevice de Qt, que crea una abstracción de los sistemas de ficheros y similares (en propiedad, se dice flujos de datos). Esto significa que el puerto serie se nos mostrará como si de un flujo de datos se tratase.

Para tener un acceso más inmediato a la ayuda, se ha copiado aquí la ayuda del componente QextSerialPort 1.2 a diciembre de 2009.

Algunos enlaces que hacen referencia a clases externas fallarán. Se deberán buscar esas clases en el manual de Qt.

/* Proyecto sencillo para mostrar la funcionalidad de qextserialport
   Ejemplo que transmite algo

  Author: Angel Perles for the DSII subject
  Date: 2010-01-14
*/

#include <QtCore/QCoreApplication>
#include <stdio.h>

#ifdef Q_OS_UNIX
#include <unistd.h> /* anyadir esta cabecera en los *nix para la función sleep() */
#endif

// anyadimos la cabecera con la informacion sobre la clase
#include <qextserialport.h>

// nombre del puerto que deseamos abrir
#define PUERTO_NOMBRE "/dev/ttyS0"
//#define PUERTO_NOMBRE "/dev/ttyUSB0"      // adaptador USB-serie
//#define PUERTO_NOMBRE "COM1"
//#define PUERTO_NOMBRE "COM3"

QextSerialPort *puerto; // puntero al objeto que maneja el puerto

int main(int argc, char *argv[])
{
    //QCoreApplication a(argc, argv);       // no eliminar esto en aplicaciones serias

    printf ("Creando instancia de QextSerialPort para abrir %s\n", PUERTO_NOMBRE);
    QextSerialPort *puerto = new QextSerialPort();
    puerto->setPortName(PUERTO_NOMBRE);
    puerto->setQueryMode(QextSerialPort::Polling);  // modo mas sencillo

    printf("Configurando puerto a 9600-8N1 sin control de flujo\n");
    puerto->setBaudRate (BAUD9600);
    puerto->setDataBits(DATA_8);
    puerto->setStopBits(STOP_1);
    puerto->setParity(PAR_NONE);
    puerto->setFlowControl(FLOW_OFF);

    printf("Abriendo el puerto ... ");
    if (puerto->open(QextSerialPort::WriteOnly)) {
        printf("abierto!!!\n");
    } else {
        printf("vaya, esto CASCA\n");
    }

    printf("Enviar \"Hola, puerto serie\" al puerto serie\n");
    puerto->write("Hola, puerto serie");

    //esperar un poco a que salga todo por el puerto
#ifdef Q_OS_WIN
    Sleep(1);
#else
    sleep(1);
#endif

    printf("Cerrando el puerto\n");
    puerto->close();

    printf("Saliendo\n");

    //return a.exec();

    return(0);
}

/* Proyecto sencillo para mostrar la funcionalidad de qextserialport
   Ejemplo que recibe cosas

  Author: Angel Perles for the DSII subject
  Date: 2010-01-14
*/

#include <QtCore/QCoreApplication>
#include <stdio.h>

// anyadimos la cabecera con la informacion sobre la clase
#include <qextserialport.h>

// nombre del puerto que deseamos abrir
#define PUERTO_NOMBRE "/dev/ttyS0"
//#define PUERTO_NOMBRE "/dev/ttyUSB0"      // adaptador USB-serie
//#define PUERTO_NOMBRE "/dev/rfcomm3"        // Bluettoth SPP
//#define PUERTO_NOMBRE "COM1"

QextSerialPort *puerto; // puntero al objeto que maneja el puerto

int main(int argc, char *argv[])
{
    //QCoreApplication a(argc, argv);       // no eliminar esto en aplicacione serias

    printf ("Creando instancia de QextSerialPort para abrir %s\n", PUERTO_NOMBRE);
    QextSerialPort *puerto = new QextSerialPort();
    puerto->setPortName(PUERTO_NOMBRE);
    puerto->setQueryMode(QextSerialPort::Polling);  // modo mas sencillo

    printf("Configurando puerto a 9600-8N1 sin control de flujo\n");
    puerto->setBaudRate (BAUD9600);
    puerto->setDataBits(DATA_8);
    puerto->setStopBits(STOP_1);
    puerto->setParity(PAR_NONE);
    puerto->setFlowControl(FLOW_OFF);

    printf("Abriendo el puerto ... ");
    if (puerto->open(QextSerialPort::ReadOnly)) {
        printf("abierto!!!\n");
    } else {
        printf("vaya, esto CASCA\n");
        exit(1);
    }

    printf("Entrando al bucle que mira si se van recibiendo cosas:\n");
    while (1) {
        int num_datos;
        char dato;

        num_datos = puerto->bytesAvailable();
        if (num_datos > 0) {    // hay algo
            puerto->getChar(&dato);
            printf("Recibido el ascii %d (%c)\n",(int)dato, dato);
        }
    }

    // aqu´i no llegamos nunca, otro dia sera
    printf("Cerrando el puerto\n");
    puerto->close();

    printf("Saliendo\n");

    //return a.exec();

    return(0);
}

/* Proyecto sencillo para mostrar la funcionalidad de qextserialport
   Ejemplo de recepcion y transmision

  Author: Angel Perles for the DSII subject
  Date: 2010-01-14
*/

#include <QtCore/QCoreApplication>
#include <stdio.h>
#ifdef Q_OS_UNIX
#include <unistd.h> /* anyadir esta cabecera en los *nix para la función sleep() */
#endif
#include <ctype.h>

// anyadimos la cabecera con la informacion sobre la clase
#include <qextserialport.h>

// nombre del puerto que deseamos abrir
#define PUERTO_NOMBRE "/dev/ttyS0"
//#define PUERTO_NOMBRE "/dev/ttyUSB0"      // adaptador USB-serie
//#define PUERTO_NOMBRE "COM1"

QextSerialPort *puerto; // puntero al objeto que maneja el puerto

int main(int argc, char *argv[])
{

    //QCoreApplication a(argc, argv);       // no eliminar esto en aplicacione serias

    printf ("Creando instancia de QextSerialPort para abrir %s\n", PUERTO_NOMBRE);
    QextSerialPort *puerto = new QextSerialPort();
    puerto->setPortName(PUERTO_NOMBRE);
    puerto->setQueryMode(QextSerialPort::Polling);  // modo mas sencillo

    printf("Configurando puerto a 9600-8N1 sin control de flujo\n");
    puerto->setBaudRate (BAUD9600);
    puerto->setDataBits(DATA_8);
    puerto->setStopBits(STOP_1);
    puerto->setParity(PAR_NONE);
    puerto->setFlowControl(FLOW_OFF);

    printf("Abriendo el puerto ... ");
    if (puerto->open(QextSerialPort::ReadWrite)) {
        printf("abierto!!!\n");
    } else {
        printf("vaya, esto CASCA\n");
    }

    printf("Entrando al bucle\n");
    printf("Pulsa \"f\" en el otro lado para salir\n");

    bool fin;
    fin = false;

    do {
        int num_datos;
        char dato;

        // comprobar si se ha recibido algo y sacarlo por pantalla
        num_datos = puerto->bytesAvailable();
        if (num_datos > 0) {    // hay algo, saco un solo byte
            puerto->getChar(&dato);
            printf("Recibido el ascii %d (%c)\n",(int)dato, dato);
            // envio el ascii de vuelta por el canal serie
            //sleep(1);
            puerto->putChar(toupper(dato));
            if (dato == '-') {  // tecla de fin
                fin = true;
            }
        }
    } while (fin == false);

    printf("Se ha pulsado \'f\'' en el otro extremo. Me salgo\n");
    puerto->write("\nAdios. Hasta la proxima\n");

    //esperar un poco a que salga todo por el puerto
#ifdef Q_OS_WIN
    Sleep(1);
#else
    sleep(1);
#endif

    printf("Cerrando el puerto\n");
    puerto->close();

    printf("Saliendo\n");

    //return a.exec();

    return(0);
}