Files
CelloEffects/readme.md
T

2.4 KiB

STM32H7S78-DK Audio Effects Processor with TouchGFX

Project Overview

This dual-boot project consists of two components:

Project Directory Purpose
Boot /Boot/ Bootloader - initializes hardware, loads application from external flash
Appli /Appli/ Main application - TouchGFX UI + audio processing

Build & Flash

Prerequisites

  • STM32CubeIDE (for CubeMX GUI, code generation)
  • gcc-arm-embedded (arm-none-eabi-gcc)
  • STM32CubeProgrammer (for flashing with external loader)
  • TouchGFX 4.26.1 (for GUI generation)

Build Commands

From /gcc/ directory:

make          # Build both Boot and Appli
make clean    # Clean all build artifacts

Flashing Commands

Important: Flashing requires external FlashLoader for external memory access.

Flash Boot (internal flash only):

STM32_Programmer_CLI -c port=SWD \
  -d Boot/TouchGFX/build/bin/target.hex \
  -hardRst

Flash Appli (requires external FlashLoader for 0x70000000):

STM32_Programmer_CLI -c port=SWD \
  -d Appli/TouchGFX/build/bin/target.hex \
  -el gcc/MX66UW1G45G_STM32H7S78-DK.stldr \
  -hardRst

See .vscode/flash_guide.md for complete flashing instructions including VS Code tasks.

Debugging in STM32CubeIDE

Debugging the code in an IDE can be complex because of the Bootloader and Application structure. To step through the code of the TouchGFX application in STM32CubeIDE, follow these steps:

  1. Generate code in TouchGFX Designer
  2. Open the project in STM32CubeIDE
  3. Launch a debug session for the Boot project
  4. Wait for the compilation and flashing to complete
  5. Terminate the debug session (Ctrl + F2)
  6. Launch a debug session for the Appli project
  7. Wait for the compilation and flashing to complete
  8. Click Resume (F8)
  9. Press the black NRST button on the STM32H7S78-DK board
  10. The application is now at a break point at the first line of main() in the Appli project. If not, click Resume (F8) once more
  11. Proceed by e.g. clicking Resume (F8) or Step Over (F6)

Performance Testing

Performance testing can be done using the GPIO pins designated with the following signals in CN10 connector on the underside of the board:

  • VSYNC_FREQ - CN14-D2 (PF1)
  • RENDER_TIME - CN14-D4 (PF2)
  • FRAME_RATE - CN14-D7 (PF3)
  • MCU_ACTIVE - CN15-D8 (PF4)