通信パラメータの設定・・・ボーレート微調整パラメータを追加(2001/09/08)

void set_gb232( UBYTE comm_parameter, UBYTE adjust_speed );

引数として各種通信パラメータを論理和した１バイトデータとボーレート微調整パラメータを指定します。
（例）set_gb232( SPEED_9600 | DATA_8 | STOP_1 | PARITY_NONE, ADJUST_0P );

なお、Ｃ言語ソースファイルに定義ファイル"gb232.h"をインクルードしてください。
"gb232.h"には以下の通信パラメータを定義してあります。

	#define SPEED_110   0x00U	// 0000 ****
	#define SPEED_300   0x10U	// 0001 ****
	#define SPEED_600   0x20U	// 0010 ****
	#define SPEED_1200  0x30U	// 0011 ****
	#define SPEED_2400  0x40U	// 0100 ****
	#define SPEED_4800  0x50U	// 0101 ****
	#define SPEED_9600  0x60U	// 0110 ****
	#define SPEED_14400 0x70U	// 0111 ****
	#define DATA_8      0x00U	// **** 0***
	#define DATA_7      0x01U	// **** 1***
	#define STOP_1      0x00U	// **** *0**
	#define STOP_2      0x04U	// **** *1**
	#define PARITY_NONE 0x00U	// **** **00
	#define PARITY_ODD  0x03U	// **** **11
	#define PARITY_EVEN 0x02U	// **** **10
	#define ADJUST_M3P  0x00U	// adjust -3%
	#define ADJUST_0P   0x01U	// adjust 0%
	#define ADJUST_P3P  0x02U	// adjust +3%
	

通信初期化

void init_gb232();

受信バッファgRcvData[127]をクリアします。
そして、ストップビットを一回送信して、送信ラインを念のためＨｉｇｈにします。

受信処理

UWORD receive_gb232( UBYTE byte_length, UBYTE timeout_count );

引数として受信するバイト数とタイムアウト時間（0.1秒単位）を指定してください。
（例）receive_gb232( 110, 1 );
受信バイト数：110バイト、タイムアウト時間：0.1秒

戻値(16バイト)の下位バイトに以下のエラーコードを返します。上位バイトには未受信バイト数を返します。よって正常受信であれば上下位バイトとも 0x00 となります。

0x00：正常受信
0x01：タイムアウトエラー（指定した時間待ったけどスタートビットが検出されなかった）
0x02：オーバーランエラー（次のデータを読み出しする前にデータが到着してしまった）
0x03：フレーミングエラー（ストップビットが検出されなかった）
0x04：パリティエラー（付加したパリティビットによりエラーが検出された）

正常に受信されれば、gRcvData[127]に受信データが格納されています。

※受信バイト数が不明または不定の場合は、予想される最大バイト数を指定してください。受信したデータが指定したバイト数に満たない場合はタイムアウトエラーとなるので、エラー位置を調べて有効なデータを取るようにして下さい。エラー位置は、次項のサンプルソースのようにすれば調べることができます。

送信処理

void send_gb232( UBYTE send_data );

引数として１バイトの送信データを指定してください。

#include <gb.h>
#include "gb232.h"
：
#define BYTE_LENGTH    127    // 127 bytes receive
#define TIMEOUT_COUNT  1      // 0.1 msec

extern UBYTE gRcvData[127];
：
unsigned char gMsgTest[] = { "GB-232 (c)2001 TeamKNOx" };
：
void send_msg( unsigned char *msg )
{
  while ( *msg ) {
    send_gb232( *msg );
    msg++;
  }
}
：
：
void main()
{
  UWORD error_result;
  UBYTE error_code, error_byte;
：
：
  set_gb232( SPEED_9600 | DATA_8 | STOP_1 | PARITY_NONE, ADJUST_0P );
  init_gb232();
：
  send_msg( gMsgTest );
：
  error_result = receive_gb232( BYTE_LENGTH, TIMEOUT_COUNT );
  error_code = (UBYTE)(error_result % 256);
  error_byte = BYTE_LENGHT - (UBYTE)(error_result / 256) + 1;
：
：
}