LCD_functions.h File Reference

---

Detailed Description

Functions for LCD_functions.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

LCD_functions.h,v

Date

2006/02/16 18:11:22

Definition in file LCD_functions.h.

Go to the source code of this file.

Functions
void	LCD_update (void)
	Checks if the LCD is ready for new data.
void	LCDscrollMsg (void)
	Make a text-string scroll over the LCD-display. The text-string will scroll one step to the left each time this funciton is executed.
void	LCDsetupData (void)
	Set up the text to be displayed (if any).
void	LCDwriteData (void)
	Writes date from the Transmit Buffer to the LCD_displayData.

---

Function Documentation

void LCD_update (  void   )

Checks if the LCD is ready for new data. Definition at line 75 of file LCD_functions.c. References Colon, FALSE, LCD_AllSegments(), LCD_Menu1, LCD_SET_COLON, LCD_status, LCDscrollMsg(), LCDwriteData(), NumberOfScroll, TRUE, _LCD_status::updateComplete, and _LCD_status::updateRequired. Referenced by main(). { if( LCD_status.updateComplete ) // if the LCD is ready for new data { if( NumberOfScroll ) //if there is a text to be scrolled { LCD_status.updateRequired = FALSE; // block LCD updating while updating the LCD_displaydata LCD_AllSegments(FALSE); // disable all segments LCDscrollMsg(); // call the scroll function LCD_status.updateComplete = FALSE; // indicate that new data are not presented on the LCD LCD_status.updateRequired = TRUE; // enable LCD_displayData to be lacthed to the LCD data Regs } else //else write the data from the Transmit Buffer { if( LCD_Menu1-1 < 5 ) // if not the CONTRAST is to be displayed { LCD_status.updateRequired = FALSE; // block LCD updating while updating the LCD_displaydata LCD_SET_COLON(Colon); // set/clear colons depending on the varibale Colon (TRUE/FALSE) LCDwriteData(); // call the write data funciton LCD_status.updateComplete = FALSE; // indicate that new data are not presented on the LCD LCD_status.updateRequired = TRUE; // enable LCD_displayData to be lacthed to the LCD data Regs } else // else set all the segments LCD_AllSegments(TRUE); } } } Here is the call graph for this function:

void LCDscrollMsg (  void   )

Make a text-string scroll over the LCD-display. The text-string will scroll one step to the left each time this funciton is executed. Definition at line 183 of file LCD_functions.c. References Clear_cnt, LCD_WriteDigit(), String, and String_cnt. Referenced by LCD_update(). { unsigned char LCD_digit_cnt; // keeps track of which of the six LCD-digits to write unsigned char Temp; // local storage for the global String_cnt if(*(String + String_cnt)) // until the string ends { LCD_digit_cnt = 8; // start with writing to the last digit Temp = String_cnt; // store the global String_cnt to the local Temp while(LCD_digit_cnt > 2) // while the all digits on LCD has been written once { LCD_digit_cnt--; // decrease the digit counter if(Temp != 0xFF) // if the Temp is not 0xFF, not end of the string LCD_WriteDigit(*(String + Temp--), LCD_digit_cnt); //write a character and decrease the Temp else // else it is the end of the string LCD_WriteDigit( ' ', LCD_digit_cnt ); // fill the digit with a ASCII-space } String_cnt++; // increment the global string counter Clear_cnt = (String_cnt + 6); // set the } else if(Clear_cnt - String_cnt) // else when the whole string has been displayed, make the string fade out { // by filling the display with ASCII-space ' '(0x20) Clear_cnt--; // decrease number of characters left to fade out LCD_digit_cnt = 8; Temp = 1; while(LCD_digit_cnt > 2) // while the all digits on LCD has been written once { LCD_digit_cnt--; // decrease the digit counter if( (LCD_digit_cnt - 2) >= (Clear_cnt - String_cnt)) // if the digit counter is greater or equal to the number characters that are cleared (' ') minus { // the number of characters left in the string LCD_WriteDigit( ' ' , LCD_digit_cnt ); // write a ASCII-space this LCD-digit } else { LCD_WriteDigit( *(String + (String_cnt - Temp)) , LCD_digit_cnt ); // write the remaining charaters in the string Temp++; // increment the temporary string counter } } } else // when the whole string has been scrolled one time { String_cnt = 0; // clear the global string counter if(NumberOfScroll != 0xFF) // if not infinite scrolling is enabled NumberOfScroll--; // drecrease the number of times to scroll the string } } Here is the call graph for this function:

void LCDsetupData (  void   )

Set up the text to be displayed (if any). Definition at line 151 of file LCD_functions.c. References Colon, FALSE, LCD_Menu1, LCD_Menu2, LCD_Menu3, NumberOfScroll, String, String_cnt, String_Table, and TRUE. Referenced by Initialization(). { if( !LCD_Menu1 ) // if LCD_Menu1 is not active { String_cnt = 0; // set String_cnt to point a the first character String = "STK502 example application for ATmega169"; NumberOfScroll = 0xFF; // enable infnite scrolling } else if( !LCD_Menu2 ) // if LCD_Menu2 is not active { NumberOfScroll = 1; // scroll the new text only once String = String_Table[LCD_Menu1-1]; // load the new text to be scrolled String_cnt = 0; // set String_cnt to point a the first character Colon = TRUE; // enable the colons if( LCD_Menu1 == 3 | LCD_Menu1 == 5 ) // if displaying the Set point or the offset Colon = FALSE; } else if( !LCD_Menu3 ) // if LCD_Menu3 is not active { Colon = TRUE; // enable the colons } else // if LCD_Menu3 is active { Colon = FALSE; // disable the colons } }

void LCDwriteData (  void   )

Writes date from the Transmit Buffer to the LCD_displayData. Definition at line 106 of file LCD_functions.c. References LCD_Menu1, and LCD_WriteDigit(). Referenced by LCD_update(). { unsigned char LCD_digit_cnt = 8; // counter to LCD Segments if( ( LCD_Menu1 > 2 ) && ( LCD_Menu1 < 6 ) ) // if Set Point, Temperature or Offset is to be displayed { // set the "degree Celsius". LCD_WriteDigit( 'C' , 7 ); // write ".C" to the last digits LCD_WriteDigit( '.' , 6 ); LCD_digit_cnt = 6; // decrease the number of digits to write } while( LCD_digit_cnt > 2 ) // while there are number of digits left to wrtie { LCD_digit_cnt--; // decrease the number of digits to write if( LCD_Menu1 > 3 ) // if displaying the temperature or offset LCD_status.blinkLCD = FALSE; // turn off the possibility to blink if( LCD_status.blinkLCD && ( LCD_Menu1 == 3 ) && LCD_Menu2 ) // if the Set Point is displayed and Menu2 is active { LCD_WriteDigit( ' ', LCD_digit_cnt ); // blink all the digits when Menu2 and LCD_status.blinkLCd is active } else if( LCD_status.blinkLCD && ( BlinkTable[LCD_Menu2-1][LCD_digit_cnt - 2] ) && LCD_Menu2) // if LCD_status.blinkLCd and Menu2 is active { LCD_WriteDigit( ' ', LCD_digit_cnt ); // blink the digit that is to be written according to BlinkTable[] } else { if( !(DataTable[LCD_Menu1-1][LCD_digit_cnt - 2]) ) // if the DataTable contains 0 { if(TCCR1A & 0x80) // check the TCCR1A register to find out if the Heater or Cooler pin is active LCD_WriteDigit( '-' , LCD_digit_cnt ); // if the Heater pin is active, write '-' else LCD_WriteDigit( '+' , LCD_digit_cnt ); // if the Cooler pin is active, write '+' } else // write data from the transmitbuffer LCD_WriteDigit( TransmitBuffer[DataTable[LCD_Menu1-1][LCD_digit_cnt - 2]] , LCD_digit_cnt ); } } } Here is the call graph for this function:

---