LabWindowsCVI串口通信函数

1、精选优质文档-倾情为你奉上LabWindows/CVI串口通信函数LabWindows/CVI提供的RS-232函数库主要包括以下几类函数：串行口打开/关闭 (Open/Close)函数，串行口输入/输出(Input/Output)函数，串行口控制(Control)函数，串行口状态查询(Status)函数和串行口事件处理(Callbacks)函数。下面分别予以介绍。1串行口打开/关闭函数1）OpenCom函数功能：表示以默认的参数设置方式打开一个串口。该函数原型为：int OpenCom (int COM_Port，char Device_Name )其中，参数COM_Port为整型变量，用于

2、指定串口号，有效范围为11000；Device_Name为字符型数组，是用ASC码字符串表示的串口名。2）OpenComConfig函数功能：用来打开一个串行口并进行相关的参数设置。该函数原型为：int OpenComConfig(int COM_Port,char Device_Name,long Baud_Rate,int Parity,int Data_Bits,int Stop_Bits,int Input_Queue_Size,int Output_Queue_Size)其中，参数COM_Port为整型变量，用于指定串口号，有效范围为11000；Device_Name为字符型数组，是

3、用ASC码字符串表示的串口名。例如，以“COM1”来代替端口1，如果输入值为NULL或一个空字符串，则以COM_Port号作为指定端口号。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_Si

4、ze为整型变量，用来指定串行口输入队列的大小；Output_Queue_Size为整型变量，用来指定串行口输出队列的大小。3）CloseCom函数功能：用来关闭一个串行口。该函数原型为：int CloseCom(int COM_Port)其中，参数COM_Port用于指定端口号。2串行口输入/输出函数1）ComRd函数功能：用来从指定端口读取字符并存放到缓冲区中。该函数原型为：int ComRd(int COM_Port，char Buffer ，int Count)其中，参数COM_Port用于指定端口号；Buffer 为字符型数组，用来存放读取出的字符串；Count为整型，表示要读取的字符

5、串的长度。2）ComRdByte函数功能：用来从指定串行口的输出队列读取一个字节的信息。该函数原型为：int ComRdByte(int COM_Port)其中，参数COM_Port用于指定端口号。3）ComWrt函数功能：用来向指定串行口的输出队列写入若干字节的信息。该函数原型为：int ComWrt (int COM_Port，char Buffer ，int Count)其中，参数Buffer 为字符型数组，用来存放要发送的字符串；Count为整型，表示要发送的字符串的长度。4）ComWrtByte函数功能：用来向指定串行口的输出队列写一个字节的信息。该函数原型为：int ComWrtB

6、yte(int COM_Port，int Byte)其中，参数Byte为整型，表示要发送的低位字节。5）ComToFile函数功能：用来从串口的输入队列读取数据，并将数据写入一个文件中，返回成功写入文件的字节数。该函数原型为：int ComToFile(int COM_Port，int File_Handle，int Count，int Termination_Byte)其中，参数File_Handle表示从Open_File得到的文件句柄；Count表示写入文件终止的条件之一，写入count个字节数；Termination_Byte表示写入文件终止的条件之一，遇到终止字节。6）ComFrom

7、File函数功能：读取指定文件并写入COM端口的输出队列。该函数原型为：int ComFromFile(int COM_Port，int File_Handle，int Count，int Termination_Byte)其中，参数File_Handle表示文件句柄。Count表示从指定端口所能读取的最大字节数；Termination_Byte表示写入文件终止的条件之一，遇到终止字节。7）ComRdTerm函数功能：用来从串行口读取数据，直到遇到终止条件为止。该函数原型为：int ComRdTerm (int COM_Port，char Buffer ，int Count，int Termi

8、nation_Byte)参数说明同上。3串行口控制函数1）FlushInQ函数功能：用来清空指定串行口的输入队列字符。该函数原型为：int FlushInQ(int COM_Port)2）FlushOutQ函数功能：用来清空指定串行口的输出队列。该函数原型为：int FlushOutQ(int COMPort)3）SetComTime函数功能：用来设置串行口输入/输出操作的时间限制，超过设定时间，提示出错信息，终止当前操作。该函数原型为：int SetComTime(int COM_Port，double Timeout_Seconds)其中，参数timeoutSeconds表示限制时间。4）

9、SetXMode函数功能：表示是否允许软件握手。默认情况下为禁止软件握手。如果串口没有打开或者输入无效参数，则会返回一个错误。函数原型为：int SetXMode (int COM_Port,int Mode);其中，参数Mode的默认值为0，禁止软件握手；1表示允许软件握手。5）SetCTSMode函数功能：表示是否允许硬件握手。默认情况为禁止硬件握手。函数原型为：int SetCTSMode(int COM_Port,int Hardware_Handshanking)其中，参数Hardware_Handshanking为硬件握手模式。有三种模式，0为禁止硬件握手，忽略CTS信号，RTS和

10、DTR信号高电平有效；2为允许硬件握手，CTS控制发送，RTS为握手信号，DTR为高电平。6）ComBreak函数功能：生成中断信号。函数原型为：int ComBreak(int COM_Port,int Break_Time_msec);其中，参数Break_Time_msec表示中断信号持续的时间。7）ComSetEscape函数功能：设置串口扩展命令。函数原型为：int ComSetEscape(int COM_Port,int Escape_Code);其中，参数Escape_Code表示扩展函数代码。4串行口状态查询函数1）GetInQLen函数：功能：用来获取指定串行口输入队列内的

11、字符数。该函数原型为：int GetInQLen (int COM_Port)2）GetOutQLen函数功能：用来获取指定串行口输出队列内的字符数。该函数原型为：int GetOutQLen (int COM_Port)3）GetComStat函数功能：用来返回串行口的状态信息，如果小于0，则表明串行口工作不正常。该函数原型为：int GetComStat (int COM_Port)4）ReturnRS232Err函数功能：返回错误代码。该函数原型为：int ReturnRS232Err (int COM_Port)5串行口事件处理函数InstallComCallback函数：功能：用来为

12、指定串行口设置一个回调函数。该函数原型为：int InstallComCallback (int COM_Port，int Event_Mask，int Notify_Count，int Event_Character , ComCallbackPtr callback_Function, void *callback_Data)其中，参数Event_Mask为整型，设置回调函数可以响应的事件，如果是0，则不触发回调函数；Notify_Count为整型，指定触发回调函数接收数据的输入缓冲区的最小字节数，可以是0到整个输入队列的大小；Event_Character为整型，指定触发LWRS_RXFLAG事件的字节值，可以是0255；Callback_Function为ComCallbackPtr类型，定义回调函数；*callback_Data为空类型，表示回调数据。6调制解调文件传输函数1）XmodemReceive函数功能：表示接收端口的数据包，并将数据写入文件中。函数原型为：int XmodemReceive(int COM_Port,char File_Name);2）XmodemSend函数功能：表示读取文件数据，并将数据以包的形式发送到端口缓冲区。函数原型为：int XmodemS