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


* 修改記錄：
*  05-11  xg增加了相應的函數
*/
#ifndef	API_COMM_H
#define API_COMM_H		

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

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


//----------------------------xg add--------------------------------------------
//介紹：向串口發送一個字節
//輸入參數：unsigned char	ucData	//	一個字節數據
//輸出參數：
//返回值：void
//備注：
//void SendToCom(uchar ucData);


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

//功能介紹：向串行口發送一個字符串
//入口參數：1 串口號
//			2 指向待發的字符串指針
//出口參數：無
//返回　：	無
//備注：	字符串應以空（NULL）結尾

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


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

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


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

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



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

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


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

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

#endif