apicomm.h

USB_D12开发评估板实现USB键盘的全部源代码

/*
* 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