famicom ROM cartridge utility - unagi
client version 0.5.0
by sato_tiff, sato at kitanaka.net
公式サイト http://sourceforge.jp/projects/unagi/

--はじめに--
famicom ROM cartridge のデータ転送を行います。 ハードウェアは国内で有
名な2種類に対応しています。

--特徴--
他の読み出しプログラムではマッパ別の対応はプログラムに内蔵されており、
未対応のマッパの追加ができるのはプログラマだけでした。unagi ではマッパ
対応をスクリプトに記載することによってユーザーが追加することができます。
バンク切り替えの仕様をしることによって技術的な興味がわくかもしれません。

コマンドラインでの無味乾燥なインタフェースによりビギナーお断りとなって
おります。

--動作環境--
パラレルポートと読み出しハードを接続した Windows 環境
* Windows XP にて動作確認しています。たぶん Win95 までなら大丈夫。
* パラレルポートアドレスは 0x0378 固定です。USB 接続のものは使えるか分
  かりません。

GIVEIO.SYS をインストールした環境
* パッケージには含まれていませんので別途用意してください。

cmd.exe, rxvt などのコマンドラインシェル

--ハードウェアの選択--
クライアントについている unagi.cfg をテキストエディタで編集して使用す
るハードを選んでください。行頭に # がついているものは無視されます。

--コマンドライン引数--
unagi.exe [mode] [script file] [target file] ...
== d ROM DUMP MODE==
ROM イメージを作成します。
unagi.exe d [script file] [dump file] [flag] [mapper]
script file - 対応するマッパの ROM スクリプトファイルを指定します。
dump file   - 出力する ROM イメージファイルを指定します。
以下は、通常は必要ありません。
flag        - 出力するヘッダを設定します。複数の場合はスペースをいれずに              記述します。
  S カセットに backup RAM がついている場合
  V スクリプトの設定を無視して mirroring を Vertical にする
  H スクリプトの設定を無視して mirroring を Horizonal にする
  _ mapper変更だけを適用する場合
mapper      - スクリプトの設定を無視してマッパ番号を設定します。

== r RAM READ MODE==
バックアップ RAM イメージを PC 上に作成します。
unagi.exe r [script file] [dump file]
script file - 対応するマッパの RAM スクリプトファイルを指定します。
dump file   - 出力する RAM イメージファイルを指定します。

== w RAM WRITE MODE==
バックアップ RAM イメージをカートリッジへ転送します。
unagi.exe w [script file] [ram file]
script file - 対応するマッパの RAM スクリプトファイルを指定します。
ram file    - 入力する RAM イメージファイルを指定します。

--スクリプト仕様--
ROM dump script パッケージの syntax.txt を参照してください。

--ライセンス--
unagi クライアントのバイナリとソースコード(例外有り)は下記が適用されま
す。unagi スクリプトは sato_tiff が作成したものは下記が適用されます。
GNU Lesser General Public License v2

例外物
- GIVEIO.SYSアクセスライブラリに含まれる giveio.c, giveio.h
えふ・ぴー・じー・えー・ぱーく管理人の「さとう」さんのご厚意によりソー
スコードも配布ソースに含めてよい許可をいただいております。二次配布など
の取り扱いはさとうさんの許可を得てください。

- GIVEIO.SYS
配布パッケージにも含めませんし、作者が誰なのかもわからないのでパッケー
ジに含めないでください。

--謝辞--
* 資料提供をしてくれた color さん, VirtuaNES のソース, nesdev
* GIVEIO.SYSアクセスライブラリのさとうさん
* ハードウェアを貸してくれたカシオンさん (敬称を付けなかったら脅しの
  メールが来ました。)
* アイコンを描いてくれたひろひろきさん
* プログラミング環境の mingw と rxvt (敬称を付けなくても脅しはきません
  でした)
