mware/xmodem.h

   1 /**
   2  * \file
   3  * <!--
   4  * Copyright 2004 Develer S.r.l. (http://www.develer.com/)
   5  * Copyright 1999, 2001 Bernardo Innocenti <bernie@develer.com>
   6  * This file is part of DevLib - See README.devlib for information.
   7  * -->
   8  * \brief X-Modem serial transmission protocol (interface)
   9  *
  10  * \version $Id$
  11  * \author Bernardo Innocenti <bernie@develer.com>
  12  * \author Francesco Sacchi <batt@develer.com>
  13  */
  14
  15 /*#*
  16  *#* $Log$
  17  *#* Revision 1.6  2007/06/07 09:10:44  batt
  18  *#* Fix some todos.
  19  *#*
  20  *#* Revision 1.5  2006/07/19 12:56:28  bernie
  21  *#* Convert to new Doxygen style.
  22  *#*
  23  *#* Revision 1.4  2005/11/04 16:20:02  bernie
  24  *#* Fix reference to README.devlib in header.
  25  *#*
  26  *#* Revision 1.3  2004/08/25 14:12:09  rasky
  27  *#* Aggiornato il comment block dei log RCS
  28  *#*
  29  *#* Revision 1.2  2004/08/15 05:31:46  bernie
  30  *#* Add an #error to spread some FUD about the quality of this module;
  31  *#* Add a few TODOs from Rasky's review;
  32  *#* Update to the new drv/ser.c API;
  33  *#* Move FlushSerial() to drv/ser.c and generalize.
  34  *#*
  35  *#* Revision 1.1  2004/08/11 19:54:22  bernie
  36  *#* Import XModem protocol into DevLib.
  37  *#*
  38  *#*/
  39 #ifndef MWARE_XMODEM_H
  40 #define MWARE_XMODEM_H
  41 #include <cfg/compiler.h>
  42 #include "kfile.h"
  43
  44 /**
  45  * Called to know if we want to abort data tranfer.
  46  * Redefine to whatever you need.
  47  * \{
  48  */
  49 #ifndef XMODEM_CHECK_ABORT
  50 #define XMODEM_CHECK_ABORT (false)
  51 #endif
  52 /*\}*/
  53
  54
  55 /**
  56  * Called to printf progress messages.
  57  * Default to kprintf debug, redefine to whatever you need.
  58  * \{
  59  */
  60 #ifndef XMODEM_PROGRESS
  61 #define XMODEM_PROGRESS(msg, ...) kprintf(msg, ## __VA_ARGS__)
  62 #endif
  63
  64
  65 /* fwd decl */
  66 struct Serial;
  67
  68 bool xmodem_recv(struct Serial *port, KFile *fd);
  69 bool xmodem_send(struct Serial *port, KFile *fd);
  70
  71 #endif /* MWARE_XMODEM_H */