简体中文
English
简体中文
日本語

Arduino 上手教程

2. 设备开发 & 案例程序

5. 拓展模块

6. 应用案例

Unit RS485-ISO Arduino 使用教程

1. 准备工作

2. 注意事项

引脚兼容性
由于每款主机的引脚配置不同,为了让用户更方便地使用,M5Stack 官方提供了引脚兼容性表,方便用户查看,请根据实际引脚连接情况修改案例程序。

3. 案例程序

  • 本案例使用 CoreS3 的 PORT.A 和 PORT.C 各连接一个 Unit RS485-ISO,并将两个 Unit 的 RS485 端子 A 对 A、B 对 B 连接。PORT.A 作为 Modbus RTU Client,PORT.C 作为 Modbus RTU Server(从站地址为 0x01)。Client 每秒向 Server 的保持寄存器 0x0000 写入一个递增值,再读取该寄存器并比较结果。

CoreS3 的 PORT.A 使用 G1 (RX)G2 (TX),PORT.C 使用 G18 (RX)G17 (TX)。Unit RS485-ISO 内部支持自动收发方向控制,因此 DE/RE 引脚均设置为 -1

cpp
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124
#include "M5Unified.h"
#include <Wire.h>
#include <ArduinoModbus.h>
#include <ArduinoRS485.h>

constexpr uint32_t MODBUS_BAUDRATE = 115200;
constexpr uint8_t SERVER_ID        = 0x01;
constexpr uint16_t REGISTER_ADDR   = 0x0000;

constexpr int PORT_A_RX_PIN = 1;
constexpr int PORT_A_TX_PIN = 2;
constexpr int PORT_C_RX_PIN = 18;
constexpr int PORT_C_TX_PIN = 17;

// PORT.A uses Serial2 as the Modbus RTU Client interface.
RS485Class RS485(Serial2, PORT_A_RX_PIN, PORT_A_TX_PIN, -1, -1);

// PORT.C uses Serial1 as the Modbus RTU Server interface.
RS485Class RS485PortC(Serial1, PORT_C_RX_PIN, PORT_C_TX_PIN, -1, -1);

ModbusRTUClientClass portAClient(RS485);
ModbusRTUServerClass portCServer(RS485PortC);

uint16_t transmitValue = 0;

void modbusServerTask(void *parameter);
void showResult(uint16_t sentValue, long receivedValue);
void haltWithError(const char *message);

void setup()
{
    M5.begin();
    Serial.begin(115200);
    delay(2000);

    M5.Display.setFont(&fonts::FreeMonoBold12pt7b);
    M5.Display.setTextColor(TFT_WHITE, TFT_BLACK);
    M5.Display.clear();
    M5.Display.println("RS485 initializing");

    // Release PORT.A from I2C before using its pins for Serial2.
    Wire.end();

    if (!portCServer.begin(SERVER_ID, MODBUS_BAUDRATE, SERIAL_8N1)) {
        haltWithError("Server init failed");
    }

    if (!portCServer.configureHoldingRegisters(REGISTER_ADDR, 1)) {
        haltWithError("Register init failed");
    }
    portCServer.holdingRegisterWrite(REGISTER_ADDR, 0);

    if (xTaskCreatePinnedToCore(modbusServerTask, "modbus-server", 4096,
                                nullptr, 2, nullptr, 0) != pdPASS) {
        haltWithError("Server task failed");
    }

    if (!portAClient.begin(MODBUS_BAUDRATE, SERIAL_8N1)) {
        haltWithError("Client init failed");
    }
    portAClient.setTimeout(500);

    Serial.println("PORT.A Client and PORT.C Server started");
    delay(100);
}

void loop()
{
    ++transmitValue;

    bool writeSuccess = portAClient.holdingRegisterWrite(
        SERVER_ID, REGISTER_ADDR, transmitValue);

    long receivedValue = -1;
    if (writeSuccess) {
        receivedValue = portAClient.holdingRegisterRead(
            SERVER_ID, REGISTER_ADDR);
    }

    showResult(transmitValue, receivedValue);
    delay(1000);
}

void modbusServerTask(void *parameter)
{
    while (true) {
        portCServer.poll();
        vTaskDelay(1);
    }
}

void showResult(uint16_t sentValue, long receivedValue)
{
    bool success = receivedValue >= 0 &&
                   static_cast<uint16_t>(receivedValue) == sentValue;

    Serial.printf("PORT.A TX: 0x%04X, PORT.C RX/TX: 0x%04lX, %s\n",
                  sentValue, receivedValue, success ? "PASS" : "FAIL");

    M5.Display.clear();
    M5.Display.setCursor(0, 0);
    M5.Display.println("Unit RS485-ISO Test");
    M5.Display.println("A Client -> C Server");
    M5.Display.printf("TX: 0x%04X\n", sentValue);

    if (receivedValue >= 0) {
        M5.Display.printf("RX: 0x%04lX\n", receivedValue);
    } else {
        M5.Display.println("RX: ERROR");
    }
    M5.Display.printf("Status: %s\n", success ? "PASS" : "FAIL");
}

void haltWithError(const char *message)
{
    Serial.println(message);
    M5.Display.clear();
    M5.Display.setCursor(0, 0);
    M5.Display.println(message);

    while (true) {
        delay(1000);
    }
}

4. 编译上传

  • 根据需求复制粘贴上述例程代码到项目代码区,选中设备端口(详情请参考 程序编译与烧录),点击 Arduino IDE 左上角编译上传按钮,等待程序完成编译并上传至设备。

5. 485 Modbus 通信

  • 设备上电后,CoreS3 的 PORT.A 作为 Modbus RTU Client 向 PORT.C 作为 Modbus RTU Server 发送保持寄存器写入请求,Server 收到请求后将数据写入保持寄存器,并返回响应。Client 收到响应后再向 Server 发送保持寄存器读取请求,Server 返回保持寄存器的值。Client 将读取到的值与发送的值进行比较,如果一致则显示 PASS,否则显示 FAIL。
Page Tools
PDF
On This Page