実験的なコードとかいろいろ。
無保証です。
十分なテストを行っていないので、不具合があるかもしれません。
長いファイル名を使用しているため、TwentyOne +Tなどのファイル名を21文字認識する環境が必要です。
PCやネット上での取り扱いを用意にするために、src/内のファイルはUTF-8で記述されています。
X68000上でビルドする際には、UTF-8からShift_JISへの変換が必要です。
あらかじめ、u8tosjをビルドしてインストールしておいてください。
トップディレクトリでmakeを実行してください。以下の処理が行われます。
- build/ディレクトリの作成。
- src/内の各ファイルをShift_JISに変換してbuild/へ保存。
次に、カレントディレクトリをbuild/に変更し、makeを実行してください。
実行ファイルが作成されます。
ファイルを適当なツールで適宜Shift_JISに変換してからmakeを実行してください。
UTF-8のままでは正しくビルドできませんので注意してください。
- Human68k version 3.02
- GNU make 3.79 human68k-1.4 以降
- HAS060.X version 3.09+91 以降(必須)
- HLK evolution version 3.01+16 以降
- gcc2
プログラム起動時にa2レジスタで渡されるコマンドライン引数の内容を表示します。
HUPAIRに準拠してエンコードされた引数の場合はHUPAIRマークとARG0も表示します。
このプログラムにはHUPAIRマークを埋め込んであるため、親プロセスがHUPAIR 準拠であればコマンドライン引数もHUPAIRに従ってエンコードされるはずです。
プログラム起動時にa2レジスタで渡されるコマンドライン引数の内容を表示します。
HUPAIRに準拠してエンコードされた引数の場合はHUPAIRマークとARG0も表示します。
このプログラムにはHUPAIRマークは埋め込まれていません。
IOCS _ADPCMAOT、IOCS _ADPCMLOTを実行してDMACの一部のレジスタの値を表示します。
DMACのレジスタの値を確認するためのものですが、手抜きでDMAを動作させるのに
IOCSコールを使っているのでADPCMドライバなどは組み込んでいない状態で実行してください。
システムに登録されているビープ音を、IOCS _ADPCMOUTで再生します。
システムに登録されているビープ音を、MPCM.Xで効果音として再生します($10xx M_EFCT_OUT)。
Warning
リターンキーによる全チャンネル再生は大きな音が出るので注意してください。
システムに登録されているビープ音を、ZMSC3.Xで効果音として再生します($13 ZM_SE_ADPCM1)。
Warning
リターンキーによる全チャンネル再生は大きな音が出るので注意してください。
IOCS _BITSNSを実行してキーの押し下げ状態を表示します。
マウスのボタンを押すと終了します。
IOCSワークに保存されているキー状態をIOCSコール経由で取得しているだけなので、
実際にキーボードから送られたスキャンコードがそのまま表示されるわけではありません。
キーボードから送信されるスキャンコードをそのまま得たい場合は、keyscanを使用してください。
ユーザーモードにおいて、メインメモリ末尾-2のアドレスからロングワードサイズで読み込みを行い
バスエラーを発生させます。
M68000は16ビットバスなので、メインメモリの容量が$00Y0_0000のとき以下のような挙動になります。
- メインメモリ末尾-2(
$00Xf_fffe)から1ワード読み込む → 成功 - メモリ未実装アドレスまたはGVRAM(
$00Y0_0000)から1ワード読み込む → バスエラー発生
ただし拡張エリアセットやMMUによりメインメモリの末尾付近がスーパーバイザ保護されている場合は、 1.の時点でバスエラーが発生します。
※SRAMの内容を破壊するので、破壊しても構わないエミュレータ上でのみ試してください。
Xellent30用インストーラch30inst.x、chxinst.xは、SRAMに既に別のプログラムが組み込まれていても 空き領域を検索し共存してインストールすることができます。 その機能を試すためのツールです。
ch30*.sysがインストールできる最小限の領域だけ残して、何もしないダミープログラムを組み込みます。
使用法:
chxdummy ch30_omake.sys
chxinst ch30_omake.sys
カラーバーのような画像を描画します。
(カラーバーではないのでカラーバーとして使うことはできません。)
コンソール画面のスクロールをテストします。
なにかキーを押すと次のモードに進みます。
現在の日時をIOCSで取得し、BCD形式と文字列形式で表示します。
文字列形式についてはIOCS _DATEASCにある4種類がそれぞれ表示されます。
IOCSワーク$cb8、$cbaの値を再計測します。
MPU 68000、IOCS ROM version 1.1、1.2、1.3、1.6(XEiJ)専用です。
コマンドライン引数で指定したファイルをDOS _CREATEで作成し、
戻り値(ファイルハンドルまたはエラーコード)を表示します。
コマンドライン引数で指定したファイルをDOS _CREATEの通常モードと特殊モード
(ファイル属性のビット15を1にする)で連続して作成し、
戻り値(ファイルハンドルまたはエラーコード)を表示します。
特殊モードの動作により、同名のファイルが2個作成されます。
コマンドライン引数で指定したドライブ(省略時はカレントドライブ)のカレントディレクトリを
DOS _CURDIRで調べ、結果を表示します。
ドライブ名(ドライブレター + コロン)、ルートディレクトリのパスデリミタは含まれないため、
ルートディレクトリの場合は空文字列が表示されます。
コマンドライン引数で指定したファイルをDOS _FATCHKで調べ、結果を表示します。
コマンドライン引数で指定したファイル(省略時は標準入力)をDOS _FGETCで
1バイトずつ読み込み、標準出力へ出力します。
コマンドライン引数で指定したファイル(省略時は標準入力)をDOS _FGETSで
一行ずつ読み込み、標準出力へ出力します。
コマンドライン引数で指定したファイルのタイムスタンプをDOS _FILEDATEで調べ、結果を表示します。
また、オプション指定時はファイルにタイムスタンプを設定します。
-d<decimal>... 10進数で指定したタイムスタンプを設定します。-x<hex>... 16進数で指定したタイムスタンプを設定します。
コマンドライン引数で指定した環境変数をDOS _GETENVで取得し、結果を表示します。
DOS _INPOUTによる文字入力を行い文字コードを表示するか、または文字出力を行います。
入力中はCTRL+Cキーで終了しますが、標準入力をリダイレクトしていると終了できない場合があります。
コマンドライン引数で動作を指定します。
- -ff ...
CODE=$ff(キー入力)を行います。 - -fe ...
CODE=$fe(キー先読み)を行います。 - その他 ... 文字列を1バイトずつ出力します。
DOS _KEYCTRLによるキー入力を行い、キーコードを表示します。
OPT.1キーまたはOPT.2キーを押し下げると終了します
(終了しない場合はどちらかのキーを押し下げたまま文字キーを押してください)。
左端の16進数はループ回数です。 先読みして入力がない状態が連続した場合は表示を省略するので、ループ回数が飛びます。
コマンドライン引数でキー入力の方法を指定できます(無指定時は1)。
0...MD=0(キー入力)を使用します。1...MD=1(キー先読み)とMD=0(キー入力)を組み合わせて使用します。
Human68k version 3.02では0(MD=0)で入力がない場合に入力待ちをしませんが、
ASK68K 組み込み時は入力待ちをするなど、FEP組み込み状態によって挙動が一致しません。
コマンドライン引数で指定したファイルをDOS _MAKETMPで作成し、
戻り値(ファイルハンドルまたはエラーコード)と生成されたファイル名を表示します。
コマンドライン引数で指定したファイル名(パス名)をDOS _NAMECKで展開し、
戻り値と展開結果を表示します。
コマンドライン引数で指定したファイル名(パス名)をDOS _NAMESTSで展開し、
戻り値と展開結果を表示します。
コマンドライン引数で指定したファイルをDOS _NEWFILEで作成し、
戻り値(ファイルハンドルまたはエラーコード)を表示します。
コマンドライン引数で指定したファイルをDOS _OPENで開き、
戻り値(ファイルハンドルまたはエラーコード)を表示します。
環境変数を全て表示します。
なにかコマンドライン引数を指定すると終了時にキー入力を待ち、
終了コード1を返します(CONFIG.SYSのEXCONFIG =行から実行する場合用)。
DOS _READで標準入力からデータを読み込み(最大256バイト)、
戻り値(入力サイズまたはエラーコード)を表示します。
また、読み込んだデータを16進数で表示します。
上位メモリから起動して「OK.」と表示するだけのプログラムで、 HUPAIR準拠表示の判別を行うコードの動作テスト用です。
Human68kの非公開機能を使って上位メモリにロードさせます。
そのためのフラグをHLK evolutionの-g2オプションで設定するので、
リンカとしてHLK evolutionを使う必要があります。
RAMDISKなど上位メモリを使用するドライバは組み込まずに起動し、
HUPAIRに対応したシェルなどからentryceilを実行します
(スーパーバイザモードで動作するシェルの場合はメインメモリ実装量を11MB以下にしておきます)。
子プロセスのメモリブロック範囲外を参照する判別コードの場合、
未実装メモリを参照してバスエラーが発生します。
DOS _GETENVで環境変数名が長すぎる場合に、スタック上に確保されたバッファの範囲外に
書き込んでしまう挙動(Human68k v3.02)を検証します。
なにかコマンドライン引数を指定すると、DOS _SETENVで環境変数名と設定する文字列が
長すぎる場合の同様の挙動を検証します。
DOSコール内部のサブルーチンにあるrts命令で読み込まれるリターンアドレスの部分を、
用意した乗っ取りルーチンのアドレスで上書きさせることで、リターンする代わりに
そのルーチンを呼び出すように細工しています。
Warning
プログラムが終了しないためリセットする必要があります。
コピーバックのディスクキャッシュなどはあらかじめ解除してください。
実験用に用意したシステムでのみ実行してください。
※普段使っているシステムでは実行しないこと！
プログラムを起動すると確認プロンプトが表示されるので、
yesと入力してリターンキーで確定すると実行されます。
エスケープシーケンス ESC [6n (DSR = Device Status Report)
を表示した際にキーバッファに入力されたデータを読み取って表示します。
Human68Kの標準では ESC [{pl};{pc}R (CPR = Cursor Position Report)
が入力されますが、FEPによっては対応していません。
「ファイルを別名で実行するR形式実行ファイル」を作成します (作成にはシェルのリダイレクト機能を用います)。
execas 実行ファイル名 > 新ファイル名.r
実行ファイルは(通常であればカレントディレクトリと)環境変数pathからの検索が行われ、
絶対パス名に正規化されて新ファイルに埋め込まれます。
指定する実行ファイルはHUPAIRに対応している必要があります。
作成されたファイルを実行すると、作成時に指定された実行ファイルをロードし、 そのプロセスのPSP内に新ファイルのパス名とファイル名を上書きしてから実行します。
たとえばexecas C:\dir\gzip.x > D:\folder\gunzip.rとして作成されたgunzip.rを実行すると、
gunzip.rから実行されたC:\dir\gzip.xからは自分自身がD:\folder\gunzip.r
というファイル名であるかのように見えます。
DOS _FATCHKでバッファの範囲外に書き込んでしまう不具合(Human68k v3.02)を検証します。
FPACK __FCVTの動作テストです。
FPACK __STOHの動作テストです。
コマンドライン引数で指定したファイル名をDOS _FILESとDOS _NFILESで検索し、
見つかったファイル名を全て表示します。
ファイル名はDOS _FILESにそのまま渡されるもので、パス名やワイルドカードも指定できます。
コマンドライン引数で指定した文字のフォントを拡大してテキストとして表示します。
文字の代わりに、2桁または4桁の16進数による文字コードで指定することもできます。
コマンドライン引数でフォントの大きさを指定できます(無指定時は-8)。
-6... 半角6×12、全角12×12。-8... 半角8×16、全角16×16。-12... 半角12×24、全角24×24。
コマンドライン引数で指定した文字(省略時は半角スペース)について、
IOCS _FNTADR、IOCS _FNTGETの結果を一覧表示します。
フォントサイズは未定義の値も含め各サイズを指定します。
_FNTADRでd2.b = 0～5、_FNTGETでd1.hw = 1～5のサイズを指定した場合、
IOCS環境(ROMまたはIOCS.Xのバージョン)によって結果が異なります。
コマンドライン引数で指定したパス名について、仮想ドライブ・仮想ディレクトリの
割り当て状態をDOS _ASSIGN (MD=0)で調べ、結果を表示します。
STUDIO KAMADAさんで解説されているHuman68kの
「サブディレクトリ内のファイルが増えたときファイルなどが壊れることがある」
不具合について、再現手順の(2)～(6)を実行します。
あらかじめ再現手順(0)～(1)を実行後、カレントドライブをMOに変更にしてからこのプログラムを実行します。
なお手元の環境(Human68k v3.02、TwentyOne.x v1.36c)にて、このプログラムでは 「サブディレクトリ内の '.' と '..' のエントリが二重に記録される」 症状は再現できませんでした。
Warning
実験用に用意したシステムでのみ実行してください。
※普段使っているシステムでは実行しないこと！
IOCS _ONTIMEで取得した起動後の経過時間(1/100秒単位)を表示します。
なにかコマンドライン引数を指定すると経過日数を表示します。
IOCS _TXFILLのサンプルです。
IOCS _TXYLINEのサンプルです。
IOCS _TXRASCPYによるラスタコピーを行います。
使用法: iocs_txrascpy コピー元 コピー先 ラスタ数 移動方向(0:下,-1:上) テキストプレーン
移動方向、テキストプレーンは省略できます(省略時は0:下、%0011となります)。
X68000をクロックアップ改造しているとラスタコピーに失敗して画面が乱れることがあります。
IOCS.XやHIOCS.Xを組み込んでいるとコンソールのスクロールに内部のルーチンを使うほか、
アプリケーションによっては独自のラスタコピールーチンを持っているため、
IOCS _TXRASCPYが呼び出される機会がなく後から問題に気づくこともしばしばあるようです。
画面が乱れる場合は、IOCS _TXRASCPYを高クロック対応ルーチンに差し替えるドライバを組み込んでください
(HIOCS PLUS version 1.10+16.17以降など)。
IOCS _JOYGETによるジョイスティック入力を行い、入力状態を表示します。
キーを押すと終了します。
キーボード制御コマンドコードをキーボードに送信します。
コードはコマンドライン引数で16進数2桁で指定します(省略時は$47 = Compactキーボード判別)。
上位メモリに常駐するだけのプログラムで、常駐プロセスの常駐検査を行うコードの動作テスト用です。
Human68kの非公開機能を使って上位メモリにロードさせます。
そのためのフラグをHLK evolutionの-g2オプションで設定するので、
リンカとしてHLK evolutionを使う必要があります。
メインメモリ実装量を11MB以下にし、RAMDISKなど上位メモリを使用するドライバは組み込まずに起動し、
keepceilを常駐してから常駐検査コードを実行します。
常駐プロセスのメモリブロック範囲外を参照する検査コードの場合、未実装メモリを参照してバスエラーが発生します
(ただしkeepceilの本体が16バイトあるので、その範囲内しか見ない検査コードであれば問題を検出できません)。
SHIFTキーが押し下げられるまで待機し、キー入力をフラッシュしてから終了します。
コマンドライン引数でキーフラッシュの方法を指定できます(無指定時はi)。
i...IOCS _KEYSNS/_KEYINPを使用します。c...DOS _KEYCTRLを使用します。f...DOS _KFLUSHを使用します。
cは、FEPを組み込んでいると完全に消去できない場合があります。
fは「標準入力に対するフラッシュ」なので、keyflush f < nul
とすると(NUL デバイスに対してフラッシュを行うため)キーボード入力は消去されません。
キーボードから受信したスキャンコードを表示します。
マウスの左ボタンを押すと終了します。
マウスの右ボタンを押すとキーボード判別コマンド($47)を送信します(動作未確認)。
MFP USART受信バッファフル割り込みを差し替えているので、動作中にIOCSレベルのキー入力は行われません。
実行後はX680x0本体のリセットボタンによる再起動を推奨します。
プロセス自身のメモリブロックのアドレスとサイズを表示したあと、
可能な限りメモリブロックを確保してそのアドレスとサイズを表示します。
コマンドライン引数で動作モードを指定できます。
s... プロセスのメモリブロックを最小まで縮小します。e... プロセスのメモリブロックを最大まで拡大します。2...DOS _SETBLOCKの代わりにDOS _SETBLOCK2を使います(要060turbo.sys)。3...DOS _MALLOCの代わりにDOS _MALLOC3を使います(要060turbo.sys)。
DOS _MALLOCでメモリブロックを確保し結果(アドレス)を表示し解放、
コマンドライン引数で指定したコマンドをDOS _EXECで実行し結果を表示、
再度メモリブロックを確保し結果を表示し解放、という操作を行います。
MIDIボード(#1 = $00eafa00-$00eafa0f)のYM3802のレジスタの値を表示します(読み込みレジスタのみ)。
YM3802はレジスタへのアクセス手順が分かりにくかったので、その確認用です。
MPCM.Xの効果音発声数を設定します。
コマンドライン引数で0から8までの数を指定します。
DOS _NAMECKでバッファの範囲外に書き込んでしまう不具合(Human68k v3.02)を検証します。
コマンドライン引数で指定したファイル名(パス名)をDOS _NAMECKで展開し、結果を表示します。
省略した場合は指定できる最大の長さ(89バイト)のダミーパス名を使用します。
バッファの直後のメモリが破壊された場合は16進数ダンプを表示します
(バイト値が0xffの場合は__となります)。
DOS _NAMESTSでバッファの範囲外に書き込んでしまう不具合(Human68k v3.02)を検証します。
コマンドライン引数で指定したファイル名(パス名)をDOS _NAMESTSで展開し、結果を表示します。
省略した場合は指定できる最大の長さ(89バイト)のダミーパス名を使用します。
バッファの直後のメモリが破壊された場合は16進数ダンプを表示します
(バイト値が0xffの場合は__となります)。
ファイル入出力のDOSコールの一部に、システムスタック上にバッファを確保して
DOS _NAMESTSの内部ルーチンを呼び出すものがありますが、
そのルーチンがバッファの範囲外に書き込んでしまう不具合(Human68k v3.02)を検証します。
スタック破壊の結果、アドレスエラーなどが発生します。
コマンドライン引数で検証するDOSコールの種類を指定します。
引数を省略して実行すると使用できるDOSコールを表示します。
Warning
プログラムを正常に終了できないためリセットする必要があります。
コピーバックのディスクキャッシュなどはあらかじめ解除してください。
実験用に用意したシステムでのみ実行してください。
※普段使っているシステムでは実行しないこと！
プログラムを起動すると確認プロンプトが表示されるので、
yesと入力してリターンキーで確定すると実行されます。
オープン中のファイルの一覧(ファイルハンドルとファイル名)を表示します。
コマンドライン引数で指定したファイルを読み込み専用でオープンし、常駐終了(DOS _KEEPPR)します。
XCのプログラマーズマニュアルには「オープンしているファイルハンドルはクローズします」
と記載されていますが、実際にはクローズされません。
ファイルをクローズする方法は用意していないので、実行後は再起動してください。
コマンドライン引数で指定したファイルをDOS _EXEC (MD=2;pathchk)で調べ、結果を表示します。
Human68kにおけるパス名のディレクトリ名部分の長さは、
DOS _NAMESTSのバッファ構造などを見ると最大64バイトに見えますが、
実際の動作ではそれより小さい値となっています。
実行するとメモリ上のHuman68kにパッチをあて、最大64バイトに拡張します。
Human68k version 3.02専用です。
Warning
実験用に用意したシステムでのみ実行してください。
※普段使っているシステムでは実行しないこと！
文字コード0x7eの文字(オーバーラインまたはチルダ)を、X68000の機種依存文字も含め表示します。
aとzはフォントの配置を分かりやすくするための対照群です(どの行も通常の半角文字です)。
X68000の機種依存文字の文字表を表示します。
コマンドライン引数で動作モードを指定できます(無指定時は80)。
80... 0x80?? 半角ひらがなf0... 0xf0?? 上付き1/4角カタカナf1... 0xf1?? 上付き1/4角ひらがなf2... 0xf2?? 下付き1/4角カタカナf3... 0xf3?? 下付き1/4角ひらがなf4... 0xf4?? 半角外字f5... 0xf5?? 半角外字
コマンドライン引数で指定した文字列を、テキスト画面に12ドットフォントで描画します。
コマンドライン引数で指定した文字列を、テキスト画面に24ドットフォントで描画します。
trap #10命令によるソフトウェアリセットを行います。
X680x0のネタとしてNJの2文字をR形式実行ファイルにするとソフトウェアリセットができるという話がありますが、
プロセス起動直後のd0レジスタの内容は不定なので厳密に言うと確実ではありません
(pxNJなどであれば問題ありません)。
このプログラムではd0レジスタに'X68k'を入れてtrap #10を実行します。
COMMAND.Xで下記のコマンドを実行すると同一内容の実行ファイルを作成できます。
echo \L\L $NJX68k>reset68k.r
コマンドライン引数で指定したファイルをDOS _OPENで開き、ファイル末尾-1の位置に
DOS _SEEK (mode=2, offset=-1)で移動し、戻り値(移動先位置またはエラーコード)を表示します。
ファイルサイズが0バイトのファイルは移動できないのでエラー$ffff_ffe7になります。
CD-ROMなどのドライバ(リモートドライブ)によっては、mode=2の場合のoffset
の扱いが逆方向になっているため移動できずエラーになることがあります。
run68の-fオプションの動作確認用に作成した、
ほとんどのDOSコールを呼び出すだけの特に機能を持たないツールです。
途中でコンソールからの入力待ちがあるのでリターンキーを何度か押してください。
Warning
実行しても害はないと思いますが、確実ではない(保証できない)ので、 普段使っているシステムでは実行しないこと！
装着されているアクセラレータの種類を表示します。
実行中のエミュレータの種類を表示します。
MIDIボードの種類を表示します。
メインメモリとハイメモリの情報を表示します。
ハイメモリについては、HIMEM.SYSまたは互換メモリドライバが必要です。
本体の機種名を表示します。
PhantomXの情報を表示します。
SCSIボードの機種名を表示します。
SRAMの容量と使用状況を表示します。
ch30*_omake.sysが組み込まれている場合はそのバージョンを表示します。
(対応しているバージョンは、バイナリエディタで開いてオフセット$19の値が$41 'A'のもの)
Shift_JISの2バイト文字の文字表を表示します。
コマンドライン引数としてfを指定すると、X680x0独自拡張の2バイト半角文字
0xf000-0xf5ffの文字表を表示します(下位バイトとして有効な値の範囲は要検証)。
指定したスキャンコードを引数としてIOCS _SKEYSETを呼び出し、
その直後にIOCS _B_KEYINPで取得したキーデータを表示します。
画面間プライオリティを特殊な設定にして各画面に図形を描画します。
手前からテキスト画面(横長の長方形)、スプライト(16x16の正方形)、
グラフィック画面(縦長の長方形)が表示されるはずです。
なにかコマンドライン引数を指定するとビデオコントローラに半透明の設定を書き込みますが、
表示結果は同じになるはずです。
スプライトを画面中央に左右に並べて表示します。
1ラインあたりの表示限界の確認用です(実機は1ラインあたり最大32個)。
コマンドライン引数で動作モードを指定できます(無指定時は1)。
1... 画面右端から左端にスプライトを128個表示します。2... 画面右端から左端にスプライトを64個、その下の段に左端から右端に64個表示します。
画面モードが0番(通常の768×512の画面、IOCS _CRTMODの16番)でない場合はそれに変更し、 グラフィック画面を65536色モードに設定します。
システムポート領域($00e8e000-$00e8e00f、ポート未割り当てのアドレスも含む) を読み込んで値を表示します。
テキスト画面にメッセージを表示します。
なにかコマンドライン引数を指定すると描画が改善されます。
IOCS _VDISPSTで設定した割り込みが発生するまでの時間を計測して表示します(100分の1秒単位)。
コマンドライン引数で動作モードを指定できます。
0～255... カウンター値の指定(無指定時は1)。a... IOCSコールの不具合を回避します。
ディスクを破壊する可能性があるため、試す場合は独立したエミュレータ環境でのみ使用して下さい。
ブロックデバイスが初期化時にユニット数=0を返してはいけないことを検証します。
これは本来あってはならない動作であり、Human68kがDPBを65536個作成してしまいます。
リモートドライブのデバイスドライバとして作られており、CONFIG.SYSのDEVICE =
行で組み込むことができますが、初期化するとユニット数=0を返す以外の機能はありません。
GNU General Public License version 3 or later.
TcbnErik / 立花@桑島技研
https://github.com/kg68k/xperiment68k