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
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:
- Initialize the GLCDC HAL module with the open API.
- Draw a primary image in the frame buffer with application code.
- Start the image displaying using the start API.
- Stop the display of the image using the stop API.
- Copy the source CLUT data to the CLUT SRAM using the clutUpdate API.
- 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.
- Request the frame buffer toggling to GLCDC hardware with the layerChange API.
- The GLCDC hardware toggles frame buffer and display a new image from the next frame.
- Perform color correction using the colorCorrection API.
- Get the status of display using the statusGet API.
- Get the version of the driver using the versionGet API.
- 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
- No known issues as of posting date
|GLCD HAL module on r_glcd (SSP 1.2.0)|