TheCloud/Digital
1
0
Fork 0
mirror of https://github.com/hneemann/Digital.git synced 2025-09-28 07:28:20 -04:00
Code Issues Packages Projects Releases Wiki Activity

Improved documentation

Browse Source
This commit is contained in:
hneemann 2016-10-30 20:44:57 +01:00
parent 1bb068300e
commit 9afb828eb5
9 changed files with 114 additions and 33 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
src/main/dig/processor/ALU.dig
View File

@ -4,7 +4,11 @@
<attributes>
<entry>
<string>Description</string>
<string>Arithmetisch Logische Einheit.</string>
<string>Arithmetisch Logische Einheit.
Führt alle arithmetischen Operationen durch.
WIrd sowohl für arithmetische Prozessorbefehle
als auch für die Berechnung von Speicheradressen
verwendet.</string>
</entry>
<entry>
<string>Width</string>
@ -17,7 +21,7 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>EIngang A</string>
<string>Erster Operand</string>
</entry>
<entry>
<string>Label</string>
@ -35,7 +39,7 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Eingang B</string>
<string>Zweiter Operand</string>
</entry>
<entry>
<string>Label</string>
@ -164,7 +168,7 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Ergebnis</string>
<string>Ergebnis der Operation</string>
</entry>
<entry>
<string>Label</string>
@ -208,6 +212,10 @@
<visualElement>
<elementName>Out</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Zero-Flag; Ist High wenn das Ergebnis Null ist.</string>
</entry>
<entry>
<string>Label</string>
<string>Zero</string>
@ -218,6 +226,10 @@
<visualElement>
<elementName>Out</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Ist High wenn das Ergebnis negativ ist.</string>
</entry>
<entry>
<string>Label</string>
<string>Neg</string>
@ -228,6 +240,10 @@
<visualElement>
<elementName>Out</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Ist High wenn es einen Übertrag gegeben hat.</string>
</entry>
<entry>
<string>Label</string>
<string>Carry</string>
@ -303,7 +319,7 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Takt</string>
<string>Der Eingang für den Übertrag</string>
</entry>
<entry>
<string>Label</string>

7
src/main/dig/processor/Branch.dig
View File

@ -4,7 +4,10 @@
<attributes>
<entry>
<string>Description</string>
<string>Einheit für bedingte Verzweigungen.</string>
<string>Einheit für bedingte Verzweigungen.
Je nach Zustand der Flags und des ctrl-Eingangs
wird ein bedingter Sprung ausgelößt oder eben
nicht.</string>
</entry>
</attributes>
<visualElements>
@ -80,7 +83,7 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>relativen Sprung ausführen</string>
<string>Ist dieser Ausgang High, soll ein bedingter relativer Sprung ausgeführt werden.</string>
</entry>
<entry>
<string>Label</string>

8
src/main/dig/processor/Control.dig
View File

@ -4,7 +4,13 @@
<attributes>
<entry>
<string>Description</string>
<string>Leitwerk für einen einfachen Prozessor.</string>
<string>Leitwerk für einen einfachen Prozessor.
Es arbeitet rein kombinatorisch, es handelt sich
also um ein einfaches Schaltwerk.
Da es vergleichsweise komplex ist (24
Ausgangsbits), wird es durch einen
entsprechenden ROM-Baustein
realisiert, und nicht durch 24 einzelne Schaltnetze.</string>
</entry>
<entry>
<string>Width</string>

38
src/main/dig/processor/Flags.dig
View File

@ -4,13 +4,21 @@
<attributes>
<entry>
<string>Description</string>
<string>Speichert die Prozessorflags</string>
<string>Speichert die Prozessor-Flags.
Über den store-Eingang, kann der aktuelle Zustand
der Flags gespeichert werden. Das Carry-Flag kann
dann für arithmetische Funktion genutzt werden,
alle Flags für eine bedingte Verzweigung.</string>
</entry>
</attributes>
<visualElements>
<visualElement>
<elementName>In</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Das Zero-Flag welches gespeichert werden soll.</string>
</entry>
<entry>
<string>Label</string>
<string>Zi</string>
@ -21,6 +29,10 @@
<visualElement>
<elementName>Out</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Gibt das gespeicherte Zero-Flag aus.</string>
</entry>
<entry>
<string>Label</string>
<string>Zo</string>
@ -45,6 +57,10 @@
<visualElement>
<elementName>In</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Das Negative-Flag welches gespeichert werden soll.</string>
</entry>
<entry>
<string>Label</string>
<string>Ni</string>
@ -55,6 +71,10 @@
<visualElement>
<elementName>Out</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Gibt das gespeicherte Negative-Flag aus.</string>
</entry>
<entry>
<string>Label</string>
<string>No</string>
@ -79,6 +99,10 @@
<visualElement>
<elementName>In</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Das Carry-Flag welches gespeichert werden soll.</string>
</entry>
<entry>
<string>Label</string>
<string>Ci</string>
@ -89,6 +113,10 @@
<visualElement>
<elementName>Out</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Gibt das gespeicherte Carry-Flag aus.</string>
</entry>
<entry>
<string>Label</string>
<string>Co</string>
@ -113,6 +141,10 @@
<visualElement>
<elementName>In</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>der Takteingang</string>
</entry>
<entry>
<string>Label</string>
<string>C</string>
@ -123,6 +155,10 @@
<visualElement>
<elementName>In</elementName>
<elementAttributes>
<entry>
<string>Description</string>
<string>Der Eingang welcher das Speichern aktiviert. Es wird auf Eins gesetzt, wenn eine arithmetische Operation ausgeführt wird.</string>
</entry>
<entry>
<string>Label</string>
<string>store</string>

5
src/main/dig/processor/Graphics.dig
View File

@ -4,7 +4,10 @@
<attributes>
<entry>
<string>Description</string>
<string>Eine einfache &quot;Grafikkarte&quot;. Sie enthält ein Grafik-RAM um die eigentliche Grafik anzuzeigen.</string>
<string>Eine einfache &quot;Grafikkarte&quot;.
Sie enthält ein Grafik-RAM um die eigentliche Grafik
anzuzeigen. Dieses Grafik-RAM ist auf die
Darstellung von 20x20 Pixel konfiguriert.</string>
</entry>
</attributes>
<visualElements>

8
src/main/dig/processor/ImReg.dig
View File

@ -4,7 +4,13 @@
<attributes>
<entry>
<string>Description</string>
<string>Register zum Speichern von großen Konstanten</string>
<string>Register zum Speichern von großen Konstanten.
Es existiert ein 1-Bit Befehl, welcher dieses Register
beschreibt. Auf diese Weise können 15 Bits
gespeichert werden (das 16. Bit aktiviert das
Beschreiben dieses Registers und ist daher immer
Eins) Um das fehlende 16. Bit zu speichern, steht ein
spezielles Bit in jedem Befehlswort zur Verfügung.</string>
</entry>
<entry>
<string>Width</string>

6
src/main/dig/processor/PC.dig
View File

@ -4,7 +4,11 @@
<attributes>
<entry>
<string>Description</string>
<string>Der Programmzähler. Hier wird der aktuelle Programmzähler gespeichert. Über die verschiedenen Eingänge kann beeinflußt werden, wie der Programmzähler mit dem Takt weitergeschaltet wird.</string>
<string>Der Programmzähler.
Hier wird der aktuelle Programmzähler gespeichert.
Über die verschiedenen Eingänge kann beeinflußt
werden, auf welche Weise der Programmzähler mit
dem Takt weiter geschaltet wird.</string>
</entry>
<entry>
<string>Width</string>

31
src/main/dig/processor/Register.dig
View File

@ -4,7 +4,8 @@
<attributes>
<entry>
<string>Description</string>
<string>In diesem Block befinden sich die Die 16 Prozessorregister.</string>
<string>In diesem Block befinden sich die 16
Prozessorregister.</string>
</entry>
<entry>
<string>Width</string>
@ -35,7 +36,9 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Daten die gespeichert werden sollen</string>
<string>Daten die gespeichert werden sollen.
Der hier anliegende Wert wird gespeichert, wenn
der Eingang WE auf 1 geschaltet wird.</string>
</entry>
<entry>
<string>Label</string>
@ -333,7 +336,9 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Takt</string>
<string>Takt. Geht der Takt auf High, und ist WE auf High
wird der Wert an WD im dem Register gespeichert,
welches in dest angegeben ist.</string>
</entry>
<entry>
<string>Label</string>
@ -347,7 +352,8 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Nummer des Source Registers</string>
<string>Nummer des Source Registers. Legt fest, welches
Register an Rsrc ausgegeben werden soll.</string>
</entry>
<entry>
<string>rotation</string>
@ -397,7 +403,10 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Nummer des Destignation Registers</string>
<string>Nummer des Destignation Registers. Legt fest,
welches Register an Rdest ausgegeben werden soll.
Zudem wird dieses Register beschrieben, wenn
WE auf 1 gesetzt wird.</string>
</entry>
<entry>
<string>Label</string>
@ -415,7 +424,9 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Das Speichern aktivieren</string>
<string>Das Speichern aktivieren. Wenn dieser Eingang auf
High geht, wird der Wert an WD in dem Register
gespeichert, welches in dest angegeben ist.</string>
</entry>
<entry>
<string>Label</string>
@ -429,7 +440,9 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Inhalt des Destignation Registers</string>
<string>Inhalt des Destignation Registers.
Welches Register ausgegeben wird, wird mittels
des Eingangs dest festgelegt.</string>
</entry>
<entry>
<string>Label</string>
@ -447,7 +460,9 @@
<elementAttributes>
<entry>
<string>Description</string>
<string>Inhalt des Source Registers</string>
<string>Inhalt des Source Registers. Welches Register
ausgegeben wird, wird mittels des Einganges src
festgelegt.</string>
</entry>
<entry>
<string>Label</string>

18
src/main/dig/processor/SignExt.dig
View File

@ -4,7 +4,11 @@
<attributes>
<entry>
<string>Description</string>
<string>Extrahiert kleine Konstanten aus dem Befehlswort</string>
<string>Extrahiert kleine Konstanten aus dem Befehlswort.
Es können zwei 5-Bit Konstanten (Die 4 Bits eines
Registers zusammen mit Bit 8 des Befehlswortes)
und eine 9-Bit Konstante (Die 8 Bits beider Register
zusammen mit Bit 8 des Befehlswortes)</string>
</entry>
<entry>
<string>Width</string>
@ -29,7 +33,6 @@
</entry>
</elementAttributes>
<pos x="200" y="140"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Splitter</elementName>
@ -44,7 +47,6 @@
</entry>
</elementAttributes>
<pos x="280" y="140"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Splitter</elementName>
@ -59,7 +61,6 @@
</entry>
</elementAttributes>
<pos x="420" y="140"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Out</elementName>
@ -78,7 +79,6 @@
</entry>
</elementAttributes>
<pos x="500" y="420"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Splitter</elementName>
@ -93,7 +93,6 @@
</entry>
</elementAttributes>
<pos x="280" y="340"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Splitter</elementName>
@ -108,7 +107,6 @@
</entry>
</elementAttributes>
<pos x="420" y="360"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Const</elementName>
@ -123,7 +121,6 @@
</entry>
</elementAttributes>
<pos x="380" y="380"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Out</elementName>
@ -142,7 +139,6 @@
</entry>
</elementAttributes>
<pos x="500" y="140"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Splitter</elementName>
@ -157,7 +153,6 @@
</entry>
</elementAttributes>
<pos x="280" y="420"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Splitter</elementName>
@ -172,7 +167,6 @@
</entry>
</elementAttributes>
<pos x="420" y="420"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Const</elementName>
@ -187,7 +181,6 @@
</entry>
</elementAttributes>
<pos x="380" y="460"/>
<rotate>0</rotate>
</visualElement>
<visualElement>
<elementName>Out</elementName>
@ -206,7 +199,6 @@
</entry>
</elementAttributes>
<pos x="500" y="360"/>
<rotate>0</rotate>
</visualElement>
</visualElements>
<wires>