GJ 199 PROFINET 磁致伸缩位移传感器：GSDML 组态与报文

PROFINET 上的 199 系列磁致伸缩位移传感器，不是接上网线就能出数。设备描述文件里几个字段直接决定你拿到的是整数计数还是毫米，也决定组态能不能一次通过。这里只讲组态和解析真正会用到的部分，接口细节以随货说明为准。

GSDML 里真正要看的是这几个字段

文件打开有几百行，对组态有实际影响的就是这么几项。任何一项对不上，后面怎么调都是白费。

字段	文件里的值	它是干什么的
格式版本	V2.31	低于此版本控制器读不全，表现为缺型号
厂商标识	0x0626	控制器按它归到哪个厂商目录下
设备标识	0x1234	与厂商标识组合，才能精确指到本型号
站名兼容名	GJ-position-sensor	分配设备名的依据，不能自己起
最小设备间隔	8 ms	更新周期的硬下限，低于它组态报错
输入长度	26 字节	模块固定值，组态里改不了
输出长度	6 字节	同上
长度上限	输入输出各 64 字节	加装其他模块时的总容量

版本这一项值得单独提：设备描述文件本身是 V2.31 格式。装到控制器的旧版本目录里不会报错，但型号列表里就是找不到这个设备，扫描时看起来像"设备没上电"，其实是文件没认出来。

装完先做三件事，错一件后面白费

文件装进控制器只是第一步。站名、IP 和更新周期这三样不配对，应用关系就建不起来，后面所有调试都是在空气里做。

站名要照着文件里的兼容名分配，不能自己起一个顺口的。写错的症状很有辨识度：网口链路灯正常亮着，说明物理层没问题，但设备死活不进数据交换状态。这时不要怀疑网线和水晶头，回来看站名。

更新周期有一条硬下限 8 ms。设成 4 ms 或 2 ms，控制器在组态阶段就报错，不是等运行起来才出问题。这个下限来自文件里的最小设备间隔字段，改不了；想要更快只能换一套方案，不是调参数能解决的。

还有一点容易漏：设备描述里声明了站名不通过网口传递。也就是说站名只能由控制器写进去，不能靠设备自带的拨码或者网页设置，换控制器就得重新分配一次。

26 字节输入怎么变成毫米

模块的输入长度是 26 字节，里面装的是位置、速度和状态三组数据。位置是整型计数，既不是毫米也不是微米。要把它变成工程量，得先知道参数记录里选的是哪一档分辨率。

分辨率有六档，每档决定一个计数代表多少长度，速度的工程单位同时跟着变：

参数取值	一个计数等于	速度单位	十万计数对应行程
1000	1 μm	0.1 mm/s	100 mm
2000	2 μm	0.2 mm/s	200 mm
5000	5 μm	0.5 mm/s	500 mm
10000	10 μm	1.0 mm/s	1 m
50000	50 μm	5.0 mm/s	5 m
100000	100 μm	10.0 mm/s	10 m

换算关系只有一条：毫米 = 计数 × 分辨率（μm）÷ 1000。选 1 μm 档时十万个计数是 100 mm，选 100 μm 档时同样十万个计数就是 10 m。

行程越长越要往大分辨率上选，否则计数位早早用完。反过来说，行程只有三百毫米却选了 100 μm 档，一个计数就是 0.1 mm，细调的时候会觉得设备"分辨率不够"，其实是自己把精度扔掉了。

有个现象常被当成故障：换了分辨率档位，但参数没有重新下载，控制器还按旧档位换算，读数和实际行程对不上。位置值本身是对的，错在换算系数。

方向参数：连接器侧是零还是满

参数记录里有一个方向位，两档取值，含义写得很直白：取 0 时连接器侧是最小值，取 1 时连接器侧是最大值。

这条定义要和"安装方向"分开看。机械上把尺子调头装，读数会反；参数里再改一次方向，就成了双重反转，读数看着"正常"，却和图纸标的基准端对不上，这种问题排查时最难想到。现场省事的做法是机械怎么装都不动，只改这一个位。

改完必须下载。参数记录不下发到设备侧，设备用的是上一组值，界面看着已经改了，实际没生效。

一台设备给两台控制器读

文件里声明了支持共享设备，可以同时建立两个应用关系。常见用法是主控做闭环，上位监控或安全控制器另建一个连接取趋势和做联锁。

两点要注意：两个连接各自分配站名和 IP，参数各下发一次，不要以为改了一个另一个会跟着变；拆掉其中一个连接时另一个不受影响，但站名一旦被改，两个会一起断。

现场六个坑

现象	大概率原因	怎么处理
扫描不到设备	文件版本低，或装了别的型号的描述	确认 V2.31，重装后重新扫描
链路灯亮，不进数据交换	站名与兼容名不一致	按文件里的名称重新分配，不用换网线
组态阶段报周期非法	更新周期设得比 8 ms 还小	调到 8 ms 及以上
位置是个大整数，对不上行程	没有按分辨率换算	按参数记录里的档位换算成毫米
改了方向，读数没变	参数没下载	重新下载参数，必要时断电重启
环网断一路后数据中断一下	环网收敛需要时间	属正常行为，不要急着换设备

环网那一项单独说一句：断掉一路后通讯能自己恢复，但收敛过程需要时间，表现是一段短暂的数据中断。这是环网的正常机制，拿去当故障处理只会白换件。

调试顺序和 EtherCAT 不一样

总线类产品的排查顺序不能混。EtherCAT 那边先看过程数据映射对不对，PROFINET 这边先看站名和更新周期——这两个不对，过程数据根本不会来。顺序理清了，26 字节里那三个数才有意义。

如果现场读数在动但方向或数值不对，先别急着怀疑传感器本体，把参数记录里的分辨率和方向位对一遍，八成能省下一次返工。

这篇管的是文件字段和报文换算。设备名怎么分、RT 与 IRT 怎么取舍，在199 的 IRT 与设备名分配里；掉站后的端口级定位在PROFINET 诊断里；从零开始的第一遍操作在PROFINET 入门里。两种以太网之间拿不准，197 的 EtherCAT 版本和195 的 PROFIBUS 版本可以并着看。