ser_avr.c File Reference

AVR UART and SPI I/O driver (Implementation). More...

#include "hw/hw_ser.h"
#include "hw/hw_cpu.h"
#include "cfg/cfg_ser.h"
#include <cfg/macros.h>
#include <cfg/debug.h>
#include <drv/ser.h>
#include <drv/ser_p.h>
#include <drv/timer.h>
#include <struct/fifobuf.h>
#include <avr/io.h>
#include <avr/signal.h>

Go to the source code of this file.


Data Structures

struct  AvrSerial
 Internal hardware state structure. More...

Defines

Hardware handshake (RTS/CTS).
#define RTS_ON   do {} while (0)
#define RTS_OFF   do {} while (0)
#define IS_CTS_ON   true
#define EIMSKF_CTS   0
 Dummy value, must be overridden.
Overridable serial bus hooks
These can be redefined in hw.h to implement special bus policies such as half-duplex, 485, etc.

  TXBEGIN      TXCHAR      TXEND  TXOFF
    |   __________|__________ |     |
    |   |   |   |   |   |   | |     |
    v   v   v   v   v   v   v v     v
 ______  __  __  __  __  __  __  ________________
       \/  \/  \/  \/  \/  \/  \/
 ______/\__/\__/\__/\__/\__/\__/


#define SER_UART0_BUS_TXINIT
 Default TXINIT macro - invoked in uart0_init().
#define SER_UART0_BUS_TXBEGIN
 Invoked before starting a transmission.
#define SER_UART0_BUS_TXCHAR(c)
 Invoked to send one character.
#define SER_UART0_BUS_TXEND
 Invoked as soon as the txfifo becomes empty.
#define SER_UART0_BUS_TXOFF
 Invoked after the last character has been transmitted.
#define SER_UART1_BUS_TXINIT
#define SER_UART1_BUS_TXBEGIN
#define SER_UART1_BUS_TXCHAR(c)
#define SER_UART1_BUS_TXEND
#define SER_UART1_BUS_TXOFF

Functions

 SIGNAL (USART0_UDRE_vect)
 Serial 0 TX interrupt handler.
 SIGNAL (SIG_UART0_TRANS)
 Serial port 0 TX complete interrupt handler.
 SIGNAL (USART0_RX_vect)
 Serial 0 RX complete interrupt handler.
 SIGNAL (SIG_SPI)
 SPI interrupt handler.

Detailed Description

AVR UART and SPI I/O driver (Implementation).

Version:
Id
ser_avr.c 1761 2008-08-29 20:37:03Z bernie

Author:
Bernie Innocenti <bernie@codewiz.org>

Stefano Fedrigo <aleph@develer.com>

Definition in file ser_avr.c.

Define Documentation

#define SER_UART0_BUS_TXBEGIN

Value:

do { \
        UCSR0B = BV(BIT_RXCIE0) | BV(BIT_UDRIE0) | BV(BIT_RXEN0) | BV(BIT_TXEN0); \
    } while (0)
Invoked before starting a transmission.

  • Enable both the receiver and the transmitter
  • Enable both the RX complete and UDR empty interrupts

Definition at line 139 of file ser_avr.c.

#define SER_UART0_BUS_TXEND

Value:

do { \
        UCSR0B = BV(BIT_RXCIE0) | BV(BIT_RXEN0) | BV(BIT_TXEN0); \
    } while (0)
Invoked as soon as the txfifo becomes empty.

  • Keep both the receiver and the transmitter enabled
  • Keep the RX complete interrupt enabled
  • Disable the UDR empty interrupt

Definition at line 161 of file ser_avr.c.

#define SER_UART0_BUS_TXINIT

Value:

do { \
        UCSR0B = BV(BIT_RXCIE0) | BV(BIT_RXEN0) | BV(BIT_TXEN0); \
    } while (0)
Default TXINIT macro - invoked in uart0_init().

  • Enable both the receiver and the transmitter
  • Enable only the RX complete interrupt

Definition at line 127 of file ser_avr.c.

#define SER_UART0_BUS_TXOFF

Invoked after the last character has been transmitted.

The default is no action.

Definition at line 175 of file ser_avr.c.

#define SER_UART1_BUS_TXBEGIN

Value:

do { \
        UCSR1B = BV(BIT_RXCIE1) | BV(BIT_UDRIE1) | BV(BIT_RXEN1) | BV(BIT_TXEN1); \
    } while (0)
See also:
SER_UART0_BUS_TXBEGIN

Definition at line 187 of file ser_avr.c.

#define SER_UART1_BUS_TXCHAR ( c   ) 

Value:

do { \
        UDR1 = (c); \
    } while (0)
See also:
SER_UART0_BUS_TXCHAR

Definition at line 193 of file ser_avr.c.

#define SER_UART1_BUS_TXEND

Value:

do { \
        UCSR1B = BV(BIT_RXCIE1) | BV(BIT_RXEN1) | BV(BIT_TXEN1); \
    } while (0)
See also:
SER_UART0_BUS_TXEND

Definition at line 199 of file ser_avr.c.

#define SER_UART1_BUS_TXINIT

Value:

do { \
        UCSR1B = BV(BIT_RXCIE1) | BV(BIT_RXEN1) | BV(BIT_TXEN1); \
    } while (0)
See also:
SER_UART0_BUS_TXINIT

Definition at line 181 of file ser_avr.c.

#define SER_UART1_BUS_TXOFF

See also:
SER_UART0_BUS_TXOFF

Definition at line 210 of file ser_avr.c.

Function Documentation

SIGNAL ( USART0_RX_vect   ) 

Serial 0 RX complete interrupt handler.

This handler is interruptible. Interrupt are reenabled as soon as recv complete interrupt is disabled. Using INTERRUPT() is troublesome when the serial is heavily loaded, because an interrupt could be retriggered when executing the handler prologue before RXCIE is disabled.

Note:
The code that re-enables interrupts is commented out because in some nasty cases the interrupt is retriggered. This is probably due to the RXC flag being set before RXCIE is cleared. Unfortunately the RXC flag is read-only and can't be cleared by code.

Definition at line 821 of file ser_avr.c.

SIGNAL ( SIG_UART0_TRANS   ) 

Serial port 0 TX complete interrupt handler.

This IRQ is usually disabled. The UDR-empty interrupt enables it when there's no more data to transmit. We need to wait until the last character has been transmitted before switching the 485 transceiver to receive mode.

The txfifo might have been refilled by putchar() while we were waiting for the transmission complete interrupt. In this case, we must restart the UDR empty interrupt, otherwise we'd stop the serial port with some data still pending in the buffer.

Definition at line 725 of file ser_avr.c.