QModMaster使用튜토리얼：무료 오픈소스Modbus디버깅 필수 도구 TCP/RTU全기능 코드与总线监视器实战

QModMaster은(는)基于Qt框架개발的무료 오픈소스Modbus마스터디버깅 도구，支持Modbus TCP和Modbus RTU两种프로토콜，内置总线监视器（Bus Monitor）可实时보기原始HEX데이터包，是산업 자동화엔지니어링师디버깅Modbus设备的必备利器。本文详细介绍QModMaster的下载安装、界面操作、TCP/RTU연결설정、레지스터读写、데이터형식设置、总线监控以及常见문제排查，帮助엔지니어링师快速掌握这款强大的Modbus디버깅 도구。

一、QModMaster개요

1.1 什么是QModMaster

QModMaster是一个무료的、오픈소스的Modbus마스터（Master）模拟软件，由Qt框架개발，底层基于libmodbus通讯库。它提供直观的图形界面，让엔지니어링师无需编写代码即可与Modbus슬레이브设备进行通讯测试，支持읽기和쓰기코일、이산 입력、유지 레지스터、입력 레지스터四种표준Modbus데이터유형。

1.2 核心功能特性

• 双프로토콜支持：同时支持Modbus TCP（以太网）和Modbus RTU（시리얼 포트RS485/RS232）
• 全기능 코드覆盖：支持기능 코드01-06、15、16等所有표준Modbus기능 코드
• 总线监视器：实时显示原始HEX데이터包，自动분석슬레이브ID、기능 코드、데이터载荷和CRC 검증
• 多데이터형식：支持10진수、16진수、有符号/无符号16位整数、32位整数、32位浮点数显示
• 连续扫描：可设置扫描间隔，自动周期性읽기设备데이터
• 跨平台：支持Windows、Linux、macOS操作系统
• 完全무료：오픈소스무료，无功能限制，无使用时长限制
• 轻量级：单文件绿色版，无需安装，解压即用

1.3 与其他Modbus디버깅 도구对比

도구	오픈소스	TCP	RTU	总线监控	데이터형식	价格
QModMaster	是	支持	支持	支持	Int/Float/Hex	무료
Modbus Poll	否	支持	支持	支持	丰富	유료（$129）
Modbus Slave	否	支持	支持	支持	丰富	유료（$129）
ModScan	否	支持	支持	不支持	一般	유료
CAS Modbus Scanner	否	支持	支持	不支持	一般	무료
pymodbus REPL	是	支持	支持	不支持	代码	무료

二、下载与安装

2.1 官方下载주소

• 官方웹사이트：https://qmodmaster.com/
• SourceForge下载：https://sourceforge.net/projects/qmodmaster/
• GitHub源码：https://github.com/mirror/qmodmaster

2.2 Windows安装

# Windows安装步骤
1. 访问 https://sourceforge.net/projects/qmodmaster/
2. 클릭 "Download" 下载最신버전本（通常为 qmodmaster-x.x.x.zip）
3. 解压到任意目录，例如 C:\Tools\QModMaster\
4. 双击 qmodmaster.exe 启动程序
5. 如提示缺少VC++运行库，安装 Microsoft Visual C++ Redistributable

# 注意：QModMaster是绿色软件，不需要安装，解压바로 사용 가능

2.3 Linux安装

# Ubuntu/Debian 安装依赖
sudo apt-get update
sudo apt-get install libqt5core5a libqt5gui5 libqt5widgets5 libmodbus5

# 下载并解压
wget https://sourceforge.net/projects/qmodmaster/files/latest/download -O qmodmaster.zip
unzip qmodmaster.zip -d qmodmaster
cd qmodmaster

# 运行
chmod +x qmodmaster
./qmodmaster

# 或从源码编译
sudo apt-get install qt5-default libmodbus-dev
git clone https://github.com/mirror/qmodmaster.git
cd qmodmaster
qmake
make
sudo make install

三、界面布局详解

QModMaster主界面分为四个主要区域，了解各区域功能是高效使用的基础。

3.1 菜单栏

菜单	功能
File	新建연결、저장설정、불러오기설정、退出
Options	选择Modbus TCP或Modbus RTU모드，설정연결매개변수
View	显示/隐藏Bus Monitor、设置데이터표시 형식
Help	关于、버전信息

3.2 도구栏

• Connect/Disconnect：연결/断开Modbus设备
• Read/Write：执行一次읽기或쓰기操作
• Scan：开启/닫기连续扫描모드
• 设置图标：快速열기연결설정对话框

3.3 데이터显示区

主区域以表格形式显示레지스터데이터，包含以下列：

• 주소：레지스터주소（0-based）
• Value(Hex)：16진수值
• Value(Dec)：10진수值
• Value(Float)：浮点数值（需手动开启）
• Description：用户自定义설명（可편집）

3.4 Bus Monitor（总线监视器）

底部区域显示实时通讯데이터包，这是QModMaster最强大的功能之一。通过 View → Bus Monitor 开启。每条记录包含：

• 时间戳：精确到毫秒的收发时间
• 方向：Tx（보내기）或 Rx（수신）
• 原始HEX데이터：完整的Modbus ADU데이터包
• 自动분석：슬레이브ID、기능 코드、데이터필드、CRC 검증码

四、Modbus TCP연결설정

4.1 설정步骤

# Modbus TCP연결설정步骤

1. 열기 Options → Modbus TCP...
2. 在弹出的对话框中填写：
   - IP 주소：设备IP주소，例如 192.168.1.100
   - Port：포트号，默认 502
   - Slave ID：슬레이브 주소（Unit ID），通常为 1
   - Timeout：超时时间（毫秒），默认 1000
3. 클릭 OK 저장설정
4. 클릭도구栏 Connect 버튼建立연결
5. 연결成功后，状态栏显示 "Connected"

# 注意事项
- 确保电脑和设备在同一网段
- 닫기电脑防火墙或放行502포트
- 部分设备需要先在设备端활성화Modbus TCP功能
- Slave ID（Unit ID）对于纯TCP设备通常为0或1，
  通过게이트웨이연결RTU设备时填写对应RTU슬레이브 주소

4.2 TCP연결故障排查

故障现象	可能原因	排查方法
연결超时	IP错误/네트워크不通	ping设备IP，检查网线和交换机
연결被拒绝	포트错误/服务未启动	用telnet测试502포트：telnet 192.168.1.100 502
연결成功但无데이터	Slave ID错误	尝试Slave ID=0,1,255，보기设备手册
返回异常码02	주소超出范围	确认设备支持的레지스터주소范围
返回异常码01	기능 코드不支持	确认设备支持该기능 코드

五、Modbus RTU연결설정

5.1 硬件准备

Modbus RTU需要USB转RS485컨버터（如CH340、FT232芯片的模块），将电脑的USB인터페이스转换为RS485总线信号。

# 硬件배선（USB转RS485模块）
USB转RS485模块 A端  -->  设备RS485 A端（D+ / + / 非反相）
USB转RS485模块 B端  -->  设备RS485 B端（D- / - / 反相）
USB转RS485模块 GND -->  设备GND（建议연결，减少共模干扰）

# 注意
- A/B线不要接反，接反会导致无响应
- 总线两端各接120Ω终端电阻
- 使用屏蔽双绞线，屏蔽层单端接地
- 多个设备并联在总线上，手拉手菊花链拓扑

5.2 软件설정

# Modbus RTU연결설정步骤

1. 插入USB转RS485컨버터，在设备管理器中보기COM口号
   （Windows：设备管理器 → 포트(COM和LPT)）
   （Linux：ls /dev/ttyUSB* 或 /dev/ttyACM*）

2. 열기 Options → Modbus RTU...
3. 설정시리얼 포트 매개변수：
   - Port：COM포트号，例如 COM3 或 /dev/ttyUSB0
   - Baud Rate：통신 속도，必须与设备一致（9600/19200/38400/115200）
   - 데이터 Bits：데이터 비트，通常为 8
   - Stop Bits：정지 비트，通常为 1
   - Parity：패리티，None/Even/Odd，必须与设备一致
   - Slave ID：슬레이브 주소，1-247
   - Timeout：超时时间，建议 1000-3000ms

4. 클릭 OK 저장
5. 클릭 Connect 연결

# 常见시리얼 포트 매개변수组合
- 9600, 8, N, 1（最常见）
- 9600, 8, E, 1（部分PLC）
- 19200, 8, N, 1
- 38400, 8, N, 1
- 115200, 8, N, 1（短距离高速）

5.3 RTU연결故障排查

故障现象	可能原因	解决方法
시리얼 포트打不开	COM口被占用/驱动未装	닫기其他시리얼 포트软件，重装CH340驱动
完全无响应	A/B线接反	交换A/B线再试
完全无响应	슬레이브 주소错误	보기设备DIP 스위치或软件设置
CRC错误	통신 속도/패리티不일치	逐项核对시리얼 포트 매개변수，与设备完全一致
偶尔丢包	干扰/无终端电阻	总线两端加120Ω电阻，使用屏蔽线
데이터乱码	정지 비트不일치	确认정지 비트是1还是2

六、유지 레지스터 읽기 (FC03)（기능 코드03）

유지 레지스터（Holding 회원가입s）是Modbus中最常用的데이터유형，기능 코드03，주소范围通常为40001-49999（对应0-based주소0-9998）。

# 유지 레지스터 읽기 (FC03)操作步骤

1. 确认已연결到设备（状态栏显示Connected）
2. 在主界面设置읽기매개변수：
   - Slave ID：슬레이브 주소（如已在연결설정中设置可省略）
   - 기능 코드：选择 "Read Holding 회원가입s (03)"
   - Start 주소：시작주소（0-based，例如 0）
   - Quantity：읽을 수량（例如 10）
3. 클릭 Read/Write 버튼执行一次읽기
4. 데이터表格中显示읽기到的레지스터 값

# 주소설명
- QModMaster使用0-based주소（从0开始）
- 设备手册中的40001对应QModMaster주소0
- 设备手册中的40010对应QModMaster주소9
- 转换公式：QModMaster주소 = 手册주소 - 40001

# 예제
읽기온도 센서데이터：
- 手册설명：온도在40101，占2个레지스터，浮点数
- QModMaster设置：Start 주소=100, Quantity=2
- 읽기后주소100和101显示原始值
- 전환到Float视图보기实际온도值

七、읽기코일与이산 입력

7.1 읽기코일（기능 코드01）

# 읽기코일（Coils）- 기능 코드01
# 코일是可读写的布尔量，주소范围00001-09999

操作步骤：
1. 기능 코드 选择 "Read Coils (01)"
2. Start 주소：시작주소（0-based）
3. Quantity：읽을 수량（最多2000个）
4. 클릭 Read/Write
5. 表格中显示每个코일的ON/OFF状态

# 주소转换
- 手册00001 → QModMaster주소0
- 手册00010 → QModMaster주소9

7.2 이산 입력 읽기 (FC02)（기능 코드02）

# 이산 입력 읽기 (FC02)（Discrete Inputs）- 기능 코드02
# 이산 입력是只读布尔量，주소范围10001-19999

操作步骤：
1. 기능 코드 选择 "Read Discrete Inputs (02)"
2. Start 주소：시작주소
3. Quantity：읽을 수량
4. 클릭 Read/Write

# 典型用途
- 읽기开关状态、버튼状态、限位开关
- 읽기设备运行/故障状态
- 읽기门禁、센서触发状态

# 주소转换
- 手册10001 → QModMaster주소0
- 手册10005 → QModMaster주소4

7.3 입력 레지스터 읽기 (FC04)（기능 코드04）

# 입력 레지스터 읽기 (FC04)（Input 회원가입s）- 기능 코드04
# 입력 레지스터是只读16位데이터，주소范围30001-39999

操作步骤：
1. 기능 코드 选择 "Read Input 회원가입s (04)"
2. Start 주소：시작주소
3. Quantity：읽을 수량
4. 클릭 Read/Write

# 典型用途
- 읽기模拟量입력（AI）：온도、压力、流量
- 읽기ADC采样值
- 읽기设备内部状态매개변수

# 주소转换
- 手册30001 → QModMaster주소0
- 手册30100 → QModMaster주소99

八、쓰기操作

8.1 写单个코일（기능 코드05）

# 写单个코일（Force Single Coil）- 기능 코드05

操作步骤：
1. 기능 코드 选择 "Write Single Coil (05)"
2. Start 주소：코일주소
3. 在데이터表格中找到对应주소行
4. 双击 Value 列，입력：
   - 0xFF00 表示 ON（吸合）
   - 0x0000 表示 OFF（断开）
5. 클릭 Read/Write 执行쓰기
6. Bus Monitor中可看到쓰기请求和设备响应

# 注意
- QModMaster中写코일使用0xFF00/0x0000，
  这是Modbus프로토콜표준规定的值
- 쓰기成功后设备会回显相同的请求帧

8.2 写单个레지스터（기능 코드06）

# 写单个레지스터（Preset Single 회원가입）- 기능 코드06

操作步骤：
1. 기능 코드 选择 "Write Single 회원가입 (06)"
2. Start 주소：레지스터주소
3. 双击데이터表格中对应行的 Value 列
4. 입력要쓰기的值（10진수或16진수）
5. 클릭 Read/Write 执行쓰기

# 예제：设定온도
- 온도设定值在40100，范围0-100，分辨率0.1
- 要设定25.5°C，쓰기值=255
- Start 주소=99, Value=255
- 클릭쓰기

8.3 写多个코일（기능 코드15）

# 写多个코일（Force Multiple Coils）- 기능 코드15

操作步骤：
1. 기능 코드 选择 "Write Multiple Coils (15)"
2. Start 주소：시작주소
3. Quantity：쓸 수량
4. 在데이터表格中逐个设置每个코일的值（0xFF00/0x0000）
5. 클릭 Read/Write 批量쓰기

# 注意
- 一次最多쓰기1968个코일
- 所有코일值会一次性보내기到设备

8.4 写多个레지스터（기능 코드16）

# 写多个레지스터（Preset Multiple 회원가입s）- 기능 코드16

操作步骤：
1. 기능 코드 选择 "Write Multiple 회원가입s (16)"
2. Start 주소：시작주소
3. Quantity：쓸 수량
4. 在데이터表格中逐个设置每个레지스터的值
5. 클릭 Read/Write 批量쓰기

# 예제：批量设置PID매개변수
- P在40200，I在40201，D在40202
- Start 주소=199, Quantity=3
- 分别设置P=100, I=50, D=20
- 클릭쓰기，一次性更新三个매개변수

九、데이터형식设置

QModMaster支持多种데이터표시 형식，通过 View 菜单전환。正确设置데이터형식是解读设备데이터的关键。

9.1 支持的데이터형식

형식	설명	适用시나리오
Unsigned Int 16	16位无符号整数（0-65535）	状态字、计数、原始ADC值
Signed Int 16	16位有符号整数（-32768~32767）	온도、压力等可能为负的量
Unsigned Int 32	32位无符号整数（占2个레지스터）	大计数、累计量
Signed Int 32	32位有符号整数（占2个레지스터）	大范围模拟量
Float 32	IEEE 754单精度浮点数（占2个레지스터）	온도、压力、流量等物理量
Hex	16진수原始值	디버깅、프로토콜分析
Binary	2진수位显示	状态字逐位分析

9.2 浮点数보기方法

# 보기32位浮点数

1. 先읽기2个连续的유지 레지스터（기능 코드03）
2. 열기 View 菜单
3. 选择 "Float" 或 "32-bit Float"
4. 데이터表格会自动将相邻的两个레지스터
   组合为一个浮点数显示

# 浮点数바이트序문제
不同设备的浮点数存储顺序可能不同：
- ABCD（大端序）：reg[0]=高16位, reg[1]=低16位（最常见）
- CDAB（字交换）：reg[0]=低16位, reg[1]=高16位
- DCBA（小端序）：完全反转

如果Float显示的值明显不对（如NaN、超大数），
설명바이트序不일치，需要：
1. 用계산器手动转换验证
2. 或使用其他도구（如Modbus Poll）전환바이트序
3. 记录设备的正确바이트序，在后续개발中使用

十、Bus Monitor总线监视器详解

Bus Monitor是QModMaster最有价值的디버깅功能，它显示总线上传输的原始데이터包，帮助엔지니어링师定位通讯문제。通过 View → Bus Monitor 开启。

10.1 데이터包분석예제

# Modbus RTU데이터包예제

# 보내기请求（Tx）：읽기슬레이브1的유지 레지스터0-9
Tx: 01 03 00 00 00 0A C5 CD
    │  │  │     │     │  │
    │  │  │     │     │  └─ CRC 검증低바이트
    │  │  │     │     └──── CRC 검증高바이트
    │  │  │     └────────── 읽을 수량=10
    │  │  └──────────────── 시작주소高바이트=0
    │  └─────────────────── 시작주소低바이트=0
    └────────────────────── 기능 코드03=读유지 레지스터
    └──────────────────────── 슬레이브 주소=1

# 수신响应（Rx）：슬레이브返回10个레지스터 값
Rx: 01 03 14 00 64 00 C8 01 2C 01 90 01 F4 02 58 02 BC 03 20 03 84 03 E8 7B 6E
    │  │  │  │
    │  │  │  └─ 레지스터0值=0x0064=100
    │  │  └──── 바이트数=20（10个레지스터×2바이트）
    │  └─────── 기능 코드03
    └────────── 슬레이브 주소=1

# Modbus TCP데이터包예제
# TCP모드比RTU多了MBAP头（7바이트）

Tx: 00 01 00 00 00 06 01 03 00 00 00 0A
    │  │  │  │  │  │  │  │  │     │
    │  │  │  │  │  │  │  │  │     └─ 数量=10
    │  │  │  │  │  │  │  │  └─────── 시작주소=0
    │  │  │  │  │  │  │  └────────── 기능 코드03
    │  │  │  │  │  │  └───────────── 슬레이브ID=1
    │  │  │  │  │  └──────────────── 길이=6바이트
    │  │  │  │  └─────────────────── 프로토콜ID=0（Modbus）
    │  │  │  └────────────────────── 프로토콜ID高바이트=0
    │  │  └───────────────────────── 事务ID低바이트=1
    │  └──────────────────────────── 事务ID高바이트=0
    └─────────────────────────────── 事务ID=1（用于일치请求响应）

10.2 异常响应분석

# Modbus异常响应형식
# 기능 코드 = 原기능 코드 + 0x80
# 异常码 = 1바이트

Rx: 01 83 02 C0 F1
    │  │  │  │
    │  │  │  └─ CRC 검증
    │  │  └──── 异常码=02（非法데이터주소）
    │  └─────── 异常기능 코드=0x83（原03+0x80）
    └────────── 슬레이브 주소=1

# 常见异常码
01 - Illegal 기능（非法기능 코드）：设备不支持该기능 코드
02 - Illegal 데이터 주소（非法데이터주소）：주소超出范围
03 - Illegal 데이터 Value（非法데이터值）：쓰기值不合法
04 - Slave Device Failure（슬레이브设备故障）：设备内部错误
05 - Acknowledge（确认）：已接受，处理中
06 - Slave Device Busy（슬레이브忙）：请稍后重试

# Bus Monitor使用技巧
- 勾选 "Show Timestamp" 보기精确时间
- 对比Tx和Rx的时间差，계산设备响应速度
- 异常响应时重点보기异常码
- 无Rx表示设备未响应，检查배선和주소

十一、连续扫描모드

# 连续扫描（Scan）功能

1. 설정好읽기매개변수（기능 코드、주소、数量）
2. 클릭도구栏 Scan 버튼（或按F5）
3. QModMaster按设定间隔周期性읽기데이터
4. 데이터表格实时更新最新值
5. 再次클릭 Scan 정지扫描

# 扫描间隔设置
- Options → 设置扫描间隔（Scan Rate）
- 常用间隔：100ms, 500ms, 1000ms, 2000ms
- 间隔太短可能导致设备响应不过来
- 建议从1000ms开始，根据设备响应速度调整

# 扫描모드用途
- 实时监控센서데이터变化
- 观察设备运行状态
- 测试设备响应速度和稳定性
- 记录데이터变化趋势（配合截图或第三方도구）

# 注意
- 扫描期间不要频繁전환기능 코드或주소
- RTU모드下扫描间隔建议≥500ms
- 长时间扫描可能导致设备发热，注意散热

十二、实际적용案例

12.1 案例一：디버깅온습도센서

# 设备：RS485온습도变送器
# 手册매개변수：
#   - 슬레이브 주소：1
#   - 통신 속도：9600, 8N1
#   - 온도：30001，16位有符号整数，分辨率0.1°C
#   - 湿度：30002，16位无符号整数，分辨率0.1%RH

# QModMaster操作：
1. Options → Modbus RTU → COM3, 9600, 8, N, 1, Slave=1
2. Connect
3. 기능 코드 = Read Input 회원가입s (04)
4. Start 주소 = 0, Quantity = 2
5. Read/Write
6. 보기结果：
   - 주소0值=253 → 온도=25.3°C（Signed Int 16）
   - 주소1值=652 → 湿度=65.2%RH（Unsigned Int 16）
7. 开启Scan，观察온습도实时变化

12.2 案例二：控制릴레이模块

# 设备：8路Modbus릴레이模块
# 手册매개변수：
#   - 슬레이브 주소：2
#   - 통신 속도：9600, 8N1
#   - 릴레이1-8对应코일0-7
#   - 写코일0xFF00=吸合，0x0000=断开

# QModMaster操作：
1. Options → Modbus RTU → COM3, 9600, 8, N, 1, Slave=2
2. Connect
3. 읽기릴레이状态：
   기능 코드 = Read Coils (01)
   Start 주소 = 0, Quantity = 8
   Read/Write → 显示8路릴레이当前状态
4. 控制릴레이1吸合：
   기능 코드 = Write Single Coil (05)
   Start 주소 = 0
   双击주소0的Value列，입력 FF00
   Read/Write → 听到릴레이吸合声
5. 控制릴레이1断开：
   Value改为 0000 → Read/Write
6. 批量控制：
   기능 코드 = Write Multiple Coils (15)
   设置前4路为FF00，后4路为0000
   Read/Write → 前4路同时吸合

12.3 案例三：디버깅变频器

# 设备：Modbus TCP变频器
# 手册매개변수：
#   - IP：192.168.1.50，포트502
#   - 슬레이브ID：1
#   - 运行频率：40001，16位整数，分辨率0.01Hz
#   - 출력电流：30001，16位整数，分辨率0.1A
#   - 启动命令：40100，写1=启动，写0=정지
#   - 频率设定：40101，范围0-5000（0.00-50.00Hz）

# QModMaster操作：
1. Options → Modbus TCP → IP=192.168.1.50, Port=502, Slave=1
2. Connect
3. 읽기运行频率：
   FC=Read Holding 회원가입s(03), Addr=0, Qty=1
   值=2500 → 频率=25.00Hz
4. 읽기출력电流：
   FC=Read Input 회원가입s(04), Addr=0, Qty=1
   值=135 → 电流=13.5A
5. 设定频率30Hz：
   FC=Write Single 회원가입(06), Addr=100
   Value=3000 → Write
6. 启动变频器：
   FC=Write Single 회원가입(06), Addr=99
   Value=1 → Write
7. 开启Scan监控运行状态

十三、高级技巧

13.1 설정文件저장与불러오기

# 저장当前설정
File → Save As → 选择저장 경로和文件名
설정文件包含：연결매개변수、기능 코드设置、데이터형식、설명信息

# 불러오기설정
File → Open → 选择之前저장的설정文件
快速전환不同设备的디버깅설정

# 建议
为每个项目/设备저장独立的설정文件，
命名형식：项目名_设备名_日期.qmm
例如：FactoryA_TempSensor_20260917.qmm

13.2 주소扫描技巧

# 不知道设备레지스터주소时的扫描方法

方法1：大范围읽기
- 设置Quantity=125（Modbus最大单次읽기量）
- 从주소0开始，每次偏移125
- 记录哪些주소有正常响应（非异常码02）

方法2：Bus Monitor观察
- 开启Scan，大范围읽기
- 在Bus Monitor中观察哪些请求返回正常데이터
- 异常码02表示该주소范围不存在

方法3：参考同类设备
- 同品牌同시리즈设备的레지스터表通常相似
- 先按已知주소测试，再逐步扩展

# 注意
- 不要对设备进行全주소空间暴力扫描
- 部分设备对频繁异常请求会触发保护
- 扫描间隔建议≥500ms

13.3 与Wireshark配合抓包

# Modbus TCP네트워크抓包分析

1. 열기Wireshark，选择网卡，开始抓包
2. 在QModMaster中执行读写操作
3. Wireshark中过滤：modbus
4. 보기完整的TCP데이터包
5. Wireshark会自动분석Modbus프로토콜필드

# 适用시나리오
- 分析네트워크지연和丢包
- 排查多마스터冲突
- 验证게이트웨이프로토콜转换正确性
- 학습Modbus TCP프로토콜细节

# RTU抓包
- 使用带监听功能的USB转RS485模块
- 或使用专用RS485总线分析仪
- QModMaster的Bus Monitor已足够应对大多数시나리오

十四、常见문제FAQ

Q1：QModMaster支持Modbus ASCII吗？

不支持。QModMaster仅支持Modbus TCP和Modbus RTU。Modbus ASCII是较老的프로토콜，目前已很少使用。如需ASCII프로토콜，可使用Modbus Poll或其他도구。

Q2：为什么읽기到的值都是0？

可能原因：①주소错误，읽기了未使用的주소；②设备未上电或未运行；③데이터유형设置错误，浮点数被当作整数显示；④슬레이브ID不일치。解决方法：보기Bus Monitor确认是否有正常响应，核对设备手册的주소表。

Q3：QModMaster可以做슬레이브（Slave）模拟吗？

不可以。QModMaster是纯마스터（Master）도구，只能主动读写슬레이브设备。如需模拟슬레이브，可使用Modbus Slave（유료）或pymodbus的服务端功能（무료）。

Q4：最大可以읽기多少个레지스터？

Modbus프로토콜规定单次最多읽기125个유지 레지스터/입력 레지스터，2000个코일/이산 입력，쓰기最多123个레지스터/1968个코일。QModMaster遵循此限制。

Q5：Windows 11下QModMaster闪退怎么办？

尝试：①以管理员身份运行；②安装最신버전VC++运行库；③右键属性→兼容性→Windows 7兼容모드；④下载最신버전本。

Q6：如何同时연결多个设备？

QModMaster单实例只能연결一个设备。可同时열기多个QModMaster实例，每个实例연결不同的设备或不同的슬레이브 주소。RTU모드下多个슬레이브在同一总线上，只需전환Slave ID即可。

十五、학습자료

• QModMaster官网：https://qmodmaster.com/
• SourceForge下载：https://sourceforge.net/projects/qmodmaster/
• Modbus프로토콜官方사양：https://modbus.org/specs.php
• libmodbus문서：https://libmodbus.org/documentation/
• Modbus TCP抓包튜토리얼：Wireshark官方문서검색"Modbus"
• RS485硬件设计指南：TI적용笔记SLVA677

QModMaster作为一款무료 오픈소스的Modbus디버깅 도구，凭借其直观的界面、强大的总线监视器和双프로토콜支持，成为산업 자동화엔지니어링师不可或缺的디버깅 필수 도구。掌握QModMaster的使用，能够快速验证设备通讯、排查프로토콜문제、읽기和쓰기레지스터데이터，大大提高现场디버깅效率。建议配合设备手册和Bus Monitor功能，从简单的유지 레지스터 읽기 (FC03)开始，逐步掌握전체기능 코드和高级디버깅技巧。