automatisierte und graphische Doku

Ich kenne kein einziges und Doygen hat mir noch nie etwas Brauchbares 
geliefert.

Ich importiere das Zeug immer ins Xilinx und lasse mir Symbole bauen, 
die ich dann ausdrucke, um mir eine Übersicht zu behalten.

Möglicherweise geht es mit dem ROBEI, das hier immer mal wieder beworben 
wird.

Dipl.-Ing. (FH) schrieb:
> Ich kenne kein einziges und Doxygen hat mir noch nie etwas Brauchbares
> geliefert.

dito hier...
Und wenn man dann sowas kriegt und die Doxygen-Kommentare sind komplett 
veraltet und passen gar nicht mehr zur HW dann freut man sich ein 2. 
Loch in den Bauch... Oder wenn der ganze Rotz mit Unterverzeichnissen 
und generierten Filenamen laenger als 255 Characters wird...

Meine Methode: Source gescheit dokumentieren (nicht Zeile fuer Zeile 
sondern etwas Globalgalaktischer) und dann die Bloecke von Hand zeichnen 
(abstrahiert, im Prinzip die Projekthierarchie mit Rechtecken). Dazu 
dann Text als genauere Erklaerung...
Damit finden sich meine Kollegen schnell zurecht und wissen schon recht 
genau, wo sie reinschauen muessen wenn mal was nicht tut.

ok.

Ja mal schauen... ein paar Bilder könnte ich aus dem NetlistViewer 
nehmen, also solange es halt nur connectete Modue sind. Muss ich mal 
schauen wie das im Detail aussieht... leider dauert das Synthethisieren 
relativ lang (1:30h). Cool wäre überhaupt, wenn man auch die Connections 
zur CPU (in mein Fall nios) sehen könnte und dann gleich in der SW einen 
ähnlichen Überblick hat... (Aber UML hab ich wenig Erfahung und fands zu 
Beginn komisch...)

Die gefragte graphische Doku kann ich auch nicht liefern. Wie schon 
erwähnt, Xilinx ISE hat eine schöne RTL View, Synplify kann auch schöne 
RTL oder Struktur Schemas malen, Lattice Diamond zeichnet grobe 
Blockdiagramme die aber wenig für Papier/HTML Dokus taugen (Im Tool 
selber sind sie ordentlich).

Dipl.-Ing. (FH) schrieb:
> Ich kenne kein einziges und Doygen hat mir noch nie etwas Brauchbares
> geliefert.

War bei mir genau so bis vor ein paar Wochen als ich das Tool VHDocL 
entdeckt habe:

http://www.volkerschatz.com/hardware/vhdocl.html

"VHDocL serves to document a hardware design at the structural level. 
Signals, formulas, function bodies and other functional components of 
the source code are ignored. Entities and architectures, function 
declarations, constants, processes, instantiations, generate statements 
and other constructs relating to the structure of the design are parsed 
and documented in HTML pages."

Ist in Perl geschrieben und OpenSource.

Habe die Sommerflaute etwas genutzt um es bei uns etwas auszuprobieren 
(bei Arbeit gibts nur Windows, tut aber problemlos). Tut ganz ordentlich 
und ist sicher interessant, wenn man mehrere Entwickler ist und z. B. 
wiederverwendbare Module baut, wo man gerne die Interfaces und 
Typdefinitionen dokumentieren möchte.