VHDL-Dokumentations- und Programmierhilfen

Gast #6844508
Lesenswert?
• ▲
▼
Kennt jemand einen Editor und/oder ein Dokumentationssystem, welches es 
erlaubt, beim Entwickeln mit VHDL an irgendeiner Stelle im Code - z.B. 
bei der Signaldeklaration - einen Erklärtext zu hinterlegen, der dann 
bei Bedarf eingeblendet wird, wenn man an anderer Stelle im Code auf das 
Signal klickt?

Die Idee kam mir, als ich den pop-up - Erklärtext vom Xilinx Editor sah: 
Geht man mit der Maus über ein Signal, dann blendet der Editor schon mal 
das "downto" ein. Es wäre gut, wenn man noch einen Erklärtext hätte, die 
mit eingeblendet würde.

Gibt es so einen Editor irgendwo, der das kann? Gfs für C++, den man 
umschreiben oder erweitern könnte? Ließe sich das mit Notepad++ 
irgendwie managen?

-----------------------------------------------------------------------

Als zweite Frage wäre erörtern, wie man so einen Text mit in die 
Qualitäts-Doku bekommt, z.B. mit Doxygen oder einer anderen SW. Mit Doxy 
kann man zumindest bei C++ Textbausteine einbinden, die dann in der Doku 
erscheinen. Es wäre gut, das auch bei VHDL zu haben. Momentan 
unterstützt Dody das VHDL leider nicht ausreichend.

Falls es das nicht gibt:

Wer kennt sich mit der plugin-Entwicklung von Notepad++ aus?  Es gibt 
dort einige Code-Analysetools, die Text-Funktionen haben, also sollte 
sich das im Prinzip machen lassen.  Ich stelle mir so etwas vor: ("&$&" 
signalisiert dem Editor einen folgenden Erklärtext)
1
signal holli_polli_5_ena : std_logic_vector(15 downto 0) := (others => '0');     -- &$& "Enable für den 5. Polli-Eingang im Modul holli, momentan oberste 4 Bits Null"
2
signal schnulli_back_clk : std_logic_vector( 3 downto 0) := (others => '0');     -- &$& "4 Eingangstakte für die Schnullifunktion, mit Clock-Mux ausgewählt"
3
signal schnuili_back_out : std_logic;                                            -- &$& "der passend zur selektierten Hardware ausgewählte Schnulli-Takt"


Ein Klick auf eine Funktionstaste oder Verweilen auf dem Signal blendet 
das dann ein. Wenn man dann mal Tausende Signale hat und im alten Code 
sucht, hat man sofort alle Infos, wie es gedacht war, was es macht und 
wie man weiter machen muss.

Später genügt ein Export und man bekommt eine Liste der Signale oder 
eine VHDL-Code-Version, die es in ein DOXY-Format übersetzt.
(Firma: www.elpra.de) Persönliche Seite #6844637
Lesenswert?
• ▲
▼
Idee schrieb:
> Kennt jemand einen Editor und/oder ein Dokumentationssystem, welches es
> erlaubt, beim Entwickeln mit VHDL an irgendeiner Stelle im Code - z.B.
> bei der Signaldeklaration - einen Erklärtext zu hinterlegen, der dann
> bei Bedarf eingeblendet wird, wenn man an anderer Stelle im Code auf das
> Signal klickt?

Sigasi muesste das koennen, weiss ich jetzt allerdings nicht auswendig.

Idee schrieb:
> Als zweite Frage wäre erörtern, wie man so einen Text mit in die
> Qualitäts-Doku bekommt, z.B. mit Doxygen oder einer anderen SW. Mit Doxy
> kann man zumindest bei C++ Textbausteine einbinden, die dann in der Doku
> erscheinen. Es wäre gut, das auch bei VHDL zu haben. Momentan
> unterstützt Dody das VHDL leider nicht ausreichend.

Auch da bietet Sigasi einiges an, wobei ich mit Doxygen egtl. ganz 
zufrieden bin (aber ja, hat auch hier einige Schwaechen und man muss 
Abstriche machen). Zum Grafiken generieren, z.B. FSM Diagramme finde ich 
Sigasi allerdings echt klasse. :-)
#6845046
Lesenswert?
• ▲
▼
Idee schrieb:
> Als zweite Frage wäre erörtern, wie man so einen Text mit in die
> Qualitäts-Doku bekommt, z.B. mit Doxygen oder einer anderen SW.

Als alternative zu Doxygen hatte ich mal VHDocL ausprobiert:
https://www.volkerschatz.com/hardware/vhdocl.html

Der Sourcecode kann so dokumentiert werden wie für Doxygen und man kann 
ihn dann durch beide Tools jagen und vergleichen. VHDocL kann ein paar 
Dinge besser, weil es halt für HDL gebaut wurde. Ich finde Doxygen Dokus 
hübscher aber der Inhalt sollte ja priorität haben :-)

Antwort schreiben

Hinweis: der ursprüngliche Beitrag ist mehr als 6 Monate alt. Bitte hier nur auf die ursprüngliche Frage antworten, für neue Fragen einen neuen Beitrag erstellen.

Formatierung
  • [c]C-Code[/c]
  • [vhdl]VHDL-Code[/vhdl]
  • [code]Code in anderen Sprachen, ASCII-Zeichnungen[/code]
  • [math]Formel in LaTeX-Syntax[/math]
  • [[Titel]] – Link zu einem Artikel
  • Verweis auf einen anderen Beitrag: Rechtsklick auf dessen Beitrags-ID (#8078628), „Adresse kopieren“, in den Text einfügen

Mehr zur Formatierung

Längeren Sourcecode als Anhang, nicht in den Text. JPG nur für Fotos und Scans; Zeichnungen und Screenshots als PNG oder GIF. Siehe Bildformate.

Schon registriert? Anmelden

Wird nicht angezeigt. Wir schicken dir einen Link; sobald du damit bestätigst, erscheint dein Beitrag.

Mit dem Abschicken legst du einen kostenlosen Account an und erkennst die Nutzungsbedingungen und die Datenschutzerklärung an.