# ModBusTcp

**Repository Path**: zzkuang/mod-bus-tcp

## Basic Information

- **Project Name**: ModBusTcp
- **Description**: modbustcp开发
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-01-08
- **Last Updated**: 2025-10-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ModBusTcp

## 环境配置

1. python版本：3.8
2. 依赖包
   ```shell
    pip install pymodbus -i https://pypi.doubanio.com/simple/
    pip install pyserial -i https://pypi.doubanio.com/simple/
    pip install pandas -i https://pypi.doubanio.com/simple/
    pip install tornado==6.4.1 -i https://pypi.doubanio.com/simple/
    pip install crcmod -i https://pypi.doubanio.com/simple/
   ```
## 目录介绍
1. exec:最终完整版安装包,包含剩下的文件
2. modbus:串口读取,modbustcp服务端,modbustcp客户端的模块
3. Web:控制网页
4. Util:项目使用的工具类

## 配置介绍
> 以下配置都可以在网关管理的页面上实现控制,下面对于参数的介绍

### Slave.json

> 是指本系统作为modbustcp作为从机供其他modbustcp主机访问的设置

#### 内容介绍

1. ip:本机作为modbustcp从机的ip
2. port: 作为modbustcp从机的端口
3. id: 作为modbustcp从机的id
4. 线圈（co）：1个bit,co_len代表对应类型的有几个
5. 离散输入（di）：1个bit,di_len代表对应类型的有几个
6. 保持寄存器（hr）：2个字节,hr_len代表对应类型的有几个
7. 输入寄存器（ir）：2个字节,ir_len代表对应类型的有几个

### Serial.json

> 针对本系统串口资源的设置

#### 内容介绍

1. COM:本系统自带的串口号,和linux串口文件内容对应,无需修改
2. band:波特率
3. activate:是否开启该串口,1为开启,0为不开启
4. save_reg: 存放在As Slave的哪种寄存器中,可选co,di,hr,ir
5. cmd:串口轮询访问的命令(不含crc部分)
6. read_start:返回的指令读取起始位,从0开始计数
7. read_len:读取长度
8. save_start: 存放起始地址
9. save_rule: 保存规则
10. freq:查询频率

### master.json

> 针对本系作为主机,连接的其他modbustcp从机的设置

#### 内容介绍

1. ip:从机ip
2. port:从机端口
3. id:从机id
4. save_reg: 存放在As Slave的哪种寄存器中,可选co,di,hr,ir,如有多个英文分号分割,建议与reg一致
5. save_start: 存放起始地址
6. save_rule: 保存规则
7. reg:取目标的哪些寄存器,英文分号分割,可选co,di,hr,ir
8. reg_len:读取目标寄存器的长度,英文分号分割,长度与reg对应
9. freq:查询频率
10. reg_addr:读取目标寄存器的起始地址,英文分号分割,长度与reg对应

#### 规则配置参考
https://wdjxrrf0as.feishu.cn/docx/KUZAdpMdPo7WhZxmXkJccpwFnbg?from=from_copylink

# 离线安装

1. 首先有一个联网环境的,平台相同的机器

2. 下载相关包,注意此时你的环境里只是下载没有安装

   ```cmd
   pip download pymodbus -i https://pypi.doubanio.com/simple/ -d /home/packages
   pip download pyserial -i https://pypi.doubanio.com/simple/ -d /home/packages
   pip download pandas -i https://pypi.doubanio.com/simple/ -d /home/packages
   pip download tornado -i https://pypi.doubanio.com/simple/ -d /home/packages
   ```

3. 安装对应的包

   ```bash
    pip install pymodbus -i https://pypi.doubanio.com/simple/
    pip install pyserial -i https://pypi.doubanio.com/simple/
    pip install pandas -i https://pypi.doubanio.com/simple/
    pip install tornado -i https://pypi.doubanio.com/simple/
   ```

4. 导出当前环境

   ```cmd
   pip freeze > requirements.txt
   ```

   * 导出的依赖目录在当前环境下

5. 下载对应的包

   ```bash
   pip download -r requirements.txt -i https://pypi.doubanio.com/simple/ -d /home/packages
   ```

6. 将依赖和依赖目录都传到目标环境,使用如下命令安装

   ```cmd
   pip install --no-index --find-links=/data/packages -r requirements.txt
   ```


## 整体安装流程

1. 将网络和电脑链接,保证网关和电脑能ping通
2. 使用串口登录设备,开启ssh
   * 将/etc/init.d/#S50sshd 文件更改名称，改为 S50sshd，重启系统即可开启此服务
3. 在linux内部创建根目录文件夹,/data并且给最高权限
4. 将install内部的内容全部上传至文件夹
5. 给install.sh 777的权限,并且执行`./install.sh`