原创 第5节 LabWindows学习笔记(3串口)

四、RS-232 Library串口函数库

1．int OpenCom (int portNumber, char deviceName[]);

函数说明：串口开启。

int  portNumber  串口号；

char deviceName[]串口名称。

返回值：如果返回为负值表示有错误！否则成功打开！

2．int OpenComConfig(int portNumber, char deviceName[], long baudRate, int parity, int dataBits,int stopBits, int inputQueueSize, int outputQueueSize);

函数说明：开启串口，并设置参数。

int portNumber串口号；

char deviceName[]串口名称，一般为空字符串；

long baudRate波特率；

int parity奇偶校验；

int dataBits数据位数；

int stopBits停止位；

int inputQueueSize, int outputQueueSize输入输出队列最大长度。

返回值：为“0”开启成功，否则失败。

3．int CloseCom (int portNumber);

函数说明：关闭串口。

4．int ComRd (int portNumber, char buffer[], int count);

函数说明：从串口中读取count个数据存储在buffer中。

int portNumber为串口号。

返回值：返回读取的字节个数。即一般出现错误时为count。

5．int ComRdByte (int portNumber);

函数说明：从串口中读一个字节。

int portNumber为串口号。

返回值：返回的是一个整型数据，它的低8位为读到的字节。

6．int ComRdTerm (int portNumber, char buffer[], int count, int terminationByte);

函数说明：从串口中读取数据，当读到的数据与terminationByte一样时，或是读到的数据个数达到count个时，停止读。

返回值：返回读取的个数。

7．int ComToFile (int portNumber, int fileHandle, int count, int terminationByte);

函数说明：从串口中读取数据，然后将数据写入文件中。当数据个数达到count个，遇到terminationByte时或是超时或错误发生时停止读数据。

返回值：数据的个数。

8．int ComWrt (int portNumber, char buffer[], int count);

函数说明：向串口写count个字节。

返回值：写的数据个数。

9. int ComWrtByte (int portNumber, int byte);

函数说明：向串口写一个字节。写的数据虽然是整型的，但是实际写到串口中的是byte的低8位。

返回值：写的数据的个数。

10．int ComFromFile (int portNumber, int fileHandle, int count, int terminationByte);

函数说明：将文件中的数据写如串口，当数据个数达到count个，遇到terminationByte时或是超时或错误发生时停止读数据。

返回值：写的数据的个数。

11．int XModemReceive (int portNumber, char fileName[]);

函数说明：从串口中接受一个信息包，然后写到文件filename中。必须遵循Modem协议。

返回值：为负值表示错误，否则操作成功。

12．int XModemSend (int portNumber, char fileName[]);

函数说明：将文件中的数据传输到串口中。

返回值：为负值表示错误，否则操作成功。

13．int XModemConfig (int portNumber, double startDelay, int maximumNumOfRetries,double waitPeriod, int packetSize);

函数说明：Modem设置函数。

14．int SetComTime (int portNumber, double timeoutSeconds);

函数说明：设置串口的超时时间。

返回值：为负值表示错误，否则操作成功。

15．int SetXMode (int portNumber, int mode);

函数说明：在传输和接收的数据时间，启用或禁用XON / XOFF，或启用或禁用软件握手。

int portNumber串口号；

int mode选择串口的模式（“0”禁止“1”启用）；

返回值：为负值则有错误发生，否则设置成功。

16．int SetCTSMode (int portNumber, int hardwareHandshaking);

函数说明：设置硬件握手模式。

int portNumber串口号；

int hardwareHandshaking 握手方式

返回值：为负值则有错误发生，否则设置成功。

17．int FlushInQ (int portNumber);

函数说明：清空串口输入队列的数据。

返回值：为负值则有错误发生，否则清除成功

18．int FlushOutQ (int portNumber);

函数说明：清空串口输出队列的数据。

返回值：为负值则有错误发生，否则清除成功

19．int ComBreak (int portNumber, int breakTimeMsec);

函数说明：产生中断信号。

int portNumber串口号

int breakTimeMsec产生中断信号的的周期。多少毫秒产生一次。

返回值：如果没有打开串口，或设置了一个错误的参数时，函数返回一个错误。

20．int ComSetEscape (int portNumber, int escapeCode);

函数说明：设置串口扩展命令，

 int escapeCode 表示扩展函数代码

21．int GetComStat (int portNumber);

函数说明：得到串口的状态。

返回值：状态代码。如下表

22．unsigned int GetComLineStatus (int portNumber);

函数说明：得到modem控制寄存器的内容。

返回值：

23．int GetComConnectionState (int portNumber);

函数说明：得到串口的连接状况。

返回值：

 24．int GetInQLen (int portNumber);

函数说明：得到串口输入队列中的数据长度。

返回值：数据的长度。

25．int GetOutQLen (int portNumber);

函数说明：得到串口输出队列中的数据长度。

返回值：数据的长度。

26．int ReturnRS232Err (void);

函数说明：返回错误代码。

27．char *GetRS232ErrorString (int errorNum);

函数说明：安装一个同步回调函数为特定的COM端口。

int portNumber串口号

int eventMask如下表：

int notifyCount 在发送LWRS_RECEIVE事件到回调函数中时，输入队列中至少有多少个字节数。

int eventCharacter触发LWRS_RXFLAG事件时的字或字节的值。（0-255）

ComCallbackPtr callbackPtr回调函数；

 void *callbackData一个4字节的值。

返回值：

例子：

notifyCount= 50; /* Wait for at least 50 bytes in queue. */
eventChar = 10; /* Wait for LF. */
eventMask = LWRS_RXFLAG | LWRS_TXEMPTY | LWRS_RECEIVE;
InstallComCallback (portNumber, eventMask, notifyCount, eventChar, ComCallback,NULL);
/* Callback Function */
void ComCallback(int portNumber, int eventMask, void *callbackdata)
{

if(eventMask & LWRS_RXFLAG)

printf("Received specified character\n");

if(eventMask & LWRS_TXEMPTY)

printf("Transmit queue now empty\n");

if(eventMask & LWRS_RECEIVE)

printf("50 or more bytes in input queue\n");

}

29．int GetSystemComHandle (int portNumber, int *systemHandle);