ModbusUtility.cs 8.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217
  1. using System;
  2. using System.Linq;
  3. using System.Net;
  4. using System.Text;
  5. namespace NModbus.Utility
  6. {
  7. /// <summary>
  8. /// Modbus utility methods.
  9. /// </summary>
  10. public static class ModbusUtility
  11. {
  12. private static readonly ushort[] CrcTable =
  13. {
  14. 0X0000, 0XC0C1, 0XC181, 0X0140, 0XC301, 0X03C0, 0X0280, 0XC241,
  15. 0XC601, 0X06C0, 0X0780, 0XC741, 0X0500, 0XC5C1, 0XC481, 0X0440,
  16. 0XCC01, 0X0CC0, 0X0D80, 0XCD41, 0X0F00, 0XCFC1, 0XCE81, 0X0E40,
  17. 0X0A00, 0XCAC1, 0XCB81, 0X0B40, 0XC901, 0X09C0, 0X0880, 0XC841,
  18. 0XD801, 0X18C0, 0X1980, 0XD941, 0X1B00, 0XDBC1, 0XDA81, 0X1A40,
  19. 0X1E00, 0XDEC1, 0XDF81, 0X1F40, 0XDD01, 0X1DC0, 0X1C80, 0XDC41,
  20. 0X1400, 0XD4C1, 0XD581, 0X1540, 0XD701, 0X17C0, 0X1680, 0XD641,
  21. 0XD201, 0X12C0, 0X1380, 0XD341, 0X1100, 0XD1C1, 0XD081, 0X1040,
  22. 0XF001, 0X30C0, 0X3180, 0XF141, 0X3300, 0XF3C1, 0XF281, 0X3240,
  23. 0X3600, 0XF6C1, 0XF781, 0X3740, 0XF501, 0X35C0, 0X3480, 0XF441,
  24. 0X3C00, 0XFCC1, 0XFD81, 0X3D40, 0XFF01, 0X3FC0, 0X3E80, 0XFE41,
  25. 0XFA01, 0X3AC0, 0X3B80, 0XFB41, 0X3900, 0XF9C1, 0XF881, 0X3840,
  26. 0X2800, 0XE8C1, 0XE981, 0X2940, 0XEB01, 0X2BC0, 0X2A80, 0XEA41,
  27. 0XEE01, 0X2EC0, 0X2F80, 0XEF41, 0X2D00, 0XEDC1, 0XEC81, 0X2C40,
  28. 0XE401, 0X24C0, 0X2580, 0XE541, 0X2700, 0XE7C1, 0XE681, 0X2640,
  29. 0X2200, 0XE2C1, 0XE381, 0X2340, 0XE101, 0X21C0, 0X2080, 0XE041,
  30. 0XA001, 0X60C0, 0X6180, 0XA141, 0X6300, 0XA3C1, 0XA281, 0X6240,
  31. 0X6600, 0XA6C1, 0XA781, 0X6740, 0XA501, 0X65C0, 0X6480, 0XA441,
  32. 0X6C00, 0XACC1, 0XAD81, 0X6D40, 0XAF01, 0X6FC0, 0X6E80, 0XAE41,
  33. 0XAA01, 0X6AC0, 0X6B80, 0XAB41, 0X6900, 0XA9C1, 0XA881, 0X6840,
  34. 0X7800, 0XB8C1, 0XB981, 0X7940, 0XBB01, 0X7BC0, 0X7A80, 0XBA41,
  35. 0XBE01, 0X7EC0, 0X7F80, 0XBF41, 0X7D00, 0XBDC1, 0XBC81, 0X7C40,
  36. 0XB401, 0X74C0, 0X7580, 0XB541, 0X7700, 0XB7C1, 0XB681, 0X7640,
  37. 0X7200, 0XB2C1, 0XB381, 0X7340, 0XB101, 0X71C0, 0X7080, 0XB041,
  38. 0X5000, 0X90C1, 0X9181, 0X5140, 0X9301, 0X53C0, 0X5280, 0X9241,
  39. 0X9601, 0X56C0, 0X5780, 0X9741, 0X5500, 0X95C1, 0X9481, 0X5440,
  40. 0X9C01, 0X5CC0, 0X5D80, 0X9D41, 0X5F00, 0X9FC1, 0X9E81, 0X5E40,
  41. 0X5A00, 0X9AC1, 0X9B81, 0X5B40, 0X9901, 0X59C0, 0X5880, 0X9841,
  42. 0X8801, 0X48C0, 0X4980, 0X8941, 0X4B00, 0X8BC1, 0X8A81, 0X4A40,
  43. 0X4E00, 0X8EC1, 0X8F81, 0X4F40, 0X8D01, 0X4DC0, 0X4C80, 0X8C41,
  44. 0X4400, 0X84C1, 0X8581, 0X4540, 0X8701, 0X47C0, 0X4680, 0X8641,
  45. 0X8201, 0X42C0, 0X4380, 0X8341, 0X4100, 0X81C1, 0X8081, 0X4040
  46. };
  47. /// <summary>
  48. /// Converts four UInt16 values into a IEEE 64 floating point format.
  49. /// </summary>
  50. /// <param name="b3">Highest-order ushort value.</param>
  51. /// <param name="b2">Second-to-highest-order ushort value.</param>
  52. /// <param name="b1">Second-to-lowest-order ushort value.</param>
  53. /// <param name="b0">Lowest-order ushort value.</param>
  54. /// <returns>IEEE 64 floating point value.</returns>
  55. public static double GetDouble(ushort b3, ushort b2, ushort b1, ushort b0)
  56. {
  57. byte[] value = BitConverter.GetBytes(b0)
  58. .Concat(BitConverter.GetBytes(b1))
  59. .Concat(BitConverter.GetBytes(b2))
  60. .Concat(BitConverter.GetBytes(b3))
  61. .ToArray();
  62. return BitConverter.ToDouble(value, 0);
  63. }
  64. /// <summary>
  65. /// Converts two UInt16 values into a IEEE 32 floating point format.
  66. /// </summary>
  67. /// <param name="highOrderValue">High order ushort value.</param>
  68. /// <param name="lowOrderValue">Low order ushort value.</param>
  69. /// <returns>IEEE 32 floating point value.</returns>
  70. public static float GetSingle(ushort highOrderValue, ushort lowOrderValue)
  71. {
  72. byte[] value = BitConverter.GetBytes(lowOrderValue)
  73. .Concat(BitConverter.GetBytes(highOrderValue))
  74. .ToArray();
  75. return BitConverter.ToSingle(value, 0);
  76. }
  77. /// <summary>
  78. /// Converts two UInt16 values into a UInt32.
  79. /// </summary>
  80. public static uint GetUInt32(ushort highOrderValue, ushort lowOrderValue)
  81. {
  82. byte[] value = BitConverter.GetBytes(lowOrderValue)
  83. .Concat(BitConverter.GetBytes(highOrderValue))
  84. .ToArray();
  85. return BitConverter.ToUInt32(value, 0);
  86. }
  87. /// <summary>
  88. /// Converts an array of bytes to an ASCII byte array.
  89. /// </summary>
  90. /// <param name="numbers">The byte array.</param>
  91. /// <returns>An array of ASCII byte values.</returns>
  92. public static byte[] GetAsciiBytes(params byte[] numbers)
  93. {
  94. return Encoding.UTF8.GetBytes(numbers.SelectMany(n => n.ToString("X2")).ToArray());
  95. }
  96. /// <summary>
  97. /// Converts an array of UInt16 to an ASCII byte array.
  98. /// </summary>
  99. /// <param name="numbers">The ushort array.</param>
  100. /// <returns>An array of ASCII byte values.</returns>
  101. public static byte[] GetAsciiBytes(params ushort[] numbers)
  102. {
  103. return Encoding.UTF8.GetBytes(numbers.SelectMany(n => n.ToString("X4")).ToArray());
  104. }
  105. /// <summary>
  106. /// Converts a network order byte array to an array of UInt16 values in host order.
  107. /// </summary>
  108. /// <param name="networkBytes">The network order byte array.</param>
  109. /// <returns>The host order ushort array.</returns>
  110. public static ushort[] NetworkBytesToHostUInt16(byte[] networkBytes)
  111. {
  112. if (networkBytes == null)
  113. {
  114. throw new ArgumentNullException(nameof(networkBytes));
  115. }
  116. if (networkBytes.Length % 2 != 0)
  117. {
  118. throw new FormatException(Resources.NetworkBytesNotEven);
  119. }
  120. ushort[] result = new ushort[networkBytes.Length / 2];
  121. for (int i = 0; i < result.Length; i++)
  122. {
  123. result[i] = (ushort)IPAddress.NetworkToHostOrder(BitConverter.ToInt16(networkBytes, i * 2));
  124. }
  125. return result;
  126. }
  127. /// <summary>
  128. /// Converts a hex string to a byte array.
  129. /// </summary>
  130. /// <param name="hex">The hex string.</param>
  131. /// <returns>Array of bytes.</returns>
  132. public static byte[] HexToBytes(string hex)
  133. {
  134. if (hex == null)
  135. {
  136. throw new ArgumentNullException(nameof(hex));
  137. }
  138. if (hex.Length % 2 != 0)
  139. {
  140. throw new FormatException(Resources.HexCharacterCountNotEven);
  141. }
  142. byte[] bytes = new byte[hex.Length / 2];
  143. for (int i = 0; i < bytes.Length; i++)
  144. {
  145. bytes[i] = Convert.ToByte(hex.Substring(i * 2, 2), 16);
  146. }
  147. return bytes;
  148. }
  149. /// <summary>
  150. /// Calculate Longitudinal Redundancy Check.
  151. /// </summary>
  152. /// <param name="data">The data used in LRC.</param>
  153. /// <returns>LRC value.</returns>
  154. public static byte CalculateLrc(byte[] data)
  155. {
  156. if (data == null)
  157. {
  158. throw new ArgumentNullException(nameof(data));
  159. }
  160. byte lrc = 0;
  161. foreach (byte b in data)
  162. {
  163. lrc += b;
  164. }
  165. lrc = (byte)((lrc ^ 0xFF) + 1);
  166. return lrc;
  167. }
  168. /// <summary>
  169. /// Calculate Cyclical Redundancy Check.
  170. /// </summary>
  171. /// <param name="data">The data used in CRC.</param>
  172. /// <returns>CRC value.</returns>
  173. public static byte[] CalculateCrc(byte[] data)
  174. {
  175. if (data == null)
  176. {
  177. throw new ArgumentNullException(nameof(data));
  178. }
  179. ushort crc = ushort.MaxValue;
  180. foreach (byte b in data)
  181. {
  182. byte tableIndex = (byte)(crc ^ b);
  183. crc >>= 8;
  184. crc ^= CrcTable[tableIndex];
  185. }
  186. return BitConverter.GetBytes(crc);
  187. }
  188. }
  189. }