1章 MSX RS-232C

※
※ このページは書きかけです。以下の可能性があります。
※ ・誤字、脱字等のチェックをおこなっていません。
※ ・テキスト、表などフォーマットがされていない。
※ ・画像が抜けている。
※

 1.1 ハードウェア

　MSX RS-232Cには、シングルチャンネルタイプとマルチチャンネルタイプの2つの仕様があります。それぞれについて、以下で解説します。

1.1.1 シングルチャンネルバージョン

1. 使用するLSl

2. ポートアドレス

　　表7.1 シングルチャンネルタイプのポートアドレス

3. 82H番地ビット割り当て

　　表7.2　シングルチャンネルタイプのシステムステータス

　　表7.3　シングルチャンネルタイプの割り込みマスクレジスタ

4. 8253を使用した8251へのボーレートクロック発生

1.水晶発振器　発信周波数 1.8432MHz

　　表7.4 シングルチャンネルタイプのボーレートとスケールファクタ

2.使用するカウンタチャンネル

5. DSUB25コネクタのピン配列

　　表7.5 DSUB25コネクタのピン配列

1.1.2 マルチチャンネルバージョン

1. 使用するLSl

2. ROMアドレス
　RS-232Cのシステムソフトウェアは4000H〜5FFFHに配置します。ROMは以下のモジュールを含みます。

1. RS-232Cドライバ
2. RS-232C拡張BASIC
3. RS-232C拡張BIOS

　マルチチャンネルバージョンでサポートしているチャンネル数は1つのカートリッジにつき、最大4チャンネル(1台のシステムにつき、最大4チャンネル)です。

図7.1　マルチチャンネルRS-232Cカートリッジの実装例

3.RAMアドレス
　RAMは6000H〜67FFHに配置します。また、同じRAMがA000H〜A7FFHにも見えるようにイメージを出します。したがって、6000Hに1を書き込むと、A000Hも1になります。システムソフトウェアから両方のアドレスのRAMにアクセス出来るように回路を設計しなければなりません。これは、RS-232Cカートリッジの実行速度をなるべく高速にするためです。
　RAMは以下の目的で使われます。

1. 1チャンネルにつき、128バイトのキャラクタとそれぞれのキャラクタについてのエラー情報128バイト、合計256バイトの受信バッファ
2. フラグと変数の保存
3. 通信パラメータの保存

4. ポートアドレス
　マルチチャンネルRS-232Cをサポートするためには、アドレスの衝突を防ぐために全てのポートはメモリ上に置かなければなりません。しかし、シングルチャンネルRS-232CのI/Oポートを直接アクセスしているアプリケーションソフトウェアを救済するために、最初の1チャンネルはI/Oポートに接続して下さい。また、この仕様については、システムソフトウェアでコントロールが可能でなければなりません。

　　表7.6 マルチチャンネルタイプのメモリアドレス

これはチャンネル0のメモリアドレスです。各チャンネルの最下位アドレスは以下の通りです。

チャンネルは連続し、0から始まらなければなりません。

　　表7.7 チャンネル配置の例

　チャンネル0は特別なチャンネルで、I/Oポートのイネーブルビット(BFFAHのビット4)を持っています。そのビットが1の時、チャンネル0はI/Oポートを通してアクセスできます。これはシングルチャンネルのRS-232Cインターフェイスとの互換性を保つためです。
　システムソフトウェアはまず、I/OにRS-232Cインターフェイスが接続されているかどうかを調べます。接続されていなければ、BFFAHのビット4に1をセットし、チャンネル0をI/Oに接続します。これにより、I/Oポートを直接アクセスしているアプリケーションソフトウェアでもマルチチャンネルのRS-232Cで動作可能になります。
　I/Oポートの82Hは、ビット4以外はBFFAHと同じです。アプリケーションが誤ってビットを反転し、RS-232Cがアクセス不可能にならないよう、このビットはI/Oポートからはアクセスできません。
　メモリのBFFBH(I/Oの83H)番地は、システム用に予約されています。

5. アドレスマップ

図7.2 アドレスマップ

6. BFFAH(メモリ)、82H(I/O)番地ビット割り当て

　　表7.8　マルチチャンネルタイプのシステムステータス

　　表7.9　マルチチャンネルタイプの割り込みマスクレジスタ

7. 8253を使用した8251へのボーレートクロック発生

1.水晶発振器　発信周波数 1.8432MHz

　　表7.10 マルチチャンネルタイプのボーレートとスケールファクタ

2.使用するカウンタチャンネル

8. DSUB25コネクタのピン配列

　　表7.11 DSUB25コネクタのピン配列

 1.2 拡張BASIC

1.2.1 概要

　MS RS-232Cには、各機能を簡単に使用できるように、MSX RS-232C拡張BASICが用意されています。コマンド、ステートメント、関数はMSX-BASIC、MSX Disk BASICとおなじですが、書式や指定方法の違いにより、RS-232C通信が行えるように機能が拡張されています。
　使い方は、CALL COMINIのように拡張ステートメントの形式です。CALLは_(アンダーバー)で代用できます。
　デバイス番号は、スロット番号の小さいスロットにさしこまれている通信用カートリッジの順に、0から割り当てられます。モデムカートリッジなど、MSX RS-232C以外の通信用カートリッジといっしょに使用された場合にも、同様にスロット順に0から割り当てられます。
　通信用カートリッジには、RS-232Cインターフェイス、MODEMカートリッジ、「MSX-SERIAL232」などがあります。

1.2.2 この章の表記法

1.2.3 拡張BASICコマンド一覧

1.拡張ステートメント(CALL文と共に使用します)

2.コマンド

3.ステートメント

4.関数

1.2.4 拡張BASICの解説

CALL COMBREAK

　ブレーク信号を送信します。

　CALL COMBREAK[("デバイス番号:"],式)]

　SD（送信データ）を強制的にブレーク状態にします。ブレーク状態とは回線が切断状態になることです。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。省略するときはコロン（:）まで省略します。

　式
　数値定数、変数、配列変数、式で指定します。指定できる範囲は3から32767までの値です。式の値は次のように計算します。

　省略した場合は、10になります。

　CALL COMBREAK(,480)
　もしくは
　CALL COMBREAK("0:",480)
　CALL COMINIにおいて以下のように設定した場合にデバイス番号0に対して、ブレーク信号を500m秒送信します。

CALL COMDTR

　DTR（ER）信号をON/OFFします。

　CALL COMDTR[("デバイス番号:"],式)]

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。省略するときはコロン（:）まで省略します。

　式
　0と1の値で指定します。

　CALL COMDTR(,0)
　もしくは
　CALL COMDTR("0:",0)
　デバイス番号0のDTR（ER）信号をOFFにします。

CALL COM GOSUB

　RS-232Cからの割り込み処理サブルーチンの開始行を指定します。

　CALL COM(["デバイス番号:"],GOSUB 行番号)

　RS-232Cから割り込みがかかると、指定されたサブルーチンが実行されます。
　CALL COMON文を使って割り込みを許可してからデータが受信されると、実行中の文の実行が終わってからサブルーチンが実行されます。サブルーチンはRETURN文で終了します。サブルーチンの実行終了後は、割り込みがかかった時点で、実行していたステートメントの次のステートメントに実行が戻ります。
　割り込み処理サブルーチンの実行中は、自動的にCOMSTOPとなり、COMOFFしないかぎり、RETURN文によってCOMON状態になります。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。省略するときはコロン（:）まで省略します。

　行番号'
　0から65529までの整数型定数で指定します。

　CALL COM(, GOSUB 10000)
　もしくは
　CALL COM("0:", GOSUB 10000)
　デバイス番号0から割り込みがかかると行番号10000にGOSUBします。

CALL COMHELP

　COMINIのパラメータの指定方法がヘルプメッセージとして出力します。

　CALL COMHELP[("デバイス番号:")]

　次のようにメッセージを送信します。

　Initialize statement options

　CALL COMINI("
　<device # {0,1,2,...9}>:
　<character length {5,6,7,8}>
　<parity {E,O,I,N}>
　<stop bits {1,2,3}>
　<XON/XOFF {X,N}>
　<CTS hand-shake {H,N}>
　<auto LF on recieve {A,N}>
　<auto LF on transmit {A,N}>
　<SI/SO {S,N}>
　,<receive baud rate>
　,<transmitter baud rate>
　,<time out count>
　Default:
　CALL COMINI("0:8N1XHNNN"
　　　　　　,1200,1200,0)

CALL COMINI

　通信機能の初期設定をします。

　CALL COMINI[("[デバイス番号:][デバイス番号:][キャラクタ長[パリティ[ストップビット長[XON/XOFF制御[ダミー[受信LF[送信LF[SI/SO制御]]]]]]]]")[,[受信速度][,[送信速度],[タイムアウト]]]])]

　通信機能の初期設定をします。指定する文字は大文字でも小文字でもかまいません。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9までの整数値を指定します。省略するときはコロン（:）まで省略します。

　キャラクタ長
　接続する機種に合わせて送信する1キャラクタのビット数を指定します。

　パリティ
　パリティチェックの方法を指定します。

　ストップビット長
　ストップビットのビット数を指定します。

　XON/XOFF制御
　XON/XOFFによるフロー制御を行うかどうかを指定します。

　RS/CS制御
　受信バッファの空き領域が少なくなったときに、RSをOFFして相手側からの送信を中断させ、バッファが空くと、RSをONして送信を再開させます。CSがOFFだと、相手への送信を中断して、CSがONになると送信を再開します。

　受信LF挿入
　CR(0DH)コードを受信したときに、CRコードとLF(0AH)コードに変換する制御です。

　送信LF削除
　CR(0DH)コードの次にLF(0AH)コードを続けて送信するとき、LFコードを削除して、CRコードのみを送信する制御です。

　SI/SO制御
　キャラクタ長が7ビットのときに、0A1Hコードから0FEHコードを送受信するときの制御を指定します。SI（0EH）コードによりG0集合を呼び出し、SO（0FH）コードによりG1集合を呼び出します。*1
　G0集合とは21Hコードから7EHコードまでの集合を、G1集合とは0A1Hコードから0FEHコードまでの集合を指します。

　受信速度
　データ受信速度を設定します。単位はビット/秒です。
　50、75、110、300、600、1200(*)、1800、2000、2400、3600、4800、7200、9600、19200

　送信速度
　データ送信速度を設定します。指定できる速度および指定方法はデータ受信速度と同じです。ただし、送信速度と送信タイムアウトをカンマ(,)まで含めて省略すると、送信速度は受信速度と同じになります。

　送信タイムアウト
　データを送信するときに、
　　XOFFコードを受信している
　　CSがOFFのためデータが送信できない
　などの場合の待ち時間を指定します。単位は約1秒です。タイムアウトした場合には送信を注視して、
　　Device I/O error
　というエラーメッセージを表示します。両略した場合や、0を指定した場合はタイムアウトしません。指定できるのは、0〜25の整数値です。

• 1 SI/SO制御を行うときは＆H80〜&H9Fのコードは送信しないで下さい。コントロールコード（&H00〜&H1F）に変換されて送信されるため、正常な更新が行われなくなる場合があります。

　CALL COMINI("0:8N1XHNNN",9600,,3)
　この例は、RS-232Cを以下のように設定します。

　CALL COMINI("7E3NNAAS")
　この例は、RS-232Cを以下のように設定します。

CALL COMOFF

　RS-232からの割り込みを禁止します。

　CALL COMOFF[("デバイス番号:")]

　CALL COMOFF文を実行後、RS-232Cにデータが来ても、割り込みは発生しません。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。省略するときはカッコごと省略します。

　CALL COMOFF
　もしくは
　CALL COMOFF("0:")
　デバイス番号0をCOMOFFします。

CALL COMON

　RS-232からの割り込みを許可します。

　CALL COMON[("デバイス番号:")]

　CALL COMON文を実行後、RS-232Cにデータが来ると、COM GOSUB文で指定してある行番号が実行されます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。省略するときはカッコごと省略します。

　CALL COMON
　もしくは
　CALL COMON("0:")
　デバイス番号0をCOMONします。

CALL COMSTAT

　RS-232Cのステータスを求めます。

　CALL COMSTAT(["デバイス番号:"],数値変数)

　RS-232Cのステータスを数値変数に代入します。
　ステータスは数値変数値の下位16ビットが1か0かで示します。

　CALL COMSTAT(,F):PRINT BIN$(F)
　もしくは
　CALL COMSTAT("0:",F):PRINT BIN$(F)
　デバイス番号0のステータスを数値変数Fに代入して、画面に2進数表示をします。

CALL COMSTOP

　RS-232Cからの割り込みを保留します。

　CALL COMSTOP[("デバイス番号:")]

　CALL COMSTOP文を実行後、RS-232Cにデータが来ても、CALL COMONが実行されるまで割り込みは保留されます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。省略するときはコロン（:）まで省略します。

　CALL COMSTOP
　もしくは
　CALL COMSTOP("0:")
　デバイス番号0をCOMSTOPします。

CALL COMTERM

　ターミナルモードにします。

　CALL COMTERM[("[デバイス番号:]")]

　コンピュータをターミナルモードにします。ターミナルモードとは、MSXをホストコンピュータの入出力端末として使用するモードです。ターミナルモードでは、MSXはホストコンピュータから受信したデータをディスプレイに表示します。そして、キーボードから入力されたデータを、ホストコンピュータに送信します。

1.ターミナルモードの起動
　1.接続する機器の仕様を確認する
　2.CALL COMINI命令による初期設定を行う
　3.CALL COMTERM命令で内蔵ターミナルソフトを起動する

　RS-232CポートをOPENしている場合には、CLOSEしてからCALL COMTERM命令を実行してください。

2.ターミナルモードの使用方法
　ターミナルモードでは、以下のキーを使って、オプション機能を設定できます。

表7.12　ターミナルモードのオプション機能一覧

　1.リテラルモード
　　SHIFT+F1でON、OFFを切り換えます。
　　SHIFT＋F1を押すと、リテラルモードがONになります。ONの時には、コントロールコード（&H1F以下のコード）はハットマーク（^）とコントロールコードに40Hを足したコードの2文字で画面に表示されます。例えば＆H01なら
　　　^A
　　と表示されます。
　　XON・OFF制御を指定しているときは、XONとXOFFコードは表示されません。
　　もう一度、SHIFT+F1を押すと、リテラルモードはOFFになります。

　2.ローカルエコーバック
　　SHIFT+F2でON、OFFを切り換えます。
　　SHIFT+F2を押すと、エコーバックがONになります。
　　ONの時には、キー入力した文字を送信すると同時に画面にも表示（エコーバック）します。
　　もう一度、SHIFT+F2を押すと、エコーバックはOFFになります。

　3.プリンタエコーバック
　　SHIFT+F3でON/OFFを切り換えます。
　　SHIFT+F3を押すと、プリンタへのエコーバックがONになります。ONの時には、画面に出力したデータをプリンタにも出力します。
　　もう一度、SHIFT+F3を押すと、プリンタへのエコーバックはOFFになります。

　4.ブレーク信号の送信
　　STOPキーを押してる間、ブレーク信号が送信されます。ブレーク信号とは、データ信号線（SD）がOFFになる状態です。

　5.ターミナルモードの終了
　　CTRL＋STOPキーを押すとターミナルモードは終了します。
　　ターミナルモードでは、
　　　F6　　リテラルモードのON/OFF
　　　F7　　エコーバックのON/OFF
　　　F8　　プリンタエコーのON/OFF
　　となり、その機能の略号が画面に表示されます。そのほかのファンクションキーは、画面に表示されているファンクションキーの内容をそのまま送信します。

　　MSXでは、画面表示の際に、DELコードとBS（バックスペース）コードは同じ扱いをします。ホストコンピュータと接続した場合、ホストコンピュータによっては、行の先頭にDELコードを送信するものがあり、画面表示が乱れることがあります。その場合、ホストコンピュータがDELコードを送信しないように設定する必要があります。DELコードの送信を止めることができないホストコンピュータと更新する場合は、ターミナルモードは使用できません。データの交信を行うプログラムを作成して、そこでDELコードの処理をしてください。

3.ターミナルモードの例
　call comini
　Ok
　call comterm
　この例は、RS-232Cを以下のように設定して、内蔵のターミナルソフトを起動する例です。

　設定の意味は、COMINIの項をご参照下さい。

4.エスケープシーケンス
　RS-232Cの内蔵ターミナルソフトがサポートするエスケープシーケンスは以下の通りです。

カーソル移動

編集・削除

その他

LOAD

　プログラムを受信します。

　LOAD　"COM[デバイス番号]:"[,R]

　RS-232CからASCII形式のBASICプログラムをロードします。EOF（＆H1A）コードを受信するとロードを終了します。ロードする前のプログラムは消え、Rオプションを指定していなかった場合、開いているファイルは閉じられます。通信誤りが検出された場合、

　　　　Device I/O error

　のエラーメッセージが表示されます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。

　Rオプション
　ロード終了後に、プログラムが実行されます。開いているファイルは閉じません。

　LOAD "COM:"
　デバイス番号0からASCII形式のBASICプログラムをロードします。

MERGE

　プログラムを受信してメモリ上のプログラムとマージ混合します。

　MERGE "COM[デバイス番号]:"

　RS-232CからASCII形式のBASICプログラムをロードします。このときロードする前のプログラムは消去されずに、ロードされたプログラムと合併されます。EOF（＆H1A）コードを受信すると、ロードを終了します。ロードする前のプログラムと同じ行番号がある場合は、ロードされたプログラムの行が残ります。通信誤りが検出された場合、

　　　　Device I/O error

　のエラーメッセージが表示されます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。

　MERGE "COM:"
　デバイス番号0からASCII形式のBASICプログラムをロードしてマージします。

RUN

　プログラムを受信した後に実行を開始します。

　RUN "COM[デバイス番号]:"[,R]

　RS-232CからASCII形式のBASICプログラムをロードして実行します。EOF（＆H1A）コードを受信するとロードを終了します。ロードする前のプログラムは消去され、Rオプションを指定していなかった場合、開いているファイルは閉じられます。通信誤りが検出された場合、

　　　　Device I/O error

　のエラーメッセージが表示されます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。

　Rオプション
　ロード終了後に、プログラムが実行されます。開いているファイルは閉じません。

　RUN "COM:"
　デバイス番号0からASCII形式のBASICプログラムをロードして実行します。

SAVE

　プログラムを送信します。

　SAVE "COM[デバイス番号]:"

　RS-232CにASCII形式のBASICプログラムを送出します。通信誤りが検出された場合、

　　　　Device I/O error

　のエラーメッセージが表示されます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。

　SAVE "COM:"
　デバイス番号0からASCII形式のBASICプログラムを送出します。

CLOSE

　RS-232C用ファイルをクローズします。

　CLOSE [[#]ファイル番号[,[#]ファイル番号]...]

　OPEN文でオープンされたファイル番号をクローズします。クローズしたファイル番号は、次にオープンするとき使用できます。ファイルが送信モードでオープンされている場合には、クローズするとEOFコードが送信されます。RUN、END、CLEAR、NEWなどのコマンドを実行した場合も、クローズされます。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。省略すると全てのファイル番号がクローズされます。

　CLOSE #1,#2
　ファイル番号1と2をクローズします。
　CLOSE
　全てのファイル番号をクローズします。

INPUT#

　数値や文字を受信して変数に代入します。

　INPUT #ファイル番号,変数[,変数]...

　RS-232Cからデータを受信して、変数に代入します。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　変数
　整数型定数、文字型変数、数値型配列変数、文字型配列変数を使用できます。
　LINE INPUT#とは以下の点が異なります。

　10 OPEN "COM:" FOR INPUT AS #1
　20 IF EOF(1) THEN GOTO 50
　30 INPUT #1,A$:PRINT A$
　40 GOTO 20
　50 CLOSE #1
　60 END

　ファイル番号1からデータを取得して文字型変数A$に代入して表示します。

LINE INPUT#

　254文字までの文字を受信して文字型変数に代入します。

　LINE INPUT #ファイル番号,変数

　RS-232CからCRコードまでの文字列データを取得して、文字型変数に代入します。
　INPUT#文と異なり、データの区切りはCRコードのみ有効です。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　変数
　文字型変数、文字型配列変数を使用できます。

　10 OPEN "COM:" FOR INPUT AS #1
　20 IF EOF(1) THEN GOTO 60
　30 LINE INPUT #1,A$
　40 PRINT A$
　50 GOTO 20
　60 CLOSE #1
　70 END

　ファイル番号1からデータを取得して文字型変数A$に代入して表示します。

OPEN

　RS-232C用ファイルをオープンします。

　OPEN "COM[デバイス番号]:"[FORモード] AS [#]ファイル番号

　RS-232Cでデータの送受信をする前に、RS-232C用のファイルをオープンして、ファイル番号を割り当てます。

　デバイス番号
　設定の対象となるカートリッジを0(*)〜9の整数値で指定します。

　モード
　OPEN時のモードを指定します。

　　OUTPUT　送信モード
　　出力用に使用します。CLOSEするときに、EOF(&H1A)コードが送信されます。

　　INPUT　受信モード
　　入力用に使用します。EOF(&H1A)コードを受信すると、それ以降のデータを受信することはできなくなりますから、必要な場合は、一度クローズして、オープンしなおしてください。EOFコードを受信したかどうかは、EOF関数で判ります。EOFコードは取得できません。

　　省略したとき　送受信モード
　　CLOSEしてもEOFコードは送信されません。また、EOF(1AH)コードを受信しても、そのまま渡されます。EOF関数では必ず0を返します。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。すでにオープンしているファイル番号を使用することはできません。

　OPEN "COM:" FOR OUTPUT AS #1
　デバイス番号0を送信モードでファイル番号1としてオープンします。

PRINT#

　数値や文字を送信します。

　PRINT #ファイル番号,[式[セパレータ 式]...]

　式で指定したデータをRS-232C用へ送信します。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　式
　文字型、数値型の定数、変数、配列変数、式などが使用できます。

　　　■数値
　　　　最初に1個の空白（数値が正のとき）かマイナス符号が送信され、次に数字が文字列に変換され、最後に1個が出力されます。
　　　■文字列
　　　　文字列が文字数だけ出力されます。

　セパレータ
　カンマ(,)とセミコロン(;)を使用できます。省略した場合には、CRコードとLFコードが出力されます。

　　　■カンマ(,)
　　　　次のタブ位置までスペースを入れる。
　　　■セミコロン(;)
　　　　何も出力せず、直後に次のデータを出力する。

　10 OPEN "COM:" FOR OUTPUT AS #1
　20 A$="ABC":B$="DEF"
　30 PRINT #1,A$,B$
　40 PRINT #1,A$,B$
　50 PRINT #1,+50,-50
　60 CLOSE
　70 END

　ファイル番号1に文字型変数の内容および数値型定数を送信します。実行結果は次のようになります。

　ABC　　　　　DEF
　ABCDEF
　50　　　　　　-50

PRINT # USING

　書式付きPRINT＃

　PRINT＃ファイル番号、USING 書式記号;　式[,式]…

　式で指定したデータを指定した書式で、RS-232Cへ送信します。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　書式記号
　■文字列を編集するもの。

　書式の中にこれらの記号以外の文字を置くと、文字の位置に応じて数値の前や後ろにその文字が表示されます。

　式
　文字型、数値型の定数、変数、配列変数、式などが使用できます。

　10 A$="MSX-RS232C"
　20 OPEN "COM:" FOR OUTPUT AS #1
　30 PRINT #1,USING "":A$
　40 L=LEN(A$):IF L=1 THEN GOTO 70
　50 A$=RIGHT$(A$,L-1)
　60 GOTO 30
　70 CLOSE #1
　80 END

　ファイル番号1に文字型変数A$の文字列から左側1文字ずつを送信します。

　M
　S
　X
　-
　R
　S
　2
　3
　2
　C

EOF

　EOFコード（&H1A）が受信されたかどうかを求めます。

　EOF(ファイル番号)

　EOF（＆H1A）コードが受信され、それ以前のデータ全てをINPUT$などにより読み込まれた場合は-1を、それ以外なら0を返します。送受信モードでオープンした場合には必ず0が返ります。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　IF EOF(1) THEN CLOSE#1
　ファイル番号1の最後のデータが読み取られたら、そのファイルを閉じます。

INPUT$

　指定した数の文字を受信します。

　INPUT$(文字数,[#]ファイル番号)

　RS-232Cから指定した数の文字を受信します。

　文字数
　1から255までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　10 OPEN "COM:" FOR INPUT AS #1
　20 IF LOC(1)>=50 THEN X$=INPUT$(50,#1) ELSE GOTO 20
　30 PRINT X$
　40 GOTO 20

　ファイル番号1から50文字を文字型変数X$に代入して表示します。

LOC

　受信バッファの未取得文字数を求めます。

　LOC(ファイル番号)

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　10 OPEN "COM:" FOR INPUT AS #1
　20 IF LOC(1)>=1 THEN X$=INPUT$(1,#1) ELSE GOTO 50
　30 PRINT X$
　40 GOTO 20
　50 IF EOF(1) THEN CLOSE #1 ELSE GOTO 20
　60 END

　ファイル番号1から未取得文字数を求めて1文字を文字列型変数X$に代入して表示します。

LOF

　受信バッファの残りバイト数を求めます。

　LOF(ファイル番号)

　ファイル番号
　1からMAXFILES文で指定された数までの整数値を指定できます。整数型定数、変数、配列変数、式などを使用できます。OPEN文で受信用もしくは送受信用にオープンしたファイル番号を指定します。

　10 X0$=CHR$(&H11):X1$=CHR$(&H13)
　20 CALL COMINI("0:8N1NNNN",300,,0)
　30 OPEN "COM:" AS #1
　40 IF LOC(1)=12 THEN X$=INPUT$(1,#1) ELSE GOTO 40
　50 PRINT X$
　60 IF LOF(1)<=32 THEN PRINT #1,X1$
　70 IF LOF(1)>=120 THEN PRINT #1,X0$
　80 GOTO 40

　ファイル番号1の受信バッファの残りバイト数を求めて、32バイト以下になったらXOFFを送信し、120バイト以上になったらXONを送信します。

 1.3 拡張BIOS

1.3.1 概要

　MSX RS-232Cでは、アプリケーションソフトウェア用のサービスルーチンとして、拡張BIOSコールが用意されています。拡張BIOSコールにより、アプリケーションソフトウェアはそのスロットアドレスやアドレスなどの位置を調べ、インタースロットコール等により、ジャンプテーブルを経由して呼び出します。
　高速処理を必要とする場合は、あらかじめスロットをイネーブルしておき、直接コールすることもできます。この章では、MSX RS-232C拡張BIOSを使用するのに必要な、拡張BIOSコールの方法と各BIOSの機能について解説します。

1.3.2 拡張BIOSの呼び出し

1.ジャンプテーブルアドレスの取得
　アプリケーションは、まず以下の拡張BIOSコールにより、MSX RS-232C拡張BIOSの存在するスロットとジャンプテーブルの先頭アドレスを調べなければなりません。
　拡張BIOSの存在するスロットとジャンプテーブルの先頭アドレスは、以下のようにして求めます。

1. RETURN情報エリア用のワークエリア(64バイト)をとる
2. 以下の設定を行い、FFCAH番地をコールする

RAMのスロットアドレスは以下のワークエリアに保存されています。このワークエリアはディスクが接続されているシステムで有効です。

表7.13 RAMのスロットアドレス

RETURN情報はアプリケーションが指定した領域に次のように格納されます。

図7.3 RETURN情報の形式

RS-232Cが無いときは、BレジスタとHLレジスタの内容が変わらずに返ってきます。
スロットアドレスの表現はMSX共通で以下の通りです。

図7.4 スロットアドレスの形式

　拡張BIOSを使用する場合は、この拡張BIOSコールで得られたジャンプテーブルをインタースロットコールなどにより呼び出し、目的のBIOSを使用します。

2.BIOSジャンプテーブル
　MSX RS-232C拡張BIOSは以下に示すジャンプテーブルを持っています。アプリケーションソフトウェアはインタースロットコール等で各エントリを呼び出すことにより、BIOSの各機能を利用できます。

EXBTBL:  DEFB    DVINFB    ; Device information
         DEFB    DVTYPE    ; Device type
         DEFB    0         ; Reserved
         JP      INIT      ; Initialize RS-232C port
         JP      OPEN      ; Open RS-232C port
         JP      STAT      ; Read status
         JP      GETCHR    ; Receive data
         JP      SNDCHR    ; Send data
         JP      CLOSE     ; Close RS-232C port
         JP      LOC       ; Reports the number of characters
                           ; in the receiver buffer
         JP      LOF       ; Reports the number of free spaces
                           ; left in the receiver buffer
         JP      BACKUP    ; Back up a character
         JP      SNDBRK    ; Send break character
         JP      DTR       ; Trun DTR(ER) line on/off
                           ; (multi type only)
         RET               ; Reserved for MODEM cartridge
         RET               ; Reserved for MODEM cartridge
         RET               ; Reserved for MODEM cartridge
         RET               ; Reserved for MODEM cartridge
         RET               ; Reserved for MODEM cartridge
         RET               ; Reserved for MODEM cartridge

DVINFB
　DVINFBは以下の構成でそのカートリッジの仕様を表します。

図7.5 DVINFBの形式

　各ビットは1でその機能があることを示し、0でないことを示します。

DVTYPE
　DVTYPEが0であればシングルチャンネルタイプのRS-232Cカートリッジです。この場合はSETCHNのエントリはありません。
　DVTYPEが0以外であればマルチチャンネルタイプのRS-232Cカートリッジです。

3.BIOSの各機能
　MSX RS-232C拡張BIOSの各機能はインタースロットコールにより呼び出されます。インタースロットコール（CALSLT）の呼び出しアドレスは001CHです。

その他のレジスタは機能により異なります。各項を参照してください。

INIT

　RS-232C拡張BIOSをイニシャライズします。

図7.6　INITパラメータテーブルの形式

　オフセット+0から+7はASCIIキャラクタ、+8から+12まではバイナリです。
　ASCIIキャラクタはすべて大文字とします。

　AF

　イニシャライズデータの意味を説明します。

キャラクタ長
　通信データのビット長を指定します。

パリティ
　データに付加するパリティの指定をします。

ストップビット
　ストップビット長を指定します。

XON/XOFF制御
　XON/XOFF制御を行うかどうかの指定します。

説明抜け

RS/CS制御
　RS/CS制御を行うかどうかの指定です。Hが指定されると、キャラクタを送信するときに、CSがチェックされます。

説明抜け

受信LF挿入
　CR（0DH）コードを受信したときにそのあとにLF（0AH）が受信されたものとみなす制御を行うかどうかの指定です。

送信LF挿入
　CR（0DH）コードを送信した直後のLF（0AH）コードは送信せずに捨てる制御を行うかどうかの指定です。

SI/SO制御
　データ長が7ビットのときに0AHコードから0FFHのコードを送受信するとき文字セットの切り換えの制御を行うかどうかの指定です。SI（0FH）コードによりG0集合を呼び出し、SO（0EH）コードによりG1集合を呼び出します。

受信/送信速度
　通信速度をビット/秒で以下の中から指定します。
　　50、75、110、300、600、1200、1800、2000、2400、3600、4800、7200、9600、19200

　なお、受信速度、送信速度はそれぞれ別に設定できます。

送信タイムアウト
　データを送信するときに、XOFFコードが受信されていたりCSがOFFだったりしてデータが送信できない場合の待ち時間を指定します。単位は秒で範囲は0から255までです。0を指定した場合はタイムアウトせずに送出できるまで待ち続けます。

　このエントリは他の機能を呼び出す前に、必ず一度は呼び出されなくてはなりません。

OPEN

　RS-232Cをオープンします。

FCBの取り方

図7.7　FCBの形式

　AF

　この機能はRS-232Cのすべての入出力処理に先立って行う必要があります。FCBエリアは9バイトのワークエリアと受信するデータの2倍の長さのバッファが必要です。
　受信データは受信データそのものと、エラー情報の2バイト構成でバッファに格納されます。子のバッファ長はCレジスタで指定されます。FCBエリアは8000H番地以上に置かなければいけません。これはRS-232Cカートリッジが割り込みによって呼び出されたときに、スロット間リード／ライトによるオーバーヘッドを避けるためにFCBエリアを直接アクセスしているためです。

STAT

　ハードウェアの状態を返します。

　なし

　bit0からbit7はLレジスタ、bit8からbit15はHレジスタ、サポートされていない機能のビットは0を返します。
　(*)のビットは読み出されるとリセットされます。

　なし

GETCHR

　受信バッファから文字を読み出します。

　なし

　なし

　このBIOSを呼び出す時は、LOCを使用して受信バッファに文字があるかどうかを調べて、文字がある場合にのみ呼び出せます。文字がない状態で呼び出したときの結果は、保証しません。

SNDCHR

　RS-232Cに文字を送出します。

　AF

　タイムアウトエラーが発生したとき、およびCTRL+STOPキーが押された場合、文字は送出しません。

CLOSE

　RS-232Cポートをクローズします。

　なし

　OPEN時にOutputモードに設定されていた場合

　OPEN時にInputモードに設定されていた場合
　なし

　AF

　FCBが解放されます。OPEN時にOUTPUTモードの指定がされていた時は、EOFコード（1AH）が送出されます。
　タイムアウトエラーが発生する可能性があるのは、このEOFコードを送出するときだけです。
　CLOSEされると、ハードウェアの受信割り込みが禁止されます。

EOF

　次の受信文字がEOFかどうかをチェックします。

　なし

　AF

LOC

　受信バッファの中にある文字数を返します。

　なし

　AF

　この機能が返す値にはバックアップされていた文字が含まれます。デバイスがInputモードでオープンされている場合にはEOF以降の文字は含まれません。ただし、この文字もバッファのスペースを必要とします。

LOF

　文字を受信バッファに戻します。これは1文字のみ可能です。

　なし

　AF

　この機能が返す値は、OPENの時に指定した受信バッファの文字数から上記LOCの値を引いた値に1を加えた（バックアップ文字の文）値です。

BACKUP

　文字を受信バッファに戻します。これは1文字のみ可能です。

　なし

　AF

SNDBRK

　指定した数のブレーク文字を送出します。

　AF、DE

DTR

　DTR（ER）をON/OFFします。

　なし

　F

SETCHN

　マルチチャンネルタイプのRS-232Cカートリッジで、制御の対象とするチャンネルを指定します。

　AF、BC

　チャンネル番号はリセット時に0に設定されます。

　ここでのチャンネル番号はBASICでのCOM0:などの番号とは異なり、マルチチャンネルRS-232Cカートリッジのポートだけに付けられた番号です。つまりシングルチャンネルタイプのRS-232Cカートリッジがマルチチャンネルタイプのものより小さいスロット番号に遭っても、チャンネル番号は0から始まります。

 1.4 サンプルプログラム

　添付のフロッピーディスクの中に、RS-232C拡張BIOSを使ったサンプルプログラムが入っています。ファイル名は、「TERMINAL.MAC」です。
　MSX-DOSからこのプログラムを起動すると、簡単なターミナルモードになります。終了するにはCTRL+STOPを押してください。
　このプログラムを作成するにはMSX-DOS TOOLSを使って、次の操作を行います。

A>m80=b:sample
No Fatal error(s)
A>l80 b:sample,b:sample/n/e
MSX-L.80  1.00 01-Apr-85 (c) 1981,1985 Microsoft
DATA    0103   0267    <  356>
XXXXX Bytes Free
[0000   0267      2]
A>