MXDRVデータ資料

（１）MXDRV現役の頃にYURAYSAN氏により書かれたドキュメントです。調査・資料化に感謝いたします。

---

{
*

MXDRV v2.06+16/02EX 内部資料 修正/追加 by YURAYSAN

*

　パラメータのbは１バイト、wは２バイト（上位,下位の順）、lは4バイト。

１．MDXデータフォーマット

[データタイトル](サイズ不定) + $0D + $0A + $1A
[PCMファイル名](サイズ不定) + $00
[音色データオフセット](word)
[MMLデータオフセット * 9](word)

　音色データ及びMMLデータのベースポインタは音色データオフセットのポインタ。

１．１ 音色データフォーマット

　以下、データはすべてバイト単位。各パラメータはM1,M2,C1,C2の順。

0:[音色番号]
3:[DT1 & MUL]×4
4:[TL]×4
5:[KS & AR]×4
6:[AME & D1R]×4
7:[DT2 & D2R]×4
8:[D1L & RR]×4
1:[FL & CON]
2:[スロットマスク]

　未使用ビットは0とする。また、[FL & CON]のビット6,7は0とする。

       注意:実際には番号順に変換される

１．２ MMLデータフォーマット

• 休符データ

   [$00 ～ $7F]                  長さはデータ値+1クロック。

• 音符データ

   [$80 ～ $DF] + [長さ-1]b    音程は$80がo0d+、$DFがo8d。ChPではデータ番号。

• テンポ設定

   [$FF] + [???]b    @tコマンド対応

• OPMレジスタ設定

   [$FE] + [レジスタ番号]b + [出力データ]b

• 音色設定

   [$FD] + [???]b    @コマンド対応

• 出力位相設定

   [$FC] + [???]b    pコマンド対応

• 音量設定

   [$FB] + [$00～$15]b    vコマンド対応
   [$FB] + [$80～$FF]b    @vコマンド対応（ビット7無効）

• 音量増大

   [$FA]

• 音量減小

   [$F9]

• 発音長指定

   [$F8] + [$01～$08]b    qコマンド対応
   [$F8] + [$FF～$80]b    @qコマンド対応（2の補数）

• キーオフ無効

   [$F7]    次のNOTE発音後キーオフしない

• リピート開始

   [$F6] + [リピート回数]b + [$00]b

• リピート終端

   [$F5] + [開始コマンドへのオフセット+2]w

• リピート脱出

   [$F4] + [終端コマンドへのオフセット+1]w

• デチューン

   [$F3] + [???]w    Dコマンド対応

• ポルタメント

   [$F2] + [変移※1]w

       変移 = 1クロックあたりの変化量

• データエンド

   [$F1] + [$00]b               演奏終了
   [$F1] + [ループポインタ]w    ポインタ位置から再演奏

• キーオンディレイ

   [$F0] + [???]b    kコマンド対応

• 同期信号送出

   [$EF] + [チャネル番号(0～8)]b

• 同期信号待機

   [$EE]

• ADPCM/ノイズ周波数設定

　チャンネルH

   [$ED] + [???]b    ノイズ周波数設定。ビット7はノイズON/OFF

       ON  : 128+周波数
       OFF : 0

　チャンネルP

   [$ED] + [???]b    Fコマンド対応

• 音程LFO制御

   [$EC] + [$80]b    MPON
   [$EC] + [$81]b    MPOF
   [$EC] + [WAVE]b + [周期※2]w + [変移※1]w

       WAVE0 [ 鋸波 ] : 周期 = 設定値×4 : 変移 = 設定値×周期÷512
       WAVE1 [矩形波] : 周期 = 設定値×2 : 変移 = 設定値×256
       WAVE2 [三角波] : 周期 = 設定値×2 : 変移 = 設定値×周期÷512

• 音量LFO制御

   [$EB] + [$80]b    MAON
   [$EB] + [$81]b    MAOF
   [$EB] + [WAVE]b + [周期※2]w + [変移※1]w

       WAVE0 [ 鋸波 ] : 周期 = 設定値×4 : 変移 = 設定値×周期÷256
       WAVE1 [矩形波] : 周期 = 設定値×2 : 変移 = 設定値×256
       WAVE2 [三角波] : 周期 = 設定値×2 : 変移 = 設定値×周期÷256

• OPMLFO制御

   [$EA] + [$80]b    MHON
   [$EA] + [$81]b    MHOF
   [$EA] + [SYNC]b + [WAVE]b + [LFRQ]b + [PMD]b + [AMD]b + [PMS/AMS]b

       [SYNC*$40+WAVE]b + [LFRQ]b + [PMD+128]b + [AMD]b + [PMS/AMS}b

• LFOディレイ設定

   [$E9] + [???]b    MDコマンド対応

• PCM4/8使用宣言

   [$E8]

• 拡張MMLコマンド

   [$E7] + [拡張コマンド]b

　+16での拡張

       [$00]b                          ERROR=強制終了
       [$01]b + [SPEED]b               FADEOUT

　+17での拡張

       [$02]b + [d0.w] + [d1.l]        PCM8を直接ドライブする
       [$03]b + [FLAG]b                $00=KEYOFFする/$01=KEYOFFしない
       [$04]b + [CH]b + [MML]?         他のチャンネルをコントロール
       [$05]b + [DATA]b                音長加算する
       [$06]b + [FLAG]b                まだフラグを使用してない？

• 拡張MMLコマンド2 （非公式コマンド）+162EXのみ

　[$E6] + [拡張コマンド]b

       [$00]b                          ERROR = 強制終了
       [$01]b + [DETUNE]w              相対ディチューン (-32768～32768)
       [$02]b + [KEY TRANS]b           移調             (-127～127)
       [$03]b + [KEY TRANS]b           相対移調         (-127～127)

※1 変移 1クロック毎に変化させる量。単位はデチューンの1/256。
※2 周期 WAVE = 0 : 1周期のクロック数

          WAVE = 1 : 1/2周期のクロック数
          WAVE = 2 :        〃

２．PDXデータフォーマット

[ポインタ]l + [$0000]w + [長さ]w ×96
[PCMデータ]

EX-PDXの場合は長さもロングワードとして使える。

３．MXDRV V2.05 ファンクションコール

　レジスタにパラメータをセットしてtrap #4を実行。d0はファンクション番号。
　リターンd0が正値は正常終了、負数はエラーコード。d0以外は保存。

FUNC$00 UNLINK 　 演奏を終了して、MXDRVを切り放します

FUNC$01 reserved

FUNC$02 LOADMML　 MMLデータバッファにデータを転送します
パラメータ: d1.l: データサイズ

               a1.l:   データアドレス
                       エラーコードはバッファサイズ+$80000000

FUNC$03 LOADPCM PCMデータバッファにデータを転送します
パラメータ: d1.l: データサイズ

               a1.l:   データアドレス
                       エラーコードはバッファサイズ+$80000000

FUNC$04 M_PLAY 演奏を開始します
パラメータ: d1.l: MML番号（現在は無効）

FUNC$05 M_END 演奏を終了します

FUNC$06 M_STOP 演奏を停止します

FUNC$07 M_CONT 演奏を再開します

FUNC$08 MMLNAME MMLデータのタイトルを参照します
パラメータ: d1.l: データ番号（０でいいV2.06）
リターン: d0.l: MMLタイトルのアドレス

FUNC$09 PCMNAME PCMデータ名を参照します
パラメータ: d1.l: データ番号（０でいいV2.06）
リターン: d0.l: PCMデータ名のアドレス

FUNC$0A VOLADD volume加算???
パラメータ: d1.b: volume add data

FUNC$0B PCMCUT ???
パラメータ: d1.b:

FUNC$0C FADEOUT ﾌｪｰﾄﾞｱｳﾄ
パラメータ: d1.w: ﾌｪｰﾄﾞｱｳﾄｽﾋﾟｰﾄﾞ

FUNC$0D AMPLAY AUTO MUSIC PLAYER
パラメータ: d1.b: コマンド（bit15がonで切り放し）

               a2.l:   ?
               a1.l:   ?

FUNC$0E CHMASK ﾁｬﾝﾈﾙのﾏｽｸ
パラメータ: d1.w: 各ﾁｬﾝﾈﾙのﾌﾗｸﾞ

<ex> WVUT SRQP HGFE DCBA
　move.l #%0000_0000_0000_0000,d1 マスク部を１にする。

FUNC$0F M_PLAY2 ﾁｬﾝﾈﾙﾏｽｸ指定して演奏
パラメータ: d1.w: 各ﾁｬﾝﾈﾙのﾌﾗｸﾞ

FUNC$10 WORKS IMAGE REG の ｱﾄﾞﾚｽ を 求める
リターン: d0.l: ｱﾄﾞﾚｽ

FUNC$11 TIMSET
パラメーター: d1.l: 正で書き込み、負で読み出し
リターン: d0.b: tempo

FUNC$12 M_STAT
リターン: d0.w: ?

FUNC$13 KEYBCONT
パラメーター: d1.b: flag
リターン: d0.b: 前回値

FUNC$14 M_STAT2
リターン: d0.w: ?

FUNC$15 EXMODE
パラメータ: d1.b: ?
リターン: d0.b: ?

FUNC$16 TRACEMODE 使用禁止!
パラメータ: d1.b: ?
リターン: d0.b: ?

FUNC$17 TRACESTEP 使用禁止!

       実際に１割り込み分演奏します。
       FUNC$16で有効にしておいて下さい。

FUNC$18 PCM4WORKS
リータン: d0.l: ワークアドレス

FUNC$19 EXCHWORKS
リータン: d0.l: ワークアドレス

FUNC$1A～$FF reserved

４． MXDRV V2.06+13 追加ファンクション　（以下さとやんによる分析結果）

FUNC$0E CHANNEL_MASK チャンネルをマスクします。
パラメータ：
　d1.l : チャンネル指定

                  P HGFE DCBA

　move.l #%0000_0000_0000_0000,d1 マスク部を１にする。

FUNC$0C FADE-OUT フェードアウトします。

（その他不明）

５．特別付録

ＭＭＬバッファへの転送するさい先頭に付加情報が必要です。データは８バイトいります。

まず、＄００００、ＰＣＭを使用しない場合は＄ＦＦＦＦ、次に音色データオフセットまでのバイト数。

                                               　　　（付加情報の先頭からの物 .W）

この値は偶数でなければならないので奇数ならデータを丸ごとずらします。

そして＄０００８を書き込みます。

転送サイズも８バイト増えます。

次ぎにＰＣＭバッファ転送のさいの付加情報。

まず、＄００００００００、次ぎにデータまでのバイト数、＄０００８です。

                       　（ＭＭＬ同様に偶数。ＰＤＸファイル名の次ぎまでの値）

そして、ＰＤＸファイル名の転送です。

あと、ＭＭＬバッファ先頭アドレスから約－＄４０からＭＭＬ，ＰＣＭバッファのバイト数、

ＰＣＭバッファ先頭アドレス、ＰＣＭデータ使用アドレスなどが書かれている。
（正確には分からない）
}

---

（２）mdxファイル・コマンドフォーマット一覧表

---

• mdxファイル構造

offset	内容	サイズ	備考
$0000	title	不定	終端は $0d $0a $1a
- - -	PDX FileName	不定	終端は $00
($0000)	BASE POINT		PDXファイル名の直後を新たに始点とする。 以後BASE POINTからのoffset
($0000)	TONE data offset	2	音色データへのオフセット（big endian）
($0002)	Ch.A offset	2	channel.Aのmmlへのオフセット（big endian）
($0004)	Ch.B offset	2	channel.Aのmmlへのオフセット（big endian）
($0006)	Ch.C offset	2	channel.Aのmmlへのオフセット（big endian）
($0008)	Ch.D offset	2	channel.Aのmmlへのオフセット（big endian）
($000A)	Ch.E offset	2	channel.Aのmmlへのオフセット（big endian）
($000C)	Ch.F offset	2	channel.Aのmmlへのオフセット（big endian）
($000E)	Ch.G offset	2	channel.Aのmmlへのオフセット（big endian）
($0010)	Ch.H offset	2	channel.Aのmmlへのオフセット（big endian）
($0012)	Ch.P offset	2	channel.Aのmmlへのオフセット（big endian）
($0014)	Ch.Q offset	2	channel.Aのmmlへのオフセット（big endian）
($0016)	Ch.R offset	2	channel.Aのmmlへのオフセット（big endian）
($0018)	Ch.S offset	2	channel.Aのmmlへのオフセット（big endian）
($001A)	Ch.T offset	2	channel.Aのmmlへのオフセット（big endian）
($001C)	Ch.U offset	2	channel.Aのmmlへのオフセット（big endian）
($001E)	Ch.V offset	2	channel.Aのmmlへのオフセット（big endian）
($0020)	Ch.W offset	2	channel.Aのmmlへのオフセット（big endian）
Ch.Q - W のオフセットは EX-PCMモードの時に設けられる

• mmlバイナリフォーマット

binary	mml表記	備考
$00 ： $7f	r%1 ： r%128	休符
$80 %1 ： $df %1	o0d+%(%1 + 1) ： o8d%(%1 + 1)	音符 %1 = $ff のとき、音長は256clock
$e0 ： $e6		未定義
$e7		拡張コマンド定義。続く１バイトでコマンド確定
$e7 $01 %1	$FO%1	フェードアウト
$e8		#EX-PCMモードの宣言
編集中・・・