LabWindowsCVI串口通信函数.doc
LabWindows/CVI串口通信函数
LabWindows/CVI提供的RS-232函数库主要包括以下几类函数:串行口翻开/关闭(Open/Close)函数,串行口输入/输出(Input/Output)函数,串行口控制(Control)函数,串行口状态查询(Status)函数和串行口事件处理(Callbacks)函数。下面分别予以介绍。
1.串行口翻开/关闭函数
1〕OpenCom函数
功能:表示以默认的参数设置方式翻开一个串口。该函数原型为:
intOpenCom(intCOM_Port,charDevice_Name[])
其中,参数COM_Port为整型变量,用于指定串口号,有效范围为1~1000;
Device_Name[]为字符型数组,是用ASCⅡ码字符串表示的串口名。
2〕OpenComConfig函数
功能:用来翻开一个串行口并进行相关的参数设置。该函数原型为:
intOpenComConfig(intCOM_Port,charDevice_Name[],longBaud_Rate,intParity,intData_Bits,intStop_Bits,intInput_Queue_Size,intOutput_Queue_Size)
其中,参数COM_Port为整型变量,用于指定串口号,有效范围为1~1000;
Device_Name[]为字符型数组,是用ASCⅡ码字符串表示的串口名。例如,以“COM1”
Baud_Rate为长整型变量,用来设置串行口的传输速率,标准的传输速率有110、300、600、1200、2400、4800、9600、19200b/s等;默认值为9600。
Parity为整型变量,用来指定奇偶校验模式。0表示无奇偶校验,1表示奇校验,2表示偶校验;
Data_Bits为整型变量,用来指定每帧信息中数据位的个数,可选5、6、7、8;
Stop_Bits为整型变量,用来指定每帧信息中停止位的个数,可选1、1.5或2;
Input_Queue_Size为整型变量,用来指定串行口输入队列的大小;
Output_Queue_Size为整型变量,用来指定串行口输出队列的大小。
3〕CloseCom函数
功能:用来关闭一个串行口。该函数原型为:
intCloseCom(intCOM_Port)
其中,参数COM_Port用于指定端口号。
2.串行口输入/输出函数
1〕ComRd函数
功能:用来从指定端口读取字符并存放到缓冲区中。该函数原型为:
intComRd(intCOM_Port,charBuffer[],intCount)
其中,参数COM_Port用于指定端口号;
Buffer[]为字符型数组,用来存放读取出的字符串;
Count为整型,表示要读取的字符串的长度。
2〕ComRdByte函数
功能:用来从指定串行口的输出队列读取一个字节的信息。该函数原型为:
intComRdByte(intCOM_Port)
其中,参数COM_Port用于指定端口号。
3〕ComWrt函数
功能:用来向指定串行口的输出队列写入假设干字节的信息。该函数原型为:
intComWrt(intCOM_Port,charBuffer[],intCount)
其中,参数Buffer[]为字符型数组,用来存放要发送的字符串;
Count为整型,表示要发送的字符串的长度。
4〕ComWrtByte函数
功能:用来向指定串行口的输出队列写一个字节的信息。该函数原型为:
intComWrtByte(intCOM_Port,intByte)
其中,参数Byte为整型,表示要发送的低位字节。
5〕ComToFile函数
功能:用来从串口的输入队列读取数据,并将数据写入一个文件中,返回成功写入文件的字节数。该函数原型为:
intComToFile(intCOM_Port,intFile_Handle,intCount,intTermination_Byte)
其中,参数File_Handle表示从Open_File得到的文件句柄;
Count表示写入文件终止的条件之一,写入count个字节数;
Termination_Byte表示写入文件终止的条件之一,遇到终止字节。
6〕ComFromFile函数
功能:读取指定文件并写入COM端口的输出队列。该函数原型为:
intComFromFile(intCOM_Port,intFile_Handle,intCount,intTermination_Byte)
其中,参数File_Handle表示文件句柄。
Count表示从指定端口所能读取的最大字节数;
Termination_Byte表示写