AY-3-8912 PSG Documentation

The Amstrad CPC,CPC+ and KC Compact use a AY-3-8912 Programmable sound generator (referred to as PSG in this document), operating at 1Mhz. This document will describe it's role in these systems. To understand the full functions please read the datasheet.

In these systems it is accessed through and connected to the 8255 PPI. (You should understand the operation of the 8255 if you wish to access the PSG)

As well as generating sound, the PSG is also used to scan the keyboard matrix to read the state of the keyboard and joysticks. The selected keyboard matrix line data is available at PSG I/O Port A. (The selected matrix line is programmed to PPI Port C bits 3-0. See the document about scanning the keyboard matrix for a full description of the algorithm involved).

The databus of the PSG is connected to PPI Port A. Data is read from/written to the PSG through this port.

The PSG function, defined by the BC1,BC2 and BDIR signals, is controlled by bit 7 and bit 6 of PPI Port C.

PSG signals:

PPI Port C Bit PSG Signal
7BDIR
6BC1

PSG function selection:

PPI Port C Bit PSG Function
7 6
0 0 Inactive
0 1 Read from selected PSG register.

When function is set, the PSG will make the register data available to PPI Port A

1 0 Write to selected PSG register

When set, the PSG will take the data at PPI Port A and write it into the selected PSG register

1 1 Select PSG register

When set, the PSG will take the data at PPI Port A and select a register

Note:

Programming the PSG

The PSG has 16 internal registers and these control the operation. Before a register can be read from/written to it must be selected.

Register selection

To write data to the PSG, PPI Port A must be operating as output. (See the document on the 8255 to see how to do this)

To select a register, write the register number into PPI Port A, then set bit 7 and bit 6 of Port C to "1".

The register will now be selected and the user can read from or write to it.

The register will remain selected until another is chosen.

Writing to the selected PSG register

To write data to the PSG, PPI Port A must be operating as output. (See the document on the 8255 to see how to do this)

To write data into the selected PSG register:

The data will then be written into the register.

Reading from the selected PSG register

To read data from the PSG, PPI Port A must be operating as input. (See the document on the 8255 to see how to do this)

To read data from the selected register:

The register data is available at PPI Port A.

Notes

  1. If the tone period is in the range 0-4 I can not hear any tone output.

Programming Examples

  1. Reading a value from a PSG register.

    This routine can be used to read data from a PSG register.

    ;; entry conditions:
    ;; c = register index
    ;; exit conditions:
    ;; a = register data
    ;; b,c,f corrupt
    ;; PPI port A is returned to output
    ;; assumptions:
    ;; PPI port A is set to output, PPI port C is set to output.
    
    .read_from_psg
    ld b,&f4            ;} Setup register index on PPI port A
    out (c),c               ;}
    
    ld bc,&f6c0            ;} Tell PSG to select register using data on PPI port A
    out (c),c               ;}
    
    ld bc,&f600            ;} Put PSG into inactive state
    out (c),c
    
                            ;** Set PPI port A to input mode. **
    ld b,&f7            ; 8255 PPI Control
    ld c,%10010010          ; mode and port configuration
    out (c),c               ; Port A input, Port B input, Port C output
                            ; All operating in mode 0. (see Programming
                            ; 8255 PPI)
    
    ld bc,&f640            ;} Tell PSG to put the data of the selected register to PPI port A to
    out (c),c               ;}
    
    ld b,&f4            ;} Read data from PPI port A
    in a,(c)                ;}
    
                            ;** Set PPI port A to output mode. *
    ld b,&f7            ;8255 PPI control
    ld c,%10000010
    out (c),c               ;Port A output, Port B input, Port C output
    
    ld bc,&f600            ;} Return PSG to inactive mode.
    out (c),c               ;}
    ret
    
  2. Writing to a PSG register.

    This routine can be used to write to registers on the PSG. C contains the index of the PSG register to write. A contains the data to write to the PSG register.

    ;; entry conditions:
    ;; C = register number
    ;; A = register data
    ;; exit conditions:
    ;; b,C,F corrupt
    ;; assumptions:
    ;; PPI port A and PPI port C are setup in output mode.
    
    .write_to_psg
    ld b,&f4            ;} setup PSG register number on PPI port A
    out (c),c               ;}
    
    ld bc,&f6c0            ;} Tell PSG to select register from data on PPI port A
    out (c),c               ;}
    
    ld bc,&f600            ;} Put PSG into inactive state.
    out (c),c               ;}
    
    ld b,&f4            ;} setup register data on PPI port A
    out (c),a               ;}
    
    ld bc,&f680            ;} Tell PSG to write data on PPI port A into selected register
    out (c),c               ;}
    
    ld bc,&f600            ;} Put PSG into inactive state
    out (c),c               ;}
    ret