Skip to main content
Renesas Electronics America - Knowledgebase

r_glcd Module Guide Resources

Last Updated:03/09/2018


Where can I find the references to module guide resources for the GLCD HAL module on r_glcd?


Information on the module guide itself and the associated resources and known issues are available here.


The GLCD HAL module is a high-level API for GLCD applications and is implemented on r_GLCD. The GLCD HAL module uses the Graphics LCD Driver peripheral on the Synergy MCU. A user-defined callback can be created to handle frame buffer switching and underflow detection.

The GLCD HAL module supports the following features:

  • Supports LCD panels with RGB interface (up to 24 bits) and sync signals (HSYNC, VSYNC, and Data Enable(optional)
  • Supports various color formats for input graphics planes (RGB888, ARGB888, RGB565, ARGB1555, ARGB4444, CLUT8, CLUT4, CLUT1)
  • Supports CLUT (Color Look-Up Table) usage for input graphics planes with 512 words (32 bits/word)
  • Supports various color formats for output (RGB888, RGB666, RGB565, Serial RGB)
  • Can input two graphics planes on top of the background plane and blend them on the screen
  • Generates a dot clock to the panel. The clock source is selectable from internal or external (LCD_EXTCLK)
  • Supports brightness adjustment, contrast adjustment, and gamma correction
  • Supports GLCDCC interrupts to handle frame buffer switching or underflow detection

Module Guide

The GLCD HAL module guide is targeted for SSP 1.2.0 and later, and the SK-S7G2 Kit.

The most recent versions of the DAC HAL module guide application note, application project and import guide are available here.

Module Guide Errata

Section 6: Using the GLCD module in an application- change to instruction steps

The typical steps in using the GLCDC HAL module in an application are:

  1. Initialize the GLCDC HAL module with the open API.
  2. Draw a primary image in the frame buffer with application code.
  3. Start the image displaying using the start API.
  4. Stop the display of the image using the stop API.
  5. Copy the source CLUT data to the CLUT SRAM using the clutUpdate API.
  6. Draw a new image in the frame buffer to update the display with application code. Typical user systems consist of the ping-pong frame buffer system, so draw the image to another frame buffer which is not used for displaying at that point.
  7. Request the frame buffer toggling to GLCDC hardware with the layerChange API.
  8. The GLCDC hardware toggles frame buffer and display a new image from the next frame.
  9. Perform color correction using the colorCorrection API.
  10. Get the status of display using the statusGet API.
  11. Get the version of the driver using the versionGet API.
  12. Close the GLCDC module by calling the close API.

To synchronize application code to the completion of drawing current frame buffer, use the line-detection interrupt and notify the timing to application code through the GLCDC callback.

Module Guide Resources

  • PDC Capture LCD DK-S7G2 with SSP 1.2.0 - Application Project here
  • Getting Started with the Weather Panel Application - Application Project here

Known issues

  • No known issues as of posting date
Suitable Products
GLCD HAL module on r_glcd (SSP 1.2.0)
  • Was this article helpful?