# modbus-rtu-tauri

**Repository Path**: H0110/modbus-rtu-tauri

## Basic Information

- **Project Name**: modbus-rtu-tauri
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Modbus RTU Tool

一个基于 Tauri + Nuxt.js 构建的跨平台 Modbus RTU 协议调试工具。

## 功能特性

- 自动搜索串口设备
- 支持所有标准 Modbus RTU 功能码:
  - 读保持寄存器 (FC03)
  - 读输入寄存器 (FC04)
  - 读线圈 (FC01)
  - 读离散输入 (FC02)
  - 写单个寄存器 (FC06)
  - 写单个线圈 (FC05)
  - 写多个寄存器 (FC16)
  - 写多个线圈 (FC15)
- 实时数据展示
- 原始帧数据调试
- 支持深色/浅色主题
- 跨平台支持 (Ubuntu/Windows)

## 技术栈

- **前端**: Nuxt.js 3 + Vue 3 + TypeScript + TailwindCSS
- **后端**: Tauri 2 + Rust
- **串口**: tokio-serial + serialport-rs
- **协议**: Modbus RTU with CRC16

## 开发环境要求

### Ubuntu/Linux
```bash
# 安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 安装 Node.js (建议使用 nvm)
# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

# 安装系统依赖
sudo apt-get update
sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev

# 用户串口权限
sudo usermod -a -G dialout $USER
# 注销并重新登录后生效
```

### Windows
```powershell
# 安装 Rust
winget install Rustlang.Rust.MSVC

# 安装 Node.js
winget install OpenJS.NodeJS.LTS

# 安装 Visual Studio Build Tools (如果尚未安装)
winget install Microsoft.VisualStudio.2022.BuildTools
```

## 安装与运行

```bash
# 安装依赖
npm install

# 开发模式
npm run tauri:dev

# 构建生产版本
npm run tauri:build
```

## 项目结构

```
modbus-rtu-tauri/
├── app.vue                 # 根组件
├── nuxt.config.ts          # Nuxt 配置
├── tailwind.config.ts      # Tailwind 配置
├── tsconfig.json           # TypeScript 配置
├── package.json            # 项目依赖
├── assets/
│   └── css/
│       └── tailwind.css    # 全局样式
├── components/
│   ├── SerialConfig.vue    # 串口配置组件
│   ├── ModbusConfig.vue    # Modbus 配置组件
│   ├── DataDisplay.vue     # 数据展示组件
│   └── DebugConsole.vue    # 调试控制台组件
├── composables/
│   └── useTauriApi.ts      # Tauri API 封装
├── pages/
│   └── index.vue           # 主页面
├── types/
│   └── index.ts            # TypeScript 类型定义
└── src-tauri/              # Rust 后端
    ├── Cargo.toml          # Rust 依赖配置
    ├── tauri.conf.json     # Tauri 配置
    └── src/
        ├── main.rs         # 入口
        ├── lib.rs          # 库入口
        ├── serial.rs       # 串口管理
        ├── modbus.rs       # Modbus 协议实现
        └── commands.rs     # Tauri 命令
```

## 使用说明

1. 连接串口设备到电脑
2. 点击"刷新"按钮搜索可用串口
3. 选择正确的串口并配置波特率等参数
4. 点击"连接"按钮建立连接
5. 配置 Modbus 参数（从站地址、起始地址等）
6. 选择操作类型并点击"执行"

## 许可证

MIT License