SerialLink.cc 36 KB
Newer Older
pixhawk's avatar
pixhawk committed
1 2 3 4 5 6 7 8 9 10 11 12
/*=====================================================================
======================================================================*/
/**
 * @file
 *   @brief Cross-platform support for serial ports
 *
 *   @author Lorenz Meier <mavteam@student.ethz.ch>
 *
 */

#include <QTimer>
#include <QDebug>
13
#include <QSettings>
pixhawk's avatar
pixhawk committed
14 15 16
#include <QMutexLocker>
#include "SerialLink.h"
#include "LinkManager.h"
17
#include "QGC.h"
pixhawk's avatar
pixhawk committed
18
#include <MG.h>
19
#include <iostream>
pixhawk's avatar
pixhawk committed
20 21 22 23
#ifdef _WIN32
#include "windows.h"
#endif

24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176
#ifdef _WIN32
#include <qextserialenumerator.h>
#endif
#if defined (__APPLE__) && defined (__MACH__)
#include <stdio.h>
#include <string.h>
#include <unistd.h>
#include <fcntl.h>
#include <sys/ioctl.h>
#include <errno.h>
#include <paths.h>
#include <termios.h>
#include <sysexits.h>
#include <sys/param.h>
#include <sys/select.h>
#include <sys/time.h>
#include <time.h>
#include <AvailabilityMacros.h>

#ifdef __MWERKS__
#define __CF_USE_FRAMEWORK_INCLUDES__
#endif


#include <CoreFoundation/CoreFoundation.h>

#include <IOKit/IOKitLib.h>
#include <IOKit/serial/IOSerialKeys.h>
#if defined(MAC_OS_X_VERSION_10_3) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_3)
#include <IOKit/serial/ioss.h>
#endif
#include <IOKit/IOBSD.h>

// Apple internal modems default to local echo being on. If your modem has local echo disabled,
// undefine the following macro.
#define LOCAL_ECHO

#define kATCommandString  "AT\r"

#ifdef LOCAL_ECHO
#define kOKResponseString  "AT\r\r\nOK\r\n"
#else
#define kOKResponseString  "\r\nOK\r\n"
#endif
#endif


// Some helper functions for serial port enumeration
#if defined (__APPLE__) && defined (__MACH__)

enum {
    kNumRetries = 3
};

// Function prototypes
static kern_return_t FindModems(io_iterator_t *matchingServices);
static kern_return_t GetModemPath(io_iterator_t serialPortIterator, char *bsdPath, CFIndex maxPathSize);

// Returns an iterator across all known modems. Caller is responsible for
// releasing the iterator when iteration is complete.
static kern_return_t FindModems(io_iterator_t *matchingServices)
{
    kern_return_t      kernResult;
    CFMutableDictionaryRef  classesToMatch;

    /*! @function IOServiceMatching
    @abstract Create a matching dictionary that specifies an IOService class match.
    @discussion A very common matching criteria for IOService is based on its class. IOServiceMatching will create a matching dictionary that specifies any IOService of a class, or its subclasses. The class is specified by C-string name.
    @param name The class name, as a const C-string. Class matching is successful on IOService's of this class or any subclass.
    @result The matching dictionary created, is returned on success, or zero on failure. The dictionary is commonly passed to IOServiceGetMatchingServices or IOServiceAddNotification which will consume a reference, otherwise it should be released with CFRelease by the caller. */

    // Serial devices are instances of class IOSerialBSDClient
    classesToMatch = IOServiceMatching(kIOSerialBSDServiceValue);
    if (classesToMatch == NULL) {
        printf("IOServiceMatching returned a NULL dictionary.\n");
    } else {
        /*!
          @function CFDictionarySetValue
          Sets the value of the key in the dictionary.
          @param theDict The dictionary to which the value is to be set. If this
            parameter is not a valid mutable CFDictionary, the behavior is
            undefined. If the dictionary is a fixed-capacity dictionary and
            it is full before this operation, and the key does not exist in
            the dictionary, the behavior is undefined.
          @param key The key of the value to set into the dictionary. If a key
            which matches this key is already present in the dictionary, only
            the value is changed ("add if absent, replace if present"). If
            no key matches the given key, the key-value pair is added to the
            dictionary. If added, the key is retained by the dictionary,
            using the retain callback provided
            when the dictionary was created. If the key is not of the sort
            expected by the key retain callback, the behavior is undefined.
          @param value The value to add to or replace into the dictionary. The value
            is retained by the dictionary using the retain callback provided
            when the dictionary was created, and the previous value if any is
            released. If the value is not of the sort expected by the
            retain or release callbacks, the behavior is undefined.
        */
        CFDictionarySetValue(classesToMatch,
                             CFSTR(kIOSerialBSDTypeKey),
                             CFSTR(kIOSerialBSDModemType));

        // Each serial device object has a property with key
        // kIOSerialBSDTypeKey and a value that is one of kIOSerialBSDAllTypes,
        // kIOSerialBSDModemType, or kIOSerialBSDRS232Type. You can experiment with the
        // matching by changing the last parameter in the above call to CFDictionarySetValue.

        // As shipped, this sample is only interested in modems,
        // so add this property to the CFDictionary we're matching on.
        // This will find devices that advertise themselves as modems,
        // such as built-in and USB modems. However, this match won't find serial modems.
    }

    /*! @function IOServiceGetMatchingServices
        @abstract Look up registered IOService objects that match a matching dictionary.
        @discussion This is the preferred method of finding IOService objects currently registered by IOKit. IOServiceAddNotification can also supply this information and install a notification of new IOServices. The matching information used in the matching dictionary may vary depending on the class of service being looked up.
        @param masterPort The master port obtained from IOMasterPort().
        @param matching A CF dictionary containing matching information, of which one reference is consumed by this function. IOKitLib can contruct matching dictionaries for common criteria with helper functions such as IOServiceMatching, IOOpenFirmwarePathMatching.
        @param existing An iterator handle is returned on success, and should be released by the caller when the iteration is finished.
        @result A kern_return_t error code. */

    kernResult = IOServiceGetMatchingServices(kIOMasterPortDefault, classesToMatch, matchingServices);
    if (KERN_SUCCESS != kernResult) {
        printf("IOServiceGetMatchingServices returned %d\n", kernResult);
        goto exit;
    }

exit:
    return kernResult;
}

/** Given an iterator across a set of modems, return the BSD path to the first one.
 *  If no modems are found the path name is set to an empty string.
 */
static kern_return_t GetModemPath(io_iterator_t serialPortIterator, char *bsdPath, CFIndex maxPathSize)
{
    io_object_t    modemService;
    kern_return_t  kernResult = KERN_FAILURE;
    Boolean      modemFound = false;

    // Initialize the returned path
    *bsdPath = '\0';

    // Iterate across all modems found. In this example, we bail after finding the first modem.

    while ((modemService = IOIteratorNext(serialPortIterator)) && !modemFound) {
        CFTypeRef  bsdPathAsCFString;

        // Get the callout device's path (/dev/cu.xxxxx). The callout device should almost always be
        // used: the dialin device (/dev/tty.xxxxx) would be used when monitoring a serial port for
        // incoming calls, e.g. a fax listener.

        bsdPathAsCFString = IORegistryEntryCreateCFProperty(modemService,
177 178 179
                                                            CFSTR(kIOCalloutDeviceKey),
                                                            kCFAllocatorDefault,
                                                            0);
180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199
        if (bsdPathAsCFString) {
            Boolean result;

            // Convert the path from a CFString to a C (NUL-terminated) string for use
            // with the POSIX open() call.

            result = CFStringGetCString((CFStringRef)bsdPathAsCFString,
                                        bsdPath,
                                        maxPathSize,
                                        kCFStringEncodingUTF8);
            CFRelease(bsdPathAsCFString);

            if (result) {
                //printf("Modem found with BSD path: %s", bsdPath);
                modemFound = true;
                kernResult = KERN_SUCCESS;
            }
        }

        printf("\n");
200

201 202 203 204 205 206 207 208 209 210
        // Release the io_service_t now that we are done with it.

        (void) IOObjectRelease(modemService);
    }

    return kernResult;
}
#endif

using namespace TNX;
pixhawk's avatar
pixhawk committed
211

212 213
SerialLink::SerialLink(QString portname, int baudRate, bool hardwareFlowControl, bool parity,
                       int dataBits, int stopBits) :
214 215
    port(NULL),
    ports(new QVector<QString>()),
216 217
    m_stopp(false),
    bytesRead(0)
pixhawk's avatar
pixhawk committed
218 219 220
{
    // Setup settings
    this->porthandle = portname.trimmed();
221 222 223 224 225 226

    if (this->porthandle == "" && getCurrentPorts()->size() > 0)
    {
        this->porthandle = getCurrentPorts()->first().trimmed();
    }

pixhawk's avatar
pixhawk committed
227 228 229
#ifdef _WIN32
    // Port names above 20 need the network path format - if the port name is not already in this format
    // catch this special case
230
    if (this->porthandle.size() > 0 && !this->porthandle.startsWith("\\")) {
pixhawk's avatar
pixhawk committed
231 232 233 234 235 236
        // Append \\.\ before the port handle. Additional backslashes are used for escaping.
        this->porthandle = "\\\\.\\" + this->porthandle;
    }
#endif
    // Set unique ID and add link to the list of links
    this->id = getNextLinkId();
237

238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256
    setBaudRate(baudRate);
    if (hardwareFlowControl)
    {
        portSettings.setFlowControl(QPortSettings::FLOW_HARDWARE);
    }
    else
    {
        portSettings.setFlowControl(QPortSettings::FLOW_OFF);
    }
    if (parity)
    {
        portSettings.setParity(QPortSettings::PAR_EVEN);
    }
    else
    {
        portSettings.setParity(QPortSettings::PAR_NONE);
    }
    setDataBits(dataBits);
    setStopBits(stopBits);
pixhawk's avatar
pixhawk committed
257 258

    // Set the port name
259 260
    if (porthandle == "")
    {
261
        name = tr("Serial Link ") + QString::number(getId());
pixhawk's avatar
pixhawk committed
262
    }
263 264 265
    else
    {
        name = portname.trimmed();
pixhawk's avatar
pixhawk committed
266
    }
lm's avatar
lm committed
267
    loadSettings();
pixhawk's avatar
pixhawk committed
268 269 270 271 272
}

SerialLink::~SerialLink()
{
    disconnect();
273
    if(port) delete port;
pixhawk's avatar
pixhawk committed
274
    port = NULL;
275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327
    if (ports) delete ports;
    ports = NULL;
}

QVector<QString>* SerialLink::getCurrentPorts()
{
    ports->clear();
#ifdef __linux

    // TODO Linux has no standard way of enumerating serial ports
    // However the device files are only present when the physical
    // device is connected, therefore listing the files should be
    // sufficient.

    QString devdir = "/dev";
    QDir dir(devdir);
    dir.setFilter(QDir::System);

    QFileInfoList list = dir.entryInfoList();
    for (int i = 0; i < list.size(); ++i) {
        QFileInfo fileInfo = list.at(i);
        if (fileInfo.fileName().contains(QString("ttyUSB")) || fileInfo.fileName().contains(QString("ttyS")) || fileInfo.fileName().contains(QString("ttyACM")))
        {
            ports->append(fileInfo.canonicalFilePath());
        }
    }
#endif

#if defined (__APPLE__) && defined (__MACH__)

    // Enumerate serial ports
    kern_return_t    kernResult; // on PowerPC this is an int (4 bytes)
    io_iterator_t    serialPortIterator;
    char        bsdPath[MAXPATHLEN];
    kernResult = FindModems(&serialPortIterator);
    kernResult = GetModemPath(serialPortIterator, bsdPath, sizeof(bsdPath));
    IOObjectRelease(serialPortIterator);    // Release the iterator.

    // Add found modems
    if (bsdPath[0])
    {
        ports->append(QString(bsdPath));
    }

    // Add USB serial port adapters
    // TODO Strangely usb serial port adapters are not enumerated, even when connected
    QString devdir = "/dev";
    QDir dir(devdir);
    dir.setFilter(QDir::System);

    QFileInfoList list = dir.entryInfoList();
    for (int i = list.size() - 1; i >= 0; i--) {
        QFileInfo fileInfo = list.at(i);
328
        if (fileInfo.fileName().contains(QString("ttyUSB")) ||
329
                fileInfo.fileName().contains(QString("tty.")) ||
330 331
                fileInfo.fileName().contains(QString("ttyS")) ||
                fileInfo.fileName().contains(QString("ttyACM")))
332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347
        {
            ports->append(fileInfo.canonicalFilePath());
        }
    }
#endif

#ifdef _WIN32
    // Get the ports available on this system
    QList<QextPortInfo> ports = QextSerialEnumerator::getPorts();

    // Add the ports in reverse order, because we prepend them to the list
    for (int i = ports.size() - 1; i >= 0; i--)
    {
        QextPortInfo portInfo = ports.at(i);
        QString portString = QString(portInfo.portName.toLocal8Bit().constData()) + " - " + QString(ports.at(i).friendName.toLocal8Bit().constData()).split("(").first();
        // Prepend newly found port to the list
oberion's avatar
oberion committed
348
        this->ports->append(portString);
349 350 351 352 353 354 355 356
    }

    //printf("port name: %s\n", ports.at(i).portName.toLocal8Bit().constData());
    //printf("friendly name: %s\n", ports.at(i).friendName.toLocal8Bit().constData());
    //printf("physical name: %s\n", ports.at(i).physName.toLocal8Bit().constData());
    //printf("enumerator name: %s\n", ports.at(i).enumName.toLocal8Bit().constData());
    //printf("===================================\n\n");
#endif
oberion's avatar
oberion committed
357
    return this->ports;
pixhawk's avatar
pixhawk committed
358 359
}

360 361 362 363 364
void SerialLink::loadSettings()
{
    // Load defaults from settings
    QSettings settings(QGC::COMPANYNAME, QGC::APPNAME);
    settings.sync();
365 366
    if (settings.contains("SERIALLINK_COMM_PORT"))
    {
367
        setPortName(settings.value("SERIALLINK_COMM_PORT").toString());
368 369
        setBaudRateType(settings.value("SERIALLINK_COMM_BAUD").toInt());
        setParityType(settings.value("SERIALLINK_COMM_PARITY").toInt());
370 371 372
        setStopBits(settings.value("SERIALLINK_COMM_STOPBITS").toInt());
        setDataBits(settings.value("SERIALLINK_COMM_DATABITS").toInt());
        setFlowType(settings.value("SERIALLINK_COMM_FLOW_CONTROL").toInt());
373 374 375 376 377 378 379
    }
}

void SerialLink::writeSettings()
{
    // Store settings
    QSettings settings(QGC::COMPANYNAME, QGC::APPNAME);
380
    settings.setValue("SERIALLINK_COMM_PORT", getPortName());
381 382
    settings.setValue("SERIALLINK_COMM_BAUD", getBaudRateType());
    settings.setValue("SERIALLINK_COMM_PARITY", getParityType());
383 384 385
    settings.setValue("SERIALLINK_COMM_STOPBITS", getStopBits());
    settings.setValue("SERIALLINK_COMM_DATABITS", getDataBits());
    settings.setValue("SERIALLINK_COMM_FLOW_CONTROL", getFlowType());
386 387 388
    settings.sync();
}

pixhawk's avatar
pixhawk committed
389 390 391 392 393

/**
 * @brief Runs the thread
 *
 **/
394 395
void SerialLink::run()
{
pixhawk's avatar
pixhawk committed
396 397 398 399
    // Initialize the connection
    hardwareConnect();

    // Qt way to make clear what a while(1) loop does
400
    quint64 msecs = QDateTime::currentMSecsSinceEpoch();
401
    quint64 initialmsecs = QDateTime::currentMSecsSinceEpoch();
402 403 404
    quint64 bytes = 0;
    bool triedreset = false;
    bool triedDTR = false;
405
    int timeout = 2500;
406 407
    forever
    {
408 409 410 411 412 413 414 415
        {
            QMutexLocker locker(&this->m_stoppMutex);
            if(this->m_stopp)
            {
                this->m_stopp = false;
                break;
            }
        }
pixhawk's avatar
pixhawk committed
416 417
        // Check if new bytes have arrived, if yes, emit the notification signal
        checkForBytes();
418 419 420 421 422 423 424
        if (bytes != bytesRead)
        {
            bytes = bytesRead;
            msecs = QDateTime::currentMSecsSinceEpoch();
        }
        else
        {
425
            if (QDateTime::currentMSecsSinceEpoch() - msecs > timeout)
426 427 428
            {
                //It's been 10 seconds since the last data came in. Reset and try again
                msecs = QDateTime::currentMSecsSinceEpoch();
429 430 431 432 433 434 435 436 437
                if (msecs - initialmsecs > 25000)
                {
                    //After initial 25 seconds, timeouts are increased to 30 seconds.
                    //This prevents temporary silences from things like calibration commands
                    //from screwing things up. In all reality, timeouts should be enabled/disabled
                    //for events like that on a case by case basis.
                    //TODO ^^
                    timeout = 30000;
                }
438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457
                if (!triedDTR && triedreset)
                {
                    triedDTR = true;
                    qDebug() << "No data!!! Attempting reset via DTR.";
                    port->setDtr(true);
                    this->msleep(250);
                    port->setDtr(false);
                }
                else if (!triedreset)
                {
                    qDebug() << "No data!!! Attempting reset via reboot command.";
                    port->write("reboot\r\n",8);
                    triedreset = true;
                }
                else
                {
                    qDebug() << "No data!!!";
                }
            }
        }
pixhawk's avatar
pixhawk committed
458 459 460 461 462
        /* Serial data isn't arriving that fast normally, this saves the thread
                 * from consuming too much processing time
                 */
        MG::SLEEP::msleep(SerialLink::poll_interval);
    }
463
    if (port) {
oberion's avatar
oberion committed
464 465 466 467 468
        port->flushInBuffer();
        port->flushOutBuffer();
        port->close();
        delete port;
        port = NULL;
469
    }
pixhawk's avatar
pixhawk committed
470 471 472
}


473 474
void SerialLink::checkForBytes()
{
pixhawk's avatar
pixhawk committed
475
    /* Check if bytes are available */
476 477
    if(port && port->isOpen() && port->isWritable())
    {
pixhawk's avatar
pixhawk committed
478 479 480 481
        dataMutex.lock();
        qint64 available = port->bytesAvailable();
        dataMutex.unlock();

482 483
        if(available > 0)
        {
484
            readBytes();
485
            bytesRead += available;
pixhawk's avatar
pixhawk committed
486
        }
487 488 489 490 491 492 493
        else if (available < 0) {
            /* Error, close port */
            port->close();
            emit disconnected();
            emit connected(false);
            emit communicationError(this->getName(), tr("Could not send data - link %1 is disconnected!").arg(this->getName()));
        }
494
    }
495 496 497 498 499
//    else
//    {
//        emit disconnected();
//        emit connected(false);
//    }
pixhawk's avatar
pixhawk committed
500 501 502

}

503 504
void SerialLink::writeBytes(const char* data, qint64 size)
{
505
    if(port && port->isOpen()) {
pixhawk's avatar
pixhawk committed
506 507
        int b = port->write(data, size);

508
        if (b > 0) {
509

510
            //            qDebug() << "Serial link " << this->getName() << "transmitted" << b << "bytes:";
pixhawk's avatar
pixhawk committed
511

512 513 514
            // Increase write counter
            bitsSentTotal += size * 8;

515 516 517 518 519 520 521
            //            int i;
            //            for (i=0; i<size; i++)
            //            {
            //                unsigned char v =data[i];
            //                qDebug("%02x ", v);
            //            }
            //            qDebug("\n");
522
        } else {
523 524 525
            disconnect();
            // Error occured
            emit communicationError(this->getName(), tr("Could not send data - link %1 is disconnected!").arg(this->getName()));
526
        }
pixhawk's avatar
pixhawk committed
527 528 529 530 531 532 533 534 535
    }
}

/**
 * @brief Read a number of bytes from the interface.
 *
 * @param data Pointer to the data byte array to write the bytes to
 * @param maxLength The maximum number of bytes to write
 **/
536 537
void SerialLink::readBytes()
{
pixhawk's avatar
pixhawk committed
538
    dataMutex.lock();
539
    if(port && port->isOpen()) {
540 541
        const qint64 maxLength = 2048;
        char data[maxLength];
pixhawk's avatar
pixhawk committed
542
        qint64 numBytes = port->bytesAvailable();
James Goppert's avatar
James Goppert committed
543
        //qDebug() << "numBytes: " << numBytes;
544

545
        if(numBytes > 0) {
pixhawk's avatar
pixhawk committed
546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572
            /* Read as much data in buffer as possible without overflow */
            if(maxLength < numBytes) numBytes = maxLength;

            port->read(data, numBytes);
            QByteArray b(data, numBytes);
            emit bytesReceived(this, b);

            //qDebug() << "SerialLink::readBytes()" << std::hex << data;
            //            int i;
            //            for (i=0; i<numBytes; i++){
            //                unsigned int v=data[i];
            //
            //                fprintf(stderr,"%02x ", v);
            //            }
            //            fprintf(stderr,"\n");
            bitsReceivedTotal += numBytes * 8;
        }
    }
    dataMutex.unlock();
}


/**
 * @brief Get the number of bytes to read.
 *
 * @return The number of bytes to read
 **/
573 574
qint64 SerialLink::bytesAvailable()
{
575
    if (port) {
576
        return port->bytesAvailable();
577
    } else {
578 579
        return 0;
    }
pixhawk's avatar
pixhawk committed
580 581 582 583 584 585 586
}

/**
 * @brief Disconnect the connection.
 *
 * @return True if connection has been disconnected, false if connection couldn't be disconnected.
 **/
587 588
bool SerialLink::disconnect()
{
589 590 591 592 593 594 595 596 597
    if(this->isRunning())
    {
        {
            QMutexLocker locker(&this->m_stoppMutex);
            this->m_stopp = true;
        }
        this->wait();

        //    if (port) {
598 599 600
        //#if !defined _WIN32 || !defined _WIN64
        /* Block the thread until it returns from run() */
        //#endif
601 602 603 604 605 606 607 608
        //        port->flushInBuffer();
        //        port->flushOutBuffer();
        //        port->close();
        //        delete port;
        //        port = NULL;

        //        if(this->isRunning()) this->terminate(); //stop running the thread, restart it upon connect

609 610
        bool closed = true;
        //port->isOpen();
pixhawk's avatar
pixhawk committed
611

612 613
        emit disconnected();
        emit connected(false);
614 615 616
        if (port) {
            port->close();
        }
617
        return closed;
618
    }
oberion's avatar
oberion committed
619
    else {
620 621 622 623
        // not running
        if (port) {
            port->close();
        }
624 625
        return true;
    }
pixhawk's avatar
pixhawk committed
626 627 628 629 630 631 632 633 634 635

}

/**
 * @brief Connect the connection.
 *
 * @return True if connection has been established, false if connection couldn't be established.
 **/
bool SerialLink::connect()
{
636
    if (this->isRunning()) this->disconnect();
637 638 639 640
    {
        QMutexLocker locker(&this->m_stoppMutex);
        this->m_stopp = false;
    }
641
    this->start(LowPriority);
642
    return true;
pixhawk's avatar
pixhawk committed
643 644 645 646 647 648 649 650 651 652
}

/**
 * @brief This function is called indirectly by the connect() call.
 *
 * The connect() function starts the thread and indirectly calls this method.
 *
 * @return True if the connection could be established, false otherwise
 * @see connect() For the right function to establish the connection.
 **/
653 654
bool SerialLink::hardwareConnect()
{
655
    if(port) {
656 657 658
        port->close();
        delete port;
    }
659 660 661
    port = new QSerialPort(porthandle, portSettings);
    QObject::connect(port,SIGNAL(aboutToClose()),this,SIGNAL(disconnected()));
    port->setCommTimeouts(QSerialPort::CtScheme_NonBlockingRead);
pixhawk's avatar
pixhawk committed
662 663
    connectionStartTime = MG::TIME::getGroundTimeNow();

664 665
    port->open();

pixhawk's avatar
pixhawk committed
666
    bool connectionUp = isConnected();
667
    if(connectionUp) {
pixhawk's avatar
pixhawk committed
668 669 670 671
        emit connected();
        emit connected(true);
    }

672
    //qDebug() << "CONNECTING LINK: " << __FILE__ << __LINE__ << "with settings" << port->portName() << getBaudRate() << getDataBits() << getParityType() << getStopBits();
673 674


675 676
    writeSettings();

pixhawk's avatar
pixhawk committed
677 678
    return connectionUp;
}
679 680


pixhawk's avatar
pixhawk committed
681 682 683 684 685
/**
 * @brief Check if connection is active.
 *
 * @return True if link is connected, false otherwise.
 **/
686 687
bool SerialLink::isConnected()
{
688
    if (port) {
lm's avatar
lm committed
689
        return port->isOpen();
690
    } else {
lm's avatar
lm committed
691 692
        return false;
    }
pixhawk's avatar
pixhawk committed
693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711
}

int SerialLink::getId()
{
    return id;
}

QString SerialLink::getName()
{
    return name;
}

void SerialLink::setName(QString name)
{
    this->name = name;
    emit nameChanged(this->name);
}


712 713 714 715
/**
  * This function maps baud rate constants to numerical equivalents.
  * It relies on the mapping given in qportsettings.h from the QSerialPort library.
  */
716 717
qint64 SerialLink::getNominalDataRate()
{
pixhawk's avatar
pixhawk committed
718
    qint64 dataRate = 0;
719
    switch (portSettings.baudRate()) {
720

721
    // Baud rates supported only by POSIX systems
722
#if defined(Q_OS_UNIX) || defined(Q_OS_LINUX) || defined(Q_OS_DARWIN)
723
    case QPortSettings::BAUDR_50:
pixhawk's avatar
pixhawk committed
724 725
        dataRate = 50;
        break;
726
    case QPortSettings::BAUDR_75:
pixhawk's avatar
pixhawk committed
727 728
        dataRate = 75;
        break;
729
    case QPortSettings::BAUDR_134:
pixhawk's avatar
pixhawk committed
730 731
        dataRate = 134;
        break;
732
    case QPortSettings::BAUDR_150:
pixhawk's avatar
pixhawk committed
733 734
        dataRate = 150;
        break;
735
    case QPortSettings::BAUDR_200:
pixhawk's avatar
pixhawk committed
736 737
        dataRate = 200;
        break;
738 739 740
    case QPortSettings::BAUDR_1800:
        dataRate = 1800;
        break;
741
#endif
742

743
        // Baud rates supported only by Windows
744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760
#if defined(Q_OS_WIN32) || defined(Q_OS_WINCE)
    case QPortSettings::BAUDR_14400:
        dataRate = 14400;
        break;
    case QPortSettings::BAUDR_56000:
        dataRate = 56000;
        break;
    case QPortSettings::BAUDR_128000:
        dataRate = 128000;
        break;
    case QPortSettings::BAUDR_256000:
        dataRate = 256000;
#endif

    case QPortSettings::BAUDR_110:
        dataRate = 110;
        break;
761
    case QPortSettings::BAUDR_300:
pixhawk's avatar
pixhawk committed
762 763
        dataRate = 300;
        break;
764
    case QPortSettings::BAUDR_600:
pixhawk's avatar
pixhawk committed
765 766
        dataRate = 600;
        break;
767
    case QPortSettings::BAUDR_1200:
pixhawk's avatar
pixhawk committed
768 769
        dataRate = 1200;
        break;
770
    case QPortSettings::BAUDR_2400:
pixhawk's avatar
pixhawk committed
771 772
        dataRate = 2400;
        break;
773
    case QPortSettings::BAUDR_4800:
pixhawk's avatar
pixhawk committed
774 775
        dataRate = 4800;
        break;
776
    case QPortSettings::BAUDR_9600:
pixhawk's avatar
pixhawk committed
777 778
        dataRate = 9600;
        break;
779
    case QPortSettings::BAUDR_19200:
pixhawk's avatar
pixhawk committed
780 781
        dataRate = 19200;
        break;
782
    case QPortSettings::BAUDR_38400:
pixhawk's avatar
pixhawk committed
783 784
        dataRate = 38400;
        break;
785
    case QPortSettings::BAUDR_57600:
pixhawk's avatar
pixhawk committed
786 787
        dataRate = 57600;
        break;
788
    case QPortSettings::BAUDR_115200:
pixhawk's avatar
pixhawk committed
789 790
        dataRate = 115200;
        break;
791 792 793 794 795 796 797 798 799 800 801 802 803 804 805
    case QPortSettings::BAUDR_230400:
        dataRate = 230400;
        break;
    case QPortSettings::BAUDR_460800:
        dataRate = 460800;
        break;
    case QPortSettings::BAUDR_500000:
        dataRate = 500000;
        break;
    case QPortSettings::BAUDR_576000:
        dataRate = 576000;
        break;
    case QPortSettings::BAUDR_921600:
        dataRate = 921600;
        break;
806

807
        // Otherwise do nothing.
808
    case QPortSettings::BAUDR_UNKNOWN:
809
    default:
810
        break;
pixhawk's avatar
pixhawk committed
811 812 813 814
    }
    return dataRate;
}

815 816
qint64 SerialLink::getTotalUpstream()
{
pixhawk's avatar
pixhawk committed
817 818 819 820 821
    statisticsMutex.lock();
    return bitsSentTotal / ((MG::TIME::getGroundTimeNow() - connectionStartTime) / 1000);
    statisticsMutex.unlock();
}

822 823
qint64 SerialLink::getCurrentUpstream()
{
pixhawk's avatar
pixhawk committed
824 825 826
    return 0; // TODO
}

827 828
qint64 SerialLink::getMaxUpstream()
{
pixhawk's avatar
pixhawk committed
829 830 831
    return 0; // TODO
}

832 833
qint64 SerialLink::getBitsSent()
{
pixhawk's avatar
pixhawk committed
834 835 836
    return bitsSentTotal;
}

837 838
qint64 SerialLink::getBitsReceived()
{
pixhawk's avatar
pixhawk committed
839 840 841
    return bitsReceivedTotal;
}

842 843
qint64 SerialLink::getTotalDownstream()
{
pixhawk's avatar
pixhawk committed
844 845 846 847 848
    statisticsMutex.lock();
    return bitsReceivedTotal / ((MG::TIME::getGroundTimeNow() - connectionStartTime) / 1000);
    statisticsMutex.unlock();
}

849 850
qint64 SerialLink::getCurrentDownstream()
{
pixhawk's avatar
pixhawk committed
851 852 853
    return 0; // TODO
}

854 855
qint64 SerialLink::getMaxDownstream()
{
pixhawk's avatar
pixhawk committed
856 857 858
    return 0; // TODO
}

859 860
bool SerialLink::isFullDuplex()
{
pixhawk's avatar
pixhawk committed
861 862 863 864
    /* Serial connections are always half duplex */
    return false;
}

865 866
int SerialLink::getLinkQuality()
{
pixhawk's avatar
pixhawk committed
867 868 869 870
    /* This feature is not supported with this interface */
    return -1;
}

871 872
QString SerialLink::getPortName()
{
pixhawk's avatar
pixhawk committed
873 874 875
    return porthandle;
}

876 877
int SerialLink::getBaudRate()
{
pixhawk's avatar
pixhawk committed
878 879 880
    return getNominalDataRate();
}

881 882
int SerialLink::getBaudRateType()
{
883
    return portSettings.baudRate();
pixhawk's avatar
pixhawk committed
884 885
}

886 887
int SerialLink::getFlowType()
{
888
    return portSettings.flowControl();
pixhawk's avatar
pixhawk committed
889 890
}

891 892
int SerialLink::getParityType()
{
893
    return portSettings.parity();
pixhawk's avatar
pixhawk committed
894 895
}

896 897
int SerialLink::getDataBitsType()
{
898
    return portSettings.dataBits();
pixhawk's avatar
pixhawk committed
899 900
}

901 902
int SerialLink::getStopBitsType()
{
903
    return portSettings.stopBits();
pixhawk's avatar
pixhawk committed
904 905
}

906 907
int SerialLink::getDataBits()
{
908 909 910
    int ret = -1;
    switch (portSettings.dataBits()) {
    case QPortSettings::DB_5:
911 912
        ret = 5;
        break;
913
    case QPortSettings::DB_6:
914 915
        ret = 6;
        break;
916
    case QPortSettings::DB_7:
917 918
        ret = 7;
        break;
919
    case QPortSettings::DB_8:
920 921 922
        ret = 8;
        break;
    default:
923
        ret = -1;
924 925 926 927 928 929 930
        break;
    }
    return ret;
}

int SerialLink::getStopBits()
{
931
    int ret = -1;
932 933 934 935 936 937 938 939 940 941 942
    switch (portSettings.stopBits()) {
    case QPortSettings::STOP_1:
        ret = 1;
        break;
    case QPortSettings::STOP_2:
        ret = 2;
        break;
    default:
        ret = -1;
        break;
    }
943 944 945
    return ret;
}

pixhawk's avatar
pixhawk committed
946 947
bool SerialLink::setPortName(QString portName)
{
948
    if(portName.trimmed().length() > 0) {
pixhawk's avatar
pixhawk committed
949
        bool reconnect = false;
950 951 952
        if (isConnected()) reconnect = true;
        disconnect();

pixhawk's avatar
pixhawk committed
953 954 955 956 957
        this->porthandle = portName.trimmed();
        setName(tr("serial port ") + portName.trimmed());
#ifdef _WIN32
        // Port names above 20 need the network path format - if the port name is not already in this format
        // catch this special case
958
        if (!this->porthandle.startsWith("\\")) {
pixhawk's avatar
pixhawk committed
959 960 961 962
            // Append \\.\ before the port handle. Additional backslashes are used for escaping.
            this->porthandle = "\\\\.\\" + this->porthandle;
        }
#endif
963

pixhawk's avatar
pixhawk committed
964 965
        if(reconnect) connect();
        return true;
966
    } else {
pixhawk's avatar
pixhawk committed
967 968 969 970 971 972 973 974 975
        return false;
    }
}


bool SerialLink::setBaudRateType(int rateIndex)
{
    bool reconnect = false;
    bool accepted = true; // This is changed if none of the data rates matches
976 977 978
    if(isConnected()) reconnect = true;
    disconnect();

979
    // These minimum and maximum baud rates were based on those enumerated in qportsettings.h.
980
#if defined(Q_OS_WIN32) || defined(Q_OS_WINCE)
981
    const int minBaud = (int)QPortSettings::BAUDR_110;
982
    const int maxBaud = (int)QPortSettings::BAUDR_921600;
983
#elif defined(Q_OS_LINUX)
984 985
    const int minBaud = (int)QPortSettings::BAUDR_50;
    const int maxBaud = (int)QPortSettings::BAUDR_921600;
986
#elif defined(Q_OS_UNIX) || defined(Q_OS_DARWIN)
987
    const int minBaud = (int)QPortSettings::BAUDR_50;
988
    const int maxBaud = (int)QPortSettings::BAUDR_921600;
989 990
#endif

991
    if (rateIndex >= minBaud && rateIndex <= maxBaud)
992 993
    {
        portSettings.setBaudRate((QPortSettings::BaudRate)rateIndex);
pixhawk's avatar
pixhawk committed
994 995 996 997 998 999
    }

    if(reconnect) connect();
    return accepted;
}

1000 1001 1002 1003 1004 1005 1006
bool SerialLink::setBaudRateString(const QString& rate)
{
    bool ok;
    int intrate = rate.toInt(&ok);
    if (!ok) return false;
    return setBaudRate(intrate);
}
pixhawk's avatar
pixhawk committed
1007 1008 1009 1010 1011

bool SerialLink::setBaudRate(int rate)
{
    bool reconnect = false;
    bool accepted = true; // This is changed if none of the data rates matches
1012
    if(isConnected()) {
pixhawk's avatar
pixhawk committed
1013 1014
        reconnect = true;
    }
1015
    disconnect();
1016

1017
    // This switch-statment relies on the mapping given in qportsettings.h from the QSerialPort library.
1018
    switch (rate) {
1019

1020
    // Baud rates supported only by non-Windows systems
1021
#if defined(Q_OS_UNIX) || defined(Q_OS_LINUX) || defined(Q_OS_DARWIN)
pixhawk's avatar
pixhawk committed
1022
    case 50:
1023
        portSettings.setBaudRate(QPortSettings::BAUDR_50);
pixhawk's avatar
pixhawk committed
1024 1025
        break;
    case 75:
1026
        portSettings.setBaudRate(QPortSettings::BAUDR_75);
pixhawk's avatar
pixhawk committed
1027 1028
        break;
    case 134:
1029
        portSettings.setBaudRate(QPortSettings::BAUDR_134);
pixhawk's avatar
pixhawk committed
1030 1031
        break;
    case 150:
1032
        portSettings.setBaudRate(QPortSettings::BAUDR_150);
pixhawk's avatar
pixhawk committed
1033 1034
        break;
    case 200:
1035
        portSettings.setBaudRate(QPortSettings::BAUDR_200);
pixhawk's avatar
pixhawk committed
1036
        break;
1037 1038 1039 1040 1041
    case 1800:
        portSettings.setBaudRate(QPortSettings::BAUDR_1800);
        break;
#endif

1042
        // Baud rates supported only by windows
1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055
#if defined(Q_OS_WIN32) || defined(Q_OS_WINCE)
    case 14400:
        portSettings.setBaudRate(QPortSettings::BAUDR_14400);
        break;
    case 56000:
        portSettings.setBaudRate(QPortSettings::BAUDR_56000);
        break;
    case 128000:
        portSettings.setBaudRate(QPortSettings::BAUDR_128000);
        break;
    case 256000:
        portSettings.setBaudRate(QPortSettings::BAUDR_256000);
        break;
1056
#endif
1057

1058
        // Supported by all OSes:
1059 1060 1061
    case 110:
        portSettings.setBaudRate(QPortSettings::BAUDR_110);
        break;
pixhawk's avatar
pixhawk committed
1062
    case 300:
1063
        portSettings.setBaudRate(QPortSettings::BAUDR_300);
pixhawk's avatar
pixhawk committed
1064 1065
        break;
    case 600:
1066
        portSettings.setBaudRate(QPortSettings::BAUDR_600);
pixhawk's avatar
pixhawk committed
1067 1068
        break;
    case 1200:
1069
        portSettings.setBaudRate(QPortSettings::BAUDR_1200);
pixhawk's avatar
pixhawk committed
1070 1071
        break;
    case 2400:
1072
        portSettings.setBaudRate(QPortSettings::BAUDR_2400);
pixhawk's avatar
pixhawk committed
1073 1074
        break;
    case 4800:
1075
        portSettings.setBaudRate(QPortSettings::BAUDR_4800);
pixhawk's avatar
pixhawk committed
1076 1077
        break;
    case 9600:
1078
        portSettings.setBaudRate(QPortSettings::BAUDR_9600);
pixhawk's avatar
pixhawk committed
1079 1080
        break;
    case 19200:
1081
        portSettings.setBaudRate(QPortSettings::BAUDR_19200);
pixhawk's avatar
pixhawk committed
1082 1083
        break;
    case 38400:
1084
        portSettings.setBaudRate(QPortSettings::BAUDR_38400);
pixhawk's avatar
pixhawk committed
1085 1086
        break;
    case 57600:
1087
        portSettings.setBaudRate(QPortSettings::BAUDR_57600);
pixhawk's avatar
pixhawk committed
1088 1089
        break;
    case 115200:
1090
        portSettings.setBaudRate(QPortSettings::BAUDR_115200);
pixhawk's avatar
pixhawk committed
1091
        break;
1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106
    case 230400:
        portSettings.setBaudRate(QPortSettings::BAUDR_230400);
        break;
    case 460800:
        portSettings.setBaudRate(QPortSettings::BAUDR_460800);
        break;
    case 500000:
        portSettings.setBaudRate(QPortSettings::BAUDR_500000);
        break;
    case 576000:
        portSettings.setBaudRate(QPortSettings::BAUDR_576000);
        break;
    case 921600:
        portSettings.setBaudRate(QPortSettings::BAUDR_921600);
        break;
pixhawk's avatar
pixhawk committed
1107 1108 1109 1110 1111 1112
    default:
        // If none of the above cases matches, there must be an error
        accepted = false;
        break;
    }

1113 1114 1115
    if(reconnect) connect();
    return accepted;

pixhawk's avatar
pixhawk committed
1116 1117
}

1118 1119
bool SerialLink::setFlowType(int flow)
{
pixhawk's avatar
pixhawk committed
1120 1121
    bool reconnect = false;
    bool accepted = true;
1122 1123
    if(isConnected()) reconnect = true;
    disconnect();
pixhawk's avatar
pixhawk committed
1124

1125
    switch (flow) {
1126 1127
    case (int)QPortSettings::FLOW_OFF:
        portSettings.setFlowControl(QPortSettings::FLOW_OFF);
pixhawk's avatar
pixhawk committed
1128
        break;
1129 1130
    case (int)QPortSettings::FLOW_HARDWARE:
        portSettings.setFlowControl(QPortSettings::FLOW_HARDWARE);
pixhawk's avatar
pixhawk committed
1131
        break;
1132 1133
    case (int)QPortSettings::FLOW_XONXOFF:
        portSettings.setFlowControl(QPortSettings::FLOW_XONXOFF);
pixhawk's avatar
pixhawk committed
1134 1135 1136 1137 1138 1139
        break;
    default:
        // If none of the above cases matches, there must be an error
        accepted = false;
        break;
    }
1140

pixhawk's avatar
pixhawk committed
1141 1142 1143 1144
    if(reconnect) connect();
    return accepted;
}

1145 1146
bool SerialLink::setParityType(int parity)
{
pixhawk's avatar
pixhawk committed
1147 1148
    bool reconnect = false;
    bool accepted = true;
1149 1150
    if (isConnected()) reconnect = true;
    disconnect();
pixhawk's avatar
pixhawk committed
1151

1152
    switch (parity) {
1153 1154
    case (int)QPortSettings::PAR_NONE:
        portSettings.setParity(QPortSettings::PAR_NONE);
pixhawk's avatar
pixhawk committed
1155
        break;
1156 1157
    case (int)QPortSettings::PAR_ODD:
        portSettings.setParity(QPortSettings::PAR_ODD);
pixhawk's avatar
pixhawk committed
1158
        break;
1159 1160
    case (int)QPortSettings::PAR_EVEN:
        portSettings.setParity(QPortSettings::PAR_EVEN);
pixhawk's avatar
pixhawk committed
1161
        break;
1162 1163
    case (int)QPortSettings::PAR_SPACE:
        portSettings.setParity(QPortSettings::PAR_SPACE);
pixhawk's avatar
pixhawk committed
1164 1165 1166 1167 1168 1169 1170
        break;
    default:
        // If none of the above cases matches, there must be an error
        accepted = false;
        break;
    }

1171
    if (reconnect) connect();
pixhawk's avatar
pixhawk committed
1172 1173 1174
    return accepted;
}

1175

1176
bool SerialLink::setDataBits(int dataBits)
1177
{
1178
    //qDebug() << "Setting" << dataBits << "data bits";
1179 1180
    bool reconnect = false;
    if (isConnected()) reconnect = true;
pixhawk's avatar
pixhawk committed
1181
    bool accepted = true;
1182
    disconnect();
pixhawk's avatar
pixhawk committed
1183

1184
    switch (dataBits) {
pixhawk's avatar
pixhawk committed
1185
    case 5:
1186
        portSettings.setDataBits(QPortSettings::DB_5);
pixhawk's avatar
pixhawk committed
1187 1188
        break;
    case 6:
1189
        portSettings.setDataBits(QPortSettings::DB_6);
pixhawk's avatar
pixhawk committed
1190 1191
        break;
    case 7:
1192
        portSettings.setDataBits(QPortSettings::DB_7);
pixhawk's avatar
pixhawk committed
1193 1194
        break;
    case 8:
1195
        portSettings.setDataBits(QPortSettings::DB_8);
pixhawk's avatar
pixhawk committed
1196 1197 1198 1199 1200 1201 1202
        break;
    default:
        // If none of the above cases matches, there must be an error
        accepted = false;
        break;
    }

1203
    if(reconnect) connect();
pixhawk's avatar
pixhawk committed
1204 1205 1206 1207

    return accepted;
}

1208
bool SerialLink::setStopBits(int stopBits)
1209
{
pixhawk's avatar
pixhawk committed
1210 1211
    bool reconnect = false;
    bool accepted = true;
1212 1213
    if(isConnected()) reconnect = true;
    disconnect();
pixhawk's avatar
pixhawk committed
1214

1215
    switch (stopBits) {
pixhawk's avatar
pixhawk committed
1216
    case 1:
1217
        portSettings.setStopBits(QPortSettings::STOP_1);
pixhawk's avatar
pixhawk committed
1218 1219
        break;
    case 2:
1220
        portSettings.setStopBits(QPortSettings::STOP_2);
pixhawk's avatar
pixhawk committed
1221 1222 1223 1224 1225 1226 1227 1228 1229 1230
        break;
    default:
        // If none of the above cases matches, there must be an error
        accepted = false;
        break;
    }

    if(reconnect) connect();
    return accepted;
}
1231 1232 1233 1234 1235 1236

bool SerialLink::setDataBitsType(int dataBits)
{
    bool reconnect = false;
    bool accepted = false;

1237 1238
    if (isConnected()) reconnect = true;
    disconnect();
1239

1240 1241
    if (dataBits >= (int)QPortSettings::DB_5 && dataBits <= (int)QPortSettings::DB_8) {
        portSettings.setDataBits((QPortSettings::DataBits) dataBits);
1242

1243
        if(reconnect) connect();
1244 1245 1246 1247 1248 1249 1250 1251 1252 1253
        accepted = true;
    }

    return accepted;
}

bool SerialLink::setStopBitsType(int stopBits)
{
    bool reconnect = false;
    bool accepted = false;
1254 1255
    if(isConnected()) reconnect = true;
    disconnect();
1256

1257 1258
    if (stopBits >= (int)QPortSettings::STOP_1 && stopBits <= (int)QPortSettings::STOP_2) {
        portSettings.setStopBits((QPortSettings::StopBits) stopBits);
1259

1260
        if(reconnect) connect();
1261 1262 1263 1264 1265 1266
        accepted = true;
    }

    if(reconnect) connect();
    return accepted;
}