系列文章目录

内置函数，来控制传统的串口设备，比如继电器等

前言

可能有时候遇到设备不是很多的情况下，并且对应时间精准度没有过高要求的时候，可以只控制继电器就行。

提示：以下是本篇文章正文内容，下面案例可供参考

一、控制串口

void testR232Fun(long com_num){
  byte data[2];
  int length=2;
  data[0]=1;
  data[1]=2;
  
 rs232Open(com_num);// 打开串口
 rs232Send(com_num,data,length);//发送数据
 rs232Close(com_num);//串口数据关闭
  
}

二、自定义相关的参数

RS232Configure

RS232Configure 函数说明

RS232Configure 是 CAPL 脚本中的一个函数，用于配置串行端口的通信参数。CAPL 提供了两种形式的该函数，分别支持基本和扩展的配置选项。

函数语法

形式1：

dword RS232Configure(dword port, dword baudrate, dword numberOfDataBits, dword numberOfStopBits, dword parity);

形式2：

dword RS232Configure(dword port, dword baudrate, dword numberOfDataBits, dword numberOfStopBits, dword parity, dword enableParityCheck);

函数功能

配置指定的串口参数。如果未显式配置，将使用默认参数：

• 波特率：9600
• 数据位：8
• 停止位：1
• 校验位：无校验。

注意：
如果存在过时的 .INI 配置文件，函数会优先使用 .INI 文件中的参数。

参数说明

返回值

示例代码

以下示例设置串口 1 的典型默认配置（波特率为 9600，8 数据位，1 停止位，无校验）：

if (0 != RS232Configure(1, 9600, 8, 1, 0)) {
    write("Set typical default at port 1.");
} else {
    write("Configuration failed.");
}

三、回调函数的使用

RS232OnSend

RS232OnSend 函数说明

RS232OnSend 是 CAPL 脚本中的一个回调函数，用于处理串口发送操作完成后的事件。该函数会在发送操作成功完成时被调用，允许开发者在数据发送完成后进行后续处理。

函数语法

RS232OnSend(dword port, byte buffer[], dword number);

函数功能

• 回调处理：RS232OnSend 在串口发送操作成功完成后被自动调用，用于处理发送完的数据。
• 只有在发送成功时，该函数才会被调用。如果发送过程中出现错误，则会触发 RS232OnError 函数。

参数说明

返回值

示例代码

以下是一个示例代码，演示如何使用 RS232OnSend 回调函数来处理发送操作完成后的后续任务：

char text[20] = "Hello World !";
byte block[20];
int i;
int length;
length = strlen(text) + 1;  // 计算字符串长度并加上结尾的 '\0'
for (i = 0; i < length; i++) {
    block[i] = text[i];  // 将字符串内容复制到发送缓冲区
}

// 发送数据到串口 1
if (0 != RS232Send(1, block, length)) {
    write("Written block of bytes to port 1.");
}
// 在发起发送请求的节点上
RS232OnSend(dword port, byte buffer[], dword number)
{
   // 发送完成，可以进行下一步操作
   // buffer == block, number == length
   write("Send completed. Proceeding with the next operation.");
}

RS232OnReceive

RS232OnReceive 函数说明

RS232OnReceive 是 CAPL 脚本中的一个回调函数，用于处理串口接收操作完成后的事件。该函数会在数据接收成功后被调用，从而让用户能够对接收到的数据进行处理。

函数语法

RS232OnReceive(dword port, byte buffer[], dword number);

函数功能

• 回调处理： 当指定串口成功接收到数据时触发该回调函数。
• 如果接收过程中发生错误，则会调用 RS232OnError 进行错误处理。
• 可以在多个节点上监听同一个串口，所有监听的节点都会接收到相同的数据。

参数说明

返回值

示例代码

以下示例展示了发送和接收串口数据的完整流程：

发送端节点代码

char text[20] = "Hello World !";
byte block[20];
int i;
int length;

// 准备发送数据
length = strlen(text) + 1;  // 包含字符串结束符 '\0'
for (i = 0; i < length; i++) {
    block[i] = text[i];
}

// 发送数据到串口 1
if (0 != RS232Send(1, block, length)) {
    write("Written block of bytes to port 1.");
}

接收端节点代码

// 定义接收缓冲区和缓冲区大小
byte mybuffer[100];
int mysize = 100;

// 启动接收数据操作
RS232Receive(2, mybuffer, mysize);

处理接收数据的回调

// 回调函数：当接收到数据时触发
RS232OnReceive(dword port, byte buffer[], dword number) {
    // port == 2
    // buffer == mybuffer, number <= mysize
    // 打印接收到的数据内容
    writef("Received %d bytes from port %d: %s\n", number, port, buffer);
}

注意事项

1. 数据缓冲区大小： buffer 的大小由 RS232Receive 中指定的大小决定，但 number 可能小于缓冲区大小。
2. 调用条件： 只有调用了 RS232Receive 的节点会触发 RS232OnReceive 回调。
3. 数据分片： 对于慢速连接，接收到的数据可能分多次触发 RS232OnReceive，因此要根据 number 逐步处理接收到的数据。
4. 多节点监听： 如果多个节点监听同一串口，所有节点都会收到相同的数据。

版本支持

• 版本支持： 从 CAPL 版本 7.1 开始支持。

如果有更多关于 RS232OnReceive 或其他串口操作的问题，可以随时提供具体需求，我们将进一步协助。

RS232OnError

RS232OnError 函数说明

RS232OnError 是 CAPL 脚本中的一个回调函数，用于处理串口通信过程中发生的错误。当 RS232Send 或 RS232Receive 操作失败时，该函数会被触发，以便记录错误信息或采取相应措施。

函数语法

RS232OnError(dword port, dword errorFlags);

函数功能

• 回调处理： 在串口通信发生错误时触发该回调函数。
• 错误汇总： errorFlags 参数提供了累计的错误信息，通过检查特定位来确定具体的错误原因。
• 如果错误是持续性的（例如配置不匹配导致的帧错误），仅在首次出现时触发。

参数说明

errorFlags 位标志说明

返回值

该函数没有返回值。

示例代码

以下代码展示了如何通过 RS232OnError 回调处理串口错误：

// 回调函数：处理串口通信错误
RS232OnError(dword port, dword errorFlags) {
    // 输出发生错误的串口号
    writef("Error on port %d:\n", port);

    // 根据错误标志位分析具体错误
    if (errorFlags & (1 << 0)) {
        writeLine("Send operation failed.");
    }
    if (errorFlags & (1 << 1)) {
        writeLine("Receive operation failed.");
    }
    if (errorFlags & (1 << 2)) {
        writeLine("Frame error occurred.");
    }
    if (errorFlags & (1 << 3)) {
        writeLine("Parity error detected.");
    }
    if (errorFlags & (1 << 4)) {
        writeLine("Buffer overrun at sender.");
    }
    if (errorFlags & (1 << 5)) {
        writeLine("Buffer overrun at receiver.");
    }
    if (errorFlags & (1 << 6)) {
        writeLine("Break state detected (pause requested).");
    }
    if (errorFlags & (1 << 7)) {
        writeLine("Timeout occurred.");
    }
}

注意事项

1. 错误诊断： errorFlags 中的多个位可能同时被设置，表示多个错误条件同时发生。
2. 持续性错误： 持续性的错误（例如配置不匹配）可能仅在首次出现时被触发，需特别注意这种情况。
3. 配置验证： 通常，帧错误或奇偶校验错误可能由两端通信参数（例如波特率、数据位、停止位、奇偶校验）不匹配引起。请确保通信双方参数一致。
4. 日志记录： 使用 write 或 writeLine 将错误信息记录到日志，以便调试和诊断问题。

总结