Skip to main content
Mikk Leini
Mikk Leini
Senior
July 22, 2023
Question

Explanation field to CubeIDE

  • July 22, 2023
  • 3 replies
  • 2993 views

Feature request to STM32 CubeIDE.
ST, please add a possibility to add user explanation text to peripheral configurations. It is neccessary because the configuration, especially numbers, are not always self-explaning. A text field where to write explanation, requirements, calculations, warnings, etc. would be very helpful. If possible, the same explanation could end up in generated C code. Simple text effects like bold and italic can be used and generated into code with Doxygen markup.

Mock-up example of IWDG:

MikkLeini_0-1690122823653.png

      This topic has been closed for replies.

      3 replies

      Pavel A.
      Pavel A.
      July 22, 2023

      A good idea. But some components have many parameters and several sub-components. Do you want to associate these "explanations" with initialization function generated by Cube (to generate a comment in main.c or per-component .c file) or with each dialog in Cube settings, just to be displayed ?

      To explain calculation of timer reload values etc., would be useful to add substitution of macros, ex.  ${SystemCoreClock}, ${ComponentClock}, ${HSE_Value}, ${APB1_Clock} ... from the clocks tab. 

       

      Mikk Leini
      Mikk LeiniAuthor
      Senior
      July 23, 2023

      I guess comments in main.c at peripheral initialization function headers (MX_xxx_Init) are fine. 

      Nikita91
      Nikita91
      Lead II
      July 23, 2023

      Good idea!

      I would like to get the comments in the C file. In some cases after the 1st MX generation, no need of MX anymore.

      Syn_BE
      Syn_BE
      Associate II
      July 27, 2023

      Hi there,

      I had a similar feature request:
      https://community.st.com/t5/stm32cubemx-mcu/cubemx-add-comment-remark-note-comments-remarks-notes/m-p/577569

      For me, the following idea would be sufficient:

      - having the possibility to add a note / comment / remark for each peripheral

      - like in the following screenshot:

              Syn_BE_2-1690472212956.png

      - the "note" icon maybe visible, if there is a note for the peripheral. (otherwise there might be no "note" icon)

      - as mentioned before by the others, it would be a really good idea to find the contents of the NOTE in a generated C file

      - the possibility of adding a comment in each "Setting" tab seems a bit too complex and/or hidden, to me. (but this is just my first impression)

       

       

        Terms & ConditionsAccessibility statement