ich bin gerade dabei, einen Filter für Doxygen zu entwickeln, der die exportierten Quellen (IEC61131-3 ST-Code) in C++-Header wandelt. Diese können dann direkt mit Doxygen weiterverarbeitet werden.
Mein aktuelles Entwicklungs-Release konvertiert schon so ziemlich jede Quelle, die mit dem Beckhoff PLC-Control exportiert wurde. Es lassen sich FBs inkl. deren Variablen und Aktionen sowie Funktionen kommentieren. Der eigentliche Programmcode wird momentan noch rausgefiltert. Ich stelle mir aber vor, dass auch dieser später mal nach C konvertiert wird.
Viele Grüsse,
Jan
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
ich stehe gerade vor der gleichen Aufgabe, also (vorzugsweise doxygen-) Dokumentation aus exportierten CoDeSys-Projekten zu generieren. Ich scheue mich ein wenig einen eigenen Konverter von ST nach C++-Header zu schreiben weil ich einerseits die IEC-Grammatik nicht vorliegen habe (die ja auch die Kommentare berücksichtigen muss) und andererseits in doxygen ja dann nur die Konvertieren C/C++ Prototypen zu sehen wären (und nicht die ST-Deklarationen).
@Jan: Wie funktioniert denn dieser Filter für doxygen?
Gruß,
Bastian
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Er verwendet das Gespann flex/bison zum Parsen der Quellen.
Der Parser sucht nach den entscheidenden Schluesselwoertern, Bezeichnern und zugehoerigen Kommentaren. Code-Teile werden dabei komplett uebergangen.
Anschliessend wird das ganze in C++-Syntax ausgegeben (Header-File).
Damit das ganze richtig funktioniert, sind einige Dinge beim Erstellen der Kommentare zu beachten.
Die Details teile ich Euch morgen mit.
Ausserdem kann ich Euch vorab die Binary zur Verfuegung stellen.
In den Code muss ich noch die GPL einarbeiten, bevor ich ihn online stelle. Aber da nun Interesse besteht, werde ich auch das schnellstens erledigen.
Ich habe den Parser schon an richtig grossen Projekten getestet. Er funktioniert fast perfekt . Es gibt dennoch ein paar Macken, die man aber leicht umgehen kann.
VG
Jan
If you would like to refer to this comment somewhere else in this project, copy and paste the following link:
Hi,
wir suchen ein Tool mit dem man die InCode-Doku etxtrahieren
und als html, xml, ... als Doku ausgeben kann.
In C++ wird das z.B. mit DOxygen gemacht.
Frage:
Kann man DOxygen auch in CoDeSys anwenden?
Kennt Ihr ein entsprechendes Tool, das für CoDeSys anwendbar ist?
Danke Michael
Hallo zusammen,
ich bin gerade dabei, einen Filter für Doxygen zu entwickeln, der die exportierten Quellen (IEC61131-3 ST-Code) in C++-Header wandelt. Diese können dann direkt mit Doxygen weiterverarbeitet werden.
Mein aktuelles Entwicklungs-Release konvertiert schon so ziemlich jede Quelle, die mit dem Beckhoff PLC-Control exportiert wurde. Es lassen sich FBs inkl. deren Variablen und Aktionen sowie Funktionen kommentieren. Der eigentliche Programmcode wird momentan noch rausgefiltert. Ich stelle mir aber vor, dass auch dieser später mal nach C konvertiert wird.
Viele Grüsse,
Jan
Hallo,
ich stehe gerade vor der gleichen Aufgabe, also (vorzugsweise doxygen-) Dokumentation aus exportierten CoDeSys-Projekten zu generieren. Ich scheue mich ein wenig einen eigenen Konverter von ST nach C++-Header zu schreiben weil ich einerseits die IEC-Grammatik nicht vorliegen habe (die ja auch die Kommentare berücksichtigen muss) und andererseits in doxygen ja dann nur die Konvertieren C/C++ Prototypen zu sehen wären (und nicht die ST-Deklarationen).
@Jan: Wie funktioniert denn dieser Filter für doxygen?
Gruß,
Bastian
Hallo zusammen,
der Filter ist in C/C++ geschrieben.
Er verwendet das Gespann flex/bison zum Parsen der Quellen.
Der Parser sucht nach den entscheidenden Schluesselwoertern, Bezeichnern und zugehoerigen Kommentaren. Code-Teile werden dabei komplett uebergangen.
Anschliessend wird das ganze in C++-Syntax ausgegeben (Header-File).
Damit das ganze richtig funktioniert, sind einige Dinge beim Erstellen der Kommentare zu beachten.
Die Details teile ich Euch morgen mit.
Ausserdem kann ich Euch vorab die Binary zur Verfuegung stellen.
In den Code muss ich noch die GPL einarbeiten, bevor ich ihn online stelle. Aber da nun Interesse besteht, werde ich auch das schnellstens erledigen.
Ich habe den Parser schon an richtig grossen Projekten getestet. Er funktioniert fast perfekt . Es gibt dennoch ein paar Macken, die man aber leicht umgehen kann.
VG
Jan
Hallo zusammen,
ich würde den Filter gern bei sourceforge einstellen.
Mein Namensvorschlag: doxygen_iec61131
Falls ihr noch andere Vorschläge habt, bitte hier unterbreiten.
VG
Jan
Hallo Jan,
hast Du was eingestellt, gibts einen link ?