Serial.h

Go to the documentation of this file.

//
// Copyright (c) 2009, Markus Rickert
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
// * Redistributions of source code must retain the above copyright notice,
//   this list of conditions and the following disclaimer.
// * Redistributions in binary form must reproduce the above copyright notice,
//   this list of conditions and the following disclaimer in the documentation
//   and/or other materials provided with the distribution.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
//
 
#ifndef _RL_HAL_SERIAL_H_
#define _RL_HAL_SERIAL_H_
 
#include <string>
#include <rl/math/Real.h>
 
#ifdef WIN32
#include <windows.h>
#else // WIN32
#include <termios.h>
#endif // WIN32
 
#include "Com.h"
 
namespace rl
{
    namespace hal
    {
        class Serial : public Com
        {
        public:
            enum BaudRate
            {
                BAUDRATE_110BPS,
                BAUDRATE_300BPS,
                BAUDRATE_600BPS,
                BAUDRATE_1200BPS,
                BAUDRATE_2400BPS,
                BAUDRATE_4800BPS,
                BAUDRATE_9600BPS,
#ifdef WIN32
 
                BAUDRATE_14400BPS,
#endif // WIN32
 
                BAUDRATE_19200BPS,
                BAUDRATE_38400BPS,
                BAUDRATE_57600BPS,
#ifdef __QNX__
                BAUDRATE_115200BPS
#else // __QNX__
                BAUDRATE_115200BPS,
#endif // __QNX__
#ifdef WIN32
 
                BAUDRATE_128000BPS,
                BAUDRATE_256000BPS
#else // WIN32
#ifndef __QNX__
 
                BAUDRATE_230400BPS,
                BAUDRATE_460800BPS,
                BAUDRATE_500000BPS,
                BAUDRATE_576000BPS,
                BAUDRATE_921600BPS,
                BAUDRATE_1000000BPS,
                BAUDRATE_1152000BPS,
                BAUDRATE_1500000BPS,
                BAUDRATE_2000000BPS,
                BAUDRATE_2500000BPS,
                BAUDRATE_3000000BPS,
                BAUDRATE_3500000BPS,
                BAUDRATE_4000000BPS
#endif // __QNX__
#endif // WIN32
            };
            
            enum DataBits
            {
                DATABITS_5BITS,
                DATABITS_6BITS,
                DATABITS_7BITS,
                DATABITS_8BITS
            };
            
            enum FlowControl
            {
                FLOWCONTROL_OFF,
                FLOWCONTROL_RTSCTS,
                FLOWCONTROL_XONXOFF
            };
            
            enum Parity
            {
                PARITY_EVENPARITY,
                PARITY_NOPARITY,
                PARITY_ODDPARITY
            };
            
            enum StopBits
            {
                STOPBITS_1BIT,
                STOPBITS_2BITS
            };
            
            Serial(
                const ::std::string& filename,
                const BaudRate& baudRate = BAUDRATE_9600BPS,
                const DataBits& dataBits = DATABITS_8BITS,
                const FlowControl& flowControl = FLOWCONTROL_OFF,
                const Parity& parity = PARITY_NOPARITY,
                const StopBits& stopBits = STOPBITS_1BIT
            );
            
            virtual ~Serial();
            
            void changeParameters();
            
            void close();
            
            void doBreak(const bool& doOn);
            
            void doDtr(const bool& doOn);
            
            void doModemStatus(bool& ctsOn, bool& dsrOn, bool& riOn, bool& dcdOn);
            
            void doRts(const bool& doOn);
            
            void flush(const bool& read, const bool& write);
            
            BaudRate getBaudRate() const;
            
            DataBits getDataBits() const;
            
            ::std::string getFilename() const;
            
            FlowControl getFlowControl() const;
            
            Parity getParity() const;
            
            StopBits getStopBits() const;
            
            void open();
            
            ::std::size_t read(void* buf, const ::std::size_t& count);
            
            ::std::size_t select(const bool& read, const bool& write, const ::rl::math::Real& timeout);
            
            void setBaudRate(const BaudRate& baudRate);
            
            void setDataBits(const DataBits& dataBits);
            
            void setFilename(const ::std::string& filename);
            
            void setFlowControl(const FlowControl& flowControl);
            
            void setParity(const Parity& parity);
            
            void setStopBits(const StopBits& stopBits);
            
            ::std::size_t write(const void* buf, const ::std::size_t& count);
            
        protected:
            
        private:
            BaudRate baudRate;
            
#ifdef WIN32
            DCB current;
#else // WIN32
            struct termios current;
#endif // WIN32
            
            DataBits dataBits;
            
#ifdef WIN32
            HANDLE fd;
#else // WIN32
            int fd;
#endif // WIN32
            
            ::std::string filename;
            
            FlowControl flowControl;
            
            Parity parity;
            
#ifdef WIN32
            DCB restore;
#else // WIN32
            struct termios restore;
#endif // WIN32
            
            StopBits stopBits;
        };
    }
}
 
#endif // _RL_HAL_SERIAL_H_