home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_01 / DIGI_104.LZH / DIGITAPE.104 / MODULE.PRG / MODULKIT.DOC < prev    next >
Text File  |  1993-07-07  |  7KB  |  140 lines
  1. ************************************************************************
  2. *                                                                      *
  3. *         DigiTape Effect Module Construction Kit                      *
  4. *         ---------------------------------------                      *
  5. *                                                                      *
  6. *    Anleitung zur Erstellung von zuladbaren Modulen                   *
  7. *              für DigiTape Release 2.0                                *
  8. *                   7. Juli 1993                                       *
  9. *                                                                      *
  10. ************************************************************************
  11.  
  12. Externe DigiTape-Effekt-Module enthalten DSP56000-Code, Bedienung und 
  13. Resource in einem File. Die Module werden vom DigiTape-Desktop aus 
  14. geladen und können dann wie interne Module verwendet werden. Ist ein 
  15. externes Modul im Multitrack-Recorder installiert und in dem Setup-File 
  16. gesichert, so wird es beim erneuten Band-Öffnen automatisch geladen.
  17.  
  18. Als Beispiel wird ein Hall-Modul mit kompletten Quelldateien 
  19. mitgeliefert.
  20.  
  21. Quelldateien:
  22. -------------
  23. Resource:      HALL.RSC
  24.                HALL.H
  25.                HALL.DFN
  26.  
  27. DSP-Assembler: HALL.ASM
  28.  
  29. Oberfläche:    HALL.C
  30.                DT_DEFIN.H
  31.                DT_LOCAL.H
  32.  
  33. Projektfile:   HALL.PRJ
  34.                MAKEFILE
  35.  
  36. Tools:
  37. ------
  38. Voraussetzung: C-Entwicklungsumgebung
  39.                Resource Construction Program
  40.                DSP56000 Assembler
  41.                (Make-Programm, nicht nötig aber schön)
  42.  
  43. Mitgeliefert:  CLN_TO_D.TTP   erzeugt aus DSP-Objektfile HALL.CLN ein 
  44.                               Hex-Dump-Array in C-Convention HALL.D und 
  45.                               einen Defines-File HALL.DH.
  46.  
  47.                RSC_TO_C.TTP   erzeugt aus Resource-File HALL.RSC ein 
  48.                               Hexdump-Array in C-Convention HALL.R
  49.  
  50. Ablauf:
  51. -------
  52.  
  53.       *---------------*       *----------*  *----------*  *-----------*
  54.       |   HALL.ASM    |       | HALL.RSC |  |  HALL.H  |  | HALL.C    |
  55.       |               |       |          |  |          |  |           |
  56.       | DSP-Assembler |       | Resource |  | Resource |  |  C-File   |
  57.       | -Quelltext    |       |          |  | -Defines |  | Bedienung |
  58.       *---------------*       *----------*  *----------*  *-----------*
  59.               |                     |             |             |
  60.               V                     V             |             |
  61.       =================    ==================     |             |
  62.       = ASM56000.TTP  =    = RSC_TO_C.TTP   =     |             |
  63.       = DSP-Assembler =    = Konvertierungs =     --------> #include
  64.       =               =    =    -Tool       =                   |
  65.       =================    ==================                   |
  66.               |                     |                           |
  67.               V                     V                           |
  68.       *---------------*      *-------------*                    |
  69.       |   HALL.CLN    |      |   HALL.R    |                    |
  70.       |               |      |             |                    |
  71.       |  DSP-Objekt   |      | Resource    |                    |
  72.       |               |      | als C-Array |                    |
  73.       *---------------*      *-------------*                    |
  74.               |                     |                           |
  75.               V                     |                           |
  76.      ===================            |                           |
  77.      =  CLN_TO_D.TTP   =            |                           |
  78.      = Konvertierungs  =            ----------------------> #include
  79.      =     -Tool       =                                        |
  80.      ===================                                        |
  81.          |          |                                           |
  82.          V          V                                           |
  83. *-------------*  *-------------*                                |
  84. |   HALL.D    |  |   HALL.DH   |                                |
  85. |             |  |             |                                |
  86. | DSP-Object  |  | DSP-Defines |                                |
  87. | als C-Array |  |    in C     |                                |
  88. *-------------*  *-------------*                                |
  89.        |                |                                       |
  90.        |                ----------------------------------> #include
  91.        |                                                        |
  92.        ---------------------------------------------------> #include
  93.                                                                 |
  94.                            DT_DEFIN.H --------------------> #include
  95.                                                                 |
  96.                            DT_LOCAL.H --------------------> #include
  97.                                                                 |
  98.                                                                 V
  99.                                              =========================
  100.                                              =  C-Compiler & Linker  =
  101.                                              =     Make HALL.PRJ     =
  102.                                              =                       =
  103.                                              =========================
  104.                                                          |
  105.                                                          V
  106.                                                *------------------*
  107.                                                |*----------------*|
  108.                                                ||   HALL.DTM     ||
  109.                                                ||                ||
  110.                                                || DigiTape-Modul ||
  111.                                                |*----------------*|
  112.                                                *------------------*
  113.  
  114.  
  115. Im DSP-Assembler-Quelltext zu beachten:
  116. ---------------------------------------
  117.  
  118. Namen dürfen nicht länger als 7 Buchstaben sein
  119.  
  120. keine ORG-Anweisung erlaubt
  121.  
  122. Berechnungen in Anweisungen sind nicht erlaubt
  123. Beispiel: move  X1,X:DATUM   erlaubt
  124.           move  X1,X:DATUM+1 nicht erlaubt
  125.  
  126. Module müssen mit RTS abgeschlossen werden
  127.  
  128. Zugriffe auf L-Speicher (X- und Y-Speicher gemeinsam)
  129. sind nicht erlaubt
  130.  
  131. Folgende Register dürfen nicht benutzt werden:
  132. R3,M3,N3
  133.  
  134. M0-M2 und M4-M7 müssen nach jedem Modulaufruf $ffff enthalten
  135. d.h. wenn sie verändert werden müssen sie am Ende
  136. wieder auf $FFFF gestzt werden
  137.  
  138. Alle anderen Register dürfen beliebig verändert werden
  139.  
  140.