[libserialport.git] / examples / README

This directory contains example programs showing how to use libserialport.

The examples currently included are:

list_ports.c - displays a list of ports on the system.
port_info.c - displays info about a particular port on the system.

The programs themselves are completely OS-independent, and require only a
C compiler and libserialport.

The 'examples.sln' file is a solution file for Microsoft Visual Studio 2019
which will build libserialport and all of the example programs.

The Makefile in this directory will attempt to build all the examples,
using 'gcc' to compile them and 'pkg-config' to discover the include
paths and linker settings needed to build with libserialport. It provides
a minimal example of how to write a Makefile to build a program using
libserialport.

If you have make, gcc, pkg-config and libserialport installed correctly
then running 'make' should build the example programs in this directory.
If this doesn't work, you may need to modify the Makefile or set necessary
paths in your environment to suit your system.

You can also build these examples using any other compiler, IDE or build
system. You just need the libserialport.h header available to compile them,
and the libserialport library available to link and run them.

These example files are hereby released into the public domain by the author.
Commit	Line	Data
8c1a14e6 ML	1	This directory contains example programs showing how to use libserialport.
	2
	3	The examples currently included are:
	4
	5	list_ports.c - displays a list of ports on the system.
	6	port_info.c - displays info about a particular port on the system.
	7
	8	The programs themselves are completely OS-independent, and require only a
	9	C compiler and libserialport.
	10
67b55d10 ML	11	The 'examples.sln' file is a solution file for Microsoft Visual Studio 2019
	12	which will build libserialport and all of the example programs.
	13
8c1a14e6 ML	14	The Makefile in this directory will attempt to build all the examples,
	15	using 'gcc' to compile them and 'pkg-config' to discover the include
	16	paths and linker settings needed to build with libserialport. It provides
	17	a minimal example of how to write a Makefile to build a program using
	18	libserialport.
	19
	20	If you have make, gcc, pkg-config and libserialport installed correctly
	21	then running 'make' should build the example programs in this directory.
	22	If this doesn't work, you may need to modify the Makefile or set necessary
	23	paths in your environment to suit your system.
	24
	25	You can also build these examples using any other compiler, IDE or build
	26	system. You just need the libserialport.h header available to compile them,
	27	and the libserialport library available to link and run them.
ee12a01e ML	28
ee12a01e ML	29	These example files are hereby released into the public domain by the author.