激光打标机TCP Socket通信协议：KZ指令集实战

激光打标机TCP Socket通信协议KZ指令集实战一、引言定位到打标区域后上位机需要控制激光打标机执行打标。本项目通过TCP Socket与打标机软件通信使用一套自定义的KZ指令集。本文从第一性原理出发讲解TCP通信的本质并结合项目中的Laser.cs代码深入剖析Socket连接、指令收发、协议握手、打标流程等关键技术。二、第一性原理TCP通信的本质2.1 什么是TCPTCPTransmission Control Protocol是互联网的基础传输协议提供可靠的、面向连接的字节流传输。与UDP不同TCP保证数据按序到达、不丢失、不重复。2.2 客户端/服务器模型TCP通信采用客户端/服务器C/S模型服务器Server监听端口等待连接。客户端Client主动连接服务器。本项目上位机是客户端打标机软件是服务器。上位机主动连接打标机的IP和端口。2.3 长连接与短连接TCP连接有两种模式短连接每次通信都建立连接用后即断。长连接建立一次连接多次通信用后关闭。本项目使用长连接因为打标流程包含多个步骤连接、加载模板、设置内容、执行、关闭需要保持连接状态。三、项目中的TCP通信3.1 连接参数在Laser.cs中定义了服务器地址和端口privateconststringserverIP192.168.30.31;// 打标机IPprivateconstintport6060;// 打标机端口3.2 创建TCP连接CreateTcp方法建立TCP连接privateboolCreateTcp(){try{clientnewTcpClient(serverIP,port);// 长连接Thread.Sleep(100);streamclient.GetStream();// 获取网络流stringresponseReceiveResponse();responseresponse.Replace(\r\n,);// 去掉换行if(responseOK){returntrue;}else{Console.WriteLine(创建Tcp失败);returnfalse;}}catch(Exceptionex){Console.WriteLine(创建Tcp失败:ex.Message);returnfalse;}}关键点new TcpClient(serverIP, port)创建TCP客户端并连接服务器。client.GetStream()获取网络流用于读写数据。Thread.Sleep(100)等待服务器响应。握手验证连接后接收服务器返回的OK验证连接成功。3.3 发送指令SendCommand方法发送指令privatevoidSendCommand(stringcommand){if(stream!nullstream.CanWrite){byte[]dataEncoding.ASCII.GetBytes(command);stream.Write(data,0,data.Length);}}指令以ASCII编码发送以\r\n结尾如KZOpenRequest\r\n。3.4 接收响应ReceiveResponse方法接收响应privatestringReceiveResponse(){if(stream!nullstream.CanRead){try{byte[]datanewbyte[1024];intbytesstream.Read(data,0,data.Length);Console.WriteLine(Received bytes: bytes);if(bytes0){Console.WriteLine(Raw data: BitConverter.ToString(data,0,bytes));stringresponseEncoding.UTF8.GetString(data,0,bytes);returnresponse;}else{MessageBox.Show(No data received from server.);returnnull;}}catch(Exceptionex){MessageBox.Show(Error receiving response: ex.Message);returnnull;}}returnnull;}四、KZ指令集详解4.1 指令集概览项目使用的KZ指令集包括指令方向说明KZOpenRequest上位机→打标机请求打开KZOpenOk打标机→上位机打开成功KZSetFile: 路径上位机→打标机加载模板文件KZSetFile打标机→上位机模板加载成功KZSetContent: TEXT1,内容上位机→打标机设置打标内容KZSetContentOK打标机→上位机内容设置成功KZRequest上位机→打标机请求执行打标KZFinished打标机→上位机打标完成KZCloseRequest上位机→打标机请求关闭KZCloseOK打标机→上位机关闭成功4.2 指令格式指令采用文本协议格式为指令名[: 参数]\r\n指令名如KZOpenRequest。参数可选用冒号分隔如KZSetFile: D:\template.txt。结尾\r\n回车换行。4.3 响应匹配上位机发送指令后接收响应并匹配privateboolConnectTcp(){try{SendCommand(KZOpenRequest\r\n);// 发送打开请求Thread.Sleep(100);stringresponseReceiveResponse();responseresponse.Replace(\r\n,);// 去掉换行if(responseKZOpenOk)// 匹配响应{returntrue;}else{Console.WriteLine(连接失败);returnfalse;}}catch(Exceptionex){Console.WriteLine(连接失败:ex.Message);returnfalse;}}五、完整打标流程5.1 Run方法Run方法编排了完整的打标流程publicvoidRun(){boolret;retCreateTcp();// 1. 创建TCP连接if(!ret){return;}retConnectTcp();// 2. 打开连接if(!ret){stream.Close();client.Close();return;}retLoadTemplate();// 3. 加载模板if(!ret){stream.Close();client.Close();return;}retLoadContent();// 4. 设置内容if(!ret){stream.Close();client.Close();return;}retEngrave();// 5. 执行打标if(!ret){stream.Close();client.Close();return;}retCloseTcp();// 6. 关闭连接if(!ret){stream.Close();client.Close();return;}stream.Close();client.Close();}5.2 流程状态机这个流程是一个顺序状态机创建连接 → 打开 → 加载模板 → 设置内容 → 执行打标 → 关闭每一步都检查返回值失败则中断并关闭连接。这种顺序执行、失败即停的模式保证了打标流程的可靠性。5.3 加载模板LoadTemplate方法加载打标模板privateboolLoadTemplate(){try{SendCommand(KZSetFile: CConfig.TemplatePath\r\n);// 发送模板路径Thread.Sleep(100);stringresponseReceiveResponse();if(responseKZSetFile)// 匹配响应{returntrue;}else{Console.WriteLine(加载模板失败);returnfalse;}}catch(Exceptionex){Console.WriteLine(加载模板失败:ex.Message);returnfalse;}}模板路径从配置中读取CConfig.TemplatePath通过KZSetFile指令发送给打标机。5.4 设置内容LoadContent方法设置打标内容privateboolLoadContent(){try{SendCommand(KZSetContent: TEXT1,公司名称\r\n);// 设置内容Thread.Sleep(100);stringresponseReceiveResponse();if(responseKZSetContentOK){returntrue;}else{Console.WriteLine(设置内容失败);returnfalse;}}catch(Exceptionex){Console.WriteLine(设置内容失败:ex.Message);returnfalse;}}KZSetContent: TEXT1,公司名称表示在TEXT1文本框中设置内容为公司名称。5.5 执行打标Engrave方法执行打标privateboolEngrave(){try{SendCommand(KZRequest\r\n);// 请求打标Thread.Sleep(1000);// 等待打标完成stringresponseReceiveResponse();if(responseKZFinished)// 打标完成{returntrue;}else{Console.WriteLine(打标失败);returnfalse;}}catch(Exceptionex){Console.WriteLine(打标失败:ex.Message);returnfalse;}}打标是耗时操作Thread.Sleep(1000)等待1秒后接收KZFinished响应。六、打标控制界面6.1 LaserLettering窗体项目还提供了一个独立的打标控制界面LaserLettering.cs允许用户手动控制打标流程privatevoidSetConnect_Click(objectsender,EventArgse){clientnewTcpClient(serverIP,port);// 连接Thread.Sleep(1000);streamclient.GetStream();stringresponseReceiveResponse();responseresponse.Replace(\r\n,);if(responseOK){}else{MessageBox.Show(Failed to connect to server.);}}这个界面提供了连接、打开、设置内容、执行、关闭等按钮方便调试和手动操作。6.2 手动控制按钮LaserLettering界面包含多个控制按钮SetConnect连接服务器。ConformConnect确认连接发送KZOpenRequest。SetContent设置内容。ExecuteEngrave执行打标。CloseEquipment关闭设备。Run一键执行完整流程。七、TCP通信的工程要点7.1 可靠性设计握手验证连接后验证OK响应确保连接成功。响应匹配每条指令都匹配预期响应失败即中断。异常处理用try/catch捕获通信异常。7.2 时序控制Thread.Sleep指令间用Sleep等待响应避免发送过快。超时打标等耗时操作需要足够长的等待时间。7.3 协议设计建议指令规范化指令名、参数格式统一。响应明确每个指令有明确的成功/失败响应。版本管理协议变更时做好版本兼容。八、总结本文从第一性原理出发讲解了激光打标机TCP Socket通信协议TCP通信本质可靠的字节流传输C/S模型。长连接一次连接多次通信。KZ指令集文本协议指令参数换行。打标流程创建→打开→加载模板→设置内容→执行→关闭。状态机顺序执行、失败即停。TCP通信是上位机控制外部设备的重要手段。下一篇文章将深入讲解INI配置文件读写技术。