•  Back 
  •  Sound routines 
  •  Index 
  •  Tree View 
  •  Cross references 
  •  Help page 
  •  Show info about hypertext 
  •  View a new file 
Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File4.17.3  devconnect                                                 TOS

 Name:         »devconnect« - Connect audio subsystem components

 Opcode:       139

 Syntax:       int32_t devconnect( int16_t src, int16_t dst, int16_t 
               srcclk, int16_t prescale, int16_t protocol );

 Description:  The XBIOS routine devconnect connects a source 
               component in the audio subsystem to one or more 
               destination components using the connection matrix.

                Parameter  Meaning 
                src        Source component: 
                           0   DMA output 
                           1   DSP output 
                           2   External input channel 
                           3   A/D converter - microphone 
 
                dst        Bit vector of the destination component: 
                           Bit 0  DMA input (for recording) 
                           Bit 1  DSP input receiving 
                           Bit 2  External output channel 
                           Bit 3  D/A converter/loudspeaker or phones 
 
                srcclk     Clock for the source components: 
                           0  Internal 25.175 MHz clock 
                           1  External clock 
                              For MilanBlaster the external clock is 
                              24.576 MHz when gpio(1,0) & 0x1l == 1l 
                              and 22.5792 MHz when gpio(1,0) & 
                              0x1l == 0l 
                           2  Internal 32 MHz clock 
 
                prescale   Clock prescaler. The sample rate is the 
                           result of the clock divided by 256 and 
                           divided by prescaler + 1. The values for 
                           the prescaler range from 0 to 11. 
                           If 0 is passed to the prescaler, then the 
                           mode will be switched to STE compatibility 
 
                protocol   If 0 is passed, transmission will be 
                           with handshaking, with 1 there is no 
                           handshaking. 

 Return value: The function returns the value 0 if the operation was 
               successfull, or non-zero otherwise.

 Availability: The function is only available on computers of the 
               Falcon series, or with extended XBIOS routines (_SND).

 Group:        Sound routines

 See also:     Binding   buffoper   buffptr   dsptristate   gpio 
               locksnd   setbuffer   setinterrupt   setmontracks 
               setmode   settracks   sndstatus   soundcmd   unlocksnd