# RobotParamTool

**Repository Path**: eriksao/robot-param-tool

## Basic Information

- **Project Name**: RobotParamTool
- **Description**: 机器人参数备份和导入工具
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# HIROKAWA.ParamTool

机器人参数配置与管理工具

## 项目简介

HIROKAWA.ParamTool 是一款专为工业自动化场景设计的参数配置与管理软件，主要用于与机器人（Robot）和对准器（Aligner）设备进行通信和控制。该工具提供设备连接、参数读写、配置管理等功能，支持多种设备型号的集中管理。

## 功能特点

- **多设备支持**：兼容 HRC100、SR100 等型号的机器人设备及 SR100 对准器
- **通信协议**：基于 TCP/IP 的异步 Socket 通信，支持 MEMOBUS 协议
- **参数管理**：支持参数配置文件的导入、导出、编辑和保存
- **状态监控**：实时监控设备连接状态、报警信息和工作状态
- **日志记录**：完整的系统事件和操作日志记录，便于问题排查
- **用户界面**：直观的图形界面，便于操作和设备状态监控

## 主要模块

### 通信模块
- **AsynSocketClient**：异步 Socket 客户端，支持数据的发送和接收
- **TCPPortConnectionBase**：TCP 端口连接基类，处理通信逻辑
- **MEMOBUS 协议**：实现 MEMOBUS 通信协议，支持寄存器读写操作

### 设备控制模块
- **RobotBaseDevice / AlignerBaseDevice**：机器人/对准器设备基类
- **HRC100Robot / SR100Robot**：HRC100 和 SR100 机器人实现
- **SR100Aligner**：SR100 对准器实现
- 支持设备的连接、断开、复位、伺服控制等操作

### 参数管理模块
- **ParamDataService**：参数数据服务，管理设备参数配置
- **DeviceConfig / ConfigItem**：设备配置和参数项定义
- 支持参数的读写、批量操作和配置文件管理

### 事件日志模块
- **EventServices**：事件服务，处理系统事件和日志
- 支持不同级别的事件记录（信息、警告、报警等）

## 技术架构

### 核心类库
- **Common.Communications**：通信相关类
- **Common.Evevt**：事件处理相关类
- **Common.Utilities**：工具类（定时器、XML序列化等）
- **Equipments**：设备接口和实现
- **ViewModels**：视图模型层
- **Views**：用户界面视图

### 支持的设备型号
| 设备类型 | 型号 | 说明 |
|---------|------|------|
| 机器人 | HRC100 | HRC100 系列机器人 |
| 机器人 | SR100 | SR100 系列机器人 |
| 对准器 | SR100 | SR100 对准器 |

### 通信协议
- **MEMOBUS 协议**：支持线圈、寄存器等多种数据类型
- **ASCII 消息格式**：基于文本的通信格式
- **二进制消息格式**：高效的二进制数据传输
- 支持消息序号和校验和功能

## 系统要求

- **操作系统**：Windows 10/11
- **运行时**：.NET 6.0 或更高版本
- **依赖组件**：
  - log4net（日志组件）
  - WPF（用户界面框架）

## 安装说明

1. 确保系统已安装 .NET 6.0 运行时
2. 下载并运行安装程序 `HIROKAWA.ParamTool_Setup.exe`
3. 按照安装向导完成安装过程

## 使用说明

### 连接设备

1. 启动程序后，在设备连接区域输入设备的 IP 地址和端口号
2. 点击连接按钮建立与设备的通信连接
3. 连接成功后，状态指示灯将变为绿色

### 参数操作

1. **读取参数**：选择参数配置项，点击读取按钮获取设备当前参数
2. **设置参数**：修改参数值后，点击设置按钮将参数写入设备
3. **保存配置**：将当前参数配置保存到 XML 文件

### 日志查看

程序会自动记录所有操作事件和系统日志，可在日志窗口查看详细信息，包括：
- 操作记录
- 通信数据
- 警告和错误信息

## 目录结构

```
HIROKAWA.ParamTool/
├── Src/
│   ├── HIROKAWA.ParamTool/          # 主应用程序
│   │   ├── Common/                  # 公共组件
│   │   │   ├── Communications/     # 通信模块
│   │   │   ├── Evevt/               # 事件模块
│   │   │   └── Utilities/           # 工具类
│   │   ├── Configs/                 # 配置文件
│   │   ├── Converters/              # 值转换器
│   │   ├── Equipments/              # 设备实现
│   │   │   ├── Aligner/             # 对准器
│   │   │   └── Robot/               # 机器人
│   │   ├── Helper/                  # 辅助工具
│   │   ├── Models/                  # 数据模型
│   │   ├── ServiceExtensions.cs     # 服务扩展
│   │   ├── Style/                   # 样式资源
│   │   ├── Themes/                  # 主题资源
│   │   ├── ViewModels/              # 视图模型
│   │   └── Views/                   # 视图
│   └── HIROKAWA.ParamTool_Setup/    # 安装程序项目
└── README.md                         # 本说明文件
```

## 开发者信息

**作者**：Erik Sao

本项目旨在为工业自动化领域提供一个高效、稳定的设备参数配置工具，适用于各类需要设备参数管理和监控的应用场景。

## 许可证

本项目采用 MIT 许可证开源，详情请参阅 [LICENSE](LICENSE) 文件。

## 依赖声明

本项目使用以下开源组件：
- **log4net**：Apache License 2.0
- **WPF**：Microsoft .NET Framework 的一部分