home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / cbm / nduk-v40.lha / V40 / include / devices / cd.i < prev    next >
Encoding:
Text File  |  1993-10-15  |  11.6 KB  |  312 lines
  1.  
  2.  
  3.     IFND    DEVICES_CD_I
  4. DEVICES_CD_I SET    1
  5. **
  6. **    $VER: cd.i 1.12 (12.8.93)
  7. **    Includes Release 40.15
  8. **
  9. **    cd.device include file
  10. **
  11. **    (C) Copyright 1992-1993 Commodore-Amiga, Inc.
  12. **        All Rights Reserved
  13. **
  14.  
  15.     INCLUDE "exec/types.i"
  16.     INCLUDE "exec/nodes.i"
  17.  
  18. ************************************************************************
  19. *                                       *
  20. *   CD Commands                               *
  21. *                                       *
  22. ************************************************************************
  23.  
  24. CD_RESET        equ  1
  25. CD_READ        equ  2
  26. CD_WRITE        equ  3
  27. CD_UPDATE        equ  4
  28. CD_CLEAR        equ  5
  29. CD_STOP        equ  6
  30. CD_START        equ  7
  31. CD_FLUSH        equ  8
  32. CD_MOTOR        equ  9
  33. CD_SEEK        equ 10
  34. CD_FORMAT        equ 11
  35. CD_REMOVE        equ 12
  36. CD_CHANGENUM        equ 13
  37. CD_CHANGESTATE        equ 14
  38. CD_PROTSTATUS        equ 15
  39.  
  40. CD_GETDRIVETYPE     equ 18
  41. CD_GETNUMTRACKS     equ 19
  42. CD_ADDCHANGEINT     equ 20
  43. CD_REMCHANGEINT     equ 21
  44. CD_GETGEOMETRY        equ 22
  45. CD_EJECT        equ 23
  46.  
  47.  
  48. CD_INFO        equ 32
  49. CD_CONFIG        equ 33
  50. CD_TOCMSF        equ 34
  51. CD_TOCLSN        equ 35
  52.  
  53. CD_READXL        equ 36
  54.  
  55. CD_PLAYTRACK        equ 37
  56. CD_PLAYMSF        equ 38
  57. CD_PLAYLSN        equ 39
  58. CD_PAUSE        equ 40
  59. CD_SEARCH        equ 41
  60.  
  61. CD_QCODEMSF        equ 42
  62. CD_QCODELSN        equ 43
  63. CD_ATTENUATE        equ 44
  64.  
  65. CD_ADDFRAMEINT        equ 45
  66. CD_REMFRAMEINT        equ 46
  67.  
  68. ************************************************************************
  69. *                                       *
  70. *   Device Driver Error Codes                           *
  71. *                                       *
  72. ************************************************************************
  73.  
  74. CDERR_OPENFAIL        equ -1        ; device/unit failed to open
  75. CDERR_ABORTED        equ -2        ; request terminated early
  76. CDERR_NOCMD        equ -3        ; command not supported by device
  77. CDERR_BADLENGTH    equ -4        ; invalid length (IO_LENGTH/IO_OFFSET)
  78. CDERR_BADADDRESS    equ -5        ; invalid address (IO_DATA misaligned)
  79. CDERR_UNITBUSY        equ -6        ; device opens ok, but unit is busy
  80. CDERR_SELFTEST        equ -7        ; hardware failed self-test
  81.  
  82. CDERR_NotSpecified    equ 20        ; general catchall
  83. CDERR_NoSecHdr        equ 21        ; couldn't even find a sector         
  84. CDERR_BadSecPreamble    equ 22      ; sector looked wrong                 
  85. CDERR_BadSecID          equ 23      ; ditto                               
  86. CDERR_BadHdrSum         equ 24      ; header had incorrect checksum       
  87. CDERR_BadSecSum         equ 25      ; data had incorrect checksum         
  88. CDERR_TooFewSecs        equ 26      ; couldn't find enough sectors
  89. CDERR_BadSecHdr    equ 27        ; another "sector looked wrong"
  90. CDERR_WriteProt    equ 28        ; can't write to a protected disk     
  91. CDERR_NoDisk            equ 29      ; no disk in the drive                
  92. CDERR_SeekError         equ 30      ; couldn't find track 0
  93. CDERR_NoMem        equ 31        ; ran out of memory
  94. CDERR_BadUnitNum    equ 32        ; asked for a unit > NUMUNITS
  95. CDERR_BadDriveType    equ 33        ; not a drive cd.device understands
  96. CDERR_DriveInUse    equ 34        ; someone else allocated the drive
  97. CDERR_PostReset    equ 35        ; user hit reset; awaiting doom
  98. CDERR_BadDataType    equ 36        ; data on disk is wrong type
  99. CDERR_InvalidState    equ 37        ; invalid cmd under current conditions
  100.  
  101. CDERR_Phase        equ 42        ; illegal or unexpected SCSI phase
  102. CDERR_NoBoard        equ 50        ; open failed for non-existant board
  103.  
  104.  
  105.  
  106. ************************************************************************
  107. *                                       *
  108. * Configuration                               *
  109. *                                       *
  110. *    The drive is configured by TagList items defined as follows:   *
  111. *                                       *
  112. ************************************************************************
  113.  
  114. TAGCD_PLAYSPEED    equ    $0001
  115. TAGCD_READSPEED    equ    $0002
  116. TAGCD_READXLSPEED    equ    $0003
  117. TAGCD_SECTORSIZE    equ    $0004
  118. TAGCD_XLECC        equ    $0005
  119. TAGCD_EJECTRESET    equ    $0006
  120.  
  121. ************************************************************************
  122. *                                       *
  123. * Information                                   *
  124. *                                       *
  125. *      Information/Status structure describes current speed settings   *
  126. *      for read and play commands, sector size, audio attenuation      *
  127. *      precision, and drive status.                       *
  128. *                                       *
  129. ************************************************************************
  130.  
  131.  STRUCTURE CDINFO,0
  132.                  ;                  Default
  133.     UWORD  CDINFO_PlaySpeed     ; Audio play speed          (75)
  134.     UWORD  CDINFO_ReadSpeed     ; Data-rate of CD_READ command   (Max)
  135.     UWORD  CDINFO_ReadXLSpeed     ; Data-rate of CD_READXL command (75)
  136.     UWORD  CDINFO_SectorSize     ; Number of bytes per sector      (2048)
  137.     UWORD  CDINFO_XLECC     ; CDXL ECC enabled/disabled
  138.     UWORD  CDINFO_EjectReset     ; Reset on eject enabled/disabled
  139.     STRUCT CDINFO_Reserved1,8     ; Reserved for future expansion
  140.  
  141.     UWORD  CDINFO_MaxSpeed     ; Maximum speed drive can handle (75, 150)
  142.     UWORD  CDINFO_AudioPrecision ; 0 = no attenuator, 1 = mute only,
  143.                  ; other = (# levels - 1)
  144.     UWORD  CDINFO_Status     ; See flags below
  145.     STRUCT CDINFO_Reserved2,8     ; Reserved for future expansion
  146.  
  147.     LABEL  CDINFO_SIZE
  148.  
  149.  
  150. ; Flags for Status
  151.  
  152. CDSTSB_CLOSED        equ 0     ; Drive door is closed
  153. CDSTSB_DISK        equ 1     ; A disk has been detected
  154. CDSTSB_SPIN        equ 2     ; Disk is spinning (motor is on)
  155. CDSTSB_TOC        equ 3     ; Table of contents read.  Disk is valid.
  156. CDSTSB_CDROM        equ 4     ; Track 1 contains CD-ROM data
  157. CDSTSB_PLAYING        equ 5     ; Audio is playing
  158. CDSTSB_PAUSED        equ 6     ; Pause mode (pauses on play command)
  159. CDSTSB_SEARCH        equ 7     ; Search mode (Fast Forward/Fast Reverse)
  160. CDSTSB_DIRECTION    equ 8     ; Search direction (0 = Forward, 1 = Reverse)
  161.  
  162. CDSTSF_CLOSED        equ $0001
  163. CDSTSF_DISK        equ $0002
  164. CDSTSF_SPIN        equ $0004
  165. CDSTSF_TOC        equ $0008
  166. CDSTSF_CDROM        equ $0010
  167. CDSTSF_PLAYING        equ $0020
  168. CDSTSF_PAUSED        equ $0040
  169. CDSTSF_SEARCH        equ $0080
  170. CDSTSF_DIRECTION    equ $0100
  171.  
  172. ; Modes for CD_SEARCH
  173.  
  174. CDMODE_NORMAL    equ 0        ; Normal play at current play speed
  175. CDMODE_FFWD    equ 1        ; Fast forward play (skip-play forward
  176. CDMODE_FREV    equ 2        ; Fast reverse play (skip-play reverse
  177.  
  178.  
  179. ************************************************************************
  180. *                                       *
  181. * Position Information                               *
  182. *                                       *
  183. *      Position information can be described in two forms: MSF and LSN *
  184. *      form.  MSF (Minutes, Seconds, Frames) form is a time encoding.  *
  185. *      LSN (Logical Sector Number) form is frame (sector) count.       *
  186. *      The desired form is selected using the io_Flags field of the    *
  187. *      IOStdReq structure.  The flags and the union are described      *
  188. *      below.                                   *
  189. *                                       *
  190. ************************************************************************
  191.  
  192.  STRUCTURE RMSF,0
  193.  
  194.     UBYTE   Reserved        ; Reserved (always zero)
  195.     UBYTE   Minute        ; Minutes (0-72ish)
  196.     UBYTE   Second        ; Seconds (0-59)
  197.     UBYTE   Frame        ; Frame   (0-74)
  198.     LABEL   RMSF_SIZE
  199.  
  200. ;UNION
  201.  
  202. LSNMSF_SIZE    equ RMSF_SIZE
  203.  
  204.  
  205. ************************************************************************
  206. *                                       *
  207. * CD Transfer Lists                               *
  208. *                                       *
  209. *      A CDXL node is a double link node; however only single linkage  *
  210. *      is used by the device driver.  If you wish to construct a       *
  211. *      transfer list manually, it is only neccessary to define the     *
  212. *      mln_Succ pointer of the MinNode.  You may also use the Exec     *
  213. *      list functions by defining a List or MinList structure and by   *
  214. *      using the AddHead/AddTail functions to create the list.    This   *
  215. *      will create a double-linked list.  Although a double-linked     *
  216. *      list is not required by the device driver, you may wish use it  *
  217. *      for your own purposes.  Don't forget to initialize the          *
  218. *      the List/MinList before using it!                               *
  219. *                                                                      *
  220. ************************************************************************
  221.  
  222.  STRUCTURE CDXL,0
  223.  
  224.     STRUCT  CDXL_Node,MLN_SIZE      ; double linkage      
  225.     APTR    CDXL_Buffer             ; data destination (word aligned) 
  226.     LONG    CDXL_Length             ; must be even # bytes
  227.     LONG    CDXL_Actual             ; bytes transferred   
  228.     APTR    CDXL_IntData            ; interrupt server data segment
  229.     APTR    CDXL_IntCode            ; interrupt server code entry
  230.     LABEL   CDXL_SIZE
  231.  
  232.  
  233. ************************************************************************
  234. *                                                                      *
  235. * CD Table of Contents                                                 *
  236. *                                                                      *
  237. *      The CD_TOC command returns an array of CDTOC entries.           *
  238. *      Entry zero contains summary information describing how many     *
  239. *      tracks the disk has and the play-time of the disk.              *
  240. *      Entries 1 through N (N = Number of tracks on disk) contain      *
  241. *      information about the track.                                    *
  242. *                                                                      *
  243. ************************************************************************
  244.  
  245.  STRUCTURE TOCSummary,0
  246.  
  247.     UBYTE   TOCS_FirstTrack          ; First track on disk (always 1)         
  248.     UBYTE   TOCS_LastTrack           ; Last track on disk                     
  249.     STRUCT  TOCS_LeadOut,LSNMSF_SIZE ; Beginning of lead-out (end of disk)
  250.     LABEL   TOCSummary_SIZE
  251.  
  252.  
  253.  STRUCTURE TOCEntry,0
  254.  
  255.     UBYTE   TOCE_CtlAdr                 ; Q-Code info                 
  256.     UBYTE   TOCE_Track                  ; Track number                
  257.     STRUCT  TOCE_Position,LSNMSF_SIZE   ; Start position of this track
  258.     LABEL   TOCEntry_SIZE
  259.  
  260.  
  261. ;UNION
  262.  
  263. CDTOC_SIZE      equ TOCEntry_SIZE
  264.  
  265.  
  266. ************************************************************************
  267. *                                                                      *
  268. * Q-Code Packets                                                       *
  269. *                                                                      *
  270. *      Q-Code packets are only returned when audio is playing.         *
  271. *      Currently, only position packets are returned (ADR_POSITION)    *
  272. *      The other ADR_ types are almost never encoded on the disk       *
  273. *      and are of little use anyway.  To avoid making the QCode        *
  274. *      structure a union, these other ADR_ structures are not defined. *
  275. *                                                                      *
  276. ************************************************************************
  277.  
  278.  STRUCTURE QCODE,0
  279.  
  280.     UBYTE   QCODE_CtlAdr                    ; Data type / QCode type          
  281.     UBYTE   QCODE_Track                     ; Track number                    
  282.     UBYTE   QCODE_Index                     ; Track subindex number           
  283.     UBYTE   QCODE_Zero                      ; The "Zero" byte of Q-Code packet
  284.     STRUCT  QCODE_TrackPosition,LSNMSF_SIZE ; Position from start of track    
  285.     STRUCT  QCODE_DiskPosition,LSNMSF_SIZE  ; Position from start of disk     
  286.     LABEL   QCODE_SIZE
  287.  
  288.  
  289. CTLADR_CTLMASK  equ $F0     ; Control field
  290.  
  291. CTL_CTLMASK     equ $D0     ; To be ANDed with CtlAdr before compared
  292.  
  293. CTL_2AUD        equ $00     ; 2 audio channels without preemphasis            
  294. CTL_2AUDEMPH    equ $10     ; 2 audio channels with preemphasis               
  295. CTL_4AUD        equ $80     ; 4 audio channels without preemphasis            
  296. CTL_4AUDEMPH    equ $90     ; 4 audio channels with preemphasis               
  297. CTL_DATA        equ $40     ; CD-ROM Data                                     
  298.  
  299. CTL_COPYMASK    equ $20     ; To be ANDed with CtlAdr before compared
  300.  
  301. CTL_COPY        equ $20     ; When true, this audio/data can be copied        
  302.  
  303. CTLADR_ADRMASK  equ $0F     ; Address field
  304.  
  305. ADR_POSITION    equ $01     ; Q-Code is position information                  
  306. ADR_UPC         equ $02     ; Q-Code is UPC information (not used)   
  307. ADR_ISRC        equ $03     ; Q-Code is ISRC (not used)
  308. ADR_HYBRID      equ $05     ; This disk is a hybrid disk
  309.  
  310.  
  311.         ENDC
  312.