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.16.2  Dosound                                                    TOS

 Name:         »Dosound« - Program the sound generator (PSG).

 Opcode:       32

 Syntax:       void Dosound( const int8_t *buf );

 Description:  The XBIOS routine Dosound starts a process for control 
               of the programmable sound generator. The buffer buf 
               holds commands for the programming of the sound 
               generator. The following commands are supported:

                Command     Meaning

                0x0x byte   Write byte into register x of the sound 
                            chip
                0x80 byte   Load bytes into temporary register for use 
                            by command 0x81
                0x81 byte1  Number of the sound register into which 
                            the value of the temporary register is to 
                            be transferred.
                     byte2  Signed value to be added to the temporary 
                            register until value in third byte is met.
                     byte3  Value of the temporary register at which 
                            the loop is terminated.
                0x82 byte   The number of 50 Hz ticks (20 ms) to wait 
                            for the next command. If the byte holds 
                            the value 0 the processing is terminated.
                ...
                0xff byte

 Return value: The function does not return a result.

 Availability: All TOS versions.

 Group:        Interface programming

 See also:     Binding