Element: sound
Sound definition. The type attribute defines one of the different sound HW configurations: q, studio (Studio II sound), bit, cdp1863 (or 1863), vp550 (VIP supersound board VP550) or vp551 (VIP supersound board VP551).
For vp550 and vp551 add stereo="on" to activate stereo mode.
For studio, vp550 and vp551 no child elements are needed
Type: q
Sound definition using the Q flag, if defined either <hw> or <sw> should be used, not both.
| child element | attribute | value | description |
|---|---|---|---|
| hw | frequency (Hz) | Play beeper tone with specified frequency when Q=1. | |
| sw | Play tone with frequency as Q flag is switched between 1/0 by the 1802 CPU. |
Type: bit
Sound definition using one bit in the specified output port. Same concept as using type="q" and <sw>, but using one bit in the output port instead of the q flag.
| child element | attribute | value | description |
|---|---|---|---|
| iogroup | group number (8 bit) | Bit sound iogroup definition. For details about value usage see XML - I/O. | |
| out | mask, q | port (1 to 7) | Bit sound output port definition. Attribute mask indicates the bit number. Optionally q can be specified to define what value the q flag should have to activate the sound. For details about attribute and value usage see XML - I/O. |
Type: cdp1863
Sound definition using Q flag and output to latch the tone frequency.
| child element | attribute | value | description |
|---|---|---|---|
| iogroup | group number (8 bit) | Cdp1863 sound iogroup definition. For details about value usage see XML - I/O. | |
| out | mask, q | port (1 to 7) | Cdp1863 sound output port definition. For details about attribute and value usage see XML - I/O. |
Type: 8912
Sound definition using AY-3-8912 Programmable Sound Generator.
| child element | attribute | value | description |
|---|---|---|---|
| channel | type | left, right or centre | AY-3-8912 channel selector, type="a", "b" or "c" to indicate the channel and left, right or centre to define where the channel should be used. |
| io | mask, q, type | port (1 to 7) | AY-3-8912 sound output and input port definition. Use type="data" to select port type. For details about attribute and value usage see XML - I/O. |
| iogroup | group number (8 bit) | AY-3-8912 sound iogroup definition. For details about value usage see XML - I/O. | |
| out | ay, mask, q, type | port (1 to 7) | AY-3-8912 sound output port definition. Use type="register" to select port type and ay="1" or ay="2" to address PSG 1 or 2. For details about attribute and value usage see XML - I/O. |