Revision as of 12:32, 23 October 2013 (view source) Rupali (Talk | contribs) (→‎LCD_DisplayRtcDate()) ← Older edit		Latest revision as of 15:33, 18 June 2014 (view source) Sandeep (Talk | contribs)
(24 intermediate revisions by 2 users not shown)
Line 1:		Line 1:
−		+	[[category:Code Libraries]]
Line 11:		Line 11:
	This manual provides the reference to all the library functions which are grouped under respective .c file.		This manual provides the reference to all the library functions which are grouped under respective .c file.
−	The .c files convention is as per the peripherals. The peripherals (lcd, keypad..) are connected to default PORTs which can be connect to required  PORTs by changing the #define..	+	The .c files convention is as per the peripherals. The peripherals (lcd, keypad..) are connected
		+	to default PORTs which can be connect to required  PORTs by changing the #define..
	==Reference:==		==Reference:==
−	It is recommended to go through the below reference documents and datasheets before interfacing any peripherals.	+	It is recommended to go through the below reference documents and datasheets before interfacing any peripherals.
−	1. The Pic Microcontroller and Embedded Systems by Muhammad Ali Mazidi.	+	#The Pic Microcontroller and Embedded Systems by Muhammad Ali Mazidi.
−	2. Pic16f877A DataSheet.	+	#Pic16f877A DataSheet.
−	3. Embedded C  by Michael J Pont .	+	#Embedded C  by Michael J Pont .
−	4. Any of the 16x2 lcd datasheet.	+	#Any of the 16x2 lcd datasheet.
−	5. RTC-DS1307 from Dallas Semiconductors.	+	#RTC-DS1307 from Dallas Semiconductors.
−		+
	==Feedback:==		==Feedback:==
Line 101:		Line 101:
	=Delay =		=Delay =
		+
	'''PIC delay library  with the crystal frequency 20Mhz'''		'''PIC delay library  with the crystal frequency 20Mhz'''
Line 136:		Line 137:
	</syntaxhighlight>		</syntaxhighlight>
−
−
	==delay_ms()==		==delay_ms()==
Line 160:		Line 159:
	</syntaxhighlight>		</syntaxhighlight>
−
−
−
Line 208:		Line 204:
	**''By default the LCD is connected to PORTB.''		**''By default the LCD is connected to PORTB.''
	*''The code can be modified to connect the LCD to any of the PORTs by changing the  "#define databus PORTB".''		*''The code can be modified to connect the LCD to any of the PORTs by changing the  "#define databus PORTB".''
−		+	[[File:LCD_8bit.png]]
Line 236:		Line 232:
	#define BlankSpace ' '		#define BlankSpace ' '
	</syntaxhighlight>		</syntaxhighlight>
−
−
−
−
−
Line 497:		Line 488:
	*''Return value : none''		*''Return value : none''
	*''Description  :This function display hour,min,sec read from DS1307.''		*''Description  :This function display hour,min,sec read from DS1307.''
−	[[File:lcd_rtcdate.png]]	+	[[File:lcd_rtctime.png]]
	<syntaxhighlight>		<syntaxhighlight>
Line 545:		Line 536:
	=Lcd_4_bit Mode=		=Lcd_4_bit Mode=
−	/*----------------------------------------------------------------------------------	+
−	Pic LCD library for 4-bit mode	+	'''Pic LCD library for 4-bit mode'''
−	Filename: lcd_4_bit.c	+	*''Filename: lcd_4_bit.c''
−	Controller: Pic16F877A	+	*''Controller: Pic16F877A''
−	Oscillator: 20 MHz	+	*''Oscillator: 20 MHz''
−	Author: XploreLabz	+	*''Author: XploreLabz''
−	website: www.xplorelabz.com	+	*''website: www.xplorelabz.com ''
−	-------------------------------------------------------------------------------------	+
−	Note:	+
−	1.Pin connection for LCD display in 4-bit mode.	+
−	2.By default the LCD is connected to PORTB.	+
−	3.The code can be modified to connect the LCD to any of the PORTs by changing the	+
−	"#define databus PORTB".	+
−		+
−		+
−	----------------------------------------------------------------------------------*/	+
−		+
		+	Note:
		+	*''Pin connection for LCD display in 4-bit mode.''
		+	*''By default the LCD is connected to PORTB.''
		+	*''The code can be modified to connect the LCD to any of the PORTs by changing the "#define databus PORTB".''
		+	[[File:LCD_4bit.png]]
		+	<syntaxhighlight>
	#include<htc.h>		#include<htc.h>
	#include "delay.h"		#include "delay.h"
	#include "lcd.h"		#include "lcd.h"
−	#define databus PORTB       // LCD databus connected to PORTB	+	#define databus PORTB             //LCD databus connected to PORTB
	#define DataBusDirection TRISB    //Data and Control bus direction config registers		#define DataBusDirection TRISB    //Data and Control bus direction config registers
−	#define rs RB0 // Register select pin connected to PORTB.0	+	#define rs RB0           // Register select pin connected to PORTB.0
−	#define rw RB1 // Read Write pin connected to PORTB.1	+	#define rw RB1           // Read Write pin connected to PORTB.1
−	#define en RB2 // Enable pin connected to PORTB.2	+	#define en RB2         // Enable pin connected to PORTB.2
−		+
		+	</syntaxhighlight>
	/* 16x2 LCD Specification */		/* 16x2 LCD Specification */
		+	<syntaxhighlight>
		+
	#define LCDMaxLines 2		#define LCDMaxLines 2
	#define LCDMaxChars 16		#define LCDMaxChars 16
	#define LineOne 0x80		#define LineOne 0x80
	#define LineTwo 0xc0		#define LineTwo 0xc0
−
	#define BlankSpace ' '		#define BlankSpace ' '
		+	</syntaxhighlight>
		+	==LCD_Init()==
		+	*''Description  :This function is used to initialize the lcd in 4-bit mode. ''
		+	*''Function name:  LCD_Init()''
		+	*''I/P Arguments: none''
		+	*''Return value : none''
−	/*----------------------------------------------------------------------------------	+	<syntaxhighlight>
−	LCD_Init()	+
−	----------------------------------------------------------------------------------	+
−	* Function name:  LCD_Init()	+
−	* I/P Arguments: none.	+
−	* Return value : none	+
−		+
−	* description  :This function is used to initialize the lcd in 4-bit mode	+
−	----------------------------------------------------------------------------------*/	+
	void LCD_Init()		void LCD_Init()
	{		{
Line 607:		Line 594:
	}		}
		+	</syntaxhighlight>
−	/*----------------------------------------------------------------------------------	+	==LCD_CmdWrite()==
−	LCD_CmdWrite()	+	*''Description  :This function sends a command to LCD in the following steps.''
−	------------------------------------------------------------------------------------	+	**''step1: Send the Higher Nibble of the I/P command to LCD.''
−	* I/P Arguments: 8-bit command supported by LCD.	+	**''step2: Select the Control Register by making RS low.''
−	* Return value : none	+	**''step3: Select Write operation making RW low.''
		+	**''step4: Send a High-to-Low pulse on Enable PIN with some delay_us.''
		+	**''step5: Send the Lower Nibble of the I/P command to LCD.''
		+	**''step6: Select the Control Register by making RS low.''
		+	**''step7: Select Write operation making RW low.''
		+	**''step8: Send a High-to-Low pulse on Enable PIN with some delay_us.''
		+	*''I/P Arguments: 8-bit command supported by LCD''
		+	*''Return value : none''
−	* description  :This function sends a command to LCD in the following steps.	+
−	step1: Send the Higher Nibble of the I/P command to LCD.	+	<syntaxhighlight>
−	step2: Select the Control Register by making RS low.	+
−	step3: Select Write operation making RW low.	+
−	step4: Send a High-to-Low pulse on Enable PIN with some delay_us.	+
−	step5: Send the Lower Nibble of the I/P command to LCD.
−	step6: Select the Control Register by making RS low.
−	step7: Select Write operation making RW low.
−	step8: Send a High-to-Low pulse on Enable PIN with some delay_us.
−	----------------------------------------------------------------------------------*/
	void LCD_CmdWrite( char cmd)		void LCD_CmdWrite( char cmd)
	{		{
Line 646:		Line 633:
	}		}
		+	</syntaxhighlight>
−	/*---------------------------------------------------------------------------------	+	==LCD_DataWrite()==
−	LCD_DataWrite()	+
−	----------------------------------------------------------------------------------	+	*''Function name: LCD_DataWrite()''
−	* Function name: LCD_DataWrite()	+	*''Description :This function sends a character to be displayed on LCD in the following steps.''
−	* I/P Arguments: ASCII value of the char to be displayed.	+	**''step1: Send the higher nibble of the character to LCD.''
−	* Return value : none	+	**''step2: Select the Data Register by making RS high.''
		+	**''step3: Select Write operation making RW low.''
		+	**''step4: Send a High-to-Low pulse on Enable PIN with some delay_us.''
		+	**''step5: wait for some time''
		+	**''step6: Send the lower nibble of the character to LCD.''
		+	**''step7: Select the Data Register by making RS high.''
		+	**''step8: Select Write operation making RW low.''
		+	**''step9: Send a High-to-Low pulse on Enable PIN with some delay_us.''
		+	*''I/P Arguments: ASCII value of the char to be displayed.''
		+	*''Return value : none''
−	* description  :
−	This function sends a character to be displayed on LCD in the following steps.
−	step1: Send the higher nibble of the character to LCD.
−	step2: Select the Data Register by making RS high.
−	step3: Select Write operation making RW low.
−	step4: Send a High-to-Low pulse on Enable PIN with some delay_us.
−	step5: wait for some time	+	<syntaxhighlight>
−		+
−	step6: Send the lower nibble of the character to LCD.	+
−	step7: Select the Data Register by making RS high.	+
−	step8: Select Write operation making RW low.	+
−	step9: Send a High-to-Low pulse on Enable PIN with some delay_us.	+
−	----------------------------------------------------------------------------------*/	+
	void LCD_DataWrite( char dat)		void LCD_DataWrite( char dat)
	{		{
Line 675:		Line 660:
	databus=(dat & 0xf0);     // Send the Higher Nibble of the Data to LCD		databus=(dat & 0xf0);     // Send the Higher Nibble of the Data to LCD
−	rs=1; // Select the Data Register by pulling RS HIGH	+	rs=1;   // Select the Data Register by pulling RS HIGH
−	rw=0; // Select the Write Operation  by pulling RW LOW	+	rw=0;   // Select the Write Operation  by pulling RW LOW
−	en=1; // Send a High-to-Low Pusle at Enable Pin	+	en=1; // Send a High-to-Low Pusle at Enable Pin
	delay_us(10);		delay_us(10);
	en=0;		en=0;
−	delay_us(10);         // wait for some time.	+	delay_us(10); // wait for some time.
	databus=((dat <<4) & 0xf0); // Send the Lower Nibble of the Data to LCD		databus=((dat <<4) & 0xf0); // Send the Lower Nibble of the Data to LCD
−	rs=1; // Select the Data Register by pulling RS HIGH	+	rs=1; // Select the Data Register by pulling RS HIGH
−	rw=0; // Select the Write Operation  by pulling RW LOW	+	rw=0; // Select the Write Operation  by pulling RW LOW
−	en=1; // Send a High-to-Low Pusle at Enable Pin	+	en=1; // Send a High-to-Low Pusle at Enable Pin
	delay_us(10);		delay_us(10);
	en=0;		en=0;
Line 693:		Line 678:
	}		}
		+	</syntaxhighlight>
		+	=Keypad=
		+	'''PIC 4x4 Keypad Library'''
		+	*''Filename: keypad.c''
		+	*''Controller: Pica6f877A''
		+	*''Oscillator: 20 MHz''
		+	*''Author: XploreLabz''
		+	*''website: www.xplorelabz.com ''
−		+	Note:
−		+	*''Rows are connected to lower 4-bits of PORTC.''
−		+	*''Cols are connected to higher 4-bits of PORTC.''
−		+	[[File:keypad.png]]
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	Keypad	+
−	/*----------------------------------------------------------------------------------	+
−	PIC 4x4 Keypad Library	+
−	Filename: keypad.c	+
−	Controller: Pica6f877A	+
−	Oscillator: 20 MHz	+
−	Author: XploreLabz	+
−	website: www.xplorelabz.com	+
−		+
−	----------------------------------------------------------------------------------	+
−	Note:	+
−	1.Rows are connected to lower 4-bits of PORTC	+
−	1.Cols are connected to higher 4-bits of PORTC	+
−		+
−	----------------------------------------------------------------------------------*/	+
−		+
	#include <htc.h>		#include <htc.h>
Line 733:		Line 703:
	#define ROW PORTC  //Lower four bits of P1 are used as ROWs		#define ROW PORTC  //Lower four bits of P1 are used as ROWs
	#define COL PORTC  //Higher four bits of P1 are used as COLs		#define COL PORTC  //Higher four bits of P1 are used as COLs
		+	</syntaxhighlight>
		+	==KEYPAD_Init()==
		+	*''Description  : This function the rows and colums for keypad scan
		+	**''ROW lines are configured as Output.''
		+	**''Column Lines are configured as Input. ''
		+	*''I/P Arguments:none''
		+	*''Return value : none''
−	/*---------------------------------------------------------------------------------	+	<syntaxhighlight>
−	KEYPAD_Init()	+
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments:none	+
−	* Return value : none	+
−	* description  : This function the rows and colums for keypad scan
−	1.ROW lines are configured as Output.
−	2.Column Lines are configured as Input.
−	-----------------------------------------------------------------------------------*/
	void KEYPAD_Init()		void KEYPAD_Init()
	{		{
Line 751:		Line 720:
	}		}
		+	</syntaxhighlight>
−	/*---------------------------------------------------------------------------------	+	==KEYPAD_WaitForKeyRelease()==
−	KEYPAD_WaitForKeyRelease()	+	*''Description : This function waits till the previous key is released.''
−	----------------------------------------------------------------------------------	+	**''All the ROW lines are pulled high.''
−	* I/P Arguments:none	+	**''Column Lines are read to check the key press.''
−	* Return value : none	+	**''If all the Keys are released then Column lines will be low(0x00) .
		+	*''I/P Arguments:none''
		+	*''Return value : none''
		+
		+	<syntaxhighlight>
		+
−	* description  : This function waits till the previous key is released.
−	1.All the ROW lines are pulled high.
−	2.Column Lines are read to check the key press.
−	3.If all the Keys are released then Column lines will be low(0x00)
−	-----------------------------------------------------------------------------------*/
	void KEYPAD_WaitForKeyRelease()		void KEYPAD_WaitForKeyRelease()
	{		{
Line 774:		Line 744:
	// If no Key is pressed, Column lines will be low(0x00)		// If no Key is pressed, Column lines will be low(0x00)
	}		}
		+	</syntaxhighlight>
−	/*---------------------------------------------------------------------------------
−	KEYPAD_WaitForKeyPress()
−	----------------------------------------------------------------------------------
−	* I/P Arguments:none
−	* Return value : none
−	* description : This function waits till a new key is pressed.	+	==KEYPAD_WaitForKeyPress()==
−	1.All the ROW lines are pulled high.	+	*''Description : This function waits till a new key is pressed.''
−	2.Column Lines are read to check the key press.	+	**''All the ROW lines are pulled high.''
−	3.If any Key is pressed then corresponding Column Line goes high.	+	**''Column Lines are read to check the key press.''
−	4.Wait for Some time and perform the above operation to ensure	+	**''If any Key is pressed then corresponding Column Line goes high.''
−	the True Key Press before decoding the KEY.	+	**''Wait for Some time and perform the above operation to ensure the True Key Press before decoding the KEY.''
−	-----------------------------------------------------------------------------------*/	+	*''I/P Arguments:none''
		+	*''Return value : none''
		+
		+
		+	<syntaxhighlight>
	void KEYPAD_WaitForKeyPress()		void KEYPAD_WaitForKeyPress()
	{		{
Line 810:		Line 780:
	}		}
		+	</syntaxhighlight>
		+	==KEYPAD_ScanKey()==
		+	*''Description  : This function scans all the rows to decode the key pressed.''
		+	**''Each time a ROW line is pulled high to detect the KEY.''
		+	**''Column Lines are read to check the key press.''
		+	**''If any Key is pressed then corresponding Column Line goes high.''
		+	**''Return the ScanCode(Combination of ROW & COL) for decoding the key. ''
		+	*''I/P Arguments:none''
		+	*''Return value : char--> Scancode of the Key Pressed''
−	/*---------------------------------------------------------------------------------	+
−	KEYPAD_ScanKey()	+	<syntaxhighlight>
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments:none	+
−		+
−	* Return value : char--> Scancode of the Key Pressed	+
−		+
−	* description  : This function scans all the rows to decode the key pressed.	+
−	1.Each time a ROW line is pulled high to detect the KEY.	+
−	2.Column Lines are read to check the key press.	+
−	3.If any Key is pressed then corresponding Column Line goes high.	+
−	4.Return the ScanCode(Combination of ROW & COL) for decoding the key.
−	-----------------------------------------------------------------------------------*/
	unsigned char KEYPAD_ScanKey()		unsigned char KEYPAD_ScanKey()
	{		{
Line 849:		Line 817:
	return(key);		return(key);
	}		}
		+	</syntaxhighlight>
		+	==KEYPAD_GetKey()==
		+	*''Description: This function waits till a key is pressed and retuns its ASCII Value''
		+	**''Wait till the previous key is released..''
		+	**''Wait for the new key press.''
		+	**''Scan all the rows one at atime for the pressed key.''
		+	**''Decode the key pressed depending on ROW-COL combination and retuns its ASCII value. ''
		+	*'' I/P Arguments:none''
		+	*''Return value : char--> ASCII value of the Key Pressed''
−		+
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	/*---------------------------------------------------------------------------------	+
−	KEYPAD_GetKey()	+
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments:none	+
−		+
−	* Return value : char--> ASCII value of the Key Pressed	+
−		+
−	* description: This function waits till a key is pressed and retuns its ASCII Value	+
−		+
−	1.Wait till the previous key is released..	+
−	2.Wait for the new key press.	+
−	3.Scan all the rows one at atime for the pressed key.	+
−	4.Decode the key pressed depending on ROW-COL combination and retuns its	+
−	ASCII value.	+
−	-----------------------------------------------------------------------------------*/	+
	unsigned char KEYPAD_GetKey()		unsigned char KEYPAD_GetKey()
	{		{
Line 926:		Line 864:
	}		}
		+	</syntaxhighlight>
		+	=UART =
		+	'''PIC UART library for Serial Communication for 9600 baud rate at 20MHz'''
		+	*''Filename: uart.c''
		+	*''Controller: Pic16F877A''
		+	*''Oscillator: 20MHz''
		+	*''Author: XploreLabz''
		+	*''website: www.xplorelabz.com ''
		+
		+	<syntaxhighlight>
		+	#include<htc.h>
		+	</syntaxhighlight>
−	UART	+	==UART_Init()==
−	/*-------------------------------------------------------------------------------	+	*''Description  :This function is used to initialize the UART at 9600 baud rate by below configuration.''
−	PIC UART library for Serial Communication for 9600 baud rate at 20MHz	+	**''TXSTA is configured for Asynchronous mode, 8-bit data & transmitter enabled.''
−	Filename: uart.c	+	**''RCSTA is configured for continous receive enable.''
−	Controller: Pic16F877A	+	**''SPBRG is configured 9600 Baud rate at 20MHz.''
−	Oscillator: 20MHz	+	*''I/P Arguments: none''
−	Author: XploreLabz	+	*''Return value : none''
−	website: www.xplorelabz.com	+
−	-------------------------------------------------------------------------------*/	+
−	#include<htc.h>	+	<syntaxhighlight>
−		+
−		+
−		+
−	/*-------------------------------------------------------------------------------	+
−	UART_Init()	+
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments: none.	+
−	* Return value : none	+
−		+
−	* description  :This function is used to initialize the UART at 9600 baud rate	+
−	by below configuration.	+
−	1.TXSTA is configured for Asynchronous mode, 8-bit data & transmitter enabled	+
−	2.RCSTA is configured for continous receive enable	+
−	3.SPBRG is configured 9600 Baud rate at 20MHz	+
−	----------------------------------------------------------------------------------*/	+
	void UART_Init()		void UART_Init()
	{		{
Line 966:		Line 899:
	SPBRG=31;        // 9600 Baud rate at 20MHz		SPBRG=31;        // 9600 Baud rate at 20MHz
	}		}
		+	</syntaxhighlight>
		+	==UART_RxChar()==
		+	*''Description :This function is used to receive a char from UART module.''
		+	**''It waits till a char is received ie.till RCIF is set,''
		+	**''RCIF will be set once a CHAR is received.''
		+	**''Finally it clears the RCIF for next cycle and returns the received char.''
		+	*''I/P Arguments: none''
		+	*''Return value : char''
		+	<syntaxhighlight>
		+
−
−	/*----------------------------------------------------------------------------------
−	UART_RxChar()
−	----------------------------------------------------------------------------------
−	* I/P Arguments: none.
−	* Return value : char
−
−	* description :This function is used to receive a char from UART module.
−	It waits till a char is received ie.till RCIF is set,
−	RCIF will be set once a CHAR is received.
−	Finally it clears the RCIF for next cycle and returns the received char.
−	----------------------------------------------------------------------------------*/
	char UART_RxChar()		char UART_RxChar()
	{		{
Line 988:		Line 919:
	return(RCREG);        // Return the received data to calling function		return(RCREG);        // Return the received data to calling function
	}		}
		+	</syntaxhighlight>
		+	==UART_TxChar()==
		+	*''Description  :This function is used to transmit a char through UART module.''
		+	**''It waits till previous char is transmitted ie.till TXIF is set.''
		+	**''TXIF will be set once a CHAR is transmitted.''
		+	**''It clears the TXIF for next operation.''
		+	**Finally the Char to be transmitted is loaded into  TXREG.''
		+	*''I/P Arguments: char--> data to be transmitted.''
		+	*''Return value : none''
−		+	<syntaxhighlight>
−		+
−		+
−		+
−	/*----------------------------------------------------------------------------------	+
−	UART_TxChar()	+
−	------------------------------------------------------------------------------------	+
−	* I/P Arguments: char--> data to be transmitted.	+
−	* Return value : none.	+
−		+
−	* description  :This function is used to transmit a char through UART module.	+
−	It waits till previous char is transmitted ie.till TXIF is set.	+
−	TXIF will be set once a CHAR is transmitted.	+
−	It clears the TXIF for next operation.	+
−	Finally the Char to be transmitted is loaded into  TXREG.	+
−	----------------------------------------------------------------------------------*/	+
	void UART_TxChar(char ch)		void UART_TxChar(char ch)
	{		{
Line 1,014:		Line 939:
	TXREG=ch;        // load the chr the to be transmitted into transmit reg		TXREG=ch;        // load the chr the to be transmitted into transmit reg
	}		}
		+	</syntaxhighlight>
		+	==UART_TxString()==
		+	*''Description :This function is used to transmit the ASCII string through UART.''
		+	**''The string_ptr points to the first char of the string.''
		+	**''And it is incremented each time to traverse till the end(NULL CHAR).''
		+	**''Each time a char is sent to UART_TxChar() fun to transmit it through UART''
		+	*''I/P Arguments: String(Address of the string) to be transmitted.''
		+	*''Return value : none''
		+	<syntaxhighlight>
		+
−
−
−
−
−
−	/*----------------------------------------------------------------------------------
−	UART_TxString()
−	-----------------------------------------------------------------------------------
−	* I/P Arguments: String(Address of the string) to be transmitted.
−	* Return value : none
−
−	* description :This function is used to transmit the ASCII string through UART..
−	The string_ptr points to the first char of the string.
−	And it is incremented each time to traverse till the end(NULL CHAR).
−	Each time a char is sent to UART_TxChar() fun to transmit it through UART
−	----------------------------------------------------------------------------------*/
	void UART_TxString(char *string_ptr)		void UART_TxString(char *string_ptr)
	{		{
Line 1,041:		Line 960:
	}		}
		+	</syntaxhighlight>
Line 1,046:		Line 966:
		+	==UART_RxString()==
		+	*''Description  :
		+	**''This function is used to receive a ASCII string through UART till the carriage_return/New_line.''
		+	**''The string_ptr points to the begining of the string and each time UART_RxChar() function is called to receive a char and copy it into the buffer(STRING) and incrment string_ptr.''
		+	**''Once the carriage_return/New_line is encountered the loop is breaked and the String is NULL terminated. ''
		+	*''I/P Arguments: *string_ptr (Address of the string where the received data needs to be stored)''
		+	*''Return value : none''
−		+	NOTE:
−		+	*''The received char is ECHOED back, if not required then comment UART_TxChar(ch) in the code.''
−		+	*''BackSlash is not taken care.''
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	/*---------------------------------------------------------------------------------	+
−	UART_RxString()	+
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments: *string_ptr	+
−	Address of the string where the received data needs to be stored	+
−	* Return value : none	+
−		+
−	* description  :	+
−	1.This function is used to receive a ASCII string through UART	+
−	till the carriage_return/New_line	+
−	2.The string_ptr points to the begining of the string and each	+
−	time UART_RxChar() function is called to receive a char and copy	+
−	it into the buffer(STRING) and incrment string_ptr.	+
−	3.Once the carriage_return/New_line is encountered the loop	+
−	is breaked and the String is NULL terminated.	+
−		+
−	*****NOTE*******:	+
−	1.The received char is ECHOED back,	+
−	if not required then comment UART_TxChar(ch) in the code.	+
−	2.BackSlash is not taken care.	+
−	----------------------------------------------------------------------------------*/	+
	void UART_RxString(char *string_ptr)		void UART_RxString(char *string_ptr)
	{		{
Line 1,097:		Line 996:
	}		}
		+	</syntaxhighlight>
		+	==UART_TxNumber()==
		+	*''I/P Arguments: unsigned int.''
		+	*''Return value : none''
		+	*''Description  :This function is used to transmit a 5-digit integer(0-65535).''
		+	*''ex:''
		+	#''if the number is 12345 then 12345 is transmitted.''
		+	#''if the number is 123 then 00123 is transmitted.''
−		+	[[File:UART_txnumber.png]]
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	/*----------------------------------------------------------------------------------	+
−	UART_TxNumber()	+
−	------------------------------------------------------------------------------------	+
−	* I/P Arguments: unsigned int.	+
−	* Return value : none	+
−		+
−	* description  :This function is used to transmit a 5-digit integer(0-65535).	+
−	ex: if the number is 12345 then 12345 is transmitted.	+
−	if the number is 123 then 00123 is transmitted.	+
−		+
−		+
−	__________Take 1 by dividing by 10000 and add 0X30 to obtain the ASCII value,	+
−	|          then take the 4-digit remainder(2345).	+
−	|	+
−	| _________Take 2 by dividing by 1000  and add 0X30 to obtain the ASCII value,	+
−	||        then take the 3-digit remainder(345)	+
−	||	+
−	|| ________Take 3 by dividing by 100  and add 0X30 to obtain the ASCII value,	+
−	|||        then take the 2-digit remainder(45).	+
−	|||	+
−	||| _______Take 4 by dividing by 10    and add 0X30 to obtain the ASCII value,	+
−	|||| ______Take 5 the remainder of 45  and add 0X30 to obtain the ASCII value,.	+
−	|||||	+
−	12345	+
−	____________________________________________________________________________________*/	+
−		+
	void UART_TxNumber(unsigned int num)		void UART_TxNumber(unsigned int num)
	{		{
Line 1,163:		Line 1,027:
	}		}
−		+	</syntaxhighlight>
		+	=I2C=
−		+	'''PIC I2C  library'''
−		+	*''Filename: I2C.c''
−		+	*''Controller: Pic16f877A(PIC family)''
−		+	*''Oscillator: 11.0592 MHz''
−	I2C	+	*''Author: XploreLabz''
−	/*---------------------------------------------------------------------------------*	+	*''website: www.xplorelabz.com ''
−	PIC I2C  library	+
−	Filename: I2C.c	+
−	Controller: Pic16f877A(PIC family)	+
−	Oscillator: 11.0592 MHz	+
−	Author: XploreLabz	+
−	website: www.xplorelabz.com	+
	Note:		Note:
−	1.The SDA and SCL lines are connected to PORTC.4 and PORTC.3	+	*''The SDA and SCL lines are connected to PORTC.4 and PORTC.3''
−	2.The code can be modified to connect the	+	*''The code can be modified to connect the SDA and SCL to any of the PORTs by changing the #define''
−	SDA and SCL to any of the PORTs by changing the #define	+	<syntaxhighlight>
−	----------------------------------------------------------------------------------*/	+
	#include<reg51.h>		#include<reg51.h>
	#include "delay.h"		#include "delay.h"
Line 1,193:		Line 1,052:
	sbit SCL=RC3;      //SCL Connected to PORTC.3		sbit SCL=RC3;      //SCL Connected to PORTC.3
	sbit SDA=RC4;      //SDA Connected to PORTC.4		sbit SDA=RC4;      //SDA Connected to PORTC.4
		+	</syntaxhighlight>
		+	==I2C_Clock()==
		+	*''Description  :This function is used to generate a clock pulse on SCL line. ''
		+	*''I/P Arguments: none''
		+	*''Return value : none''
		+	<syntaxhighlight>
−
−
−	/*---------------------------------------------------------------------------------*
−	I2C_Clock()
−	----------------------------------------------------------------------------------*
−	* I/P Arguments: none.
−	* Return value : none
−
−	* description  :This function is used to generate a clock pulse on SCL line.
−	-----------------------------------------------------------------------------------*/
	void I2C_Clock(void)		void I2C_Clock(void)
	{		{
Line 1,218:		Line 1,073:
	}		}
		+	</syntaxhighlight>
		+	==I2C_Start()==
		+	*''I/P Arguments: none''
		+	*''Return value : none''
		+	*''Description  :This function is used to generate I2C Start Condition.''
		+	**''Start Condition: SDA goes low when SCL is High. ''
		+	[[File:I2C_start.png]]
		+	<syntaxhighlight>
−
−
−
−
−
−
−
−
−
−
−
−
−
−
−
−	/*---------------------------------------------------------------------------------*
−	I2C_Start()
−	----------------------------------------------------------------------------------*
−	* I/P Arguments: none.
−	* Return value : none
−	* description  :This function is used to generate I2C Start Condition.
−	Start Condition: SDA goes low when SCL is High.
−
−	-----------------------------------------------------------------------------------*/
	void I2C_Start()		void I2C_Start()
	{		{
Line 1,260:		Line 1,099:
	SCL = 0;        //Finally Clear the SCL to complete the cycle		SCL = 0;        //Finally Clear the SCL to complete the cycle
	}		}
		+	</syntaxhighlight>
−		+	==I2C_Stop()==
−		+	*''I/P Arguments: none''
−	/*-----------------------------------------------------------------------------------	+	*''Return value : none''
−	I2C_Stop()	+	*''Description :This function is used to generate I2C Stop Condition.''
−	------------------------------------------------------------------------------------	+	**''Stop Condition: SDA goes High when SCL is High. ''
−	* I/P Arguments: none.	+	[[File:I2C_stop.png]]
−	* Return value : none	+	<syntaxhighlight>
−	* description :This function is used to generate I2C Stop Condition.	+
−	Stop Condition: SDA goes High when SCL is High.	+
−		+
−	------------------------------------------------------------------------------------*/	+
	void I2C_Stop(void)		void I2C_Stop(void)
Line 1,286:		Line 1,122:
	SDA = 1;            // Now Pull SDA High, to generate the Stop Condition		SDA = 1;            // Now Pull SDA High, to generate the Stop Condition
	}		}
		+	</syntaxhighlight>
−		+	==I2C_Write()==
−	/*---------------------------------------------------------------------------------*	+	*''I/P Arguments: unsigned char-->8bit data to be sent.''
−	I2C_Write()	+	*''Return value : none''
−	----------------------------------------------------------------------------------*	+	*''Description :This function is used to send a byte on SDA line using I2C protocol''
−	* I/P Arguments: unsigned char-->8bit data to be sent.	+	**''8bit data is sent bit-by-bit on each clock cycle.''
−	* Return value : none	+	**''MSB(bit) is sent first and LSB(bit) is sent at last.''
−	* description :This function is used to send a byte on SDA line using I2C protocol	+	**''Data is sent when SCL is low. ''
−	8bit data is sent bit-by-bit on each clock cycle.	+	[[File:I2C_write.png]]
−	MSB(bit) is sent first and LSB(bit) is sent at last.	+	<syntaxhighlight>
−	Data is sent when SCL is low.	+
−		+
−	-----------------------------------------------------------------------------------*/	+
	void I2C_Write(unsigned char dat)		void I2C_Write(unsigned char dat)
	{		{
Line 1,312:		Line 1,146:
	}		}
−	/*-----------------------------------------------------------------------------------*	+	</syntaxhighlight>
−	I2C_Read()	+
−	------------------------------------------------------------------------------------*	+	==I2C_Read()==
−	* I/P Arguments: none.	+	*''I/P Arguments: none''
−	* Return value : Unsigned char(received byte)	+	*''Return value : Unsigned char(received byte)''
−	* description :This fun is used to receive a byte on SDA line using I2C protocol.	+	*''Description :This fun is used to receive a byte on SDA line using I2C protocol.''
−	8bit data is received bit-by-bit each clock and finally packed into Byte.	+	**''8bit data is received bit-by-bit each clock and finally packed into Byte.''
−	MSB(bit) is received first and LSB(bit) is received at last.	+	**''MSB(bit) is received first and LSB(bit) is received at last.''
−		+	[[File:I2C_read.png]]
−	-------------------------------------------------------------------------------------*/	+	<syntaxhighlight>
	unsigned char I2C_Read(void)		unsigned char I2C_Read(void)
	{		{
Line 1,340:		Line 1,174:
	return dat;              // Finally return the received Byte*		return dat;              // Finally return the received Byte*
	}		}
		+	</syntaxhighlight>
		+	==I2C_Ack()==
		+	*''Description  :This function is used to generate a the Positive ACK pulse on SDA after receiving a byte.''
		+	*''I/P Arguments: none.''
		+	*''Return value : none''
−	/*---------------------------------------------------------------------------------*	+	<syntaxhighlight>
−	I2C_Ack()	+
−	----------------------------------------------------------------------------------*	+
−	* I/P Arguments: none.	+
−	* Return value : none	+
−	* description  :This function is used to generate a the Positive ACK
−	pulse on SDA after receiving a byte.
−	-----------------------------------------------------------------------------------*/
	void I2C_Ack()		void I2C_Ack()
	{		{
Line 1,359:		Line 1,191:
	}		}
		+	</syntaxhighlight>
−	/*---------------------------------------------------------------------------------*
−	I2C_NoAck()
−	----------------------------------------------------------------------------------*
−	* I/P Arguments: none.
−	* Return value : none
−	* description :This function is used to generate a the Negative/NO ACK	+	==I2C_NoAck()==
−	pulse on SDA after receiving all bytes.	+	*''Description :This function is used to generate a the Negative/NO ACK pulse on SDA after receiving all bytes.''
−	-----------------------------------------------------------------------------------*/	+	*''I/P Arguments: none''
		+	*''Return value : none''
		+
		+
		+	<syntaxhighlight>
	void I2C_NoAck()		void I2C_NoAck()
	{		{
Line 1,378:		Line 1,210:
	SCL = 1;        // Set SCL */		SCL = 1;        // Set SCL */
	}		}
		+	</syntaxhighlight>
		+	=Ds1307_RTC =
		+	'''PIC DS1307  library'''
		+	*''Filename: DS1307.c''
		+	*''Controller: Pic16f877A(PIC family)''
		+	*''Oscillator: 11.0592 MHz''
		+	*''Author: XploreLabz''
		+	*''website: www.xplorelabz.com ''
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	Ds1307_RTC	+
−	/*--------------------------------------------------------------------------------	+
−	PIC DS1307  library	+
−	Filename: DS1307.c	+
−	Controller: Pic16f877A(PIC family)	+
−	Oscillator: 11.0592 MHz	+
−	Author: XploreLabz	+
−	website: www.xplorelabz.com	+
−		+
−	---------------------------------------------------------------------------------*/	+
	#include "ds1307.h"		#include "ds1307.h"
	#include "i2c.h"		#include "i2c.h"
	#include "delay.h"		#include "delay.h"
		+	</syntaxhighlight>
−		+	*''Below values are fixed and should not be changed.''
−	/* Below values are fixed and should not be changed.	+	*''Refer Ds1307 DataSheet for more info.''
−	Refer Ds1307 DataSheet for more info*/	+	<syntaxhighlight>
−		+
	#define DS1307_ID 0xD0    // DS1307 ID		#define DS1307_ID 0xD0    // DS1307 ID
Line 1,427:		Line 1,238:
	#define DATE_ADDRESS  0x04 // Address to access Ds1307 DATE register		#define DATE_ADDRESS  0x04 // Address to access Ds1307 DATE register
	#define CONTROL 0x07      // Address to access Ds1307 CONTROL register		#define CONTROL 0x07      // Address to access Ds1307 CONTROL register
		+	</syntaxhighlight>
		+	==DS1307_Init()==
		+	*''Description :This function is used to initialize the Ds1307 RTC.''
		+	**''Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.''
		+	**''After selecting DS1307, write 0x00 into Control register of Ds1307''
		+	*''I/P Arguments: none''
		+	*''Return value : none''
		+
−	/*---------------------------------------------------------------------------------	+	<syntaxhighlight>
−	DS1307_Init()	+
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments: none.	+
−	* Return value : none	+
−		+
−	* description :This function is used to initialize the Ds1307 RTC.	+
−	Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.	+
−	After selecting DS1307, write 0x00 into Control register of Ds1307	+
−	------------------------------------------------------------------------------------*/
	void DS1307_Init()		void DS1307_Init()
	{		{
Line 1,457:		Line 1,267:
	}		}
		+	</syntaxhighlight>
		+	==DS1307_Write()==
		+	*''Description :This function is used to write a byte of data into Ds1307 RTC.''
		+	**''This function calls I2C_write function to perform the same. ''
		+	*''I/P Arguments: char-> Data to be written into DS1307.''
		+	*''Return value : none''
		+	<syntaxhighlight>
−
−
−
−	/*---------------------------------------------------------------------------------
−	DS1307_Write()
−	----------------------------------------------------------------------------------
−	* I/P Arguments: char-> Data to be written into DS1307.
−	* Return value : none
−
−	* description :This function is used to write a byte of data into Ds1307 RTC.
−	This function calls I2C_write function to perform the same.
−	------------------------------------------------------------------------------------*/
	void DS1307_Write(unsigned char dat)		void DS1307_Write(unsigned char dat)
	{		{
Line 1,482:		Line 1,287:
	}		}
		+	</syntaxhighlight>
		+	==DS1307_Read()==
		+	*''Description : This function is used to read a byte of data from Ds1307 RTC.''
		+	**''This function calls I2C_Read function to perform the same. ''
		+	*''I/P Arguments: char-> Data to be written into DS1307.''
		+	*''Return value : none''
		+
		+	<syntaxhighlight>
−
−
−
−
−	/*---------------------------------------------------------------------------------
−	DS1307_Read()
−	----------------------------------------------------------------------------------
−	* I/P Arguments: char-> Data to be written into DS1307.
−	* Return value : none
−
−	* description : This function is used to read a byte of data from Ds1307 RTC.
−	This function calls I2C_Read function to perform the same.
−	------------------------------------------------------------------------------------*/
	unsigned char DS1307_Read()		unsigned char DS1307_Read()
	{		{
Line 1,507:		Line 1,307:
	return(dat);		return(dat);
	}		}
		+	</syntaxhighlight>
		+	==DS1307_SetTime()==
		+	*''Description  :This function is used to set Time(hh,mm,ss) into the Ds1307 RTC.''
		+	**''Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.''
		+	**''After selecting DS1307, select the RAM address 0x00 to point to sec''
		+	**''Initilze Sec, MIN, Hour one after the other.''
		+	**''Stop the I2c communication.''
		+	*''I/P Arguments: char,char,char-->hh,mm,ss to initilize the time into DS1307.''
		+	*''Return value : none''
−		+
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	/*----------------------------------------------------------------------------------	+
−	DS1307_SetTime()	+
−	-----------------------------------------------------------------------------------	+
−	* I/P Arguments: char,char,char-->hh,mm,ss to initilize the time into DS1307.	+
−	* Return value : none	+
−		+
−	* description  :This function is used to set Time(hh,mm,ss) into the Ds1307 RTC.	+
−	Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.	+
−	After selecting DS1307, select the RAM address 0x00 to point to sec	+
−	Initilze Sec, MIN, Hour one after the other.	+
−	Stop the I2c communication.	+
−	-----------------------------------------------------------------------------------*/	+
	void DS1307_SetTime(unsigned char hh, unsigned char mm, unsigned char ss)		void DS1307_SetTime(unsigned char hh, unsigned char mm, unsigned char ss)
	{		{
Line 1,552:		Line 1,334:
	I2C_Stop();            // Stop I2C communication after Setting the Time		I2C_Stop();            // Stop I2C communication after Setting the Time
	}		}
		+	</syntaxhighlight>
		+	==DS1307_SetDate()==
		+	*''Description  :This function is used to set Date(dd,mm,yy) into the Ds1307 RTC.''
		+	**''Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.''
		+	**''After selecting DS1307, select the RAM address 0x04 to point to day''
		+	**''Initilze Day,Month and Year one after the other.''
		+	**''Stop the I2c communication.''
		+	*''I/P Arguments: char,char,char-->day,month,year to initilize the Date into DS1307.''
		+	*''Return value : none''
−		+
−		+	<syntaxhighlight>
−	/*---------------------------------------------------------------------------------	+
−	DS1307_SetDate()	+
−	----------------------------------------------------------------------------------	+
−	* I/P Arguments: char,char,char-->day,month,year to initilize the Date into DS1307.	+
−	* Return value : none	+
−		+
−	* description  :This function is used to set Date(dd,mm,yy) into the Ds1307 RTC.	+
−	Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.	+
−	After selecting DS1307, select the RAM address 0x04 to point to day	+
−	Initilze Day,Month and Year one after the other.	+
−	Stop the I2c communication.	+
−	----------------------------------------------------------------------------------*/	+
	void DS1307_SetDate(unsigned char dd, unsigned char mm, unsigned char yy)		void DS1307_SetDate(unsigned char dd, unsigned char mm, unsigned char yy)
	{		{
Line 1,583:		Line 1,362:
	I2C_Stop();            // Stop I2C communication after Setting the Date		I2C_Stop();            // Stop I2C communication after Setting the Date
	}		}
		+	</syntaxhighlight>
		+	==DS1307_GetTime()==
		+	*''Description  :This function is used to get the Time(hh,mm,ss) from Ds1307 RTC.''
		+	**''Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.''
		+	**''After selecting DS1307, select the RAM address 0x00 to point to sec''
		+	**''Get Sec, MIN, Hour one after the other.''
		+	**''Stop the I2c communication. ''
		+	*''I/P Arguments: char *,char *,char *-->pointers to get the hh,mm,ss.''
		+	*''Return value : none''
−	/*----------------------------------------------------------------------------------	+
−	DS1307_GetTime()	+	<syntaxhighlight>
−	-----------------------------------------------------------------------------------	+
−	* I/P Arguments: char *,char *,char *-->pointers to get the hh,mm,ss.	+
−	* Return value : none	+
−	* description  :This function is used to get the Time(hh,mm,ss) from Ds1307 RTC.
−	Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.
−	After selecting DS1307, select the RAM address 0x00 to point to sec
−	Get Sec, MIN, Hour one after the other.
−	Stop the I2c communication.
−	-----------------------------------------------------------------------------------*/
	void DS1307_GetTime(unsigned char *h_ptr,unsigned char *m_ptr,unsigned char *s_ptr)		void DS1307_GetTime(unsigned char *h_ptr,unsigned char *m_ptr,unsigned char *s_ptr)
	{		{
Line 1,620:		Line 1,399:
	}		}
		+	</syntaxhighlight>
		+	==DS1307_GetDate()==
		+	*''Description  :This function is used to get the Date(y,m,d) from Ds1307 RTC.''
		+	**''Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.''
		+	**''After selecting DS1307, select the RAM address 0x00 to point to DAY''
		+	**''Get Day, Month, Year one after the other.''
		+	**''Stop the I2c communication. ''
		+	*''I/P Arguments: char *,char *,char *-->pointers to get the y,m,d.''
		+	*''Return value : none''
−		+
−		+	<syntaxhighlight>
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−	/*----------------------------------------------------------------------------------	+
−	DS1307_GetDate()	+
−	-----------------------------------------------------------------------------------	+
−	* I/P Arguments: char *,char *,char *-->pointers to get the y,m,d.	+
−	* Return value : none	+
−		+
−	* description  :This function is used to get the Date(y,m,d) from Ds1307 RTC.	+
−	Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.	+
−	After selecting DS1307, select the RAM address 0x00 to point to DAY	+
−	Get Day, Month, Year one after the other.	+
−	Stop the I2c communication.	+
−	-----------------------------------------------------------------------------------*/	+
	void DS1307_GetDate(unsigned char *d_ptr,unsigned char *m_ptr,unsigned char *y_ptr)		void DS1307_GetDate(unsigned char *d_ptr,unsigned char *m_ptr,unsigned char *y_ptr)
	{		{
Line 1,684:		Line 1,435:
	}		}
		+	</syntaxhighlight>
−		+	=EEPROM=
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
−		+
		+	'''Pic16f877A EEPROM library'''
		+	*''Filename: eeprom.c''
		+	*''Controller: Pic16f877A''
		+	*''Oscillator: 20 MHz''
		+	*''Author: XploreLabz''
		+	*''website: www.xplorelabz.com ''
		+
		+	<syntaxhighlight>
		+	#include<htc.h>
		+	#include"delay.h"
		+	</syntaxhighlight>
		+	==EEPROM_WriteByte()==
		+	*''Description:This function is used to write the data at specified EEPROM_address.. ''
		+	*''I/P Arguments: char,char-->eeprom_address at which eeprom_data is to be written.''
		+	*''Return value : none''
		+
		+	<syntaxhighlight>          .
−
−
−	Eeprom
−
−	/*---------------------------------------------------------------------------------------*
−	Pic16f877A Eeprom library
−	Filename: eeprom.c
−	Controller: Pic16f877A
−	Oscillator: 20 MHz
−	Author: XploreLabz
−	website: www.xplorelabz.com
−
−	----------------------------------------------------------------------------------------*/
−
−	#include<htc.h>
−	#include"delay.h"
−
−
−	/*---------------------------------------------------------------------------------------
−	EEPROM_WriteByte()
−	----------------------------------------------------------------------------------------
−	* I/P Arguments: char,char-->eeprom_address at which eeprom_data is to be written.
−	* Return value : none
−
−	* description:This function is used to write the data at specified EEPROM_address..
−	.
−	----------------------------------------------------------------------------------------*/
	void EEPROM_WriteByte(unsigned char eeprom_Address, unsigned char eeprom_Data)		void EEPROM_WriteByte(unsigned char eeprom_Address, unsigned char eeprom_Data)
	{		{
Line 1,750:		Line 1,479:
	}		}
		+	</syntaxhighlight>
−	/*-----------------------------------------------------------------------------------------	+	==EEPROM_ReadByte()==
−	EEPROM_ReadByte()	+
−	------------------------------------------------------------------------------------------	+
−	* I/P Arguments: char-->eeprom_address from where eeprom_data is to be read.	+
−	* Return value : char-->data read from Eeprom.	+
−	* description:	+	*''Description: This function is used to read the data from specified EEPROM_address.''
−	This function is used to read the data from specified EEPROM_address.	+	*''I/P Arguments: char-->eeprom_address from where eeprom_data is to be read.''
−	-----------------------------------------------------------------------------------------*/	+	*''Return value : char-->data read from Eeprom.''
		+
		+
		+	<syntaxhighlight>
	unsigned char EEPROM_ReadByte(unsigned char eeprom_Address)		unsigned char EEPROM_ReadByte(unsigned char eeprom_Address)
	{		{
Line 1,772:		Line 1,501:
	return(EEDATA);      // Return the data read form eeprom.		return(EEDATA);      // Return the data read form eeprom.
	}		}
		+	</syntaxhighlight>
Line 1,777:		Line 1,507:
−	/*---------------------------------------------------------------------------------------	+	==EEPROM_WriteNBytes()==
−	EEPROM_WriteNBytes()	+
−	----------------------------------------------------------------------------------------	+	*''Description: This function is used to write N-bytes of data at specified EEPROM_address.''
−	* I/P Arguments: char,-->eeprom_address from where the N-bytes are to be written.	+	**''EEPROM_WriteByte() function is called to write a byte at atime.''
−	char*-->Pointer to the N-bytes of data to be written.	+	**''Source(RAM) and destination(EEPROM) address are incremented after each write''
−	char --> Number of bytes to be written	+	**''NoOfBytes is Decemented each time a byte is written.''
		+	**''Above Operation is carried out till all the bytes are written(NoOfBytes!=0).''
		+	*''I/P Arguments:''
		+	#''char,-->eeprom_address from where the N-bytes are to be written.''
		+	#''char*-->Pointer to the N-bytes of data to be written.''
		+	#''char --> Number of bytes to be written.''
		+	*''Return value : none''
−	* Return value : none	+
−		+	<syntaxhighlight>
−	* description:	+
−	This function is used to write N-bytes of data at specified EEPROM_address.	+
−	EEPROM_WriteByte() function is called to write a byte at atime.	+
−	Source(RAM) and destination(EEPROM) address are incremented after each write	+
−	NoOfBytes is Decemented each time a byte is written.	+
−	Above Operation is carried out till all the bytes are written(NoOfBytes!=0)	+
−	---------------------------------------------------------------------------------------*/	+
	void EEPROM_WriteNBytes(unsigned char EepromAddr, unsigned char *RamAddr, char NoOfBytes)		void EEPROM_WriteNBytes(unsigned char EepromAddr, unsigned char *RamAddr, char NoOfBytes)
	{		{
Line 1,803:		Line 1,532:
	}		}
	}		}
		+	</syntaxhighlight>
		+	==EEPROM_ReadNBytes()==
		+
		+	*''Description: This function is used to Read N-bytes of data from specified EEPROM_address.''
		+	**''EEPROM_ReadByte() func is called to read a byte at a time.''
		+	**''Source(RAM) and destination(EEPROM) address are incremented each time.''
		+	**''NoOfBytes is Decemented after a byte is read.''
		+	**''Above Operation is carried out till all the bytes are read(NoOfBytes!=0).''
		+	*''I/P Arguments:''
		+	#''char,-->eeprom_address from where the N-bytes is to be read.''
		+	#''char*-->Pointer into which the N-bytes of data is to be read.''
		+	#''char --> Number of bytes to be Read''
		+	*''Return value : none''
		+
		+	<syntaxhighlight>
−
−	/*---------------------------------------------------------------------------------------
−	EEPROM_ReadNBytes()
−	----------------------------------------------------------------------------------------
−	* I/P Arguments: char,-->eeprom_address from where the N-bytes is to be read.
−	char*-->Pointer into which the N-bytes of data is to be read.
−	char --> Number of bytes to be Read
−
−	* Return value : none
−
−	* description:
−	This function is used to Read N-bytes of data from specified EEPROM_address.
−	EEPROM_ReadByte() func is called to read a byte at a time.
−	Source(RAM) and destination(EEPROM) address are incremented each time.
−	NoOfBytes is Decemented after a byte is read.
−	Above Operation is carried out till all the bytes are read(NoOfBytes!=0)
−	---------------------------------------------------------------------------------------*/
	void EEPROM_ReadNBytes(unsigned char EepromAddr, unsigned char *RamAddr, char NoOfBytes)		void EEPROM_ReadNBytes(unsigned char EepromAddr, unsigned char *RamAddr, char NoOfBytes)
	{		{
Line 1,836:		Line 1,563:
	}		}
	}		}
		+	</syntaxhighlight>
Line 1,841:		Line 1,569:
−	/*---------------------------------------------------------------------------------------
−	EEPROM_WriteString()
−	----------------------------------------------------------------------------------------
−	* I/P Arguments: char,-->eeprom_address where the String is to be written.
−	char*-->Pointer to String which has to be written.
−	* Return value : none	+	==EEPROM_WriteString()==
		+
		+	*''Description:This function is used to Write a String at specified EEPROM_address.''
		+	**''EEPROM_WriteByte() function is called to write a byte at a time.''
		+	**''Source(RAM) and destination(EEPOM) address are incremented each time.''
		+	**''Above Operation is carried out till Null char is identified.''
		+	*''I/P Arguments:''
		+	#''char,-->eeprom_address where the String is to be written.''
		+	#''char*-->Pointer to String which has to be written.''
		+	*''Return value : none''
−	* description:This function is used to Write a String at specified EEPROM_address.	+	NOTE:
−	EEPROM_WriteByte() function is called to write a byte at a time.	+	*''Null char is also written into the eeprom.''
−	Source(RAM) and destination(EEPOM) address are incremented each time.	+
−	Above Operation is carried out till Null char is identified.	+	<syntaxhighlight>
−	NOTE: Null char is also written into the eeprom.
−	---------------------------------------------------------------------------------------*/
	void EEPROM_WriteString(unsigned char eeprom_address, unsigned char * source_address)		void EEPROM_WriteString(unsigned char eeprom_address, unsigned char * source_address)
	{		{
Line 1,866:		Line 1,596:
	}		}
		+	</syntaxhighlight>
		+	==EEPROM_ReadString()==
		+
		+	*''Description:This function is used to Read a String from specified EEPROM_address.''
		+	**''EEPROM_ReadByte() function is called to read a byte at a time.''
		+	**''Source(EEPROM) and destination(RAM) address are incremented each time.''
		+	**''Above Operation is carried out till Null char is identified.''
		+	*''I/P Arguments:''
		+	#''char,-->eeprom_address from where the String is to be read.''
		+	#''char*-->Pointer into which the String is to be read.''
		+	*''Return value : none''
		+	<syntaxhighlight>
−
−
−
−
−	/*---------------------------------------------------------------------------------------
−	EEPROM_ReadString()
−	----------------------------------------------------------------------------------------
−	* I/P Arguments: char,-->eeprom_address from where the String is to be read.
−	char*-->Pointer into which the String is to be read.
−
−	* Return value : none
−
−	* description:This function is used to Read a String from specified EEPROM_address.
−	EEPROM_ReadByte() function is called to read a byte at a time.
−	Source(EEPROM) and destination(RAM) address are incremented each time.
−	Above Operation is carried out till Null char is identified.
−	---------------------------------------------------------------------------------------*/
	void EEPROM_ReadString(unsigned char eeprom_address, unsigned char * destination_address)		void EEPROM_ReadString(unsigned char eeprom_address, unsigned char * destination_address)
	{		{
Line 1,900:		Line 1,625:
	}		}
		+	</syntaxhighlight>
Line 1,905:		Line 1,631:
−	/*-----------------------------------------------------------------------------------------	+	==EEPROM_Erase()==
−	EEPROM_Erase()	+
−	------------------------------------------------------------------------------------------	+	*''Description:This function is used to erase the entire Eeprom memory.''
−	* I/P Arguments: none	+	**''Eeprom is filled with 0xFF to accomplish the Eeprom Erase.''
		+	**''EEPROM_WriteByte() function is called to write a byte at a time.''
		+	**''Whole memory(0-255) is traversed and filled with 0xFF''
		+	*''I/P Arguments: none''
		+	*''Return value : none''
−	* Return value : none
−	* description:This function is used to erase the entire Eeprom memory.	+	<syntaxhighlight>
−	Eeprom is filled with 0xFF to accomplish the Eeprom Erase.	+
−	EEPROM_WriteByte() function is called to write a byte at a time.	+
−	Whole memory(0-255) is traversed and filled with 0xFF	+
−	-----------------------------------------------------------------------------------------*/	+
	void EEPROM_Erase()		void EEPROM_Erase()
	{		{
Line 1,926:		Line 1,651:
	}		}
	}		}
		+	</syntaxhighlight>
		+	=PIC Library Usage Guide=
		+	[[PIC_Library_Usage_Guide|PIC Library Usage Guide]]

---

Latest revision as of 15:33, 18 June 2014

 

 

 

Introduction

Overview:

This manual is designed to help embedded programmers and students, rapidly exploit the Pic(16f877A)-Controller for embedded applications. This manual has been targeted at embedded systems programmers and Students who have basic knowledge of Pic(16f877A/PIC18f) architecture and C-Language.

This manual provides the reference to all the library functions which are grouped under respective .c file. The .c files convention is as per the peripherals. The peripherals (lcd, keypad..) are connected to default PORTs which can be connect to required PORTs by changing the #define..

Reference:

It is recommended to go through the below reference documents and datasheets before interfacing any peripherals.

1. The Pic Microcontroller and Embedded Systems by Muhammad Ali Mazidi.
2. Pic16f877A DataSheet.
3. Embedded C by Michael J Pont .
4. Any of the 16x2 lcd datasheet.
5. RTC-DS1307 from Dallas Semiconductors.

Feedback:

Suggestions for additions and improvements in code and documentation are always welcome. Please send your feedback via e-mail to feedback@xplorelabz.com

Disclaimer:

The libraries have been tested for Pic16f877A on different development boards. We strongly believe that the library works on any Pic16f877A boards. However, Xplore Labz disclaims any kind of hardware failure resulting out of usage of libraries, directly or indirectly. Documentation may be subject to change without prior notice.

The usage of tools and software demonstrated in the document are for educational purpose only, all rights pertaining to these belong to the respective owners. Users must ensure license terms are adhered to, for any use of the demonstrated software.

GNU GENERAL PUBLIC LICENSE: The library code in this document is licensed under GNU General Public License (GPL) Copyright (C) 2012. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Since the library is licensed free of charge, there is no warranty for the libraries and the entire risk of the quality and performance is with the user.

Errors and omissions should be reported to: feedback@xplorelabz.com

ADC

                                   Pic ADC library.

• Filename: adc.c
• Controller: Pic16f877A
• Oscillator: 20 MHz
• Author: XploreLabz
• website: www.xplorelabz.com
• Reference:Pic16f877a dataSheet

ADC_Init()

• Description :This function initializes the ADC control registers.
• I/P Arguments: none
• Return value : none

ADC_StartConversion()

• Description  :This function does the ADC conversioin for the Selected Channel and returns the converted 10bit result.
• I/P Arguments: char(channel number).
• Return value : int(10 bit ADC result)

Delay

                    PIC delay library  with the crystal frequency 20Mhz

• Filename: delay.c
• Controller: Pic16F877A
• Oscillator: 20MHz
• Author: XploreLabz
• website: www.xplorelabz.com

delay_us()

• Description : This function is used generate delay in us.
  • It genarates a approximate delay of 3us for each count
  • if 50 is passed as the argument then it generates a delay of apprx 150us.
• I/P Arguments: unsigned int
• Return value : none

delay_ms()

• Description: This function is used generate delay in ms.
  • It genarates a approximate delay of 1ms for each count
  • if 1000 is passed as the argument then it generates delay of apprx 1000ms(1sec)
• I/P Arguments: unsigned int
• Return value : none

delay_sec()

• Description: This function is used generate delay in sec .
  • It genarates a approximate delay of 1sec for each count,
  • if 10 is passed as the argument then it generates delay of apprx 10sec
• I/P Arguments: unsigned char
• Return value : none

Note:

• A max of 255 sec delay can be generated wsing this function.

Lcd_8_bit Mode

                        PIC LCD library for 8-bit mode

• Filename: lcd_8_bit.c
• Controller: Pic16F877A
• Oscillator: 20MHz
• Author: XploreLabz
• website: www.xplorelabz.com

Note:

• Pin connection for LCD display in 8-bit mode is as shown below.
  • By default the LCD is connected to PORTB.
• The code can be modified to connect the LCD to any of the PORTs by changing the "#define databus PORTB".

LCD_Init()

• Function name: LCD_Init()
• Description  :This function is used to initialize the lcd in 8-bit mode.
• I/P Arguments: none
• Return value : none

LCD_Clear()

• Description  :This function clears the LCD and moves the cursor to first Position.
• I/P Arguments: none
• Return value : none

LCD_GoToLineOne()

• Description  :This function moves the Cursor to First line First Position.
• I/P Arguments: none
• Return value : none

LCD_GoToLineTwo()

• Description  :This function moves the Cursor to Second line First Position.
• I/P Arguments: none
• Return value : none

LCD_GoToXY()

• Description  :This function moves the Cursor to specified position.
• I/P Arguments: char row,char col

1. row -> line number(line1=0, line2=1),
   1. For 2line LCD the I/P argument should be either 0 or 1.
2. col -> char number.
   1. For 16-char LCD the I/P argument should be betwen 0-15.

• Return value : none

LCD_CmdWrite()

• Description :This function sends a command to LCD in the following steps.
  • step1: Send the I/P command to LCD.
  • step2: Select the Control Register by making RS low.
  • step3: Select Write operation making RW low.
  • step4: Send a High-to-Low pulse on Enable PIN with some delay_us.
• I/P Arguments: 8-bit command supported by LCD.
• Return value : none

LCD_DataWrite()

• Description  :This function sends a character to be displayed on LCD in the following steps.
  • step1: Send the character to LCD.
  • step2: Select the Data Register by making RS high.
  • step3: Select Write operation making RW low.
  • step4: Send a High-to-Low pulse on Enable PIN with some delay_us.
• I/P Arguments: ASCII value of the char to be displayed.
• Return value : none

LCD_DisplayString()

• Description  :This function is used to display the ASCII string on the lcd.

1. The string_ptr points to the first char of the string and traverses till the end(NULL CHAR).
2. Each time a char is sent to LCD_DataWrite funtion to display.

• I/P Arguments: String(Address of the string) to be displayed.
• Return value : none

LCD_DisplayNumber()

• Function name: LCD_DisplayNumber()
• I/P Arguments: unsigned int
• Return value : none
• Description  :This function is used to display a 5-digit integer(0-65535).
  • ex:

1. if the number is 12345 then 12345 is displayed.
2. if the number is 123 then 00123 is displayed.

LCD_ScrollMessage()

• Description  :This function scrolls the given message on the first line.

1. 16 chars are displayed at atime.
2. Pointer is incremented to skip a char each time to give the illusion of moving chars.
3. If the chars are less than 16, then the BlankSpaces are displayed.

• I/P Arguments: char *msg_ptr (msg_ptr -> pointer to the string to be scrolled)
• Return value : none

LCD_DisplayRtcTime()

• I/P Arguments: char hour,char min,char sec (hour,min,sec should be packed BCD format, as read from DS1307)
• Return value : none
• Description  :This function display hour,min,sec read from DS1307.

LCD_DisplayRtcDate()

• I/P Arguments: char day,char month,char year (day,month,year should be packed BCD format, as read from DS1307)
• Return value : none
• Description  :This function display day,month,year read from DS1307.

Lcd_4_bit Mode

                       Pic LCD library for 4-bit mode

• Filename: lcd_4_bit.c
• Controller: Pic16F877A
• Oscillator: 20 MHz
• Author: XploreLabz
• website: www.xplorelabz.com

Note:

• Pin connection for LCD display in 4-bit mode.
• By default the LCD is connected to PORTB.
• The code can be modified to connect the LCD to any of the PORTs by changing the "#define databus PORTB".

/* 16x2 LCD Specification */

LCD_Init()

• Description  :This function is used to initialize the lcd in 4-bit mode.
• Function name: LCD_Init()
• I/P Arguments: none
• Return value : none

LCD_CmdWrite()

• Description  :This function sends a command to LCD in the following steps.
  • step1: Send the Higher Nibble of the I/P command to LCD.
  • step2: Select the Control Register by making RS low.
  • step3: Select Write operation making RW low.
  • step4: Send a High-to-Low pulse on Enable PIN with some delay_us.
  • step5: Send the Lower Nibble of the I/P command to LCD.
  • step6: Select the Control Register by making RS low.
  • step7: Select Write operation making RW low.
  • step8: Send a High-to-Low pulse on Enable PIN with some delay_us.
• I/P Arguments: 8-bit command supported by LCD
• Return value : none

LCD_DataWrite()

• Function name: LCD_DataWrite()
• Description  :This function sends a character to be displayed on LCD in the following steps.
  • step1: Send the higher nibble of the character to LCD.
  • step2: Select the Data Register by making RS high.
  • step3: Select Write operation making RW low.
  • step4: Send a High-to-Low pulse on Enable PIN with some delay_us.
  • step5: wait for some time
  • step6: Send the lower nibble of the character to LCD.
  • step7: Select the Data Register by making RS high.
  • step8: Select Write operation making RW low.
  • step9: Send a High-to-Low pulse on Enable PIN with some delay_us.
• I/P Arguments: ASCII value of the char to be displayed.
• Return value : none

Keypad

                       PIC 4x4 Keypad Library

• Filename: keypad.c
• Controller: Pica6f877A
• Oscillator: 20 MHz
• Author: XploreLabz
• website: www.xplorelabz.com

Note:

• Rows are connected to lower 4-bits of PORTC.
• Cols are connected to higher 4-bits of PORTC.

KEYPAD_Init()

• Description  : This function the rows and colums for keypad scan
  • ROW lines are configured as Output.
  • Column Lines are configured as Input.
• I/P Arguments:none
• Return value : none

KEYPAD_WaitForKeyRelease()

• Description  : This function waits till the previous key is released.
  • All the ROW lines are pulled high.
  • Column Lines are read to check the key press.
  • If all the Keys are released then Column lines will be low(0x00) .
• I/P Arguments:none
• Return value : none

KEYPAD_WaitForKeyPress()

• Description  : This function waits till a new key is pressed.
  • All the ROW lines are pulled high.
  • Column Lines are read to check the key press.
  • If any Key is pressed then corresponding Column Line goes high.
  • Wait for Some time and perform the above operation to ensure the True Key Press before decoding the KEY.
• I/P Arguments:none
• Return value : none

KEYPAD_ScanKey()

• Description  : This function scans all the rows to decode the key pressed.
  • Each time a ROW line is pulled high to detect the KEY.
  • Column Lines are read to check the key press.
  • If any Key is pressed then corresponding Column Line goes high.
  • Return the ScanCode(Combination of ROW & COL) for decoding the key.
• I/P Arguments:none
• Return value : char--> Scancode of the Key Pressed

KEYPAD_GetKey()

• Description: This function waits till a key is pressed and retuns its ASCII Value
  • Wait till the previous key is released..
  • Wait for the new key press.
  • Scan all the rows one at atime for the pressed key.
  • Decode the key pressed depending on ROW-COL combination and retuns its ASCII value.
• I/P Arguments:none
• Return value : char--> ASCII value of the Key Pressed

UART

     PIC UART library for Serial Communication for 9600 baud rate at 20MHz

• Filename: uart.c
• Controller: Pic16F877A
• Oscillator: 20MHz
• Author: XploreLabz
• website: www.xplorelabz.com

UART_Init()

• Description  :This function is used to initialize the UART at 9600 baud rate by below configuration.
  • TXSTA is configured for Asynchronous mode, 8-bit data & transmitter enabled.
  • RCSTA is configured for continous receive enable.
  • SPBRG is configured 9600 Baud rate at 20MHz.
• I/P Arguments: none
• Return value : none

UART_RxChar()

• Description :This function is used to receive a char from UART module.
  • It waits till a char is received ie.till RCIF is set,
  • RCIF will be set once a CHAR is received.
  • Finally it clears the RCIF for next cycle and returns the received char.
• I/P Arguments: none
• Return value : char

UART_TxChar()

• Description  :This function is used to transmit a char through UART module.
  • It waits till previous char is transmitted ie.till TXIF is set.
  • TXIF will be set once a CHAR is transmitted.
  • It clears the TXIF for next operation.
  • Finally the Char to be transmitted is loaded into TXREG.
• I/P Arguments: char--> data to be transmitted.
• Return value : none

UART_TxString()

• Description :This function is used to transmit the ASCII string through UART.
  • The string_ptr points to the first char of the string.
  • And it is incremented each time to traverse till the end(NULL CHAR).
  • Each time a char is sent to UART_TxChar() fun to transmit it through UART
• I/P Arguments: String(Address of the string) to be transmitted.
• Return value : none

UART_RxString()

• Description  :
  • This function is used to receive a ASCII string through UART till the carriage_return/New_line.
  • The string_ptr points to the begining of the string and each time UART_RxChar() function is called to receive a char and copy it into the buffer(STRING) and incrment string_ptr.
  • Once the carriage_return/New_line is encountered the loop is breaked and the String is NULL terminated.
• I/P Arguments: *string_ptr (Address of the string where the received data needs to be stored)
• Return value : none

NOTE:

• The received char is ECHOED back, if not required then comment UART_TxChar(ch) in the code.
• BackSlash is not taken care.

UART_TxNumber()

• I/P Arguments: unsigned int.
• Return value : none

• Description  :This function is used to transmit a 5-digit integer(0-65535).
• ex:

1. if the number is 12345 then 12345 is transmitted.
2. if the number is 123 then 00123 is transmitted.

I2C

                                PIC I2C  library

• Filename: I2C.c
• Controller: Pic16f877A(PIC family)
• Oscillator: 11.0592 MHz
• Author: XploreLabz
• website: www.xplorelabz.com

Note:

• The SDA and SCL lines are connected to PORTC.4 and PORTC.3
• The code can be modified to connect the SDA and SCL to any of the PORTs by changing the #define

I2C_Clock()

• Description  :This function is used to generate a clock pulse on SCL line.
• I/P Arguments: none
• Return value : none

I2C_Start()

• I/P Arguments: none
• Return value : none
• Description  :This function is used to generate I2C Start Condition.
  • Start Condition: SDA goes low when SCL is High.

I2C_Stop()

• I/P Arguments: none
• Return value : none
• Description  :This function is used to generate I2C Stop Condition.
  • Stop Condition: SDA goes High when SCL is High.

I2C_Write()

• I/P Arguments: unsigned char-->8bit data to be sent.
• Return value : none
• Description  :This function is used to send a byte on SDA line using I2C protocol
  • 8bit data is sent bit-by-bit on each clock cycle.
  • MSB(bit) is sent first and LSB(bit) is sent at last.
  • Data is sent when SCL is low.

I2C_Read()

• I/P Arguments: none
• Return value : Unsigned char(received byte)
• Description :This fun is used to receive a byte on SDA line using I2C protocol.
  • 8bit data is received bit-by-bit each clock and finally packed into Byte.
  • MSB(bit) is received first and LSB(bit) is received at last.

I2C_Ack()

• Description  :This function is used to generate a the Positive ACK pulse on SDA after receiving a byte.
• I/P Arguments: none.
• Return value : none

I2C_NoAck()

• Description  :This function is used to generate a the Negative/NO ACK pulse on SDA after receiving all bytes.
• I/P Arguments: none
• Return value : none

Ds1307_RTC

                              PIC DS1307  library

• Filename: DS1307.c
• Controller: Pic16f877A(PIC family)
• Oscillator: 11.0592 MHz
• Author: XploreLabz
• website: www.xplorelabz.com

• Below values are fixed and should not be changed.
• Refer Ds1307 DataSheet for more info.

DS1307_Init()

• Description :This function is used to initialize the Ds1307 RTC.
  • Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.
  • After selecting DS1307, write 0x00 into Control register of Ds1307
• I/P Arguments: none
• Return value : none

DS1307_Write()

• Description :This function is used to write a byte of data into Ds1307 RTC.
  • This function calls I2C_write function to perform the same.
• I/P Arguments: char-> Data to be written into DS1307.
• Return value : none

DS1307_Read()

• Description : This function is used to read a byte of data from Ds1307 RTC.
  • This function calls I2C_Read function to perform the same.
• I/P Arguments: char-> Data to be written into DS1307.
• Return value : none

DS1307_SetTime()

• Description  :This function is used to set Time(hh,mm,ss) into the Ds1307 RTC.
  • Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.
  • After selecting DS1307, select the RAM address 0x00 to point to sec
  • Initilze Sec, MIN, Hour one after the other.
  • Stop the I2c communication.
• I/P Arguments: char,char,char-->hh,mm,ss to initilize the time into DS1307.
• Return value : none

DS1307_SetDate()

• Description  :This function is used to set Date(dd,mm,yy) into the Ds1307 RTC.
  • Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.
  • After selecting DS1307, select the RAM address 0x04 to point to day
  • Initilze Day,Month and Year one after the other.
  • Stop the I2c communication.
• I/P Arguments: char,char,char-->day,month,year to initilize the Date into DS1307.
• Return value : none

DS1307_GetTime()

• Description  :This function is used to get the Time(hh,mm,ss) from Ds1307 RTC.
  • Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.
  • After selecting DS1307, select the RAM address 0x00 to point to sec
  • Get Sec, MIN, Hour one after the other.
  • Stop the I2c communication.
• I/P Arguments: char *,char *,char *-->pointers to get the hh,mm,ss.
• Return value : none

DS1307_GetDate()

• Description  :This function is used to get the Date(y,m,d) from Ds1307 RTC.
  • Ds1307 ic is enabled by sending the DS1307 id on the I2C bus.
  • After selecting DS1307, select the RAM address 0x00 to point to DAY
  • Get Day, Month, Year one after the other.
  • Stop the I2c communication.
• I/P Arguments: char *,char *,char *-->pointers to get the y,m,d.
• Return value : none

EEPROM

                               Pic16f877A EEPROM library

• Filename: eeprom.c
• Controller: Pic16f877A
• Oscillator: 20 MHz
• Author: XploreLabz
• website: www.xplorelabz.com

EEPROM_WriteByte()

• Description:This function is used to write the data at specified EEPROM_address..
• I/P Arguments: char,char-->eeprom_address at which eeprom_data is to be written.
• Return value : none

EEPROM_ReadByte()

• Description: This function is used to read the data from specified EEPROM_address.
• I/P Arguments: char-->eeprom_address from where eeprom_data is to be read.
• Return value : char-->data read from Eeprom.

EEPROM_WriteNBytes()

• Description: This function is used to write N-bytes of data at specified EEPROM_address.
  • EEPROM_WriteByte() function is called to write a byte at atime.
  • Source(RAM) and destination(EEPROM) address are incremented after each write
  • NoOfBytes is Decemented each time a byte is written.
  • Above Operation is carried out till all the bytes are written(NoOfBytes!=0).
• I/P Arguments:

1. char,-->eeprom_address from where the N-bytes are to be written.
2. char*-->Pointer to the N-bytes of data to be written.
3. char --> Number of bytes to be written.

• Return value : none

EEPROM_ReadNBytes()

• Description: This function is used to Read N-bytes of data from specified EEPROM_address.
  • EEPROM_ReadByte() func is called to read a byte at a time.
  • Source(RAM) and destination(EEPROM) address are incremented each time.
  • NoOfBytes is Decemented after a byte is read.
  • Above Operation is carried out till all the bytes are read(NoOfBytes!=0).
• I/P Arguments:

1. char,-->eeprom_address from where the N-bytes is to be read.
2. char*-->Pointer into which the N-bytes of data is to be read.
3. char --> Number of bytes to be Read

• Return value : none

EEPROM_WriteString()

• Description:This function is used to Write a String at specified EEPROM_address.
  • EEPROM_WriteByte() function is called to write a byte at a time.
  • Source(RAM) and destination(EEPOM) address are incremented each time.
  • Above Operation is carried out till Null char is identified.
• I/P Arguments:

1. char,-->eeprom_address where the String is to be written.
2. char*-->Pointer to String which has to be written.

• Return value : none

NOTE:

• Null char is also written into the eeprom.

EEPROM_ReadString()

• Description:This function is used to Read a String from specified EEPROM_address.
  • EEPROM_ReadByte() function is called to read a byte at a time.
  • Source(EEPROM) and destination(RAM) address are incremented each time.
  • Above Operation is carried out till Null char is identified.
• I/P Arguments:

1. char,-->eeprom_address from where the String is to be read.
2. char*-->Pointer into which the String is to be read.

• Return value : none

EEPROM_Erase()

• Description:This function is used to erase the entire Eeprom memory.
  • Eeprom is filled with 0xFF to accomplish the Eeprom Erase.
  • EEPROM_WriteByte() function is called to write a byte at a time.
  • Whole memory(0-255) is traversed and filled with 0xFF
• I/P Arguments: none
• Return value : none

PIC Library Usage Guide

PIC Library Usage Guide