X-Git-Url: https://codewiz.org/gitweb?a=blobdiff_plain;f=drv%2Fser.c;h=0838bc1538855e6c58575d0c6107d16b2981c485;hb=2535cb94ec2183791128f8bbd109ca69a960cf78;hp=d920d9dec59f1cbe4327daf4671b351be9eb737f;hpb=c96294490251736a986bd6bbe26eb6d7b50d9760;p=bertos.git diff --git a/drv/ser.c b/drv/ser.c index d920d9de..0838bc15 100644 --- a/drv/ser.c +++ b/drv/ser.c @@ -85,33 +85,29 @@ #endif -/* Serial configuration parameters */ -#define SER_CTSDELAY 70 /**< CTS line retry interval (ms) */ -#define SER_TXPOLLDELAY 2 /**< Transmit buffer full retry interval (ms) */ -#define SER_RXPOLLDELAY 2 /**< Receive buffer empty retry interval (ms) */ - - struct Serial ser_handles[SER_CNT]; - /** - * Inserisce il carattere c nel buffer di trasmissione. - * Questa funzione mette il processo chiamante in attesa - * quando il buffer e' pieno. + * Insert \a c in tx FIFO buffer. + * \note This function will switch out the calling process + * if the tx buffer is full. If the buffer is full + * and \a port->txtimeout is 0 return EOF immediatly. * - * \return EOF in caso di errore o timeout, altrimenti - * il carattere inviato. + * \return EOF on error or timeout, \a c otherwise. */ static int ser_putchar(int c, struct Serial *port) { - //ASSERT_VALID_FIFO(&port->txfifo); if (fifo_isfull_locked(&port->txfifo)) { #if CONFIG_SER_TXTIMEOUT != -1 + /* If timeout == 0 we don't want to wait */ + if (port->txtimeout == 0) + return EOF; + ticks_t start_time = timer_clock(); #endif - /* Attende finche' il buffer e' pieno... */ + /* Wait while buffer is full... */ do { wdt_reset(); @@ -141,19 +137,22 @@ static int ser_putchar(int c, struct Serial *port) /** - * Preleva un carattere dal buffer di ricezione. - * Questa funzione mette il processo chiamante in attesa - * quando il buffer e' vuoto. L'attesa ha un timeout - * di ser_rxtimeout millisecondi. + * Fetch a character from the rx FIFO buffer. + * \note This function will switch out the calling process + * if the rx buffer is empty. If the buffer is empty + * and \a port->rxtimeout is 0 return EOF immediatly. * - * \return EOF in caso di errore o timeout, altrimenti - * il carattere ricevuto. + * \return EOF on error or timeout, \a c otherwise. */ static int ser_getchar(struct Serial *port) { if (fifo_isempty_locked(&port->rxfifo)) { #if CONFIG_SER_RXTIMEOUT != -1 + /* If timeout == 0 we don't want to wait for chars */ + if (port->rxtimeout == 0) + return EOF; + ticks_t start_time = timer_clock(); #endif /* Wait while buffer is empty */ @@ -185,9 +184,10 @@ static int ser_getchar(struct Serial *port) } /** - * Preleva un carattere dal buffer di ricezione. - * Se il buffer e' vuoto, ser_getchar_nowait() ritorna - * immediatamente EOF. + * Fetch a character from the rx FIFO buffer. + * If the buffer is empty, ser_getchar_nowait() returns + * EOF immediatly. + * \note Deprecated, use ser_getchar with rx_timeout set to 0. */ int ser_getchar_nowait(struct KFileSerial *fd) { @@ -199,6 +199,7 @@ int ser_getchar_nowait(struct KFileSerial *fd) } + /** * Read at most \a size bytes from \a port and put them in \a buf * @@ -364,6 +365,7 @@ static int ser_flush(struct KFile *fd) /** * Initialize a serial port. * + * \param fd KFile Serial struct interface. * \param unit Serial unit to open. Possible values are architecture dependant. */ static struct Serial *ser_open(struct KFileSerial *fd, unsigned int unit)