main.c reference

Role of main.c

main.c should remain as close as possible to STM32CubeMX-generated code. The preferred design is:

  • CubeMX controls peripheral initialization and startup sequence;

  • handwritten code is inserted only through USER CODE sections;

  • application logic is attached through #include "platform.h", #include "user_code_0.h", and #include "user_code_2.h".

Documentation rule

This file should be documented as an integration and initialization shell, not as the primary place for handwritten application logic.