1. 现成库读不到数据的那天,我决定用 C# Socket 自己拼一遍 S7
现场一台 S7 系列 PLC,上位机用 C# 写数据采集,库里调个 Read("DB1.DBD0") 就完事。可一旦超时或者读回一堆零,黑盒里到底发没发连接请求、报文长度对不对、地址映射有没有偏,全看不见。那段时间我干脆把现成库放一边,用 .NET 自带的 Socket 从 102 端口开始,把 TPKT、COTP、S7 这三层报文自己拼了一遍。代码开发工具这件事有时就是这样:封装省事,但排错时你得知道每一字节从哪来。这篇记录的就是从 TCP 连接到读出 DB 块数据的完整路径,适合会一点 C#、被 S7 通信卡过的人照着做。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 102 端口之上不止一层:TPKT、COTP、S7 各自管什么
2.1 TPKT 与 COTP:先解决「一包到底多长」
很多人把 PLC 的 102 端口当成普通 TCP 服务,连上就直接发 S7 读写命令,结果 PLC 毫无反应。问题在于 102 端口上跑的不是裸 S7,最外层还有 TPKT,中间夹着 COTP。TPKT 只有 4 个字节,第一个字节固定 0x03,第二个字节保留为 0x00,第三、四字节是整个包的总长度,按大端存放。接收时如果不先读这 4 个字节,你根本不知道后面该收多少,TCP 流式接收很容易把两个响应粘在一起。
COTP 负责连接建立和数据传输。连接请求叫 CR,PDU 类型字节是 0xE0;连接确认叫 CC,类型字节是 0xD0;真正承载 S7 数据的是 DT,类型字节是 0xF0。CR 和 CC 里还会带 TPDU 大小、源 TSAP、目标 TSAP 这些参数,机架号和槽位号就藏在 TSAP 里。现场常见 CPU 是机架 0、槽位 1,但这不是万能值,得按硬件组态核对。
| 层 | 典型长度 | 关键字段 | 作用 |
|---|---|---|---|
| TPKT | 4 字节 | 版本、总长度 | 界定一个完整报文 |
| COTP | 3 字节起 | PDU 类型 CR/CC/DT | 建立 ISO 连接、承载数据 |
| S7 | 10 或 12 字节起 | ROSCTR、参数长度、数据长度 | 读写请求与响应 |
把这三层分开看,后面写代码时每个方法只负责一段,出错也容易定位。最怕的是一上来就抄一段几百字节的十六进制数组,连哪个字节是长度都不知道,换一台 PLC 就全乱。
2.2 S7 PDU:Job 和 Ack_Data 的区别
TPKT 和 COTP 之后才是 S7 报文。S7 头第一个字节是 0x32,第二个字节是 ROSCTR,请求用 0x01 表示 Job,响应里常见 0x03 表示 Ack_Data。后面依次是冗余标识、PDU 参考号、参数长度、数据长度。请求头是 10 字节,响应头多两个字节的错误类和错误码,所以解析响应时不能拿请求的偏移去套。
参数区第一个字节是功能码,读变量用 0x04,第二个字节是项数,读一个地址就填 0x01。再往后是变量规格,常见结构是 0x12 0x0A 0x10 开头,接着是传输尺寸、长度、DB 号、区域码和三字节位地址。数据区在响应里才出现,每个数据项带返回码、传输尺寸、按位计算的长度,最后才是真实数据。S7 多字节数值是大端,C# 的 BitConverter 在 x86 上按小端解释,解析 DWORD、REAL 时记得翻转。
2.3 一次读 DB1.DBD0 的字节级顺序
把一次完整交互拆开,顺序是固定的:
- 用
Socket连接 PLC 的 102 端口,设置发送和接收超时。 - 发送 COTP CR,读取返回的 CC,确认
0xD0且长度正常。 - 组装 S7 Job 报文,参数区填功能码
0x04、项数0x01,变量规格里填 DB 号 1、区域码0x84、字节偏移 0、长度 4。 - 发送 Job,按 TPKT 长度字段读满一个响应。
- 先看 S7 头的错误类和错误码,再看数据项返回码是不是
0xFF,最后按位长除以 8 取数据。
这五步里,第二步最容易被跳过。材料里有一句话很关键:只有 ISO 连接建立成功,才能进行后续的 S7 数据读写。TCP 三次握手只证明网络通了,不代表 PLC 的 ISO 层认了你。后面所有「连上了但读不到」的问题,十有八九要回到这一步查。
3. 用 C# Socket 完成 ISO-on-TCP 握手:CR 发出到 CC 校验
3.1 Socket 连接与超时:别让 Receive 无限等
先建一个薄传输层,只负责连接、发送、按 TPKT 长度收包。Socket.ReceiveTimeout 必须设,不设的话 PLC 不回数据时线程会一直挂在那里,产线上表现为采集程序莫名其妙卡死。SendTimeout 也一并设上,网络半开时至少能抛异常而不是静默。
csharp复制using System;
using System.IO;
using System.Net.Sockets;
public sealed class S7Transport : IDisposable
{
private readonly Socket _socket = new Socket(
AddressFamily.InterNetwork,
SocketType.Stream,
ProtocolType.Tcp);
private const int S7Port = 102;
public void Connect(string host, int timeoutMs = 3000)
{
_socket.ReceiveTimeout = timeoutMs;
_socket.SendTimeout = timeoutMs;
_socket.NoDelay = true; // 小报文别等 Nagle 合并
_socket.Connect(host, S7Port);
}
public void Send(byte[] pdu)
{
int sent = 0;
while (sent < pdu.Length)
{
sent += _socket.Send(pdu, sent, pdu.Length - sent, SocketFlags.None);
}
}
public byte[] ReceivePdu()
{
byte[] header = ReadExact(4);
int total = (header[2] << 8) | header[3]; // TPKT 总长度,大端
if (total < 7 || total > 4096)
throw new InvalidDataException($"TPKT 长度异常: {total}");
byte[] rest = ReadExact(total - 4);
byte[] pdu = new byte[total];
Buffer.BlockCopy(header, 0, pdu, 0, 4);
Buffer.BlockCopy(rest, 0, pdu, 4, rest.Length);
return pdu;
}
private byte[] ReadExact(int count)
{
byte[] buffer = new byte[count];
int offset = 0;
while (offset < count)
{
int n = _socket.Receive(buffer, offset, count - offset, SocketFlags.None);
if (n == 0) throw new IOException("PLC 关闭了连接");
offset += n;
}
return buffer;
}
public void Dispose() => _socket.Dispose();
}
ReadExact 是整个传输层的核心。TCP 只保证字节流顺序,不保证一次 Receive 就是一个完整 PDU。PLC 响应稍大一点,或者网络设备分片,一次可能只收到 TPKT 头的前两个字节。按长度循环读满,后面的解析才不会错位。NoDelay 设为 true 是避免小报文被 Nagle 算法压着,读单个位变量时体感会好一些。
3.2 构造 CR 并按 TPKT 长度收 CC
连接建立请求的字节不多,但机架和槽位要参数化。下面这份以常见机架 0、槽位 1 为例,0xC1 是源 TSAP,0xC2 是目标 TSAP,两个参数都带长度字节。
csharp复制private static byte[] BuildCotpCr(byte rack, byte slot)
{
return new byte[]
{
0x03, 0x00, 0x00, 0x16, // TPKT:版本 3,总长 22
0x11, 0xE0, // COTP:头长 17,CR
0x00, 0x00, // 目标引用
0x00, 0x01, // 源引用
0x00, // 协议类与选项
0xC0, 0x01, 0x0A, // TPDU 大小 1024 字节
0xC1, 0x02, rack, slot, // 源 TSAP:机架/槽位
0xC2, 0x02, 0x01, 0x00 // 目标 TSAP
};
}
public void Handshake(byte rack = 0, byte slot = 1)
{
Send(BuildCotpCr(rack, slot));
byte[] cc = ReceivePdu();
if (cc.Length < 7 || cc[5] != 0xD0)
throw new IOException($"COTP 连接失败,PDU 类型: 0x{cc[5]:X2}");
int cotpLen = cc[4];
if (cotpLen < 6 || cc.Length < 7 + (cotpLen - 6))
throw new IOException("COTP CC 长度字段不匹配");
}
BuildCotpCr 里 0x16 是总长 22,等于 TPKT 4 字节加 COTP 18 字节。0xC0 0x01 0x0A 表示协商 TPDU 大小为 1024,0x0A 就是 10 的 2 次方。源 TSAP 放机架和槽位,目标 TSAP 常见是 0x01 0x00。有些 CPU 对 TSAP 更敏感,如果 CC 一直不回,先确认硬件组态里的机架槽位,不要死磕代码。
Handshake 里校验 cc[5] == 0xD0 是最低要求。更稳一点还要看 cc[4] 这个 COTP 长度字段和实际数组长度是否对得上。曾经遇到一种情况,PLC 回了 CC,但长度字段和实际收到的字节数差两位,后面发 S7 请求就一直超时。把长度校验加上之后,问题当场现形。
3.3 CC 校验失败时看哪几个字节
CC 没回来或者类型不对,先看三个地方。第一看 cc[0] 是不是 0x03,不是的话说明对方回的根本不是 TPKT,可能是别的服务占用了端口。第二看 cc[5],0xD0 才是 CC,0xE0 说明对方还在发 CR,连接没谈拢。第三看 cc[4] 和数组长度,长度字段是 COTP 头长度,不是整个包长度,别和 TPKT 的总长混淆。
如果 TCP 连接本身失败,先查 102 端口通不通、PLC 是否允许 PUT/GET 通信。这一步属于网络和 PLC 组态,不是 C# 代码能解决的。代码里能做的,是把异常信息和已经收到的前几个字节打出来。血泪经验是:只打印「连接失败」四个字,等于没打;把十六进制前 8 字节打出来,很多时候一眼就能看出是端口错了还是 TSAP 错了。
4. C# 里做 S7 地址映射:DB1.DBD0 到字节偏移的换算
4.1 把地址拆成区域码、DB 号、字节偏移
S7 的地址写法好读,但协议里不用字符串。DB1.DBD0 要拆成区域码 0x84、DB 号 1、字节偏移 0、长度 4;M0.0 拆成区域码 0x83、字节偏移 0、位偏移 0、长度 1;I0.0 的区域码是 0x81,Q0.0 是 0x82。DB 块里还有 DBX、DBB、DBW、DBD 四种粒度,分别对应 1、1、2、4 字节。
| 地址前缀 | 区域码 | 说明 |
|---|---|---|
| DB | 0x84 |
数据块,需同时带 DB 号 |
| M | 0x83 |
位存储区 |
| I | 0x81 |
输入区 |
| Q | 0x82 |
输出区 |
解析函数不要图省事用 Split('.') 硬切,DB1.DBD0 和 M0.0 的结构不一样。下面这个版本把两类地址分开处理,返回统一的 S7Item,后面的组包方法只认结构体,不再碰字符串。
csharp复制using System;
using System.Text.RegularExpressions;
public readonly record struct S7Item(
byte Area, // 区域码
int DbNumber, // DB 号,非 DB 区为 0
int ByteOffset, // 字节偏移
byte BitOffset, // 位偏移 0-7
int ByteLength, // 读取字节数
bool IsBit); // 是否按位读
public static class S7Address
{
public static S7Item Parse(string address)
{
string text = address.Trim().ToUpperInvariant();
// DB1.DBD0 / DB1.DBW2 / DB1.DBB4 / DB1.DBX0.0
Match db = Regex.Match(text, @"^DB(\d+)\.DB([XBWD])(\d+)(?:\.(\d))?$");
if (db.Success)
{
int dbNo = int.Parse(db.Groups[1].Value);
char type = db.Groups[2].Value[0];
int offset = int.Parse(db.Groups[3].Value);
byte bit = db.Groups[4].Success ? byte.Parse(db.Groups[4].Value) : (byte)0;
int length = type switch { 'X' => 1, 'B' => 1, 'W' => 2, 'D' => 4, _ => 1 };
return new S7Item(0x84, dbNo, offset, bit, length, type == 'X');
}
// M0.0 / I0.0 / Q0.0
Match m = Regex.Match(text, @"^([MIQ])(\d+)(?:\.(\d))?$");
if (m.Success)
{
byte area = m.Groups[1].Value switch
{
"M" => (byte)0x83,
"I" => (byte)0x81,
"Q" => (byte)0x82,
_ => throw new ArgumentException("未知区域")
};
int offset = int.Parse(m.Groups[2].Value);
byte bit = m.Groups[3].Success ? byte.Parse(m.Groups[3].Value) : (byte)0;
bool isBit = m.Groups[3].Success;
return new S7Item(area, 0, offset, bit, 1, isBit);
}
throw new FormatException($"无法识别的 S7 地址: {address}");
}
}
ByteOffset 和 BitOffset 要分开存,组包时再合成三字节的位地址。DB1.DBD4 的位地址是 32,DB1.DBX0.0 的位地址是 0,M0.0 的位地址也是 0,但区域码不同。把位地址算成「字节偏移」是最常见的翻车点,后面排查章节会展开。
4.2 组装读请求:31 字节里每个位置放什么
一个读单地址的 Job 报文固定 31 字节,其中 TPKT 4 字节、COTP 3 字节、S7 头 10 字节、参数区 14 字节。参数区里功能码 0x04 和项数 0x01 占两字节,剩下 12 字节是变量规格。
csharp复制private static byte[] BuildReadRequest(ushort pduRef, S7Item item)
{
byte[] pdu = new byte[31];
// TPKT
pdu[0] = 0x03; pdu[1] = 0x00;
pdu[2] = 0x00; pdu[3] = 0x1F; // 总长 31
// COTP DT
pdu[4] = 0x02; pdu[5] = 0xF0; pdu[6] = 0x80;
// S7 头(Job 固定 10 字节)
pdu[7] = 0x32; // 协议标识
pdu[8] = 0x01; // ROSCTR = Job
pdu[9] = 0x00; pdu[10] = 0x00; // 冗余标识
pdu[11] = (byte)(pduRef >> 8); pdu[12] = (byte)pduRef;
pdu[13] = 0x00; pdu[14] = 0x0E; // 参数区长度 14
pdu[15] = 0x00; pdu[16] = 0x00; // 数据区长度 0
// 参数区:读变量 + 项数
pdu[17] = 0x04;
pdu[18] = 0x01;
// 变量规格:12 字节
pdu[19] = 0x12; // 规格类型
pdu[20] = 0x
