2013-11-14 20:33:53 +04:00
|
|
|
-------------------------------------------------------------------------------
|
2013-10-27 21:19:39 +04:00
|
|
|
libserialport: cross-platform library for accessing serial ports
|
2013-11-14 20:33:53 +04:00
|
|
|
-------------------------------------------------------------------------------
|
2013-10-27 21:19:39 +04:00
|
|
|
|
|
|
|
|
libserialport is a minimal library written in C that is intended to take care
|
|
|
|
|
of the OS-specific details when writing software that uses serial ports.
|
|
|
|
|
|
|
|
|
|
By writing your serial code to use libserialport, you enable it to work
|
|
|
|
|
transparently on any platform supported by the library.
|
|
|
|
|
|
|
|
|
|
The operations that are supported are:
|
|
|
|
|
|
|
|
|
|
- Port enumeration (obtaining a list of serial ports on the system).
|
2014-06-11 18:10:29 +04:00
|
|
|
- Obtaining port metadata (USB device information, Bluetooth address, etc).
|
2013-10-27 21:19:39 +04:00
|
|
|
- Opening and closing ports.
|
|
|
|
|
- Setting port parameters (baud rate, parity, etc).
|
|
|
|
|
- Reading, writing and flushing data.
|
|
|
|
|
- Obtaining error information.
|
|
|
|
|
|
|
|
|
|
libserialport is an open source project released under the LGPL3+ license.
|
|
|
|
|
|
|
|
|
|
Status
|
|
|
|
|
======
|
|
|
|
|
|
|
|
|
|
The library should build and work on any Windows or Unix-based system. If it
|
|
|
|
|
does not, please submit a bug.
|
|
|
|
|
|
|
|
|
|
Enumeration is currently only implemented on Windows, Mac OS X and Linux. On
|
2013-11-23 15:57:17 +04:00
|
|
|
other systems enumeration is not supported, but ports can still be opened by
|
|
|
|
|
name and then used.
|
2013-10-27 21:19:39 +04:00
|
|
|
|
|
|
|
|
If you know how to enumerate available ports on another OS, please submit a bug
|
|
|
|
|
with this information, or better still a patch implementing it.
|
|
|
|
|
|
|
|
|
|
Dependencies
|
|
|
|
|
============
|
|
|
|
|
|
2014-05-31 02:48:54 +04:00
|
|
|
No other libraries are required.
|
2013-10-27 21:19:39 +04:00
|
|
|
|
|
|
|
|
Building
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
The package uses a GNU style build system and requires a Unix style shell.
|
2014-09-07 21:27:02 +04:00
|
|
|
|
|
|
|
|
Windows builds can be created natively with the MinGW-w64 toolchain and
|
|
|
|
|
MSYS environment, or cross-compiled using a MinGW-w64 toolchain:
|
|
|
|
|
|
|
|
|
|
http://mingw-w64.sourceforge.net/
|
|
|
|
|
|
|
|
|
|
The "old" MinGW from http://mingw.org/ is not supported.
|
2013-10-27 21:19:39 +04:00
|
|
|
|
|
|
|
|
Run "./autogen.sh" to generate the build system, "./configure" to setup, then
|
|
|
|
|
"make" to build the library and "make install" to install it.
|
|
|
|
|
|
|
|
|
|
API
|
|
|
|
|
===
|
|
|
|
|
|
2013-11-19 06:11:34 +04:00
|
|
|
Doxygen API documentation is included.
|
