跳转到主要内容

调试

由于TouchGFX应用程序是一组由TouchGFX Designer、TouchGFX Generator生成并由开发人员编写的C++文件,因此可以像任何其他C++应用程序一样调试。

目标板卡调试

如果您正在使用像IAR Workbench、Keil uVision或STM32CubeIDE这样的IDE,则可以直接使用IDE的可用机制进行目标板卡调试。 由TouchGFX Generator或直接从TouchGFX板件设置生成的TouchGFX项目可以直接使用选定的工具链进行调试。

Board bring up代码和TouchGFX AL只在目标板卡上执行,因此需要在那部分进行调试。 应用程序的UI部分可以在目标板卡或使用模拟器进行调试。 在目标板卡上,您通常会调试性能问题等,如动画速度、更新频率和响应能力。 其他特定于UI的问题可以在目标上调试,但使用模拟器调试通常会更快。

模拟器调试

调试与UI相关的问题,如动画动作、转换、元素更新、程序逻辑等等;在大多数情况下,使用模拟器进行测试和调试比每次烧录板卡要高效得多。

TouchGFX应用程序还支持Visual Studio,并为其提供和维护一个项目文件。 使用Visual Studio时,可以在调试模式下运行模拟器,可以利用IDE的所有调试功能。

如果想要使用模拟器进行调试,您可以不局限于Visual Studio。 应用程序可以通过GCC进行编译,如果你在使用一个不同的IDE, 可能在配置调试一个GCC编译通过过的项目。 然而, 对于你选择的IDE, 你需要自己进行配置.

在Visual Studio中调试

使用DebugPrinter

DebugPrinter类是一种在显示屏上打印调试消息的简单方法,无需向屏幕添加TextArea或其他控件。 例如,这种方法可用于显示来自后端的事件、或FPS或渲染时间等测量值。

在使用DebugPrinter之前,需要分配一个实例并将其传递给Application类。 例如,这可以在FrontendApplication的构造函数中实现:

调试打印器需要和帧缓冲区格式保持兼容。 这里,我们可以在gui/src/common/FrontendApplication.cpp中添加一个16bpp调试打印器:

#include <gui/common/FrontendApplication.hpp>

#include <platform/driver/lcd/LCD16bpp.hpp>
LCD16DebugPrinter lcd16bppDebugPrinter;

FrontendApplication::FrontendApplication(Model& m, FrontendHeap& heap)
: FrontendApplicationBase(m, heap)
{
lcd16bppDebugPrinter.setPosition(0, 0, 240, 40);
lcd16bppDebugPrinter.setScale(2);
lcd16bppDebugPrinter.setColor(0x00); //black
Application::setDebugPrinter(&lcd16bppDebugPrinter);
}

在这里,我们已经配置了DebugPrinter在上方写入240 x 40像素。
在您的应用程序中,现在可以使用以下代码打印字符串:

char debugStringBuffer[30];
void updateDebugString()
{
static int count = 0;
count++;
snprintf(debugStringBuffer, sizeof(debugStringBuffer), "tick: %d", count);
Application::getDebugPrinter()->setString(debugStringBuffer);
Application::invalidateDebugRegion();
}
Note
从ascii 32(空格)到ascii 126(’~’)的字符均可用。

DebugPrinter类

DebugPrinter实例必须兼容所使用的LCD类。 该表列出了DebugPrinter类名称:

LCD 类DebugPrinter类
LCD1bppLCD1DebugPrinter
LCD2bppLCD2DebugPrinter
LCD4bppLCD4DebugPrinter
LCD8bpp_ARGB2222LCD8ARGB2222DebugPrinter
LCD8bpp_ABGR2222LCD8ABGR2222DebugPrinter
LCD8bpp_RGBA2222LCD8RGBA2222DebugPrinter
LCD8bpp_BGRA2222LCD8BGRA2222DebugPrinter
LCD16bppLCD16DebugPrinter
LCD16bppSerialFlashLCD16DebugPrinter
LCD24bppLCD24DebugPrinter
LCD32bppLCD32DebugPrinter

使用与正在使用的LCD类匹配的DebugPrinter类。