[RTEMS Project] #2504: Doxygen for automatically generated headers in TMS570

[RTEMS trac]

#2504: Doxygen for automatically generated headers in TMS570
---------------------------+---------------------
 Reporter:  Tangem         |       Owner:
     Type:  defect         |      Status:  new
 Priority:  normal         |   Milestone:  4.11.1
Component:  Documentation  |     Version:  4.11
 Severity:  normal         |  Resolution:
 Keywords:  Doxygen        |
---------------------------+---------------------

Comment (by ppisa):

 Headers would be overwritten when files they are regenerated.
 Manual editing is time consuming as well. So we need to add this to the
 Python script.

 https://github.com/AoLaD/rtems-
 tms570-utils/blob/master/headers/python/make_header.py

 If update is committed to mainline then it can be used as reminder for
 future script change. We compare what changed after each script run
 against previous git state. But I would leave that for future headers
 update.

 On the other hand, there are pending massive additions to TMS570 BSP code
 which are required for RTEMS self contained BSP startup. To have some
 idea, look at tms570-bsp-with-hwinit branch. The branch includes startup
 alternative with integrated HalCoGen code and initial work on minimal
 RTEMS better matching solution.

 https://github.com/AoLaD/rtems/commits/tms570-bsp-with-hwinit

 I have even done some proof of feasibility to use same PinMux
 implementation for tms570lc4357. We communicate about requirements for
 support of future Hercules family chips with Ti expert and he expressed
 that he likes our approach taken for RTEMS and considers it better than
 HalCoGen taken one at least in PinMux area.

 So we are far form full chip support and changes on RTEMS master which are
 not coordinated with WIP branches, would conflict during integration.

--
Ticket URL: <http://devel.rtems.org/ticket/2504#comment:2>
RTEMS Project <http://www.rtems.org/>
RTEMS Project