/*
* CopyRight (C) 2005,江蘇盛唐電子產(chǎn)品有限公司
* All Rights Reserved.
*
* 文件名稱：APIComm.h
* 文件標(biāo)識：
* 摘    要：RS232通信類API定義頭文件
* 
* 當(dāng)前版本：1.0
* 作    者：熊剛
* 完成日期：2005年10月7日
*
* 取代版本： 
* 原作者  ：
* 完成日期：


* 修改記錄：
*  05-11  xg增加了相應(yīng)的函數(shù)
*/
#ifndef	API_COMM_H
#define API_COMM_H		

#include "..\inc\DataType.h"
#define PC_COM1 1
#define PC_COM2 2
//--------------------------------------------------------------------------------------
// 函 數(shù) 名：uchar ReadDataFromRS232(uchar SeriesComID, uchar ucReadLen, uchar *pucData)
// 用    途：從串行口讀數(shù)據(jù)
// 入口參數(shù)：uchar SeriesComID:串口號 
//                        0x01:串口1
//                        0x02:串口2
//           uchar ucReadLen  :讀長度
//           uchar *pucData   :讀回數(shù)據(jù)緩沖區(qū)
// 返    回: ucLen:實際讀數(shù)據(jù)的長度
//--------------------------------------------------------------------------------------
uchar ReadDataFromRS232(uchar SeriesComID, uchar ucReadLen, uchar *pucData);

//--------------------------------------------------------------------------------------
// 函 數(shù) 名：uchar ReadDataFromRS232(uchar SeriesComID, uchar ucReadLen, uchar *pucData)
// 用    途：從串行口讀數(shù)據(jù)
// 入口參數(shù)：uchar SeriesComID:串口號 
//                           1:串口1
//                           2:串口2
//           uchar *sucData   :寫數(shù)據(jù)緩沖區(qū)
//           uchar ucLen      :寫數(shù)據(jù)長度
// 返    回: 無
//--------------------------------------------------------------------------------------
void WriteDataToRS232(uchar SeriesComID, const uchar *sucData, uchar ucLen);


//----------------------------xg add--------------------------------------------
//介紹：向串口發(fā)送一個字節(jié)
//輸入?yún)?shù)：unsigned char	ucData	//	一個字節(jié)數(shù)據(jù)
//輸出參數(shù)：
//返回值：void
//備注：
//void SendToCom(uchar ucData);


//功能介紹：利用串口在程序中設(shè)置一個斷點
//入口參數(shù)：串口號
//出口參數(shù)：
//返回　　:接收到的字符值
//備注：
uchar  SetComBreakPoint(uchar ucSeriesComID);

//功能介紹：向串行口發(fā)送一個字符串
//入口參數(shù)：1 串口號
//			2 指向待發(fā)的字符串指針
//出口參數(shù)：無
//返回?。?無
//備注：	字符串應(yīng)以空（NULL）結(jié)尾

//功能介紹：查找串口是否收到數(shù)據(jù)
//入口參數(shù)：串口號
//出口參數(shù)：
//返回　　:接收到的字符時返回true;否則返回false;
//備注：
uchar  CheckComRI(uchar ucSeriesComID);


//功能介紹：將一個uchar　型整數(shù)通過串行口發(fā)送一個字符串
//入口參數(shù)：1 串口號
//			2 指向待發(fā)的字符串指針
//出口參數(shù)：無
//返回　：	無
//備注：	字符串應(yīng)以空（NULL）結(jié)尾
void ComShowString(uchar ucSeriesComID, const uchar *ucShowString) ;

//功能介紹：向串行口發(fā)送一個字符串
//入口參數(shù)：1 串口號
//			2 指向待發(fā)的字符串指針
//出口參數(shù)：無
//返回?。?無
//備注：	字符串應(yīng)以空（NULL）結(jié)尾，發(fā)送完成后不回車換行
void ComShowStringNoLF(uchar ucSeriesComID, const uchar *ucShowString);


//功能介紹：將一個uchar　型整數(shù)通過串行口發(fā)送
//入口參數(shù)：1 串口號
//			2 指向待發(fā)的字符變量
//出口參數(shù)：無
//返回　：	無
//備注：	
void ComShowByte(uchar ucSeriesComID, uchar ucData); 

//功能介紹：將一個uInt　型整數(shù)通過串行口發(fā)送成字符串
//入口參數(shù)：1 串口號
//			2 指向待發(fā)的整形變量
//出口參數(shù)：無
//返回?。?無
//備注：	
void ComShowWord(uchar ucSeriesComID, uint uiData);



//功能介紹：向串口輸出一個空行
//入口參數(shù)：1 串口號
//出口參數(shù)：無
//返回?。?無
//備注：	
void ComShowSpaceLine(uchar ucSeriesComID);

//===========================================================================================================
//功能: 1.將16進(jìn)制數(shù)據(jù)轉(zhuǎn)為文本，并通過串口發(fā)送
//輸入: 1.串口號
//      2.指針型,指向報文首地址
//      3.字節(jié)型,報文長度
//輸出: 無
//備注: 無
//日志: 1.2003-5-30建立(lxx)
//修改	xg
//===========================================================================================================
void ComSendText (uchar ucCom_ID, void *Buffer, uchar cArrLen);


//--------------------------add end -------------------------------------------

//===========================================================================================================
//功能: 1.將數(shù)據(jù)以printf的格式通過串口向外發(fā)送
//輸入: 1.串口號
//      2.字符串，可選變量進(jìn)行格式化輸出。
//輸出: 無
//備注: 無
//日志: 1.2006-6-25建立(熊剛)
//修改	
//===========================================================================================================
void ComPrintf(char *fmt,...);

#endif