X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=bertos%2Fdrv%2Fser.h;h=c264811efcad05958226d482fe5c1a471b175127;hb=2a398044dd1d7b2af34a96c19ad378c25b546579;hp=c77053e4f3f7d0a34bec3a01086c5b660f6cbaa3;hpb=21f92eace872a7e12382cff9aa6e3364f25857aa;p=bertos.git diff --git a/bertos/drv/ser.h b/bertos/drv/ser.h index c77053e4..c264811e 100644 --- a/bertos/drv/ser.h +++ b/bertos/drv/ser.h @@ -31,17 +31,24 @@ * * --> * - * \brief High level serial I/O API + * \brief High level serial I/O API. * * \version $Id$ * \author Bernie Innocenti + * + * $WIZ$ module_name = "ser" + * $WIZ$ module_depends = "kfile", "timer" + * $WIZ$ module_configuration = "bertos/cfg/cfg_ser.h" + * $WIZ$ module_hw = "bertos/hw/hw_ser.h" + * $WIZ$ module_supports = "not atmega103 and not atmega168 " + * $WIZ$ module_supports += "and not atmega32 and not atmega8" */ #ifndef DRV_SER_H #define DRV_SER_H #include -#include +#include #include #if OS_HOSTED @@ -92,11 +99,11 @@ /** * \name LSB or MSB first data order for SPI driver. - * \{ + * + * $WIZ$ ser_order_bit = "SER_MSB_FIRST", "SER_LSB_FIRST" */ #define SER_MSB_FIRST 0 #define SER_LSB_FIRST 1 -/*\}*/ /** * \name Parity settings for ser_setparity(). @@ -112,6 +119,22 @@ /*\}*/ +/** + * \def CONFIG_SER_STROBE + * + * This is a debug facility that can be used to + * monitor SER interrupt activity on an external pin. + * + * To use strobes, redefine the macros SER_STROBE_ON, + * SER_STROBE_OFF and SER_STROBE_INIT and set + * CONFIG_SER_STROBE to 1. + */ +#if !defined(CONFIG_SER_STROBE) || !CONFIG_SER_STROBE + #define SER_STROBE_ON do {/*nop*/} while(0) + #define SER_STROBE_OFF do {/*nop*/} while(0) + #define SER_STROBE_INIT do {/*nop*/} while(0) +#endif + struct SerialHardware; /** Human-readable serial error descriptions */ @@ -120,6 +143,9 @@ extern const char * const serial_errors[8]; /** Serial handle structure */ typedef struct Serial { + /** Serial have a KFile struct implementation **/ + KFile fd; + /** Physical port number */ unsigned int unit; @@ -152,11 +178,6 @@ typedef struct Serial struct SerialHardware* hw; } Serial; -typedef struct SerialKFile -{ - KFile fd; - Serial *ser; -} SerialKFile; /** * ID for serial. @@ -164,26 +185,26 @@ typedef struct SerialKFile #define KFT_SERIAL MAKE_ID('S', 'E', 'R', 'L') -INLINE SerialKFile * SERIALKFILE(KFile *fd) +INLINE Serial * SERIAL_CAST(KFile *fd) { ASSERT(fd->_type == KFT_SERIAL); - return (SerialKFile *)fd; + return (Serial *)fd; } /* Function prototypes */ //extern int ser_getchar_nowait(struct Serial *port); -void ser_setbaudrate(struct SerialKFile *fd, unsigned long rate); -void ser_setparity(struct SerialKFile *fd, int parity); -void ser_settimeouts(struct SerialKFile *fd, mtime_t rxtimeout, mtime_t txtimeout); -void ser_resync(struct SerialKFile *fd, mtime_t delay); -int ser_getchar_nowait(struct SerialKFile *fd); - -void ser_purgeRx(struct SerialKFile *fd); -void ser_purgeTx(struct SerialKFile *fd); -void ser_purge(struct SerialKFile *fd); -void ser_init(struct SerialKFile *fds, unsigned int unit); -void spimaster_init(SerialKFile *fds, unsigned int unit); +void ser_setbaudrate(struct Serial *fd, unsigned long rate); +void ser_setparity(struct Serial *fd, int parity); +void ser_settimeouts(struct Serial *fd, mtime_t rxtimeout, mtime_t txtimeout); +void ser_resync(struct Serial *fd, mtime_t delay); +int ser_getchar_nowait(struct Serial *fd); + +void ser_purgeRx(struct Serial *fd); +void ser_purgeTx(struct Serial *fd); +void ser_purge(struct Serial *fd); +void ser_init(struct Serial *fds, unsigned int unit); +void spimaster_init(Serial *fds, unsigned int unit); /**