/*
* $Log$
+ * Revision 1.8 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.7 2004/07/18 21:49:03 bernie
* Make CONFIG_SER_DEFBAUDRATE optional.
*
#ifdef CONFIG_KERNEL
#include <kern/proc.h>
#endif
-#if defined(CONFIG_SER_TXTIMEOUT) || defined(CONFIG_SER_RXTIMEOUT)
+#if CONFIG_SER_TXTIMEOUT != -1 || CONFIG_SER_RXTIMEOUT != -1
#include <drv/timer.h>
#endif
{
if (fifo_isfull_locked(&port->txfifo))
{
-#ifdef CONFIG_SER_TXTIMEOUT
+#if CONFIG_SER_TXTIMEOUT != -1
time_t start_time = timer_gettick();
#endif
/* Give up timeslice to other processes. */
proc_switch();
#endif
-#ifdef CONFIG_SER_TXTIMEOUT
+#if CONFIG_SER_TXTIMEOUT != -1
if (timer_gettick() - start_time >= port->txtimeout)
{
port->status |= SERRF_TXTIMEOUT;
if (fifo_isempty_locked(&port->rxfifo))
{
-#ifdef CONFIG_SER_RXTIMEOUT
+#if CONFIG_SER_RXTIMEOUT != -1
time_t start_time = timer_gettick();
#endif
/* Wait while buffer is empty */
do
{
-#ifdef CONFIG_KERN_SCHED
+#if defined(CONFIG_KERN_SCHED) && CONFIG_KERN_SCHED
/* Give up timeslice to other processes. */
proc_switch();
#endif
-#ifdef CONFIG_SER_RXTIMEOUT
+#if CONFIG_SER_RXTIMEOUT != -1
if (timer_gettick() - start_time >= port->rxtimeout)
{
port->status |= SERRF_RXTIMEOUT;
}
+#if CONFIG_SER_GETS
/*!
* Read a line long at most as size and puts it
* in buf.
/*!
- * Read a line long at most as size and puts it
+ * Read a line long at most as size and put it
* in buf, with optional echo.
- * \return number of chars read or EOF in case
+ *
+ * \return number of chars read, or EOF in case
* of error.
*/
int ser_gets_echo(struct Serial *port, char *buf, int size, bool echo)
for (;;)
{
if ((c = ser_getchar(port)) == EOF)
+ {
+ buf[i] = '\0';
return -1;
+ }
+
/* FIXME */
if (c == '\r' || c == '\n' || i >= size-1)
{
return i;
}
+#endif /* !CONFIG_SER_GETS */
/*!
}
+#if CONFIG_PRINTF
/*!
* Formatted write
*/
return len;
}
+#endif /* CONFIG_PRINTF */
-#if defined(CONFIG_SER_RXTIMEOUT) || defined(CONFIG_SER_TXTIMEOUT)
+
+#if CONFIG_SER_RXTIMEOUT != -1 || CONFIG_SER_TXTIMEOUT != -1
void ser_settimeouts(struct Serial *port, time_t rxtimeout, time_t txtimeout)
{
port->rxtimeout = rxtimeout;
port->txtimeout = txtimeout;
}
-#endif /* defined(CONFIG_SER_RXTIMEOUT) || defined(CONFIG_SER_TXTIMEOUT) */
+#endif /* CONFIG_SER_RXTIMEOUT || CONFIG_SER_TXTIMEOUT */
void ser_setbaudrate(struct Serial *port, unsigned long rate)
*/
void ser_purge(struct Serial *ser)
{
- fifo_flush(&ser->rxfifo);
- fifo_flush(&ser->txfifo);
+ fifo_flush_locked(&ser->rxfifo);
+ fifo_flush_locked(&ser->txfifo);
+}
+
+/*!
+ * Wait until all pending output is completely
+ * transmitted to the other end.
+ *
+ * \note The current implementation only checks the
+ * software transmission queue. Any hardware
+ * FIFOs are ignored.
+ */
+void ser_drain(struct Serial *ser)
+{
+ while(!fifo_isempty(&ser->txfifo))
+ {
+#if defined(CONFIG_KERN_SCHED) && CONFIG_KERN_SCHED
+ /* Give up timeslice to other processes. */
+ proc_switch();
+#endif
+ }
}
struct Serial *port;
ASSERT(unit < countof(ser_handles));
-
port = &ser_handles[unit];
ASSERT(!port->is_open);
+ DB(port->is_open = true;)
port->unit = unit;
- port->is_open = true;
/* Initialize circular buffer */
fifo_init(&port->rxfifo, port->rxbuffer, sizeof(port->rxbuffer));
port->hw->table->init(port->hw, port);
/* Set default values */
-#if defined(CONFIG_SER_RXTIMEOUT) || defined(CONFIG_SER_TXTIMEOUT)
+#if CONFIG_SER_RXTIMEOUT != -1 || CONFIG_SER_TXTIMEOUT != -1
ser_settimeouts(port, CONFIG_SER_RXTIMEOUT, CONFIG_SER_TXTIMEOUT);
#endif
-#if defined(CONFIG_SER_DEFBAUDRATE)
+#if CONFIG_SER_DEFBAUDRATE
ser_setbaudrate(port, CONFIG_SER_DEFBAUDRATE);
#endif
void ser_close(struct Serial *port)
{
ASSERT(port->is_open);
+ DB(port->is_open = false;)
- port->is_open = false;
port->hw->table->cleanup(port->hw);
port->hw = NULL;
}
/*
* $Log$
+ * 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.
*
#ifndef DRV_SER_H
#define DRV_SER_H
-#include "compiler.h"
#include <mware/fifobuf.h>
-#include "config.h"
+#include <drv/kdebug.h>
+#include <compiler.h>
+#include <config.h>
/*!
* \name Serial Error/status flags
*/
enum
{
-#if defined(__AVR_ATmega64__)
+#if defined(__AVR_ATmega64__) || defined(__AVR_ATmega128__)
SER_UART0,
SER_UART1,
SER_SPI,
/*! Physical port number */
unsigned int unit;
- bool is_open;
+ DB(bool is_open;)
/*!
* \name FIFO transmit and receive buffers.
unsigned char rxbuffer[CONFIG_SER_RXBUFSIZE];
/* \} */
-#ifdef CONFIG_SER_RXTIMEOUT
+#if CONFIG_SER_RXTIMEOUT != -1
time_t rxtimeout;
#endif
-#ifdef CONFIG_SER_TXTIMEOUT
+#if CONFIG_SER_TXTIMEOUT != -1
time_t txtimeout;
#endif
/*! Holds the flags defined above. Will be 0 when no errors have occurred. */
serstatus_t status;
-
+
/*! Low-level interface to hardware. */
struct SerialHardware* hw;
};
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, time_t rxtimeout, time_t txtimeout);
extern void ser_purge(struct Serial *port);
-
-#if defined(CONFIG_SER_RXTIMEOUT) || defined(CONFIG_SER_TXTIMEOUT)
- extern void ser_settimeouts(struct Serial *port, time_t rxtimeout, time_t txtimeout);
-#endif
+extern void ser_drain(struct Serial *port);
extern struct Serial *ser_open(unsigned int unit);
extern void ser_close(struct Serial *port);