aboutsummaryrefslogtreecommitdiff
path: root/doc/casm.html
diff options
context:
space:
mode:
authorIan C <ianc@noddybox.co.uk>2016-05-06 11:37:46 +0100
committerIan C <ianc@noddybox.co.uk>2016-05-06 11:37:46 +0100
commit0b3c0e2a2e347db8af3f29d4dc8c86797981bc85 (patch)
treee8551b423f5f03a25da42d1c540749d968035812 /doc/casm.html
parentbeb25c09c87c67e83f05f89fe704890493aac263 (diff)
Added documentation for SNES output driver.
Diffstat (limited to 'doc/casm.html')
-rw-r--r--doc/casm.html85
1 files changed, 85 insertions, 0 deletions
diff --git a/doc/casm.html b/doc/casm.html
index 469456a..07b2c91 100644
--- a/doc/casm.html
+++ b/doc/casm.html
@@ -919,6 +919,13 @@ A Commodore 64 T64 tape file.
A Nintendo Gameboy ROM file.
</td></tr>
+<tr><td class="cmd">
+<a href="#snesout">snes</a>
+</td>
+<td class="def">
+A SNES ROM file.
+</td></tr>
+
</table>
</td></tr>
@@ -1115,6 +1122,84 @@ installed with just a <b>reti</b> instruction.
</table>
+<h3 id="snesout">SNES ROM File Output Format</h3>
+
+<p>
+Generates a ROM file for a SNES emulator or hardware. Note that large ROM
+sizes have not been extensively checked and verified.
+</p>
+
+<p>If a single bank was used during the assembly then a simple 32K ROM is
+assumed, and an error will be shown if the addresses used fall outside the range
+0x150 to 0x7fff. </p>
+
+<p>Similarly if multiple banks are used then it is assumed that the first bank
+is only used in the range 0x150 to 0x3fff, and subsequent banks in the range
+0x4000 to 0x7fff. This is to fit in with the method the Gameboy uses to page
+memory banks into the upper 16K portion of the normal 32K ROM address space.
+</p>
+
+<p>By default the output driver will try and fill in the ROM size and type in
+the header properly, but these can be overridden using settings.</p>
+
+<h4>SNES ROM Output Format options</h4>
+
+<p>The SNES output driver supports the following settings that can be set via
+an <b>option</b> command.
+</p>
+
+<table>
+
+<thead><tr><td class="head">Option</td>
+<td class="head">Description</td></tr></thead>
+
+<tr><td class="cmd">
+option snes-name, <i>name</i>
+</td>
+<td class="def">
+Sets the name of the cartridge. Defaults to "NONAME" if not set.
+</td></tr>
+
+<tr><td class="cmd">
+option snes-rom-type, &lt;lorom|hirom|lorom-fast|hirom-fast&gt;
+</td>
+<td class="def">
+Defines the memory mapping used for this cartridge. A detailed explanation
+is beyond this document, but note that when lorom is used then just the upper
+32K of each bank is used to generate the ROM. This is to make life easier,
+as the real physical mapping would make the lower 32K of a ROM bank
+mapped into the upper 32K address space. This way no hoops have to be jumped
+through.
+</td></tr>
+
+<tr><td class="cmd">
+option snes-irq, <i>irq</i>, <i>address</i>
+</td>
+<td class="def">
+Specifies an address where an IRQ routine is stored, and sets the appropriate
+vectors in emulation and native mode. <i>irq</i> can either by <b>vbl</b> for
+the vertical blanking interrupt and <b>irq</b> which is used for the scan-line
+interrupt. Note that an error is generated if a <b>vbl</b> routine is not
+supplied.
+</td></tr>
+
+<tr><td class="cmd">
+option snes-ram-size, <i>size</i>
+</td>
+<td class="def">
+Sets the RAM size in the ROM header.
+</td></tr>
+
+<tr><td class="cmd">
+option snes-rom-size, <i>size</i>
+</td>
+<td class="def">
+Sets the ROM size in the ROM header, overriding the calculated value the output
+driver would generate.
+</td></tr>
+
+</table>
+
<h2>Listing</h2>
<p>