Skip to main content
Renesas Singapore - Knowledgebase

sf_el_gx Module Guide Resources

Last Updated:03/13/2018


Where can I find the references to module guide resources for the Express Logic GUIX Synergy Port module on sf_el_gx?


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


The Express Logic GUIX Synergy Port Module, SF_EL_GX, is the Express Logic GUIXTM adaptation layer for Synergy MCU groups, which have graphics engines GLCDC, DRW (2DG engine) or a JPEG decode engine. The API supports graphics hardware engine setup for GUIX and supports graphics rendering and displaying accelerated by hardware engines. The module defines full-set of GUIX low-level display driver functions which draw graphics accelerated by DRW (2DG engine) or JPEG, or displays graphics with GLCDC (See the GUIX User Guide Chapter 5: GUIX Display Drivers). The module encourages the hardware acceleration for graphics rendering but also allows software processing without hardware support.

The GUIX Synergy Port Framework module features include:

  • Adapts GUIX to the SSP Framework
  • Attaches the SSP Display Interface driver to GUIX Display Driver Interface
  • Allows GUIX to draw widgets accelerated by the Synergy D2W (2DG) engine
  • Allows GUIX to draw widgets accelerated by the Synergy JPEG engine
  • Supports double-buffer toggling control for screen transitions without tearing
  • Supports screen rotation (90/180/270 degree)
  • Supports various output color formats
    • 32bpp (ARGB8888, RGB-888)
    • 16bpp (RGB565)
    • 8bpp (8bit Palette (CLUT))
  • Support for user callback functions


Module Guide

The GUIX Synergy Port Framework module guide is targeted for SSP 1.2.0 and above and the SK-S7G2 Kit.

The most recent versions of the GUIX Synergy Port Framework module guide application note, application project and import guide are available here.


Module Guide Errata

Section Module Operational Notes, Added paragraph and bullet point

Size of JPEG Work Buffer

The JPEG work buffer trades off the JPEG decode speed against the buffer size. When a widget on the screen is formatted in JPEG, the JPEG work buffer is used as a temporary storage memory to create the decoded image. If the buffer size is not large enough for decoding an entire image, JPEG decoding is performed in the output buffer streaming mode. BitBLT operation by 2D Drawing engine decodes a piece of JPEG raster image in the buffer, then transfers it to the frame buffer. The minimum size of JPEG work buffer is {(The number of pixels in the horizontal line) x (bpp (bytes per pixel) of the display format) x 8 (lines)}. For instance, if the decoded image is 800 pixels in a horizontal line and RGB565 format, the number is 800 x 2 x 8= 12 800 (byte). If the buffer size was smaller than this number, JPEG decoding will not be processed. To get better throughput, parameter “Size of the JPEG Work Buffer” should be set as much as larger because it improves the JPEG decode throughput. The JPEG output buffer streaming mode repeats partial JPEG decode operations and the repletion comes to be overhead.

D/AVE 2D buffer cache

The D/AVE 2D buffer cache can be enabled or disabled through following configuration in the Synergy Configurator. Disable it when images with high resolution and 32 bit ARGB8888 color format are used.

  • D/AVE 2D Frame Buffer Cache (Valid if D/AVE 2D Drawing Engine is enabled)

Screen Tearing in Single Buffer Designs

  • Screen tearing is a visual artifact in video display where a display device shows information from multiple frames in a single screen draw. In general, a system with a single frame buffer can cause the screen tearing issue on a LCD panel. The module allows users to have single frame buffer (set NULL to @ref sf_el_gx_cfg_t::p_framebuffer_b) but does not care for the screen tearing. It is recommended to have a ping-pong frame buffer system to consist of two frame buffers.


Module Guide Resources

  • HMI Brushless DC (BLDC) Motor Controller - Application Project here.
  • PE-HMI1 GUIX "Hello World" - Application Project here.
  • GUIX "Hello World" for DK-S7G2 GUI Application here.

Known issues

  • Refer to the SSP release notes for known issues, available here.
Suitable Products
  • Was this article helpful?