* -->
*
* \author Andrea Grandi <andrea@develer.com>
+ * \author Daniele Basile <asterix@develer.com>
*
- * \brief Tag protocol (protocol).
+ * \brief KeyTAG parser.
+ *
+ * This module parse TAG message that come from comunication channel,
+ * and convert the tag value into string.
*
* TAG protocol is decribed in this way:
* <pre>
#include <cfg/log.h>
#include <cfg/macros.h>
-#include <kern/kfile.h>
+#include <io/kfile.h>
+#include <string.h>
/**
* Starting communication char (STX).
*/
pkt->len = 0;
}
-void keytag_init(struct TagPacket *pkt, struct KFile *comm, struct KFile *tag)
+/**
+ * DEPRECATED FUCNTIONS
+ * To read the tag string from device you shoul use the keytag_recv
+ * fuction, that return the string if we had received it.
+ */
+void keytag_poll(struct TagPacket *pkt)
{
- keytag_clearPkt(pkt);
- pkt->host = comm;
- pkt->tag = tag;
+ uint8_t buf[CONFIG_TAG_MAX_LEN];
+ int len;
+ if ((len = keytag_recv(pkt, buf, sizeof(buf))) != EOF)
+ kfile_write(pkt->host, buf, len);
}
-void keytag_poll(struct TagPacket *pkt)
+/**
+ * Receive the tag message from channel, and if
+ * the tag is good put the converted string into given buffer.
+ * The fuction return the len of found tag string, otherwise EOF.
+ */
+int keytag_recv(struct TagPacket *pkt, uint8_t *tag, size_t len)
{
int c;
if (c == TAG_ETX)
{
/* Terminate the tag string */
- uint16_t len = MIN((uint16_t)CONFIG_TAG_MAX_LEN, pkt->len);
- pkt->buf[len] = '\0';
- /* Write read TAG on communication serial */
- kfile_printf(pkt->host, "%s%s", CONFIG_TAG_LABEL, pkt->buf);
+ size_t tag_len = MIN(len, pkt->len);
+
+ /* Save read tag */
+ memcpy(tag, pkt->buf, tag_len);
pkt->sync = false;
+ return tag_len;
}
else
{
}
if (kfile_error(pkt->tag) != 0)
{
- LOG_ERR("Error %08x\n", kfile_error(pkt->tag));
+ LOG_ERR("Error %04x\n", kfile_error(pkt->tag));
kfile_clearerr(pkt->tag);
}
+ return EOF;
}
+
+/**
+ * Init the keytag module.
+ */
+void keytag_init(struct TagPacket *pkt, struct KFile *comm, struct KFile *tag)
+{
+ keytag_clearPkt(pkt);
+ pkt->tag = tag;
+ pkt->host = comm;
+}
+