Difference between revisions of "Libserialport"

From sigrok
Jump to navigation Jump to search
m
(9 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:libserialport}}
{{DISPLAYTITLE:libserialport}}
'''libserialport''' 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.
'''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.
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 ==
== Supported operating systems ==
Line 8: Line 10:
* Linux
* Linux
* Mac OS X
* Mac OS X
* FreeBSD
* Windows
* Windows
* Android
== API documentation ==
You can browse the [http://sigrok.org/api/libserialport/unstable/index.html API documentation] of the library online.
== Distribution packages ==
See [[Downloads#Binaries_and_distribution_packages|Downloads]].


== Getting the code ==
== Getting the code ==
Line 15: Line 27:


You can also [http://sigrok.org/gitweb/?p=libserialport.git;a=tree browse the source code] via gitweb.
You can also [http://sigrok.org/gitweb/?p=libserialport.git;a=tree browse the source code] via gitweb.
== Requirements ==
* libudev (only neded on Linux)
* There are no dependencies at all on other OSes.


== Building from source ==
== Building from source ==
Line 27: Line 34:
  $ '''make'''
  $ '''make'''
  $ '''sudo make install'''
  $ '''sudo make install'''
'''Note:''' There are no dependencies (i.e., no other libraries are needed to build/use libserialport).
== Debugging ==
To examine problems related to libserialport, verbose debug output can be enabled by setting the environment variable '''LIBSERIALPORT_DEBUG''' to any value.


__NOTOC__
__NOTOC__
[[Category:APIs]]

Revision as of 15:39, 28 April 2018

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

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

Note: There are no dependencies (i.e., no other libraries are needed to build/use libserialport).

Debugging

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