README

This is a Go wrapper for the libnfc.

You need the following libnfc version to use this code:

    versions <= 2.0.2 need libnfc version 1.7.0 or 1.7.1
    version  >= 2.1.0 need libnfc version 1.8.0 or later

Due to an unfortunate ABI breakage, libnfc version 1.7.2 cannot be used
with this wrapper.

The code has not been thoroughly tested yet. Please report any errors to
the project. The API is considered stable as of version 2.0 and will
probably not change in incompatible ways in the near future.

Version 2.0.2 and earlier of this wrapper have been developed before the
advent of Go modules.  For this reason, they use a weird homecooked
scheme for their versioning involving the 2.0 and latest directories.
These can safely be ignored for new developments.  Using Go modules,
only version 2.1.0 and later are available.

To use this library, install libnfc version 1.8.0 or newer and import

    github.com/clausecker/nfc/v2

into your project.  Pkg-config is used to find libnfc automatically.  If
this does not work, you can compile with tag nopkgconfig or no_pkgconfig
to instruct the package to instead simply link with -lnfc.  You'll then
have to manually set things up for suitable -I... and -L... options to
be supplied so the header files and library are found.

This project uses go modules for versioning and tries its best to follow
the usual guidelines for interface stability.

Copyright (c) 2014--2020, 2024 Robert Clausecker <fuz@fuz.su>

This program is free software: you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, version 3.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU General Public License for more details.