UART.h File Reference

---

Detailed Description

Defines and prototypes for UART.c.

Application note:

AVR064: A Temperature Monitoring System with LCD Output

Documentation:

For comprehensive code documentation, supported compilers, compiler settings and supported devices see readme.html

Author:

Atmel Corporation: http://www.atmel.com
Support email: avr@atmel.com

Name

RELEASE_1_1

Revision

1.3

RCSfile

UART.h,v

Date

2006/02/16 18:11:22

Definition in file UART.h.

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
unsigned char	HEX2ASCII (unsigned char)
	Converts a Hex-byte to 2 or 3 decimal-bytes.
void	Send_TX_data (void)
	Send data from the TransmitBuffer.
void	Store_RX_data (void)
	Convert from ASCII to HEX and store data from the ReceiveBuffer to the SRAM locations.
void	UART_init (unsigned char)
	Initialise the UART.

---

Function Documentation

unsigned char HEX2ASCII (  unsigned char  Hex  )

Converts a Hex-byte to 2 or 3 decimal-bytes. Parameters: Hex  - the Hex-byte to be converted Returns: Number of decimal-bytes and ASCII-converted hex in Dec_L, Dec_M and possibly Dec_H Definition at line 150 of file UART.c. References Dec_H, Dec_L, and Dec_M. Referenced by Send_TX_data(). { unsigned char Nr_ASCII_bytes = 2; Dec_L = 0; //clear decimal-bytes Dec_M = 0; Dec_H = 0; while(Hex) // loop until the Hex is zero { Dec_L = Hex; // store decimal-byte to Dec_L Hex -= 10; // subtract 10 from the Hex-byte if(!(SREG & 0x01)) // if carry flag is not set { Dec_M++; // incrase Dec_M-byte if(Dec_M > 9) // if Dec_M-byte over 100 decimal { Dec_M = 0; // clear Dec_M Dec_H++; // increase Dec_H } if(!Hex) // if the Hex is zero Dec_L = 0; // clear Dec_L } else Hex = 0; } Dec_L += 0x30; // add 0x30 to get the right ascii-value Dec_M += 0x30; // add 0x30 to get the right ascii-value if(Dec_H) // if over 100d { Dec_H += 0x30; // add 0x30 to get the right ascii-value Nr_ASCII_bytes++; // increase number of bytes } return Nr_ASCII_bytes; // return number of bytes }

void Send_TX_data (  void   )

Send data from the TransmitBuffer. Definition at line 96 of file UART.c. References Bytes_to_send, Dec_L, HEX2ASCII(), HOUR, Nr_of_hex_bytes_to_send, REVISION_H, REVISION_L, sPreamble, TransmitBuffer, and TX_byte_nr. Referenced by main(). { unsigned char Nr_bytes_in_TX_buffer; unsigned char Cnt; unsigned char Nr_ASCII_bytes; if(!(UCSR0B & 0x20)) // do not make a new transmit-buffer if there's an on-going transmition (UDRIE-bit is set) { //FILL THE TRANSMITBUFFER WITH NEW DATA Nr_bytes_in_TX_buffer = 0; // clear number of bytes in buffer // load preamble byte in the transmit-buffer while(sPreamble[Nr_bytes_in_TX_buffer]) { TransmitBuffer[Nr_bytes_in_TX_buffer] = sPreamble[Nr_bytes_in_TX_buffer]; //put the preamble to the Transmit buffer Nr_bytes_in_TX_buffer++; }// finished loading the preamble byte Cnt = 0; // clear "Cnt", which is used to count the number of bytes loaded from SRAM in the loop below // load data bytes in the transmit-buffer while(Cnt < Nr_of_hex_bytes_to_send) // loop until "Cnt" is equal to "Nr_of_hex_bytes_to_send { TransmitBuffer[Nr_bytes_in_TX_buffer++] = 0x20; // add one space character Nr_ASCII_bytes = HEX2ASCII(*(&HOUR + Cnt++)); // format Hex-byte to ACSII data-bytes while(Nr_ASCII_bytes) // loop while there's ASCII to left { Nr_ASCII_bytes--; // decrement "Nr_ASCII_bytes" TransmitBuffer[Nr_bytes_in_TX_buffer++] = *(&Dec_L + Nr_ASCII_bytes); // (hopefully) load ASCII-bytes in the transmit-buffer } }// finished loading data bytes in the transmit-buffer TransmitBuffer[Nr_bytes_in_TX_buffer++] = 0x20; // add one space character TransmitBuffer[Nr_bytes_in_TX_buffer++] = REVISION_H; // add the revisions number in the transmit packet TransmitBuffer[Nr_bytes_in_TX_buffer++] = REVISION_L; // add the revisions number in the transmit packet TransmitBuffer[Nr_bytes_in_TX_buffer++] = 0x0D; // load ASCII for carriage return TransmitBuffer[Nr_bytes_in_TX_buffer++] = 0x0A; // load ASCII for line feed TX_byte_nr = 0; // no bytes sent Bytes_to_send = Nr_bytes_in_TX_buffer; // set number of bytes to send = nr_bytes_in-TX_buffer UCSR0B |= (1<<UDRIE0); // Enable UDRE interrupt (starts transfer) } } Here is the call graph for this function:

void Store_RX_data (  void   )

Convert from ASCII to HEX and store data from the ReceiveBuffer to the SRAM locations. Definition at line 58 of file UART.c. References FALSE, HOUR, ReceiveBuffer, and RX_Packet_complete. Referenced by main(). { unsigned char ASCII_Cnt = 0; // variable to count the number of ascii-bytes unsigned char HEX_Cnt = 0; // variable to count the number of Hex-bytes unsigned char HEX_byte; // variable to store the Hex-byte // loop until the Packet is converted from ascii to Hex and loaded in the correct places in SRAM while(RX_Packet_complete) { HEX_byte = 0; // clear "HEX_byte" // loop to convert ASCII to Hex // it will loop until a ascii space charater (0x20) or a ascii line feed (0x0D) appears while((ReceiveBuffer[ASCII_Cnt] != 0x20) & (ReceiveBuffer[ASCII_Cnt] != 0x0D)) { HEX_byte *= 10; // multiply Hex-byte with 10 HEX_byte += (ReceiveBuffer[ASCII_Cnt] - '0'); // store and add the ascii-byte ASCII_Cnt++; // increment ascii byte counter } // one ascii-byte has been converted to a Hex-byte if(ASCII_Cnt) // if any byte where converted { *(&HOUR + HEX_Cnt) = HEX_byte; // store the Hex-byte in SRAM HEX_Cnt++; // increment Hex-byte counter } if(ReceiveBuffer[ASCII_Cnt] == 0x20) // if the ascii byte was a space charater ASCII_Cnt++; // increment ascii byte counter else // else it means the end of packet { RX_Packet_complete = FALSE; // indicate that a new packet can be converted } } //the whole ReceiveBuffer has been converted Hex-bytes and stored in the SRAM-locations }

void UART_init (  unsigned char  BaudRate  )

Initialise the UART. Parameters: BaudRate  - used to set the baudrate of the UART Definition at line 45 of file UART.c. References RX_byte_nr. Referenced by Initialization(). { RX_byte_nr = 0; UBRR0L = BaudRate; // set the baudrate that is choosen UCSR0A = (1<<U2X0); // double the USART Transmission Speed UCSR0B = (1<<RXCIE0) | (1<<TXCIE0) | (1<<RXEN0) | (1<<TXEN0); // enable Receiver and Transmitter and interrupt UCSR0C = (3<<UCSZ00); // character size = 8 bit }

---