Difference between revisions of "GLCD"

(Created page with "category:Library_Reference =GLCD= ==GLCD_Init== {|{{Widget:LibCol}} {{#Widget:LibTable}} |- |Defination ||void GLCD_Init () |- | Input Arguments || none |- | Return...")
 
m
 
(6 intermediate revisions by the same user not shown)
Line 14: Line 14:
 
| Return Value|| none
 
| Return Value|| none
 
|-
 
|-
−
| Description ||This function is used to initialize the lcd.<br />It initializes the LCD for selected mode(4/8-bit) and Type(16x2/16x1 etc)
+
| Description ||This function is used to initialize the glcd.
 
|-
 
|-
−
| Usage ||GLCD_Init() //Initialize GLCD <br />GLCD_Init(); //Initialize 2x16 LCD in 4-bit Mode<br />GLCD_Init(4,4,16) //Initialize 4x16 LCD in 8-bit Mode
+
| Usage ||GLCD_Init() //Initialize GLCD  
 
|}
 
|}
  
Line 25: Line 25:
 
|Defination || void GLCD_CmdWrite( uint8_t var_lcdCmd_u8)
 
|Defination || void GLCD_CmdWrite( uint8_t var_lcdCmd_u8)
 
|-
 
|-
−
| Input Arguments || 8-bit command supported by LCD.
+
| Input Arguments || 8-bit command supported by GLCD.
 
|-
 
|-
 
| Return Value|| none
 
| Return Value|| none
 
|-
 
|-
−
| Description ||This function sends a command to LCD.<br />Some of the commonly used commands are defined in lcd.h.<br />For more commands refer the data sheet.<br />The behaviour is undefined if unsupported commands are sent.     
+
| Description ||This function sends a command to GLCD.<br />Some of the commonly used commands are defined in glcd.h.<br />For more commands refer the data sheet.<br />The behaviour is undefined if unsupported commands are sent.     
 
|-
 
|-
 
| Usage ||   
 
| Usage ||   
−
GLCD_CmdWrite(0x0c);                                      //Sets display On and Cursor Off<br />
+
GLCD_CmdWrite(0xB8);                                      //Sets cursor to first line<br />
−
GLCD_CmdWrite(CMD_DISPLAY_ON_CURSOR_OFF); //Recommended
+
GLCD_CmdWrite(FirstLineNumberAddress); //Recommended
 
|}
 
|}
  
Line 46: Line 46:
 
| Return Value|| none.
 
| Return Value|| none.
 
|-
 
|-
−
| Description ||This function clears the LCD and moves the cursor to beginning of first line
+
| Description ||This function clears the GLCD and moves the cursor to beginning of first line
 
|-
 
|-
 
| Usage ||  
 
| Usage ||  
Line 65: Line 65:
 
|-
 
|-
 
| Description ||This function moves the Cursor to beginning of the specified line. If the requested line number is out of range, it will not move the cursor.<br />
 
| Description ||This function moves the Cursor to beginning of the specified line. If the requested line number is out of range, it will not move the cursor.<br />
−
Note: The line numbers run from 1 to Maxlines.<br />To avoid the confusion the below enums has to be used for selecting lines.<br />For four line LCD the enums are as below:<br />
+
Note: The line numbers run from 1 to Maxlines.<br />To avoid the confusion the below enums has to be used for selecting lines.<br />For four line GLCD the enums are as below:<br />
 
*E_LcdLineOne<br />
 
*E_LcdLineOne<br />
 
*E_LcdLineTwo<br />
 
*E_LcdLineTwo<br />
Line 73: Line 73:
 
| Usage ||     
 
| Usage ||     
 
GLCD_GoToLine(1);                  //Moves the cursor to beginning of first line
 
GLCD_GoToLine(1);                  //Moves the cursor to beginning of first line
 +
 
GLCD_GoToLine(E_LcdLineOne); //Recommended usage
 
GLCD_GoToLine(E_LcdLineOne); //Recommended usage
 
|}
 
|}
−
 
−
 
−
 
  
 
==GLCD_GoToNextline==
 
==GLCD_GoToNextline==
Line 105: Line 103:
 
|-
 
|-
 
| Input Arguments ||<br />
 
| Input Arguments ||<br />
−
*row: line number(line1=1, line2=2)<br />For 2line LCD the I/P argument should be either 1 or 2.<br />
+
*row: line number(line1=1, line2=2)<br />For 2line GLCD the I/P argument should be either 1 or 2.<br />
−
*col: char number.<br />For 16-char LCD the I/P argument should be between 0-15.
+
*col: char number.<br />For 16-char GLCD the I/P argument should be between 0-15.
 
|-
 
|-
 
| Return Value|| none
 
| Return Value|| none
Line 128: Line 126:
 
| Return Value|| none
 
| Return Value|| none
 
|-
 
|-
−
| Description ||This function sends a character to be displayed on LCD.<br />Any valid ascii value can be passed to display the respective character
+
| Description ||This function sends a character to be displayed on GLCD.<br />Any valid ascii value can be passed to display the respective character
 
|-
 
|-
 
| Usage ||   
 
| Usage ||   
−
GLCD_DisplayChar(65);    //Displays 'A' on LCD<br />
+
GLCD_DisplayChar(65);    //Displays 'A' on GLCD<br />
−
GLCD_DisplayChar(0x41);  //Displays 'A' on LCD <br />
+
GLCD_DisplayChar(0x41);  //Displays 'A' on GLCD <br />
 
GLCD_DisplayChar('A');    //Recommended usage  
 
GLCD_DisplayChar('A');    //Recommended usage  
 
|}
 
|}
Line 192: Line 190:
 
| Input Arguments ||  
 
| Input Arguments ||  
 
*NumericSystem_et: Specifies type of number ENUM_BINARY(2),ENUM_DECIMAL(10), ENUM_Hex(16)
 
*NumericSystem_et: Specifies type of number ENUM_BINARY(2),ENUM_DECIMAL(10), ENUM_Hex(16)
−
*uint32_t: Number to be displayed on the LCD.
+
*uint32_t: Number to be displayed on the GLCD.
 
*uint8_t : Number of digits to be displayed
 
*uint8_t : Number of digits to be displayed
 
|-
 
|-
Line 269: Line 267:
 
==Usage Guide==
 
==Usage Guide==
 
<html>
 
<html>
−
<script src="https://gist.github.com/Amritach/f6623a13490f16d1ff6a.js"></script>
+
<script src="https://gist.github.com/Amritach/d383ab80738c7177ad79.js"></script>
 
</html>
 
</html>
 +
 +
{{DISQUS}}

Latest revision as of 18:09, 30 May 2015

GLCD

GLCD_Init

{{#Widget:LibTable}}
Defination void GLCD_Init ()
Input Arguments none
Return Value none
Description This function is used to initialize the glcd.
Usage GLCD_Init() //Initialize GLCD

GLCD_CmdWrite

{{#Widget:LibTable}}
Defination void GLCD_CmdWrite( uint8_t var_lcdCmd_u8)
Input Arguments 8-bit command supported by GLCD.
Return Value none
Description This function sends a command to GLCD.
Some of the commonly used commands are defined in glcd.h.
For more commands refer the data sheet.
The behaviour is undefined if unsupported commands are sent.
Usage

GLCD_CmdWrite(0xB8); //Sets cursor to first line
GLCD_CmdWrite(FirstLineNumberAddress); //Recommended

GLCD_Clear

{{#Widget:LibTable}}
Defination void GLCD_Clear()
Input Arguments none.
Return Value none.
Description This function clears the GLCD and moves the cursor to beginning of first line
Usage

GLCD_Clear(); // Clears the lcd and sets the cursor to beginning of the first line.


GLCD_GoToLine

{{#Widget:LibTable}}
Defination void GLCD_GoToLine(uint8_t var_lineNumber_u8)
Input Arguments uint8_t: Line number to move the cursor.
Return Value none
Description This function moves the Cursor to beginning of the specified line. If the requested line number is out of range, it will not move the cursor.

Note: The line numbers run from 1 to Maxlines.
To avoid the confusion the below enums has to be used for selecting lines.
For four line GLCD the enums are as below:

  • E_LcdLineOne
  • E_LcdLineTwo
  • E_LcdLineThree
  • E_LcdLineFour
Usage

GLCD_GoToLine(1); //Moves the cursor to beginning of first line

GLCD_GoToLine(E_LcdLineOne); //Recommended usage

GLCD_GoToNextline

{{#Widget:LibTable}}
Defination void GLCD_GoToNextLine()
Input Arguments none
Return Value none
Description This function moves the Cursor to beginning of the next line. If the cursor is on last line and NextLine command is issued then it will move the cursor to first line.
Usage

GLCD_GoToNextline(); //Moves the cursor to beginning of next line.



GLCD_SetCursor

{{#Widget:LibTable}}
Defination void GLCD_SetCursor(char var_lineNumber_u8,char var_charNumber_u8)
Input Arguments
  • row: line number(line1=1, line2=2)
    For 2line GLCD the I/P argument should be either 1 or 2.
  • col: char number.
    For 16-char GLCD the I/P argument should be between 0-15.
Return Value none
Description This function moves the Cursor to specified position.
  • Note:If the Input(Line/Char number) are out of range then no action will be taken
Usage

GLCD_SetCursor(1,10); //Moves the cursor to 1st line 11th char. GLCD_SetCursor(5,10); //No action taken as line 5 is out of range

GLCD_DisplayChar

{{#Widget:LibTable}}
Defination void GLCD_DisplayChar( char var_lcdData_u8)
Input Arguments uint8_t: ASCII value of the char to be displayed.
Return Value none
Description This function sends a character to be displayed on GLCD.
Any valid ascii value can be passed to display the respective character
Usage

GLCD_DisplayChar(65); //Displays 'A' on GLCD
GLCD_DisplayChar(0x41); //Displays 'A' on GLCD
GLCD_DisplayChar('A'); //Recommended usage



GLCD_DisplayString

{{#Widget:LibTable}}
Defination void GLCD_DisplayString(char *ptr_stringPointer_u8)
Input Arguments char*:String(Address of the string) to be displayed.
Return Value none
Description This function is used to display the ASCII string on the lcd.
Usage 
  1.  
  2. void main()
  3. {
  4.    char myString[]={"hello, world"};
  5.    GLCD_DisplayString(myString);
  6.    GLCD_DisplayString("good morning");
  7. }

GLCD_ScrollMessage

{{#Widget:LibTable}}
Defination void GLCD_ScrollMessage(uint8_t var_lineNumber_u8, char *ptr_msgPointer_u8)
Input Arguments
  • uint8_t: Line number on which the message has to be scrolled
  • char *: pointer to the string to be scrolled
Return Value none
Description This function scrolls the given message on the specified line.
If the specified line number is out of range then the message will be scrolled on first line.
  • Note: Leave 7-8 spaces at the beginning and 1 space at the end of the message to be scrolled.
Usage

GLCD_ScrollMessage(" Welcome to embedded programming ");



GLCD_DisplayNumber

{{#Widget:LibTable}}
Defination void GLCD_DisplayNumber(NumericSystem_et e_typeOfNum_e8, uint32_t var_number_u32, uint8_t var_numOfDigitsToDisplay_u8)
Input Arguments
  • NumericSystem_et: Specifies type of number ENUM_BINARY(2),ENUM_DECIMAL(10), ENUM_Hex(16)
  • uint32_t: Number to be displayed on the GLCD.
  • uint8_t : Number of digits to be displayed
Return Value none
Description

This function is used to display a max of 10digit decimal/Hex number OR specified number of bits for binary number.
1st parameter specifies type of number ENUM_BINARY(2),ENUM_DECIMAL(10), ENUM_Hex(16).
3rd parameter specifies the number of digits from the right side to be displayed.
The output for the input combinations is as below
Binary:

  • (10,4) then 4-LSB will be displayed ie. 1010
  • (10,8) then 8-LSB will be displayed ie. 00001010
  • (10,2) then 2-LSB will be displayed ie. 10

Decimal:

  • (10,12345,4) then 4-digits ie. 2345 will be displayed
  • (ENUM_DECIMAL,12345,6) then 6-digits ie. 012345 will be displayed
  • (10,12345,C_DisplayDefaultDigits_U8) then 12345 will be displayed.\

Hex:

  • (16,0x12AB,3) then 3-digits ie. 2AB will be displayed
  • (ENUM_Hex,0x12AB,6) then 6-digits ie. 0012AB will be displayed
  • (ENUM_Hex,0x12AB,C_DisplayDefaultDigits_U8) then 12AB will be displayed.
Usage

uint32_t decNumber = 123456;
GLCD_DisplayDecimalNumber(decNumber,5); //Display last 5-digits of Number
GLCD_DisplayDecimalNumber(12345,4); //Display last 4-digits of number

GLCD_Printf

{{#Widget:LibTable}}
Defination void GLCD_Printf(const char *argList, ...)
Input Arguments variable length arguments similar to printf
Return Value none
Description This function is similar to printf function in C. It takes the arguments with specified format and displays accordingly .

The supported format specifiers are as below.

  • %c: character
  • %d: decimal(16bit)
  • %l: decimal(32-bit)
  • %b: binary(16-bit)
  • %s: string
  • %f: float
  • %x: hexadecimal
Usage 
  1. void main()
  2. {
  3. uint16_t decNum=1234;//16-bit
  4. uint32_t longDec=12345678;//32-bit
  5. float floatNum=1234.5678;
  6. uint16_t hexNum=0xABCD;
  7. char myString[]={"hello, world};
  8.  
  9. GLCD_Printf("%d %l %f %x %b %s",decNum,longDec,floatNum,hexNum,hexNum,myString);
  10. GLCD_Printf("D:%d,L:%l,F=%f,H:%x,Str:%s",1234,12345678,123.456,0xAB,"hello");
  11. }

Usage Guide

#include<lpc17xx.h>
#include "glcd.h" //User defined GLCD library which contains the lcd routines
#include "delay.h" //User defined library which contains the delay routines
void main()
{
SystemInit(); //Clock and PLL configuration
/* Setup/Map the controller pins for LCD operation
CS1 CS2 RS RW EN D0 D1 D2 D3 D4 D5 D6 D7 */
GLCD_SetUp(P2_0,P2_1,P2_2,P2_3,P2_4,P1_20,P1_21,P1_22,P1_23,P1_24,P1_25,P1_26,P1_27);
/* Initialize GLCD before use */
GLCD_Init();
while(1)
{
/*scroll the message on line1 */
GLCD_Clear();
GLCD_ScrollMessage(1," Program to demonstrate the ExploreEmbedded Lib Usage");
GLCD_Clear();
GLCD_Printf("Hello, World \nGood Morning");
DELAY_sec(3);
GLCD_Clear();
GLCD_Printf("DecNum:%4d",1234);
GLCD_Printf("\nHexNum:%4x",0xABCD);
DELAY_sec(3);
GLCD_Clear();
GLCD_Printf("16-bit Bin:1234");
GLCD_GoToNextLine();
GLCD_Printf("%16b",0x1234);
DELAY_sec(3);
}
}
view raw lpc1768_glcd_UsngLib.c hosted with ❤ by GitHub

Retrieved from "https://exploreembedded.com/wiki/index.php?title=GLCD&oldid=5796"