前言
搞工业上位机软件，数据转换是绕不开的活儿。串口收上来一堆字节，得转成有符号整数、浮点数、工程量；要给PLC发指令，又得把工程值打包成字节数组。每个设备厂家的大小端还不一样——西门子是大端，Modbus是大端，有些国产设备又是小端，稍不留神数值就完全不对了。
这活儿干多了，慢慢把常用的转换方法收拢到一个工具类里，涵盖字节与基本类型互转、大小端互换、十六进制处理、各品牌PLC数据解析、工程量换算，还有串口协议里的帧提取和校验。这个 DataConvert 类在实际项目中跑了好几年，今天整理出来分享一下。
项目介绍
DataConvert 是一个针对工业上位机场景的C#数据转换工具类，纯静态方法调用，零外部依赖。它解决的问题很简单：让工业通讯协议里的字节数据，能准确、方便地转成业务代码能用的数值类型。
整个类按功能划分成十个模块，从基础的字节转Int/Float，到Modbus寄存器和西门子S7的专用解析，再到4-20mA电流换算、串口帧提取，基本覆盖了工控软件开发中常见的数据处理场景。
项目功能
按模块梳理如下：
| 模块 | 功能说明 |
|---|---|
| 字节与基本类型互转 | 字节数组转Int16/Int32/Int64/Float/Double，支持大小端指定；反向转换同样支持 |
| 字节与Bool互转 | 字节数组按位解析为Bool数组，或将Bool数组打包成字节 |
| 大小端转换 | 字节数组反转、16位/32位数值的大小端互换 |
| 十六进制转换 | 字节数组与十六进制字符串互转，支持多种分隔符格式 |
| 字符串与编码转换 | UTF-8、ASCII、GBK编码下的字节与字符串互转 |
| PLC数据解析 | Modbus寄存器转浮点数/整型、CRC16校验；西门子S7浮点解析与BCD码转换；欧姆龙数据解析 |
| 工程量转换 | 原始值与工程值线性映射、4-20mA与工程量互转、ADC值转温度 |
| 串口数据帧解析 | 从接收缓冲区中查找帧头、提取完整数据帧、计算累加和/异或校验 |
| 数据合并与拆分 | 合并多个字节数组、截取子数组、按固定长度拆分 |
| 位操作与校验算法 | 字节和字的位读写、CRC16/CRC32校验计算 |
项目特点
1、方法命名统一：BytesToXxx 和 XxxToBytes 成对出现，看到名字就知道怎么用，不需要翻文档。
2、大小端参数全覆盖：每个数值转换方法都有 isBigEndian 参数，默认小端，需要大端时传 true 即可。
3、PLC协议针对性处理：Modbus、西门子S7、欧姆龙这三种国内工控最常见的PLC，都有专门的解析方法，不需要自己再写一遍字节拼装逻辑。
4、串口粘包处理：ExtractFrames 方法能从不断收到的数据流中按帧头提取完整报文，剩下没处理完的数据自动缓存，下次继续解析，省了不少粘包拆包的麻烦。
5、无外部依赖：全是 .NET 原生 API，复制到任何项目里都能直接用。
项目技术
| 技术点 | 具体实现 |
|---|---|
| BitConverter | 用于字节数组与 Int16、Int32、Int64、Single、Double 等基本类型的互转 |
| 位运算 | 通过 &、|、<<、>> 操作实现字节内位的读写，以及Bool数组与字节的打包解包 |
| 数组操作 | Array.Copy 实现字节片段拷贝，Array.Reverse 实现大小端反转 |
| Encoding 编码 | 支持 UTF-8、ASCII、GBK 编码的字符串与字节互转，其中GBK需要注册 CodePagesEncodingProvider |
| CRC 校验算法 | 分别实现了 CRC16-Modbus (多项式0xA001) 和 CRC16-CCITT (0x8408) 以及 CRC32 |
| 流式数据处理 | 使用 MemoryStream 构建数据帧，用查找算法从缓冲区中定位帧头 |
项目代码
工具类代码量不小，核心部分挑几个典型的用法说一下。
字节数组转数值（支持大小端）
// 小端模式下，字节 [0x34, 0x12] 转 ushort = 0x1234
ushort value1 = DataConvert.BytesToUInt16(new byte[] { 0x34, 0x12 }, 0, false);
// 大端模式下，字节 [0x12, 0x34] 转 ushort = 0x1234
ushort value2 = DataConvert.BytesToUInt16(new byte[] { 0x12, 0x34 }, 0, true);
BytesToInt16、BytesToInt32、BytesToFloat、BytesToDouble 的方法签名一致，用起来不需要记忆额外的转换逻辑。
Modbus寄存器解析
Modbus协议里，32位浮点数占用两个寄存器，且通常是大端存储（AB CD）。ModbusRegistersToFloat 方法把两个 ushort 寄存器拼成4字节，直接转为 float：
ushort[] registers = new ushort[] { 0x3F80, 0x0000 }; // 对应浮点数 1.0
float value = DataConvert.ModbusRegistersToFloat(registers, 0);
反向转换 FloatToModbusRegisters 同样可用。
从串口接收缓冲区提取数据帧
串口通讯里，粘包是家常便饭。ExtractFrames 配合帧头长度，能把完整帧捞出来，剩下的数据留到下次处理：
byte[] buffer = ...; // 从串口读到的原始数据
byte[] header = new byte[] { 0xAA, 0x55 };
int frameLength = 12; // 每帧12字节
ExtractFrames(buffer, header, frameLength, out List<byte[]> frames, out byte[] remaining);
foreach (var frame in frames) {
// 处理完整帧
}
// 下次收到数据时，把 remaining 拼到新数据后面再解析
4-20mA电流转工程量
模拟量采集常用4-20mA信号，对应到0-100MPa的压力值，一行就能算出来：
// 12mA 电流，量程 0-100MPa
double pressure = DataConvert.Current4To20ToEngineering(12.0, 0, 100); // 结果: 50
项目效果
在实际上位机项目里，工具类接入过Modbus RTU串口设备、西门子S7-1200/1500 PLC，以及一些国产仪表的自定义协议。几类场景下的表现：
数值转换准确性：与PLC内部监控值对比，Float、Int32、BCD码的解析结果一致，没有出现字节序错误导致的数值跳变。
帧解析稳定性：ExtractFrames 方法在处理连续高速数据时，未出现帧错位或丢帧，缓冲区残留数据也能正确缓存。
代码可读性：调用方不再需要写重复的字节拼装和移位操作，业务层代码量明显减少。
项目源码
完整的 DataConvert 工具类代码已整理好，包含十个功能模块，可以直接复制到项目中使用。
代码结构如下：
UpperComputer.Utils/
└── DataConvert.cs
├── 字节数组与基本类型互转 (Int16/32/64, Float, Double, Bool)
├── 大小端转换 (ReverseBytes, SwapEndian16/32)
├── 十六进制转换 (BytesToHexString, HexStringToBytes)
├── 字符串与字节互转 (UTF-8, ASCII, GBK)
├── PLC数据解析 (Modbus, 西门子S7, 欧姆龙)
├── 工程量转换 (线性映射, 4-20mA, ADC转温度)
├── 串口数据帧解析 (提取帧, 累加和, 异或校验)
├── 数据合并与拆分 (MergeBytes, SubBytes, SplitBytes)
├── 位操作 (GetBit, SetBit, GetBits)
└── 常用校验算法 (CRC16, CRC32)
总结
DataConvert 这个工具类，本质上是把工业上位机开发里那些高频、重复的数据转换操作，沉淀成了一套统一的API。它不解决业务问题，但能让业务代码写得顺手一些——不需要每次遇到字节序、Modbus、CRC校验都重新查资料、重新写一遍。
大家也在做类似的上位机软件开发，这份代码可以直接拿来用，也可以按自己的需求裁剪或扩展。数据转换的坑不少，有个趁手的工具类至少能少踩几脚。
关键词
上位机开发，数据转换，C#工具类，字节数组转换，大小端处理，Modbus协议，西门子PLC，CRC校验，串口通讯，工程量换算，位操作，十六进制转换，PLC数据解析，帧提取
最后
如果你觉得这篇文章对你有帮助，不妨点个赞支持一下！你的支持是我继续分享知识的动力。如果有任何疑问或需要进一步的帮助，欢迎随时留言。
也可以加入微信公众号 [DotNet技术匠] 社区，与其他热爱技术的同行一起交流心得，共同成长！
优秀是一种习惯，欢迎大家留言学习！
