Difference between revisions of "Libserialport"

From sigrok
Jump to navigation Jump to search
(build instructions depend on the platform, reference the README file)
 
(7 intermediate revisions by 2 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
* Android
Line 14: Line 17:


You can browse the [http://sigrok.org/api/libserialport/unstable/index.html API documentation] of the library online.
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 21: Line 28:
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 ==
== Building from source ==


* libudev (only needed on Linux)
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.
* There are no dependencies at all on other OSes.


== Building from source ==
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'''
  $ '''./autogen.sh'''
Line 32: Line 38:
  $ '''make'''
  $ '''make'''
  $ '''sudo make install'''
  $ '''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.


__NOTOC__
__NOTOC__
[[Category:APIs]]

Latest revision as of 13:59, 14 November 2020

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.