Stephen Shaw: add link to Atarisoft

2014-10-06T13:52:04Z

add link to Atarisoft

← Older revision		Revision as of 13:52, 6 October 2014
Line 65:		Line 65:
	\| style="border:1px solid black; padding:0.5em" \| Cartridges with 2 ROMs and 0 or 1 GROM dump. Extended Basic is known to use this format.		\| style="border:1px solid black; padding:0.5em" \| Cartridges with 2 ROMs and 0 or 1 GROM dump. Extended Basic is known to use this format.
	\| style="border:1px solid black; padding:0.5em" \| rom_socket, rom2_socket, grom_socket		\| style="border:1px solid black; padding:0.5em" \| rom_socket, rom2_socket, grom_socket
	\| style="border:1px solid black; padding:0.5em" \| Extended Basic and many Atarisoft games		\| style="border:1px solid black; padding:0.5em" \| Extended Basic and many [[Atarisoft]] games
	\|-		\|-
	\| style="border:1px solid black; padding:0.5em" \| minimem		\| style="border:1px solid black; padding:0.5em" \| minimem

Mizapf: /* New cartridge structure */

2013-02-02T22:37:04Z

New cartridge structure

← Older revision		Revision as of 22:37, 2 February 2013
Line 9:		Line 9:
	'''Note''': As with all other features, please check the section [[MESS_non-problems\|No problems]] first if you suspect an issue. Sometimes there is no problem at all, or you can easily avoid it.		'''Note''': As with all other features, please check the section [[MESS_non-problems\|No problems]] first if you suspect an issue. Sometimes there is no problem at all, or you can easily avoid it.

	== ~~New~~ cartridge ~~structure~~ ==		== RomPacK cartridge packs (RPK) ==

	Before MESS 0.131, cartridges consisted of separate ROM dumps, namely for ROM and GROM. This requires the user to mount both dumps in one cartridge slot each. From 0.131 on, cartridges are realized as ZIP files, containing several entries. For instance, the Extended Basic cartridge looks like this:		Before MESS 0.131, cartridges consisted of separate ROM dumps, namely for ROM and GROM. This requires the user to mount both dumps in one cartridge slot each. From 0.131 on, cartridges are realized as ZIP files, containing several entries. For instance, the Extended Basic cartridge looks like this:
Line 91:		Line 91:
	\| style="border:1px solid black; padding:0.5em" \| rom_socket		\| style="border:1px solid black; padding:0.5em" \| rom_socket
	\| style="border:1px solid black; padding:0.5em" \| Cartridges with CRU banking (like DataBioTics)		\| style="border:1px solid black; padding:0.5em" \| Cartridges with CRU banking (like DataBioTics)
			\|-
			\| style="border:1px solid black; padding:0.5em" \| gromemu
			\| style="border:1px solid black; padding:0.5em" \| Paged cartridges with GROM emulation (full 8K)
			\| style="border:1px solid black; padding:0.5em" \| grom_socket, rom_socket, rom2_socket
			\| style="border:1px solid black; padding:0.5em" \| RXB and other cartridges with emulated GROMs
	\|}		\|}

Mizapf at 17:34, 20 October 2011

2011-10-20T17:34:51Z

← Older revision		Revision as of 17:34, 20 October 2011
Line 162:		Line 162:
	* Create a layout file as shown above. Use the rom dump file names in the references. Name the file "layout.xml".		* Create a layout file as shown above. Use the rom dump file names in the references. Name the file "layout.xml".
	* Create a ZIP archive file named mycartridge.rpk (or any other name). Put the rom dumps and the xml file in the archive.		* Create a ZIP archive file named mycartridge.rpk (or any other name). Put the rom dumps and the xml file in the archive.

			[[Category:MESS]]

Mizapf at 15:28, 7 November 2009

2009-11-07T15:28:59Z

New page

Back to [[MESS | TI MESS emulation home page]].

With MESS 0.131 there is a new cartridge handling system, the ''multicart system''. It basically has three important features:

* Cartridges which contain various ROM dumps can now be realized by one single file.
* As one has one file per cartridge, the multiple cartridge handling may be used.
* Cartridges may consist of ROMs and RAMs. RAM can be handled as persistent (NVRAM) or volatile.

'''Note''': As with all other features, please check the section [[MESS_non-problems|No problems]] first if you suspect an issue. Sometimes there is no problem at all, or you can easily avoid it.

== New cartridge structure ==

Before MESS 0.131, cartridges consisted of separate ROM dumps, namely for ROM and GROM. This requires the user to mount both dumps in one cartridge slot each. From 0.131 on, cartridges are realized as ZIP files, containing several entries. For instance, the Extended Basic cartridge looks like this:

extendedbasic.rpk:
exbasicc.bin
exbasicd.bin
exbasicg.bin
layout.xml

The "bin" files are ROM dumps: ''exbasicc'' is the ROM dump of the CPU address area >6000 to >7FFF. ''exbasicd'' is the second bank which resides on the same addresses. Extended Basic switches both banks by writing a random value to address >6000 (switch to bank 0) or >6002 (switch to bank 1). ''exbasicg'' is the GROM dump. Unlike the GRAM Kracker format (which is also used in the Geneve), all GROMs are stored in one file, including the padding in the last 2K of each GROM (i.e. the file is expected to have a size of a multiple of 8K).

The layout file defines the role of the respective ROM dumps, and selects one of five predefined handlers in the MESS emulator. If more cartridge types are found, additional handlers can be added in the MESS code.

This is the layout file for the Extended Basic cartridge:

<?xml version="1.0" encoding="utf-8"?>
<romset version="1.0">
<resources>
<rom id="gromimage" file="exbasicg.bin"/>
<rom id="romimage1" file="exbasicc.bin"/>
<rom id="romimage2" file="exbasicd.bin"/>
</resources>
<configuration>
<pcb type="paged">
<socket id="rom_socket" uses="romimage1"/>
<socket id="rom2_socket" uses="romimage2"/>
<socket id="grom_socket" uses="gromimage"/>
</pcb>
</configuration>
</romset>

The file contents is an XML document following these conventions:

* The root element is <romset>
* Each dump is found in a <rom> element in the <resources> section.
* In the <configuration> section, the <pcb> element defines the cartridge type.
* Each socket refers to exactly one resource defined above.

For the TI emulation, we have some predefined constants here:

{| style="border:1px solid black"
|-
! style="border:1px solid black; padding:0.5em" | PCB Type
! style="border:1px solid black; padding:0.5em" | Meaning
! style="border:1px solid black; padding:0.5em" | Sockets
! style="border:1px solid black; padding:0.5em" | Used by
|-
| style="border:1px solid black; padding:0.5em" | standard
| style="border:1px solid black; padding:0.5em" | Cartridges with 0 or 1 ROM and 0 or 1 GROM dump.
| style="border:1px solid black; padding:0.5em" | rom_socket, grom_socket
| style="border:1px solid black; padding:0.5em" | Most cartridges
|-
| style="border:1px solid black; padding:0.5em" | paged
| style="border:1px solid black; padding:0.5em" | Cartridges with 2 ROMs and 0 or 1 GROM dump. Extended Basic is known to use this format.
| style="border:1px solid black; padding:0.5em" | rom_socket, rom2_socket, grom_socket
| style="border:1px solid black; padding:0.5em" | Extended Basic and many Atarisoft games
|-
| style="border:1px solid black; padding:0.5em" | minimem
| style="border:1px solid black; padding:0.5em" | Cartridges with 1 ROM (4K) and 1 persistent RAM (4K) and 0 or 1 GROM dump.
| style="border:1px solid black; padding:0.5em" | rom_socket, grom_socket, ram_socket
| style="border:1px solid black; padding:0.5em" | Mini Memory
|-
| style="border:1px solid black; padding:0.5em" | super
| style="border:1px solid black; padding:0.5em" | Cartridges with 1 RAM (32K) and 0 or 1 GROM dump.
| style="border:1px solid black; padding:0.5em" | grom_socket, ram_socket
| style="border:1px solid black; padding:0.5em" | SuperSpace II
|-
| style="border:1px solid black; padding:0.5em" | mbx
| style="border:1px solid black; padding:0.5em" | Cartridges with 1 ROM, 1 RAM (1K, persistent) and 0 or 1 GROM dump.
| style="border:1px solid black; padding:0.5em" | rom_socket, grom_socket, ram_socket
| style="border:1px solid black; padding:0.5em" | MBX cartridges
|-
| style="border:1px solid black; padding:0.5em" | paged379i
| style="border:1px solid black; padding:0.5em" | Cartridges with one ROM of 8K to 64K
| style="border:1px solid black; padding:0.5em" | rom_socket
| style="border:1px solid black; padding:0.5em" | New cartridges with LS379 selector
|-
| style="border:1px solid black; padding:0.5em" | pagedcru
| style="border:1px solid black; padding:0.5em" | Cartridges with one ROM of 8K to 64K
| style="border:1px solid black; padding:0.5em" | rom_socket
| style="border:1px solid black; padding:0.5em" | Cartridges with CRU banking (like DataBioTics)
|}

== More examples ==

Editor/Assembler:
<?xml version="1.0" encoding="utf-8"?>
<romset>
<resources>
<rom id="gromimage" file="ed-assmg.bin"/>
</resources>
<configuration>
<pcb type="standard">
<socket id="grom_socket" uses="gromimage"/>
</pcb>
</configuration>
</romset>

MiniMemory:
<?xml version="1.0" encoding="utf-8"?>
<romset>
<resources>
<rom id="gromimage" file="minimemg.bin"/>
<rom id="romimage" file="minimemc.bin"/>
<ram id="bufferedRam" type="persistent" file="minimem.nv" length="4096" />
</resources>
<configuration>
<pcb type="minimem">
<socket id="rom_socket" uses="romimage"/>
<socket id="grom_socket" uses="gromimage"/>
<socket id="ram_socket" uses="bufferedRam"/>
</pcb>
</configuration>
</romset>

SuperSpace II (do not mount the supcartc.bin which can be found on some servers; it is just the image of the empty ram):
<?xml version="1.0" encoding="utf-8"?>
<romset version="1.0">
<resources>
<rom id="gromdump" file="supcartg.bin"/>
<ram id="ssram" file="superspace.nv" type="persistent" store="external" length="32768" />
</resources>
<configuration>
<pcb type="super">
<socket id="grom_socket" uses="gromdump"/>
<socket id="ram_socket" uses="ssram"/>
</pcb>
</configuration>
</romset>

Sewermania (although there may be better examples; I don't know whether it makes use of the RAM at all):
<?xml version="1.0" encoding="utf-8"?>
<romset version="1.0">
<resources>
<rom id="gromimage" file="sewermaniag.bin"/>
<ram id="mbxram" store="external" type="persistent" file="sewermania.nv" length="1024" />
</resources>
<configuration>
<pcb type="mbx">
<socket id="grom_socket" uses="gromimage"/>
<socket id="ram_socket" uses="mbxram"/>
</pcb>
</configuration>
</romset>

== Do it yourself ==

If the cartridge which you want to use is not available as an rpk, just do the following:

* Determine the type of the cartridge. This is something you have to figure out. If you find a *d.bin file, it is "paged"; the "minimem" type is only used by MiniMemory, and the "super" type belongs to SuperSpace II. That is, you need to check whether the cartridge is an MBX cartridge or not, and accordingly use the type "standard", "paged", or "mbx".
* Create a layout file as shown above. Use the rom dump file names in the references. Name the file "layout.xml".
* Create a ZIP archive file named mycartridge.rpk (or any other name). Put the rom dumps and the xml file in the archive.

MESS multicart system - Revision history

Stephen Shaw: add link to Atarisoft

Mizapf: /* New cartridge structure */

Mizapf at 17:34, 20 October 2011

Mizapf at 15:28, 7 November 2009