XYD_ScrewDriver.cs 23 KB

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