MSX Development Tools · 2017

asu bloadmake Ver 1.1

A Windows utility for adding an MSX BLOAD header to binary program or data files, so they can be loaded using MSX-BASIC.

WindowsMSX-BASICBDS C support2-Clause BSD
Download Ver 1.1 ↗

© Masaki Oba 2017

Overview

asu bloadmake adds an MSX BLOAD header to a binary file (a program or data file). It is similar in purpose to the BSAVE.COM utility included with MSX-DOS2 TOOLS, but BSAVE.COM converts Intel HEX files rather than arbitrary binary files and does not run on Windows.

The -b option supports BDS C programs built with a customized startup routine and MSX library.

Platform: Windows · License: 2-Clause BSD License.

Included files

  • bloadmake.exe — English executable
  • bloadmakej.exe — Japanese executable
  • bloadmakea.exe — English executable (same as bloadmake.exe)
  • bloadmake.c — Japanese source file
  • bloadmakea.c — English source file

Source encoding: Shift JIS. Other environments may require conversion to another encoding or removal of Japanese text.

Default settings

Origin (ORG): 8100H
Load size: input file size
Execution address: 8100H
Output filename: the input filename with its extension changed to .bin.

Usage & options

usage: bloadmake [-b] [-o<hex>] [-s<hex>] [-r<hex>] [-k<extension>] readfile [writefile]
   -o, -s, -r and -j take hexadecimal values; -k sets the filename extension.
   xxx -o,-s,-r,-j hex numbers. -k filename extension.

     -b write a jump to the initialization code for BDS C with MSX-BASIC fixed C.CCC

         if the jump address changes, use -r or -j option.

     -oxxx  ORG address (hex); for example -o8A00

     -sxxx  load size in bytes (hex); for example -sffb

     -rxxx  run address (hex); for example -r9b00

     -jxxx  write jump code "JP xxxxH" 3 bytes at ORG through ORG+2

     -kxxx  output filename extension; for example -kABC

     -A  romanized messages (default)

     -N  Japanese messages



<font size="+1"><b>Download</b></font>

<a href="http://www.nabeta.tk/en/msx/bloadmake1.1.zip">Download asu bloadmake Ver 1.1</a>



<font size="+1"><b>Support runtime and Library for BDS C</b></font>

<a href="http://www.nabeta.tk/en/msx/cr3develop.html">CR3 with asu-MSX Library for BDS C</a>

(including asu bloadmake.but may old version)



<a href="http://www.nabeta.tk/en">http://www.nabeta.tk/en/ (English)</a>

<a href="http://www.nabeta.tk">http://www.nabeta.tk (Japanese)</a>



(Japanese)

MSXのバイナリファイル(プログラムまたはデータにMSXのbloadヘッダを付加するプログラムです。

bloadヘッダを付加するとMSX-BASICのBLOADコマンドでMSXのメモリに読み込むことができ、マシン語プログラムの場合は実行することもできます。

似たような機能を持つソフトはMSX-DOS2 TOOLSのBSAVEコマンドだと思いますが、それはHEXファイルからの変換でバイナリファイルからの変換には対応していないこととWindowsでは動きません。

デフォルトはORGと実行番地が8100H、読み込みサイズはファイルサイズ。

デフォルト出力ファイル名は、入力ファイルの拡張子をBINに変えたもの。

BDS CでOSとしてのMSX-BASIC上で動くプログラムを作るために作りました。

そのため、-b オプションというBDS C用のオプションがあります。

これはBDS CとMSX-BASIC対応に改造した特定の初期化ルーチン(C.CCC)とMSX-BASIC環境に対応したライブラリとセットでないと意味をなしません。

普通にCP/M環境用にコンパイルしてもMSX-BASIC上では暴走するだけです。

MSX-BASIC対応のC.CCC及びMSX-BASIC対応のBDS C用ライブラリとサンプルプログラムは別途公開します。

サンプルプログラムは<a href="http://www.nabeta.tk/msx/cr3.html">CR3という落ち物ゲーム</a>です。

BDS Cを使わない場合でもbloadmakeは汎用的に使えます。



使い方: bloadmake [-b] [-o<16進数>] [-s<16進数>] [-r<16進数>] [-k<出力拡張子>] 読込ファイル [書き込みファイル]

   xxxは-o,-s,-r,-jでは16進数。-kでは拡張子の文字。

     -b  BDS CとMSX-BASIC対応改造C.CCC用の初期化ルーチンにジャンプするコードを埋め込む。

        もしジャンプアドレスが変更されたら、-r または-j オプションを使ってください。

     -oxxx  読み込み開始番地(ORG)。例えば -o8A00 なら 8A00H番地に読み込む。

     -sxxx  読み込みサイズ。例えば -sffb なら FFBHバイト読み込む。

     -rxxx  実行開始番地。例えば -r9b00 なら 9B00H番地から実行する。

     -jxxx  プログラム先頭3バイトにジャンプ命令を"JP xxxx"を上書きで埋め込む。

     -kxxx  出力ファイルの拡張子を指定。-kABC なら 拡張子を.ABCにする

     -A  エラーや説明等のメッセージをローマ字で出力する。

     -N  エラーや説明等のメッセージを全角で出力する。(デフォルト)





<a href="http://www.nabeta.tk/en">http://www.nabeta.tk/en/ (English)</a>

<a href="mailto:admin@nabeta.tk">admin@nabeta.tk</a>



Program last update 30 Mar 2017

HTML last update 30 Mar 2017

Compilation

Using C++ Builder on Windows:

bcc32 -DWINDOWS bloadmake.c

日本語の説明

MSXのバイナリファイル(プログラムまたはデータにMSXのbloadヘッダを付加するプログラムです。
bloadヘッダを付加するとMSX-BASICのBLOADコマンドでMSXのメモリに読み込むことができ、マシン語プログラムの場合は実行することもできます。
似たような機能を持つソフトはMSX-DOS2 TOOLSのBSAVEコマンドだと思いますが、それはHEXファイルからの変換でバイナリファイルからの変換には対応していないこととWindowsでは動きません。
デフォルトはORGと実行番地が8100H、読み込みサイズはファイルサイズ。
デフォルト出力ファイル名は、入力ファイルの拡張子をBINに変えたもの。
BDS CでOSとしてのMSX-BASIC上で動くプログラムを作るために作りました。
そのため、-b オプションというBDS C用のオプションがあります。
これはBDS CとMSX-BASIC対応に改造した特定の初期化ルーチン(C.CCC)とMSX-BASIC環境に対応したライブラリとセットでないと意味をなしません。
普通にCP/M環境用にコンパイルしてもMSX-BASIC上では暴走するだけです。
MSX-BASIC対応のC.CCC及びMSX-BASIC対応のBDS C用ライブラリとサンプルプログラムは別途公開します。
サンプルプログラムはCR3という落ち物ゲームです。
BDS Cを使わない場合でもbloadmakeは汎用的に使えます。

使い方: bloadmake [-b] [-o<16進数>] [-s<16進数>] [-r<16進数>] [-k<出力拡張子>] 読込ファイル [書き込みファイル]
xxxは-o,-s,-r,-jでは16進数。-kでは拡張子の文字。
-b BDS CとMSX-BASIC対応改造C.CCC用の初期化ルーチンにジャンプするコードを埋め込む。
もしジャンプアドレスが変更されたら、-r または-j オプションを使ってください。
-oxxx 読み込み開始番地(ORG)。例えば -o8A00 なら 8A00H番地に読み込む。
-sxxx 読み込みサイズ。例えば -sffb なら FFBHバイト読み込む。
-rxxx 実行開始番地。例えば -r9b00 なら 9B00H番地から実行する。
-jxxx プログラム先頭3バイトにジャンプ命令を"JP xxxx"を上書きで埋め込む。
-kxxx 出力ファイルの拡張子を指定。-kABC なら 拡張子を.ABCにする
-A エラーや説明等のメッセージをローマ字で出力する。
-N エラーや説明等のメッセージを全角で出力する。(デフォルト)


http://www.nabeta.tk/en/ (English)
admin@nabeta.tk

Program last update 30 Mar 2017
HTML last update 30 Mar 2017