PIC16F877 JHD-2X16-I2C LCD with HD44780 Controller

/**
 * @brief Main program entry point
 */
void main(void) {
    systemInit();
    
    while (1) {
        demoBasicPrinting();      // Show basic printing and custom characters
        demoAutoScroll();         // Demonstrate auto-scrolling text
        demoCursorControl();      // Demonstrate cursor and blinking controls
        demoDisplayControl();     // Show display on/off functionality
        demoTextDirection();      // Test text direction control
        demoScrolling();          // Scroll text left and right
        demoHomeCommand();        // Test home command (reset cursor)
    }
}

/**
 * @brief Initialize system components and custom characters
 */
void systemInit(void) {
    I2C_Master_Init();          // Initialize I2C master interface
    LCD_Init(LCD_ADDRESS);      // Initialize LCD with specified I2C address
    LCD_Clear();                // Clear the LCD display
    
    // Initialize custom characters
    LCD_CreateCustomChar(0, SMILEY);         // Create smiley character
    LCD_CreateCustomChar(1, LAUGHING_SMILEY); // Create laughing smiley character
}

/**
 * @brief Demonstrate basic text printing and custom characters
 */
void demoBasicPrinting(void) {
    LCD_Clear();                 // Clear the screen
    LCD_SetCursor(0, 0);         // Set cursor to the first row, first column
    LCD_Print_String("Hello! Like");  // Print a message
    LCD_SetCursor(0, 1);         // Move cursor to the second row, first column
    LCD_Print_String("SUBSCRIBE ");  // Print another message
    
    // Display custom characters (smiley and laughing smiley)
    LCD_Print_Char(0);           // Print the first custom character
    LCD_Print_Char(1);           // Print the second custom character
    LCD_Print_Char(0);           // Print the first custom character again
    
    __delay_ms(DELAY_EXTRA);     // Wait for the specified extra delay
}

/**
 * @brief Demonstrate auto-scroll functionality
 */
void demoAutoScroll(void) {
    LCD_Clear();                 // Clear the screen
    LCD_SetCursor(0, 0);         // Set cursor to the first row, first column
    LCD_Print_String("AutoScroll Test");  // Print a message
    LCD_AutoScroll_ON();         // Enable auto-scroll feature
    
    // Print some characters while auto-scrolling
    for (int i = 0; i < AUTOSCROLL_COUNT; i++) {
        LCD_Print_Char('.');     // Print a dot
        __delay_ms(DELAY_SHORT); // Wait for short delay
    }
    
    LCD_AutoScroll_OFF();        // Disable auto-scrolling
    __delay_ms(DELAY_LONG);      // Wait for a long delay
}

/**
 * @brief Demonstrate cursor and blink control
 */
void demoCursorControl(void) {
    LCD_Clear();                 // Clear the screen
    LCD_SetCursor(0, 0);         // Set cursor to the first row, first column
    LCD_Print_String("Cursor ON");  // Print cursor on message
    LCD_Cursor_ON();             // Enable cursor visibility
    __delay_ms(DELAY_MEDIUM);    // Wait for medium delay
    
    LCD_SetCursor(0, 1);         // Set cursor to the second row, first column
    LCD_Print_String("Blink ON");  // Print blink on message
    LCD_Blink_ON();              // Enable cursor blink
    __delay_ms(DELAY_MEDIUM);    // Wait for medium delay
    
    LCD_Blink_OFF();             // Disable blink
    LCD_Cursor_OFF();            // Disable cursor visibility
    LCD_Clear();                 // Clear the screen
    LCD_SetCursor(0, 0);         // Set cursor to the first row, first column
    LCD_Print_String("Cursor/Blink OFF"); // Show cursor/blink off message
    __delay_ms(DELAY_LONG);      // Wait for a long delay
}