blueMSX+ v3.1.1-y8960.5

blueMSX+ の非公式フォークに、音源カートリッジ Y8960 のエミュレーションを追加したものです。

Y8960 のハードウェアは開発中です（hra1129/Y8960_Cartridge）。
エミュレーションは現時点の仕様に沿っており、仕様が変われば動作も変わります。 そのため pre-release として公開しています。

この版は Y8960_Cartridge の v0.9.4 を基にしています。

使い方: Y8960 対応の使い方

v3.1.1-y8960.4 からの変更

Y8960 の仕様の変更に追随しました

• 7FFFh（I/O イネーブラ 2）を読み出せるようになりました。 bit 0・1・2・7 は書いた値、bit 3-6 は 0 です。
  メモリマップド I/O のそれ以外の番地（7FF0h-7FFEh）は書き込みのみのままです
• RAM モードで BANK1 に SCC を出しているときは、メモリマップド I/O が見えなくなりました。 7FF0h-7FFFh は
  SCC のものになります。v3.1.1-y8960.4 ではこの場合もメモリマップド I/O に入っていました。
  メモリマップド I/O が見えるのは、互換モードのときと、RAM モードで BANK1 に ROM バンクを出しているときです

blueMSX+ の開発版から取り込んだもの

• ASCII16-X・Yamanooto・Flash-ROM SCC のフラッシュは、MSX が書き換えた部分だけを保存するようになりました。
  ROM ファイルを作り直すと、その内容が反映されます
• 長いファイルパスを含むメッセージが、途中で切れずに表示されるようになりました
• 自動で隠れたマウスポインタが、動かしたときかクリックしたときだけ再び現れるようになりました

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

同梱していないもの

• Y8960 を駆動する拡張 BASIC と BIOS（madscient/MsxSoundSuiteExtension）。入手方法と利用条件はそちらを参照してください
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

注意

• テーマのミキサー画面には Y8960 の帯がありません。ブロックごとの調整はミキサー（個体ごと）で、Y8960 全体は設定ファイルで変更します（使い方を参照）
• 動作の確認が済んでいない機能があります（使い方の「動作の確認が済んでいない機能」）
• 配布物（x64 版・Win32 版）で確かめたのは、起動することと、試験用のプログラムで SCC と OPM の音・定位・ミキサーの音量、バンクメモリとメモリマップド I/O、I/O イネーブラ 2 の読み出し、タイマと OPM の割り込みが期待どおりになることまでです

English

An unofficial fork of blueMSX+ that adds emulation of the Y8960 sound cartridge.

The Y8960 hardware is still under development (hra1129/Y8960_Cartridge).
The emulation follows its current specification and will change as the hardware does, so this is published as a pre-release.

This version is based on Y8960_Cartridge v0.9.4.

How to use: Y8960 user guide (Japanese)

Changes since v3.1.1-y8960.4

Following the Y8960 specification

• 7FFFh (I/O enabler 2) can now be read back. Bits 0, 1, 2 and 7 return what was written; bits 3-6 read as 0.
  The rest of the memory-mapped I/O (7FF0h-7FFEh) stays write only
• With the SCC shown in BANK1 in RAM mode, the memory-mapped I/O is now absent and 7FF0h-7FFFh belong to the
  SCC. In v3.1.1-y8960.4 those writes went to the memory-mapped I/O. The memory-mapped I/O is present in compatibility
  mode, and in RAM mode while BANK1 holds a ROM bank

From blueMSX+'s development branch

• The flash of ASCII16-X, Yamanooto and the Flash-ROM SCC now saves only the parts the MSX has rewritten, so a rebuilt
  ROM file takes effect
• Messages with a long file path are shown whole instead of being cut off
• An auto-hidden mouse pointer comes back only when it moves or on a click

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Not included

• The extended BASIC and BIOS that drive the Y8960 (madscient/MsxSoundSuiteExtension). See there for how to obtain them and the terms of use
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

Notes

• The theme's mixer window has no Y8960 strip. Set the blocks one by one in Sound Mixer (Devices); the Y8960 as a whole is set in the settings file (see the user guide)
• Some features have not been confirmed to work (see the user guide)
• On the packages (x64 and Win32), what has been checked is that they start, and that test programs get the expected SCC and OPM sound, pan and mixer volumes, bank memory and memory-mapped I/O behaviour, the read-back of I/O enabler 2, and timer and OPM interrupts

blueMSX+ v3.1.1-y8960.4

blueMSX+ の非公式フォークに、音源カートリッジ Y8960 のエミュレーションを追加したものです。

Y8960 のハードウェアは開発中です（hra1129/Y8960_Cartridge）。
エミュレーションは現時点の仕様に沿っており、仕様が変われば動作も変わります。 そのため pre-release として公開しています。

この版は Y8960_Cartridge の v0.9.2 を基にしています。

使い方: Y8960 対応の使い方

v3.1.1-y8960.3 からの変更

Y8960 の仕様の変更に追随しました

• OPM（YM2151 相当）のブロックが増えました。 Y8960 は 7 つのブロックになりました。I/O ポートは 7Eh（アドレス）と
  7Fh（データ、読むとステータス）で、I/O イネーブラは 7FFFh の bit 2、トンネルは 7FFBh/7FFCh、
  ミキサーの音量は 7FFDh です。タイマの割り込みは MSX の割り込みに入ります
• マシン構成に置くときの番号は 206 です。以前 Y8960 DCSG に使っていた番号なので、v3.1.1-y8960.2 までの
  config.ini を書き換えたときに DCSG の行を残していると、Y8960 OPM が追加されます
• SCC がステレオになり、チャンネルごとに定位を置けるようになりました。 BANK2 に SCC を出しているときは
  9900h-9904h、RAM モードで BANK1 に出しているときは 7900h-7904h です。定位を書かない SCC は中央に置かれ、
  左右それぞれの音は以前の約 0.7 倍になります
• メモリマップド I/O は 7FF0h-7FFFh になりました。 RAM モードで BANK1 に SCC を出しているときも使えます
  （7FF0h-7FFFh への書き込みは SCC ではなくメモリマップド I/O に入ります）。BANK1 に RAM バンクを出しているときは
  使えず、その範囲は RAM として書けます

ミキサー

• ツール → ミキサー（個体ごと） を足しました。音源を 1 つずつ並べ、行ごとに有効/無効・音量・パンを変えられます。
  同じ種類の音源を 2 つ載せても別々に調整でき、Y8960 のブロックも 1 行ずつ出ます。設定は bluemsx.ini に保存され、
  同じ場所に挿したときに戻ります
• 10 番目に登録された音源の音量・パン・有効が、MIDI の設定で上書きされることがある不具合を直しました

blueMSX+ の開発版から取り込んだもの

• GFX9000 と Video9000（V9990）
• ROM のマッパーの判定の改善、フラッシュの書き込み保護の修正、一部の zip を開くと落ちる不具合の修正
• /rom1 /rom2 が拡張子によらず ROM を受け取るようになりました。種類の分からないファイルをドロップしたときは
  エラーを表示します

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

同梱していないもの

• Y8960 を駆動する拡張 BASIC と BIOS（madscient/MsxSoundSuiteExtension）。入手方法と利用条件はそちらを参照してください
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

注意

• テーマのミキサー画面には Y8960 の帯がありません。ブロックごとの調整はミキサー（個体ごと）で、Y8960 全体は設定ファイルで変更します（使い方を参照）
• 動作の確認が済んでいない機能があります（使い方の「動作の確認が済んでいない機能」）
• 配布物（x64 版・Win32 版）で確かめたのは、起動することと、試験用のプログラムで SCC と OPM の音・定位・ミキサーの音量、バンクメモリとメモリマップド I/O、タイマと OPM の割り込みが期待どおりになることまでです

English

An unofficial fork of blueMSX+ that adds emulation of the Y8960 sound cartridge.

The Y8960 hardware is still under development (hra1129/Y8960_Cartridge).
The emulation follows its current specification and will change as the hardware does, so this is published as a pre-release.

This version is based on Y8960_Cartridge v0.9.2.

How to use: Y8960 user guide (Japanese)

Changes since v3.1.1-y8960.3

Following the Y8960 specification

• A new OPM block (YM2151 equivalent). The Y8960 now has seven blocks. I/O ports 7Eh (address) and 7Fh (data;
  reads the status), I/O enabler bit 2 of 7FFFh, tunnel at 7FFBh/7FFCh, mixer volume at 7FFDh. Its timer
  interrupt reaches the MSX's interrupt line
• Its number in a machine configuration is 206, which Y8960 DCSG used to have. A config.ini from v3.1.1-y8960.2 or
  earlier that was renumbered but kept the DCSG line now adds a Y8960 OPM
• The SCC is now stereo, with a pan per channel: 9900h-9904h with the SCC shown in BANK2, 7900h-7904h with
  it shown in BANK1 in RAM mode. An SCC whose pan is left alone sits in the centre, at about 0.7 of its former level on
  each side
• The memory-mapped I/O is now 7FF0h-7FFFh. It works with the SCC shown in BANK1 in RAM mode too (writes to
  7FF0h-7FFFh go to the memory-mapped I/O, not the SCC). With a RAM bank in BANK1 it is absent and the range is RAM

Mixer

• Tools → Sound Mixer (Devices) lists each sound device on its own row, with enable, volume and pan. Two devices of
  the same kind can be set apart, and the Y8960 blocks get a row each. The settings are saved in bluemsx.ini and come
  back when the device is in the same place
• Fixed: the MIDI settings could overwrite the volume, pan and enable of the tenth sound device registered

From blueMSX+'s development branch

• GFX9000 and Video9000 (V9990)
• Better ROM mapper detection, a flash write-protect fix, and a fix for a crash opening some zip files
• /rom1 and /rom2 accept a ROM of any extension; dropping a file of unknown type shows an error

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Not included

• The extended BASIC and BIOS that drive the Y8960 (madscient/MsxSoundSuiteExtension). See there for how to obtain them and the terms of use
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

Notes

• The theme's mixer window has no Y8960 strip. Set the blocks one by one in Sound Mixer (Devices); the Y8960 as a whole is set in the settings file (see the user guide)
• Some features have not been confirmed to work (see the user guide)
• On the packages (x64 and Win32), what has been checked is that they start, and that test programs get the expected SCC and OPM sound, pan and mixer volumes, bank memory and memory-mapped I/O behaviour, and timer and OPM interrupts

blueMSX+ v3.1.1-y8960.3

blueMSX+ の非公式フォークに、音源カートリッジ Y8960 のエミュレーションを追加したものです。

Y8960 のハードウェアは開発中です（hra1129/Y8960_Cartridge）。
エミュレーションは現時点の仕様に沿っており、仕様が変われば動作も変わります。 そのため pre-release として公開しています。

使い方: Y8960 対応の使い方

v3.1.1-y8960.2 からの変更

以前の版の設定・履歴・ステートはそのまま使えません

• Y8960 のデバイスの番号が 180-187 から 200-207 に変わりました。 v3.1.1-y8960.2 までの版で作った
  マシン構成（config.ini）は、[Slots] の番号に 20 を足して書き換えてください。
  Y8960 DCSG（186）の行は消してください
• カートリッジの履歴とステートセーブも番号を持つため、以前の版のものは使えません
• 基盤タイプ MSX2++（SSGS を本体の PSG にする形）は無くなりました

Y8960 の仕様の変更に追随しました

• Y8960 DCSG と、OPLLEX・OPL2EX の 2 回路目は無くなりました。 ハードウェアから外れたためです。
  Y8960 は 6 つのブロックになりました
• MSX-MIXER が音量を持つようになりました。 メモリマップド I/O の 7FF7h-7FFAh がブロックごとの音量
  （SSGS / OPLLEX / OPL2EX / SCC）、7FFEh がマスター音量です。I/O ポート B6h/B7h は無くなりました
• メモリマップド I/O の並びが変わりました。 トンネルは SSGS が 7FF0h/7FF1h、OPL2EX が 7FF2h/7FF3h、
  OPLLEX が 7FF4h/7FF5h、I/O イネーブラは 7FF6h と 7FFFh（SSGS は bit 1）です
• SSGS のレジスタ配置が変わりました。 00h-0Fh と 10h-1Fh が 2 系統、20h-26h がチャンネルごとの音量、
  28h-2Eh がチャンネルごとの定位です
• OPLLEX と OPL2EX がステレオになりました。 OPLLEX は 50h-58h、OPL2EX は F6h-FEh（チャンネル 1-9）と
  FFh（ADPCM）で、チャンネルごとに定位を置けます
• OPL2EX のリズム音が楽音と同じ大きさで混ざるようになりました。07h の bit 3（SP-OFF）は無くなりました
• RAM モードでない（互換モードの）とき、BANK1 には SCC が出なくなりました

修正と改善

• OPL2EX の ADPCM が、サンプルの終わりで遅れずに止まるようになりました。再生中に停止アドレスを再生位置より
  手前へ動かしたときも、すぐに止まります
• OPLLEX の音源コアを emu2413 v1.6.4 のサンプリングレート変換に更新しました
• blueMSX+ の開発版に入った SCC と PSG の修正を、Y8960 の SCC と SSGS にも入れました
• blueMSX+ の開発版に入った修正と機能を取り込みました（Rookie Drive NX、フォルダをディスクとして挿して書き戻す機能、
  物理ドライブの接続、MegaFlashROM SCC+ SD・SCC・R800・プリンタの修正、C-BIOS の更新など）。
  バージョン情報の画面に、ビルドした枝とコミットが出ます

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

同梱していないもの

• Y8960 を駆動する拡張 BASIC と BIOS（madscient/MsxSoundSuiteExtension）。入手方法と利用条件はそちらを参照してください
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

注意

• Y8960 全体の音量・パンはミキサー画面に出ません。設定ファイルで変更します（使い方を参照）
• 動作の確認が済んでいない機能があります（使い方の「動作の確認が済んでいない機能」）
• 配布物（x64 版・Win32 版）で確かめたのは、起動することと、試験用のプログラムで SCC の音とミキサーの音量（マスター音量を含む）が期待どおりになることまでです

English

An unofficial fork of blueMSX+ that adds emulation of the Y8960 sound cartridge.

The Y8960 hardware is still under development (hra1129/Y8960_Cartridge).
The emulation follows its current specification and will change as the hardware does, so this is published as a pre-release.

How to use: Y8960 user guide (Japanese)

Changes since v3.1.1-y8960.2

Settings, history and states from earlier versions do not carry over

• The Y8960 device numbers moved from 180-187 to 200-207. In machine configurations (config.ini) made with
  v3.1.1-y8960.2 or earlier, add 20 to the numbers in [Slots], and delete the Y8960 DCSG (186) line
• The cartridge history and saved states also hold these numbers, so those from earlier versions cannot be used
• Board type MSX2++ (SSGS as the machine's PSG) is gone

Following the Y8960 specification

• Y8960 DCSG and the second OPLLEX and OPL2EX circuits are gone, as the hardware dropped them. The Y8960 now has six blocks
• MSX-MIXER now has volumes: per-block volumes (SSGS / OPLLEX / OPL2EX / SCC) at 7FF7h-7FFAh and a master volume at 7FFEh
  of the memory-mapped I/O. I/O ports B6h/B7h are gone
• New memory-mapped I/O layout: tunnels at 7FF0h/7FF1h (SSGS), 7FF2h/7FF3h (OPL2EX), 7FF4h/7FF5h (OPLLEX);
  I/O enablers at 7FF6h and 7FFFh (SSGS is bit 1)
• New SSGS register layout: two sets at 00h-0Fh and 10h-1Fh, per-channel volume at 20h-26h, per-channel pan at 28h-2Eh
• OPLLEX and OPL2EX are now stereo, with per-channel pan: OPLLEX 50h-58h, OPL2EX F6h-FEh (channels 1-9) and FFh (ADPCM)
• OPL2EX rhythm is mixed at the same level as the melody. Bit 3 of 07h (SP-OFF) is gone
• Outside RAM mode (compatibility mode), the SCC no longer appears in BANK1

Fixes and improvements

• The OPL2EX ADPCM stops on time at the end of a sample, and at once when the stop address is moved behind playback
• The OPLLEX core uses the sample rate converter of emu2413 v1.6.4
• The SCC and PSG fixes from blueMSX+'s development branch are also in the Y8960 SCC and SSGS
• Fixes and features from blueMSX+'s development branch (Rookie Drive NX, directories inserted as disks with write-back,
  physical drives, fixes to MegaFlashROM SCC+ SD, the SCC, the R800 and the printer, updated C-BIOS, and more).
  The About dialog shows the branch and commit it was built from

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Not included

• The extended BASIC and BIOS that drive the Y8960 (madscient/MsxSoundSuiteExtension). See there for how to obtain them and the terms of use
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

Notes

• The Y8960's overall volume and pan do not appear in the mixer window; change them in the settings file (see the user guide)
• Some features have not been confirmed to work (see the user guide)
• On the packages (x64 and Win32), what has been checked is that they start and that a test program gets the expected SCC sound and mixer volumes (master volume included)

blueMSX+ v3.1.1-makoto.4

blueMSX+ の非公式フォークに、YM2608 (OPNA) の音源カートリッジ Makoto のエミュレーションを追加したものです。

Y8960 対応（v3.1.1-y8960.5）とは別の版で、Y8960 は含みません。

v3.1.1-makoto.3 との違い

• FM と SSG の音量を別々に調整できます。 調整は設定ファイルで行います（下の「使い方」の 3）。
  Yamaha SFG の音量設定は、Makoto には効かなくなりました
• ADPCM 用 RAM の読み書きが、ブロックの端まで届きます。 makoto.3 までは、書き込みで終了アドレスの最後の 1 バイトが書かれず、
  読み出しでリミットアドレスの最後の 1 バイトが読めませんでした。ADPCM の再生終了のフラグ（EOS）も、フラグのリセットで消えるようになりました
• makoto.3 以前で保存したステートを読み込むと、再生中だった ADPCM は止まった状態になります（FM・SSG・リズムは続きます）

同梱していないもの

• YM2608 のリズム音源の波形 ROM（8 KB）は同梱していません。 YM2608 に内蔵されている
  ヤマハの ROM のデータで、再配布できないためです。リズム音源を鳴らすには、利用者ご自身で
  入手してください。 無くてもエミュレータは動き、リズム以外の音（FM・SSG・ADPCM）は鳴ります
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

使い方

1. リズム音源の波形 ROM を置きます（任意）。 入手した ROM を
   Machines/Shared Roms/ym2608_rhythm.rom という名前で置いてください。
   MAME で ym2608_adpcm_rom.bin（8192 バイト、CRC32 23c9e0d8）と呼ばれているものと同じデータです。
   置かない場合はリズムだけが鳴りません。

2. カートリッジを挿します。 メニューの「ROMスロット 1」または「ROMスロット 2」→「特殊カートリッジ」→「Makoto」。
   マシン構成エディタで、デバイス「Makoto」としてスロットに置くこともできます。
   コマンドラインからは /special2 MAKOTO のように指定できます。

3. 音量とパンは設定ファイルで調整します（ミキサー画面には出ません）。エミュレータを終了してから、
   blueMSX+ のフォルダにある bluemsx.ini の次の行を書き換えます。行が無ければ [config] の下に足してください。
   OPNA_FM が FM・リズム・ADPCM、OPNA_SSG が SSG です。音量は 0〜100、パンは 0（左）〜100（右）で、下は既定値です。

   sound.mixerChannel.MIXER_CHANNEL_OPNA_FM.enable=yes
   sound.mixerChannel.MIXER_CHANNEL_OPNA_FM.pan=50
   sound.mixerChannel.MIXER_CHANNEL_OPNA_FM.volume=95
   sound.mixerChannel.MIXER_CHANNEL_OPNA_SSG.enable=yes
   sound.mixerChannel.MIXER_CHANNEL_OPNA_SSG.pan=50
   sound.mixerChannel.MIXER_CHANNEL_OPNA_SSG.volume=95
   

エミュレートしているもの

音源	YM2608 (OPNA)、8 MHz。FM 6 音・SSG 3 音・リズム 6 音・ADPCM 1 音
I/O ポート	14h–17h（14h/15h が表側、16h/17h が裏側のアドレスとデータ）
ADPCM 用 RAM	256 KB
割り込み	YM2608 の /IRQ は MSX の /INT に繋がっています

音源部分には ymfm（Aaron Giles、BSD-3-Clause）を使っています。
blueMSX+ と同梱のコンポーネントのライセンスは、パッケージの LICENSE.txt と Licenses フォルダにあります。

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

注意

• 確認したのは、C-BIOS の機種と実機 BIOS の機種（Sony HB-F1XDJ）で試験用のプログラムを動かし、
  FM・SSG・リズム・タイマ・割り込みが期待どおりに鳴ることまでです（C-BIOS は x64 版と Win32 版、実機 BIOS は x64 版）。
  VGMPlay MSX などの市販・同人のソフトでの再生は、まだ確かめていません
• ADPCM の再生と RAM の読み書きは、エミュレータの外で動かす開発用の試験で確かめました。MSX 上のソフトからは、まだ確かめていません

English

An unofficial fork of blueMSX+ that adds emulation of Makoto, a YM2608 (OPNA) sound cartridge.

This is separate from the Y8960 build (v3.1.1-y8960.5) and does not include the Y8960.

Differences from v3.1.1-makoto.3

• The levels of FM and SSG can be set separately. They are set in the settings file (step 3 of "How to use").
  The Yamaha SFG volume setting no longer applies to Makoto
• Reads and writes of the ADPCM RAM reach the ends of a block. Up to makoto.3 a write did not store the last byte of the
  end address, and a read did not reach the last byte of the limit address. The ADPCM end-of-sample flag (EOS) is now
  cleared by the flag reset
• When a state saved with makoto.3 or earlier is loaded, ADPCM that was playing is left stopped (FM, SSG and rhythm go on)

Not included

• The YM2608 rhythm waveform ROM (8 KB) is not included. It is Yamaha's data built into the
  YM2608 and cannot be redistributed. To hear the rhythm part, you need to obtain it yourself.
  Without it the emulator still runs and everything but the rhythm (FM, SSG, ADPCM) plays
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

How to use

1. Put the rhythm waveform ROM in place (optional). Save the ROM you obtained as
   Machines/Shared Roms/ym2608_rhythm.rom.
   It is the same data MAME calls ym2608_adpcm_rom.bin (8192 bytes, CRC32 23c9e0d8).
   Without it only the rhythm part is silent.

2. Insert the cartridge: menu "Cartridge Slot 1" or "Cartridge Slot 2" → "Insert Special" → "Makoto".
   It can also be placed in a slot as the device "Makoto" in the machine configuration editor,
   or given on the command line, e.g. /special2 MAKOTO.

3. Volume and pan are set in the settings file (they do not appear on the mixer screen). With the emulator closed, edit
   these lines of bluemsx.ini in the blueMSX+ folder; if they are not there, add them under [config].
   OPNA_FM is FM, rhythm and ADPCM; OPNA_SSG is the SSG. Volume is 0 to 100, pan is 0 (left) to 100 (right);
   the values below are the defaults.

   sound.mixerChannel.MIXER_CHANNEL_OPNA_FM.enable=yes
   sound.mixerChannel.MIXER_CHANNEL_OPNA_FM.pan=50
   sound.mixerChannel.MIXER_CHANNEL_OPNA_FM.volume=95
   sound.mixerChannel.MIXER_CHANNEL_OPNA_SSG.enable=yes
   sound.mixerChannel.MIXER_CHANNEL_OPNA_SSG.pan=50
   sound.mixerChannel.MIXER_CHANNEL_OPNA_SSG.volume=95
   

What is emulated

Sound chip	YM2608 (OPNA) at 8 MHz: 6 FM, 3 SSG, 6 rhythm, 1 ADPCM
I/O ports	14h–17h (14h/15h lower half, 16h/17h upper half: address and data)
ADPCM RAM	256 KB
Interrupt	The YM2608's /IRQ is connected to the MSX /INT

The sound chip is ymfm by Aaron Giles (BSD-3-Clause).
The licenses of blueMSX+ and the components it includes are in LICENSE.txt and the Licenses folder of the package.

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Notes

• What has been checked: on a C-BIOS machine and on a machine with a real BIOS (Sony HB-F1XDJ), a test program plays FM, SSG
  and rhythm and uses the timer and the interrupt as expected (C-BIOS with both the x64 and the Win32 build, the real BIOS with
  the x64 build). Playback with software such as VGMPlay MSX has not been checked yet
• ADPCM playback and reads and writes of its RAM have been checked with a development test that runs outside the emulator.
  They have not been checked from software on the MSX yet

blueMSX+ v3.1.1-makoto.3

blueMSX+ の非公式フォークに、YM2608 (OPNA) の音源カートリッジ Makoto のエミュレーションを追加したものです。

Y8960 対応（v3.1.1-y8960.2）とは別の版で、Y8960 は含みません。

v3.1.1-makoto.2 との違い

• 高い音が正しい大きさで鳴ります。 makoto.2 では、音が高いほど小さくなり（14 kHz で約 2 dB）、元の音に無い成分も混ざっていました。FM・リズム・ADPCM と SSG を、それぞれチップが作る速さのまま生成してから、出力の速さに変換するようにしています
• プリスケーラを切り替えた状態で保存したステートが、正しい音程で読めます

同梱していないもの

• YM2608 のリズム音源の波形 ROM（8 KB）は同梱していません。 YM2608 に内蔵されている
  ヤマハの ROM のデータで、再配布できないためです。リズム音源を鳴らすには、利用者ご自身で
  入手してください。 無くてもエミュレータは動き、リズム以外の音（FM・SSG・ADPCM）は鳴ります
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

使い方

1. リズム音源の波形 ROM を置きます（任意）。 入手した ROM を
   Machines/Shared Roms/ym2608_rhythm.rom という名前で置いてください。
   MAME で ym2608_adpcm_rom.bin（8192 バイト、CRC32 23c9e0d8）と呼ばれているものと同じデータです。
   置かない場合はリズムだけが鳴りません。
2. カートリッジを挿します。 メニューの「ROMスロット 1」または「ROMスロット 2」→「特殊カートリッジ」→「Makoto」。
   マシン構成エディタで、デバイス「Makoto」としてスロットに置くこともできます。
   コマンドラインからは /special2 MAKOTO のように指定できます。
3. 音量とパンは Yamaha SFG と同じ設定で調整します。

エミュレートしているもの

音源	YM2608 (OPNA)、8 MHz。FM 6 音・SSG 3 音・リズム 6 音・ADPCM 1 音
I/O ポート	14h–17h（14h/15h が表側、16h/17h が裏側のアドレスとデータ）
ADPCM 用 RAM	256 KB
割り込み	YM2608 の /IRQ は MSX の /INT に繋がっています

音源部分には ymfm（Aaron Giles、BSD-3-Clause）を使っています。
blueMSX+ と同梱のコンポーネントのライセンスは、パッケージの LICENSE.txt と Licenses フォルダにあります。

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

注意

• 確認したのは、C-BIOS の機種で試験用のプログラムを動かし、FM・SSG・リズム・タイマ・割り込みが期待どおりに鳴ることまでです（x64 版と Win32 版の両方）。
  VGMPlay MSX などの市販・同人のソフトでの再生と、ADPCM の再生はまだ確かめていません
• ADPCM 用 RAM への読み書きは、ブロックの端で実機と違う動きをします。 書き込みでは終了アドレスの最後の 1 バイトが書かれず、
  読み出しではリミットアドレスの最後の 1 バイトを読む前に 0 番地へ戻ります。使っている ymfm の動作で、実機ではどちらも最後の 1 バイトまで届くと報告されています

English

An unofficial fork of blueMSX+ that adds emulation of Makoto, a YM2608 (OPNA) sound cartridge.

This is separate from the Y8960 build (v3.1.1-y8960.2) and does not include the Y8960.

Differences from v3.1.1-makoto.2

• High notes play at their proper level. In makoto.2 a note got quieter the higher it was (about 2 dB at 14 kHz),
  and sound that was not in the original was mixed in. FM, rhythm and ADPCM, and the SSG, are now each generated at the
  rate the chip produces them at and then converted to the output rate
• A state saved with the prescaler switched now loads at the right pitch

Not included

• The YM2608 rhythm waveform ROM (8 KB) is not included. It is Yamaha's data built into the
  YM2608 and cannot be redistributed. To hear the rhythm part, you need to obtain it yourself.
  Without it the emulator still runs and everything but the rhythm (FM, SSG, ADPCM) plays
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

How to use

1. Put the rhythm waveform ROM in place (optional). Save the ROM you obtained as
   Machines/Shared Roms/ym2608_rhythm.rom.
   It is the same data MAME calls ym2608_adpcm_rom.bin (8192 bytes, CRC32 23c9e0d8).
   Without it only the rhythm part is silent.
2. Insert the cartridge: menu "Cartridge Slot 1" or "Cartridge Slot 2" → "Insert Special" → "Makoto".
   It can also be placed in a slot as the device "Makoto" in the machine configuration editor,
   or given on the command line, e.g. /special2 MAKOTO.
3. Volume and pan use the same setting as the Yamaha SFG.

What is emulated

Sound chip	YM2608 (OPNA) at 8 MHz: 6 FM, 3 SSG, 6 rhythm, 1 ADPCM
I/O ports	14h–17h (14h/15h lower half, 16h/17h upper half: address and data)
ADPCM RAM	256 KB
Interrupt	The YM2608's /IRQ is connected to the MSX /INT

The sound chip is ymfm by Aaron Giles (BSD-3-Clause).
The licenses of blueMSX+ and the components it includes are in LICENSE.txt and the Licenses folder of the package.

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Notes

• What has been checked: on a C-BIOS machine, a test program plays FM, SSG and rhythm and uses the timer and the interrupt as expected
  (with both the x64 and the Win32 build). Playback with software such as VGMPlay MSX, and ADPCM playback, have not been checked yet
• Reading and writing the ADPCM RAM differs from the real chip at the ends of a block. A write does not store the last byte
  of the end address, and a read returns to address 0 before reading the last byte of the limit address. This is how the ymfm
  in use behaves; on the real chip both are reported to reach the last byte

blueMSX+ v3.1.1-y8960.2

blueMSX+ の非公式フォークに、音源カートリッジ Y8960 のエミュレーションを追加したものです。

Y8960 のハードウェアは開発中です（hra1129/Y8960_Cartridge）。
エミュレーションは現時点の仕様に沿っており、仕様が変われば動作も変わります。 そのため pre-release として公開しています。

使い方: Y8960 対応の使い方

v3.1.1-y8960.1 からの変更

• Y8960 一式を 1 枚のカートリッジとして挿せるようになりました。「ファイル → ROMスロット → 特殊カートリッジ → Y8960 Cartridge」、または ROM イメージを挿して ROM タイプに Y8960 Cartridge を選びます（ファームウェアを使う場合はこちら）。7 つのブロックが一度に入り、抜くと一度に外れます
• マシン構成エディタで Y8960 SCC を置いたとき、開始ページが正しく設定されない不具合を直しました
• blueMSX+ の開発版に入った修正を取り込みました（キーボード・ジョイスティック・SG-1000・Game Reader の SCC など）
• 配布物に、blueMSX+ と同梱のコンポーネントのライセンス文書（LICENSE.txt と Licenses フォルダ）を入れました

追加したもの

• Y8960 を構成する 7 つのブロックを、マシン構成に 1 つずつ追加できるデバイスとして実装しました
  • Y8960 SCC（SCC・バンクメモリ・I/O イネーブラ・メモリマップド I/O）
  • Y8960 OPLLEX（YM2413 相当 ×2、チャンネルごとの音色 ROM 切り替え）
  • Y8960 OPL2EX（YM3812 + ADPCM-B 相当 ×2、4 種類の波形選択）
  • Y8960 SSGS（YM2149 相当 ×2、チャンネルごとのパンポット）
  • Y8960 DCSG（SN76489 相当 ×2）
  • Y8960 MSX-TIMER（4 本のカウンタと割り込み）
  • Y8960 MSX-MIXER（ハードウェア側が未実装のため、現状は音に影響しません）
• Y8960 SCC は ROM タイプ Y8960 SCC のカートリッジとしても挿せます
• 本体内蔵の形を試すための基盤タイプ MSX2++ を追加しました（SSGS が本体の PSG になります）
• 1 つの I/O ポートを複数のデバイスで共有できるようにしました
• コマンドラインオプション /hidden（ウィンドウを出さずに実行）と、外部のプログラムからキー入力を送る仕組みを追加しました

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

同梱していないもの

• Y8960 を駆動する拡張 BASIC と BIOS（madscient/MsxSoundSuiteExtension）。入手方法と利用条件はそちらを参照してください
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

注意

• Y8960 の音量・パンはミキサー画面に出ません。設定ファイルで変更します（使い方を参照）
• 動作の確認が済んでいない機能があります（使い方の「動作の確認が済んでいない機能」）
• Win32 版は、起動して ROM タイプの一覧を出せることまでしか確かめていません

English

An unofficial fork of blueMSX+ that adds emulation of the Y8960 sound cartridge.

The Y8960 hardware is still under development (hra1129/Y8960_Cartridge).
The emulation follows its current specification and will change as the hardware does, so this is published as a pre-release.

How to use: Y8960 user guide (Japanese)

Changes since v3.1.1-y8960.1

• The whole Y8960 can be inserted as one cartridge: "File → Cartridge Slot → Insert Special → Y8960 Cartridge", or insert a ROM image with ROM type Y8960 Cartridge (use this for the firmware). All seven blocks go in together and come out together
• Fixed the start page of Y8960 SCC when placed with the machine configuration editor
• Fixes from blueMSX+'s development branch (keyboard, joystick, SG-1000, Game Reader SCC and others)
• The package now includes the licenses of blueMSX+ and its components (LICENSE.txt and the Licenses folder)

Added

• The seven blocks of the Y8960, each as a device you add to a machine configuration
  • Y8960 SCC (SCC, bank memory, I/O enabler, memory-mapped I/O)
  • Y8960 OPLLEX (2 × YM2413-compatible, per-channel voice ROM selection)
  • Y8960 OPL2EX (2 × YM3812 + ADPCM-B-compatible, four waveforms)
  • Y8960 SSGS (2 × YM2149-compatible, per-channel panpot)
  • Y8960 DCSG (2 × SN76489-compatible)
  • Y8960 MSX-TIMER (four counters and an interrupt)
  • Y8960 MSX-MIXER (no effect on sound yet; not implemented in the hardware)
• Y8960 SCC can also be inserted as a cartridge with ROM type Y8960 SCC
• Board type MSX2++ for the built-in form (SSGS replaces the machine's PSG)
• An I/O port can be shared by more than one device
• Command line option /hidden (run without a window) and key input from external programs

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Not included

• The extended BASIC and BIOS that drive the Y8960 (madscient/MsxSoundSuiteExtension). See there for how to obtain them and the terms of use
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

Notes

• Y8960 volume and pan do not appear in the mixer window; change them in the settings file (see the user guide)
• Some features have not been confirmed to work (see the user guide)
• The Win32 build has only been checked to start and list ROM types

blueMSX+ v3.1.1-makoto.2

blueMSX+ の非公式フォークに、YM2608 (OPNA) の音源カートリッジ Makoto のエミュレーションを追加したものです。

Y8960 対応（v3.1.1-y8960.2）とは別の版で、Y8960 は含みません。

同梱していないもの

• YM2608 のリズム音源の波形 ROM（8 KB）は同梱していません。 YM2608 に内蔵されている
  ヤマハの ROM のデータで、再配布できないためです。リズム音源を鳴らすには、利用者ご自身で
  入手してください。 無くてもエミュレータは動き、リズム以外の音（FM・SSG・ADPCM）は鳴ります
• 実機の BIOS ROM（blueMSX+ と同じく、C-BIOS の機種は ROM なしで使えます）

使い方

1. リズム音源の波形 ROM を置きます（任意）。 入手した ROM を
   Machines/Shared Roms/ym2608_rhythm.rom という名前で置いてください。
   MAME で ym2608_adpcm_rom.bin（8192 バイト、CRC32 23c9e0d8）と呼ばれているものと同じデータです。
   置かない場合はリズムだけが鳴りません。
2. カートリッジを挿します。 メニューの「ROMスロット 1」または「ROMスロット 2」→「特殊カートリッジ」→「Makoto」。
   マシン構成エディタで、デバイス「Makoto」としてスロットに置くこともできます。
   コマンドラインからは /special2 MAKOTO のように指定できます。
3. 音量とパンは Yamaha SFG と同じ設定で調整します。

エミュレートしているもの

音源	YM2608 (OPNA)、8 MHz。FM 6 音・SSG 3 音・リズム 6 音・ADPCM 1 音
I/O ポート	14h–17h（14h/15h が表側、16h/17h が裏側のアドレスとデータ）
ADPCM 用 RAM	256 KB
割り込み	YM2608 の /IRQ は MSX の /INT に繋がっています

音源部分には ymfm（Aaron Giles、BSD-3-Clause）を使っています。
blueMSX+ と同梱のコンポーネントのライセンスは、パッケージの LICENSE.txt と Licenses フォルダにあります。

土台は blueMSX+ v3.1.1 で、それ以降に blueMSX+ の開発版に入った修正も含みます。

注意

• 確認したのは、C-BIOS の機種で試験用のプログラムを動かし、FM・SSG・リズム・タイマ・割り込みが期待どおりに鳴ることまでです。
  VGMPlay MSX などの市販・同人のソフトでの再生と、ADPCM の再生はまだ確かめていません
• Win32 版と、配布用の構成（Final）のビルドでは、音を確かめていません

English

An unofficial fork of blueMSX+ that adds emulation of Makoto, a YM2608 (OPNA) sound cartridge.

This is separate from the Y8960 build (v3.1.1-y8960.2) and does not include the Y8960.

Not included

• The YM2608 rhythm waveform ROM (8 KB) is not included. It is Yamaha's data built into the
  YM2608 and cannot be redistributed. To hear the rhythm part, you need to obtain it yourself.
  Without it the emulator still runs and everything but the rhythm (FM, SSG, ADPCM) plays
• Real-machine BIOS ROMs (as with blueMSX+, the C-BIOS machines work without them)

How to use

1. Put the rhythm waveform ROM in place (optional). Save the ROM you obtained as
   Machines/Shared Roms/ym2608_rhythm.rom.
   It is the same data MAME calls ym2608_adpcm_rom.bin (8192 bytes, CRC32 23c9e0d8).
   Without it only the rhythm part is silent.
2. Insert the cartridge: menu "Cartridge Slot 1" or "Cartridge Slot 2" → "Insert Special" → "Makoto".
   It can also be placed in a slot as the device "Makoto" in the machine configuration editor,
   or given on the command line, e.g. /special2 MAKOTO.
3. Volume and pan use the same setting as the Yamaha SFG.

What is emulated

Sound chip	YM2608 (OPNA) at 8 MHz: 6 FM, 3 SSG, 6 rhythm, 1 ADPCM
I/O ports	14h–17h (14h/15h lower half, 16h/17h upper half: address and data)
ADPCM RAM	256 KB
Interrupt	The YM2608's /IRQ is connected to the MSX /INT

The sound chip is ymfm by Aaron Giles (BSD-3-Clause).
The licenses of blueMSX+ and the components it includes are in LICENSE.txt and the Licenses folder of the package.

Based on blueMSX+ v3.1.1, including fixes that went into blueMSX+'s development branch after it.

Notes

• What has been checked: on a C-BIOS machine, a test program plays FM, SSG and rhythm and uses the timer and the interrupt as expected.
  Playback with software such as VGMPlay MSX, and ADPCM playback, have not been checked yet
• Sound has not been checked with the Win32 build or with the distribution (Final) configuration