X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=drv%2Fser.h;h=d74c2235e94c3d70d31c9a249aad508c9c279bce;hb=HEAD;hp=6a6264241def7d8f0afd86d7c88f87ec72cfffb6;hpb=78a239daa38e9241e17d78dfe9ada7e438eab630;p=bertos.git diff --git a/drv/ser.h b/drv/ser.h deleted file mode 100644 index 6a626424..00000000 --- a/drv/ser.h +++ /dev/null @@ -1,272 +0,0 @@ -/** - * \file - * - * - * \brief High level serial I/O API - * - * \version $Id$ - * \author Bernardo Innocenti - */ - -/*#* - *#* $Log$ - *#* Revision 1.36 2007/01/29 11:30:30 batt - *#* Reimplement ser_clearstatus as a macro. - *#* - *#* Revision 1.35 2007/01/27 20:47:12 batt - *#* Add clear status. - *#* - *#* Revision 1.34 2006/11/20 15:07:40 batt - *#* Revert unneeded locked functions. - *#* - *#* Revision 1.33 2006/11/17 17:03:58 batt - *#* Implement ser_setstatus and ser_getstatus as functions to avoid race conditions. - *#* - *#* Revision 1.32 2006/11/17 16:01:12 batt - *#* Serial status MUST be volatile. - *#* - *#* Revision 1.31 2006/09/13 18:22:48 bernie - *#* Typo. - *#* - *#* Revision 1.30 2006/09/13 18:21:23 bernie - *#* Add configurable SPI pin mapping. - *#* - *#* Revision 1.29 2006/09/13 13:59:11 bernie - *#* Documentation fixes. - *#* - *#* Revision 1.28 2006/07/21 10:58:00 batt - *#* Use timer_clock() instead of obsolete timer_ticks(). - *#* - *#* Revision 1.27 2006/07/19 12:56:26 bernie - *#* Convert to new Doxygen style. - *#* - *#* Revision 1.26 2006/05/18 00:39:13 bernie - *#* Add struct Serial friendly typedef. - *#* - *#* Revision 1.25 2006/02/17 22:28:00 bernie - *#* Rename ser_emul.c to ser_posix.c. - *#* - *#* Revision 1.24 2006/02/17 22:23:06 bernie - *#* Update POSIX serial emulator. - *#* - *#* Revision 1.23 2005/11/27 23:33:40 bernie - *#* Use appconfig.h instead of cfg/config.h. - *#* - *#* Revision 1.22 2005/11/04 16:20:02 bernie - *#* Fix reference to README.devlib in header. - *#* - *#* Revision 1.21 2005/04/11 19:10:27 bernie - *#* Include top-level headers from cfg/ subdir. - *#* - *#* Revision 1.20 2005/01/22 04:20:01 bernie - *#* Reformat. - *#* - *#* Revision 1.19 2005/01/11 18:08:16 aleph - *#* Add missing include - *#* - *#* Revision 1.18 2004/12/08 08:57:17 bernie - *#* Rename time_t to mtime_t. - *#* - *#* Revision 1.17 2004/11/16 21:54:56 bernie - *#* Changes for SC Monoboard support. - *#* - *#* Revision 1.16 2004/10/19 11:48:05 bernie - *#* Reformat. - *#* - *#* Revision 1.15 2004/10/19 08:11:53 bernie - *#* SERRF_TX, SERRF_RX: New macros; Enhance documentation. - *#* - *#* Revision 1.14 2004/10/03 18:43:18 bernie - *#* Fix a nasty bug caused by confusion between old-style and new-style configuration macros. - *#* - *#* Revision 1.13 2004/09/14 21:04:57 bernie - *#* Don't vanely call kdebug.h. - *#* - *#* Revision 1.12 2004/09/06 21:40:50 bernie - *#* Move buffer handling in chip-specific driver. - *#* - *#* Revision 1.11 2004/08/25 14:12:08 rasky - *#* Aggiornato il comment block dei log RCS - *#* - *#* Revision 1.10 2004/08/24 16:20:48 bernie - *#* ser_read(): Make buffer argument void *#* for consistency with ANSI C and ser_write() - *#* - *#* Revision 1.9 2004/08/15 05:32:22 bernie - *#* ser_resync(): New function. - *#* - *#* Revision 1.8 2004/08/02 20:20:29 aleph - *#* Merge from project_ks - *#* - *#* Revision 1.7 2004/07/30 14:15:53 rasky - *#* Nuovo supporto unificato per detect della CPU - *#* - *#* Revision 1.6 2004/07/29 22:57:09 bernie - *#* ser_drain(): New function; Make Serial::is_open a debug-only feature; Switch to new-style CONFIG_* macros. - *#* - *#* Revision 1.5 2004/07/18 21:54:23 bernie - *#* Add ATmega8 support. - *#* - *#* Revision 1.4 2004/06/03 11:27:09 bernie - *#* Add dual-license information. - *#* - *#* Revision 1.3 2004/06/02 21:35:24 aleph - *#* Serial enhancements: interruptible receive handler and 8 bit serial status for AVR; remove volatile attribute to FIFOBuffer, useless for new fifobuf routens - *#* - *#* Revision 1.2 2004/05/23 18:21:53 bernie - *#* Trim CVS logs and cleanup header info. - *#* - *#*/ -#ifndef DRV_SER_H -#define DRV_SER_H - - -#include -#include - -#include CPU_HEADER(ser) - -#include - - - -/** - * \name Masks to group TX/RX errors. - * \{ - */ -#define SERRF_RX \ - ( SERRF_RXFIFOOVERRUN \ - | SERRF_RXTIMEOUT \ - | SERRF_RXSROVERRUN \ - | SERRF_PARITYERROR \ - | SERRF_FRAMEERROR \ - | SERRF_NOISEERROR) -#define SERRF_TX (SERRF_TXTIMEOUT) -/*\}*/ - -/** - * \name LSB or MSB first data order for SPI driver. - * \{ - */ -#define SER_MSB_FIRST 0 -#define SER_LSB_FIRST 1 -/*\}*/ - -/** - * \name Parity settings for ser_setparity(). - * - * \note Values are AVR-specific for performance reasons. - * Other processors should either decode them or - * redefine these macros. - * \{ - */ -#define SER_PARITY_NONE 0 -#define SER_PARITY_EVEN 2 -#define SER_PARITY_ODD 3 -/*\}*/ - - -struct SerialHardware; - -/** Human-readable serial error descriptions */ -extern const char * const serial_errors[8]; - -/** Serial handle structure */ -typedef struct Serial -{ - /** Physical port number */ - unsigned int unit; - -#ifdef _DEBUG - bool is_open; -#endif - - /** - * \name Transmit and receive FIFOs. - * - * Declared volatile because handled asinchronously by interrupts. - * - * \{ - */ - FIFOBuffer txfifo; - FIFOBuffer rxfifo; - /* \} */ - -#if CONFIG_SER_RXTIMEOUT != -1 - ticks_t rxtimeout; -#endif -#if CONFIG_SER_TXTIMEOUT != -1 - ticks_t txtimeout; -#endif - - /** Holds the flags defined above. Will be 0 when no errors have occurred. */ - volatile serstatus_t status; - - /** Low-level interface to hardware. */ - struct SerialHardware* hw; -} Serial; - - -/* Function prototypes */ -extern int ser_putchar(int c, struct Serial *port); -extern int ser_getchar(struct Serial *port); -extern int ser_getchar_nowait(struct Serial *port); - -extern int ser_write(struct Serial *port, const void *buf, size_t len); -extern int ser_read(struct Serial *port, void *buf, size_t size); - -extern int ser_print(struct Serial *port, const char *s); -extern int ser_printf(struct Serial *port, const char *format, ...) FORMAT(__printf__, 2, 3); - -extern int ser_gets(struct Serial *port, char *buf, int size); -extern int ser_gets_echo(struct Serial *port, char *buf, int size, bool echo); - -extern void ser_setbaudrate(struct Serial *port, unsigned long rate); -extern void ser_setparity(struct Serial *port, int parity); -extern void ser_settimeouts(struct Serial *port, mtime_t rxtimeout, mtime_t txtimeout); -extern void ser_resync(struct Serial *port, mtime_t delay); -extern void ser_purge(struct Serial *port); -extern void ser_drain(struct Serial *port); - -extern struct Serial *ser_open(unsigned int unit); -extern void ser_close(struct Serial *port); - -/** - * \name Additional functions implemented as macros - * - * \{ - */ -#define ser_getstatus(h) ((h)->status) -#define ser_setstatus(h, x) ((h)->status = (x)) -#define ser_clearstatus(h) ser_setstatus(h, 0) -/* \} */ - -#endif /* DRV_SER_H */