libfap - APRS parser

libfap is a quick and dirty C port of the Ham::APRS::FAP Finnish APRS Parser (Fabulous APRS Parser) Perl module. As the original Perl code, libfap parses normal, mic-e and compressed location packets, NMEA location packets, objects, items, messages, telemetry and most weather packets. For more description, see the Perl module.

News

RSS icon

2015-01-31

Aaand there was a bug. A crash caused by null pointer accident in telemetry parsing. Fixed in 1.5, go get it.

2014-11-23

We're back!

A new release of libfap is out. See the changelog for details.

Downloading and installing

Source code and also binary packages for some GNU/Linux distributions can be downloaded from the downloads directory.

Binary packages

Debian and Ubuntu users can use the provided binary packages. Just download the packages you need and say dpkg -i libfap*.deb.

Users of RPM-based distributions should look here: https://bugzilla.redhat.com/show_bug.cgi?id=669010

Compiling

Building libfap should work like this:

tar xvzf libfap-<version>.tar.gz
cd libfap-<version>
./configure [--prefix=/opt or other options]
make
make install

Documentation

To see how to use the parser in your C/C++ code, see the API documentation.

Checking for availability

If you use automake and things in your project, you can check for libfap for example like this:

dnl Check for libfap.
AC_CHECK_HEADERS(fap.h, , AC_MSG_ERROR([libfap header not found.]),[[#include <fap.h>]])
AC_CHECK_LIB(fap, fap_parseaprs, , AC_MSG_ERROR([libfap library object not found.]))

Copyright and disclaimer

The parser has been originally written by Tapio Sokura, OH2KKU and Heikki Hannikainen, OH7LZB and ported to C by Tapio Aaltonen, OH2GVE.

Libfap is free software; you can redistribute it and/or modify it under the terms of either:

  1. the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or
  2. the Artistic License version 1.0.

Both licenses can be found in the licenses directory of the source code package.

This software has no warranty, you use it entirely at your own risk. If you spot a bug in libfap, please report it to OH2GVE. Thanks!

back to front