home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / musik / diti_tra.ck / dt_modul.deu / modulkit.doc < prev    next >
Encoding:
Text File  |  1994-10-20  |  7.8 KB  |  172 lines
  1. 06601030305800
  2. F0110030
  3. 9[...................................................]001
  4. Ç************************************************************************
  5. *                                                                      *
  6. *         DigiTape Effect Module Construction Kit                      *
  7. *         ---------------------------------------                      *
  8. *                                                                      *
  9. *    Anleitung zur Erstellung von zuladbaren Modulen                   *
  10. *              für DigiTape Release 2.0                                *
  11. *                   7. Juli 1993                                       *
  12. *                                                                      *
  13. ************************************************************************
  14.  
  15. DigiTape unterstützt ab der Version 1.03  freie Effektmodule.
  16.  
  17. Das heißt, daß jeder, der sich zu einem bißchen C- und 
  18. etwas mehr DSP-Assembler-Programmierung in der Lage sieht, 
  19. nachladbare Module mit Klageffekten erstellen kann, die in 
  20. DigiTape eingebunden werden.
  21.  
  22. Wir stellen anbeiEntwicklerinformationen über das Softwareinterface
  23. und die Verbindung zu DigiTape zur Verfügung.
  24.  
  25. Weitere Informationen, die benötigt werden, finden sich im 
  26. Motorola Entwicklerhandbuch zum DSP 56k sowie im Falcon 
  27. Entwicklerkit von Atari, das Sie bei Atari Computer GmbH in
  28. Schwalbach bestellen können.
  29.  
  30. Beachten Sie bitte die Artikelserie "DSP-Programierung" in der
  31. ST Comuter, Heim Verlag.
  32.  
  33. Weiterhin möchten wir auf eine Artikelserie mit dem Titel
  34. "Klangwunder" in der Zeitschrift c't verweisen, die auf 
  35. Soundprogrammierung für den DSP 56k / Falcon 030 
  36. gezielt eingeht:
  37.  
  38. "Klangwunder" in c't Heise Verlag, Heft  9/93 S. 226ff
  39.                                    Heft 10/93 S. 212ff
  40.                                    Heft 11/93 S. 260ff
  41.  
  42.  
  43.  
  44. Externe DigiTape-Effekt-Module enthalten DSP56000-Code, Bedienung und 
  45. Resource in einem File. Die Module werden vom DigiTape-Desktop aus 
  46. geladen und können dann wie interne Module verwendet werden. Ist ein 
  47. externes Modul im Multitrack-Recorder installiert und in dem Setup-File 
  48. gesichert, so wird es beim erneuten Band-Öffnen automatisch geladen.
  49.  
  50. Als Beispiel wird ein Hall-Modul mit kompletten Quelldateien 
  51. mitgeliefert.
  52.  
  53. Quelldateien:
  54. -------------
  55. Resource:      HALL.RSC
  56.                HALL.H
  57.                HALL.DFN
  58. Ç
  59. DSP-Assembler: HALL.ASM
  60.  
  61. Oberfläche:    HALL.C
  62.                DT_DEFIN.H
  63.                DT_LOCAL.H
  64.  
  65. Projektfile:   HALL.PRJ
  66.                MAKEFILE
  67.  
  68. Tools:
  69. ------
  70. Voraussetzung: C-Entwicklungsumgebung
  71.                Resource Construction Program
  72.                DSP56000 Assembler
  73.                (Make-Programm, nicht nötig aber schön)
  74.  
  75. Mitgeliefert:  CLN_TO_D.TTP   erzeugt aus DSP-Objektfile HALL.CLN ein 
  76.                               Hex-Dump-Array in C-Convention HALL.D und 
  77.                               einen Defines-File HALL.DH.
  78.  
  79.                RSC_TO_C.TTP   erzeugt aus Resource-File HALL.RSC ein 
  80.                               Hexdump-Array in C-Convention HALL.R
  81.  
  82. Ablauf:
  83. -------
  84.  
  85.       *---------------*       *----------*  *----------*  *-----------*
  86.       |   HALL.ASM    |       | HALL.RSC |  |  HALL.H  |  | HALL.C    |
  87.       |               |       |          |  |          |  |           |
  88.       | DSP-Assembler |       | Resource |  | Resource |  |  C-File   |
  89.       | -Quelltext    |       |          |  | -Defines |  | Bedienung |
  90.       *---------------*       *----------*  *----------*  *-----------*
  91.               |                     |             |             |
  92.               V                     V             |             |
  93.       =================    ==================     |             |
  94.       = ASM56000.TTP  =    = RSC_TO_C.TTP   =     |             |
  95.       = DSP-Assembler =    = Konvertierungs =     --------> #include
  96.       =               =    =    -Tool       =                   |
  97.       =================    ==================                   |
  98.               |                     |                           |
  99.               V                     V                           |
  100.       *---------------*      *-------------*                    |
  101.       |   HALL.CLN    |      |   HALL.R    |                    |
  102.       |               |      |             |                    |
  103.       |  DSP-Objekt   |      | Resource    |                    |
  104.       |               |      | als C-Array |                    |
  105.       *---------------*      *-------------*                    |
  106.               |                     |                           |
  107.               V                     |                           |
  108.      ===================            |                           |
  109.      =  CLN_TO_D.TTP   =            |                           |
  110.      = Konvertierungs  =            ----------------------> #include
  111.      =     -Tool       =                                        |
  112. Ç     ===================                                        |
  113.          |          |                                           |
  114.          V          V                                           |
  115. *-------------*  *-------------*                                |
  116. |   HALL.D    |  |   HALL.DH   |                                |
  117. |             |  |             |                                |
  118. | DSP-Object  |  | DSP-Defines |                                |
  119. | als C-Array |  |    in C     |                                |
  120. *-------------*  *-------------*                                |
  121.        |                |                                       |
  122.        |                ----------------------------------> #include
  123.        |                                                        |
  124.        ---------------------------------------------------> #include
  125.                                                                 |
  126.                            DT_DEFIN.H --------------------> #include
  127.                                                                 |
  128.                            DT_LOCAL.H --------------------> #include
  129.                                                                 |
  130.                                                                 V
  131.                                              =========================
  132.                                              =  C-Compiler & Linker  =
  133.                                              =     Make HALL.PRJ     =
  134.                                              =                       =
  135.                                              =========================
  136.                                                          |
  137.                                                          V
  138.                                                *------------------*
  139.                                                |*----------------*|
  140.                                                ||   HALL.DTM     ||
  141.                                                ||                ||
  142.                                                || DigiTape-Modul ||
  143.                                                |*----------------*|
  144.                                                *------------------*
  145.  
  146.  
  147. Im DSP-Assembler-Quelltext zu beachten:
  148. ---------------------------------------
  149.  
  150. Namen dürfen nicht länger als 7 Buchstaben sein
  151.  
  152. keine ORG-Anweisung erlaubt
  153.  
  154. Berechnungen in Anweisungen sind nicht erlaubt
  155. Beispiel: move  X1,X:DATUM   erlaubt
  156.           move  X1,X:DATUM+1 nicht erlaubt
  157.  
  158. Module müssen mit RTS abgeschlossen werden
  159.  
  160. Zugriffe auf L-Speicher (X- und Y-Speicher gemeinsam)
  161. sind nicht erlaubt
  162.  
  163. Folgende Register dürfen nicht benutzt werden:
  164. R3,M3,N3
  165.  
  166. ÇM0-M2 und M4-M7 müssen nach jedem Modulaufruf $ffff enthalten
  167. d.h. wenn sie verändert werden müssen sie am Ende
  168. wieder auf $FFFF gestzt werden
  169.  
  170. Alle anderen Register dürfen beliebig verändert werden
  171.  
  172.