modbus_tcp_listen

`modbus_tcp_listen` 函数是 libmodbus 库中的一个函数，用于开始监听从站的连接请求。

函数原型如下：

int modbus_tcp_listen(modbus_t *ctx, int nb_connections);

参数说明：
- `ctx`：Modbus TCP 上下文。
- `nb_connections`：期望的最大连接数。

返回值：
- 成功时返回 0。
- 失败时返回 -1，并设置 `errno`。

使用该函数的示例代码如下：

#include <stdio.h>
#include <stdlib.h>
#include <modbus.h>

int main() {
    modbus_t *ctx;

    // 创建 Modbus TCP 上下文
    ctx = modbus_new_tcp("0.0.0.0", 502);
    if (ctx == NULL) {
        fprintf(stderr, "无法创建 Modbus TCP 上下文\n");
        return -1;
    }

    // 监听从站连接
    if (modbus_tcp_listen(ctx, 1) == -1) {
        fprintf(stderr, "监听从站连接失败: %s\n", modbus_strerror(errno));
        modbus_free(ctx);
        return -1;
    }

    // 等待从站连接请求

    // 断开连接并释放资源
    modbus_free(ctx);

    return 0;
}

在这个示例中，我们创建了 Modbus TCP 上下文 `ctx`，并使用 `modbus_new_tcp` 函数将其初始化为监听所有网络接口的 502 端口。

然后，我们使用 `modbus_tcp_listen` 函数开始监听从站连接。第二个参数 `nb_connections` 表示期望的最大连接数，这里我们设置为 1。

在调用 `modbus_tcp_listen` 后，程序将一直阻塞在该函数调用处，等待从站的连接请求。你可以根据实际需求在这个位置进行其他处理，比如接受从站连接、处理数据请求等。

最后，我们使用 `modbus_free` 释放 Modbus 上下文的资源。

请注意，这只是一个简单的示例，你可以根据你的实际需求进行修改和扩展，例如在接受连接后处理数据请求和响应。