corr opencode (run debug flash)

2026-10-18 16:08:54 +02:00
1 parent 2c2202e60d
commit 4b54d587fe
@@ -1,14 +1,55 @@
-# STM32H7S78-DK TBS
+# STM32H7S78-DK Audio Effects Processor with TouchGFX

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

- VSYNC_FREQ  - CN14-D2 (PF1)
- RENDER_TIME - CN14-D4 (PF2)
- FRAME_RATE  - CN14-D7 (PF3)
- MCU_ACTIVE  - CN15-D8 (PF4)
+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:**
+```bash
+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):**
+```bash
+STM32_Programmer_CLI -c port=SWD \
+  -d Boot/TouchGFX/build/bin/target.hex \
+  -hardRst
+```
+
+**Flash Appli (requires external FlashLoader for 0x70000000):**
+```bash
+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`](.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 of the TBS for STM32H7S78-DK. To step through the code of the TouchGFX application in STM32CubeIDE, follow these steps:
+
+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
@@ -17,6 +58,15 @@ Debugging the code in an IDE can be complex because of the Bootloader and Applic
 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 STM32H7S7-DK board
+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)
+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)