<?xml version="1.0"?>
<!-- $Id: exampleconfigs.xml,v 1.13 2005/11/19 10:14:10 manuelbi Exp $ -->
<!DOCTYPE msxconfig SYSTEM "msxconfig.dtd">
<msxconfig>

<!-- This file contains some example XML fragments for use in
hardwareconfig.xml files. Because this file cannot be used directly with
openMSX, it is not testable and therefore quite a pain to maintain. Therefore,
most parts just refer to existing real configurations which you can find in the
share/machines and share/extensions directories. The few remaining fragments
have some extra comments or cannot be found in existing configurations. -->

<!-- The info tag is mandatory; for fantasy configs, just fill in something you can think up, or make an empty tag. -->
  <info>
    <menufacturer>openMSX team</menufacturer>
    <code>EC-050</code>
    <release_year>2004</release_year>
    <description>Example configuration</description>
    <type>MSX2</type>
  </info>

<!-- MapperType: see any machine config with a mapper, e.g. Philips MSX2 -->

<!-- RenShaTurbo: see any machine with RenSHa Turbo, e.g. Panasonic FS-A1WX -->

  <devices>

<!--define slot structure (expanded slots and external slots) -->
    <primary slot="0">
      <some_device>...</some_device>
    </primary>
    <primary slot="1" external="true"/>
    <primary slot="2">
      <secondary slot="0" external="true"/>
      <secondary slot="1" external="true"/>
      <secondary slot="2" external="true"/>
      <secondary slot="3" external="true"/>
    </primary>
    <primary slot="3">
      <secondary slot="2">
        <some_device>...</some_device>
      </secondary>
    </primary>
  
<!-- 8kb RAM at address 0xE000-0xFFFF in slot 3-2 -->
  <primary slot="3">
    <secondary slot="2">
      <RAM id="myram1">
        <mem base="0x0000" size="0x10000"/>
        <slow_drain_on_reset>true</slow_drain_on_reset>
        <size>8</size>
        <base>56</base>
      </RAM>
    </secondary>
  </primary>

<!-- BIOS + BASIC ROM in unexpanded slot 0. See any MSX1 config -->

<!-- FDC controller in slot 3-3 with one physical disk drive: see e.g. the
Philips NMS 8250 config -->

<!-- PPI: see any machine config -->

<!-- VDP: see any machine config -->

<!-- E6Timer: see any turboR config -->

<!-- PSG: see any machine config -->

<!-- Kanji ROM: see many Japanese MSX2 configs -->

<!-- Real time clock: see any MSX2 config -->
                      
<!-- 2MB memory mapper that can be inserted in any slot (expanded or not),
     see the ram2mb extension-->

<!-- SCCPlus cartridge, starts with a preloaded NEMESIS2 -->
  <primary slot="any">
    <secondary slot="any">
      <SCCplus id="SCC+ Cartridge">
        <mem base="0x4000" size="0x8000"/>
        <filename>NEMESIS2.ROM</filename>
        <sound>
          <volume>13000</volume>
          <mode>mono</mode>
        </sound>
        <!-- possible subtypes "Snatcher" "SD-Snatcher" "mirrored" "expanded" -->
        <subtype>expanded</subtype>
      </SCCplus>
    </secondary>
  </primary>

<!-- a rom with explicitly specified mappertype can also be specified in XML.
     Note that Synthesizer also works from the command line, thanks to romdb.xml -->
  <primary slot="any">
    <secondary slot="any">
      <ROM id="KonamiSynthesizer">
        <mem base="0x4000" size="0x8000"/>
        <rom>
          <filename>Synthesizer.rom</filename>
          <mappertype>SYNTHESIZER</mappertype>
        </rom>
        <sound>
          <volume>13000</volume>
          <mode>mono</mode>
        </sound>
      </ROM>
    </secondary>
  </primary>

<!-- For an FM-PAC config, check out the fmpac extension -->
 
<!-- For an MSX Audio config, check out the share/extensions/audio dir -->
                                          
<!-- MSX-MIDI device, can be found in the Turbo-R. -->

<!-- For a cassetteport config, check out any MSX1 machine -->

<!-- For a printerport config, check out any machine -->

<!-- For an SCC config, check out the scc extension -->
  
<!-- See the configuration of the National FS-4600 machine for Kanji12:
     "Switched IO devices (IO region 0x40-0x4F)" don't need an <io> tag -->

<!-- A debug device to be controlled from the MSX: see debugdevice extension -->

  </devices>

</msxconfig>
