TouchGFX issue regarding board revision

This tutorial addresses a specific issue encountered when using TouchGFX with a particular board revision. TouchGFX, a widely used graphical user interface (GUI) framework for embedded systems, is typically seamless in integration. However, certain board revisions may introduce compatibility problems due to hardware changes, software mismatches, or configuration conflicts.

The purpose of this document is to:

1. Identify the root cause of the issue.
2. Explain the impact on system performance and behavior.
3. Provide step-by-step guidance to resolve or work around the problem.

By following this short tutorial, developers and engineers can ensure TouchGFX functions correctly on the affected board revisions and minimize project delays.

Details regarding the changes between board revisions can be found in the changelog. The changelog provides a list of modifications, including hardware updates and design adjustments, which may impact compatibility with TouchGFX. Users are encouraged to review the changelog to identify any relevant differences that could affect their projects.

Changlog is available within the products webpage.

The issue with STM modules has been reported by a large number of customers. Generally, the problem arises when, despite successfully creating a GUI project in TouchGFX and programming the module, nothing is displayed on the target module. The issue is related to the board revision of the module. Each board revision has a dedicated template available within the TGFX software. Importantly, each template includes a description specifying which board revision it is designed for.

How to check revision on board 7" module (right side) and 10" module(left side).

TouchGFX template for 7" board revision 1.2

TouchGFX template for 7" board revision 1.3

TouchGFX template for 10" board revision 1.5

TouchGFX template for 10" board revision 1.6

Note: Sometimes, a problem may occur with older revision templates, such as version 1.2 in STM 7″ modules and version 1.5 in STM 10″ modules. If the issue persists, consider updating the templates to a newer version.

Steps to Resolve the Problem:

1. Save the project in TouchGFX.
2. Open the .ioc file from the project folder using CubeMX.
3. Click on Generate Code in CubeMX.
4. Save the file.
5. Return to TouchGFX, click generate code(F4).
6. Contiune working on project.