libserialport

From sigrok
Jump to navigation Jump to search

libserialport (sometimes abbreviated as "sp") is a minimal, cross-platform shared library written in C that is intended to take care of the OS-specific details when writing software that uses serial ports.

It is licensed under the terms of the GNU Lesser General Public License, version 3 or later.

Note: While libserialport is hosted on sigrok.org (and sigrok uses libserialport), this is a completely independent library that can be used by other projects as well. The libserialport library does not depend on any sigrok related libraries or projects.

Supported operating systems

  • Linux
  • Mac OS X
  • FreeBSD
  • Windows
  • Android

API documentation

You can browse the API documentation of the library online.

Distribution packages

See Downloads.

Getting the code

$ git clone git://sigrok.org/libserialport

You can also browse the source code via gitweb.

Building from source

Navigate to the directory where the source code resides. Make sure to also check the README file in the source tree in case this wiki page isn't up to date.

These are typical instructions for UNIX style environments. Your specific environment may differ. Check the doc files which reside in the source tree.

$ ./autogen.sh
$ ./configure
$ make
$ sudo make install

Note: The libserialport project does not depend on other libraries to build/use. But build tools will be required (the specific set depends on your platform).

Debugging

To examine problems related to libserialport, verbose debug output can be enabled by setting the environment variable LIBSERIALPORT_DEBUG to any value.