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
    // Initialize the connection
397 398 399 400 401
    if (!hardwareConnect())
    {
        //Need to error out here.

    }
pixhawk's avatar
pixhawk committed
402 403

    // Qt way to make clear what a while(1) loop does
404
    quint64 msecs = QDateTime::currentMSecsSinceEpoch();
405
    quint64 initialmsecs = QDateTime::currentMSecsSinceEpoch();
406 407 408
    quint64 bytes = 0;
    bool triedreset = false;
    bool triedDTR = false;
409
    int timeout = 2500;
410 411
    forever
    {
412 413 414 415 416 417 418 419
        {
            QMutexLocker locker(&this->m_stoppMutex);
            if(this->m_stopp)
            {
                this->m_stopp = false;
                break;
            }
        }
pixhawk's avatar
pixhawk committed
420 421
        // Check if new bytes have arrived, if yes, emit the notification signal
        checkForBytes();
422 423 424 425 426 427 428
        if (bytes != bytesRead)
        {
            bytes = bytesRead;
            msecs = QDateTime::currentMSecsSinceEpoch();
        }
        else
        {
429
            if (QDateTime::currentMSecsSinceEpoch() - msecs > timeout)
430 431 432
            {
                //It's been 10 seconds since the last data came in. Reset and try again
                msecs = QDateTime::currentMSecsSinceEpoch();
433 434 435 436 437 438 439 440 441
                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;
                }
442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461
                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
462 463 464 465 466
        /* Serial data isn't arriving that fast normally, this saves the thread
                 * from consuming too much processing time
                 */
        MG::SLEEP::msleep(SerialLink::poll_interval);
    }
467
    if (port) {
oberion's avatar
oberion committed
468 469 470 471 472
        port->flushInBuffer();
        port->flushOutBuffer();
        port->close();
        delete port;
        port = NULL;
473
    }
pixhawk's avatar
pixhawk committed
474 475 476
}


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

486 487
        if(available > 0)
        {
488
            readBytes();
489
            bytesRead += available;
pixhawk's avatar
pixhawk committed
490
        }
491 492 493 494 495 496 497
        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()));
        }
498
    }
499 500 501 502 503
//    else
//    {
//        emit disconnected();
//        emit connected(false);
//    }
pixhawk's avatar
pixhawk committed
504 505 506

}

507 508
void SerialLink::writeBytes(const char* data, qint64 size)
{
509
    if(port && port->isOpen()) {
pixhawk's avatar
pixhawk committed
510 511
        int b = port->write(data, size);

512
        if (b > 0) {
513

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

516 517 518
            // Increase write counter
            bitsSentTotal += size * 8;

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

/**
 * @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
 **/
540 541
void SerialLink::readBytes()
{
pixhawk's avatar
pixhawk committed
542
    dataMutex.lock();
543
    if(port && port->isOpen()) {
544 545
        const qint64 maxLength = 2048;
        char data[maxLength];
pixhawk's avatar
pixhawk committed
546
        qint64 numBytes = port->bytesAvailable();
James Goppert's avatar
James Goppert committed
547
        //qDebug() << "numBytes: " << numBytes;
548

549
        if(numBytes > 0) {
pixhawk's avatar
pixhawk committed
550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576
            /* 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
 **/
577 578
qint64 SerialLink::bytesAvailable()
{
579
    if (port) {
580
        return port->bytesAvailable();
581
    } else {
582 583
        return 0;
    }
pixhawk's avatar
pixhawk committed
584 585 586 587 588 589 590
}

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

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

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

613 614
        bool closed = true;
        //port->isOpen();
pixhawk's avatar
pixhawk committed
615

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

}

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

/**
 * @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.
 **/
657 658
bool SerialLink::hardwareConnect()
{
659
    if(port) {
660 661 662
        port->close();
        delete port;
    }
663 664 665
    port = new QSerialPort(porthandle, portSettings);
    QObject::connect(port,SIGNAL(aboutToClose()),this,SIGNAL(disconnected()));
    port->setCommTimeouts(QSerialPort::CtScheme_NonBlockingRead);
pixhawk's avatar
pixhawk committed
666 667
    connectionStartTime = MG::TIME::getGroundTimeNow();

668 669
    port->open();

pixhawk's avatar
pixhawk committed
670
    bool connectionUp = isConnected();
671
    if(connectionUp) {
pixhawk's avatar
pixhawk committed
672 673 674 675
        emit connected();
        emit connected(true);
    }

676
    //qDebug() << "CONNECTING LINK: " << __FILE__ << __LINE__ << "with settings" << port->portName() << getBaudRate() << getDataBits() << getParityType() << getStopBits();
677 678


679 680
    writeSettings();

pixhawk's avatar
pixhawk committed
681 682
    return connectionUp;
}
683 684


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

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

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

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


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

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

747
        // Baud rates supported only by Windows
748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764
#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;
765
    case QPortSettings::BAUDR_300:
pixhawk's avatar
pixhawk committed
766 767
        dataRate = 300;
        break;
768
    case QPortSettings::BAUDR_600:
pixhawk's avatar
pixhawk committed
769 770
        dataRate = 600;
        break;
771
    case QPortSettings::BAUDR_1200:
pixhawk's avatar
pixhawk committed
772 773
        dataRate = 1200;
        break;
774
    case QPortSettings::BAUDR_2400:
pixhawk's avatar
pixhawk committed
775 776
        dataRate = 2400;
        break;
777
    case QPortSettings::BAUDR_4800:
pixhawk's avatar
pixhawk committed
778 779
        dataRate = 4800;
        break;
780
    case QPortSettings::BAUDR_9600:
pixhawk's avatar
pixhawk committed
781 782
        dataRate = 9600;
        break;
783
    case QPortSettings::BAUDR_19200:
pixhawk's avatar
pixhawk committed
784 785
        dataRate = 19200;
        break;
786
    case QPortSettings::BAUDR_38400:
pixhawk's avatar
pixhawk committed
787 788
        dataRate = 38400;
        break;
789
    case QPortSettings::BAUDR_57600:
pixhawk's avatar
pixhawk committed
790 791
        dataRate = 57600;
        break;
792
    case QPortSettings::BAUDR_115200:
pixhawk's avatar
pixhawk committed
793 794
        dataRate = 115200;
        break;
795 796 797 798 799 800 801 802 803 804 805 806 807 808 809
    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;
810

811
        // Otherwise do nothing.
812
    case QPortSettings::BAUDR_UNKNOWN:
813
    default:
814
        break;
pixhawk's avatar
pixhawk committed
815 816 817 818
    }
    return dataRate;
}

819 820
qint64 SerialLink::getTotalUpstream()
{
pixhawk's avatar
pixhawk committed
821 822 823 824 825
    statisticsMutex.lock();
    return bitsSentTotal / ((MG::TIME::getGroundTimeNow() - connectionStartTime) / 1000);
    statisticsMutex.unlock();
}

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

831 832
qint64 SerialLink::getMaxUpstream()
{
pixhawk's avatar
pixhawk committed
833 834 835
    return 0; // TODO
}

836 837
qint64 SerialLink::getBitsSent()
{
pixhawk's avatar
pixhawk committed
838 839 840
    return bitsSentTotal;
}

841 842
qint64 SerialLink::getBitsReceived()
{
pixhawk's avatar
pixhawk committed
843 844 845
    return bitsReceivedTotal;
}

846 847
qint64 SerialLink::getTotalDownstream()
{
pixhawk's avatar
pixhawk committed
848 849 850 851 852
    statisticsMutex.lock();
    return bitsReceivedTotal / ((MG::TIME::getGroundTimeNow() - connectionStartTime) / 1000);
    statisticsMutex.unlock();
}

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

858 859
qint64 SerialLink::getMaxDownstream()
{
pixhawk's avatar
pixhawk committed
860 861 862
    return 0; // TODO
}

863 864
bool SerialLink::isFullDuplex()
{
pixhawk's avatar
pixhawk committed
865 866 867 868
    /* Serial connections are always half duplex */
    return false;
}

869 870
int SerialLink::getLinkQuality()
{
pixhawk's avatar
pixhawk committed
871 872 873 874
    /* This feature is not supported with this interface */
    return -1;
}

875 876
QString SerialLink::getPortName()
{
pixhawk's avatar
pixhawk committed
877 878 879
    return porthandle;
}

880 881
int SerialLink::getBaudRate()
{
pixhawk's avatar
pixhawk committed
882 883 884
    return getNominalDataRate();
}

885 886
int SerialLink::getBaudRateType()
{
887
    return portSettings.baudRate();
pixhawk's avatar
pixhawk committed
888 889
}

890 891
int SerialLink::getFlowType()
{
892
    return portSettings.flowControl();
pixhawk's avatar
pixhawk committed
893 894
}

895 896
int SerialLink::getParityType()
{
897
    return portSettings.parity();
pixhawk's avatar
pixhawk committed
898 899
}

900 901
int SerialLink::getDataBitsType()
{
902
    return portSettings.dataBits();
pixhawk's avatar
pixhawk committed
903 904
}

905 906
int SerialLink::getStopBitsType()
{
907
    return portSettings.stopBits();
pixhawk's avatar
pixhawk committed
908 909
}

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

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

pixhawk's avatar
pixhawk committed
950 951
bool SerialLink::setPortName(QString portName)
{
952
    if(portName.trimmed().length() > 0) {
pixhawk's avatar
pixhawk committed
953
        bool reconnect = false;
954 955 956
        if (isConnected()) reconnect = true;
        disconnect();

pixhawk's avatar
pixhawk committed
957 958 959 960 961
        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
962
        if (!this->porthandle.startsWith("\\")) {
pixhawk's avatar
pixhawk committed
963 964 965 966
            // Append \\.\ before the port handle. Additional backslashes are used for escaping.
            this->porthandle = "\\\\.\\" + this->porthandle;
        }
#endif
967

pixhawk's avatar
pixhawk committed
968 969
        if(reconnect) connect();
        return true;
970
    } else {
pixhawk's avatar
pixhawk committed
971 972 973 974 975 976 977 978 979
        return false;
    }
}


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

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

995
    if (rateIndex >= minBaud && rateIndex <= maxBaud)
996 997
    {
        portSettings.setBaudRate((QPortSettings::BaudRate)rateIndex);
pixhawk's avatar
pixhawk committed
998 999 1000 1001 1002 1003
    }

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

1004 1005 1006 1007 1008 1009 1010
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
1011 1012 1013 1014 1015

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

1021
    // This switch-statment relies on the mapping given in qportsettings.h from the QSerialPort library.
1022
    switch (rate) {
1023

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

1046
        // Baud rates supported only by windows
1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059
#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;
1060
#endif
1061

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

1117 1118 1119
    if(reconnect) connect();
    return accepted;

pixhawk's avatar
pixhawk committed
1120 1121
}

1122 1123
bool SerialLink::setFlowType(int flow)
{
pixhawk's avatar
pixhawk committed
1124 1125
    bool reconnect = false;
    bool accepted = true;
1126 1127
    if(isConnected()) reconnect = true;
    disconnect();
pixhawk's avatar
pixhawk committed
1128

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

pixhawk's avatar
pixhawk committed
1145 1146 1147 1148
    if(reconnect) connect();
    return accepted;
}

1149 1150
bool SerialLink::setParityType(int parity)
{
pixhawk's avatar
pixhawk committed
1151 1152
    bool reconnect = false;
    bool accepted = true;
1153 1154
    if (isConnected()) reconnect = true;
    disconnect();
pixhawk's avatar
pixhawk committed
1155

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

1175
    if (reconnect) connect();
pixhawk's avatar
pixhawk committed
1176 1177 1178
    return accepted;
}

1179

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

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

1207
    if(reconnect) connect();
pixhawk's avatar
pixhawk committed
1208 1209 1210 1211

    return accepted;
}

1212
bool SerialLink::setStopBits(int stopBits)
1213
{
pixhawk's avatar
pixhawk committed
1214 1215
    bool reconnect = false;
    bool accepted = true;
1216 1217
    if(isConnected()) reconnect = true;
    disconnect();
pixhawk's avatar
pixhawk committed
1218

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

    if(reconnect) connect();
    return accepted;
}
1235 1236 1237 1238 1239 1240

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

1241 1242
    if (isConnected()) reconnect = true;
    disconnect();
1243

1244 1245
    if (dataBits >= (int)QPortSettings::DB_5 && dataBits <= (int)QPortSettings::DB_8) {
        portSettings.setDataBits((QPortSettings::DataBits) dataBits);
1246

1247
        if(reconnect) connect();
1248 1249 1250 1251 1252 1253 1254 1255 1256 1257
        accepted = true;
    }

    return accepted;
}

bool SerialLink::setStopBitsType(int stopBits)
{
    bool reconnect = false;
    bool accepted = false;
1258 1259
    if(isConnected()) reconnect = true;
    disconnect();
1260

1261 1262
    if (stopBits >= (int)QPortSettings::STOP_1 && stopBits <= (int)QPortSettings::STOP_2) {
        portSettings.setStopBits((QPortSettings::StopBits) stopBits);
1263

1264
        if(reconnect) connect();
1265 1266 1267 1268 1269 1270
        accepted = true;
    }

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