add nfc_device_get_connstring() function and nfc-probe example to show devices connection strings

utils/Makefile.am

@@ -4,6 +4,7 @@ bin_PROGRAMS = \
 		nfc-mfclassic \
 		nfc-mfsetuid \
 		nfc-mfultralight \
+		nfc-probe \
 		nfc-read-forum-tag3 \
 		nfc-relay-picc
 
@@ -36,6 +37,10 @@ nfc_mfsetuid_LDADD = $(top_builddir)/libnfc/libnfc.la \
 nfc_mfultralight_SOURCES = nfc-mfultralight.c mifare.c mifare.h
 nfc_mfultralight_LDADD = $(top_builddir)/libnfc/libnfc.la
 
+nfc_probe_SOURCES = nfc-probe.c
+nfc_probe_LDADD = $(top_builddir)/libnfc/libnfc.la \
+		 libnfcutils.la
+
 nfc_read_forum_tag3_SOURCES = nfc-read-forum-tag3.c
 nfc_read_forum_tag3_LDADD = $(top_builddir)/libnfc/libnfc.la \
 		            libnfcutils.la

utils/nfc-probe.c

@@ -0,0 +1,115 @@
+/*-
+ * Public platform independent Near Field Communication (NFC) library examples
+ * 
+ * Copyright (C) 2009, Roel Verdult
+ * Copyright (C) 2010, Romuald Conty, Romain Tartière
+ * 
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *  1) Redistributions of source code must retain the above copyright notice,
+ *  this list of conditions and the following disclaimer. 
+ *  2 )Redistributions in binary form must reproduce the above copyright
+ *  notice, this list of conditions and the following disclaimer in the
+ *  documentation and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ * 
+ * Note that this license only applies on the examples, NFC library itself is under LGPL
+ *
+ */
+
+/**
+ * @file nfc-probe.c
+ * @brief Lists each available NFC device
+ */
+
+#ifdef HAVE_CONFIG_H
+#  include "config.h"
+#endif // HAVE_CONFIG_H
+
+#ifdef HAVE_LIBUSB
+#  ifdef DEBUG
+#    include <sys/param.h>
+#    include <usb.h>
+#  endif
+#endif
+
+#include <err.h>
+#include <stdio.h>
+#include <stddef.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include <nfc/nfc.h>
+
+#include "nfc-utils.h"
+
+#define MAX_DEVICE_COUNT 16
+#define MAX_TARGET_COUNT 16
+
+static nfc_device *pnd;
+
+void
+print_usage (const char* progname)
+{
+  printf ("usage: %s [-v]\n", progname);
+  printf ("  -v\t verbose display\n");
+}
+
+int
+main (int argc, const char *argv[])
+{
+  (void) argc;
+  const char *acLibnfcVersion;
+  size_t  i;
+  bool verbose = false;
+
+  nfc_init ();
+  
+  // Display libnfc version
+  acLibnfcVersion = nfc_version ();
+  printf ("%s uses libnfc %s\n", argv[0], acLibnfcVersion);
+  if (argc != 1) {
+    if ((argc == 2) && (0 == strcmp ("-v", argv[1]))) {
+      verbose = true;
+    } else {
+      print_usage (argv[0]);
+      exit (EXIT_FAILURE);
+    }
+  }
+
+#ifdef HAVE_LIBUSB
+#  ifdef DEBUG
+  usb_set_debug (4);
+#  endif
+#endif
+
+  nfc_connstring connstrings[MAX_DEVICE_COUNT];
+  size_t szDeviceFound = nfc_list_devices (connstrings, MAX_DEVICE_COUNT);
+
+  if (szDeviceFound == 0) {
+    printf ("No NFC device found.\n");
+  }
+
+  printf ("%d NFC device(s) found:\n", szDeviceFound);
+  for (i = 0; i < szDeviceFound; i++) {
+    pnd = nfc_open (connstrings[i]);
+    if (pnd != NULL) {
+      printf ("- %s:\n    %s\n", nfc_device_get_name (pnd), nfc_device_get_connstring (pnd));
+    }
+    nfc_close (pnd);
+  }
+  
+  nfc_exit ();
+  return 0;
+}