Add comments.
authorasterix <asterix@38d2e660-2303-0410-9eaa-f027e97ec537>
Fri, 7 May 2010 13:37:30 +0000 (13:37 +0000)
committerasterix <asterix@38d2e660-2303-0410-9eaa-f027e97ec537>
Fri, 7 May 2010 13:37:30 +0000 (13:37 +0000)
git-svn-id: https://src.develer.com/svnoss/bertos/trunk@3626 38d2e660-2303-0410-9eaa-f027e97ec537

bertos/net/keytag.c

index 2376305a07424ebfb4cf2c733f2a9d18ad57b924..32473ceb733fd047614a8558616ad6eab82a3a7c 100644 (file)
  * -->
  *
  * \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>
@@ -85,6 +89,11 @@ void keytag_poll(struct TagPacket *pkt)
                kfile_write(pkt->host, buf, len);
 }
 
+/**
+ * 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;