Agile Modbus 简易从机接入实践

发布于 2022-08-02 13:45:02 浏览：3878 订阅该版

[tocm]

# 简易从机接入接口

## 说明

仓库：[https://github.com/loogg/agile_modbus](https://github.com/loogg/agile_modbus)

Agile Modbus 提供了 `agile_modbus_slave_callback_t` 的一种实现方式，使用户能够简单方便接入。

使用示例可查看 `examples/slave`。

使用方式：

```C

#include "agile_modbus.h"
#include "agile_modbus_slave_util.h"

const agile_modbus_slave_util_t slave_util = {
  /* User implementation */

};

agile_modbus_slave_handle(ctx, read_len, 0, agile_modbus_slave_util_callback, &slave_util, NULL);

```

- `agile_modbus_slave_util_callback` 介绍

- Agile Modbus 提供的一种 `agile_modbus_slave_callback_t` 实现方式，需要 `agile_modbus_slave_util_t` 类型变量指针作为私有数据。

- 私有数据为 NULL，所有功能码都能响应且为成功，但寄存器数据依然为 0。

- `agile_modbus_slave_util_t` 介绍

```C

typedef struct agile_modbus_slave_util {
      const agile_modbus_slave_util_map_t *tab_bits;                                            /**< 线圈寄存器定义数组 */
      int nb_bits;                                                                              /**< 线圈寄存器定义数组数目 */
      const agile_modbus_slave_util_map_t *tab_input_bits;                                      /**< 离散量输入寄存器定义数组 */
      int nb_input_bits;                                                                        /**< 离散量输入寄存器定义数组数目 */
      const agile_modbus_slave_util_map_t *tab_registers;                                       /**< 保持寄存器定义数组 */
      int nb_registers;                                                                         /**< 保持寄存器定义数组数目 */
      const agile_modbus_slave_util_map_t *tab_input_registers;                                 /**< 输入寄存器定义数组 */
      int nb_input_registers;                                                                   /**< 输入寄存器定义数组数目 */
      int (*addr_check)(agile_modbus_t *ctx, struct agile_modbus_slave_info *slave_info);       /**< 地址检查接口 */
      int (*special_function)(agile_modbus_t *ctx, struct agile_modbus_slave_info *slave_info); /**< 特殊功能码处理接口 */
      int (*done)(agile_modbus_t *ctx, struct agile_modbus_slave_info *slave_info, int ret);    /**< 处理结束接口 */
  } agile_modbus_slave_util_t;

```

- 寄存器相关

用户需要实现 `bits`、`input_bits`、`registers`、`input_registers` 定义。如果某个寄存器定义为 NULL，该寄存器对应的功能码能响应且为成功，但寄存器数据都为 0。

- 接口调用过程

![SlaveCallback.jpg](https://oss-club.rt-thread.org/uploads/20220802/47f8f74d9c3f2b6aac99c3c781763c06.jpg.webp "SlaveCallback.jpg")

- `agile_modbus_slave_util_map` 介绍

```C

typedef struct agile_modbus_slave_util_map {
      int start_addr;                                       /**< 起始地址 */
      int end_addr;                                         /**< 结束地址 */
      int (*get)(void *buf, int bufsz);                     /**< 获取寄存器数据接口 */
      int (*set)(int index, int len, void *buf, int bufsz); /**< 设置寄存器数据接口 */
  } agile_modbus_slave_util_map_t;

```

- **注意事项**:

- 起始地址和结束地址决定的寄存器个数有限制。更改函数内部 `map_buf` 数组大小可使其变大。

- bit 寄存器 < 250

- register 寄存器 < 125

- 接口函数为 NULL，寄存器对应的功能码能响应且为成功。

- `get` 接口

将地址域内的数据全部拷贝到 `buf` 中。

- `set` 接口

- `index`: 地址域内的偏移

- `len`: 长度

根据 `index` 和 `len` 修改数据。

## 示例

以 01 功能码为例：

```C

#include <stdint.h>
#include <pthread.h>
#include "agile_modbus.h"
#include "agile_modbus_slave_util.h"

static uint8_t _tab_bits[10] = {0, 1, 0, 1, 0, 1, 0, 1, 0, 1};

static int get_map_buf(void *buf, int bufsz)
{
    uint8_t *ptr = (uint8_t *)buf;

pthread_mutex_lock(&slave_mtx);
    for (int i = 0; i < sizeof(_tab_bits); i++) {
        ptr[i] = _tab_bits[i];
    }
    pthread_mutex_unlock(&slave_mtx);

return 0;
}

static int set_map_buf(int index, int len, void *buf, int bufsz)
{
    uint8_t *ptr = (uint8_t *)buf;

pthread_mutex_lock(&slave_mtx);
    for (int i = 0; i < len; i++) {
        _tab_bits[index + i] = ptr[index + i];
    }
    pthread_mutex_unlock(&slave_mtx);

return 0;
}

const agile_modbus_slave_util_map_t bit_maps[1] = {
    {0x041A, 0x0423, get_map_buf, set_map_buf}};

```