NEWS APPS DOCS ABOUT | ||||
Autodocs Include classes clib datatypes devices audio.h / .i bootblock.h / .i cd.h / .i clipboard.h / .i console.h / .i conunit.h / .i gameport.h / .i hardblocks.h / .i input.h / .i inputevent.h / .i keyboard.h / .i keymap.h / .i narrator.h / .i parallel.h / .i printer.h / .i prtbase.h / .i prtgfx.h / .i scsidisk.h / .i serial.h / .i timer.h / .i trackdisk.h / .i diskfont dos exec gadgets graphics hardware images intuition libraries pragma pragmas prefs proto reaction resources rexx utility workbench GuruMeditation | #ifndef DEVICES_CD_H #define DEVICES_CD_H /* ** $VER: cd.h 1.11 (12.8.1993) ** Includes Release 45.1 ** ** cd.device include file ** ** (C) Copyright 1992-2001 Amiga, Inc. ** All Rights Reserved */ #include <exec/types.h> #include <exec/nodes.h> /************************************************************************** * * * CD Commands * * * **************************************************************************/ #define CD_RESET 1 #define CD_READ 2 #define CD_WRITE 3 #define CD_UPDATE 4 #define CD_CLEAR 5 #define CD_STOP 6 #define CD_START 7 #define CD_FLUSH 8 #define CD_MOTOR 9 #define CD_SEEK 10 #define CD_FORMAT 11 #define CD_REMOVE 12 #define CD_CHANGENUM 13 #define CD_CHANGESTATE 14 #define CD_PROTSTATUS 15 #define CD_GETDRIVETYPE 18 #define CD_GETNUMTRACKS 19 #define CD_ADDCHANGEINT 20 #define CD_REMCHANGEINT 21 #define CD_GETGEOMETRY 22 #define CD_EJECT 23 #define CD_INFO 32 #define CD_CONFIG 33 #define CD_TOCMSF 34 #define CD_TOCLSN 35 #define CD_READXL 36 #define CD_PLAYTRACK 37 #define CD_PLAYMSF 38 #define CD_PLAYLSN 39 #define CD_PAUSE 40 #define CD_SEARCH 41 #define CD_QCODEMSF 42 #define CD_QCODELSN 43 #define CD_ATTENUATE 44 #define CD_ADDFRAMEINT 45 #define CD_REMFRAMEINT 46 /************************************************************************** * * * Device Driver Error Codes * * * **************************************************************************/ #define CDERR_OPENFAIL (-1) /* device/unit failed to open */ #define CDERR_ABORTED (-2) /* request terminated early */ #define CDERR_NOCMD (-3) /* command not supported by device */ #define CDERR_BADLENGTH (-4) /* invalid length (IO_LENGTH/IO_OFFSET) */ #define CDERR_BADADDRESS (-5) /* invalid address (IO_DATA misaligned) */ #define CDERR_UNITBUSY (-6) /* device opens ok, but unit is busy */ #define CDERR_SELFTEST (-7) /* hardware failed self-test */ #define CDERR_NotSpecified 20 /* general catchall */ #define CDERR_NoSecHdr 21 /* couldn't even find a sector */ #define CDERR_BadSecPreamble 22 /* sector looked wrong */ #define CDERR_BadSecID 23 /* ditto */ #define CDERR_BadHdrSum 24 /* header had incorrect checksum */ #define CDERR_BadSecSum 25 /* data had incorrect checksum */ #define CDERR_TooFewSecs 26 /* couldn't find enough sectors */ #define CDERR_BadSecHdr 27 /* another "sector looked wrong" */ #define CDERR_WriteProt 28 /* can't write to a protected disk */ #define CDERR_NoDisk 29 /* no disk in the drive */ #define CDERR_SeekError 30 /* couldn't find track 0 */ #define CDERR_NoMem 31 /* ran out of memory */ #define CDERR_BadUnitNum 32 /* asked for a unit > NUMUNITS */ #define CDERR_BadDriveType 33 /* not a drive cd.device understands */ #define CDERR_DriveInUse 34 /* someone else allocated the drive */ #define CDERR_PostReset 35 /* user hit reset; awaiting doom */ #define CDERR_BadDataType 36 /* data on disk is wrong type */ #define CDERR_InvalidState 37 /* invalid cmd under current conditions */ #define CDERR_Phase 42 /* illegal or unexpected SCSI phase */ #define CDERR_NoBoard 50 /* open failed for non-existant board */ /************************************************************************** * * * Configuration * * * * The drive is configured by TagList items defined as follows: * * * **************************************************************************/ #define TAGCD_PLAYSPEED 0x0001 #define TAGCD_READSPEED 0x0002 #define TAGCD_READXLSPEED 0x0003 #define TAGCD_SECTORSIZE 0x0004 #define TAGCD_XLECC 0x0005 #define TAGCD_EJECTRESET 0x0006 /************************************************************************** * * * Information * * * * Information/Status structure describes current speed settings * * for read and play commands, sector size, audio attenuation * * precision, and drive status. * * * **************************************************************************/ struct CDInfo { /* Default */ UWORD PlaySpeed; /* Audio play speed (75) */ UWORD ReadSpeed; /* Data-rate of CD_READ command (Max) */ UWORD ReadXLSpeed; /* Data-rate of CD_READXL command (75) */ UWORD SectorSize; /* Number of bytes per sector (2048) */ UWORD XLECC; /* CDXL ECC enabled/disabled */ UWORD EjectReset; /* Reset on eject enabled/disabled */ UWORD Reserved1[4]; /* Reserved for future expansion */ UWORD MaxSpeed; /* Maximum speed drive can handle (75, 150) */ UWORD AudioPrecision; /* 0 = no attenuator, 1 = mute only, */ /* other = (# levels - 1) */ UWORD Status; /* See flags below */ UWORD Reserved2[4]; /* Reserved for future expansion */ }; /* Flags for Status */ #define CDSTSB_CLOSED 0 /* Drive door is closed */ #define CDSTSB_DISK 1 /* A disk has been detected */ #define CDSTSB_SPIN 2 /* Disk is spinning (motor is on) */ #define CDSTSB_TOC 3 /* Table of contents read. Disk is valid. */ #define CDSTSB_CDROM 4 /* Track 1 contains CD-ROM data */ #define CDSTSB_PLAYING 5 /* Audio is playing */ #define CDSTSB_PAUSED 6 /* Pause mode (pauses on play command) */ #define CDSTSB_SEARCH 7 /* Search mode (Fast Forward/Fast Reverse) */ #define CDSTSB_DIRECTION 8 /* Search direction (0 = Forward, 1 = Reverse) */ #define CDSTSF_CLOSED 0x0001 #define CDSTSF_DISK 0x0002 #define CDSTSF_SPIN 0x0004 #define CDSTSF_TOC 0x0008 #define CDSTSF_CDROM 0x0010 #define CDSTSF_PLAYING 0x0020 #define CDSTSF_PAUSED 0x0040 #define CDSTSF_SEARCH 0x0080 #define CDSTSF_DIRECTION 0x0100 /* Modes for CD_SEARCH */ #define CDMODE_NORMAL 0 /* Normal play at current play speed */ #define CDMODE_FFWD 1 /* Fast forward play (skip-play forward)*/ #define CDMODE_FREV 2 /* Fast reverse play (skip-play reverse)*/ /************************************************************************** * * * Position Information * * * * Position information can be described in two forms: MSF and LSN * * form. MSF (Minutes, Seconds, Frames) form is a time encoding. * * LSN (Logical Sector Number) form is frame (sector) count. * * The desired form is selected using the io_Flags field of the * * IOStdReq structure. The flags and the union are described * * below. * * * **************************************************************************/ struct RMSF { UBYTE Reserved; /* Reserved (always zero) */ UBYTE Minute; /* Minutes (0-72ish) */ UBYTE Second; /* Seconds (0-59) */ UBYTE Frame; /* Frame (0-74) */ }; union LSNMSF { struct RMSF MSF; /* Minute, Second, Frame */ ULONG LSN; /* Logical Sector Number */ }; /************************************************************************** * * * CD Transfer Lists * * * * A CDXL node is a double link node; however only single linkage * * is used by the device driver. If you wish to construct a * * transfer list manually, it is only neccessary to define the * * mln_Succ pointer of the MinNode. You may also use the Exec * * list functions by defining a List or MinList structure and by * * using the AddHead/AddTail functions to create the list. This * * will create a double-linked list. Although a double-linked * * list is not required by the device driver, you may wish use it * * for your own purposes. Don't forget to initialize the * * the List/MinList before using it! * * * **************************************************************************/ struct CDXL { struct MinNode Node; /* double linkage */ char *Buffer; /* data destination (word aligned) */ LONG Length; /* must be even # bytes */ LONG Actual; /* bytes transferred */ APTR IntData; /* interrupt server data segment */ VOID (*IntCode)(); /* interrupt server code entry */ }; /************************************************************************** * * * CD Table of Contents * * * * The CD_TOC command returns an array of CDTOC entries. * * Entry zero contains summary information describing how many * * tracks the disk has and the play-time of the disk. * * Entries 1 through N (N = Number of tracks on disk) contain * * information about the track. * * * **************************************************************************/ struct TOCSummary { UBYTE FirstTrack; /* First track on disk (always 1) */ UBYTE LastTrack; /* Last track on disk */ union LSNMSF LeadOut; /* Beginning of lead-out track (end of disk) */ }; struct TOCEntry { UBYTE CtlAdr; /* Q-Code info */ UBYTE Track; /* Track number */ union LSNMSF Position; /* Start position of this track */ }; union CDTOC { struct TOCSummary Summary; /* First entry (0) is summary information */ struct TOCEntry Entry; /* Entries 1-N are track entries */ }; /************************************************************************** * * * Q-Code Packets * * * * Q-Code packets are only returned when audio is playing. * * Currently, only position packets are returned (ADR_POSITION) * * The other ADR_ types are almost never encoded on the disk * * and are of little use anyway. To avoid making the QCode * * structure a union, these other ADR_ structures are not defined. * * * **************************************************************************/ struct QCode { UBYTE CtlAdr; /* Data type / QCode type */ UBYTE Track; /* Track number */ UBYTE Index; /* Track subindex number */ UBYTE Zero; /* The "Zero" byte of Q-Code packet */ union LSNMSF TrackPosition; /* Position from start of track */ union LSNMSF DiskPosition; /* Position from start of disk */ }; #define CTLADR_CTLMASK 0xF0 /* Control field */ #define CTL_CTLMASK 0xD0 /* To be ANDed with CtlAdr before compared */ #define CTL_2AUD 0x00 /* 2 audio channels without preemphasis */ #define CTL_2AUDEMPH 0x10 /* 2 audio channels with preemphasis */ #define CTL_4AUD 0x80 /* 4 audio channels without preemphasis */ #define CTL_4AUDEMPH 0x90 /* 4 audio channels with preemphasis */ #define CTL_DATA 0x40 /* CD-ROM Data */ #define CTL_COPYMASK 0x20 /* To be ANDed with CtlAdr before compared */ #define CTL_COPY 0x20 /* When true, this audio/data can be copied */ #define CTLADR_ADRMASK 0x0F /* Address field */ #define ADR_POSITION 0x01 /* Q-Code is position information */ #define ADR_UPC 0x02 /* Q-Code is UPC information (not used) */ #define ADR_ISRC 0x03 /* Q-Code is ISRC (not used) */ #define ADR_HYBRID 0x05 /* This disk is a hybrid disk */ #endif Comments |
$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se |