Doxygen comments in code generated with Simulink Embedded Coder

Question

Tomaso Poggi 2022-5-17

0
链接

此问题的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/1721290-doxygen-comments-in-code-generated-with-simulink-embedded-coder

评论： Pablo 2024-5-10

I am using Embedded Coder to generate C code for a model. My model contains several busses that are translated to struct typedefs in C.

As expected, the "Description" field of each signal in the bus is transalted into a comment in the C code.

I would like the comment to have a doxygen style, that is it should be in the form:

/** My comment */

By looking into the help, I saw that in Simulink there is the possibility to do something similar by creeating a custom CGT file (see this page). Anyway, the comment style only applies to file banners, functions banners and file trailers, while comments to typedefs are left in a classic style.

I also found that it is possible to insert doxygen-like comments for typedefs in MATLAB generated code (see this page). However, I cannot manage to do the same for code generated from a Simulink model. I tried to add a "Type Definitions" section to my custom CGT file but nothing happened. In particular I added the following lines to my custom CGT:

%% Type Definitions
<TypeDefinitionsBanner style="doxygen_qt">
Type Definitions
</TypeDefinitionsBanner>

Any suggestion?

Thnak you.

1 个评论
显示 -1更早的评论隐藏 -1更早的评论

Pablo 2024-5-10

Is there any advance in this feature? It is already possible to integrate doxygen style comments in Embedded Coder?

请先登录，再进行评论。

请先登录，再回答此问题。

Answer 1

Tomaso Poggi 2022-5-30

0
链接

此回答的直接链接

https://ww2.mathworks.cn/matlabcentral/answers/1721290-doxygen-comments-in-code-generated-with-simulink-embedded-coder#answer_974300

I contacted the Mthworks support service and it turned out that at the moment there is no way of accomplishing this workflow by editing the CGT files. Anyway, they opened an Enhancement request with the Development, so the feature might be available in the future.