A2 SD Music+ User manual

SD
SDSD
SD
SD
SDSD
SD Music+
Music+Music+
Music+
Music+
Music+Music+
Music+ user
useruser
user
user
useruser
user’ ’s manual
s manuals manual
s manual
s manual
s manuals manual
s manual
http:/ / www.apple2.net
\tÇ ^|Å

Prologue
Prologue
• Our APPLE II has a speaker and can make some simple sound and CPU must handle every t
ics for tone, Due to these difficulties, new sound card appeared name of Mocking board I, I
I, A,C but, so long time ago and discontinued.
During long time, It was my the only sound card for APPLE II and I can’t find another sound
card Of course I can have a Passport card but it isn’t sound card. It is just MIDI interface.
After research both FM chip , AY3- 8910 and 6522 functions, I could design new sound card
it is the SD Music+.
It isn’ t just new sound card with new chip sets. If we need new program or new game(?) , it
would be useless that’s why It is compatible as our classic mocking board but, much better
musical instruments.
• The SD Music+ integrated with new technologies to drive FM chips(YM2413).
• You can use this card on APPLE II, II+, / / e even IIGS but, as we know, Mocking board does
n’t work well with APPLE IIGS and have same compatible issue.
• It can produce 9 channels of sound and 8 channels are used for mocking board channel an
d the last one is used for noise emulation.
• But mocking board have limitations and not very good to drive YM2413, For drive all functio
ns of Ym2413 sound chip, It provide ‘Native mode’ with this mode, you can control YM2413
almost of all functions and there are no limitations as mocking board compatible mode. For
example you can use 5 percussion sounds and can add one user music instruments and ca
n change to another music instruments.
• If you are good at the programming on APPLE II, You can make good music player or music
converter.

Introduction
Introduction
SD Music+
SD Music+SD Music+
SD Music+ is 2nd version of SD Music card.
is 2nd version of SD Music card.is 2nd version of SD Music card.
is 2nd version of SD Music card.
It has enhanced mockingboard channels for great music.
It has enhanced mockingboard channels for great music.It has enhanced mockingboard channels for great music.
It has enhanced mockingboard channels for great music.
It is translate control signals of Mockingboard chips and make g
It is translate control signals of Mockingboard chips and make gIt is translate control signals of Mockingboard chips and make g
It is translate control signals of Mockingboard chips and make great sound.
reat sound.reat sound.
reat sound.
It has APPLE II spaker mixer without wire connection on
It has APPLE II spaker mixer without wire connection onIt has APPLE II spaker mixer without wire connection on
It has APPLE II spaker mixer without wire connection on APPLE II speaker.
APPLE II speaker.APPLE II speaker.
APPLE II speaker.
Enjoy it on your APPLE II with SD Music+ music supports.
Enjoy it on your APPLE II with SD Music+ music supports.Enjoy it on your APPLE II with SD Music+ music supports.
Enjoy it on your APPLE II with SD Music+ music supports.
Thank you very much;
Thank you very much;Thank you very much;
Thank you very much;

Installation
Installation
☞
☞☞
☞WARNING
WARNINGWARNING
WARNING
•Before to connect SD Music+, Please unplug power cord
unplug power cordunplug power cord
unplug power cord both
APPLE II and your Audio amplifier.
•SLOT# 4 is recommanded cause some of game just try to detect
mockingboard existance on SLOT# 4 but works also another slot
if game S/ W could select slot# of mockingboard.

SD
SD Music+ Music+ connector and switches connector and switches
Music Instruments SW
APPLE ][ Speaker Enable/Disable
3.5mm Audio out jack
LED while on Active

Music instrument assign Utility
Music instrument assign Utility
•You can find image file which is a utility for assign music instruments of SD Music+.
You need to transfer this utility disk to your real APPLE II via ADT or SD
DISK] [ Emulator. But, if you are difficult, Please try to keyin the shor BASIC program.
•If you have disk emulator, boot the Image disk.
•You can select channel which you want to change music instruments.
(It doesn’t show present music instruments sorry for it.)
You can select instruments by < > keys and set with Return key.
Then It will store your setting into the EEPROM of SD Music+.
For exit press ESC key
•You need to consider the switch cap, Cause it will return to defaults every Power ON.
If you want to keep your changes, you have to remove the cap.
•Anyway, this returning to default setting is doing once the power ON.

Music instrument
Music instruments sconfiguration configuration
Simply key- in channel number to change music instruments
Then use arrow key(<- >)to select music instruments then Press Enter.
Thant’s all.. If you want exit, just press ESC..
Recommended to remove switch block to avoid resetting again while the Power ON APPLE II.

Sound
Sound channel channels s
•Mocking board II,A,C are have total 6 channels and each chann
el assigned to SD Music+ as below.
<
<<
<No
NoNo
No Switch block
Switch blockSwitch block
Switch block for maximum instruments
for maximum instrumentsfor maximum instruments
for maximum instruments>
>>
>
Mocking boar
Mocking boarMocking boar
Mocking boar
d channel
d channeld channel
d channel
SD Music
SD MusicSD Music
SD Music+
++
+
Channel
ChannelChannel
Channel
Remarks
RemarksRemarks
Remarks
1 1(7) 7th is chorus
2 2(8) 8th is chorus
3 3
4 4
5 5
6 6
1
st
Noise 9 Noise
2
nd
Noise 9 Noise
7th channel and 8th channel are used just
for chorus and playing with major channel .

Channels assign
Channels assign
• Maximum 8 music instruments are assigned for each 6 mocking
board channels. Each music instrument assigned in 1 to 6 and t
wo more music instruments are used as chorus on 1 and 2
(No Switch block)
So it would be 1(7),2(8),3,4,5,6
• You can change this music instruments array with setting utility
or your own simple BASIC code anyways total music instrument
s are 16 (Noise included)

Simple BASIC source code for
Simple BASIC source code for
Instruments assign
Instruments assign
You can use this source code for your SD Music+.
You need to insert SD music+ slot in # 4
Simple put channel number then Music instruments number.
If channel number is ‘0’ then will end of program.
Channel number is valid 1 to 8 and Music instruments number is valid 0~ 15
Please refer music instruments table.
10 HOME
10 HOME10 HOME
10 HOME
20 INPUT
20 INPUT20 INPUT
20 INPUT “
““
“CHANNEL?
CHANNEL?CHANNEL?
CHANNEL?“
““
“;C
;C;C
;C
30 IF C=0 THEN END
30 IF C=0 THEN END30 IF C=0 THEN END
30 IF C=0 THEN END
40 INPUT
40 INPUT40 INPUT
40 INPUT “
““
“MUSIC INSTRUMENT?
MUSIC INSTRUMENT?MUSIC INSTRUMENT?
MUSIC INSTRUMENT?“
““
“;M
;M;M
;M
50 S=C*16+M
50 S=C*16+M50 S=C*16+M
50 S=C*16+M
60 POKE 50306,255:POKE 50307,255
60 POKE 50306,255:POKE 50307,25560 POKE 50306,255:POKE 50307,255
60 POKE 50306,255:POKE 50307,255
70 POKE 50304,129: POKE 50305,S
70 POKE 50304,129: POKE 50305,S70 POKE 50304,129: POKE 50305,S
70 POKE 50304,129: POKE 50305,S
80 POKE 50304,255
80 POKE 50304,25580 POKE 50304,255
80 POKE 50304,255
90 GOTO 20
90 GOTO 2090 GOTO 20
90 GOTO 20
Reference code on Monitor
Reference code on MonitorReference code on Monitor
Reference code on Monitor
(n: is slot number)
(n: is slot number)(n: is slot number)
(n: is slot number)
Cn82:FF
Cn82:FFCn82:FF
Cn82:FF ‘
‘‘
‘Set PortB
Set PortBSet PortB
Set PortB’
’’
’
Cn83:FF
Cn83:FFCn83:FF
Cn83:FF ‘
‘‘
‘Set PortA
Set PortASet PortA
Set PortA’
’’
’
Cn80:81
Cn80:81Cn80:81
Cn80:81 ‘
‘‘
‘Mode for change of instrument
Mode for change of instrumentMode for change of instrument
Mode for change of instrument’
’’
’
Cn81: # #
Cn81: # #Cn81: # #
Cn81: # # ‘
‘‘
‘Channel/ Instrument number
Channel/ Instrument numberChannel/ Instrument number
Channel/ Instrument number’
’’
’
Cn80:FF
Cn80:FFCn80:FF
Cn80:FF ‘
‘‘
‘End of configuration
End of configurationEnd of configuration
End of configuration

Tip for music instruments
Tip for music instruments
•Two type of Music instrument are using on SD Music+. One is concurrent
sounding instrument and the other is short period sounding instruments and SD
Music+ have major 1(7),2(8),3,4,5,6 channels and 7,8 channels are behind of
1st and 2nd channel. When 1
st
channel is playing then 7 channel of music
instrument also playing together and 8 channel also playing with channel 2. It
named as chorus instruments.
•The major channels(1,2,3,4,5,6) are good playing with concurrent music
instrument cause of Some of music using changing volume while the playing
sound and sub channel is recommended to assign short period instruments.
•If you assign short period(hit) music instruments to major channel, the sound
wasn’t good cause of again controlled by volume while the playing decay time.
•And sub channel doesn’t control by mocking board volume.
•Sub channel on and off is depend on the switch block configuration.
•If 1- 2 on, it doesn’t have sub channel, 2- 3 on is one sub channel. Open is 2
sub channels.

Return to default instruments
Return to default instruments
Mode selection is following by switch block position as
below.
•1
11
1-
--
- 2
22
23 : One music instrument used(Clarinet). Little
similar as the Mockingboard sound.
(2 noise channel, no sub instrument)
•1 2
22
2-
--
- 3
33
3: Set to SD Music+ instruments to default.
When you turn on the APPLE II, It will return to SD d
efault. (Factory default)
(2 noise channel
2 noise channel2 noise channel
2 noise channel, one sub channel
one sub channelone sub channel
one sub channel)
•1 2 3 : No
NoNo
No switch cap.
Using previous stored instruments setting.
It doesn’t change any music instrument.
If you want to use user defined sets, you need set
as this mode.
One noise channel
One noise channelOne noise channel
One noise channel, two sub channels
two sub channelstwo sub channels
two sub channels get activate
※If switch block was inserted on SD Mu
sic+, It will return to default music instru
ments set every power on the APPLE II.
If you want to keep your own configured
instruments array, Please remove the swi
tch block.

Music instruments channel status
Music instruments channel status
•Mocking board similar mode
•No sub chorus channel
•2 noise channel on 8,9
•Channel# 7 is not used
Channel #
Channel #Channel #
Channel # Music instrume
Music instrumeMusic instrume
Music instrume
nt#
nt#nt#
nt#
Description
DescriptionDescription
Description
1 5 Clarinet
2 5 Clarinet
3 5 Clarinet
4 5 Clarinet
5 5 Clarinet
6 5 Clarinet
8(1
st
noise ) 0 Noise
9(2
nd
noise) 0 Noise
Switch block on
Switch block onSwitch block on
Switch block on 1
11
1-
--
- 2
22
2(Left)
(Left)(Left)
(Left)
Channel #
Channel #Channel #
Channel # Music instrumen
Music instrumenMusic instrumen
Music instrumen
t#
t#t#
t#
Description
DescriptionDescription
Description
1 (7) 4 (2) Flute / Guitar
2 9 Horn
3 6 Oboe
4 5 Clarinet
5 7 Trumpet
6 8 Organ
8(1
st
noise) 0 Noise
9(2
nd
noise) 0 Noise
Switch block on
Switch block onSwitch block on
Switch block on 2
22
2-
--
- 3
33
3(
((
(Right
RightRight
Right)
))
)
•One sub chorus channel
•2 noise channel on 8,9
Channel #
Channel #Channel #
Channel # Music instrume
Music instrumeMusic instrume
Music instrume
nt#
nt#nt#
nt#
Description
DescriptionDescription
Description
1(7) No change No change
2(8) “ “
3 “ “
4 “ “
5 “ “
6 “ “
9 (1
st
& 2
nd
) 0 Noise
•Using previous setting
•One noise channel on 9
•2 sub chorus channel activate
No
NoNo
No switch cap
switch capswitch cap
switch cap

List of Music instruments
List of Music instruments
User define(Noise)
User define(Noise)User define(Noise)
User define(Noise)
Concurrent sound
Short sound

Control as mocking board
Control as mocking board
To control mocking board, you need to know how to use 6522. Mock
To control mocking board, you need to know how to use 6522. MockTo control mocking board, you need to know how to use 6522. Mock
To control mocking board, you need to know how to use 6522. Mocking board have tow 6522 an
ing board have tow 6522 aning board have tow 6522 an
ing board have tow 6522 an
d connection to AY3
d connection to AY3d connection to AY3
d connection to AY3-
--
- 8910 as interface device. There are three major functions, Timer
8910 as interface device. There are three major functions, Timer8910 as interface device. There are three major functions, Timer
8910 as interface device. There are three major functions, Timer ,Int
,Int,Int
,Int
errupts and Port IO.
errupts and Port IO.errupts and Port IO.
errupts and Port IO.
•Each 6522 has one timer and two IO ports
Each 6522 has one timer and two IO portsEach 6522 has one timer and two IO ports
Each 6522 has one timer and two IO ports
–Timer
TimerTimer
Timer
•You can use timer interrupts for accurate sound processing, 6522 provide one t
imer interrupt and 6502 can have proper timing to send next note of your song.
You need to learn how to handle this interrupts control and for set it Please refe
r 6522 manual.
•Port A and
Port A andPort A and
Port A and Port B for AY8910
Port B for AY8910Port B for AY8910
Port B for AY8910
–Set AY3
Set AY3Set AY3
Set AY3-
--
- 8910 to get register number.
8910 to get register number.8910 to get register number.
8910 to get register number.
•Set ay3- 8910 register number, Register number must already have on $Cn01 e
arlier, then this function just set act to sound chip to aware the data is Register
number.
–Store Data
Store DataStore Data
Store Data
•Data should store in $Cn01 and send data to previous register number.
–Reset the sound chip
Reset the sound chipReset the sound chip
Reset the sound chip
•Reset all AY3- 8910 Registers. You can use it to reset the chip.

IO Address and diagram
IO Address and diagram
•Mocking
MockingMocking
Mocking board
boardboard
board-
--
-II,A,C have two
II,A,C have twoII,A,C have two
II,A,C have two AY3
AY3AY3
AY3-
--
- 8910
89108910
8910.
–1
st
6522 occupied $Cn0x
$Cn0x$Cn0x
$Cn0x and 2
nd
6522 is $Cn8x
$Cn8x$Cn8x
$Cn8x
•Mocking
MockingMocking
Mocking board
boardboard
board-
--
-I has one AY3
I has one AY3I has one AY3
I has one AY3-
--
-8910
89108910
8910
–Connected on $Cn0x
$Cn0x$Cn0x
$Cn0x
•SD Music+ has one 6522
–$Cn0x and $Cn8x are mirrored
$Cn0x and $Cn8x are mirrored$Cn0x and $Cn8x are mirrored
$Cn0x and $Cn8x are mirrored
APPLE2 IO Slot
APPLE2 IO SlotAPPLE2 IO Slot
APPLE2 IO Slot
Atmega128
Atmega128Atmega128
Atmega128 YM2413
YM2413YM2413
YM2413
6522
65226522
6522
※n is slot number

Direct control of YM2413
Direct control of YM2413
•SD Music
SD MusicSD Music
SD Music+
++
+also occupied same address as Mocking board. It occupied $Cn0x t
$Cn0x t$Cn0x t
$Cn0x t
o
oo
o $Cn8x but only
$Cn8x but only$Cn8x but only
$Cn8x but only has
hashas
has one timer and IRQ interrupt.
one timer and IRQ interrupt.one timer and IRQ interrupt.
one timer and IRQ interrupt.
–Mocking board compatible mode are following mocking board control.
•If you want to make new music player, I recommended to use this ‘nati
ve mode’to control all of functions of YM2413. It is similar way as Moc
king board but transparent way to control YM2413 chip.
–For ‘Native mode
Native modeNative mode
Native mode’,
,,
, you can control as 2
nd
AY3- 8910 but, register number is
start from 128
128128
128-
--
-. For example, Register # 128 is Register # 0 of YM2413, Register
# 129 is heading to Register # 1 of YM2413 and so on.
So, with this say, you can control YM2413.
–YM2413 Reset is same as Mocking board.
–Register are write only.
※Controlling SD Music+ is can be done same way of Mocking board. it’s easy to use with old software. But, it
can’t use all of functions of YM2413 and sound may limited under mocking board control. So I suggest to tr
y to use ‘Native mode’for full control. It is logically separated and located 2
nd
AY3- 8910 Register number 1
28(MSB).

Sample
Sample Mockingboard Mockingboard routine routine
•INIT ; Init of 6522 (once required)
INIT ; Init of 6522 (once required)INIT ; Init of 6522 (once required)
INIT ; Init of 6522 (once required)
LDA # $FF
STA DDRA; $C403
LDA # $07
STA DDRB; $C402
RTS
•RESET; Reset AY3
RESET; Reset AY3RESET; Reset AY3
RESET; Reset AY3-
--
- 8910
89108910
8910
LDA # $00
STA ORB ;$C400
LDA # $04
STA ORB
ORBORB
ORB ;$C400
RTS
•Store data for Register
Store data for RegisterStore data for Register
Store data for Register
•LDA # 11(Data)
STA ORA
ORAORA
ORA; $C401
RTS
•Use data for Register number
Use data for Register numberUse data for Register number
Use data for Register number
LDA # $07
STA ORB ;$C400
LDA # $04
STA ORB ;$C400
RTS
•Use data for Register data
Use data for Register dataUse data for Register data
Use data for Register data
LDA # $06
STA ORB ;$C400
LDA # $04
STA ORB ;$C400
RTS
1
11
1
st
st st
st
6522 base address $Cn00
6522 base address $Cn006522 base address $Cn00
6522 base address $Cn00
2
22
2
nd
nd nd
nd
6522 base Address $Cn80
6522 base Address $Cn806522 base Address $Cn80
6522 base Address $Cn80
(n is slot number
n is slot numbern is slot number
n is slot number)

6522 Register table
6522 Register table

AY3
AY3- -8910 Register table 8910 Register table