CORS与前后端联调-WebMvcConfig里的一行配置
2026/9/24 3:51:42
去年在一个配电房改造项目上，我用威纶通触摸屏连接一批Modbus RTU测温仪表，原以为半天能搞定的事，结果画面温度值出来之前，光通信就耗掉快两小时。后来又在同一个项目里踩了数据解析的坑：寄存器地址按说明书填了，数值却显示成一串天文数字。从那以后，我养成了固定的配置和排查流程，遇到Modbus协议项目基本不掉链子。
这篇文章把威纶通触摸屏连接Modbus仪表的完整链路拆开讲：从485接线、EasyBuilder Pro参数设置，到地址映射、浮点数解析，再到通信延时测量与优化，最后是现场联调验证顺序。适合正在做设备数据采集、电气自动化改造的工程师，也适合第一次把仪表数据接到触摸屏上的新手。看完至少能少走一半弯路。
1. 先把物理层做扎实：485接线、终端电阻和站号规划
1.1 A/B标识乱象与正确接线
RS485接线是最容易翻车但往往被忽视的环节。RS485是差分信号，理论上A接A、B接B就能通，但不同仪表的端子标识并不统一。有的标A/B，有的标D+/D-，还有的标485+/485-，甚至同一厂家不同型号都可能相反。所以接线前先看仪表端子丝印和说明书，这比什么都有用。
如果实在拿不准，也不用怕，A/B对调不会烧设备。我的习惯是：接好线后先不写画面程序，直接用电脑调试软件读一下；读不通就把两根信号线对调再试一次，往往第二次就通了。这个土办法比纠结端子定义快得多。
还有一个容易被忽略的点：屏蔽层和GND地线。很多仪表的485端子旁边带GND或SG，最好和触摸屏的485参考地连起来，避免两个设备地电位差过大，把差分信号拉到无效电平。屏蔽层则采用单端接地，不要两头都接，两头接地反而容易形成地环路干扰。
1.2 终端电阻与总线拓扑怎么处理
总线距离短、设备数量少的时候，终端电阻不接也能跑。但一旦距离超过50米，或者并联了多台设备，总线末端的信号反射会非常明显，典型症状是通信偶尔超时、数据偶尔跳变。这时候在485总线最末端一台仪表的A、B之间并联一个120Ω电阻，问题往往立竿见影。
拓扑上尽量采用手拉手菊花链方式，从一台仪表进线再出线到下一台。不要因为触摸屏COM口旁边就是通道，就直接从屏上分出三根线给三台仪表，这种星型接法在较高波特率下很容易出现反射和串扰。如果现场已经放了星型线，要么改接成链式，要么把波特率降到9600并加终端电阻。
1.3 站号规划是总线秩序的前提
Modbus从机站号范围1到247，每台仪表必须唯一。多台仪表同时默认站号1，是最常见的总线故障。我见过一个现场，触摸屏读数时而正常时而无响应，排查半天才发现是两台仪表站号都设成了1，它们收到同一条请求后同时回复，把总线彻底搞乱。
所以项目开工前先在Excel里列一个站号分配表：第1台站号1、第2台站号2，按顺序写清楚。仪表侧设定完站号后，最好断电重启一次确认参数保存成功。有些仪表面板改完参数不保存，断电后恢复原值，这个坑我踩过不止一次。
2. EasyBuilder Pro里新增仪表：串口参数、超时与批读取选项
2.1 新增设备要选对MODBUS RTU驱动
打开EasyBuilder Pro后，双击系统参数，在设备列表里点新增。厂商选择MODBUS，设备类型选择MODBUS RTU，接口选择实际使用的COM口。这里常有人选成串口服务器、PLC之类，导致后续地址类型对不上。
新增完设备后，设备属性界面主要填三项：站号、串口参数、通信高级选项。站号对应仪表的从站地址，注意是十进制数值不是十六进制。比如仪表面板显示Addr 02，这里就填2，不是0x02。
2.2 串口参数匹配的细节
串口参数有波特率、数据位、校验位、停止位四项，必须和仪表侧完全一致。很多工程文档里写“9600, 8, N, 1”，但国产仪表默认偶校验8E1的也不少见，别惯性思维。
如果不确定仪表串口参数，又没法在面板上看清楚，最稳的办法是用Modbus Poll之类的PC调试工具，按波特率9600、2400、19200，校验位N/E/O挨个扫描，找到能正常读回数据的组合。平时备一根USB转485线，能省去大量猜参数的时间。
数据位和校验位其实是联动的：无校验时数据位通常8位，停止位1或2；偶校验或奇校验时也是8位数据位。如果选了7位数据位，Modbus RTU基本就不适用了。触摸屏侧设置完参数后，建议关闭EasyBuilder Pro的在线模拟再重开一次，避免旧配置没刷新。
2.3 响应超时和命令间隔时间
设备属性里还有两个参数，平时容易被忽略，出问题时又是关键：响应超时时间和命令间隔时间。
响应超时是触摸屏等待从站回复的最长时间，超过就判定本次请求失败。默认值通常在几百毫秒，对大多数仪表够用。但有些仪表在写入EEPROM或批量保存时，响应会拖到1秒以上；如果画面里频繁做写入操作，建议把响应超时适当调大到1000ms左右，否则会频繁报PLC No Response。反过来也不要调太大，万一某条命令真的超时，它会卡住这条链路的轮询，整体刷新就被拖慢。
命令间隔时间是相邻两条命令之间的等待时间，默认0表示驱动自行控制帧间隔。总线干扰明显、偶发错帧时，把间隔设为10到20ms能让总线稳定很多；但没有必要设到几百毫秒，那会人为放大通信延时，画面刷新肉眼可见地变慢。
2.4 批读取选项：延时优化的第一板斧
EasyBuilder Pro的设备属性里通常有关于连续地址优化或批量读取的选项，有的叫多帧连续读取，有的在通信优化里。它的原理很简单：如果画面里连续引用同一台仪表的多个连续寄存器，驱动会把它们合成一条Modbus读指令，一次读回更多数据，而不是每个地址发一条命令。
以温度记录为例，仪表内部寄存器从4x 0到4x 5连续存放6个通道的温度，如果关闭这个选项，驱动可能会发6条03读命令；开启后通常只发1条，通信量减少到原来的六分之一。我第一次做这个项目时没注意这个选项，后来做延时分析才发现，同样一组温度数据，开启批读取后刷新时间从2.8秒降到1秒以内。所以它是后面第4章优化通信延时时最值得先动手的地方。
3. 地址映射与数据解析：为什么同一个寄存器读出来是乱码
3.1 四种寄存器区与功能码不能搞混
Modbus规范把寄存器分成了四个区，功能码也不同。关键要分清：
| Modbus区 | 功能码(读) | 属性 | 威纶通地址类型 | 典型用途 |
|---|---|---|---|---|
| 0x 线圈 | 01 | 可读写位 | 0x | 开关、继电器输出 |
| 1x 离散输入 | 02 | 只读位 | 1x | 开关状态信号 |
| 3x 输入寄存器 | 04 | 只读字 | 3x | 模拟量输入、实时测量值 |
| 4x 保持寄存器 | 03 | 可读写字 | 4x | 设定值、累计量、可写参数 |
同样写地址1，用3x类型驱动发的是04功能码，用4x类型驱动发的是03功能码。如果仪表只实现了04读输入寄存器，而你按4x来配置，触摸屏就会一直显示0。项目中最常见的“为什么读到0”，基本都出在这一步。
3.2 地址偏移：40001和协议地址0的差一坑
仪表手册喜欢写“保持寄存器40001=温度”，这是PLC风格的地址，表示第1个保持寄存器。而在Modbus协议报文里，起始地址是0x0000。两者之间的换算关系，取决于你用的是什么调试工具和触摸屏驱动。
在Modbus Poll里，Read/Write Definition界面有一个关于地址格式的选项。勾选后地址栏直接填40001，背后报文地址自动减1；不勾选就填0。哪个读出来正常，就说明你当前的理解没跑偏。
在威纶通里也有类似概念，设备地址可以按4x类型加协议偏移地址来填，也可以按设备手册的五位数地址格式直接输入，不同版本的驱动处理方式略有差异。别死记填0还是填1，我的做法是：先在Modbus Poll里用Base 0方式确认温度在协议地址0，然后到威纶通4x地址栏填0；如果画面读不到，再试填1。两分钟就能验证完。
3.3 32位浮点数的字序问题
这是数据解析“乱码”的最大来源。
带小数点的温度、压力、流量，很多仪表用IEEE754 32位浮点数存储，占用两个连续寄存器，共4个字节。读取时这4个字节的排列顺序有四种可能：ABCD、BADC、CDAB、DCBA，分别对应大端、字节交换、字交换、小端等不同存储方式。仪表说明书通常会写“32位浮点按ABCD顺序存储”或“CDAB”，但也有不少写得模棱两可。
我的判断方法是：把触摸屏上的数值显示元件设置成32-bit Float，然后在数据格式选项里依次切换ABCD、BADC、CDAB、DCBA四种，哪个显示值和仪表面板一致，就锁定哪个。切换过程中如果看到1e-40、几百万、负数等明显异常值，直接跳过。
还要注意，读32位数据时占用的是两个连续寄存器，比如4x 0和4x 1。如果这两个地址同时被另一个16位显示元件占用，画面就会互相干扰，数值疯跳。安排地址表时，32位数据要占两个连续地址，16位数据只占一个，不要重叠。
3.4 仪表输出的是原始值而不是物理量怎么办
很多仪表并不会直接输出浮点物理量，而是输出一个整数原始值。比如某液位计，4x 0寄存器输出1234，实际液位是123.4cm，精度0.1cm。这种情况不需要非读成浮点，直接在数值显示元件里用16位整数读取，然后做线性变换：数值乘0.1加偏移0。EasyBuilder Pro的数值显示元件自带Scale和Offset功能，在属性里填就行。
如果数据带负数，先确认是16位有符号还是无符号。按无符号读取时，-2℃会显示成65534，需要改成有符号整数；如果元件不支持，就用宏把大于32767的原始值减65536再显示。
碰到两个寄存器合成32位整数、还要按位取状态量时，宏指令是最后手段。威纶通的宏可以把两个LW拼成一个32位变量，再按规则移位。但宏一多会影响扫描周期，我建议能用元件属性解决的绝不动用宏，只有说明书明确写了需要特殊算法时才启用。
4. 通信延时的组成与实测优化：从“能通”到“顺畅”
4.1 理论先算账：一条Modbus命令到底要多久
先算一笔账。9600bps下，RS485串口传输1个字节约1.04ms，因为1字节含起始位、数据位、停止位共10个位。一条读10个保持寄存器的RTU请求是8字节，约8.3ms；响应是5加10乘以2等于25字节，约26ms。加起来约34ms，这还没算从站CPU的处理时间。普通仪表响应耗时一般在5到50ms之间，加上帧间隙，一条命令典型耗时50到100ms。
如果画面里有30个过程值，来自12台仪表，又恰好每个地址一条命令，一轮轮询就是30乘以70ms约等于2.1秒。很多项目刚组态完感觉画面卡，不是触摸屏性能不行，而是总线上一堆命令在排队。
| 波特率 | 1字节传输时间 | 读10路响应总时间(估算) |
|---|---|---|
| 9600 | 1.04ms | 60~100ms |
| 19200 | 0.52ms | 35~60ms |
| 38400 | 0.26ms | 25~40ms |
| 115200 | 0.087ms | 15~25ms |
注意即使波特率到115200，命令耗时也不可能降到1ms量级，因为从站仪表本身的处理响应时间通常有5到20ms，这部分是省不掉的。
4.2 实际测量延时：两种办法
用Modbus Poll读取时，软件会显示每条命令的执行耗时，能直观看到单条请求从发送到收到响应用了多少毫秒。把USB转485串口接到总线上，Modbus Poll按相同参数读同一台仪表，观察单条命令耗时，基本就能估算出触摸屏那边的轮询节奏。
想要更精确，可以用串口监视器抓原始报文，对比两个时间戳：触摸屏发出请求的时间，和收到响应的时间。但串口监视器挂在总线上会占用节点，要注意别和主站冲突。
EasyBuilder Pro在线模拟时，也可以打开通信状态监控，查看驱动与设备之间的通信耗时和错误计数，这个在没有第三方工具时很实用。
4.3 优化顺序：先合并地址，再提波特率，最后动间隔
我自己的优化顺序是固定的：
- 先看地址能否合并。同一台仪表连续地址，开启批读取，让一条命令读更多寄存器。这一步最简单，效果最明显。
- 再考虑波特率。从9600升到19200或38400，对布线质量有要求。如果前期接线不规范，升到19200后偶发错帧，不如保持9600加合并地址。
- 然后检查命令间隔时间。默认0或太小导致总线不稳时，加到10到20ms让总线缓一缓；如果本身没有错帧，没必要加。
- 最后处理写操作。画面里频繁写设定值的按钮，尽量用写多个寄存器指令，减少总帧数。
- 公共窗口里不要挂带串口地址的显示元件。公共窗口每个画面切换都会刷新，等于成倍增加通信量。
4.4 一个12台仪表的实测对比
我经手过一个配电房测温项目，一台威纶通MT8102iE通过RS485挂12台Modbus RTU仪表，每台3个温度值，共36个过程量。最初直接在数值显示元件里一个个填地址，没开批读取，画面完整刷新一次约2.5秒。
后来按上面的顺序优化：开启连续地址批读取，每台仪表一次读连续3个寄存器，波特率保持9600，命令间隔设10ms。实测刷新降到0.7到0.8秒。
| 优化项 | 优化前 | 优化后 |
|---|---|---|
| 每条命令读取点数 | 每地址1点 | 每台3点连续 |
| 波特率 | 9600 | 9600 |
| 命令间隔 | 0ms | 10ms |
| 完整画面刷新周期 | 约2.5s | 约0.8s |
0.8秒对过程监控已经够用，但对需要秒级响应的操作画面可能还不够。如果要做快速操作，把数据先从串口读到LW，画面元件只显示LW，而不是直接显示串口地址，也能减少刷新压力。
5. 现场最常踩的五个坑和一个通用排查顺序
5.1 数值一直为0：先确认仪表到底有没有开通讯
遇到数值一直为0，先别急着怀疑触摸屏。很多仪表出厂默认关闭通讯功能，或者需要面板上开启RS485通讯使能，改完还要保存并重启。有一次现场师傅折腾一下午，最后发现仪表通讯参数改是改了，没按保存键，断电后恢复默认。
所以拿到新仪表，第一次上电先把说明书翻出来，把通讯参数设置、保存、重启三个动作做完，再连触摸屏。另外就是第3章说的地址区选错或者功能码不支持，用Modbus Poll能快速区分是哪种情况。
5.2 数值偶发跳变、突然掉线
间歇性通信问题，优先怀疑：
- 站号冲突，用排除法逐台断开确认
- 地线没共，把GND连上
- 屏蔽层悬空或两端都接地
- 缺少终端电阻
- 波特率设得过高
- 超时时间或命令间隔过小
排查这种间歇性问题，最好用Modbus Poll连续读取一段时间，观察错误计数。如果Modbus Poll也偶发错误，基本是物理层或从站问题；如果Modbus Poll稳定而触摸屏跳动，才去怀疑触摸屏侧的配置和轮询节奏。
5.3 浮点数量级不对：字序和类型双重检查
读出的数值如果是1.5e-40、3.0e28这种明显不在物理范围内的数，先怀疑字序，把ABCD、BADC、CDAB、DCBA四种格式依次试一遍。如果四种都试完还是不对，再看是不是根本不该用浮点——有些仪表把浮点拆成两个16位整数，或者用BCD码存储，这时要查说明书里的寄存器描述，而不是在触摸屏上硬解。
BCD码在部分累计量仪表里很常见，数据格式要选32-bit BCD而不是32-bit Float。这个问题在流量计上尤其常见。
5.4 公共窗口绑了通信地址，刷新慢到怀疑人生
有人会问威纶通触摸屏7号窗口怎么设置，这种特定编号窗口多半是公共窗口或者弹窗设置。在这个话题上我踩过一个坑：为了让每个画面都显示当前温度，把温度显示元件放在了公共窗口里。公共窗口在每个画面切换时都要刷新，开起来后整条485总线负载直接翻倍，画面卡得不行。
后来把数据展示都放各自画面，公共窗口只留不带地址的静态标题和功能按钮，问题就没了。凡是带Modbus地址的元件，尽量放在独立窗口，不要塞进公共窗口。公共窗口适合放纯文字、背景、不带地址的按钮。
5.5 一个通用排查顺序：先电脑，再触摸屏，最后测物理层
| 步骤 | 操作 | 排查内容 |
|---|---|---|
| 1 | 仪表面板或就地显示 | 物理量本身是否正确、通讯是否使能 |
| 2 | 电脑加Modbus Poll | 串口参数、站号、功能码、寄存器地址、数据类型 |
| 3 | EasyBuilder Pro | 地址区类型、偏移、数据类型、字序、倍率 |
| 4 | 现场物理层 | 线缆、终端电阻、共地、干扰、站号冲突 |
这个顺序反过来最容易浪费时间。很多人第一步就在触摸屏上改地址，改了一下午，最后拿电脑一读，发现仪表侧参数都是错的。先让电脑把数据读出来，就有了一个确定正确的基准。
6. 联调验证：先用电脑把数据读出来，再回头调触摸屏
6.1 Modbus Poll联机读仪表的基本设置
Modbus Poll是验证仪表数据最方便的工具，官方试用版就够用，不用费心找特殊版本。连接时用USB转485线，A接A、B接B，GND尽量接上。打开Modbus Poll后，在Setup里的Read/Write Definition填入站号、功能码、起始地址和寄存器数量，再把数据类型选成匹配的格式，点OK后就能看到周期轮询的数据。
如果显示超时，多数是串口参数不对，或者地址区、功能码选错。此时在Modbus Poll的Connection里把参数改成另一组继续试，比在触摸屏上盲改高效得多。
6.2 把Modbus Poll验证好的参数原样平移到触摸屏
用Modbus Poll确认能稳定读出数据后，把几个关键信息抄下来：站号、功能码是03还是04、起始地址从几开始、寄存器数量、数据类型、字序。
到EasyBuilder Pro里，站号填一样的，地址区类型按功能码选3x或4x，数值显示元件的数据类型和字序按Modbus Poll里验证过的设置。如果你之前不确定威纶通地址栏填0还是填1，现在就能判断了：Modbus Poll在不勾选PLC地址格式时填0读到数据，而威纶通里也填0能读出来的话，两个工具对偏移的处理是一致的；读不到就改成1再试一次。这个方法能解决所有地址差一的困惑。
6.3 没有电脑时的兜底方案
如果现场没有电脑，也有一个土办法：先在触摸屏上放一个数值显示元件，地址设为要读的寄存器，数据类型选16位无符号整数，让它显示原始值。对照仪表面板显示的物理量，反推寄存器里存的是原始值还是浮点、是整数倍率还是BCD。
比如原始值显示1234，面板显示123.4℃，说明是原始值乘0.1，后面加个线性变比就行；如果原始值是一堆毫无规律的大数，再试着切换到浮点类型和不同字序。这个办法虽然笨，但在紧急维护时很救命。
最后分享两个我做了这么多项目之后固定下来的习惯，一是先电脑后触摸屏，二是每个项目开工前把所有仪表的站号、功能码、起始地址、数据类型、字序、倍率整理成一张Excel表。把这两个习惯保持住，现场调试速度会有质的提升。再补一个小细节：仪表参数改完后，一定要断电重启并重新读一次，确认保存成功了再继续做画面，否则下次上电数据又乱套，你会以为是触摸屏的问题。