ESP-IDF Modbus从站例子

支持的芯片型号 ESP32 ESP32-C2 ESP32-C3 ESP32-C6 ESP32-H2 ESP32-S2 ESP32-S3

Modbus从站例子

此示例演示了使用FreeModbus协议栈来实现ESP32作为从站设备来进行通信,
该示例允许外部 Modbus主站使用 Modbus协议读取/写入的从站设备参数, “mb_example_common/modbus_params.h”头文件中,定义了可通过Modbus协议操作的参数,用户修改该文件来添加/删除自己的自定义参数。
这些在结构“holding_reg_params”、“input_reg_params”、“coil_reg_params”和“discrete_reg_params”中表示,分别用于保存寄存器、输入参数、线圈和离散输入。
app_main应用程序演示了如何启动Modbus协议,当参数发生变化时会通知主站设备。
FreeModbus 协议栈位于“components/freemodbus”文件夹中,包含“/port”文件夹,该文件夹中包含与 ESP32 连接的堆栈端口。 可以在 KConfig 文件中配置一些端口参数,以正确启动协议栈(有关详细信息,请参阅下面的说明)。

“examples/protocols/modbus/mb_example_common”文件夹中定义从站示例使用到的参数结构。

所需硬件 :

选项1:
PC (Modbus从站应用软件) + 连接到USB端口的USB串行适配器 + RS485线路驱动器 + ESP32开发板
MAX485线路驱动器芯片在下文中作为示例,但其他类似的芯片也可以使用。

选项2:
根据其README.md文件的说明配置了modbus_master示例应用程序,并将其烧录到ESP32开发板上。
注意: 在modbus_master示例中,可以编辑“Example Data (Object) Dictionary”来处理连接到Modbus段的从站设备的参数。
RS485示例电路示意图:

         VCC ---------------+                               +--------------- VCC
                            |                               |
                    +-------x-------+               +-------x-------+
         RXD <------| RO            | DIFFERENTIAL  |             RO|-----> RXD
                    |              B|---------------|B              |
         TXD ------>| DI   MAX485   |    \  /       |    MAX485   DI|<----- TXD
ESP32 board         |               |   RS-485 side |               |    Modbus master
         RTS --+--->| DE            |    /  \       |             DE|---+
               |    |              A|---------------|A              |   |
               +----| /RE           |    PAIR       |            /RE|---+-- RTS
                    +-------x--------+              +-------x-------+
                            |                               |
                           ---                             ---

如何设置和使用示例:

配置软件

输入下面的命令开始配置:

idf.py menuconfig

选择“Modbus示例配置”菜单项。
使用以下命令和表格配置用于 Modbus 通信的 UART 引脚。

  ------------------------------------------------------------------------------------------------------------------------------
  |  UART Interface       | #define            | Default pins for      | Default pins for          | External RS485 Driver Pin |
  |                       |                    | ESP32 (C6)            | ESP32-S2 (S3, C3, C2, H2) |                           |
  | ----------------------|--------------------|-----------------------|---------------------------|---------------------------|
  | Transmit Data (TxD)   | CONFIG_MB_UART_TXD | GPIO23                | GPIO9                     | DI                        |
  | Receive Data (RxD)    | CONFIG_MB_UART_RXD | GPIO22                | GPIO8                     | RO                        |
  | Request To Send (RTS) | CONFIG_MB_UART_RTS | GPIO18                | GPIO10                    | ~RE/DE                    |
  | Ground                | n/a                | GND                   | GND                       | GND                       |
  ------------------------------------------------------------------------------------------------------------------------------

注意: 每个目标芯片都有不同的GPIO引脚可用于UART连接。有关更多信息,请参阅所选目标的UART文档。

在 Kconfig 中定义Modbus communiction mode- CONFIG_MB_COMM_MODE(对于主站和从站应用程序必须相同)。
为示例应用程序设置Modbus slave address(对于示例脚本默认设置为 1)。
FreeModbus协议栈的通信参数(Component config->Modbus configuration)允许进行适当的配置,但通常使用默认设置就足够了。
请查看参数的帮助字符串以获取更多信息。

设置外部 Modbus主站软件

选项1:
根据应用程序中使用的端口配置参数配置外部Modbus主站软件。
例如,可以使用Modbus Poll应用程序与该示例一起使用。

选项2:
设置基于ESP32的电路板,并根据其README.md文件中的说明设置modbus_master示例配置。
设置一个或多个从站电路板,具有不同的从站地址,并将它们连接到相同的Modbus段(参见上文中的配置)。
注意:主站和从站示例应用程序的Modbus communiction mode参数必须相同,以便能够相互通信。

应用编译和烧写

构建项目并烧写程序到板上,然后运行监视器工具查看串行输出:

idf.py -p PORT flash monitor

(退出串行监视器, 输入 Ctrl-].)

有关配置和使用ESP-IDF构建项目的完整步骤,请参阅《Getting Started Guide》

示例输出

应用程序的示例输出:

I (13941) SLAVE_TEST: INPUT READ (13651163 us), ADDR:1, TYPE:8, INST_ADDR:0x3ffb2fd0, SIZE:2
I (13951) SLAVE_TEST: HOLDING READ (13656431 us), ADDR:1, TYPE:2, INST_ADDR:0x3ffb2fe0, SIZE:2
I (13961) SLAVE_TEST: INPUT READ (13665877 us), ADDR:3, TYPE:8, INST_ADDR:0x3ffb2fd4, SIZE:2
I (13971) SLAVE_TEST: HOLDING READ (13676010 us), ADDR:3, TYPE:2, INST_ADDR:0x3ffb2fe4, SIZE:2
I (13981) SLAVE_TEST: INPUT READ (13686130 us), ADDR:5, TYPE:8, INST_ADDR:0x3ffb2fd8, SIZE:2
I (13991) SLAVE_TEST: HOLDING READ (13696267 us), ADDR:5, TYPE:2, INST_ADDR:0x3ffb2fe8, SIZE:2
I (14001) SLAVE_TEST: COILS READ (13706331 us), ADDR:0, TYPE:32, INST_ADDR:0x3ffb2fcc, SIZE:8
I (14001) SLAVE_TEST: Modbus controller destroyed.

输出行描述了操作类型、时间戳、Modbus地址、访问类型、参数结构中的存储地址和寄存器数量。

你可能感兴趣的:(MODBUS,从站)