From 46b93115a6a244a6587daca7a72728ac742e41ec Mon Sep 17 00:00:00 2001 From: hehe Date: Tue, 6 Jan 2026 18:12:21 +0800 Subject: [PATCH] add serial package --- serial/CMakeLists.txt | 65 + serial/Makefile | 62 + serial/README.md | 60 + serial/images/install_Serial_ubuntu.png | Bin 0 -> 144627 bytes serial/include/serial/impl/unix.h | 221 ++++ serial/include/serial/impl/win.h | 207 ++++ serial/include/serial/serial.h | 775 ++++++++++++ serial/include/serial/v8stdint.h | 57 + serial/package.xml | 30 + .../src/impl/list_ports/list_ports_linux.cc | 335 ++++++ serial/src/impl/list_ports/list_ports_osx.cc | 286 +++++ serial/src/impl/list_ports/list_ports_win.cc | 152 +++ serial/src/impl/unix.cc | 1066 +++++++++++++++++ serial/src/impl/win.cc | 646 ++++++++++ serial/src/serial.cc | 430 +++++++ waveshare/CMakeLists.txt | 6 +- waveshare/lib/libserial.so | Bin 188864 -> 0 bytes 17 files changed, 4395 insertions(+), 3 deletions(-) create mode 100755 serial/CMakeLists.txt create mode 100755 serial/Makefile create mode 100755 serial/README.md create mode 100755 serial/images/install_Serial_ubuntu.png create mode 100755 serial/include/serial/impl/unix.h create mode 100755 serial/include/serial/impl/win.h create mode 100755 serial/include/serial/serial.h create mode 100755 serial/include/serial/v8stdint.h create mode 100755 serial/package.xml create mode 100755 serial/src/impl/list_ports/list_ports_linux.cc create mode 100755 serial/src/impl/list_ports/list_ports_osx.cc create mode 100755 serial/src/impl/list_ports/list_ports_win.cc create mode 100755 serial/src/impl/unix.cc create mode 100755 serial/src/impl/win.cc create mode 100755 serial/src/serial.cc delete mode 100755 waveshare/lib/libserial.so diff --git a/serial/CMakeLists.txt b/serial/CMakeLists.txt new file mode 100755 index 0000000..aa10d4d --- /dev/null +++ b/serial/CMakeLists.txt @@ -0,0 +1,65 @@ +cmake_minimum_required(VERSION 3.5) +project(serial) + +find_package(ament_cmake REQUIRED) + +ament_export_include_directories(include) +ament_export_libraries(${PROJECT_NAME}) + +## Sources +## Add serial library +add_library(${PROJECT_NAME} SHARED + src/serial.cc + include/serial/serial.h + include/serial/v8stdint.h +) + +if(APPLE) # macOS + find_library(IOKIT_LIBRARY IOKit) + find_library(FOUNDATION_LIBRARY Foundation) + target_sources(${PROJECT_NAME} PRIVATE + src/impl/unix.cc + src/impl/list_ports/list_ports_osx.cc + ) + target_link_libraries(${PROJECT_NAME} ${FOUNDATION_LIBRARY} ${IOKIT_LIBRARY}) +elseif(UNIX) # .*nix + target_sources(${PROJECT_NAME} PRIVATE + src/impl/unix.cc + src/impl/list_ports/list_ports_linux.cc + ) + target_link_libraries(${PROJECT_NAME} rt pthread) +elseif(WIN32) # Windows + target_sources(${PROJECT_NAME} PRIVATE + src/impl/win.cc + src/impl/list_ports/list_ports_win.cc + ) + target_link_libraries(${PROJECT_NAME} setupapi) + ament_export_libraries(setupapi) +endif() + + +## Include headers +target_include_directories(${PROJECT_NAME} PRIVATE include) + +## Uncomment for example +# add_executable(serial_example examples/serial_example.cc) +# add_dependencies(serial_example ${PROJECT_NAME}) +# target_link_libraries(serial_example ${PROJECT_NAME}) + +## Install executable +install(TARGETS ${PROJECT_NAME} + ARCHIVE DESTINATION lib + LIBRARY DESTINATION lib +) + +## Install headers +install(FILES include/serial/serial.h include/serial/v8stdint.h + DESTINATION include/serial +) + +## Tests +#if(BUILD_TESTING) +# add_subdirectory(tests) +#endif() + +ament_package() diff --git a/serial/Makefile b/serial/Makefile new file mode 100755 index 0000000..e172072 --- /dev/null +++ b/serial/Makefile @@ -0,0 +1,62 @@ +all: serial + +CMAKE_FLAGS := -DCMAKE_INSTALL_PREFIX=/tmp/usr/local +UNAME := $(shell uname -s) + +install_deps: +ifeq ($(UNAME),Darwin) + brew tap ros/deps + brew update + brew outdated boost || brew upgrade boost || brew install boost + brew outdated python || brew upgrade python || brew install python + sudo -H python2 -m pip install -U pip setuptools + sudo -H python2 -m pip install --force-reinstall --no-deps -U pip + sudo -H python2 -m pip install rosinstall_generator wstool rosdep empy catkin_pkg + sudo -H rosdep init + rosdep update + mkdir catkin_ws + cd catkin_ws && rosinstall_generator catkin --rosdistro hydro --tar > catkin.rosinstall + cd catkin_ws && wstool init src catkin.rosinstall + cd catkin_ws && rosdep install --from-paths src --ignore-src -y + cd catkin_ws && python2 ./src/catkin/bin/catkin_make -DPYTHON_EXECUTABLE=`which python2` install + echo "source catkin_ws/install/setup.bash" > setup.bash +else + sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu precise main" > /etc/apt/sources.list.d/ros-latest.list' + wget http://packages.ros.org/ros.key -O - | sudo apt-key add - + sudo apt-get update + sudo apt-get install ros-hydro-catkin libboost-dev + echo "source /opt/ros/hydro/setup.bash" > setup.bash +endif + +install: + cd build && make install + +serial: + @mkdir -p build + cd build && cmake $(CMAKE_FLAGS) .. +ifneq ($(MAKE),) + cd build && $(MAKE) +else + cd build && make +endif + +.PHONY: clean +clean: + rm -rf build + +.PHONY: doc +doc: + @doxygen doc/Doxyfile +ifeq ($(UNAME),Darwin) + @open doc/html/index.html +endif + +.PHONY: test +test: + @mkdir -p build + cd build && cmake $(CMAKE_FLAGS) .. +ifneq ($(MAKE),) + cd build && $(MAKE) run_tests +else + cd build && make run_tests +endif diff --git a/serial/README.md b/serial/README.md new file mode 100755 index 0000000..8ed338b --- /dev/null +++ b/serial/README.md @@ -0,0 +1,60 @@ +Adapt to ROS2 foxy. + +https://github.com/ZhaoXiangBox/serial + + + +#### Install + +Get the code: + + # open a new terminal + cd serial + mkdir build + +Build: + + cd build + cmake .. + make + +Install: + + sudo make install + +**like this**: + + + + + +也可以不用 make install ,直接和你想要调用本API的ROS2 节点放在同一个 src 下编译即可。有关于本串口操作包的 API 在线文档如下： + + + +[serial: Serial Library](http://wjwwood.io/serial/doc/1.1.0/index.html) + + + +本 ROS Package 修改来自： + +### License + +The MIT License + +Copyright (c) 2012 William Woodall, John Harrison + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. + +### Authors + +William Woodall +John Harrison + +### Contact + +William Woodall diff --git a/serial/images/install_Serial_ubuntu.png b/serial/images/install_Serial_ubuntu.png new file mode 100755 index 0000000000000000000000000000000000000000..90c9e02f91a19b18ea37940c1e7e6bf1810b24f1 GIT binary patch literal 144627 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 z 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 + * \author John Harrison + * \version 0.1 + * + * \section LICENSE + * + * The MIT License + * + * Copyright (c) 2012 William Woodall, John Harrison + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + * DEALINGS IN THE SOFTWARE. + * + * \section DESCRIPTION + * + * This provides a unix based pimpl for the Serial class. This implementation is + * based off termios.h and uses select for multiplexing the IO ports. + * + */ + +#if !defined(_WIN32) + +#ifndef SERIAL_IMPL_UNIX_H +#define SERIAL_IMPL_UNIX_H + +#include "serial/serial.h" + +#include + +namespace serial { + +using std::size_t; +using std::string; +using std::invalid_argument; + +using serial::SerialException; +using serial::IOException; + +class MillisecondTimer { +public: + MillisecondTimer(const uint32_t millis); + int64_t remaining(); + +private: + static timespec timespec_now(); + timespec expiry; +}; + +class serial::Serial::SerialImpl { +public: + SerialImpl (const string &port, + unsigned long baudrate, + bytesize_t bytesize, + parity_t parity, + stopbits_t stopbits, + flowcontrol_t flowcontrol); + + virtual ~SerialImpl (); + + void + open (); + + void + close (); + + bool + isOpen () const; + + size_t + available (); + + bool + waitReadable (uint32_t timeout); + + void + waitByteTimes (size_t count); + + size_t + read (uint8_t *buf, size_t size = 1); + + size_t + write (const uint8_t *data, size_t length); + + void + flush (); + + void + flushInput (); + + void + flushOutput (); + + void + sendBreak (int duration); + + void + setBreak (bool level); + + void + setRTS (bool level); + + void + setDTR (bool level); + + bool + waitForChange (); + + bool + getCTS (); + + bool + getDSR (); + + bool + getRI (); + + bool + getCD (); + + void + setPort (const string &port); + + string + getPort () const; + + void + setTimeout (Timeout &timeout); + + Timeout + getTimeout () const; + + void + setBaudrate (unsigned long baudrate); + + unsigned long + getBaudrate () const; + + void + setBytesize (bytesize_t bytesize); + + bytesize_t + getBytesize () const; + + void + setParity (parity_t parity); + + parity_t + getParity () const; + + void + setStopbits (stopbits_t stopbits); + + stopbits_t + getStopbits () const; + + void + setFlowcontrol (flowcontrol_t flowcontrol); + + flowcontrol_t + getFlowcontrol () const; + + void + readLock (); + + void + readUnlock (); + + void + writeLock (); + + void + writeUnlock (); + +protected: + void reconfigurePort (); + +private: + string port_; // Path to the file descriptor + int fd_; // The current file descriptor + + bool is_open_; + bool xonxoff_; + bool rtscts_; + + Timeout timeout_; // Timeout for read operations + unsigned long baudrate_; // Baudrate + uint32_t byte_time_ns_; // Nanoseconds to transmit/receive a single byte + + parity_t parity_; // Parity + bytesize_t bytesize_; // Size of the bytes + stopbits_t stopbits_; // Stop Bits + flowcontrol_t flowcontrol_; // Flow Control + + // Mutex used to lock the read functions + pthread_mutex_t read_mutex; + // Mutex used to lock the write functions + pthread_mutex_t write_mutex; +}; + +} + +#endif // SERIAL_IMPL_UNIX_H + +#endif // !defined(_WIN32) diff --git a/serial/include/serial/impl/win.h b/serial/include/serial/impl/win.h new file mode 100755 index 0000000..2c0c6cd --- /dev/null +++ b/serial/include/serial/impl/win.h @@ -0,0 +1,207 @@ +/*! + * \file serial/impl/windows.h + * \author William Woodall + * \author John Harrison + * \version 0.1 + * + * \section LICENSE + * + * The MIT License + * + * Copyright (c) 2012 William Woodall, John Harrison + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + * DEALINGS IN THE SOFTWARE. + * + * \section DESCRIPTION + * + * This provides a windows implementation of the Serial class interface. + * + */ + +#if defined(_WIN32) + +#ifndef SERIAL_IMPL_WINDOWS_H +#define SERIAL_IMPL_WINDOWS_H + +#include "serial/serial.h" + +#include "windows.h" + +namespace serial { + +using std::string; +using std::wstring; +using std::invalid_argument; + +using serial::SerialException; +using serial::IOException; + +class serial::Serial::SerialImpl { +public: + SerialImpl (const string &port, + unsigned long baudrate, + bytesize_t bytesize, + parity_t parity, + stopbits_t stopbits, + flowcontrol_t flowcontrol); + + virtual ~SerialImpl (); + + void + open (); + + void + close (); + + bool + isOpen () const; + + size_t + available (); + + bool + waitReadable (uint32_t timeout); + + void + waitByteTimes (size_t count); + + size_t + read (uint8_t *buf, size_t size = 1); + + size_t + write (const uint8_t *data, size_t length); + + void + flush (); + + void + flushInput (); + + void + flushOutput (); + + void + sendBreak (int duration); + + void + setBreak (bool level); + + void + setRTS (bool level); + + void + setDTR (bool level); + + bool + waitForChange (); + + bool + getCTS (); + + bool + getDSR (); + + bool + getRI (); + + bool + getCD (); + + void + setPort (const string &port); + + string + getPort () const; + + void + setTimeout (Timeout &timeout); + + Timeout + getTimeout () const; + + void + setBaudrate (unsigned long baudrate); + + unsigned long + getBaudrate () const; + + void + setBytesize (bytesize_t bytesize); + + bytesize_t + getBytesize () const; + + void + setParity (parity_t parity); + + parity_t + getParity () const; + + void + setStopbits (stopbits_t stopbits); + + stopbits_t + getStopbits () const; + + void + setFlowcontrol (flowcontrol_t flowcontrol); + + flowcontrol_t + getFlowcontrol () const; + + void + readLock (); + + void + readUnlock (); + + void + writeLock (); + + void + writeUnlock (); + +protected: + void reconfigurePort (); + +private: + wstring port_; // Path to the file descriptor + HANDLE fd_; + + bool is_open_; + + Timeout timeout_; // Timeout for read operations + unsigned long baudrate_; // Baudrate + + parity_t parity_; // Parity + bytesize_t bytesize_; // Size of the bytes + stopbits_t stopbits_; // Stop Bits + flowcontrol_t flowcontrol_; // Flow Control + + // Mutex used to lock the read functions + HANDLE read_mutex; + // Mutex used to lock the write functions + HANDLE write_mutex; +}; + +} + +#endif // SERIAL_IMPL_WINDOWS_H + +#endif // if defined(_WIN32) diff --git a/serial/include/serial/serial.h b/serial/include/serial/serial.h new file mode 100755 index 0000000..a165785 --- /dev/null +++ b/serial/include/serial/serial.h @@ -0,0 +1,775 @@ +/*! + * \file serial/serial.h + * \author William Woodall + * \author John Harrison + * \version 0.1 + * + * \section LICENSE + * + * The MIT License + * + * Copyright (c) 2012 William Woodall + * + * Permission is hereby granted, free of charge, to any person obtaining a + * copy of this software and associated documentation files (the "Software"), + * to deal in the Software without restriction, including without limitation + * the rights to use, copy, modify, merge, publish, distribute, sublicense, + * and/or sell copies of the Software, and to permit persons to whom the + * Software is furnished to do so, subject to the following conditions: + * + * The above copyright notice and this permission notice shall be included in + * all copies or substantial portions of the Software. + * + * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE + * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + * DEALINGS IN THE SOFTWARE. + * + * \section DESCRIPTION + * + * This provides a cross platform interface for interacting with Serial Ports. + */ + +#ifndef SERIAL_H +#define SERIAL_H + +#include +#include +#include +#include +#include +#include +#include +#include + +#define THROW(exceptionClass, message) throw exceptionClass(__FILE__, \ +__LINE__, (message) ) + +namespace serial { + +/*! + * Enumeration defines the possible bytesizes for the serial port. + */ +typedef enum { + fivebits = 5, + sixbits = 6, + sevenbits = 7, + eightbits = 8 +} bytesize_t; + +/*! + * Enumeration defines the possible parity types for the serial port. + */ +typedef enum { + parity_none = 0, + parity_odd = 1, + parity_even = 2, + parity_mark = 3, + parity_space = 4 +} parity_t; + +/*! + * Enumeration defines the possible stopbit types for the serial port. + */ +typedef enum { + stopbits_one = 1, + stopbits_two = 2, + stopbits_one_point_five +} stopbits_t; + +/*! + * Enumeration defines the possible flowcontrol types for the serial port. + */ +typedef enum { + flowcontrol_none = 0, + flowcontrol_software, + flowcontrol_hardware +} flowcontrol_t; + +/*! + * Structure for setting the timeout of the serial port, times are + * in milliseconds. + * + * In order to disable the interbyte timeout, set it to Timeout::max(). + */ +struct Timeout { +#ifdef max +# undef max +#endif + static uint32_t max() {return std::numeric_limits::max();} + /*! + * Convenience function to generate Timeout structs using a + * single absolute timeout. + * + * \param timeout A long that defines the time in milliseconds until a + * timeout occurs after a call to read or write is made. + * + * \return Timeout struct that represents this simple timeout provided. + */ + static Timeout simpleTimeout(uint32_t timeout) { + return Timeout(max(), timeout, 0, timeout, 0); + } + + /*! Number of milliseconds between bytes received to timeout on. */ + uint32_t inter_byte_timeout; + /*! A constant number of milliseconds to wait after calling read. */ + uint32_t read_timeout_constant; + /*! A multiplier against the number of requested bytes to wait after + * calling read. + */ + uint32_t read_timeout_multiplier; + /*! A constant number of milliseconds to wait after calling write. */ + uint32_t write_timeout_constant; + /*! A multiplier against the number of requested bytes to wait after + * calling write. + */ + uint32_t write_timeout_multiplier; + + explicit Timeout (uint32_t inter_byte_timeout_=0, + uint32_t read_timeout_constant_=0, + uint32_t read_timeout_multiplier_=0, + uint32_t write_timeout_constant_=0, + uint32_t write_timeout_multiplier_=0) + : inter_byte_timeout(inter_byte_timeout_), + read_timeout_constant(read_timeout_constant_), + read_timeout_multiplier(read_timeout_multiplier_), + write_timeout_constant(write_timeout_constant_), + write_timeout_multiplier(write_timeout_multiplier_) + {} +}; + +/*! + * Class that provides a portable serial port interface. + */ +class Serial { +public: + /*! + * Creates a Serial object and opens the port if a port is specified, + * otherwise it remains closed until serial::Serial::open is called. + * + * \param port A std::string containing the address of the serial port, + * which would be something like 'COM1' on Windows and '/dev/ttyS0' + * on Linux. + * + * \param baudrate An unsigned 32-bit integer that represents the baudrate + * + * \param timeout A serial::Timeout struct that defines the timeout + * conditions for the serial port. \see serial::Timeout + * + * \param bytesize Size of each byte in the serial transmission of data, + * default is eightbits, possible values are: fivebits, sixbits, sevenbits, + * eightbits + * + * \param parity Method of parity, default is parity_none, possible values + * are: parity_none, parity_odd, parity_even + * + * \param stopbits Number of stop bits used, default is stopbits_one, + * possible values are: stopbits_one, stopbits_one_point_five, stopbits_two + * + * \param flowcontrol Type of flowcontrol used, default is + * flowcontrol_none, possible values are: flowcontrol_none, + * flowcontrol_software, flowcontrol_hardware + * + * \throw serial::PortNotOpenedException + * \throw serial::IOException + * \throw std::invalid_argument + */ + Serial (const std::string &port = "", + uint32_t baudrate = 9600, + Timeout timeout = Timeout(), + bytesize_t bytesize = eightbits, + parity_t parity = parity_none, + stopbits_t stopbits = stopbits_one, + flowcontrol_t flowcontrol = flowcontrol_none); + + /*! Destructor */ + virtual ~Serial (); + + /*! + * Opens the serial port as long as the port is set and the port isn't + * already open. + * + * If the port is provided to the constructor then an explicit call to open + * is not needed. + * + * \see Serial::Serial + * + * \throw std::invalid_argument + * \throw serial::SerialException + * \throw serial::IOException + */ + void + open (); + + /*! Gets the open status of the serial port. + * + * \return Returns true if the port is open, false otherwise. + */ + bool + isOpen () const; + + /*! Closes the serial port. */ + void + close (); + + /*! Return the number of characters in the buffer. */ + size_t + available (); + + /*! Block until there is serial data to read or read_timeout_constant + * number of milliseconds have elapsed. The return value is true when + * the function exits with the port in a readable state, false otherwise + * (due to timeout or select interruption). */ + bool + waitReadable (); + + /*! Block for a period of time corresponding to the transmission time of + * count characters at present serial settings. This may be used in con- + * junction with waitReadable to read larger blocks of data from the + * port. */ + void + waitByteTimes (size_t count); + + /*! Read a given amount of bytes from the serial port into a given buffer. + * + * The read function will return in one of three cases: + * * The number of requested bytes was read. + * * In this case the number of bytes requested will match the size_t + * returned by read. + * * A timeout occurred, in this case the number of bytes read will not + * match the amount requested, but no exception will be thrown. One of + * two possible timeouts occurred: + * * The inter byte timeout expired, this means that number of + * milliseconds elapsed between receiving bytes from the serial port + * exceeded the inter byte timeout. + * * The total timeout expired, which is calculated by multiplying the + * read timeout multiplier by the number of requested bytes and then + * added to the read timeout constant. If that total number of + * milliseconds elapses after the initial call to read a timeout will + * occur. + * * An exception occurred, in this case an actual exception will be thrown. + * + * \param buffer An uint8_t array of at least the requested size. + * \param size A size_t defining how many bytes to be read. + * + * \return A size_t representing the number of bytes read as a result of the + * call to read. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + size_t + read (uint8_t *buffer, size_t size); + + /*! Read a given amount of bytes from the serial port into a give buffer. + * + * \param buffer A reference to a std::vector of uint8_t. + * \param size A size_t defining how many bytes to be read. + * + * \return A size_t representing the number of bytes read as a result of the + * call to read. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + size_t + read (std::vector &buffer, size_t size = 1); + + /*! Read a given amount of bytes from the serial port into a give buffer. + * + * \param buffer A reference to a std::string. + * \param size A size_t defining how many bytes to be read. + * + * \return A size_t representing the number of bytes read as a result of the + * call to read. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + size_t + read (std::string &buffer, size_t size = 1); + + /*! Read a given amount of bytes from the serial port and return a string + * containing the data. + * + * \param size A size_t defining how many bytes to be read. + * + * \return A std::string containing the data read from the port. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + std::string + read (size_t size = 1); + + /*! Reads in a line or until a given delimiter has been processed. + * + * Reads from the serial port until a single line has been read. + * + * \param buffer A std::string reference used to store the data. + * \param size A maximum length of a line, defaults to 65536 (2^16) + * \param eol A string to match against for the EOL. + * + * \return A size_t representing the number of bytes read. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + size_t + readline (std::string &buffer, size_t size = 65536, std::string eol = "\n"); + + /*! Reads in a line or until a given delimiter has been processed. + * + * Reads from the serial port until a single line has been read. + * + * \param size A maximum length of a line, defaults to 65536 (2^16) + * \param eol A string to match against for the EOL. + * + * \return A std::string containing the line. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + std::string + readline (size_t size = 65536, std::string eol = "\n"); + + /*! Reads in multiple lines until the serial port times out. + * + * This requires a timeout > 0 before it can be run. It will read until a + * timeout occurs and return a list of strings. + * + * \param size A maximum length of combined lines, defaults to 65536 (2^16) + * + * \param eol A string to match against for the EOL. + * + * \return A vector containing the lines. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + */ + std::vector + readlines (size_t size = 65536, std::string eol = "\n"); + + /*! Write a string to the serial port. + * + * \param data A const reference containing the data to be written + * to the serial port. + * + * \param size A size_t that indicates how many bytes should be written from + * the given data buffer. + * + * \return A size_t representing the number of bytes actually written to + * the serial port. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + * \throw serial::IOException + */ + size_t + write (const uint8_t *data, size_t size); + + /*! Write a string to the serial port. + * + * \param data A const reference containing the data to be written + * to the serial port. + * + * \return A size_t representing the number of bytes actually written to + * the serial port. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + * \throw serial::IOException + */ + size_t + write (const std::vector &data); + + /*! Write a string to the serial port. + * + * \param data A const reference containing the data to be written + * to the serial port. + * + * \return A size_t representing the number of bytes actually written to + * the serial port. + * + * \throw serial::PortNotOpenedException + * \throw serial::SerialException + * \throw serial::IOException + */ + size_t + write (const std::string &data); + + /*! Sets the serial port identifier. + * + * \param port A const std::string reference containing the address of the + * serial port, which would be something like 'COM1' on Windows and + * '/dev/ttyS0' on Linux. + * + * \throw std::invalid_argument + */ + void + setPort (const std::string &port); + + /*! Gets the serial port identifier. + * + * \see Serial::setPort + * + * \throw std::invalid_argument + */ + std::string + getPort () const; + + /*! Sets the timeout for reads and writes using the Timeout struct. + * + * There are two timeout conditions described here: + * * The inter byte timeout: + * * The inter_byte_timeout component of serial::Timeout defines the + * maximum amount of time, in milliseconds, between receiving bytes on + * the serial port that can pass before a timeout occurs. Setting this + * to zero will prevent inter byte timeouts from occurring. + * * Total time timeout: + * * The constant and multiplier component of this timeout condition, + * for both read and write, are defined in serial::Timeout. This + * timeout occurs if the total time since the read or write call was + * made exceeds the specified time in milliseconds. + * * The limit is defined by multiplying the multiplier component by the + * number of requested bytes and adding that product to the constant + * component. In this way if you want a read call, for example, to + * timeout after exactly one second regardless of the number of bytes + * you asked for then set the read_timeout_constant component of + * serial::Timeout to 1000 and the read_timeout_multiplier to zero. + * This timeout condition can be used in conjunction with the inter + * byte timeout condition with out any problems, timeout will simply + * occur when one of the two timeout conditions is met. This allows + * users to have maximum control over the trade-off between + * responsiveness and efficiency. + * + * Read and write functions will return in one of three cases. When the + * reading or writing is complete, when a timeout occurs, or when an + * exception occurs. + * + * A timeout of 0 enables non-blocking mode. + * + * \param timeout A serial::Timeout struct containing the inter byte + * timeout, and the read and write timeout constants and multipliers. + * + * \see serial::Timeout + */ + void + setTimeout (Timeout &timeout); + + /*! Sets the timeout for reads and writes. */ + void + setTimeout (uint32_t inter_byte_timeout, uint32_t read_timeout_constant, + uint32_t read_timeout_multiplier, uint32_t write_timeout_constant, + uint32_t write_timeout_multiplier) + { + Timeout timeout(inter_byte_timeout, read_timeout_constant, + read_timeout_multiplier, write_timeout_constant, + write_timeout_multiplier); + return setTimeout(timeout); + } + + /*! Gets the timeout for reads in seconds. + * + * \return A Timeout struct containing the inter_byte_timeout, and read + * and write timeout constants and multipliers. + * + * \see Serial::setTimeout + */ + Timeout + getTimeout () const; + + /*! Sets the baudrate for the serial port. + * + * Possible baudrates depends on the system but some safe baudrates include: + * 110, 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 56000, + * 57600, 115200 + * Some other baudrates that are supported by some comports: + * 128000, 153600, 230400, 256000, 460800, 500000, 921600 + * + * \param baudrate An integer that sets the baud rate for the serial port. + * + * \throw std::invalid_argument + */ + void + setBaudrate (uint32_t baudrate); + + /*! Gets the baudrate for the serial port. + * + * \return An integer that sets the baud rate for the serial port. + * + * \see Serial::setBaudrate + * + * \throw std::invalid_argument + */ + uint32_t + getBaudrate () const; + + /*! Sets the bytesize for the serial port. + * + * \param bytesize Size of each byte in the serial transmission of data, + * default is eightbits, possible values are: fivebits, sixbits, sevenbits, + * eightbits + * + * \throw std::invalid_argument + */ + void + setBytesize (bytesize_t bytesize); + + /*! Gets the bytesize for the serial port. + * + * \see Serial::setBytesize + * + * \throw std::invalid_argument + */ + bytesize_t + getBytesize () const; + + /*! Sets the parity for the serial port. + * + * \param parity Method of parity, default is parity_none, possible values + * are: parity_none, parity_odd, parity_even + * + * \throw std::invalid_argument + */ + void + setParity (parity_t parity); + + /*! Gets the parity for the serial port. + * + * \see Serial::setParity + * + * \throw std::invalid_argument + */ + parity_t + getParity () const; + + /*! Sets the stopbits for the serial port. + * + * \param stopbits Number of stop bits used, default is stopbits_one, + * possible values are: stopbits_one, stopbits_one_point_five, stopbits_two + * + * \throw std::invalid_argument + */ + void + setStopbits (stopbits_t stopbits); + + /*! Gets the stopbits for the serial port. + * + * \see Serial::setStopbits + * + * \throw std::invalid_argument + */ + stopbits_t + getStopbits () const; + + /*! Sets the flow control for the serial port. + * + * \param flowcontrol Type of flowcontrol used, default is flowcontrol_none, + * possible values are: flowcontrol_none, flowcontrol_software, + * flowcontrol_hardware + * + * \throw std::invalid_argument + */ + void + setFlowcontrol (flowcontrol_t flowcontrol); + + /*! Gets the flow control for the serial port. + * + * \see Serial::setFlowcontrol + * + * \throw std::invalid_argument + */ + flowcontrol_t + getFlowcontrol () const; + + /*! Flush the input and output buffers */ + void + flush (); + + /*! Flush only the input buffer */ + void + flushInput (); + + /*! Flush only the output buffer */ + void + flushOutput (); + + /*! Sends the RS-232 break signal. See tcsendbreak(3). */ + void + sendBreak (int duration); + + /*! Set the break condition to a given level. Defaults to true. */ + void + setBreak (bool level = true); + + /*! Set the RTS handshaking line to the given level. Defaults to true. */ + void + setRTS (bool level = true); + + /*! Set the DTR handshaking line to the given level. Defaults to true. */ + void + setDTR (bool level = true); + + /*! + * Blocks until CTS, DSR, RI, CD changes or something interrupts it. + * + * Can throw an exception if an error occurs while waiting. + * You can check the status of CTS, DSR, RI, and CD once this returns. + * Uses TIOCMIWAIT via ioctl if available (mostly only on Linux) with a + * resolution of less than +-1ms and as good as +-0.2ms. Otherwise a + * polling method is used which can give +-2ms. + * + * \return Returns true if one of the lines changed, false if something else + * occurred. + * + * \throw SerialException + */ + bool + waitForChange (); + + /*! Returns the current status of the CTS line. */ + bool + getCTS (); + + /*! Returns the current status of the DSR line. */ + bool + getDSR (); + + /*! Returns the current status of the RI line. */ + bool + getRI (); + + /*! Returns the current status of the CD line. */ + bool + getCD (); + +private: + // Disable copy constructors + Serial(const Serial&); + Serial& operator=(const Serial&); + + // Pimpl idiom, d_pointer + class SerialImpl; + SerialImpl *pimpl_; + + // Scoped Lock Classes + class ScopedReadLock; + class ScopedWriteLock; + + // Read common function + size_t + read_ (uint8_t *buffer, size_t size); + // Write common function + size_t + write_ (const uint8_t *data, size_t length); + +}; + +class SerialException : public std::exception +{ + // Disable copy constructors + SerialException& operator=(const SerialException&); + std::string e_what_; +public: + SerialException (const char *description) { + std::stringstream ss; + ss << "SerialException " << description << " failed."; + e_what_ = ss.str(); + } + SerialException (const SerialException& other) : e_what_(other.e_what_) {} + virtual ~SerialException() throw() {} + virtual const char* what () const throw () { + return e_what_.c_str(); + } +}; + +class IOException : public std::exception +{ + // Disable copy constructors + IOException& operator=(const IOException&); + std::string file_; + int line_; + std::string e_what_; + int errno_; +public: + explicit IOException (std::string file, int line, int errnum) + : file_(file), line_(line), errno_(errnum) { + std::stringstream ss; +#if defined(_WIN32) && !defined(__MINGW32__) + char error_str [1024]; + strerror_s(error_str, 1024, errnum); +#else + char * error_str = strerror(errnum); +#endif + ss << "IO Exception (" << errno_ << "): " << error_str; + ss << ", file " << file_ << ", line " << line_ << "."; + e_what_ = ss.str(); + } + explicit IOException (std::string file, int line, const char * description) + : file_(file), line_(line), errno_(0) { + std::stringstream ss; + ss << "IO Exception: " << description; + ss << ", file " << file_ << ", line " << line_ << "."; + e_what_ = ss.str(); + } + virtual ~IOException() throw() {} + IOException (const IOException& other) : line_(other.line_), e_what_(other.e_what_), errno_(other.errno_) {} + + int getErrorNumber () const { return errno_; } + + virtual const char* what () const throw () { + return e_what_.c_str(); + } +}; + +class PortNotOpenedException : public std::exception +{ + // Disable copy constructors + const PortNotOpenedException& operator=(PortNotOpenedException); + std::string e_what_; +public: + PortNotOpenedException (const char * description) { + std::stringstream ss; + ss << "PortNotOpenedException " << description << " failed."; + e_what_ = ss.str(); + } + PortNotOpenedException (const PortNotOpenedException& other) : e_what_(other.e_what_) {} + virtual ~PortNotOpenedException() throw() {} + virtual const char* what () const throw () { + return e_what_.c_str(); + } +}; + +/*! + * Structure that describes a serial device. + */ +struct PortInfo { + + /*! Address of the serial port (this can be passed to the constructor of Serial). */ + std::string port; + + /*! Human readable description of serial device if available. */ + std::string description; + + /*! Hardware ID (e.g. VID:PID of USB serial devices) or "n/a" if not available. */ + std::string hardware_id; + +}; + +/* Lists the serial ports available on the system + * + * Returns a vector of available serial ports, each represented + * by a serial::PortInfo data structure: + * + * \return vector of serial::PortInfo. + */ +std::vector +list_ports(); + +} // namespace serial + +#endif diff --git a/serial/include/serial/v8stdint.h b/serial/include/serial/v8stdint.h new file mode 100755 index 0000000..f3be96b --- /dev/null +++ b/serial/include/serial/v8stdint.h @@ -0,0 +1,57 @@ +// This header is from the v8 google project: +// http://code.google.com/p/v8/source/browse/trunk/include/v8stdint.h + +// Copyright 2012 the V8 project authors. 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. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived +// from this software without specific prior written permission. +// +// 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 +// OWNER 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. + +// Load definitions of standard types. + +#ifndef V8STDINT_H_ +#define V8STDINT_H_ + +#include +#include + +#if defined(_WIN32) && !defined(__MINGW32__) + +typedef signed char int8_t; +typedef unsigned char uint8_t; +typedef short int16_t; // NOLINT +typedef unsigned short uint16_t; // NOLINT +typedef int int32_t; +typedef unsigned int uint32_t; +typedef __int64 int64_t; +typedef unsigned __int64 uint64_t; +// intptr_t and friends are defined in crtdefs.h through stdio.h. + +#else + +#include + +#endif + +#endif // V8STDINT_H_ diff --git a/serial/package.xml b/serial/package.xml new file mode 100755 index 0000000..f1ac9d3 --- /dev/null +++ b/serial/package.xml @@ -0,0 +1,30 @@ + + + serial + 1.2.1 + + Serial is a cross-platform, simple to use library for using serial ports on computers. + This library provides a C++, object oriented interface for interacting with RS-232 + like devices on Linux and Windows. + + + William Woodall + + MIT + + http://wjwwood.github.com/serial/ + https://github.com/wjwwood/serial + https://github.com/wjwwood/serial/issues + + William Woodall + John Harrison + + ament_cmake + + boost + + + ament_cmake + + + diff --git a/serial/src/impl/list_ports/list_ports_linux.cc b/serial/src/impl/list_ports/list_ports_linux.cc new file mode 100755 index 0000000..9779d5e --- /dev/null +++ b/serial/src/impl/list_ports/list_ports_linux.cc @@ -0,0 +1,335 @@ +#if defined(__linux__) + +/* + * Copyright (c) 2014 Craig Lilley + * This software is made available under the terms of the MIT licence. + * A copy of the licence can be obtained from: + * http://opensource.org/licenses/MIT + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include + +#include "serial/serial.h" + +using serial::PortInfo; +using std::istringstream; +using std::ifstream; +using std::getline; +using std::vector; +using std::string; +using std::cout; +using std::endl; + +static vector glob(const vector& patterns); +static string basename(const string& path); +static string dirname(const string& path); +static bool path_exists(const string& path); +static string realpath(const string& path); +static string usb_sysfs_friendly_name(const string& sys_usb_path); +static vector get_sysfs_info(const string& device_path); +static string read_line(const string& file); +static string usb_sysfs_hw_string(const string& sysfs_path); +static string format(const char* format, ...); + +vector +glob(const vector& patterns) +{ + vector paths_found; + + if(patterns.size() == 0) + return paths_found; + + glob_t glob_results; + + int glob_retval = glob(patterns[0].c_str(), 0, NULL, &glob_results); + + vector::const_iterator iter = patterns.begin(); + + while(++iter != patterns.end()) + { + glob_retval = glob(iter->c_str(), GLOB_APPEND, NULL, &glob_results); + } + + for(int path_index = 0; path_index < glob_results.gl_pathc; path_index++) + { + paths_found.push_back(glob_results.gl_pathv[path_index]); + } + + globfree(&glob_results); + + return paths_found; +} + +string +basename(const string& path) +{ + size_t pos = path.rfind("/"); + + if(pos == std::string::npos) + return path; + + return string(path, pos+1, string::npos); +} + +string +dirname(const string& path) +{ + size_t pos = path.rfind("/"); + + if(pos == std::string::npos) + return path; + else if(pos == 0) + return "/"; + + return string(path, 0, pos); +} + +bool +path_exists(const string& path) +{ + struct stat sb; + + if( stat(path.c_str(), &sb ) == 0 ) + return true; + + return false; +} + +string +realpath(const string& path) +{ + char* real_path = realpath(path.c_str(), NULL); + + string result; + + if(real_path != NULL) + { + result = real_path; + + free(real_path); + } + + return result; +} + +string +usb_sysfs_friendly_name(const string& sys_usb_path) +{ + unsigned int device_number = 0; + + istringstream( read_line(sys_usb_path + "/devnum") ) >> device_number; + + string manufacturer = read_line( sys_usb_path + "/manufacturer" ); + + string product = read_line( sys_usb_path + "/product" ); + + string serial = read_line( sys_usb_path + "/serial" ); + + if( manufacturer.empty() && product.empty() && serial.empty() ) + return ""; + + return format("%s %s %s", manufacturer.c_str(), product.c_str(), serial.c_str() ); +} + +vector +get_sysfs_info(const string& device_path) +{ + string device_name = basename( device_path ); + + string friendly_name; + + string hardware_id; + + string sys_device_path = format( "/sys/class/tty/%s/device", device_name.c_str() ); + + if( device_name.compare(0,6,"ttyUSB") == 0 ) + { + sys_device_path = dirname( dirname( realpath( sys_device_path ) ) ); + + if( path_exists( sys_device_path ) ) + { + friendly_name = usb_sysfs_friendly_name( sys_device_path ); + + hardware_id = usb_sysfs_hw_string( sys_device_path ); + } + } + else if( device_name.compare(0,6,"ttyACM") == 0 ) + { + sys_device_path = dirname( realpath( sys_device_path ) ); + + if( path_exists( sys_device_path ) ) + { + friendly_name = usb_sysfs_friendly_name( sys_device_path ); + + hardware_id = usb_sysfs_hw_string( sys_device_path ); + } + } + else + { + // Try to read ID string of PCI device + + string sys_id_path = sys_device_path + "/id"; + + if( path_exists( sys_id_path ) ) + hardware_id = read_line( sys_id_path ); + } + + if( friendly_name.empty() ) + friendly_name = device_name; + + if( hardware_id.empty() ) + hardware_id = "n/a"; + + vector result; + result.push_back(friendly_name); + result.push_back(hardware_id); + + return result; +} + +string +read_line(const string& file) +{ + ifstream ifs(file.c_str(), ifstream::in); + + string line; + + if(ifs) + { + getline(ifs, line); + } + + return line; +} + +string +format(const char* format, ...) +{ + va_list ap; + + size_t buffer_size_bytes = 256; + + string result; + + char* buffer = (char*)malloc(buffer_size_bytes); + + if( buffer == NULL ) + return result; + + bool done = false; + + unsigned int loop_count = 0; + + while(!done) + { + va_start(ap, format); + + int return_value = vsnprintf(buffer, buffer_size_bytes, format, ap); + + if( return_value < 0 ) + { + done = true; + } + else if( return_value >= buffer_size_bytes ) + { + // Realloc and try again. + + buffer_size_bytes = return_value + 1; + + char* new_buffer_ptr = (char*)realloc(buffer, buffer_size_bytes); + + if( new_buffer_ptr == NULL ) + { + done = true; + } + else + { + buffer = new_buffer_ptr; + } + } + else + { + result = buffer; + done = true; + } + + va_end(ap); + + if( ++loop_count > 5 ) + done = true; + } + + free(buffer); + + return result; +} + +string +usb_sysfs_hw_string(const string& sysfs_path) +{ + string serial_number = read_line( sysfs_path + "/serial" ); + + if( serial_number.length() > 0 ) + { + serial_number = format( "SNR=%s", serial_number.c_str() ); + } + + string vid = read_line( sysfs_path + "/idVendor" ); + + string pid = read_line( sysfs_path + "/idProduct" ); + + return format("USB VID:PID=%s:%s %s", vid.c_str(), pid.c_str(), serial_number.c_str() ); +} + +vector +serial::list_ports() +{ + vector results; + + vector search_globs; + search_globs.push_back("/dev/ttyACM*"); + search_globs.push_back("/dev/ttyS*"); + search_globs.push_back("/dev/ttyUSB*"); + search_globs.push_back("/dev/tty.*"); + search_globs.push_back("/dev/cu.*"); + + vector devices_found = glob( search_globs ); + + vector::iterator iter = devices_found.begin(); + + while( iter != devices_found.end() ) + { + string device = *iter++; + + vector sysfs_info = get_sysfs_info( device ); + + string friendly_name = sysfs_info[0]; + + string hardware_id = sysfs_info[1]; + + PortInfo device_entry; + device_entry.port = device; + device_entry.description = friendly_name; + device_entry.hardware_id = hardware_id; + + results.push_back( device_entry ); + + } + + return results; +} + +#endif // defined(__linux__) diff --git a/serial/src/impl/list_ports/list_ports_osx.cc b/serial/src/impl/list_ports/list_ports_osx.cc new file mode 100755 index 0000000..333c55c --- /dev/null +++ b/serial/src/impl/list_ports/list_ports_osx.cc @@ -0,0 +1,286 @@ +#if defined(__APPLE__) + +#include +#include + +#include +#include +#include +#include + +#include +#include +#include + +#include "serial/serial.h" + +using serial::PortInfo; +using std::string; +using std::vector; + +#define HARDWARE_ID_STRING_LENGTH 128 + +string cfstring_to_string( CFStringRef cfstring ); +string get_device_path( io_object_t& serial_port ); +string get_class_name( io_object_t& obj ); +io_registry_entry_t get_parent_iousb_device( io_object_t& serial_port ); +string get_string_property( io_object_t& device, const char* property ); +uint16_t get_int_property( io_object_t& device, const char* property ); +string rtrim(const string& str); + +string +cfstring_to_string( CFStringRef cfstring ) +{ + char cstring[MAXPATHLEN]; + string result; + + if( cfstring ) + { + Boolean success = CFStringGetCString( cfstring, + cstring, + sizeof(cstring), + kCFStringEncodingASCII ); + + if( success ) + result = cstring; + } + + return result; +} + +string +get_device_path( io_object_t& serial_port ) +{ + CFTypeRef callout_path; + string device_path; + + callout_path = IORegistryEntryCreateCFProperty( serial_port, + CFSTR(kIOCalloutDeviceKey), + kCFAllocatorDefault, + 0 ); + + if (callout_path) + { + if( CFGetTypeID(callout_path) == CFStringGetTypeID() ) + device_path = cfstring_to_string( static_cast(callout_path) ); + + CFRelease(callout_path); + } + + return device_path; +} + +string +get_class_name( io_object_t& obj ) +{ + string result; + io_name_t class_name; + kern_return_t kern_result; + + kern_result = IOObjectGetClass( obj, class_name ); + + if( kern_result == KERN_SUCCESS ) + result = class_name; + + return result; +} + +io_registry_entry_t +get_parent_iousb_device( io_object_t& serial_port ) +{ + io_object_t device = serial_port; + io_registry_entry_t parent = 0; + io_registry_entry_t result = 0; + kern_return_t kern_result = KERN_FAILURE; + string name = get_class_name(device); + + // Walk the IO Registry tree looking for this devices parent IOUSBDevice. + while( name != "IOUSBDevice" ) + { + kern_result = IORegistryEntryGetParentEntry( device, + kIOServicePlane, + &parent ); + + if(kern_result != KERN_SUCCESS) + { + result = 0; + break; + } + + device = parent; + + name = get_class_name(device); + } + + if(kern_result == KERN_SUCCESS) + result = device; + + return result; +} + +string +get_string_property( io_object_t& device, const char* property ) +{ + string property_name; + + if( device ) + { + CFStringRef property_as_cfstring = CFStringCreateWithCString ( + kCFAllocatorDefault, + property, + kCFStringEncodingASCII ); + + CFTypeRef name_as_cfstring = IORegistryEntryCreateCFProperty( + device, + property_as_cfstring, + kCFAllocatorDefault, + 0 ); + + if( name_as_cfstring ) + { + if( CFGetTypeID(name_as_cfstring) == CFStringGetTypeID() ) + property_name = cfstring_to_string( static_cast(name_as_cfstring) ); + + CFRelease(name_as_cfstring); + } + + if(property_as_cfstring) + CFRelease(property_as_cfstring); + } + + return property_name; +} + +uint16_t +get_int_property( io_object_t& device, const char* property ) +{ + uint16_t result = 0; + + if( device ) + { + CFStringRef property_as_cfstring = CFStringCreateWithCString ( + kCFAllocatorDefault, + property, + kCFStringEncodingASCII ); + + CFTypeRef number = IORegistryEntryCreateCFProperty( device, + property_as_cfstring, + kCFAllocatorDefault, + 0 ); + + if(property_as_cfstring) + CFRelease(property_as_cfstring); + + if( number ) + { + if( CFGetTypeID(number) == CFNumberGetTypeID() ) + { + bool success = CFNumberGetValue( static_cast(number), + kCFNumberSInt16Type, + &result ); + + if( !success ) + result = 0; + } + + CFRelease(number); + } + + } + + return result; +} + +string rtrim(const string& str) +{ + string result = str; + + string whitespace = " \t\f\v\n\r"; + + std::size_t found = result.find_last_not_of(whitespace); + + if (found != std::string::npos) + result.erase(found+1); + else + result.clear(); + + return result; +} + +vector +serial::list_ports(void) +{ + vector devices_found; + CFMutableDictionaryRef classes_to_match; + io_iterator_t serial_port_iterator; + io_object_t serial_port; + mach_port_t master_port; + kern_return_t kern_result; + + kern_result = IOMasterPort(MACH_PORT_NULL, &master_port); + + if(kern_result != KERN_SUCCESS) + return devices_found; + + classes_to_match = IOServiceMatching(kIOSerialBSDServiceValue); + + if (classes_to_match == NULL) + return devices_found; + + CFDictionarySetValue( classes_to_match, + CFSTR(kIOSerialBSDTypeKey), + CFSTR(kIOSerialBSDAllTypes) ); + + kern_result = IOServiceGetMatchingServices(master_port, classes_to_match, &serial_port_iterator); + + if (KERN_SUCCESS != kern_result) + return devices_found; + + while ( (serial_port = IOIteratorNext(serial_port_iterator)) ) + { + string device_path = get_device_path( serial_port ); + io_registry_entry_t parent = get_parent_iousb_device( serial_port ); + IOObjectRelease(serial_port); + + if( device_path.empty() ) + continue; + + PortInfo port_info; + port_info.port = device_path; + port_info.description = "n/a"; + port_info.hardware_id = "n/a"; + + string device_name = rtrim( get_string_property( parent, "USB Product Name" ) ); + string vendor_name = rtrim( get_string_property( parent, "USB Vendor Name") ); + string description = rtrim( vendor_name + " " + device_name ); + if( !description.empty() ) + port_info.description = description; + + string serial_number = rtrim(get_string_property( parent, "USB Serial Number" ) ); + uint16_t vendor_id = get_int_property( parent, "idVendor" ); + uint16_t product_id = get_int_property( parent, "idProduct" ); + + if( vendor_id && product_id ) + { + char cstring[HARDWARE_ID_STRING_LENGTH]; + + if(serial_number.empty()) + serial_number = "None"; + + int ret = snprintf( cstring, HARDWARE_ID_STRING_LENGTH, "USB VID:PID=%04x:%04x SNR=%s", + vendor_id, + product_id, + serial_number.c_str() ); + + if( (ret >= 0) && (ret < HARDWARE_ID_STRING_LENGTH) ) + port_info.hardware_id = cstring; + } + + devices_found.push_back(port_info); + } + + IOObjectRelease(serial_port_iterator); + return devices_found; +} + +#endif // defined(__APPLE__) diff --git a/serial/src/impl/list_ports/list_ports_win.cc b/serial/src/impl/list_ports/list_ports_win.cc new file mode 100755 index 0000000..7da40c4 --- /dev/null +++ b/serial/src/impl/list_ports/list_ports_win.cc @@ -0,0 +1,152 @@ +#if defined(_WIN32) + +/* + * Copyright (c) 2014 Craig Lilley + * This software is made available under the terms of the MIT licence. + * A copy of the licence can be obtained from: + * http://opensource.org/licenses/MIT + */ + +#include "serial/serial.h" +#include +#include +#include +#include +#include +#include + +using serial::PortInfo; +using std::vector; +using std::string; + +static const DWORD port_name_max_length = 256; +static const DWORD friendly_name_max_length = 256; +static const DWORD hardware_id_max_length = 256; + +// Convert a wide Unicode string to an UTF8 string +std::string utf8_encode(const std::wstring &wstr) +{ + int size_needed = WideCharToMultiByte(CP_UTF8, 0, &wstr[0], (int)wstr.size(), NULL, 0, NULL, NULL); + std::string strTo( size_needed, 0 ); + WideCharToMultiByte (CP_UTF8, 0, &wstr[0], (int)wstr.size(), &strTo[0], size_needed, NULL, NULL); + return strTo; +} + +vector +serial::list_ports() +{ + vector devices_found; + + HDEVINFO device_info_set = SetupDiGetClassDevs( + (const GUID *) &GUID_DEVCLASS_PORTS, + NULL, + NULL, + DIGCF_PRESENT); + + unsigned int device_info_set_index = 0; + SP_DEVINFO_DATA device_info_data; + + device_info_data.cbSize = sizeof(SP_DEVINFO_DATA); + + while(SetupDiEnumDeviceInfo(device_info_set, device_info_set_index, &device_info_data)) + { + device_info_set_index++; + + // Get port name + + HKEY hkey = SetupDiOpenDevRegKey( + device_info_set, + &device_info_data, + DICS_FLAG_GLOBAL, + 0, + DIREG_DEV, + KEY_READ); + + TCHAR port_name[port_name_max_length]; + DWORD port_name_length = port_name_max_length; + + LONG return_code = RegQueryValueEx( + hkey, + _T("PortName"), + NULL, + NULL, + (LPBYTE)port_name, + &port_name_length); + + RegCloseKey(hkey); + + if(return_code != EXIT_SUCCESS) + continue; + + if(port_name_length > 0 && port_name_length <= port_name_max_length) + port_name[port_name_length-1] = '\0'; + else + port_name[0] = '\0'; + + // Ignore parallel ports + + if(_tcsstr(port_name, _T("LPT")) != NULL) + continue; + + // Get port friendly name + + TCHAR friendly_name[friendly_name_max_length]; + DWORD friendly_name_actual_length = 0; + + BOOL got_friendly_name = SetupDiGetDeviceRegistryProperty( + device_info_set, + &device_info_data, + SPDRP_FRIENDLYNAME, + NULL, + (PBYTE)friendly_name, + friendly_name_max_length, + &friendly_name_actual_length); + + if(got_friendly_name == TRUE && friendly_name_actual_length > 0) + friendly_name[friendly_name_actual_length-1] = '\0'; + else + friendly_name[0] = '\0'; + + // Get hardware ID + + TCHAR hardware_id[hardware_id_max_length]; + DWORD hardware_id_actual_length = 0; + + BOOL got_hardware_id = SetupDiGetDeviceRegistryProperty( + device_info_set, + &device_info_data, + SPDRP_HARDWAREID, + NULL, + (PBYTE)hardware_id, + hardware_id_max_length, + &hardware_id_actual_length); + + if(got_hardware_id == TRUE && hardware_id_actual_length > 0) + hardware_id[hardware_id_actual_length-1] = '\0'; + else + hardware_id[0] = '\0'; + + #ifdef UNICODE + std::string portName = utf8_encode(port_name); + std::string friendlyName = utf8_encode(friendly_name); + std::string hardwareId = utf8_encode(hardware_id); + #else + std::string portName = port_name; + std::string friendlyName = friendly_name; + std::string hardwareId = hardware_id; + #endif + + PortInfo port_entry; + port_entry.port = portName; + port_entry.description = friendlyName; + port_entry.hardware_id = hardwareId; + + devices_found.push_back(port_entry); + } + + SetupDiDestroyDeviceInfoList(device_info_set); + + return devices_found; +} + +#endif // #if defined(_WIN32) diff --git a/serial/src/impl/unix.cc b/serial/src/impl/unix.cc new file mode 100755 index 0000000..4309aa6 --- /dev/null +++ b/serial/src/impl/unix.cc @@ -0,0 +1,1066 @@ +/* Copyright 2012 William Woodall and John Harrison + * + * Additional Contributors: Christopher Baker @bakercp + */ + +#if !defined(_WIN32) + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#if defined(__linux__) +# include +#endif + +#include +#include +#include +#ifdef __MACH__ +#include +#include +#include +#endif + +#include "serial/impl/unix.h" + +#ifndef TIOCINQ +#ifdef FIONREAD +#define TIOCINQ FIONREAD +#else +#define TIOCINQ 0x541B +#endif +#endif + +#if defined(MAC_OS_X_VERSION_10_3) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_3) +#include +#endif + +using std::string; +using std::stringstream; +using std::invalid_argument; +using serial::MillisecondTimer; +using serial::Serial; +using serial::SerialException; +using serial::PortNotOpenedException; +using serial::IOException; + + +MillisecondTimer::MillisecondTimer (const uint32_t millis) + : expiry(timespec_now()) +{ + int64_t tv_nsec = expiry.tv_nsec + (millis * 1e6); + if (tv_nsec >= 1e9) { + int64_t sec_diff = tv_nsec / static_cast (1e9); + expiry.tv_nsec = tv_nsec % static_cast(1e9); + expiry.tv_sec += sec_diff; + } else { + expiry.tv_nsec = tv_nsec; + } +} + +int64_t +MillisecondTimer::remaining () +{ + timespec now(timespec_now()); + int64_t millis = (expiry.tv_sec - now.tv_sec) * 1e3; + millis += (expiry.tv_nsec - now.tv_nsec) / 1e6; + return millis; +} + +timespec +MillisecondTimer::timespec_now () +{ + timespec time; +# ifdef __MACH__ // OS X does not have clock_gettime, use clock_get_time + clock_serv_t cclock; + mach_timespec_t mts; + host_get_clock_service(mach_host_self(), SYSTEM_CLOCK, &cclock); + clock_get_time(cclock, &mts); + mach_port_deallocate(mach_task_self(), cclock); + time.tv_sec = mts.tv_sec; + time.tv_nsec = mts.tv_nsec; +# else + clock_gettime(CLOCK_MONOTONIC, &time); +# endif + return time; +} + +timespec +timespec_from_ms (const uint32_t millis) +{ + timespec time; + time.tv_sec = millis / 1e3; + time.tv_nsec = (millis - (time.tv_sec * 1e3)) * 1e6; + return time; +} + +Serial::SerialImpl::SerialImpl (const string &port, unsigned long baudrate, + bytesize_t bytesize, + parity_t parity, stopbits_t stopbits, + flowcontrol_t flowcontrol) + : port_ (port), fd_ (-1), is_open_ (false), xonxoff_ (false), rtscts_ (false), + baudrate_ (baudrate), parity_ (parity), + bytesize_ (bytesize), stopbits_ (stopbits), flowcontrol_ (flowcontrol) +{ + pthread_mutex_init(&this->read_mutex, NULL); + pthread_mutex_init(&this->write_mutex, NULL); + if (port_.empty () == false) + open (); +} + +Serial::SerialImpl::~SerialImpl () +{ + close(); + pthread_mutex_destroy(&this->read_mutex); + pthread_mutex_destroy(&this->write_mutex); +} + +void +Serial::SerialImpl::open () +{ + if (port_.empty ()) { + throw invalid_argument ("Empty port is invalid."); + } + if (is_open_ == true) { + throw SerialException ("Serial port already open."); + } + + fd_ = ::open (port_.c_str(), O_RDWR | O_NOCTTY | O_NONBLOCK); + + if (fd_ == -1) { + switch (errno) { + case EINTR: + // Recurse because this is a recoverable error. + open (); + return; + case ENFILE: + case EMFILE: + THROW (IOException, "Too many file handles open."); + default: + THROW (IOException, errno); + } + } + + reconfigurePort(); + is_open_ = true; +} + +void +Serial::SerialImpl::reconfigurePort () +{ + if (fd_ == -1) { + // Can only operate on a valid file descriptor + THROW (IOException, "Invalid file descriptor, is the serial port open?"); + } + + struct termios options; // The options for the file descriptor + + if (tcgetattr(fd_, &options) == -1) { + THROW (IOException, "::tcgetattr"); + } + + // set up raw mode / no echo / binary + options.c_cflag |= (tcflag_t) (CLOCAL | CREAD); + options.c_lflag &= (tcflag_t) ~(ICANON | ECHO | ECHOE | ECHOK | ECHONL | + ISIG | IEXTEN); //|ECHOPRT + + options.c_oflag &= (tcflag_t) ~(OPOST); + options.c_iflag &= (tcflag_t) ~(INLCR | IGNCR | ICRNL | IGNBRK); +#ifdef IUCLC + options.c_iflag &= (tcflag_t) ~IUCLC; +#endif +#ifdef PARMRK + options.c_iflag &= (tcflag_t) ~PARMRK; +#endif + + // setup baud rate + bool custom_baud = false; + speed_t baud; + switch (baudrate_) { +#ifdef B0 + case 0: baud = B0; break; +#endif +#ifdef B50 + case 50: baud = B50; break; +#endif +#ifdef B75 + case 75: baud = B75; break; +#endif +#ifdef B110 + case 110: baud = B110; break; +#endif +#ifdef B134 + case 134: baud = B134; break; +#endif +#ifdef B150 + case 150: baud = B150; break; +#endif +#ifdef B200 + case 200: baud = B200; break; +#endif +#ifdef B300 + case 300: baud = B300; break; +#endif +#ifdef B600 + case 600: baud = B600; break; +#endif +#ifdef B1200 + case 1200: baud = B1200; break; +#endif +#ifdef B1800 + case 1800: baud = B1800; break; +#endif +#ifdef B2400 + case 2400: baud = B2400; break; +#endif +#ifdef B4800 + case 4800: baud = B4800; break; +#endif +#ifdef B7200 + case 7200: baud = B7200; break; +#endif +#ifdef B9600 + case 9600: baud = B9600; break; +#endif +#ifdef B14400 + case 14400: baud = B14400; break; +#endif +#ifdef B19200 + case 19200: baud = B19200; break; +#endif +#ifdef B28800 + case 28800: baud = B28800; break; +#endif +#ifdef B57600 + case 57600: baud = B57600; break; +#endif +#ifdef B76800 + case 76800: baud = B76800; break; +#endif +#ifdef B38400 + case 38400: baud = B38400; break; +#endif +#ifdef B115200 + case 115200: baud = B115200; break; +#endif +#ifdef B128000 + case 128000: baud = B128000; break; +#endif +#ifdef B153600 + case 153600: baud = B153600; break; +#endif +#ifdef B230400 + case 230400: baud = B230400; break; +#endif +#ifdef B256000 + case 256000: baud = B256000; break; +#endif +#ifdef B460800 + case 460800: baud = B460800; break; +#endif +#ifdef B500000 + case 500000: baud = B500000; break; +#endif +#ifdef B576000 + case 576000: baud = B576000; break; +#endif +#ifdef B921600 + case 921600: baud = B921600; break; +#endif +#ifdef B1000000 + case 1000000: baud = B1000000; break; +#endif +#ifdef B1152000 + case 1152000: baud = B1152000; break; +#endif +#ifdef B1500000 + case 1500000: baud = B1500000; break; +#endif +#ifdef B2000000 + case 2000000: baud = B2000000; break; +#endif +#ifdef B2500000 + case 2500000: baud = B2500000; break; +#endif +#ifdef B3000000 + case 3000000: baud = B3000000; break; +#endif +#ifdef B3500000 + case 3500000: baud = B3500000; break; +#endif +#ifdef B4000000 + case 4000000: baud = B4000000; break; +#endif + default: + custom_baud = true; + // OS X support +#if defined(MAC_OS_X_VERSION_10_4) && (MAC_OS_X_VERSION_MIN_REQUIRED >= MAC_OS_X_VERSION_10_4) + // Starting with Tiger, the IOSSIOSPEED ioctl can be used to set arbitrary baud rates + // other than those specified by POSIX. The driver for the underlying serial hardware + // ultimately determines which baud rates can be used. This ioctl sets both the input + // and output speed. + speed_t new_baud = static_cast (baudrate_); + if (-1 == ioctl (fd_, IOSSIOSPEED, &new_baud, 1)) { + THROW (IOException, errno); + } + // Linux Support +#elif defined(__linux__) && defined (TIOCSSERIAL) + struct serial_struct ser; + + if (-1 == ioctl (fd_, TIOCGSERIAL, &ser)) { + THROW (IOException, errno); + } + + // set custom divisor + ser.custom_divisor = ser.baud_base / static_cast (baudrate_); + // update flags + ser.flags &= ~ASYNC_SPD_MASK; + ser.flags |= ASYNC_SPD_CUST; + + if (-1 == ioctl (fd_, TIOCSSERIAL, &ser)) { + THROW (IOException, errno); + } +#else + throw invalid_argument ("OS does not currently support custom bauds"); +#endif + } + if (custom_baud == false) { +#ifdef _BSD_SOURCE + ::cfsetspeed(&options, baud); +#else + ::cfsetispeed(&options, baud); + ::cfsetospeed(&options, baud); +#endif + } + + // setup char len + options.c_cflag &= (tcflag_t) ~CSIZE; + if (bytesize_ == eightbits) + options.c_cflag |= CS8; + else if (bytesize_ == sevenbits) + options.c_cflag |= CS7; + else if (bytesize_ == sixbits) + options.c_cflag |= CS6; + else if (bytesize_ == fivebits) + options.c_cflag |= CS5; + else + throw invalid_argument ("invalid char len"); + // setup stopbits + if (stopbits_ == stopbits_one) + options.c_cflag &= (tcflag_t) ~(CSTOPB); + else if (stopbits_ == stopbits_one_point_five) + // ONE POINT FIVE same as TWO.. there is no POSIX support for 1.5 + options.c_cflag |= (CSTOPB); + else if (stopbits_ == stopbits_two) + options.c_cflag |= (CSTOPB); + else + throw invalid_argument ("invalid stop bit"); + // setup parity + options.c_iflag &= (tcflag_t) ~(INPCK | ISTRIP); + if (parity_ == parity_none) { + options.c_cflag &= (tcflag_t) ~(PARENB | PARODD); + } else if (parity_ == parity_even) { + options.c_cflag &= (tcflag_t) ~(PARODD); + options.c_cflag |= (PARENB); + } else if (parity_ == parity_odd) { + options.c_cflag |= (PARENB | PARODD); + } +#ifdef CMSPAR + else if (parity_ == parity_mark) { + options.c_cflag |= (PARENB | CMSPAR | PARODD); + } + else if (parity_ == parity_space) { + options.c_cflag |= (PARENB | CMSPAR); + options.c_cflag &= (tcflag_t) ~(PARODD); + } +#else + // CMSPAR is not defined on OSX. So do not support mark or space parity. + else if (parity_ == parity_mark || parity_ == parity_space) { + throw invalid_argument ("OS does not support mark or space parity"); + } +#endif // ifdef CMSPAR + else { + throw invalid_argument ("invalid parity"); + } + // setup flow control + if (flowcontrol_ == flowcontrol_none) { + xonxoff_ = false; + rtscts_ = false; + } + if (flowcontrol_ == flowcontrol_software) { + xonxoff_ = true; + rtscts_ = false; + } + if (flowcontrol_ == flowcontrol_hardware) { + xonxoff_ = false; + rtscts_ = true; + } + // xonxoff +#ifdef IXANY + if (xonxoff_) + options.c_iflag |= (IXON | IXOFF); //|IXANY) + else + options.c_iflag &= (tcflag_t) ~(IXON | IXOFF | IXANY); +#else + if (xonxoff_) + options.c_iflag |= (IXON | IXOFF); + else + options.c_iflag &= (tcflag_t) ~(IXON | IXOFF); +#endif + // rtscts +#ifdef CRTSCTS + if (rtscts_) + options.c_cflag |= (CRTSCTS); + else + options.c_cflag &= (unsigned long) ~(CRTSCTS); +#elif defined CNEW_RTSCTS + if (rtscts_) + options.c_cflag |= (CNEW_RTSCTS); + else + options.c_cflag &= (unsigned long) ~(CNEW_RTSCTS); +#else +#error "OS Support seems wrong." +#endif + + // http://www.unixwiz.net/techtips/termios-vmin-vtime.html + // this basically sets the read call up to be a polling read, + // but we are using select to ensure there is data available + // to read before each call, so we should never needlessly poll + options.c_cc[VMIN] = 0; + options.c_cc[VTIME] = 0; + + // activate settings + ::tcsetattr (fd_, TCSANOW, &options); + + // Update byte_time_ based on the new settings. + uint32_t bit_time_ns = 1e9 / baudrate_; + byte_time_ns_ = bit_time_ns * (1 + bytesize_ + parity_ + stopbits_); + + // Compensate for the stopbits_one_point_five enum being equal to int 3, + // and not 1.5. + if (stopbits_ == stopbits_one_point_five) { + byte_time_ns_ += ((1.5 - stopbits_one_point_five) * bit_time_ns); + } +} + +void +Serial::SerialImpl::close () +{ + if (is_open_ == true) { + if (fd_ != -1) { + int ret; + ret = ::close (fd_); + if (ret == 0) { + fd_ = -1; + } else { + THROW (IOException, errno); + } + } + is_open_ = false; + } +} + +bool +Serial::SerialImpl::isOpen () const +{ + return is_open_; +} + +size_t +Serial::SerialImpl::available () +{ + if (!is_open_) { + return 0; + } + int count = 0; + if (-1 == ioctl (fd_, TIOCINQ, &count)) { + THROW (IOException, errno); + } else { + return static_cast (count); + } +} + +bool +Serial::SerialImpl::waitReadable (uint32_t timeout) +{ + // Setup a select call to block for serial data or a timeout + fd_set readfds; + FD_ZERO (&readfds); + FD_SET (fd_, &readfds); + timespec timeout_ts (timespec_from_ms (timeout)); + int r = pselect (fd_ + 1, &readfds, NULL, NULL, &timeout_ts, NULL); + + if (r < 0) { + // Select was interrupted + if (errno == EINTR) { + return false; + } + // Otherwise there was some error + THROW (IOException, errno); + } + // Timeout occurred + if (r == 0) { + return false; + } + // This shouldn't happen, if r > 0 our fd has to be in the list! + if (!FD_ISSET (fd_, &readfds)) { + THROW (IOException, "select reports ready to read, but our fd isn't" + " in the list, this shouldn't happen!"); + } + // Data available to read. + return true; +} + +void +Serial::SerialImpl::waitByteTimes (size_t count) +{ + timespec wait_time = { 0, static_cast(byte_time_ns_ * count)}; + pselect (0, NULL, NULL, NULL, &wait_time, NULL); +} + +size_t +Serial::SerialImpl::read (uint8_t *buf, size_t size) +{ + // If the port is not open, throw + if (!is_open_) { + throw PortNotOpenedException ("Serial::read"); + } + size_t bytes_read = 0; + + // Calculate total timeout in milliseconds t_c + (t_m * N) + long total_timeout_ms = timeout_.read_timeout_constant; + total_timeout_ms += timeout_.read_timeout_multiplier * static_cast (size); + MillisecondTimer total_timeout(total_timeout_ms); + + // Pre-fill buffer with available bytes + { + ssize_t bytes_read_now = ::read (fd_, buf, size); + if (bytes_read_now > 0) { + bytes_read = bytes_read_now; + } + } + + while (bytes_read < size) { + int64_t timeout_remaining_ms = total_timeout.remaining(); + if (timeout_remaining_ms <= 0) { + // Timed out + break; + } + // Timeout for the next select is whichever is less of the remaining + // total read timeout and the inter-byte timeout. + uint32_t timeout = std::min(static_cast (timeout_remaining_ms), + timeout_.inter_byte_timeout); + // Wait for the device to be readable, and then attempt to read. + if (waitReadable(timeout)) { + // If it's a fixed-length multi-byte read, insert a wait here so that + // we can attempt to grab the whole thing in a single IO call. Skip + // this wait if a non-max inter_byte_timeout is specified. + if (size > 1 && timeout_.inter_byte_timeout == Timeout::max()) { + size_t bytes_available = available(); + if (bytes_available + bytes_read < size) { + waitByteTimes(size - (bytes_available + bytes_read)); + } + } + // This should be non-blocking returning only what is available now + // Then returning so that select can block again. + ssize_t bytes_read_now = + ::read (fd_, buf + bytes_read, size - bytes_read); + // read should always return some data as select reported it was + // ready to read when we get to this point. + if (bytes_read_now < 1) { + // Disconnected devices, at least on Linux, show the + // behavior that they are always ready to read immediately + // but reading returns nothing. + throw SerialException ("device reports readiness to read but " + "returned no data (device disconnected?)"); + } + // Update bytes_read + bytes_read += static_cast (bytes_read_now); + // If bytes_read == size then we have read everything we need + if (bytes_read == size) { + break; + } + // If bytes_read < size then we have more to read + if (bytes_read < size) { + continue; + } + // If bytes_read > size then we have over read, which shouldn't happen + if (bytes_read > size) { + throw SerialException ("read over read, too many bytes where " + "read, this shouldn't happen, might be " + "a logical error!"); + } + } + } + return bytes_read; +} + +size_t +Serial::SerialImpl::write (const uint8_t *data, size_t length) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::write"); + } + fd_set writefds; + size_t bytes_written = 0; + + // Calculate total timeout in milliseconds t_c + (t_m * N) + long total_timeout_ms = timeout_.write_timeout_constant; + total_timeout_ms += timeout_.write_timeout_multiplier * static_cast (length); + MillisecondTimer total_timeout(total_timeout_ms); + + bool first_iteration = true; + while (bytes_written < length) { + int64_t timeout_remaining_ms = total_timeout.remaining(); + // Only consider the timeout if it's not the first iteration of the loop + // otherwise a timeout of 0 won't be allowed through + if (!first_iteration && (timeout_remaining_ms <= 0)) { + // Timed out + break; + } + first_iteration = false; + + timespec timeout(timespec_from_ms(timeout_remaining_ms)); + + FD_ZERO (&writefds); + FD_SET (fd_, &writefds); + + // Do the select + int r = pselect (fd_ + 1, NULL, &writefds, NULL, &timeout, NULL); + + // Figure out what happened by looking at select's response 'r' + /** Error **/ + if (r < 0) { + // Select was interrupted, try again + if (errno == EINTR) { + continue; + } + // Otherwise there was some error + THROW (IOException, errno); + } + /** Timeout **/ + if (r == 0) { + break; + } + /** Port ready to write **/ + if (r > 0) { + // Make sure our file descriptor is in the ready to write list + if (FD_ISSET (fd_, &writefds)) { + // This will write some + ssize_t bytes_written_now = + ::write (fd_, data + bytes_written, length - bytes_written); + // write should always return some data as select reported it was + // ready to write when we get to this point. + if (bytes_written_now < 1) { + // Disconnected devices, at least on Linux, show the + // behavior that they are always ready to write immediately + // but writing returns nothing. + throw SerialException ("device reports readiness to write but " + "returned no data (device disconnected?)"); + } + // Update bytes_written + bytes_written += static_cast (bytes_written_now); + // If bytes_written == size then we have written everything we need to + if (bytes_written == length) { + break; + } + // If bytes_written < size then we have more to write + if (bytes_written < length) { + continue; + } + // If bytes_written > size then we have over written, which shouldn't happen + if (bytes_written > length) { + throw SerialException ("write over wrote, too many bytes where " + "written, this shouldn't happen, might be " + "a logical error!"); + } + } + // This shouldn't happen, if r > 0 our fd has to be in the list! + THROW (IOException, "select reports ready to write, but our fd isn't" + " in the list, this shouldn't happen!"); + } + } + return bytes_written; +} + +void +Serial::SerialImpl::setPort (const string &port) +{ + port_ = port; +} + +string +Serial::SerialImpl::getPort () const +{ + return port_; +} + +void +Serial::SerialImpl::setTimeout (serial::Timeout &timeout) +{ + timeout_ = timeout; +} + +serial::Timeout +Serial::SerialImpl::getTimeout () const +{ + return timeout_; +} + +void +Serial::SerialImpl::setBaudrate (unsigned long baudrate) +{ + baudrate_ = baudrate; + if (is_open_) + reconfigurePort (); +} + +unsigned long +Serial::SerialImpl::getBaudrate () const +{ + return baudrate_; +} + +void +Serial::SerialImpl::setBytesize (serial::bytesize_t bytesize) +{ + bytesize_ = bytesize; + if (is_open_) + reconfigurePort (); +} + +serial::bytesize_t +Serial::SerialImpl::getBytesize () const +{ + return bytesize_; +} + +void +Serial::SerialImpl::setParity (serial::parity_t parity) +{ + parity_ = parity; + if (is_open_) + reconfigurePort (); +} + +serial::parity_t +Serial::SerialImpl::getParity () const +{ + return parity_; +} + +void +Serial::SerialImpl::setStopbits (serial::stopbits_t stopbits) +{ + stopbits_ = stopbits; + if (is_open_) + reconfigurePort (); +} + +serial::stopbits_t +Serial::SerialImpl::getStopbits () const +{ + return stopbits_; +} + +void +Serial::SerialImpl::setFlowcontrol (serial::flowcontrol_t flowcontrol) +{ + flowcontrol_ = flowcontrol; + if (is_open_) + reconfigurePort (); +} + +serial::flowcontrol_t +Serial::SerialImpl::getFlowcontrol () const +{ + return flowcontrol_; +} + +void +Serial::SerialImpl::flush () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::flush"); + } + tcdrain (fd_); +} + +void +Serial::SerialImpl::flushInput () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::flushInput"); + } + tcflush (fd_, TCIFLUSH); +} + +void +Serial::SerialImpl::flushOutput () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::flushOutput"); + } + tcflush (fd_, TCOFLUSH); +} + +void +Serial::SerialImpl::sendBreak (int duration) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::sendBreak"); + } + tcsendbreak (fd_, static_cast (duration / 4)); +} + +void +Serial::SerialImpl::setBreak (bool level) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::setBreak"); + } + + if (level) { + if (-1 == ioctl (fd_, TIOCSBRK)) + { + stringstream ss; + ss << "setBreak failed on a call to ioctl(TIOCSBRK): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + } else { + if (-1 == ioctl (fd_, TIOCCBRK)) + { + stringstream ss; + ss << "setBreak failed on a call to ioctl(TIOCCBRK): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + } +} + +void +Serial::SerialImpl::setRTS (bool level) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::setRTS"); + } + + int command = TIOCM_RTS; + + if (level) { + if (-1 == ioctl (fd_, TIOCMBIS, &command)) + { + stringstream ss; + ss << "setRTS failed on a call to ioctl(TIOCMBIS): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + } else { + if (-1 == ioctl (fd_, TIOCMBIC, &command)) + { + stringstream ss; + ss << "setRTS failed on a call to ioctl(TIOCMBIC): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + } +} + +void +Serial::SerialImpl::setDTR (bool level) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::setDTR"); + } + + int command = TIOCM_DTR; + + if (level) { + if (-1 == ioctl (fd_, TIOCMBIS, &command)) + { + stringstream ss; + ss << "setDTR failed on a call to ioctl(TIOCMBIS): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + } else { + if (-1 == ioctl (fd_, TIOCMBIC, &command)) + { + stringstream ss; + ss << "setDTR failed on a call to ioctl(TIOCMBIC): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + } +} + +bool +Serial::SerialImpl::waitForChange () +{ +#ifndef TIOCMIWAIT + +while (is_open_ == true) { + + int status; + + if (-1 == ioctl (fd_, TIOCMGET, &status)) + { + stringstream ss; + ss << "waitForChange failed on a call to ioctl(TIOCMGET): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + else + { + if (0 != (status & TIOCM_CTS) + || 0 != (status & TIOCM_DSR) + || 0 != (status & TIOCM_RI) + || 0 != (status & TIOCM_CD)) + { + return true; + } + } + + usleep(1000); + } + + return false; +#else + int command = (TIOCM_CD|TIOCM_DSR|TIOCM_RI|TIOCM_CTS); + + if (-1 == ioctl (fd_, TIOCMIWAIT, &command)) { + stringstream ss; + ss << "waitForDSR failed on a call to ioctl(TIOCMIWAIT): " + << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + return true; +#endif +} + +bool +Serial::SerialImpl::getCTS () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getCTS"); + } + + int status; + + if (-1 == ioctl (fd_, TIOCMGET, &status)) + { + stringstream ss; + ss << "getCTS failed on a call to ioctl(TIOCMGET): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + else + { + return 0 != (status & TIOCM_CTS); + } +} + +bool +Serial::SerialImpl::getDSR () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getDSR"); + } + + int status; + + if (-1 == ioctl (fd_, TIOCMGET, &status)) + { + stringstream ss; + ss << "getDSR failed on a call to ioctl(TIOCMGET): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + else + { + return 0 != (status & TIOCM_DSR); + } +} + +bool +Serial::SerialImpl::getRI () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getRI"); + } + + int status; + + if (-1 == ioctl (fd_, TIOCMGET, &status)) + { + stringstream ss; + ss << "getRI failed on a call to ioctl(TIOCMGET): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + else + { + return 0 != (status & TIOCM_RI); + } +} + +bool +Serial::SerialImpl::getCD () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getCD"); + } + + int status; + + if (-1 == ioctl (fd_, TIOCMGET, &status)) + { + stringstream ss; + ss << "getCD failed on a call to ioctl(TIOCMGET): " << errno << " " << strerror(errno); + throw(SerialException(ss.str().c_str())); + } + else + { + return 0 != (status & TIOCM_CD); + } +} + +void +Serial::SerialImpl::readLock () +{ + int result = pthread_mutex_lock(&this->read_mutex); + if (result) { + THROW (IOException, result); + } +} + +void +Serial::SerialImpl::readUnlock () +{ + int result = pthread_mutex_unlock(&this->read_mutex); + if (result) { + THROW (IOException, result); + } +} + +void +Serial::SerialImpl::writeLock () +{ + int result = pthread_mutex_lock(&this->write_mutex); + if (result) { + THROW (IOException, result); + } +} + +void +Serial::SerialImpl::writeUnlock () +{ + int result = pthread_mutex_unlock(&this->write_mutex); + if (result) { + THROW (IOException, result); + } +} + +#endif // !defined(_WIN32) diff --git a/serial/src/impl/win.cc b/serial/src/impl/win.cc new file mode 100755 index 0000000..786f4f6 --- /dev/null +++ b/serial/src/impl/win.cc @@ -0,0 +1,646 @@ +#if defined(_WIN32) + +/* Copyright 2012 William Woodall and John Harrison */ + +#include + +#include "serial/impl/win.h" + +using std::string; +using std::wstring; +using std::stringstream; +using std::invalid_argument; +using serial::Serial; +using serial::Timeout; +using serial::bytesize_t; +using serial::parity_t; +using serial::stopbits_t; +using serial::flowcontrol_t; +using serial::SerialException; +using serial::PortNotOpenedException; +using serial::IOException; + +inline wstring +_prefix_port_if_needed(const wstring &input) +{ + static wstring windows_com_port_prefix = L"\\\\.\\"; + if (input.compare(windows_com_port_prefix) != 0) + { + return windows_com_port_prefix + input; + } + return input; +} + +Serial::SerialImpl::SerialImpl (const string &port, unsigned long baudrate, + bytesize_t bytesize, + parity_t parity, stopbits_t stopbits, + flowcontrol_t flowcontrol) + : port_ (port.begin(), port.end()), fd_ (INVALID_HANDLE_VALUE), is_open_ (false), + baudrate_ (baudrate), parity_ (parity), + bytesize_ (bytesize), stopbits_ (stopbits), flowcontrol_ (flowcontrol) +{ + if (port_.empty () == false) + open (); + read_mutex = CreateMutex(NULL, false, NULL); + write_mutex = CreateMutex(NULL, false, NULL); +} + +Serial::SerialImpl::~SerialImpl () +{ + this->close(); + CloseHandle(read_mutex); + CloseHandle(write_mutex); +} + +void +Serial::SerialImpl::open () +{ + if (port_.empty ()) { + throw invalid_argument ("Empty port is invalid."); + } + if (is_open_ == true) { + throw SerialException ("Serial port already open."); + } + + // See: https://github.com/wjwwood/serial/issues/84 + wstring port_with_prefix = _prefix_port_if_needed(port_); + LPCWSTR lp_port = port_with_prefix.c_str(); + fd_ = CreateFileW(lp_port, + GENERIC_READ | GENERIC_WRITE, + 0, + 0, + OPEN_EXISTING, + FILE_ATTRIBUTE_NORMAL, + 0); + + if (fd_ == INVALID_HANDLE_VALUE) { + DWORD create_file_err = GetLastError(); + stringstream ss; + switch (create_file_err) { + case ERROR_FILE_NOT_FOUND: + // Use this->getPort to convert to a std::string + ss << "Specified port, " << this->getPort() << ", does not exist."; + THROW (IOException, ss.str().c_str()); + default: + ss << "Unknown error opening the serial port: " << create_file_err; + THROW (IOException, ss.str().c_str()); + } + } + + reconfigurePort(); + is_open_ = true; +} + +void +Serial::SerialImpl::reconfigurePort () +{ + if (fd_ == INVALID_HANDLE_VALUE) { + // Can only operate on a valid file descriptor + THROW (IOException, "Invalid file descriptor, is the serial port open?"); + } + + DCB dcbSerialParams = {0}; + + dcbSerialParams.DCBlength=sizeof(dcbSerialParams); + + if (!GetCommState(fd_, &dcbSerialParams)) { + //error getting state + THROW (IOException, "Error getting the serial port state."); + } + + // setup baud rate + switch (baudrate_) { +#ifdef CBR_0 + case 0: dcbSerialParams.BaudRate = CBR_0; break; +#endif +#ifdef CBR_50 + case 50: dcbSerialParams.BaudRate = CBR_50; break; +#endif +#ifdef CBR_75 + case 75: dcbSerialParams.BaudRate = CBR_75; break; +#endif +#ifdef CBR_110 + case 110: dcbSerialParams.BaudRate = CBR_110; break; +#endif +#ifdef CBR_134 + case 134: dcbSerialParams.BaudRate = CBR_134; break; +#endif +#ifdef CBR_150 + case 150: dcbSerialParams.BaudRate = CBR_150; break; +#endif +#ifdef CBR_200 + case 200: dcbSerialParams.BaudRate = CBR_200; break; +#endif +#ifdef CBR_300 + case 300: dcbSerialParams.BaudRate = CBR_300; break; +#endif +#ifdef CBR_600 + case 600: dcbSerialParams.BaudRate = CBR_600; break; +#endif +#ifdef CBR_1200 + case 1200: dcbSerialParams.BaudRate = CBR_1200; break; +#endif +#ifdef CBR_1800 + case 1800: dcbSerialParams.BaudRate = CBR_1800; break; +#endif +#ifdef CBR_2400 + case 2400: dcbSerialParams.BaudRate = CBR_2400; break; +#endif +#ifdef CBR_4800 + case 4800: dcbSerialParams.BaudRate = CBR_4800; break; +#endif +#ifdef CBR_7200 + case 7200: dcbSerialParams.BaudRate = CBR_7200; break; +#endif +#ifdef CBR_9600 + case 9600: dcbSerialParams.BaudRate = CBR_9600; break; +#endif +#ifdef CBR_14400 + case 14400: dcbSerialParams.BaudRate = CBR_14400; break; +#endif +#ifdef CBR_19200 + case 19200: dcbSerialParams.BaudRate = CBR_19200; break; +#endif +#ifdef CBR_28800 + case 28800: dcbSerialParams.BaudRate = CBR_28800; break; +#endif +#ifdef CBR_57600 + case 57600: dcbSerialParams.BaudRate = CBR_57600; break; +#endif +#ifdef CBR_76800 + case 76800: dcbSerialParams.BaudRate = CBR_76800; break; +#endif +#ifdef CBR_38400 + case 38400: dcbSerialParams.BaudRate = CBR_38400; break; +#endif +#ifdef CBR_115200 + case 115200: dcbSerialParams.BaudRate = CBR_115200; break; +#endif +#ifdef CBR_128000 + case 128000: dcbSerialParams.BaudRate = CBR_128000; break; +#endif +#ifdef CBR_153600 + case 153600: dcbSerialParams.BaudRate = CBR_153600; break; +#endif +#ifdef CBR_230400 + case 230400: dcbSerialParams.BaudRate = CBR_230400; break; +#endif +#ifdef CBR_256000 + case 256000: dcbSerialParams.BaudRate = CBR_256000; break; +#endif +#ifdef CBR_460800 + case 460800: dcbSerialParams.BaudRate = CBR_460800; break; +#endif +#ifdef CBR_921600 + case 921600: dcbSerialParams.BaudRate = CBR_921600; break; +#endif + default: + // Try to blindly assign it + dcbSerialParams.BaudRate = baudrate_; + } + + // setup char len + if (bytesize_ == eightbits) + dcbSerialParams.ByteSize = 8; + else if (bytesize_ == sevenbits) + dcbSerialParams.ByteSize = 7; + else if (bytesize_ == sixbits) + dcbSerialParams.ByteSize = 6; + else if (bytesize_ == fivebits) + dcbSerialParams.ByteSize = 5; + else + throw invalid_argument ("invalid char len"); + + // setup stopbits + if (stopbits_ == stopbits_one) + dcbSerialParams.StopBits = ONESTOPBIT; + else if (stopbits_ == stopbits_one_point_five) + dcbSerialParams.StopBits = ONE5STOPBITS; + else if (stopbits_ == stopbits_two) + dcbSerialParams.StopBits = TWOSTOPBITS; + else + throw invalid_argument ("invalid stop bit"); + + // setup parity + if (parity_ == parity_none) { + dcbSerialParams.Parity = NOPARITY; + } else if (parity_ == parity_even) { + dcbSerialParams.Parity = EVENPARITY; + } else if (parity_ == parity_odd) { + dcbSerialParams.Parity = ODDPARITY; + } else if (parity_ == parity_mark) { + dcbSerialParams.Parity = MARKPARITY; + } else if (parity_ == parity_space) { + dcbSerialParams.Parity = SPACEPARITY; + } else { + throw invalid_argument ("invalid parity"); + } + + // setup flowcontrol + if (flowcontrol_ == flowcontrol_none) { + dcbSerialParams.fOutxCtsFlow = false; + dcbSerialParams.fRtsControl = RTS_CONTROL_DISABLE; + dcbSerialParams.fOutX = false; + dcbSerialParams.fInX = false; + } + if (flowcontrol_ == flowcontrol_software) { + dcbSerialParams.fOutxCtsFlow = false; + dcbSerialParams.fRtsControl = RTS_CONTROL_DISABLE; + dcbSerialParams.fOutX = true; + dcbSerialParams.fInX = true; + } + if (flowcontrol_ == flowcontrol_hardware) { + dcbSerialParams.fOutxCtsFlow = true; + dcbSerialParams.fRtsControl = RTS_CONTROL_HANDSHAKE; + dcbSerialParams.fOutX = false; + dcbSerialParams.fInX = false; + } + + // activate settings + if (!SetCommState(fd_, &dcbSerialParams)){ + CloseHandle(fd_); + THROW (IOException, "Error setting serial port settings."); + } + + // Setup timeouts + COMMTIMEOUTS timeouts = {0}; + timeouts.ReadIntervalTimeout = timeout_.inter_byte_timeout; + timeouts.ReadTotalTimeoutConstant = timeout_.read_timeout_constant; + timeouts.ReadTotalTimeoutMultiplier = timeout_.read_timeout_multiplier; + timeouts.WriteTotalTimeoutConstant = timeout_.write_timeout_constant; + timeouts.WriteTotalTimeoutMultiplier = timeout_.write_timeout_multiplier; + if (!SetCommTimeouts(fd_, &timeouts)) { + THROW (IOException, "Error setting timeouts."); + } +} + +void +Serial::SerialImpl::close () +{ + if (is_open_ == true) { + if (fd_ != INVALID_HANDLE_VALUE) { + int ret; + ret = CloseHandle(fd_); + if (ret == 0) { + stringstream ss; + ss << "Error while closing serial port: " << GetLastError(); + THROW (IOException, ss.str().c_str()); + } else { + fd_ = INVALID_HANDLE_VALUE; + } + } + is_open_ = false; + } +} + +bool +Serial::SerialImpl::isOpen () const +{ + return is_open_; +} + +size_t +Serial::SerialImpl::available () +{ + if (!is_open_) { + return 0; + } + COMSTAT cs; + if (!ClearCommError(fd_, NULL, &cs)) { + stringstream ss; + ss << "Error while checking status of the serial port: " << GetLastError(); + THROW (IOException, ss.str().c_str()); + } + return static_cast(cs.cbInQue); +} + +bool +Serial::SerialImpl::waitReadable (uint32_t /*timeout*/) +{ + THROW (IOException, "waitReadable is not implemented on Windows."); + return false; +} + +void +Serial::SerialImpl::waitByteTimes (size_t /*count*/) +{ + THROW (IOException, "waitByteTimes is not implemented on Windows."); +} + +size_t +Serial::SerialImpl::read (uint8_t *buf, size_t size) +{ + if (!is_open_) { + throw PortNotOpenedException ("Serial::read"); + } + DWORD bytes_read; + if (!ReadFile(fd_, buf, static_cast(size), &bytes_read, NULL)) { + stringstream ss; + ss << "Error while reading from the serial port: " << GetLastError(); + THROW (IOException, ss.str().c_str()); + } + return (size_t) (bytes_read); +} + +size_t +Serial::SerialImpl::write (const uint8_t *data, size_t length) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::write"); + } + DWORD bytes_written; + if (!WriteFile(fd_, data, static_cast(length), &bytes_written, NULL)) { + stringstream ss; + ss << "Error while writing to the serial port: " << GetLastError(); + THROW (IOException, ss.str().c_str()); + } + return (size_t) (bytes_written); +} + +void +Serial::SerialImpl::setPort (const string &port) +{ + port_ = wstring(port.begin(), port.end()); +} + +string +Serial::SerialImpl::getPort () const +{ + return string(port_.begin(), port_.end()); +} + +void +Serial::SerialImpl::setTimeout (serial::Timeout &timeout) +{ + timeout_ = timeout; + if (is_open_) { + reconfigurePort (); + } +} + +serial::Timeout +Serial::SerialImpl::getTimeout () const +{ + return timeout_; +} + +void +Serial::SerialImpl::setBaudrate (unsigned long baudrate) +{ + baudrate_ = baudrate; + if (is_open_) { + reconfigurePort (); + } +} + +unsigned long +Serial::SerialImpl::getBaudrate () const +{ + return baudrate_; +} + +void +Serial::SerialImpl::setBytesize (serial::bytesize_t bytesize) +{ + bytesize_ = bytesize; + if (is_open_) { + reconfigurePort (); + } +} + +serial::bytesize_t +Serial::SerialImpl::getBytesize () const +{ + return bytesize_; +} + +void +Serial::SerialImpl::setParity (serial::parity_t parity) +{ + parity_ = parity; + if (is_open_) { + reconfigurePort (); + } +} + +serial::parity_t +Serial::SerialImpl::getParity () const +{ + return parity_; +} + +void +Serial::SerialImpl::setStopbits (serial::stopbits_t stopbits) +{ + stopbits_ = stopbits; + if (is_open_) { + reconfigurePort (); + } +} + +serial::stopbits_t +Serial::SerialImpl::getStopbits () const +{ + return stopbits_; +} + +void +Serial::SerialImpl::setFlowcontrol (serial::flowcontrol_t flowcontrol) +{ + flowcontrol_ = flowcontrol; + if (is_open_) { + reconfigurePort (); + } +} + +serial::flowcontrol_t +Serial::SerialImpl::getFlowcontrol () const +{ + return flowcontrol_; +} + +void +Serial::SerialImpl::flush () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::flush"); + } + FlushFileBuffers (fd_); +} + +void +Serial::SerialImpl::flushInput () +{ + if (is_open_ == false) { + throw PortNotOpenedException("Serial::flushInput"); + } + PurgeComm(fd_, PURGE_RXCLEAR); +} + +void +Serial::SerialImpl::flushOutput () +{ + if (is_open_ == false) { + throw PortNotOpenedException("Serial::flushOutput"); + } + PurgeComm(fd_, PURGE_TXCLEAR); +} + +void +Serial::SerialImpl::sendBreak (int /*duration*/) +{ + THROW (IOException, "sendBreak is not supported on Windows."); +} + +void +Serial::SerialImpl::setBreak (bool level) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::setBreak"); + } + if (level) { + EscapeCommFunction (fd_, SETBREAK); + } else { + EscapeCommFunction (fd_, CLRBREAK); + } +} + +void +Serial::SerialImpl::setRTS (bool level) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::setRTS"); + } + if (level) { + EscapeCommFunction (fd_, SETRTS); + } else { + EscapeCommFunction (fd_, CLRRTS); + } +} + +void +Serial::SerialImpl::setDTR (bool level) +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::setDTR"); + } + if (level) { + EscapeCommFunction (fd_, SETDTR); + } else { + EscapeCommFunction (fd_, CLRDTR); + } +} + +bool +Serial::SerialImpl::waitForChange () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::waitForChange"); + } + DWORD dwCommEvent; + + if (!SetCommMask(fd_, EV_CTS | EV_DSR | EV_RING | EV_RLSD)) { + // Error setting communications mask + return false; + } + + if (!WaitCommEvent(fd_, &dwCommEvent, NULL)) { + // An error occurred waiting for the event. + return false; + } else { + // Event has occurred. + return true; + } +} + +bool +Serial::SerialImpl::getCTS () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getCTS"); + } + DWORD dwModemStatus; + if (!GetCommModemStatus(fd_, &dwModemStatus)) { + THROW (IOException, "Error getting the status of the CTS line."); + } + + return (MS_CTS_ON & dwModemStatus) != 0; +} + +bool +Serial::SerialImpl::getDSR () +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getDSR"); + } + DWORD dwModemStatus; + if (!GetCommModemStatus(fd_, &dwModemStatus)) { + THROW (IOException, "Error getting the status of the DSR line."); + } + + return (MS_DSR_ON & dwModemStatus) != 0; +} + +bool +Serial::SerialImpl::getRI() +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getRI"); + } + DWORD dwModemStatus; + if (!GetCommModemStatus(fd_, &dwModemStatus)) { + THROW (IOException, "Error getting the status of the RI line."); + } + + return (MS_RING_ON & dwModemStatus) != 0; +} + +bool +Serial::SerialImpl::getCD() +{ + if (is_open_ == false) { + throw PortNotOpenedException ("Serial::getCD"); + } + DWORD dwModemStatus; + if (!GetCommModemStatus(fd_, &dwModemStatus)) { + // Error in GetCommModemStatus; + THROW (IOException, "Error getting the status of the CD line."); + } + + return (MS_RLSD_ON & dwModemStatus) != 0; +} + +void +Serial::SerialImpl::readLock() +{ + if (WaitForSingleObject(read_mutex, INFINITE) != WAIT_OBJECT_0) { + THROW (IOException, "Error claiming read mutex."); + } +} + +void +Serial::SerialImpl::readUnlock() +{ + if (!ReleaseMutex(read_mutex)) { + THROW (IOException, "Error releasing read mutex."); + } +} + +void +Serial::SerialImpl::writeLock() +{ + if (WaitForSingleObject(write_mutex, INFINITE) != WAIT_OBJECT_0) { + THROW (IOException, "Error claiming write mutex."); + } +} + +void +Serial::SerialImpl::writeUnlock() +{ + if (!ReleaseMutex(write_mutex)) { + THROW (IOException, "Error releasing write mutex."); + } +} + +#endif // #if defined(_WIN32) + diff --git a/serial/src/serial.cc b/serial/src/serial.cc new file mode 100755 index 0000000..37b5d70 --- /dev/null +++ b/serial/src/serial.cc @@ -0,0 +1,430 @@ +/* Copyright 2012 William Woodall and John Harrison */ +#include + +#if !defined(_WIN32) && !defined(__OpenBSD__) && !defined(__FreeBSD__) +# include +#endif + +#if defined (__MINGW32__) +# define alloca __builtin_alloca +#endif + +#include "serial/serial.h" + +#ifdef _WIN32 +#include "serial/impl/win.h" +#else +#include "serial/impl/unix.h" +#endif + +using std::invalid_argument; +using std::min; +using std::numeric_limits; +using std::vector; +using std::size_t; +using std::string; + +using serial::Serial; +using serial::SerialException; +using serial::IOException; +using serial::bytesize_t; +using serial::parity_t; +using serial::stopbits_t; +using serial::flowcontrol_t; + +class Serial::ScopedReadLock { +public: + ScopedReadLock(SerialImpl *pimpl) : pimpl_(pimpl) { + this->pimpl_->readLock(); + } + ~ScopedReadLock() { + this->pimpl_->readUnlock(); + } +private: + // Disable copy constructors + ScopedReadLock(const ScopedReadLock&); + const ScopedReadLock& operator=(ScopedReadLock); + + SerialImpl *pimpl_; +}; + +class Serial::ScopedWriteLock { +public: + ScopedWriteLock(SerialImpl *pimpl) : pimpl_(pimpl) { + this->pimpl_->writeLock(); + } + ~ScopedWriteLock() { + this->pimpl_->writeUnlock(); + } +private: + // Disable copy constructors + ScopedWriteLock(const ScopedWriteLock&); + const ScopedWriteLock& operator=(ScopedWriteLock); + SerialImpl *pimpl_; +}; + +Serial::Serial (const string &port, uint32_t baudrate, serial::Timeout timeout, + bytesize_t bytesize, parity_t parity, stopbits_t stopbits, + flowcontrol_t flowcontrol) + : pimpl_(new SerialImpl (port, baudrate, bytesize, parity, + stopbits, flowcontrol)) +{ + pimpl_->setTimeout(timeout); +} + +Serial::~Serial () +{ + delete pimpl_; +} + +void +Serial::open () +{ + pimpl_->open (); +} + +void +Serial::close () +{ + pimpl_->close (); +} + +bool +Serial::isOpen () const +{ + return pimpl_->isOpen (); +} + +size_t +Serial::available () +{ + return pimpl_->available (); +} + +bool +Serial::waitReadable () +{ + serial::Timeout timeout(pimpl_->getTimeout ()); + return pimpl_->waitReadable(timeout.read_timeout_constant); +} + +void +Serial::waitByteTimes (size_t count) +{ + pimpl_->waitByteTimes(count); +} + +size_t +Serial::read_ (uint8_t *buffer, size_t size) +{ + return this->pimpl_->read (buffer, size); +} + +size_t +Serial::read (uint8_t *buffer, size_t size) +{ + ScopedReadLock lock(this->pimpl_); + return this->pimpl_->read (buffer, size); +} + +size_t +Serial::read (std::vector &buffer, size_t size) +{ + ScopedReadLock lock(this->pimpl_); + uint8_t *buffer_ = new uint8_t[size]; + size_t bytes_read = 0; + + try { + bytes_read = this->pimpl_->read (buffer_, size); + } + catch (const std::exception &e) { + delete[] buffer_; + throw; + } + + buffer.insert (buffer.end (), buffer_, buffer_+bytes_read); + delete[] buffer_; + return bytes_read; +} + +size_t +Serial::read (std::string &buffer, size_t size) +{ + ScopedReadLock lock(this->pimpl_); + uint8_t *buffer_ = new uint8_t[size]; + size_t bytes_read = 0; + try { + bytes_read = this->pimpl_->read (buffer_, size); + } + catch (const std::exception &e) { + delete[] buffer_; + throw; + } + buffer.append (reinterpret_cast(buffer_), bytes_read); + delete[] buffer_; + return bytes_read; +} + +string +Serial::read (size_t size) +{ + std::string buffer; + this->read (buffer, size); + return buffer; +} + +size_t +Serial::readline (string &buffer, size_t size, string eol) +{ + ScopedReadLock lock(this->pimpl_); + size_t eol_len = eol.length (); + uint8_t *buffer_ = static_cast + (alloca (size * sizeof (uint8_t))); + size_t read_so_far = 0; + while (true) + { + size_t bytes_read = this->read_ (buffer_ + read_so_far, 1); + read_so_far += bytes_read; + if (bytes_read == 0) { + break; // Timeout occured on reading 1 byte + } + if (string (reinterpret_cast + (buffer_ + read_so_far - eol_len), eol_len) == eol) { + break; // EOL found + } + if (read_so_far == size) { + break; // Reached the maximum read length + } + } + buffer.append(reinterpret_cast (buffer_), read_so_far); + return read_so_far; +} + +string +Serial::readline (size_t size, string eol) +{ + std::string buffer; + this->readline (buffer, size, eol); + return buffer; +} + +vector +Serial::readlines (size_t size, string eol) +{ + ScopedReadLock lock(this->pimpl_); + std::vector lines; + size_t eol_len = eol.length (); + uint8_t *buffer_ = static_cast + (alloca (size * sizeof (uint8_t))); + size_t read_so_far = 0; + size_t start_of_line = 0; + while (read_so_far < size) { + size_t bytes_read = this->read_ (buffer_+read_so_far, 1); + read_so_far += bytes_read; + if (bytes_read == 0) { + if (start_of_line != read_so_far) { + lines.push_back ( + string (reinterpret_cast (buffer_ + start_of_line), + read_so_far - start_of_line)); + } + break; // Timeout occured on reading 1 byte + } + if (string (reinterpret_cast + (buffer_ + read_so_far - eol_len), eol_len) == eol) { + // EOL found + lines.push_back( + string(reinterpret_cast (buffer_ + start_of_line), + read_so_far - start_of_line)); + start_of_line = read_so_far; + } + if (read_so_far == size) { + if (start_of_line != read_so_far) { + lines.push_back( + string(reinterpret_cast (buffer_ + start_of_line), + read_so_far - start_of_line)); + } + break; // Reached the maximum read length + } + } + return lines; +} + +size_t +Serial::write (const string &data) +{ + ScopedWriteLock lock(this->pimpl_); + return this->write_ (reinterpret_cast(data.c_str()), + data.length()); +} + +size_t +Serial::write (const std::vector &data) +{ + ScopedWriteLock lock(this->pimpl_); + return this->write_ (&data[0], data.size()); +} + +size_t +Serial::write (const uint8_t *data, size_t size) +{ + ScopedWriteLock lock(this->pimpl_); + return this->write_(data, size); +} + +size_t +Serial::write_ (const uint8_t *data, size_t length) +{ + return pimpl_->write (data, length); +} + +void +Serial::setPort (const string &port) +{ + ScopedReadLock rlock(this->pimpl_); + ScopedWriteLock wlock(this->pimpl_); + bool was_open = pimpl_->isOpen (); + if (was_open) close(); + pimpl_->setPort (port); + if (was_open) open (); +} + +string +Serial::getPort () const +{ + return pimpl_->getPort (); +} + +void +Serial::setTimeout (serial::Timeout &timeout) +{ + pimpl_->setTimeout (timeout); +} + +serial::Timeout +Serial::getTimeout () const { + return pimpl_->getTimeout (); +} + +void +Serial::setBaudrate (uint32_t baudrate) +{ + pimpl_->setBaudrate (baudrate); +} + +uint32_t +Serial::getBaudrate () const +{ + return uint32_t(pimpl_->getBaudrate ()); +} + +void +Serial::setBytesize (bytesize_t bytesize) +{ + pimpl_->setBytesize (bytesize); +} + +bytesize_t +Serial::getBytesize () const +{ + return pimpl_->getBytesize (); +} + +void +Serial::setParity (parity_t parity) +{ + pimpl_->setParity (parity); +} + +parity_t +Serial::getParity () const +{ + return pimpl_->getParity (); +} + +void +Serial::setStopbits (stopbits_t stopbits) +{ + pimpl_->setStopbits (stopbits); +} + +stopbits_t +Serial::getStopbits () const +{ + return pimpl_->getStopbits (); +} + +void +Serial::setFlowcontrol (flowcontrol_t flowcontrol) +{ + pimpl_->setFlowcontrol (flowcontrol); +} + +flowcontrol_t +Serial::getFlowcontrol () const +{ + return pimpl_->getFlowcontrol (); +} + +void Serial::flush () +{ + ScopedReadLock rlock(this->pimpl_); + ScopedWriteLock wlock(this->pimpl_); + pimpl_->flush (); +} + +void Serial::flushInput () +{ + ScopedReadLock lock(this->pimpl_); + pimpl_->flushInput (); +} + +void Serial::flushOutput () +{ + ScopedWriteLock lock(this->pimpl_); + pimpl_->flushOutput (); +} + +void Serial::sendBreak (int duration) +{ + pimpl_->sendBreak (duration); +} + +void Serial::setBreak (bool level) +{ + pimpl_->setBreak (level); +} + +void Serial::setRTS (bool level) +{ + pimpl_->setRTS (level); +} + +void Serial::setDTR (bool level) +{ + pimpl_->setDTR (level); +} + +bool Serial::waitForChange() +{ + return pimpl_->waitForChange(); +} + +bool Serial::getCTS () +{ + return pimpl_->getCTS (); +} + +bool Serial::getDSR () +{ + return pimpl_->getDSR (); +} + +bool Serial::getRI () +{ + return pimpl_->getRI (); +} + +bool Serial::getCD () +{ + return pimpl_->getCD (); +} diff --git a/waveshare/CMakeLists.txt b/waveshare/CMakeLists.txt index e60f6ac..d1d6b08 100755 --- a/waveshare/CMakeLists.txt +++ b/waveshare/CMakeLists.txt @@ -9,11 +9,10 @@ find_package(ament_cmake REQUIRED) find_package(rclcpp REQUIRED) find_package(sensor_msgs REQUIRED) find_package(std_msgs REQUIRED) -######find_package(serial REQUIRED) +find_package(serial REQUIRED) # Add header file directory include_directories(include) -link_directories(${CMAKE_SOURCE_DIR}/lib) # Create the imu_cmd library add_library(imu_cmd @@ -40,6 +39,7 @@ ament_target_dependencies(imu_node rclcpp std_msgs sensor_msgs + serial ) # Install executable files @@ -52,7 +52,7 @@ install(TARGETS imu_cmd DESTINATION lib/${PROJECT_NAME} ) -install(FILES lib/libserial.so DESTINATION lib) +#install(FILES lib/libserial.so DESTINATION lib) # Install other resources (such as launch files, configuration files, etc.) install(DIRECTORY launch rviz diff --git a/waveshare/lib/libserial.so b/waveshare/lib/libserial.so deleted file mode 100755 index bc8caaf2a8d3eb1dd93fbb40fb9c00cb82a99d2a..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 188864 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