aboutsummaryrefslogtreecommitdiff
path: root/games/atari800/cart.rst
blob: 77a207d86487472fe04a973715bb488b44a51fe5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
.. RST source for cart(1) man page. Convert with:
..   rst2man.py cart.rst > cart.6
.. rst2man.py comes from the SBo development/docutils package.

.. |version| replace:: 5.0.0
.. |date| date::

====
cart
====

----------------------------------------------------------
convert raw Atari 8-bit ROM images to Atari800 CART files.
----------------------------------------------------------

:Manual section: 6
:Manual group: SlackBuilds.org
:Date: |date|
:Version: |version|

SYNOPSIS
========

cart *romfile* *cartfile* *carttype*

cart **-l**

cart **-p** *romfile*

DESCRIPTION
===========

**cart** creates an Atari800 CART image file from a raw Atari 8-bit ROM
image file by adding a 16-byte **CART** header.

The *romfile* is a file containing a raw Atari 8-bit ROM image
dump. It must be of the correct size for the *carttype* argument
(e.g. for type 1, "Standard 8KB cartridge", the file must be exactly
8192 bytes).

Output is written to *cartfile*. This must be a different filename
from *romfile* (in-place conversion is not supported). *cartfile* will
be exactly 16 bytes longer than *romfile* (e.g. for type 1, it will be
8208 bytes).

The *carttype* argument is numeric, one of the supported types. The
list can be viewed with **cart -l**. If you're not sure of the correct
type for a given ROM, you can narrow it down by running **cart -p**
*romfile*, which will show all the possible types that match the size
of the ROM.

There is no corresponding tool to convert a CART image back to a raw
ROM file, but this can be done with e.g. **dd**\(1)::

  dd if=image.cart of=image.raw bs=1 skip=16

...or **head**\(1) and **cat**\(1)::

  cat image.cart | ( head -c16 >/dev/null ; cat ) > image.raw

OPTIONS
=======

-l    Show the complete list of supported cartridge types.

-p *romfile*
      Show the list of cartridge types that match the size of *romfile*.

COPYRIGHT
=========

See the file /usr/doc/atari800-|version|/COPYING for license information.

AUTHORS
=======

**cart** is part of the **atari800**\(6) distribution. See
/usr/doc/atari800-|version|/CREDITS for the list of authors.

This man page written for the SlackBuilds.org project
by B. Watson, and is licensed under the WTFPL.

SEE ALSO
========

**atari800**\(6)

Full documentation for the CART file format:
  /usr/doc/atari800-|version|/cart.txt

The **atari800** website:
  https://atari800.github.io/