home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: delta / whiteline CD Series - delta.iso / tools / falc_uti / dsp_tool / doku / dsp_tool.doc
Encoding:
Text File  |  1995-11-25  |  7.1 KB  |  184 lines
  1.       Tools und Beispiele zur DSP-Programmierung
  2.       ==========================================
  3.       
  4. Dieses Paket enthält ein komplettes Entwicklungssystem für den
  5. DSP 56001 des Falcon 030.
  6.  
  7. Dieses Paket enthält:
  8.  
  9.  - Einen DSP-Assembler
  10.  
  11.  - Einen LOD-Dissassembler
  12.  
  13.  - Diverse Hilfs- und Konvertierprogramme
  14.  
  15.  - Eine Shell von der aus alle Programme aufgerufen werden
  16.    können.
  17.    
  18.  - Ein DSP.HLP File für das Pure Pascal/Pure C-Hilfesystem mit
  19.    einer Beschreibung aller DSP-Befehle und Falcon-Spezifischer
  20.    Details.
  21.    
  22.  - Eine Pure Pascal Unit mit Hilfsfunktionen für die Benutzung
  23.    des DSP in Pascal Programmen. Da die Unit im Sourcecode vor-
  24.    liegt, läßt sie sich einfach auf andere Programmiersprachen
  25.    anpassen.
  26.    
  27.  - Beispielprogramme in Pure Pascal
  28.  
  29.  
  30. WICHTIGER HINWEIS:
  31. ==================
  32.  
  33. Die Programme A56.TTP, DISASM.TTP und OUTTOLOD.TTP sind frei kopier-
  34. bare Programme von einem FTP-Server. Ich bin nicht der Autor dieser
  35. Programme.
  36. Ich habe diese Programme in dieses Paket integriert, damit nicht jeder
  37. Benutzer meines Paketes sich diese Programme selbst aus irgendwelchen
  38. Mailboxen zusammensuchen muß.
  39.  
  40. Ich habe diese Programme, so wie ich sie auf einem FTP-Server gefunden
  41. habe, in dem Ordner ORIGINAL abgelegt. Dort finden Sie auch die Dokumen-
  42. tationen der Autoren.
  43. Bitte lesen Sie auch diese Dokumentationen und README-Files aufmerksam
  44. durch !
  45.  
  46. Autor des Programms A56.TTP:
  47. ----------------------------
  48.  
  49. Ate Brink
  50.  
  51. Moderator of the Atari archive at the Utrecht university (ftp.cs.ruu.nl)
  52.  
  53. Email: ate@cs.ruu.nl
  54.  
  55. Autor der Programme OUTTOLOD.TTP und DISASM.TTP:
  56. ------------------------------------------------
  57.  
  58. Gabriel Sebestyen   email: szoli@palma1.elte.hu
  59. Damnjanich 23
  60. 1071 BUDAPEST (HUNGARY)
  61.  
  62.  
  63. Weitere Hinweise zum Copyright
  64. ==============================
  65.  
  66. Alle von mir verfassten Programme und Beispiele dieses Paketes sind
  67. Public-Domain.
  68. Nähere Informationen zu den nicht von mir stammenden Programmen
  69. A56.TTP, OUTTOLOD.TTP und DISASM.TTP entnehmen Sie bitte den
  70. entsprechenden Dokumentationen im Verzeichnis ORIGINAL.
  71. (Archive müssen erst ausgepackt werden)
  72.  
  73. Das Helpfile DSP.HLP ist NICHT Public-Domain, sondern Freeware.
  74. D.h. ich behalte mir einige Rechte an dieser Datei vor:
  75.  
  76.  - DSP.HLP darf beliebig oft kopiert und weitergegeben werden.
  77.  
  78.  - DSP.HLP darf aber NICHT zur Entwicklung komerzieller Programme
  79.    benutzt werden und NICHT einzeln oder im Paket verkauft
  80.    werden.
  81.  
  82.  
  83. Anschrift des Autors:
  84.  
  85.                      Dirk Hohmann
  86.                      An der Etzequelle 6
  87.                      37130 Gleichen/Etzenborn
  88.  
  89. --------------------------------------------------------------------------
  90. |                     Bedienungsanleitungen                              |
  91. --------------------------------------------------------------------------
  92.  
  93. Installation des Paketes:
  94. =========================
  95.  
  96. Für den ersten Test sollte man den kompletten Ordner DSP_TOOL auf das
  97. Laufwerk C kopieren. Die Pfade der Shell sind so eingestellt, daß alle
  98. Aktionen bis auf 'Linkfile' funktionieren müßten.
  99.  
  100.  
  101. A56_SHL.PRG:
  102. ============
  103.  
  104. Über eine Dialogbox kann man den DSP-Assembler, den Disassembler und
  105. einige Konvertierprogramme aufrufen.
  106.  
  107. Das Programm benötigt mindestens 16 Farben !!!
  108.  
  109. In dem oberen Feld der Dialogbox kann man die Pfade für die Programme
  110. und den Code einstellen. Alle Pfade müssen sich auf dem selben Laufwerk
  111. befinden.
  112. Im unteren Feld kann man die Aktion auswählen, die beim Anklicken von
  113. 'Start' ausgeführt werden soll.
  114.  
  115. Assembler:    Ein DSP-Sourcecode wird in ein LOD-File übersetzt. Dazu
  116.               wird A56.TTP aufgerufen und anschließend OUTTOLOD.TTP.
  117.               Die Bildschirmausgaben des Assemblers werden in eine
  118.               Datei 'A56_LIST.OUT' umgeleitet. Falls beim Assemblieren
  119.               ein Fehler passiert, wird man von der SHELL aufgefordert
  120.               sich diese Datei anzusehen.
  121.               Übrigens: Der Assembler mag keine ä,ö,ü und ß in den 
  122.               Kommentaren !!!
  123.            
  124. Disassembler: Eine LOD-Datei wird in Assemblercode zurückübersetzt.
  125.               Leider kann dieses Programm so nicht wieder vom A56
  126.               assembliert werden, da der Assembler einige Probleme
  127.               mit der Schreibweise der Adressierungsarten hat.
  128.               Ausserdem ist er sehr pingelig was MOVE-Befehle angeht.
  129.               Für Kontrollregister möchte er ein MOVEC und für Pheri-
  130.               pherie ein MOVEP haben. Er akzeptiert kein MOVE an diesen
  131.               Stellen.
  132.               Der Assembler benutzt bei MOVEP automatisch die für
  133.               Pheripheriezugriffe vorgesehene Adressierungsart '<<'.
  134.               Wenn man diese bei MOVEP trotzdem angibt, so erhält man
  135.               eine Fehlermeldung.
  136.               ACHTUNG der Disassembler übersetzt einige TFR-Befehle 
  137.               falsch !!
  138.               Lösung der Probleme: Weiterlesen !!!
  139.               
  140. Formatieren:  Ein disassembliertes Programm wird optisch aufbereitet
  141.               und die Fehler des Disassemblers werden behoben.
  142.               Das Programm läßt sich nun mit dem A56.TTP assemblieren.
  143.               Alle vom Formatprogramm geänderten Zeilen werden mit einem
  144.               entsprechenden Kommentar versehen.
  145.               
  146. Label einf.:  Wenn man statt der hexadezimalen Adressen für die Pheri-
  147.               pherieregister lieber die Namen der IOEQU.INC haben
  148.               möcht, so kann man sie mit diesem Programm einsetzen
  149.               lassen.
  150.               Im Klartext: Das Programm ersetzt alle Konstanten eines
  151.               Quelltextes durch die in der Include-Datei definierten
  152.               Namen.
  153.               
  154. Reassembler:  Alle drei og. Punkte werden nacheinander ausgeführt.
  155.  
  156. Linkfile:     Eine LOD-Datei wird in eine Objektcode-Datei umgewan-
  157.               delt. Näheres dazu in der DSP-Hilfe und in den
  158.               Beispielprogrammen DSP_SIN1.PAS und DSP_SIN2.PAS.
  159.               Das Linkfile-Programm braucht zum erstellen des Objekt-
  160.               codes einen 68000er-Assembler (z.B. PASM.TTP).
  161.               Der Pfad zu diesem Assembler muß in der Datei DSPLINK.INF
  162.               stehen.
  163.               Der dort eingetragene Assembler erhält über die Kommando-
  164.               zeile den Dateinamen (incl. Pfad) des zu übersetzenden
  165.               Programms. Der Assembler muß als Ausgabedatei den Objekt-
  166.               code liefern (*.o oder *.obj usw..). Das übergebene
  167.               Programm besteht aus einem Hexdump und einem Label.
  168.               
  169. Wird dem Programm ein Dateiname (incl. Pfad) übergeben, so wird ohne
  170. die Dialogbox anzuzeigen der Assembler gestartet.
  171.  
  172.  
  173. Die DSP-Hilfedatei 'DSP.HLP':
  174. =============================
  175.  
  176. Diese Datei wurde mit dem Pure Pascal beiliegendem HELPCOMP.TTP übersetzt.
  177. Ich benutze die Hilfe in Pure-Pascal 1.1. Wenn sich das Dateiformat nicht
  178. allzusehr unterscheidet, müßte diese Hilfe auch unter Pure C arbeiten.
  179. Mit dem Schlüsselwort 'dsp' gelangt man in ein Hauptmenü, von dem aus
  180. alle weiteren Punkte, wie der komplette 56000-Befehlssatz und Hilfen zu
  181. den weiteren Programmen dieses Paketes erreichbar sind.
  182.   
  183.  
  184.  
  185.  
  186.