XYD_ScrewDriver.cs 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Net;
  4. using System.Net.Sockets;
  5. using System.Text;
  6. using System.Threading.Tasks;
  7. using TeamAAS_VP.Enums;
  8. using TeamAAS_VP.Interfaces;
  9. namespace TeamAAS_VP.Core.ScrewDriver
  10. {
  11. /// <summary>
  12. /// XYD 系列电动螺丝刀数据读取与解析器。
  13. /// 通过 UDP 向设备发送 "GET_TSPC" 探测命令并接收包含 TSPB/TSPA 数据包的响应,
  14. /// 解析设备返回的扭矩、角度、速度、时间等曲线和结果信息。
  15. /// </summary>
  16. public class XYD_ScrewDriver : IScrewDriver
  17. {
  18. private Socket _socket;
  19. private IPEndPoint _endPoint;
  20. // 协议最小数据长度(TSPB 固定头与描述长度)
  21. private const int MinDataLength = 508;
  22. #region 属性
  23. public Guid Id { get; private set; }
  24. private bool _isConnected;
  25. /// <summary>
  26. /// 当前连接状态(是否已与设备建立连接并成功接收过有效数据)。
  27. /// </summary>
  28. public bool IsConnected => _isConnected;
  29. /// <summary>
  30. /// 螺丝刀设备 IP 地址。
  31. /// </summary>
  32. public string IPAdress { get; private set; }
  33. /// <summary>
  34. /// 设备端口号。
  35. /// </summary>
  36. public int Port { get; private set; }
  37. /// <summary>
  38. /// 螺丝刀品牌标识(XYD 固定)。
  39. /// </summary>
  40. public ElectricScrewdriverBrand Brand => ElectricScrewdriverBrand.XYD;
  41. /// <summary>
  42. /// 螺丝编号(设备返回的整型编号)。
  43. /// </summary>
  44. public int ScrewNum { get; private set; }
  45. /// <summary>
  46. /// 曲线采样频率(单位:Hz 或协议定义的采样单位)。
  47. /// </summary>
  48. public int Frequency { get; private set; }
  49. /// <summary>
  50. /// 结果时间戳(设备返回的年月日时分秒)。
  51. /// </summary>
  52. public DateTime ResultDateTime { get; private set; }
  53. /// <summary>
  54. /// 锁止角(单位:度)。
  55. /// </summary>
  56. public double LockAngel { get; private set; }
  57. public double StrokeAngle1 { get; private set; }
  58. public double StrokeAngle2 { get; private set; }
  59. public double StrokeAngle3 { get; private set; }
  60. public double StrokeAngle4 { get; private set; }
  61. public double StrokeAngle5 { get; private set; }
  62. public double StrokeTorque1 { get; private set; }
  63. public double StrokeTorque2 { get; private set; }
  64. public double StrokeTorque3 { get; private set; }
  65. public double StrokeTorque4 { get; private set; }
  66. public double StrokeTorque5 { get; private set; }
  67. /// <summary>
  68. /// 峰值扭矩(单位:N·m,协议返回值需乘以 0.001)。
  69. /// </summary>
  70. public double MaxTorque { get; private set; }
  71. public double OverlockAngle { get; private set; }
  72. /// <summary>
  73. /// 过锁扭矩(单位:N·m)。
  74. /// </summary>
  75. public double OverlockTorque { get; private set; }
  76. public double SlopeCheck { get; private set; }
  77. public double ClampingAngle { get; private set; }
  78. public double ClampingAngleCheck { get; private set; }
  79. public double FitAngle { get; private set; }
  80. public double FitAngleCheck { get; private set; }
  81. /// <summary>
  82. /// 夹紧扭矩(单位:N·m)。
  83. /// </summary>
  84. public double ClampingTorque { get; private set; }
  85. public double ClampingTorqueCheck { get; private set; }
  86. /// <summary>
  87. /// 过程最大扭矩(单位:N·m)。
  88. /// </summary>
  89. public double ProcessMaxTorque { get; private set; }
  90. public double ProcessMaxTorqueCheck { get; private set; }
  91. public double FitPointCoord { get; private set; }
  92. public double FitAngle1 { get; private set; }
  93. /// <summary>
  94. /// 贴合点扭矩(单位:N·m)。
  95. /// </summary>
  96. public double FitTorque { get; private set; }
  97. public double SectionTooth { get; private set; }
  98. public double SectionStroke1 { get; private set; }
  99. public double SectionStroke2 { get; private set; }
  100. public double SectionStroke3 { get; private set; }
  101. public double SectionStroke4 { get; private set; }
  102. public double SectionStroke5 { get; private set; }
  103. public double SectionLockAngle { get; private set; }
  104. public double SectionLockFinish1 { get; private set; }
  105. public double SectionOverLock { get; private set; }
  106. public double SectionFinalEnd { get; private set; }
  107. /// <summary>
  108. /// 解析出的错误信息或结果说明(根据设备返回码映射)。
  109. /// </summary>
  110. public string ErrorInfo { get; private set; }
  111. /// <summary>
  112. /// 本次结果是否判定为成功(设备返回结果码为 4 表示成功)。
  113. /// </summary>
  114. public bool Success { get; private set; }
  115. public int ProgramNumber { get; private set; }
  116. /// <summary>
  117. /// 总圈数(单位:圈,协议返回为度需除以 360)。
  118. /// </summary>
  119. public double Truns { get; private set; }
  120. /// <summary>
  121. /// 结果扭矩值(单位:N·m)。
  122. /// </summary>
  123. public double TorqueValue { get; private set; }
  124. /// <summary>
  125. /// 锁付时长(单位:秒)。
  126. /// </summary>
  127. public int FinalTime { get; private set; }
  128. /// <summary>
  129. /// 曲线数据集合(解析后的时间、角度、扭矩、斜率等)。
  130. /// </summary>
  131. public List<WaveData> WaveDatas { get; } = new List<WaveData>();
  132. #endregion
  133. #region 事件
  134. /// <summary>
  135. /// 连接状态变化事件,参数:sender, connected。
  136. /// 当连接状态改变时触发(包括连接失败/成功与获取数据后状态更新)。
  137. /// </summary>
  138. public event Action<object, bool> ConnectStateChangedEvent;
  139. #endregion
  140. /// <summary>
  141. /// 构造函数,初始化目标设备的 IP 与端口。
  142. /// </summary>
  143. /// <param name="ip">设备 IP 地址</param>
  144. /// <param name="port">设备 UDP 端口</param>
  145. public XYD_ScrewDriver(string ip, int port)
  146. {
  147. IPAdress = ip;
  148. Port = port;
  149. Id=Guid.NewGuid();
  150. }
  151. /// <summary>
  152. /// 确保内部 Socket 已创建并配置好超时与目标 EndPoint。
  153. /// 如果已存在则直接返回。
  154. /// </summary>
  155. private void EnsureSocket()
  156. {
  157. if (_socket == null)
  158. {
  159. _socket = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, ProtocolType.Udp);
  160. // 发送/接收超时,避免阻塞 UI 线程过久
  161. _socket.SendTimeout = 1000;
  162. _socket.ReceiveTimeout = 2000;
  163. _endPoint = new IPEndPoint(System.Net.IPAddress.Parse(IPAdress), Port);
  164. }
  165. }
  166. /// <summary>
  167. /// 同步连接到设备并进行一次探测(发送 GET_TSPC 并解析响应)。
  168. /// 返回是否成功连接并解析到有效数据。
  169. /// </summary>
  170. public bool Connect()
  171. {
  172. try
  173. {
  174. EnsureSocket();
  175. _socket.Connect(_endPoint);
  176. // 发送探测命令并等待响应
  177. if (!SendGetTspc())
  178. {
  179. UpdateConnectState(false);
  180. return false;
  181. }
  182. byte[] data = ReceiveOnce();
  183. if (data==null || data.Length==0)
  184. {
  185. return false;
  186. }
  187. //if (data == null || !DataAnalysis(data))
  188. //{
  189. // UpdateConnectState(true);
  190. // return true;
  191. //}
  192. UpdateConnectState(true);
  193. return true;
  194. }
  195. catch (Exception)
  196. {
  197. UpdateConnectState(false);
  198. return false;
  199. }
  200. }
  201. /// <summary>
  202. /// 异步版本的 Connect。
  203. /// </summary>
  204. public Task<bool> ConnectAsync()
  205. {
  206. return Task.Run(() => Connect());
  207. }
  208. /// <summary>
  209. /// 向设备请求数据并解析,最多尝试若干次(容错网络丢包)。
  210. /// </summary>
  211. public bool GetData()
  212. {
  213. if (_socket == null)
  214. {
  215. EnsureSocket();
  216. }
  217. // 允许多次重试以应对 UDP 丢包/超时
  218. for (int i = 0; i < 10; i++)
  219. {
  220. try
  221. {
  222. if (!SendGetTspc())
  223. continue;
  224. byte[] data = ReceiveOnce();
  225. if (data == null)
  226. continue;
  227. if (!DataAnalysis(data))
  228. continue;
  229. UpdateConnectState(true);
  230. return true;
  231. }
  232. catch (Exception)
  233. {
  234. UpdateConnectState(false);
  235. }
  236. }
  237. return false;
  238. }
  239. /// <summary>
  240. /// 异步版本的 GetData。
  241. /// </summary>
  242. public Task<bool> GetDataAsync()
  243. {
  244. return Task.Run(() => GetData());
  245. }
  246. /// <summary>
  247. /// 发送协议探测命令 "GET_TSPC" 到设备。
  248. /// 返回是否发送成功。
  249. /// </summary>
  250. private bool SendGetTspc()
  251. {
  252. try
  253. {
  254. var cmd = "GET_TSPC";
  255. var bytes = Encoding.ASCII.GetBytes(cmd);
  256. _socket.SendTo(bytes, _endPoint);
  257. return true;
  258. }
  259. catch
  260. {
  261. // 发送失败通常来自网络/Socket 状态,调用方会做重试或断开处理
  262. return false;
  263. }
  264. }
  265. /// <summary>
  266. /// 从 Socket 接收一次数据(单次 ReceiveFrom),并返回实际接收到的字节数组。
  267. /// 超时或异常返回 null。
  268. /// </summary>
  269. private byte[] ReceiveOnce()
  270. {
  271. try
  272. {
  273. EndPoint remote = new IPEndPoint(System.Net.IPAddress.Any, 0);
  274. byte[] buf = new byte[_socket.ReceiveBufferSize];
  275. int len = _socket.ReceiveFrom(buf, ref remote);
  276. if (len <= 0) return null;
  277. var data = new byte[len];
  278. Array.Copy(buf, 0, data, 0, len);
  279. return data;
  280. }
  281. catch
  282. {
  283. // 接收异常(例如超时),返回 null 以触发上层重试逻辑
  284. return null;
  285. }
  286. }
  287. /// <summary>
  288. /// 更新连接状态并触发事件。
  289. /// </summary>
  290. /// <param name="connected">新的连接状态</param>
  291. private void UpdateConnectState(bool connected)
  292. {
  293. _isConnected = connected;
  294. ConnectStateChangedEvent?.Invoke(this, connected);
  295. }
  296. /// <summary>
  297. /// 释放资源实现(受保护,可由派生类覆盖)。
  298. /// </summary>
  299. /// <param name="disposing">是否为显式释放</param>
  300. protected virtual void Dispose(bool disposing)
  301. {
  302. if (disposing)
  303. {
  304. if (_socket != null)
  305. {
  306. try
  307. {
  308. _socket.Shutdown(SocketShutdown.Both);
  309. }
  310. catch { }
  311. _socket.Close();
  312. _socket.Dispose();
  313. _socket = null;
  314. }
  315. }
  316. }
  317. /// <summary>
  318. /// 释放所有托管资源并抑制终结化。
  319. /// </summary>
  320. public void Dispose()
  321. {
  322. Dispose(true);
  323. GC.SuppressFinalize(this);
  324. }
  325. /// <summary>
  326. /// 解析设备返回的字节数据(TSPB + 可选的 TSPA 曲线数据)。
  327. /// 对协议字段按固定偏移解析并进行单位转换。
  328. /// 返回解析是否成功(数据完整且符合长度要求)。
  329. /// </summary>
  330. /// <param name="data">原始字节数据</param>
  331. /// <returns>是否解析成功</returns>
  332. private bool DataAnalysis(byte[] data)
  333. {
  334. if (data == null || data.Length < MinDataLength)
  335. return false;
  336. try
  337. {
  338. #region 注释(协议字段说明)
  339. // 协议字节说明(基于设备文档):
  340. // 1 - 4 “TSPB”
  341. // 5 - 8 螺丝编号 (4 bytes, DCBA order)
  342. // 9 - 10 曲线采样频率 (2 bytes)
  343. // 11 - 22 结果日期 - 年 月 日 时 分 秒 (每项 2 bytes)
  344. // 23 - 24 程序编号
  345. // 25 - 26 总圈数 (单位:度)
  346. // 27 锁止角度 (2 bytes)
  347. // 29 结果扭矩 (2 bytes)
  348. // 31 结果时间 (2 bytes)
  349. // 33 锁附结果 (2 bytes)
  350. // 35 ... 94 各阶段角度/扭矩等(按文档固定偏移)
  351. // 205 TSPA 数据起始坐标(协议中以 1-base 或 0-base 可能不同)
  352. // 207 TSPA 数据总数(样本点数)
  353. // 随后按扭矩/速度/角度/斜率分别存放(每项为 2 bytes,sectionBytes = length * 2)
  354. #endregion
  355. // 基本字段解析
  356. ScrewNum = ToInt32N(data, 4);
  357. Frequency = ToInt16(data, 8);
  358. int year = ToInt16(data, 10);
  359. int month = ToInt16(data, 12);
  360. int day = ToInt16(data, 14);
  361. int hour = ToInt16(data, 16);
  362. int minute = ToInt16(data, 18);
  363. int second = ToInt16(data, 20);
  364. ResultDateTime = new DateTime(year, month, day, hour, minute, second);
  365. ProgramNumber = ToInt16(data, 22);
  366. // 设备返回的总圈数字段以度为单位,转换为圈
  367. Truns = ToInt16(data, 24) / 360.0;
  368. LockAngel = ToInt16(data, 26);
  369. // 扭矩值以 mN·m(或协议指定单位)返回,乘以 0.001 转换为 N·m
  370. TorqueValue = ToInt16(data, 28) * 0.001;
  371. FinalTime = ToInt16(data, 30);
  372. int finalResult = ToInt16(data, 32);
  373. switch (finalResult)
  374. {
  375. case 1: ErrorInfo = "圈数异常"; break;
  376. case 2: ErrorInfo = "区段行程NG"; break;
  377. case 3: ErrorInfo = "超时"; break;
  378. case 4: ErrorInfo = string.Empty; break;
  379. case 5: ErrorInfo = "中断"; break;
  380. case 6: ErrorInfo = "转矩过大"; break;
  381. case 7: ErrorInfo = "反转"; break;
  382. case 8: ErrorInfo = "锁止角不合格"; break;
  383. case 9: ErrorInfo = "过锁异常"; break;
  384. case 10: ErrorInfo = "斜率异常"; break;
  385. case 11: ErrorInfo = "夹角异常"; break;
  386. case 12: ErrorInfo = "贴合角异常"; break;
  387. case 13: ErrorInfo = "夹紧力异常"; break;
  388. case 14: ErrorInfo = "过程力异常"; break;
  389. default: ErrorInfo = finalResult.ToString(); break;
  390. }
  391. Success = finalResult == 4;
  392. // 阶段行程角度:协议中以度为单位,代码将其转换为圈(度/360)
  393. StrokeAngle1 = ToInt16(data, 34) / 360.0;
  394. StrokeAngle2 = ToInt16(data, 36) / 360.0;
  395. StrokeAngle3 = ToInt16(data, 38) / 360.0;
  396. StrokeAngle4 = ToInt16(data, 40) / 360.0;
  397. StrokeAngle5 = ToInt16(data, 42) / 360.0;
  398. // 阶段扭矩转换(单位缩放)
  399. StrokeTorque1 = ToInt16(data, 44) * 0.001;
  400. StrokeTorque2 = ToInt16(data, 46) * 0.001;
  401. StrokeTorque3 = ToInt16(data, 48) * 0.001;
  402. StrokeTorque4 = ToInt16(data, 50) * 0.001;
  403. StrokeTorque5 = ToInt16(data, 52) * 0.001;
  404. MaxTorque = ToInt16(data, 54) * 0.001;
  405. OverlockAngle = ToInt16(data, 56);
  406. OverlockTorque = ToInt16(data, 58) * 0.001;
  407. SlopeCheck = ToInt16(data, 60);
  408. ClampingAngle = ToInt16(data, 62);
  409. ClampingAngleCheck = ToInt16(data, 64);
  410. FitAngle = ToInt16(data, 66);
  411. FitAngleCheck = ToInt16(data, 68);
  412. ClampingTorque = ToInt16(data, 70) * 0.001;
  413. ClampingTorqueCheck = ToInt16(data, 72);
  414. ProcessMaxTorque = ToInt16(data, 74) * 0.001;
  415. ProcessMaxTorqueCheck = ToInt16(data, 76);
  416. FitPointCoord = ToInt16(data, 78);
  417. FitAngle1 = ToInt16(data, 80);
  418. FitTorque = ToInt16(data, 82) * 0.001;
  419. SectionTooth = ToInt16(data, 84);
  420. SectionStroke1 = ToInt16(data, 86);
  421. SectionStroke2 = ToInt16(data, 88);
  422. SectionStroke3 = ToInt16(data, 90);
  423. SectionStroke4 = ToInt16(data, 92);
  424. SectionStroke5 = ToInt16(data, 94);
  425. SectionLockAngle = ToInt16(data, 96);
  426. SectionLockFinish1 = ToInt16(data, 98);
  427. SectionOverLock = ToInt16(data, 100);
  428. SectionFinalEnd = ToInt16(data, 102);
  429. // 计算 TSPA 曲线数据段长度(协议: 在偏移 504/506 存有开始/结束索引或总数)
  430. int length = ToInt16(data, 506) - ToInt16(data, 504);
  431. if (length <= 0)
  432. {
  433. // 无曲线数据,清空集合并返回成功
  434. WaveDatas.Clear();
  435. return true;
  436. }
  437. int sectionBytes = length * 2;
  438. int expectedTotal = 508 + sectionBytes * 4;
  439. // 如果整体长度不足,则认为数据不完整,返回失败以触发重试
  440. if (data.Length < expectedTotal)
  441. return false;
  442. var torques = new byte[sectionBytes];
  443. var speeds = new byte[sectionBytes];
  444. var angles = new byte[sectionBytes];
  445. var slopes = new byte[sectionBytes];
  446. // 按顺序从数据中拷贝各段(扭矩、速度、角度、斜率)
  447. Array.Copy(data, 508, torques, 0, sectionBytes);
  448. Array.Copy(data, 508 + sectionBytes, speeds, 0, sectionBytes);
  449. Array.Copy(data, 508 + sectionBytes * 2, angles, 0, sectionBytes);
  450. Array.Copy(data, 508 + sectionBytes * 3, slopes, 0, sectionBytes);
  451. WaveDatas.Clear();
  452. // 每 2 字节为一个样本,使用 ToInt16 解析(注意字节序)
  453. for (int i = 0; i < sectionBytes; i += 2)
  454. {
  455. double angleVal = ToInt16(angles, i) / 360.0;
  456. double torqueVal = ToInt16(torques, i) * 0.001;
  457. double slopeVal = ToInt16(slopes, i);
  458. // 时间:按采样频率换算(单位:秒),注意 i 为字节索引,样本索引为 i/2
  459. double time = (Frequency * i) / 1000.0;
  460. WaveDatas.Add(new WaveData
  461. {
  462. LockAngle = angleVal,
  463. Torque = torqueVal,
  464. Slopes = slopeVal,
  465. Turns = angleVal,
  466. Time = time
  467. });
  468. }
  469. return true;
  470. }
  471. catch
  472. {
  473. // 任意解析或转换异常均视为解析失败
  474. return false;
  475. }
  476. }
  477. /// <summary>
  478. /// 将指定数组中从 startIndex 开始的两个字节按设备协议的字节序解析为有符号 16 位值。
  479. /// 协议采用“DCBA 风格(低字节在前,高字节在后)”,因此这里以小端方式合成。
  480. /// </summary>
  481. /// <param name="value">字节数组</param>
  482. /// <param name="startIndex">起始索引</param>
  483. /// <returns>解析出的 short 值,出错返回 0</returns>
  484. private short ToInt16(byte[] value, int startIndex)
  485. {
  486. if (value == null || startIndex < 0 || startIndex + 1 >= value.Length)
  487. return 0;
  488. // data is DCBA style (little-endian word swapped)
  489. return (short)((value[startIndex + 1] << 8) | value[startIndex]);
  490. }
  491. /// <summary>
  492. /// 将指定数组中从 startIndex 开始的 4 个字节按设备协议解析为 32 位整型(DCBA 顺序)。
  493. /// 注意字节顺序为设备特定格式,这里按原实现保持位移组合。
  494. /// </summary>
  495. /// <param name="value">字节数组</param>
  496. /// <param name="startIndex">起始索引</param>
  497. /// <returns>解析出的 int 值,出错返回 0</returns>
  498. private int ToInt32N(byte[] value, int startIndex)
  499. {
  500. if (value == null || startIndex < 0 || startIndex + 3 >= value.Length)
  501. return 0;
  502. // DCBA order -> 构造 32 位整数(高位在后面的索引)
  503. return (value[startIndex + 3] << 24) | (value[startIndex + 2] << 16) | (value[startIndex + 1] << 8) | value[startIndex];
  504. }
  505. /// <summary>
  506. /// 曲线数据结构,包含速度、扭矩、角度、圈数、斜率与时间。
  507. /// </summary>
  508. public struct WaveData
  509. {
  510. /// <summary>
  511. /// 速度
  512. /// </summary>
  513. public double Speed { get; set; }
  514. /// <summary>
  515. /// 扭矩
  516. /// </summary>
  517. public double Torque { get; set; }
  518. /// <summary>
  519. /// 角度
  520. /// </summary>
  521. public double LockAngle { get; set; }
  522. /// <summary>
  523. /// 圈数
  524. /// </summary>
  525. public double Turns { get; set; }
  526. /// <summary>
  527. /// 斜率
  528. /// </summary>
  529. public double Slopes { get; set; }
  530. /// <summary>
  531. /// 时间(秒)
  532. /// </summary>
  533. public double Time { get; set; }
  534. }
  535. }
  536. }