C55XX CSL EXAMPLE: LCD EXAMPLE DOCUMENTATION

LCD EXAMPLE1 - DIAGRAM DISPLAY TEST

TEST DESCRIPTION:

This test code demonstrates following functionalities of the CSL LCDC module on the C5505/C5515 LCD panel.

Drawing a Rectangle
Drawing a Circle
Drawing a Line
Copying an Icon
Moving an Icon Drawing rectangle is done by drawRectangle() API which displays a Red color rectangle on the LCD. Drawing circle is done by drawCircle() API which displays a blue color circle on the LCD. Drawing line is done by drawLine() API which displays a white color line on the LCD. Copying icon is done by iconCopy() API which copies a small portion of image from the rectangle and displays on the LCD. This copied icon will be in the square shape. Moving icon is done by iconMove() API which moves a small portion of image from the circle and displays on the LCD. This moved icon will be in the rectangular shape. A Black colored rectangular hole will be created on the circle due to moving the icon from circle space. This example uses 65k color mode.

   Position of the images drawn on the LCD screen will be as shown below, when
   the LCD is viewed with JTAG port on the left hand side and Power port on the
   right hand side.

     ================
     =  RRRR  CCCC  =
     =  RRRR  CCCC  =
     =  RRRR  CCCC  =
     =              =
     = LLLLLLLLLLLL =
     =              =
     = IM        IC =
     ================

     'R'  - Position of the Rectangle
     'C'  - Position of the Circle
     'L'  - Position of the Line
     'IM' - Position of moved icon from circle
     'IC' - Position of copied icon from rectangle

Manual inspection is required to determine the success/failure of the test. Execution status of each API will be displayed on the CCS stdout window.

NOTE: THIS TEST HAS BEEN DEVELOPED TO WORK WITH CHIP VERSIONS C5505 AND C5515. MAKE SURE THAT PROPER CHIP VERSION MACRO IS DEFINED IN THE FILE c55xx_csl\inc\csl_general.h.

TEST PROCEDURE:

Open the CCS and connect the target (C5505/C5515 EVM)
Open the project "CSL_LCDC_DiagramExample_Out.pjt" and build it
Load the program on to the target
Set the PLL frequency to 12.288MHz
Run the program and observe the test result
Repeat the test at PLL frequencies 40, 60, 75 and 100MHz
Repeat the test in Release mode

TEST RESULT:

All the CSL APIs should return success.
All the objects displayed on the LCD of the C5505/C5515 EVM should be clear, with proper color and at proper position as described in the TEST DESCRIPTION section.

============================================================================

LCD EXAMPLE2 - DMA POLL TEST

TEST DESCRIPTION:

This test code demonstrates DMA mode of operation of the CSL LCD module. DMA module of LCD operates with out using the interrupts. During this test LCD panel will be filled with two colors; Blue and Red. Upper half of the LCD will be colored Blue and lower half of the LCD will be colored Red. Filling the colors will be done in two steps. In the first step test code configures CSL LCD module and DMA to fill upper half of the LCD with Blue color. In the second step test code configures CSL LCD module and DMA to fill lower half of the LCD with Red color. DMA used for LCD data transfer is internal to the LCD controller and is not the DMA of C5505/C5515 DSP. This example uses 256 color mode.

NOTE: Data buffer used by the LCD in DMA mode should be allocated in the SARAM. This test code places the 'gLcdBuf' in SARAM using pragma macro.

   LCD display after running the test will be as shown below, when
   the LCD is viewed with JTAG port on the left hand side and Power port on the
   right hand side.

     ====================
     ====================
     == BBBBBBBBBBBBBB ==
     == BBBBBBBBBBBBBB ==
     == BBBBBBBBBBBBBB ==
     == RRRRRRRRRRRRRR ==
     == RRRRRRRRRRRRRR ==
     == RRRRRRRRRRRRRR ==
     ====================
     ====================

     'B' - Part of LCD colored in Blue
     'R' - Part of LCD colored in Red

Manual inspection is required to determine the success/failure of the test. Execution status of each API will be displayed on the CCS stdout window.

TEST PROCEDURE:

Open the CCS and connect the target (C5505 EVM)
Open the project "CSL_LCDC_DmaPolledExample_Out.pjt" and build it
Load the program on to the target
Set the PLL frequency to 12.288MHz
Run the program and observe the test result
Repeat the test at PLL frequencies 40, 60, 75 and 100MHz
Repeat the test in Release mode

TEST RESULT:

All the CSL APIs should return success.
Upper Half of the LCD panel should be filled with BLUE color
Lower Half of the LCD panel should be filled with RED color

============================================================================

LCD EXAMPLE3 - DMA INTERRUPT TEST

TEST DESCRIPTION:

This test code demonstrates DMA mode of operation of the CSL LCD module. DMA module of LCD operates using the interrupts.During this test LCD panel will be filled with two colors; Blue and Green. Left half of the LCD will be colored Blue and right half of the LCD will be colored Green. Filling the colors will be done in two steps. In the first step test code configures CSL LCD module and DMA to fill left half of the LCD with Blue color. In the second step test code configures CSL LCD module and DMA to fill right half of the LCD with Green color. DMA used for LCD data transfer is internal to the LCD controller and is not the DMA of C5505/C5515 DSP. This example uses 256 color mode.

NOTE: Data buffer used by the LCD in DMA mode should be allocated in the SARAM. This test code places the 'gLcdBuf' in SARAM using pragma macro.

   LCD display after running the test will be as shown below, when
   the LCD is viewed with JTAG port on the left hand side and Power port on the
   right hand side.

     ====================
     ====================
     == BBBBBBBGGGGGGG ==
     == BBBBBBBGGGGGGG ==
     == BBBBBBBGGGGGGG ==
     == BBBBBBBGGGGGGG ==
     == BBBBBBBGGGGGGG ==
     == BBBBBBBGGGGGGG ==
     ====================
     ====================

     'B' - Part of LCD colored in Blue
     'G' - Part of LCD colored in Green

Manual inspection is required to determine the success/failure of the test. Execution status of each API will be displayed on the CCS stdout window.

TEST PROCEDURE:

Open the CCS and connect the target (C5505 EVM)
Open the project "CSL_LCDC_DmaIntcExample_Out.pjt" and build it
Load the program on to the target
Set the PLL frequency to 12.288MHz
Run the program and observe the test result
Repeat the test at PLL frequencies 40, 60, 75 and 100MHz
Repeat the test in Release mode

TEST RESULT:

All the CSL APIs should return success.
Left Half of the LCD panel should be filled with BLUE color
Right Half of the LCD panel should be filled with GREEN color

============================================================================

LCD EXAMPLE4 - TEXT DISPLAY TEST

TEST DESCRIPTION:

This test code demonstrates displaying a string of characters on the LCD panel. Different text is displayed on the LCD panel in two steps.

In the first step two character strings are displayed on the LCD panel using DMA mode with text in White color. LCD panel is divided into two vertical parts to display the strings in separate planes. String "IMAGINATION IS BEGINNING OF CREATION.YOU IMAGINE WHAT YOU DESIRE" will be displayed on the left half of the LCD. String "YOU WILL WHAT YOU IMAGINE AND AT LAST YOU CREATE WHAT YOU WILL" will be displayed on the right half of the LCD. This two strings will be displayed for few seconds and then text will be cleared line by line. During this step text displayed will be smaller in size as the LCD panel is divided into two parts.

In the second step one character string will be displayed on the LCD panel using polled mode with text in Red color. String "CSL FOR TEXAS INSTRUMENTS C5505(C5515) LCD MODULE" will be displayed on complete plane of the LCD. During this step text displayed will be bigger in size and more clear.

NOTE: THIS TEST HAS BEEN DEVELOPED TO WORK WITH CHIP VERSIONS C5505 AND C5515. MAKE SURE THAT PROPER CHIP VERSION MACRO IS DEFINED IN THE FILE c55xx_csl\inc\csl_general.h.

TEST PROCEDURE:

Open the CCS and connect the target (C5505/C5515 EVM)
Open the project "CSL_LCDC_TextDisplayExample_Out.pjt" and build it
Load the program on to the target
Set the PLL frequency to 12.288MHz
Run the program and observe the test result
Repeat the test at PLL frequencies 40, 60, 75 and 100MHz
Repeat the test in Release mode

TEST RESULT:

All the CSL APIs should return success.
String "IMAGINATION IS BEGINNING OF CREATION.YOU IMAGINE WHAT YOU DESIRE" should be displayed on the left half of the LCD. String "YOU WILL WHAT YOU IMAGINE AND AT LAST YOU CREATE WHAT YOU WILL" will be displayed on the right half of the LCD. The strings should be cleared line by line after few seconds.
String "CSL FOR TEXAS INSTRUMENTS C5505(C5515) LCD MODULE" should be displayed on the LCD panel with text in Red color.

=============================================================================

LCD EXAMPLE5 - 65K COLOR MODE TEST

TEST DESCRIPTION:

This test code demonstrates 65k color mode operation of CSL LCD module. LCD controller on the EVM supports three color modes; 256, 65k and 262k. In 65k color mode each color is represented using two 8 bit data. LCD controller on the EVM is interfaced to LCD panel using 8-bit data interface. Each pixel data will be sent to the LCD in two 16 bit words, each word carrying one 8-bit information of the color. Color information is transferred to LCDC registers using internal DMA module.

DMA module of LCD operates using the interrupts.During this test LCD panel will be filled with two colors; Red and Green. Upper half of the LCD will be filled Red color and lower half of the LCD will be filled with green color. Filling the colors will be done in two steps. In the first step test code configures CSL LCD module and DMA to fill upper half of the LCD with Red color. In the second step test code configures CSL LCD module and DMA to fill lower half of the LCD with Green color. DMA used for LCD data transfer is internal to the LCD controller and is not the DMA of C5505/C5515 DSP.

NOTE: Data buffer used by the LCD in DMA mode should be allocated in the SARAM. This test code places the 'gLcdBuf' in SARAM using pragma macro.

NOTE: Macro 'LCD_65K_COLOR_MODE' should be defined to enable the color value and other configurations for 65k color mode. This macro was defined in project build options.

   LCD display after running the test will be as shown below, when
   the LCD is viewed with JTAG port on the left hand side and Power port on the
   right hand side.

     ====================
     ====================
     == RRRRRRRRRRRRRR ==
     == RRRRRRRRRRRRRR ==
     == RRRRRRRRRRRRRR ==
     == GGGGGGGGGGGGGG ==
     == GGGGGGGGGGGGGG ==
     == GGGGGGGGGGGGGG ==
     ====================
     ====================

     'R' - Part of LCD colored in Red
     'G' - Part of LCD colored in Green

Manual inspection is required to determine the success/failure of the test. Execution status of each API will be displayed on the CCS stdout window.

NOTE: THIS TEST HAS BEEN DEVELOPED TO WORK WITH CHIP VERSIONS C5505 AND C5515. MAKE SURE THAT PROPER CHIP VERSION MACRO IS DEFINED IN THE FILE c55xx_csl\inc\csl_general.h.

TEST PROCEDURE:

Open the CCS and connect the target (C5505/C5515 EVM)
Open the project "CSL_LCDC_65kColorModeExample_Out.pjt" and build it
Load the program on to the target
Set the PLL frequency to 12.288MHz
Run the program and observe the test result
Repeat the test at PLL frequencies 40, 60, 75 and 100MHz
Repeat the test in Release mode

TEST RESULT:

All the CSL APIs should return success.
Upper Half of the LCD panel should be filled with RED color
Lower Half of the LCD panel should be filled with GREEN color

============================================================================

LCD EXAMPLE5 - 262K COLOR MODE TEST

TEST DESCRIPTION:

This test code demonstrates 262k color mode operation of CSL LCD module. LCD controller on the EVM supports three color modes; 256, 65k and 262k. In 262k color mode each color is represented using three 6 bit data. LCD controller on the EVM is interfaced to LCD panel using 8-bit data interface. Each pixel data will be sent to the LCD in three 16 bit words, each word carrying one 6-bit information of the color. Color information is transferred to LCDC registers using internal DMA module.

DMA module of LCD operates using the interrupts.During this test LCD panel will be filled with two colors; White and Blue. Upper half of the LCD will be filled White color and lower half of the LCD will be filled with Blue color. Filling the colors will be done in two steps. In the first step test code configures CSL LCD module and DMA to fill upper half of the LCD with White color. In the second step test code configures CSL LCD module and DMA to fill lower half of the LCD with Blue color. DMA used for LCD data transfer is internal to the LCD controller and is not the DMA of C5505/C5515 DSP.

NOTE: Data buffer used by the LCD in DMA mode should be allocated in the SARAM. This test code places the 'gLcdBuf' in SARAM using pragma macro.

NOTE: Macro 'LCD_262K_COLOR_MODE' should be defined to enable the color value and other configurations for 262k color mode. This macro was defined in project build options.

   LCD display after running the test will be as shown below, when
   the LCD is viewed with JTAG port on the left hand side and Power port on the
   right hand side.

     ====================
     ====================
     == WWWWWWWWWWWWWW ==
     == WWWWWWWWWWWWWW ==
     == WWWWWWWWWWWWWW ==
     == BBBBBBBBBBBBBB ==
     == BBBBBBBBBBBBBB ==
     == BBBBBBBBBBBBBB ==
     ====================
     ====================

     'W' - Part of LCD colored in White
     'B' - Part of LCD colored Blue

Manual inspection is required to determine the success/failure of the test. Execution status of each API will be displayed on the CCS stdout window.

NOTE: THIS TEST HAS BEEN DEVELOPED TO WORK WITH CHIP VERSIONS C5505 AND C5515. MAKE SURE THAT PROPER CHIP VERSION MACRO IS DEFINED IN THE FILE c55xx_csl\inc\csl_general.h.

TEST PROCEDURE:

Open the CCS and connect the target (C5505/C5515 EVM)
Open the project "CSL_LCDC_262kColorModeExample_Out.pjt" and build it
Load the program on to the target
Set the PLL frequency to 12.288MHz
Run the program and observe the test result
Repeat the test at PLL frequencies 40, 60, 75 and 100MHz
Repeat the test in Release mode

TEST RESULT:

All the CSL APIs should return success.
Upper Half of the LCD panel should be filled with WHITE color
Lower Half of the LCD panel should be filled with BLUE color