From 18e6e1bc7cf3a16ffd382250dac503b852b37b58 Mon Sep 17 00:00:00 2001
From: Romuald Conty <romuald@libnfc.org>
Date: Thu, 29 Jul 2010 12:48:59 +0000
Subject: [PATCH] Add documentation for pn53x_InListPassiveTarget()
---
libnfc/chips/pn53x.c | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/libnfc/chips/pn53x.c b/libnfc/chips/pn53x.c
index 2881327..a56d37d 100644
--- a/libnfc/chips/pn53x.c
+++ b/libnfc/chips/pn53x.c
@@ -275,6 +275,20 @@ pn53x_decode_target_data(const byte_t* pbtRawData, size_t szDataLen, nfc_chip_t
return true;
}
+/**
+ * @brief C wrapper to InListPassiveTarget command
+ * @return true if command is successfully sent
+ *
+ * @param pnd nfc_device_t struct pointer that represent currently used device
+ * @param nmInitModulation Desired modulation
+ * @param pbtInitiatorData Optional initiator data used for Felica, ISO14443B, Topaz Polling or for ISO14443A selecting a specific UID
+ * @param szInitiatorDataLen Length of initiator data \a pbtInitiatorData
+ * @param pbtTargetsData pointer on a pre-allocated byte array to receive TargetData[n] as described in pn53x user manual
+ * @param pszTargetsData size_t pointer where size of \a pbtTargetsData will be written
+ *
+ * @note Selected targets count can be found in \a pbtTargetsData[0] if available (i.e. \a pszTargetsData content is more than 0)
+ * @note To decode theses TargetData[n], there is @fn pn53x_decode_target_data
+ */
bool
pn53x_InListPassiveTarget(const nfc_device_t* pnd,
const nfc_modulation_t nmInitModulation, const byte_t szMaxTargets,