MAMEDEV Wiki - User contributions [en-gb]

Driver:FMTowns

2020-07-12T03:00:37Z

Mahlemiut: mention which drivers have the necessary SCSI device

== Installing TownsOS ==

You will need:
* Towns System Software v2.1L51 operating system CD image (software list shortname: tss2151)

=== Create a hard disk image ===
* First, create a blank hard disk image using chdman.
'''./chdman createhd -o ''<path to HD image file>'' -c none -chs 768,16,16'''
The CHS values are up to you, they only affect the size of the disk image, the example given will give about a 100MB image. The geometry itself is irrelevant for the FM-Towns as hard disks are SCSI. -c none is also important, as this disables compression, but allows direct writing to the image data (compressed CHDs are read-only).
If you've used the fmtowns driver before, it might be easier if you move or delete all the files in the nvram/fmtowns folder. This will clear all CMOS settings, which may interfere with some things.

=== Boot TownsOS and run installation program ===
* Start MAME, with the Towns System Software CD and your newly created hard disk image mounted in -cdrom and -hard1 slots respectively. Please note that only a couple of drivers (fmtownsux and fmtownssj) have the SCSI controller installed, matching the setup of the original models.
'''./mame64 fmtownsux -cdrom tss2151 -hard1 ''<path to HD image file>'''''
The emulated system should now start to boot from the CD image. Once at the GUI, double-click the ツール (tool) icon in the TOWNSSYSTEM window. In the new window that appears, double-click the HDインストール (HD install) icon (highlighted in this screenshot):
[[File:tos_hdinstall_1.png]]

* A dialog will apear, asking the OS to install, either TownsOS or Windows 3.1. Select TownsOS, then click the emboldened button. Now you should see this dialog:
[[File:tos_hdinstall_2.png]]

Make sure the first option is selected, and click the emboldened button. The second option is likely used for upgrading an existing TownsOS installation.

* Next select the hard disk to install to. As the disk drive is unformatted, no drive letters are assigned to any HDs, so you must select disk unit number. Numbers are assigned to each physical SCSI HD, from 0 to 4. MAME's -hard1 slot refers to HD unit 0, so click on that icon to select it (it will display inverted, so you know which unit is selected), as shown below, and then click the emboldened button.
[[File:tos_hdinstall_drvsel.png]]

* Now you can select which parts of TownsOS you wish to install. You may select multiple items, so long as there is enough space available on the HD image (100MB is plenty). The only required feature is "TownsOS (コンソール)".
[[File:tos_hdinstall_pkgsel.png]]

Clicking the emboldened button will then bring up a summary of the features to be installed, including the HD unit to install to (should be 0), the drive letter to use for the system drive (it will assign D: for you if there is no other HD drives on the systems), the disk size, and the size of the install. Click the emboldenend button to continue.

* Now the system will partition and format the drive for you, and then it will reboot.

=== Boot TownsOS from HD, and complete installation ===
* Once back in the GUI, you'll now see a new icon for drive D on the initial window. But first, we need to copy the OS files to the new drive. Open the ツール window, and double-click the HDインストール icon once again. The installation process should now begin.
[[File:tos_hdinstall_copying.png]]

* Once copying is finished, you'll be presented with a customisation dialog. Do note that there are two pages to this dialog, you can switch between them by clicking the left-most button at the bottom of the dialog. Settings can be left as they are, but it is useful to enable the IC memory card driver (click the left option in the ICメモリカード frame on page 1), this will add the loading of the memory card driver to CONFIG.SYS, so that you don't have to.
[[File:tos_hdinstall_customise_1.png]][[File:tos_hdinstall_customise_2.png]]

* Clicking the emboldened button will confirm the settings you've chosen, and will display this dialog:
[[File:tos_hdinstall_reset.png]]

This is simply stating that you need to reset the system. Click the button, and the installation is complete. To reset the system, select the last item in the FMTowns menu (button in the top-left of the screen), or alternatively, click the button in the top-right corner of the screen, and click the left button (リセット = reset). The system will now reboot, from the HD (you may unmount the CD image now, if you want).

== Disk partitioning and formatting under TownsOS ==

After installing TownsOS, you'll likely want to use the rest of the hard disk for storage. You can do this before installing TownOS, if you wish, but do note that MS-DOS partitions are limited to 127MB in size, splitting up the OS and other areas on the disk is a good idea. Partitioning is done in the second and third items in the last menu, as shown in in this screenshot:

[[File:tos_hdinstall_menu.png]]

Firstly, you'll need to select the second menu item, and assign an extra drive letter to HD unit 0. Click the HD unit 0 icon (there will already be a grey D symbol there signifying that drive D is assigned to this HD. You'll see a dialog with two options, leave the top option selected, and click the emboldened button. This will add the a new drive letter (should be E) to the HD. Choosing the bottom option in the previous dialog will remove a drive letter assignment. Drive assignments should now look like this:
[[File:tos_drive_assign.png]]

Drive assignments are stored in CMOS, so you'll need to restart TownsOS for the changes to take effect. As before, you can select the last item on the FMTowns menu, or click the button in the top-right corner of the screen, and then click the left button in the exit dialog to reset.

Once back in the GUI, you can select the third item in the last menu, which will set up disk partitions.
You'll see one partition already setup for TownsOS itself. Click the label for the second partition, and name it anything you wish. The next option is partition type, select MS-DOS here. The next option is the bootable flag, this will already be active for the TownsOS partition, and you don't want to change this, so leave it alone. The next option is the size of the partition, clicking this will bring up a dialog to adjust it. Clicking the ALL button will automatically use all remaining space on the disk, up to 127MB (the maximum size of MS-DOS partitions). When done, you should see a partition table similar to this:

[[File:tos_disk_partition.png]]

Clicking the emboldened will bring up a confirmation dialog, clicking the emboldened button there will write the partition table to the HD. Clcik the non-emboldened button to close the partitioning program.

Formatting a drive can be found under the first item in the ディスク (disk) menu. Selecting it will bring up this dialog:

[[File:tos_diskformat.png]]

Use the arrow buttons in the top-left to select which drive to format - note that you cannot select the drive that TownsOS is installed on.
The options on the right are:
* Copy system files to disk (default is to not copy system files)
* Disk format (enabled for floppy drives only)
* Disk volume label

Clicking the emboldened button will start the formatting process. Once done, you can store anything you wish on the HD.

Important note: By default, folders will appear in an icon view, showing shortcuts to applications and so on. To get a plain file list view, click the icon in the top right-hand corner of the window, and select the second menu item,

Driver:Amstrad

2018-10-24T05:14:56Z

Mahlemiut: /* Dobbertin HD20 */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== Digiblaster ===

DIY device that produces digital sound sent via the printer port.

Commandline usage example:
'''mame cpc6128 -centronics digiblst'''

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

For more information on setting up and formatting the HD20, read [[Driver:Amstrad:HD20_install|here]].

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Programmers Development System ===

Device that connects the CPC to a PC running development software, allowing code to be downloaded to the CPC and be remotely debugged.

Requires:
* Software to communicate with and send data to or receive data from a PC running the PDS development software.

Commandline usage example:
'''mame cpc6128 -exp pds'''

Known issues:
* Communication between MAME instances using this hardware is not implemented as yet. Probably needs more than just a socket to communicate.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== ROM Box ===

Generic device containing sockets to place software sold on ROM (such as Protext and Maxam 1½).

Note that by default, the 464 will only load ROMs in the first 7 slots, the 664/6128/Plus only loads the first 15 ROMs.

Commandline usage example:
'''mame cpc6128 -exp rom -rom1 ''<path to ROM image (BIN, ZIP, 7Z)>'' -rom2 ...'''

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image (CHD)>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

File:Brunword edit.png

2017-01-26T08:32:32Z

Mahlemiut: Mahlemiut uploaded a new version of "File:Brunword edit.png"

File:Brunword menu.png

2017-01-26T08:32:09Z

Mahlemiut: Mahlemiut uploaded a new version of "File:Brunword menu.png"

Driver:Amstrad:HD20 install

2017-01-19T01:31:17Z

Mahlemiut: /* Setting up the Dobbertin HD20 */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== ''Create a blank 3" floppy disk, to be used as a CP/M work disk'' ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== ''Make the disk bootable'' ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== ''Copy some CP/M and HD utilities to the work disk'' ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== ''Copy utilities and driver from the HD interface disk to the work disk'' ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== ''Update the work disk to use CPM63.SYS'' ====

Restart MAME ''without'' the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

=== Partitioning and formatting the hard disk ===

Boot from our CP/M 2.2 work disk (HDFORMAT.COM does not appear to work under CP/M Plus),
with the HD20 enabled, and hard disk image mounted.

At the A> prompt, type '''hdformat''', and press Enter. You will be given the option of doing a low-level format, a high-level format, or quit.

First press L to do a low-level format. This creates the partition table, providing four
5MB partitions (both X-DDOS and CP/M refer to them as drives D, E, F and G).

Press Y to confirm, and then Space to create the partition table.

Next, press H to do a high-level format, press D to format drive D, then Y to confirm, and
then Space to start formatting. Repeat this for each of the drives, then press Q to quit.

{|
|[[File:hd20_hdformat.png|384px|center]]
|[[File:hd20_hdformat_2.png|384px|center]]
|}
Now you can test it by copying some files to drive D. Resetting the system to go back to
BASIC, you should be able to list files you copied by entering |dir,"d:", and it should report
about 5MB of free space.

[[File:hd20_dir.png|center]]

Driver:Amstrad:HD20 install

2017-01-18T23:23:46Z

Mahlemiut: /* Partitioning and formatting the hard disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME ''without'' the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

=== Partitioning and formatting the hard disk ===

Boot from our CP/M 2.2 work disk (HDFORMAT.COM does not appear to work under CP/M Plus),
with the HD20 enabled, and hard disk image mounted.

At the A> prompt, type '''hdformat''', and press Enter. You will be given the option of doing a low-level format, a high-level format, or quit.

First press L to do a low-level format. This creates the partition table, providing four
5MB partitions (both X-DDOS and CP/M refer to them as drives D, E, F and G).

Press Y to confirm, and then Space to create the partition table.

Next, press H to do a high-level format, press D to format drive D, then Y to confirm, and
then Space to start formatting. Repeat this for each of the drives, then press Q to quit.

{|
|[[File:hd20_hdformat.png|384px|center]]
|[[File:hd20_hdformat_2.png|384px|center]]
|}
Now you can test it by copying some files to drive D. Resetting the system to go back to
BASIC, you should be able to list files you copied by entering |dir,"d:", and it should report
about 5MB of free space.

[[File:hd20_dir.png|center]]

Driver:Amstrad:HD20 install

2017-01-18T22:56:46Z

Mahlemiut: /* Partitioning and formatting the hard disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME ''without'' the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

=== Partitioning and formatting the hard disk ===

Boot from our CP/M 2.2 work disk (HDFORMAT.COM does not appear to work under CP/M Plus),
with the HD20 enabled, and hard disk image mounted.

At the A> prompt, type '''hdformat''', and press Enter. You will be given the option of doing a low-level format, a high-level format, or quit.

First press L to do a low-level format. This creates the partition table, providing four
5MB partitions (both X-DDOS and CP/M refer to them as drives D, E, F and G).

Press Y to confirm, and then Space to create the partition table.

Next, press H to do a high-level format, press D to format drive D, then Y to confirm, and
then Space to start formatting. Repeat this for each of the drives, then press Q to quit.

[[File:hd20_hdformat.png|384px]] [[File:hd20_hdformat_2.png|384px]]

Now you can test it by copying some files to drive D. Resetting the system to go back to
BASIC, you should be able to list files you copied by entering |dir,"d:", and it should report
about 5MB of free space.

[[File:hd20_dir.png|center]]

File:Hd20 hdformat 2.png

2017-01-18T22:53:25Z

Mahlemiut:

File:Hd20 hdformat.png

2017-01-18T22:53:06Z

Mahlemiut:

File:Hd20 dir.png

2017-01-18T22:52:39Z

Mahlemiut:

Driver:Amstrad:HD20 install

2017-01-18T22:51:19Z

Mahlemiut: /* Setting up the Dobbertin HD20 */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME ''without'' the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

=== Partitioning and formatting the hard disk ===

Boot from our CP/M 2.2 work disk (HDFORMAT.COM does not appear to work under CP/M Plus),
with the HD20 enabled, and hard disk image mounted.

At the A> prompt, type '''hdformat''', and press Enter. You will be given the option of doing a low-level format, a high-level format, or quit.

First press L to do a low-level format. This creates the partition table, providing four
5MB partitions (both X-DDOS and CP/M refer to them as drives D, E, F and G).

Press Y to confirm, and then Space to create the partition table.

Next, press H to do a high-level format, press D to format drive D, then Y to confirm, and
then Space to start formatting. Repeat this for each of the drives, then press Q to quit.

Now you can test it by copying some files to drive D. Resetting the system to go back to
BASIC, you should be able to list files you copied by entering |dir,"d:", and it should report
about 5MB of free space.

Driver:Amstrad:HD20 install

2017-01-18T22:45:06Z

Mahlemiut: /* Update the work disk to use CPM63.SYS */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME ''without'' the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad

2017-01-18T22:44:04Z

Mahlemiut: /* Dobbertin HD20 */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== Digiblaster ===

DIY device that produces digital sound sent via the printer port.

Commandline usage example:
'''mame cpc6128 -centronics digiblst'''

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Setting up and formatting the HD20]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Programmers Development System ===

Device that connects the CPC to a PC running development software, allowing code to be downloaded to the CPC and be remotely debugged.

Requires:
* Software to communicate with and send data to or receive data from a PC running the PDS development software.

Commandline usage example:
'''mame cpc6128 -exp pds'''

Known issues:
* Communication between MAME instances using this hardware is not implemented as yet. Probably needs more than just a socket to communicate.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== ROM Box ===

Generic device containing sockets to place software sold on ROM (such as Protext and Maxam 1½).

Note that by default, the 464 will only load ROMs in the first 7 slots, the 664/6128/Plus only loads the first 15 ROMs.

Commandline usage example:
'''mame cpc6128 -exp rom -rom1 ''<path to ROM image (BIN, ZIP, 7Z)>'' -rom2 ...'''

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image (CHD)>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad:HD20 install

2017-01-18T08:34:49Z

Mahlemiut: /* Make CP/M support a 63k TPA */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:32:16Z

Mahlemiut: /* Make CP/M support a 63k TPA */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

Enter the following commands at the A> prompt: 
'''movcpm 255 *''' 
'''save 34 cpm63.com'''

Now enter '''ddt cpm63.com''' and then at the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing, then at the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

Type '''sysgen *''' and press Enter.

When asked for the destination disk, press Enter. 
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk. (Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:27:56Z

Mahlemiut: /* Copy utilities and driver from the HD interface disk to the work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands: 
'''pip a:=badtrack.com''' 
'''pip a:=hdformat.com''' 
'''pip a:=writesys.com''' 
'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:27:34Z

Mahlemiut: /* Copy some CP/M and HD utilities to the work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one: 
'''pip b:=pip.com''' 
'''pip b:=ddt.com''' 
'''pip b:=movcpm.com''' 
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands:

'''pip a:=badtrack.com'''

'''pip a:=hdformat.com'''

'''pip a:=writesys.com'''

'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:27:06Z

Mahlemiut: /* Update the work disk to use CPM63.SYS */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one:

'''pip b:=pip.com'''

'''pip b:=ddt.com'''

'''pip b:=movcpm.com'''

'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands:

'''pip a:=badtrack.com'''

'''pip a:=hdformat.com'''

'''pip a:=writesys.com'''

'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for: 
Source disk - press Enter 
Drive to write to - press A 
Destination disk - press Enter 
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:25:08Z

Mahlemiut: /* Update the work disk to use CPM63.SYS */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one:

'''pip b:=pip.com'''

'''pip b:=ddt.com'''

'''pip b:=movcpm.com'''

'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands:

'''pip a:=badtrack.com'''

'''pip a:=hdformat.com'''

'''pip a:=writesys.com'''

'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk, and boot it using '''|cpm,1''' at the Ready prompt.

Now mount the work disk, and enter '''writesys cpm63.sys''' at the A> prompt.

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:23:37Z

Mahlemiut: /* Copy utilities and driver from the HD interface disk to the work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one:

'''pip b:=pip.com'''

'''pip b:=ddt.com'''

'''pip b:=movcpm.com'''

'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive. Then enter each of the following commands:

'''pip a:=badtrack.com'''

'''pip a:=hdformat.com'''

'''pip a:=writesys.com'''

'''pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:22:47Z

Mahlemiut: /* Copy some CP/M and HD utilities to the work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one:

'''pip b:=pip.com'''

'''pip b:=ddt.com'''

'''pip b:=movcpm.com'''

'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:22:21Z

Mahlemiut: /* Copy some CP/M and HD utilities to the work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Now you need to copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk. Enter the following commands at the A> prompt, pressing Enter after each one:

'''pip b:=pip.com'''
'''pip b:=ddt.com'''
'''pip b:=movcpm.com'''
'''pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T08:18:36Z

Mahlemiut: /* Make the disk bootable */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager. Then, at the Ready prompt, type '''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk.

'''A> pip b:=pip.com'''
'''A> pip b:=ddt.com'''
'''A> pip b:=movcpm.com'''
'''A> pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T07:21:51Z

Mahlemiut: /* Setting up the Dobbertin HD20 */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter '''|format,1''' and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png|center]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager.

'''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk.

'''A> pip b:=pip.com'''
'''A> pip b:=ddt.com'''
'''A> pip b:=movcpm.com'''
'''A> pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png|center]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-18T00:17:09Z

Mahlemiut: /* Create a blank 3" floppy disk, to be used as a CP/M work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter |format,1 and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

[[File:hd20_fdformat.png]]

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager.

'''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk.

'''A> pip b:=pip.com'''
'''A> pip b:=ddt.com'''
'''A> pip b:=movcpm.com'''
'''A> pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad:HD20 install

2017-01-17T23:40:08Z

Mahlemiut: /* Copy some CP/M and HD utilities to the work disk */

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter |format,1 and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager.

'''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk.

'''A> pip b:=pip.com'''
'''A> pip b:=ddt.com'''
'''A> pip b:=movcpm.com'''
'''A> pip b:=sysgen.com'''

==== Copy utilities and driver from the HD interface disk to the work disk ====

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

==== Update the work disk to use CPM63.SYS ====

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

==== Make CP/M support a 63k TPA ====

'''A> movcpm 255 *'''
'''A> save 34 cpm63.com'''
'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

[[File:hd20_ddt.png]]

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

File:Hd20 ddt.png

2017-01-17T23:37:06Z

Mahlemiut:

File:Hd20 fdformat.png

2017-01-17T23:36:42Z

Mahlemiut:

Driver:Amstrad:HD20 install

2017-01-17T23:35:48Z

Mahlemiut: Created page with "== Setting up the Dobbertin HD20 == === Creating a blank hard disk image === Create a blank HD image file using chdman: '''chdman createhd -o ''<output CHD file>'' -chs 615..."

== Setting up the Dobbertin HD20 ==

=== Creating a blank hard disk image ===
Create a blank HD image file using chdman:

'''chdman createhd -o ''<output CHD file>'' -chs 615,4,17 -c none'''
chdman - MAME Compressed Hunks of Data (CHD) manager 0.179 (mame0179-616-g0d17e0f-dirty)
Output CHD: ''<output CHD file>''
Compression: none
Cylinders: 615
Heads: 4
Sectors: 17
Bytes/sector: 512
Sectors/hunk: 8
Logical size: 21,411,840

=== Running MAME ===

With the HD20 active:
'''mame cpc6128 -exp hd20 -hard1 ''<path to CHD>'' -upd765:1 3ssdd'''

Without the HD20 active:
'''mame cpc6128 -upd765:1 3ssdd'''

(-upd765:1 3ssdd is used to set drive B to a 3" single-sided drive, this is to lessen disk swapping,
which is annoying to do at times in MAME's UI)

=== Setting up CP/M 2.2 ===

Requires:
* CP/M 2.2 Master disk (software list: cpmplusu01:flop4)
* Dobbertin HD Interface driver disk (not in software list)

Note that this assumes you are using 128k RAM or more, so the cpc6128 driver is used.

==== Create a blank 3" floppy disk, to be used as a CP/M work disk ====

Boot the CPC driver, with the HD20 expansion enabled, and the just created HD image mounted.

Use MAME's File Manager to create a floppy disk image (MFM or MFI format), and then re-mount
the image to make sure it is open in read-write mode.

At the Ready prompt, enter |format,1 and press Enter. Then press Y to confirm you want to
format a disk, then S for System disk, and wait for the format to be complete.

==== Make the disk bootable ====

First, mount the CPM 2.2 master disk via MAME's File Manager.

'''|syscopy,1,1''' and press Enter.

When asked for the source disk, press any key. When asked for the destination disk, PAUSE, and
use MAME's File Manager to mount the work disk (this is to work around UI inputs bleeding into
emulation). Unpause (and R to retry in case you get any error), and now the disk should be
bootable.

==== Copy some CP/M and HD utilities to the work disk ====

Mount the CP/M 2.2 master disk, and also mount our work disk in the second disk drive, and boot
it by entering '''|cpm''' and pressing Enter.

Copy PIP.COM, MOVCPM.CPM, DDT.COM, and SYSGEN.COM from the CP/M 2.2 disk to the work disk.

'''A> pip b:=pip.com'''
'''A> pip b:=ddt.com'''
'''A> pip b:=movcpm.com'''
'''A> pip b:=sysgen.com'''

Copy utilities and driver from the HD interface disk to the work disk.

Mount the work disk in the first disk drive, and the HD interface disk in the second drive.

'''A> pip a:=badtrack.com'''
'''A> pip a:=hdformat.com'''
'''A> pip a:=writesys.com'''
'''A> pip a:=cpm63.sys'''

Update the work disk to use CPM63.SYS

Restart MAME without the HD20 enabled, and mount the CP/M 2.2 master disk. Boot it using |cpm,1.

Now mount the work disk.

'''A> writesys cpm63.sys'''

When asked for:
Source disk - press Enter
Drive to write to - press A
Destination disk - press Enter
System disk - press Enter.

No disk swapping needed. :)

Make CP/M support a 63k TPA.

'''A> movcpm 255 *'''

'''A> save 34 cpm63.com'''

'''A> ddt cpm63.com'''

At the '-' prompt, type '''s1e0c''' and press Enter.

Now you must enter the string of bytes to edit.

Type in the following byte values, pressing Enter after each one.

3a 04 00 e6 0f 32 42 ee 2e 80 cd 0b f8

Now type a '.' and press Enter to stop editing.
At the '-' prompt, type g0 and press Enter.

'''A> sysgen *'''

When asked for the destination disk, press Enter.
When asked for the system disk, pause, and then mount the CP/M 2.2 master disk.
(Or you can just press Enter and let it crash).

Now you can reset the system, and boot from the work disk with '''|cpm,1'''.

Driver:Amstrad

2017-01-09T03:21:10Z

Mahlemiut: /* DK'Tronics Speech Synthesiser */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== Digiblaster ===

DIY device that produces digital sound sent via the printer port.

Commandline usage example:
'''mame cpc6128 -centronics digiblst'''

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Programmers Development System ===

Device that connects the CPC to a PC running development software, allowing code to be downloaded to the CPC and be remotely debugged.

Requires:
* Software to communicate with and send data to or receive data from a PC running the PDS development software.

Commandline usage example:
'''mame cpc6128 -exp pds'''

Known issues:
* Communication between MAME instances using this hardware is not implemented as yet. Probably needs more than just a socket to communicate.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== ROM Box ===

Generic device containing sockets to place software sold on ROM (such as Protext and Maxam 1½).

Note that by default, the 464 will only load ROMs in the first 7 slots, the 664/6128/Plus only loads the first 15 ROMs.

Commandline usage example:
'''mame cpc6128 -exp rom -rom1 ''<path to ROM image (BIN, ZIP, 7Z)>'' -rom2 ...'''

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image (CHD)>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:57:54Z

Mahlemiut: /* Romantic Robot Multiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Programmers Development System ===

Device that connects the CPC to a PC running development software, allowing code to be downloaded to the CPC and be remotely debugged.

Requires:
* Software to communicate with and send data to or receive data from a PC running the PDS development software.

Commandline usage example:
'''mame cpc6128 -exp pds'''

Known issues:
* Communication between MAME instances using this hardware is not implemented as yet. Probably needs more than just a socket to communicate.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== ROM Box ===

Generic device containing sockets to place software sold on ROM (such as Protext and Maxam 1½).

Note that by default, the 464 will only load ROMs in the first 7 slots, the 664/6128/Plus only loads the first 15 ROMs.

Commandline usage example:
'''mame cpc6128 -exp rom -rom1 ''<path to ROM image (BIN, ZIP, 7Z)>'' -rom2 ...'''

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image (CHD)>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:48:32Z

Mahlemiut: /* PlayCity */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Programmers Development System ===

Device that connects the CPC to a PC running development software, allowing code to be downloaded to the CPC and be remotely debugged.

Requires:
* Software to communicate with and send data to or receive data from a PC running the PDS development software.

Commandline usage example:
'''mame cpc6128 -exp pds'''

Known issues:
* Communication between MAME instances using this hardware is not implemented as yet. Probably needs more than just a socket to communicate.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image (CHD)>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:33:35Z

Mahlemiut: /* Symbiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image (CHD)>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:33:15Z

Mahlemiut: /* Dobbertin HD20 */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Other OS support:
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image CHD>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:29:17Z

Mahlemiut: /* Symbiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

OS support:
* FutureOS
* SymbOS

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image CHD>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:23:30Z

Mahlemiut: /* Romantic Robot Multiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

=== Symbiface II ===

Multifunction device adding RTC, PS/2 mouse, an IDE HD interface, 512kB RAM and 512kB of rewritable ROM.

Commandline usage example:
'''mame cpc6128 -exp sf2 -hard ''<path to hard disk image CHD>'' -ramsize 576k'''

Known issues:
* PS/2 mouse support is not perfect. It does not like quick, swift movements.
* Rewriteable ROMs are not supported as yet.
* Extra RAM is not implemented, but you can add '''-ramsize 576k''' to the commandline to use the equivalent feature.

Driver:Amstrad

2017-01-07T10:13:48Z

Mahlemiut: /* Dobbertin HD20 */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-07T02:34:37Z

Mahlemiut: /* Dobbertin HD20 */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors). Includes XD-DOS on ROM.

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-07T02:32:39Z

Mahlemiut: /* Dobbertin HD20 */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors).

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

[[Driver:Amstrad:HD20_install|Installing HD20 drivers in CP/M Plus]] (coming soon)

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-07T02:29:12Z

Mahlemiut: /* Dobbertin Smartwatch */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin HD20 ===

The HD20 is a 20MB fixed hard disk drive. It uses a Seagate ST11M controller (PC/XT interface), and has varying brands of HDs, but is always 20MB (615 clyinders, 4 heads, 17 sectors).

Requires:
* HD interface software on floppy disk, which includes drivers for CP/M 2.2 and CP/M Plus. Only required to low-level format (partition) the HD initially. Includes documentation (in German).

Commandline usage example:
'''mame cpc6128 -exp hd20 -hard ''<path to hard disk image (CHD)>'''''

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-06T03:25:25Z

Mahlemiut: /* Romantic Robot Multiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center|384px]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-06T03:14:36Z

Mahlemiut: /* Romantic Robot Multiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

[[File:mf2_menu.png|center]]

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

File:Mf2 menu.png

2017-01-06T03:13:56Z

Mahlemiut:

Driver:Amstrad

2017-01-06T02:11:52Z

Mahlemiut: /* Romantic Robot Multiface II */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

Known issues:
* Can only be stopped once. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-05T23:02:17Z

Mahlemiut: /* PlayCity */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

=== Romantic Robot Multiface II ===

Hacking tool designed for transferring software to tape or disk.

Commandline usage example:
'''mame cpc6128 -exp multiface2'''

If the Multiface II menu is not appearing for you when pressing the stop button (F6, by default), then check MAME's Machine Configuration menu, and make sure that the Multiface II is switched on.

Known issues:
* Does not return to the running software after pressing the stop button. Requires the ability to do something when the CPU PC hits a certain point, the MAME core does not allow for this at this stage.

Driver:Amstrad

2017-01-05T22:39:23Z

Mahlemiut: /* PlayCity */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup to acknowledge IRQs properly, which cannot be used with a slot device. NMIs work fine, however.

Driver:Amstrad

2017-01-05T22:36:28Z

Mahlemiut: /* PlayCity */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs, for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup, which cannot be used with a slot device. NMIs work fine, however.

Driver:Amstrad

2017-01-05T22:35:54Z

Mahlemiut: /* HM Transtape */

== Amstrad CPC / Plus expansion devices ==

This page will list various CPC expansion devices that MAME emulates, and how to use them, plus the status of the device's emulation.

=== Amdrum ===

Requires:
* Amdrum software on cassette (software list name: amdrum, amdrumak (Afro Kit), amdrumek (Electro Kit), amdrumlk (Latin Kit))

Usage example:
'''mame cpc6128 -exp amdrum -cass amdrum:cass1'''

To run the software:
With the Amdrum cassette image mounted, type '''|tape''', then Enter (664/6128/Plus only, the 464 starts in tape mode if there is no disk drive), and then hold Ctrl and press the small enter key (or just type '''run"''' and press Enter). Press any key to start loading, and don't forget to start the tape (switch to partial keyboard mode (ScrollLock), and press F2, then switch back to full keyboard mode). Wait while the software loads (press fast-forward to speed this up - in partial keyboard mode, hold Insert (Win32) or PageDown (SDL)).

Once loaded, you will be looking at the load/save screen.
[[File:amdrum_load.png|center]]
First, you need to load the instrument data, so mount the second side of the Amdrum cassette (use MAME's File Manager to mount it from either the software list, or directly point to the tape image). Press 5, and then 9 (siginfies loading a whole kit), type '''AMKIT''', press Enter, and start the tape again. After some time, the instruments will be loaded. Stop the tape (Shift-F2 in partial keyboard mode) once loading is complete, as the tape motor starts when playing back samples. Press R to go to the main menu, and now you can create drum sounds all you want.

If you want to load the demonstration songs, then after loading the instrument kit, from the Load/Save screen, press 3, then 99, and press Enter. Start the tape, and wait some more (doesn't take long). After loading is finished, you'll see 9 songs listed on the left side of the screen.
[[File:amdrum_songs.png|center]]
Stop the tape, and press R to return to the main menu.
[[File:amdrum_edit.png|center]]
At the main menu, you can choose a song by pressing C and then typing the number of the song to select followed by Enter. Then press D to play the song. Press Space to stop the song when done.

=== Amstrad / Pace RS-232C Serial Port ===

Provides RS-232C serial communications between the CPC and other serial devices or computers. The Amstrad model of this device is hardware compatible with the Pace device, only difference is the software included on ROM.

Other OS support:
* CP/M 2.2
* CP/M Plus

Commandline usage examples:
'''mame cpc6128 -exp rs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Pace)''
'''mame cpc6128 -exp amsrs232 -exp:rs232:rs232 null_modem -bitb localhost:5000''' ''(Amstrad)''

If the device is enabled, then on boot, you'll see either '''COMMSTAR (c)1986 Honeysoft Ltd.''' (Pace) or '''Amstrad RS232C Serial Interface (v1)'''.

Various devices can be attached to a serial port, including a serial terminal, serial printer, and others. The most useful one, however, is the Null Modem (as used in the example commandline above), which allows a connection between two instances of MAME via a socket.

Known Issues:
* Communication via a socket does not work if hardware flow control is enabled. This is a limitation of simply sending the data through a socket, but it allows for other applications, not just MAME, to communicate with the emulated system.

=== Amstrad SSA-1 Speech Synthesiser ===

A speech synthesiser based around the SP0256, with software available on cassette. Similar, but not compatible with, the DK'Tronics Speech Synthesiser.

Commandline usage example:
'''mame cpc6128 -exp ssa1 -cass ssa1synt:cass1'''

Known issues:
* Some software will not correctly detect the SSA-1, as in current SP0256 emulation, the LRQ and SBY lines change at the same time. Detection works by checking that one line is active only, and then both. A couple of games, such as Tubaruba, do not bother detecting the SSA-1, meaning that they will provide speech in MAME. This does not affect the DK'Tronics synthesiser as it doesn't use the SBY line.

=== Brunword Elite MK4 ===

Command-line usage example:
'''mame cpc6128 -exp brunword4'''

Brunword Elite MK4 is a word processor, with the software contained on ROM, within the expansion device.

To run, at the Ready prompt, type '''|brunword''' and press Enter. You will now be looking at Brunword's main menu, listing various commands to use.
[[File:brunword_menu.png|center]]
There are various "mem-files" already loaded, so you can look at some examples, including a tutorial to help you get started using the application. Press G on the main menu to load a mem-file - TUTOR1 is a good place to start.
[[File:brunword_edit.png|center]]

=== DK'Tronics Speech Synthesiser ===

A speech synthesiser based around the SP0256-AL2, similar, but not compatible with, the Amstrad SSA-1.

Commandline usage example:
'''mame cpc6128 -exp dkspeech'''

Software is included on ROM, so is ready to use with the device connected. If working, you'll see '''SPEECH ROM 1.1''' displayed on boot.

How to get it to say something in BASIC:
* (464) Type '''a$="something":|say,@a$''' and press Enter
* (664/6128) Type '''|say,"something"''' and press Enter

Other commands:
* '''PRINT "`something`"''' - same as |SAY
* '''|SPEAK''' - displays RSX commands, and says "DK'Tronics Speech Synthesiser"
* '''|SPON''' and '''|SPOF''' - turn read buffer interrupts on or off
* '''|SPED,n''' - set text speed, n is between 0 and 15
* '''|FLUS''' - clear speech and text buffers
* '''|FEED,n,n,n...''' - feed data (up to 30 values between 5 and 63) directly to the speech buffer
* '''|OUTM,n'''
** n=1 - Redirect PRINT command output to the text-to-speech converter
** n=2 - Redirect PRINT output and all text to the text-to-speech converter
** n=3 - As above, but still display text on screen.
* '''|LEFT,v''' - report available memory in buffer (v is a variable).

=== Dobbertin Smartwatch ===

The Smartwatch adds an RTC and software commands on ROM.

Other OS support:
* CP/M Plus (via patches)
* FutureOS

Commandline usage example:
'''mame cpc6128 -exp smartwatch'''

'''|help''' will the ROMs on the system, and you can list the available commands using '''|help,n''' where ''n'' is the ROM slot for TIME ROM+.

Known issues:
* Day is wrong.
* Changing the date and time doesn't work. (Not implemented in DS1315 RTC core)

=== HM Transtape ===

The Transtape is a hacking device, similar to the Multiface II, allowing you to save or load software at any point, or to enter pokes (ie: cheat ;)).
By default, the red button is mapped to F1, and the black button is mapped to F2. The red button is used to interrupt software and then save or load the state.
Using the device is currently a bit unclear, the only manual available is in Spanish.

Commandline usage example:
'''mame cpc6128 -exp transtape'''

Known issues:
* Doesn't return to the running software once either button has been pressed, ending up in the software locking up, requiring a reset (F3). Menus do appear after pressing the red button, however.

=== PlayCity ===

Adds 2 YMZ294 PSGs. for 6 extra channels of sound. Also provides a controllable source of IRQs and NMIs.

Commandline usage example:
'''mame cpc6128 -exp playcity'''

Known issues:
* IRQs do not work correctly. The current Z80CTC core requires a daisy chain setup, which cannot be used with a slot device. NMIs work fine, however.

Driver:Amstrad

2017-01-05T00:48:51Z

Mahlemiut: /* Amstrad / Pace RS-232C Serial Port */

Driver:Amstrad

2017-01-05T00:47:05Z

Mahlemiut: /* Dobbertin Smartwatch */