doc: Add example for KFileFifo

git-svn-id: https://src.develer.com/svnoss/bertos/trunk@2752 38d2e660-2303-0410-9eaa-f027e97ec537

diff --git a/bertos/struct/kfile_fifo.h b/bertos/struct/kfile_fifo.h
index 5d9ba5c2de5a099c693c6ca268c95797e4d77039..b5842786471eaa806ce9b0e5b92f0029166e111f 100644 (file)
--- a/bertos/struct/kfile_fifo.h
+++ b/bertos/struct/kfile_fifo.h
@@ -32,6 +32,27 @@
  *
  * \brief KFile interface over a FIFO buffer.
  *
+ * Convenient way to push data into a FIFO using the KFile interface.
+ * For example, it's possible to read from a serial port and put the characters
+ * into a fifo:
+ * \code
+ * // serial reader process
+ * {
+ *   // other stuff here...
+ *   kfile_read(&ser_port.fd, buffer, sizeof(buffer));
+ *   kfile_write(&kfifo.fd, buffer, sizeof(buffer));
+ *   // ...
+ * }
+ *
+ * // controller process
+ * {
+ *   //...
+ *   kfile_read(&kfifo.fd, buffer2, sizeof(buffer2));
+ *   // use read data
+ * }
+ * \endcode
+ *
+ *
  * \version $Id: cfg_adc.h 2348 2009-02-16 13:43:44Z duplo $
  * \author Francesco Sacchi <asterix@develer.com>
  *
@@ -65,6 +86,12 @@ INLINE KFileFifo * KFILEFIFO_CAST(KFile *fd)
        return (KFileFifo *)fd;
 }
 
+/**
+ * Initialize KFileFifo struct.
+ *
+ * \param kf Interface to initialize.
+ * \param fifo Fifo buffer to operate on.
+ */
 void kfilefifo_init(KFileFifo *kf, FIFOBuffer *fifo);
 
 #endif /* STRUCT_KFILE_FIFO */