# esp8266-modbus-device

**Repository Path**: littletow/esp8266-modbus-device

## Basic Information

- **Project Name**: esp8266-modbus-device
- **Description**: esp8266 设备端，支持modbus采集上传，支持MQTT/TCP协议。
- **Primary Language**: C
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: mqtt, modbus

## README



# ESP8266 Modbus 设备

本项目基于 ESP8266 开发，是一个轻量级的 Modbus 从设备实现，适用于物联网和工业自动化场景。

## 功能特性

- ⚡️ 完全兼容 Modbus RTU 协议
- 📶 支持 WiFi 网络连接
- 🔌 可配置多个保持寄存器
- 💾 内置 EEPROM 用于数据持久化
- 📟 易于集成的 Arduino/PlatformIO 库

## 硬件要求

- ESP8266 开发板（如 NodeMCU、Wemos D1 Mini）
- TTL 转 RS485 模块（可选，用于工业环境）

## 快速开始

### 安装

推荐使用 PlatformIO 进行开发：

```bash
# 克隆项目
git clone https://gitee.com/littletow/esp8266-modbus-device.git
cd esp8266-modbus-device

# 编译并上传
pio run --target upload
```

或使用 Arduino IDE：

1. 将项目导入 Arduino IDE
2. 选择正确的开发板和端口
3. 上传代码

### 配置

在 `src/config.h` 中修改默认参数：

```cpp
#define MODBUS_DEVICE_ID 1
#define BAUD_RATE 9600
```

## 使用示例

```cpp
#include "ModbusESP8266.h"

ModbusESP8266 modbus;

void setup() {
    modbus.begin(1, Serial);  // 设备ID为1，使用硬件Serial
    modbus.addRegister(0x0000, 0);  // 添加寄存器
}

void loop() {
    modbus.task();  // 处理Modbus请求
}
```

## 引脚连接

| ESP8266 | RS485模块 |
|--------|-----------|
| GPIO1  | DI        |
| GPIO3  | RO        |
| GPIO15 | DE/RE    |

## 贡献指南

欢迎提交 Issue 和 Pull Request！

## 许可证

MIT License