unit-test-client.c 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994
  1. /*
  2. * Copyright © Stéphane Raimbault <stephane.raimbault@gmail.com>
  3. *
  4. * SPDX-License-Identifier: BSD-3-Clause
  5. */
  6. #include <errno.h>
  7. #include <modbus.h>
  8. #include <stdio.h>
  9. #include <stdlib.h>
  10. #include <string.h>
  11. #include <unistd.h>
  12. #include "unit-test.h"
  13. const int EXCEPTION_RC = 2;
  14. enum {
  15. TCP,
  16. TCP_PI,
  17. RTU
  18. };
  19. int test_server(modbus_t *ctx, int use_backend);
  20. int send_crafted_request(modbus_t *ctx,
  21. int function,
  22. uint8_t *req,
  23. int req_size,
  24. uint16_t max_value,
  25. uint16_t bytes,
  26. int backend_length,
  27. int backend_offset);
  28. int equal_dword(uint16_t *tab_reg, const uint32_t value);
  29. int is_memory_equal(const void *s1, const void *s2, size_t size);
  30. #define BUG_REPORT(_cond, _format, _args...) \
  31. printf("\nLine %d: assertion error for '%s': " _format "\n", __LINE__, #_cond, ##_args)
  32. #define ASSERT_TRUE(_cond, _format, __args...) \
  33. { \
  34. if (_cond) { \
  35. printf("OK\n"); \
  36. } else { \
  37. BUG_REPORT(_cond, _format, ##__args); \
  38. goto close; \
  39. } \
  40. };
  41. int is_memory_equal(const void *s1, const void *s2, size_t size)
  42. {
  43. return (memcmp(s1, s2, size) == 0);
  44. }
  45. int equal_dword(uint16_t *tab_reg, const uint32_t value)
  46. {
  47. return ((tab_reg[0] == (value >> 16)) && (tab_reg[1] == (value & 0xFFFF)));
  48. }
  49. int main(int argc, char *argv[])
  50. {
  51. /* Length of report slave ID response slave ID + ON/OFF + 'LMB' + version */
  52. const int NB_REPORT_SLAVE_ID = 2 + 3 + strlen(LIBMODBUS_VERSION_STRING);
  53. uint8_t *tab_rp_bits = NULL;
  54. uint16_t *tab_rp_registers = NULL;
  55. uint16_t *tab_rp_registers_bad = NULL;
  56. modbus_t *ctx = NULL;
  57. int i;
  58. uint8_t value;
  59. int nb_points;
  60. int rc;
  61. float real;
  62. uint32_t old_response_to_sec;
  63. uint32_t old_response_to_usec;
  64. uint32_t new_response_to_sec;
  65. uint32_t new_response_to_usec;
  66. uint32_t old_byte_to_sec;
  67. uint32_t old_byte_to_usec;
  68. int use_backend;
  69. int success = FALSE;
  70. int old_slave;
  71. char *ip_or_device;
  72. if (argc > 1) {
  73. if (strcmp(argv[1], "tcp") == 0) {
  74. use_backend = TCP;
  75. } else if (strcmp(argv[1], "tcppi") == 0) {
  76. use_backend = TCP_PI;
  77. } else if (strcmp(argv[1], "rtu") == 0) {
  78. use_backend = RTU;
  79. } else {
  80. printf("Modbus client for unit testing\n");
  81. printf("Usage:\n %s [tcp|tcppi|rtu]\n", argv[0]);
  82. printf("Eg. tcp 127.0.0.1 or rtu /dev/ttyUSB1\n\n");
  83. exit(1);
  84. }
  85. } else {
  86. /* By default */
  87. use_backend = TCP;
  88. }
  89. if (argc > 2) {
  90. ip_or_device = argv[2];
  91. } else {
  92. switch (use_backend) {
  93. case TCP:
  94. ip_or_device = "127.0.0.1";
  95. break;
  96. case TCP_PI:
  97. ip_or_device = "::1";
  98. break;
  99. case RTU:
  100. ip_or_device = "/dev/ttyUSB1";
  101. break;
  102. default:
  103. break;
  104. }
  105. }
  106. if (use_backend == TCP) {
  107. ctx = modbus_new_tcp(ip_or_device, 1502);
  108. } else if (use_backend == TCP_PI) {
  109. ctx = modbus_new_tcp_pi(ip_or_device, "1502");
  110. } else {
  111. ctx = modbus_new_rtu(ip_or_device, 115200, 'N', 8, 1);
  112. }
  113. if (ctx == NULL) {
  114. fprintf(stderr, "Unable to allocate libmodbus context\n");
  115. return -1;
  116. }
  117. modbus_set_debug(ctx, TRUE);
  118. modbus_set_error_recovery(
  119. ctx, MODBUS_ERROR_RECOVERY_LINK | MODBUS_ERROR_RECOVERY_PROTOCOL);
  120. if (use_backend == RTU) {
  121. modbus_set_slave(ctx, SERVER_ID);
  122. }
  123. modbus_get_response_timeout(ctx, &old_response_to_sec, &old_response_to_usec);
  124. if (modbus_connect(ctx) == -1) {
  125. fprintf(stderr, "Connection failed: %s\n", modbus_strerror(errno));
  126. modbus_free(ctx);
  127. return -1;
  128. }
  129. /* Allocate and initialize the memory to store the bits */
  130. nb_points = (UT_BITS_NB > UT_INPUT_BITS_NB) ? UT_BITS_NB : UT_INPUT_BITS_NB;
  131. tab_rp_bits = (uint8_t *) malloc(nb_points * sizeof(uint8_t));
  132. memset(tab_rp_bits, 0, nb_points * sizeof(uint8_t));
  133. /* Allocate and initialize the memory to store the registers */
  134. nb_points = (UT_REGISTERS_NB > UT_INPUT_REGISTERS_NB) ? UT_REGISTERS_NB
  135. : UT_INPUT_REGISTERS_NB;
  136. tab_rp_registers = (uint16_t *) malloc(nb_points * sizeof(uint16_t));
  137. memset(tab_rp_registers, 0, nb_points * sizeof(uint16_t));
  138. printf("** UNIT TESTING **\n");
  139. printf("1/1 No response timeout modification on connect: ");
  140. modbus_get_response_timeout(ctx, &new_response_to_sec, &new_response_to_usec);
  141. ASSERT_TRUE(old_response_to_sec == new_response_to_sec &&
  142. old_response_to_usec == new_response_to_usec,
  143. "");
  144. printf("\nTEST WRITE/READ:\n");
  145. /** COIL BITS **/
  146. /* Single */
  147. rc = modbus_write_bit(ctx, UT_BITS_ADDRESS, ON);
  148. printf("1/2 modbus_write_bit: ");
  149. ASSERT_TRUE(rc == 1, "");
  150. rc = modbus_read_bits(ctx, UT_BITS_ADDRESS, 1, tab_rp_bits);
  151. printf("2/2 modbus_read_bits: ");
  152. ASSERT_TRUE(rc == 1, "FAILED (nb points %d)\n", rc);
  153. ASSERT_TRUE(tab_rp_bits[0] == ON, "FAILED (%0X != %0X)\n", tab_rp_bits[0], ON);
  154. /* End single */
  155. /* Multiple bits */
  156. {
  157. uint8_t tab_value[UT_BITS_NB];
  158. modbus_set_bits_from_bytes(tab_value, 0, UT_BITS_NB, UT_BITS_TAB);
  159. rc = modbus_write_bits(ctx, UT_BITS_ADDRESS, UT_BITS_NB, tab_value);
  160. printf("1/2 modbus_write_bits: ");
  161. ASSERT_TRUE(rc == UT_BITS_NB, "");
  162. }
  163. rc = modbus_read_bits(ctx, UT_BITS_ADDRESS, UT_BITS_NB, tab_rp_bits);
  164. printf("2/2 modbus_read_bits: ");
  165. ASSERT_TRUE(rc == UT_BITS_NB, "FAILED (nb points %d)\n", rc);
  166. i = 0;
  167. nb_points = UT_BITS_NB;
  168. while (nb_points > 0) {
  169. int nb_bits = (nb_points > 8) ? 8 : nb_points;
  170. value = modbus_get_byte_from_bits(tab_rp_bits, i * 8, nb_bits);
  171. ASSERT_TRUE(
  172. value == UT_BITS_TAB[i], "FAILED (%0X != %0X)\n", value, UT_BITS_TAB[i]);
  173. nb_points -= nb_bits;
  174. i++;
  175. }
  176. printf("OK\n");
  177. /* End of multiple bits */
  178. /** DISCRETE INPUTS **/
  179. rc =
  180. modbus_read_input_bits(ctx, UT_INPUT_BITS_ADDRESS, UT_INPUT_BITS_NB, tab_rp_bits);
  181. printf("1/1 modbus_read_input_bits: ");
  182. ASSERT_TRUE(rc == UT_INPUT_BITS_NB, "FAILED (nb points %d)\n", rc);
  183. i = 0;
  184. nb_points = UT_INPUT_BITS_NB;
  185. while (nb_points > 0) {
  186. int nb_bits = (nb_points > 8) ? 8 : nb_points;
  187. value = modbus_get_byte_from_bits(tab_rp_bits, i * 8, nb_bits);
  188. ASSERT_TRUE(value == UT_INPUT_BITS_TAB[i],
  189. "FAILED (%0X != %0X)\n",
  190. value,
  191. UT_INPUT_BITS_TAB[i]);
  192. nb_points -= nb_bits;
  193. i++;
  194. }
  195. printf("OK\n");
  196. /** HOLDING REGISTERS **/
  197. /* Single register */
  198. rc = modbus_write_register(ctx, UT_REGISTERS_ADDRESS, 0x1234);
  199. printf("1/2 modbus_write_register: ");
  200. ASSERT_TRUE(rc == 1, "");
  201. rc = modbus_read_registers(ctx, UT_REGISTERS_ADDRESS, 1, tab_rp_registers);
  202. printf("2/2 modbus_read_registers: ");
  203. ASSERT_TRUE(rc == 1, "FAILED (nb points %d)\n", rc);
  204. ASSERT_TRUE(tab_rp_registers[0] == 0x1234,
  205. "FAILED (%0X != %0X)\n",
  206. tab_rp_registers[0],
  207. 0x1234);
  208. /* End of single register */
  209. /* Many registers */
  210. rc = modbus_write_registers(
  211. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB, UT_REGISTERS_TAB);
  212. printf("1/5 modbus_write_registers: ");
  213. ASSERT_TRUE(rc == UT_REGISTERS_NB, "");
  214. rc = modbus_read_registers(
  215. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB, tab_rp_registers);
  216. printf("2/5 modbus_read_registers: ");
  217. ASSERT_TRUE(rc == UT_REGISTERS_NB, "FAILED (nb points %d)\n", rc);
  218. for (i = 0; i < UT_REGISTERS_NB; i++) {
  219. ASSERT_TRUE(tab_rp_registers[i] == UT_REGISTERS_TAB[i],
  220. "FAILED (%0X != %0X)\n",
  221. tab_rp_registers[i],
  222. UT_REGISTERS_TAB[i]);
  223. }
  224. rc = modbus_read_registers(ctx, UT_REGISTERS_ADDRESS, 0, tab_rp_registers);
  225. printf("3/5 modbus_read_registers (0): ");
  226. ASSERT_TRUE(rc == -1, "FAILED (nb_points %d)\n", rc);
  227. nb_points = (UT_REGISTERS_NB > UT_INPUT_REGISTERS_NB) ? UT_REGISTERS_NB
  228. : UT_INPUT_REGISTERS_NB;
  229. memset(tab_rp_registers, 0, nb_points * sizeof(uint16_t));
  230. /* Write registers to zero from tab_rp_registers and store read registers
  231. into tab_rp_registers. So the read registers must set to 0, except the
  232. first one because there is an offset of 1 register on write. */
  233. rc = modbus_write_and_read_registers(ctx,
  234. UT_REGISTERS_ADDRESS + 1,
  235. UT_REGISTERS_NB - 1,
  236. tab_rp_registers,
  237. UT_REGISTERS_ADDRESS,
  238. UT_REGISTERS_NB,
  239. tab_rp_registers);
  240. printf("4/5 modbus_write_and_read_registers: ");
  241. ASSERT_TRUE(
  242. rc == UT_REGISTERS_NB, "FAILED (nb points %d != %d)\n", rc, UT_REGISTERS_NB);
  243. ASSERT_TRUE(tab_rp_registers[0] == UT_REGISTERS_TAB[0],
  244. "FAILED (%0X != %0X)\n",
  245. tab_rp_registers[0],
  246. UT_REGISTERS_TAB[0]);
  247. for (i = 1; i < UT_REGISTERS_NB; i++) {
  248. ASSERT_TRUE(
  249. tab_rp_registers[i] == 0, "FAILED (%0X != %0X)\n", tab_rp_registers[i], 0);
  250. }
  251. /* End of many registers */
  252. /** INPUT REGISTERS **/
  253. rc = modbus_read_input_registers(
  254. ctx, UT_INPUT_REGISTERS_ADDRESS, UT_INPUT_REGISTERS_NB, tab_rp_registers);
  255. printf("1/1 modbus_read_input_registers: ");
  256. ASSERT_TRUE(rc == UT_INPUT_REGISTERS_NB, "FAILED (nb points %d)\n", rc);
  257. for (i = 0; i < UT_INPUT_REGISTERS_NB; i++) {
  258. ASSERT_TRUE(tab_rp_registers[i] == UT_INPUT_REGISTERS_TAB[i],
  259. "FAILED (%0X != %0X)\n",
  260. tab_rp_registers[i],
  261. UT_INPUT_REGISTERS_TAB[i]);
  262. }
  263. /* MASKS */
  264. printf("1/1 Write mask: ");
  265. rc = modbus_write_register(ctx, UT_REGISTERS_ADDRESS, 0x12);
  266. rc = modbus_mask_write_register(ctx, UT_REGISTERS_ADDRESS, 0xF2, 0x25);
  267. ASSERT_TRUE(rc != -1, "FAILED (%x == -1)\n", rc);
  268. rc = modbus_read_registers(ctx, UT_REGISTERS_ADDRESS, 1, tab_rp_registers);
  269. ASSERT_TRUE(
  270. tab_rp_registers[0] == 0x17, "FAILED (%0X != %0X)\n", tab_rp_registers[0], 0x17);
  271. printf("\nTEST FLOATS\n");
  272. /** FLOAT **/
  273. printf("1/4 Set/get float ABCD: ");
  274. modbus_set_float_abcd(UT_REAL, tab_rp_registers);
  275. ASSERT_TRUE(is_memory_equal(tab_rp_registers, UT_IREAL_ABCD_SET, 4),
  276. "FAILED Set float ABCD");
  277. real = modbus_get_float_abcd(UT_IREAL_ABCD_GET);
  278. ASSERT_TRUE(real == UT_REAL, "FAILED (%f != %f)\n", real, UT_REAL);
  279. printf("2/4 Set/get float DCBA: ");
  280. modbus_set_float_dcba(UT_REAL, tab_rp_registers);
  281. ASSERT_TRUE(is_memory_equal(tab_rp_registers, UT_IREAL_DCBA_SET, 4),
  282. "FAILED Set float DCBA");
  283. real = modbus_get_float_dcba(UT_IREAL_DCBA_GET);
  284. ASSERT_TRUE(real == UT_REAL, "FAILED (%f != %f)\n", real, UT_REAL);
  285. printf("3/4 Set/get float BADC: ");
  286. modbus_set_float_badc(UT_REAL, tab_rp_registers);
  287. ASSERT_TRUE(is_memory_equal(tab_rp_registers, UT_IREAL_BADC_SET, 4),
  288. "FAILED Set float BADC");
  289. real = modbus_get_float_badc(UT_IREAL_BADC_GET);
  290. ASSERT_TRUE(real == UT_REAL, "FAILED (%f != %f)\n", real, UT_REAL);
  291. printf("4/4 Set/get float CDAB: ");
  292. modbus_set_float_cdab(UT_REAL, tab_rp_registers);
  293. ASSERT_TRUE(is_memory_equal(tab_rp_registers, UT_IREAL_CDAB_SET, 4),
  294. "FAILED Set float CDAB");
  295. real = modbus_get_float_cdab(UT_IREAL_CDAB_GET);
  296. ASSERT_TRUE(real == UT_REAL, "FAILED (%f != %f)\n", real, UT_REAL);
  297. printf("\nAt this point, error messages doesn't mean the test has failed\n");
  298. /** ILLEGAL DATA ADDRESS **/
  299. printf("\nTEST ILLEGAL DATA ADDRESS:\n");
  300. /* The mapping begins at the defined addresses and ends at address +
  301. * nb_points so these addresses are not valid. */
  302. rc = modbus_read_bits(ctx, 0, 1, tab_rp_bits);
  303. printf("* modbus_read_bits (0): ");
  304. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  305. rc = modbus_read_bits(ctx, UT_BITS_ADDRESS, UT_BITS_NB + 1, tab_rp_bits);
  306. printf("* modbus_read_bits (max): ");
  307. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  308. rc = modbus_read_input_bits(ctx, 0, 1, tab_rp_bits);
  309. printf("* modbus_read_input_bits (0): ");
  310. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  311. rc = modbus_read_input_bits(
  312. ctx, UT_INPUT_BITS_ADDRESS, UT_INPUT_BITS_NB + 1, tab_rp_bits);
  313. printf("* modbus_read_input_bits (max): ");
  314. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  315. rc = modbus_read_registers(ctx, 0, 1, tab_rp_registers);
  316. printf("* modbus_read_registers (0): ");
  317. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  318. rc = modbus_read_registers(
  319. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB_MAX + 1, tab_rp_registers);
  320. printf("* modbus_read_registers (max): ");
  321. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  322. rc = modbus_read_input_registers(ctx, 0, 1, tab_rp_registers);
  323. printf("* modbus_read_input_registers (0): ");
  324. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  325. rc = modbus_read_input_registers(
  326. ctx, UT_INPUT_REGISTERS_ADDRESS, UT_INPUT_REGISTERS_NB + 1, tab_rp_registers);
  327. printf("* modbus_read_input_registers (max): ");
  328. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  329. rc = modbus_write_bit(ctx, 0, ON);
  330. printf("* modbus_write_bit (0): ");
  331. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  332. rc = modbus_write_bit(ctx, UT_BITS_ADDRESS + UT_BITS_NB, ON);
  333. printf("* modbus_write_bit (max): ");
  334. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  335. rc = modbus_write_bits(ctx, 0, 1, tab_rp_bits);
  336. printf("* modbus_write_coils (0): ");
  337. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  338. rc = modbus_write_bits(ctx, UT_BITS_ADDRESS + UT_BITS_NB, UT_BITS_NB, tab_rp_bits);
  339. printf("* modbus_write_coils (max): ");
  340. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  341. rc = modbus_write_register(ctx, 0, tab_rp_registers[0]);
  342. printf("* modbus_write_register (0): ");
  343. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  344. rc = modbus_write_register(
  345. ctx, UT_REGISTERS_ADDRESS + UT_REGISTERS_NB_MAX, tab_rp_registers[0]);
  346. printf("* modbus_write_register (max): ");
  347. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  348. rc = modbus_write_registers(ctx, 0, 1, tab_rp_registers);
  349. printf("* modbus_write_registers (0): ");
  350. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  351. rc = modbus_write_registers(ctx,
  352. UT_REGISTERS_ADDRESS + UT_REGISTERS_NB_MAX,
  353. UT_REGISTERS_NB,
  354. tab_rp_registers);
  355. printf("* modbus_write_registers (max): ");
  356. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  357. rc = modbus_mask_write_register(ctx, 0, 0xF2, 0x25);
  358. printf("* modbus_mask_write_registers (0): ");
  359. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  360. rc = modbus_mask_write_register(
  361. ctx, UT_REGISTERS_ADDRESS + UT_REGISTERS_NB_MAX, 0xF2, 0x25);
  362. printf("* modbus_mask_write_registers (max): ");
  363. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  364. rc = modbus_write_and_read_registers(
  365. ctx, 0, 1, tab_rp_registers, 0, 1, tab_rp_registers);
  366. printf("* modbus_write_and_read_registers (0): ");
  367. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  368. rc = modbus_write_and_read_registers(ctx,
  369. UT_REGISTERS_ADDRESS + UT_REGISTERS_NB_MAX,
  370. UT_REGISTERS_NB,
  371. tab_rp_registers,
  372. UT_REGISTERS_ADDRESS + UT_REGISTERS_NB_MAX,
  373. UT_REGISTERS_NB,
  374. tab_rp_registers);
  375. printf("* modbus_write_and_read_registers (max): ");
  376. ASSERT_TRUE(rc == -1 && errno == EMBXILADD, "");
  377. /** TOO MANY DATA **/
  378. printf("\nTEST TOO MANY DATA ERROR:\n");
  379. rc = modbus_read_bits(ctx, UT_BITS_ADDRESS, MODBUS_MAX_READ_BITS + 1, tab_rp_bits);
  380. printf("* modbus_read_bits: ");
  381. ASSERT_TRUE(rc == -1 && errno == EMBMDATA, "");
  382. rc = modbus_read_input_bits(
  383. ctx, UT_INPUT_BITS_ADDRESS, MODBUS_MAX_READ_BITS + 1, tab_rp_bits);
  384. printf("* modbus_read_input_bits: ");
  385. ASSERT_TRUE(rc == -1 && errno == EMBMDATA, "");
  386. rc = modbus_read_registers(
  387. ctx, UT_REGISTERS_ADDRESS, MODBUS_MAX_READ_REGISTERS + 1, tab_rp_registers);
  388. printf("* modbus_read_registers: ");
  389. ASSERT_TRUE(rc == -1 && errno == EMBMDATA, "");
  390. rc = modbus_read_input_registers(
  391. ctx, UT_INPUT_REGISTERS_ADDRESS, MODBUS_MAX_READ_REGISTERS + 1, tab_rp_registers);
  392. printf("* modbus_read_input_registers: ");
  393. ASSERT_TRUE(rc == -1 && errno == EMBMDATA, "");
  394. rc = modbus_write_bits(ctx, UT_BITS_ADDRESS, MODBUS_MAX_WRITE_BITS + 1, tab_rp_bits);
  395. printf("* modbus_write_bits: ");
  396. ASSERT_TRUE(rc == -1 && errno == EMBMDATA, "");
  397. rc = modbus_write_registers(
  398. ctx, UT_REGISTERS_ADDRESS, MODBUS_MAX_WRITE_REGISTERS + 1, tab_rp_registers);
  399. printf("* modbus_write_registers: ");
  400. ASSERT_TRUE(rc == -1 && errno == EMBMDATA, "");
  401. /** SLAVE ADDRESS **/
  402. old_slave = modbus_get_slave(ctx);
  403. printf("\nTEST SLAVE ADDRESS:\n");
  404. printf("1/2 Not compliant slave address is refused: ");
  405. rc = modbus_set_slave(ctx, 248);
  406. ASSERT_TRUE(rc == -1, "Slave address of 248 shouldn't be allowed");
  407. printf("2/2 Not compliant slave address is allowed: ");
  408. modbus_enable_quirks(ctx, MODBUS_QUIRK_MAX_SLAVE);
  409. rc = modbus_set_slave(ctx, 248);
  410. ASSERT_TRUE(rc == 0, "Not compliant slave address should have been accepted");
  411. modbus_disable_quirks(ctx, MODBUS_QUIRK_MAX_SLAVE);
  412. rc = modbus_set_slave(ctx, old_slave);
  413. ASSERT_TRUE(rc == 0, "Uanble to restore slave value")
  414. /** SLAVE REPLY **/
  415. printf("\nTEST SLAVE REPLY:\n");
  416. modbus_set_slave(ctx, INVALID_SERVER_ID);
  417. rc = modbus_read_registers(
  418. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB, tab_rp_registers);
  419. if (use_backend == RTU) {
  420. const int RAW_REQ_LENGTH = 6;
  421. uint8_t raw_req[] = {INVALID_SERVER_ID, 0x03, 0x00, 0x01, 0x01, 0x01};
  422. /* Too many points */
  423. uint8_t raw_invalid_req[] = {INVALID_SERVER_ID, 0x03, 0x00, 0x01, 0xFF, 0xFF};
  424. const int RAW_RSP_LENGTH = 7;
  425. uint8_t raw_rsp[] = {INVALID_SERVER_ID, 0x03, 0x04, 0, 0, 0, 0};
  426. uint8_t rsp[MODBUS_RTU_MAX_ADU_LENGTH];
  427. /* No response in RTU mode */
  428. printf("1-A/3 No response from slave %d: ", INVALID_SERVER_ID);
  429. ASSERT_TRUE(rc == -1 && errno == ETIMEDOUT, "");
  430. /* The slave raises a timeout on a confirmation to ignore because if an
  431. * indication for another slave is received, a confirmation must follow */
  432. /* Send a pair of indication/confirmation to the slave with a different
  433. * slave ID to simulate a communication on a RS485 bus. At first, the
  434. * slave will see the indication message then the confirmation, and it must
  435. * ignore both. */
  436. modbus_send_raw_request(ctx, raw_req, RAW_REQ_LENGTH * sizeof(uint8_t));
  437. modbus_send_raw_request(ctx, raw_rsp, RAW_RSP_LENGTH * sizeof(uint8_t));
  438. rc = modbus_receive_confirmation(ctx, rsp);
  439. printf("1-B/3 No response from slave %d on indication/confirmation messages: ",
  440. INVALID_SERVER_ID);
  441. ASSERT_TRUE(rc == -1 && errno == ETIMEDOUT, "");
  442. /* Send an INVALID request for another slave */
  443. modbus_send_raw_request(ctx, raw_invalid_req, RAW_REQ_LENGTH * sizeof(uint8_t));
  444. rc = modbus_receive_confirmation(ctx, rsp);
  445. printf("1-C/3 No response from slave %d with invalid request: ",
  446. INVALID_SERVER_ID);
  447. ASSERT_TRUE(rc == -1 && errno == ETIMEDOUT, "");
  448. rc = modbus_set_slave(ctx, MODBUS_BROADCAST_ADDRESS);
  449. ASSERT_TRUE(rc == 0, "Invalid broadcast address");
  450. rc = modbus_read_registers(
  451. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB, tab_rp_registers);
  452. printf("2/3 No reply after a broadcast query: ");
  453. ASSERT_TRUE(rc == -1 && errno == ETIMEDOUT, "");
  454. } else {
  455. /* Response in TCP mode */
  456. printf("1/3 Response from slave %d: ", INVALID_SERVER_ID);
  457. ASSERT_TRUE(rc == UT_REGISTERS_NB, "");
  458. rc = modbus_set_slave(ctx, MODBUS_BROADCAST_ADDRESS);
  459. ASSERT_TRUE(rc == 0, "Invalid broacast address");
  460. rc = modbus_read_registers(
  461. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB, tab_rp_registers);
  462. printf("2/3 Reply after a query with unit id == 0: ");
  463. ASSERT_TRUE(rc == UT_REGISTERS_NB, "");
  464. }
  465. /* Restore slave */
  466. modbus_set_slave(ctx, old_slave);
  467. printf("3/3 Response with an invalid TID or slave: ");
  468. rc = modbus_read_registers(
  469. ctx, UT_REGISTERS_ADDRESS_INVALID_TID_OR_SLAVE, 1, tab_rp_registers);
  470. ASSERT_TRUE(rc == -1, "");
  471. printf("1/2 Report slave ID truncated: \n");
  472. /* Set a marker to ensure limit is respected */
  473. tab_rp_bits[NB_REPORT_SLAVE_ID - 1] = 42;
  474. rc = modbus_report_slave_id(ctx, NB_REPORT_SLAVE_ID - 1, tab_rp_bits);
  475. /* Return the size required (response size) but respects the defined limit */
  476. ASSERT_TRUE(rc == NB_REPORT_SLAVE_ID && tab_rp_bits[NB_REPORT_SLAVE_ID - 1] == 42,
  477. "Return is rc %d (%d) and marker is %d (42)",
  478. rc,
  479. NB_REPORT_SLAVE_ID,
  480. tab_rp_bits[NB_REPORT_SLAVE_ID - 1]);
  481. printf("2/2 Report slave ID: \n");
  482. /* tab_rp_bits is used to store bytes */
  483. rc = modbus_report_slave_id(ctx, NB_REPORT_SLAVE_ID, tab_rp_bits);
  484. ASSERT_TRUE(rc == NB_REPORT_SLAVE_ID, "");
  485. /* Slave ID is an arbitrary number for libmodbus */
  486. ASSERT_TRUE(rc > 0, "");
  487. /* Run status indicator is ON */
  488. ASSERT_TRUE(rc > 1 && tab_rp_bits[1] == 0xFF, "");
  489. /* Print additional data as string */
  490. if (rc > 2) {
  491. printf("Additional data: ");
  492. for (i = 2; i < rc; i++) {
  493. printf("%c", tab_rp_bits[i]);
  494. }
  495. printf("\n");
  496. }
  497. /* Save original timeout */
  498. modbus_get_response_timeout(ctx, &old_response_to_sec, &old_response_to_usec);
  499. modbus_get_byte_timeout(ctx, &old_byte_to_sec, &old_byte_to_usec);
  500. rc = modbus_set_response_timeout(ctx, 0, 0);
  501. printf("1/6 Invalid response timeout (zero): ");
  502. ASSERT_TRUE(rc == -1 && errno == EINVAL, "");
  503. rc = modbus_set_response_timeout(ctx, 0, 1000000);
  504. printf("2/6 Invalid response timeout (too large us): ");
  505. ASSERT_TRUE(rc == -1 && errno == EINVAL, "");
  506. rc = modbus_set_byte_timeout(ctx, 0, 1000000);
  507. printf("3/6 Invalid byte timeout (too large us): ");
  508. ASSERT_TRUE(rc == -1 && errno == EINVAL, "");
  509. modbus_set_response_timeout(ctx, 0, 1);
  510. rc = modbus_read_registers(
  511. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB, tab_rp_registers);
  512. printf("4/6 1us response timeout: ");
  513. if (rc == -1 && errno == ETIMEDOUT) {
  514. printf("OK\n");
  515. } else {
  516. printf("FAILED (can fail on some platforms)\n");
  517. }
  518. /* A wait and flush operation is done by the error recovery code of
  519. * libmodbus but after a sleep of current response timeout
  520. * so 0 can be too short!
  521. */
  522. usleep(old_response_to_sec * 1000000 + old_response_to_usec);
  523. modbus_flush(ctx);
  524. /* Trigger a special behaviour on server to wait for 0.5 second before
  525. * replying whereas allowed timeout is 0.2 second */
  526. modbus_set_response_timeout(ctx, 0, 200000);
  527. rc = modbus_read_registers(
  528. ctx, UT_REGISTERS_ADDRESS_SLEEP_500_MS, 1, tab_rp_registers);
  529. printf("5/6 Too short response timeout (0.2s < 0.5s): ");
  530. ASSERT_TRUE(rc == -1 && errno == ETIMEDOUT, "");
  531. /* Wait for reply (0.2 + 0.4 > 0.5 s) and flush before continue */
  532. usleep(400000);
  533. modbus_flush(ctx);
  534. modbus_set_response_timeout(ctx, 0, 600000);
  535. rc = modbus_read_registers(
  536. ctx, UT_REGISTERS_ADDRESS_SLEEP_500_MS, 1, tab_rp_registers);
  537. printf("6/6 Adequate response timeout (0.6s > 0.5s): ");
  538. ASSERT_TRUE(rc == 1, "");
  539. /* Disable the byte timeout.
  540. The full response must be available in the 600ms interval */
  541. modbus_set_byte_timeout(ctx, 0, 0);
  542. rc = modbus_read_registers(
  543. ctx, UT_REGISTERS_ADDRESS_SLEEP_500_MS, 1, tab_rp_registers);
  544. printf("7/7 Disable byte timeout: ");
  545. ASSERT_TRUE(rc == 1, "");
  546. /* Restore original response timeout */
  547. modbus_set_response_timeout(ctx, old_response_to_sec, old_response_to_usec);
  548. if (use_backend == TCP) {
  549. /* The test server is only able to test byte timeouts with the TCP
  550. * backend */
  551. /* Timeout of 3ms between bytes */
  552. modbus_set_byte_timeout(ctx, 0, 3000);
  553. rc = modbus_read_registers(
  554. ctx, UT_REGISTERS_ADDRESS_BYTE_SLEEP_5_MS, 1, tab_rp_registers);
  555. printf("1/2 Too small byte timeout (3ms < 5ms): ");
  556. ASSERT_TRUE(rc == -1 && errno == ETIMEDOUT, "");
  557. /* Wait remaining bytes before flushing */
  558. usleep(11 * 5000);
  559. modbus_flush(ctx);
  560. /* Timeout of 7ms between bytes */
  561. modbus_set_byte_timeout(ctx, 0, 7000);
  562. rc = modbus_read_registers(
  563. ctx, UT_REGISTERS_ADDRESS_BYTE_SLEEP_5_MS, 1, tab_rp_registers);
  564. printf("2/2 Adapted byte timeout (7ms > 5ms): ");
  565. ASSERT_TRUE(rc == 1, "");
  566. }
  567. /* Restore original byte timeout */
  568. modbus_set_byte_timeout(ctx, old_byte_to_sec, old_byte_to_usec);
  569. /** BAD RESPONSE **/
  570. printf("\nTEST BAD RESPONSE ERROR:\n");
  571. /* Allocate only the required space */
  572. tab_rp_registers_bad =
  573. (uint16_t *) malloc(UT_REGISTERS_NB_SPECIAL * sizeof(uint16_t));
  574. rc = modbus_read_registers(
  575. ctx, UT_REGISTERS_ADDRESS, UT_REGISTERS_NB_SPECIAL, tab_rp_registers_bad);
  576. printf("* modbus_read_registers: ");
  577. ASSERT_TRUE(rc == -1 && errno == EMBBADDATA, "");
  578. free(tab_rp_registers_bad);
  579. /** MANUAL EXCEPTION **/
  580. printf("\nTEST MANUAL EXCEPTION:\n");
  581. rc = modbus_read_registers(
  582. ctx, UT_REGISTERS_ADDRESS_SPECIAL, UT_REGISTERS_NB, tab_rp_registers);
  583. printf("* modbus_read_registers at special address: ");
  584. ASSERT_TRUE(rc == -1 && errno == EMBXSBUSY, "");
  585. /** Run a few tests to challenge the server code **/
  586. if (test_server(ctx, use_backend) == -1) {
  587. goto close;
  588. }
  589. modbus_close(ctx);
  590. modbus_free(ctx);
  591. ctx = NULL;
  592. /* Test init functions */
  593. printf("\nTEST INVALID INITIALIZATION:\n");
  594. ctx = modbus_new_rtu(NULL, 1, 'A', 0, 0);
  595. ASSERT_TRUE(ctx == NULL && errno == EINVAL, "");
  596. ctx = modbus_new_rtu("/dev/dummy", 0, 'A', 0, 0);
  597. ASSERT_TRUE(ctx == NULL && errno == EINVAL, "");
  598. printf("\nALL TESTS PASS WITH SUCCESS.\n");
  599. success = TRUE;
  600. close:
  601. /* Free the memory */
  602. free(tab_rp_bits);
  603. free(tab_rp_registers);
  604. /* Close the connection */
  605. modbus_close(ctx);
  606. modbus_free(ctx);
  607. return (success) ? 0 : -1;
  608. }
  609. /* Send crafted requests to test server resilience
  610. and ensure proper exceptions are returned. */
  611. int test_server(modbus_t *ctx, int use_backend)
  612. {
  613. int rc;
  614. int i;
  615. /* Read requests */
  616. const int READ_RAW_REQ_LEN = 6;
  617. const int slave = (use_backend == RTU) ? SERVER_ID : MODBUS_TCP_SLAVE;
  618. uint8_t read_raw_req[] = {slave,
  619. /* function, address, 5 values */
  620. MODBUS_FC_READ_HOLDING_REGISTERS,
  621. UT_REGISTERS_ADDRESS >> 8,
  622. UT_REGISTERS_ADDRESS & 0xFF,
  623. 0x0,
  624. 0x05};
  625. /* Write and read registers request */
  626. const int RW_RAW_REQ_LEN = 13;
  627. uint8_t rw_raw_req[] = {slave,
  628. /* function, addr to read, nb to read */
  629. MODBUS_FC_WRITE_AND_READ_REGISTERS,
  630. /* Read */
  631. UT_REGISTERS_ADDRESS >> 8,
  632. UT_REGISTERS_ADDRESS & 0xFF,
  633. (MODBUS_MAX_WR_READ_REGISTERS + 1) >> 8,
  634. (MODBUS_MAX_WR_READ_REGISTERS + 1) & 0xFF,
  635. /* Write */
  636. 0,
  637. 0,
  638. 0,
  639. 1,
  640. /* Write byte count */
  641. 1 * 2,
  642. /* One data to write... */
  643. 0x12,
  644. 0x34};
  645. const int WRITE_RAW_REQ_LEN = 13;
  646. uint8_t write_raw_req[] = {slave,
  647. /* function will be set in the loop */
  648. MODBUS_FC_WRITE_MULTIPLE_REGISTERS,
  649. /* Address */
  650. UT_REGISTERS_ADDRESS >> 8,
  651. UT_REGISTERS_ADDRESS & 0xFF,
  652. /* 3 values, 6 bytes */
  653. 0x00,
  654. 0x03,
  655. 0x06,
  656. /* Dummy data to write */
  657. 0x02,
  658. 0x2B,
  659. 0x00,
  660. 0x01,
  661. 0x00,
  662. 0x64};
  663. const int INVALID_FC = 0x42;
  664. const int INVALID_FC_REQ_LEN = 6;
  665. uint8_t invalid_fc_raw_req[] = {slave, 0x42, 0x00, 0x00, 0x00, 0x00};
  666. int req_length;
  667. uint8_t rsp[MODBUS_TCP_MAX_ADU_LENGTH];
  668. int tab_read_function[] = {MODBUS_FC_READ_COILS,
  669. MODBUS_FC_READ_DISCRETE_INPUTS,
  670. MODBUS_FC_READ_HOLDING_REGISTERS,
  671. MODBUS_FC_READ_INPUT_REGISTERS};
  672. int tab_read_nb_max[] = {MODBUS_MAX_READ_BITS + 1,
  673. MODBUS_MAX_READ_BITS + 1,
  674. MODBUS_MAX_READ_REGISTERS + 1,
  675. MODBUS_MAX_READ_REGISTERS + 1};
  676. int backend_length;
  677. int backend_offset;
  678. if (use_backend == RTU) {
  679. backend_length = 3;
  680. backend_offset = 1;
  681. } else {
  682. backend_length = 7;
  683. backend_offset = 7;
  684. }
  685. printf("\nTEST RAW REQUESTS:\n");
  686. uint32_t old_response_to_sec;
  687. uint32_t old_response_to_usec;
  688. /* This requests can generate flushes server side so we need a higher
  689. * response timeout than the server. The server uses the defined response
  690. * timeout to sleep before flushing.
  691. * The old timeouts are restored at the end.
  692. */
  693. modbus_get_response_timeout(ctx, &old_response_to_sec, &old_response_to_usec);
  694. modbus_set_response_timeout(ctx, 0, 600000);
  695. int old_s = modbus_get_socket(ctx);
  696. modbus_set_socket(ctx, -1);
  697. rc = modbus_receive(ctx, rsp);
  698. modbus_set_socket(ctx, old_s);
  699. printf("* modbus_receive with invalid socket: ");
  700. ASSERT_TRUE(rc == -1, "FAILED (%d)\n", rc);
  701. req_length = modbus_send_raw_request(ctx, read_raw_req, READ_RAW_REQ_LEN);
  702. printf("* modbus_send_raw_request: ");
  703. ASSERT_TRUE(req_length == (backend_length + 5), "FAILED (%d)\n", req_length);
  704. printf("* modbus_receive_confirmation: ");
  705. rc = modbus_receive_confirmation(ctx, rsp);
  706. ASSERT_TRUE(rc == (backend_length + 12), "FAILED (%d)\n", rc);
  707. /* Try to read more values than a response could hold for all data
  708. types. */
  709. for (i = 0; i < 4; i++) {
  710. rc = send_crafted_request(ctx,
  711. tab_read_function[i],
  712. read_raw_req,
  713. READ_RAW_REQ_LEN,
  714. tab_read_nb_max[i],
  715. 0,
  716. backend_length,
  717. backend_offset);
  718. if (rc == -1)
  719. goto close;
  720. }
  721. rc = send_crafted_request(ctx,
  722. MODBUS_FC_WRITE_AND_READ_REGISTERS,
  723. rw_raw_req,
  724. RW_RAW_REQ_LEN,
  725. MODBUS_MAX_WR_READ_REGISTERS + 1,
  726. 0,
  727. backend_length,
  728. backend_offset);
  729. if (rc == -1)
  730. goto close;
  731. rc = send_crafted_request(ctx,
  732. MODBUS_FC_WRITE_MULTIPLE_REGISTERS,
  733. write_raw_req,
  734. WRITE_RAW_REQ_LEN,
  735. MODBUS_MAX_WRITE_REGISTERS + 1,
  736. 6,
  737. backend_length,
  738. backend_offset);
  739. if (rc == -1)
  740. goto close;
  741. rc = send_crafted_request(ctx,
  742. MODBUS_FC_WRITE_MULTIPLE_COILS,
  743. write_raw_req,
  744. WRITE_RAW_REQ_LEN,
  745. MODBUS_MAX_WRITE_BITS + 1,
  746. 6,
  747. backend_length,
  748. backend_offset);
  749. if (rc == -1)
  750. goto close;
  751. /* Modbus write multiple registers with large number of values but a set a
  752. small number of bytes in requests (not nb * 2 as usual). */
  753. rc = send_crafted_request(ctx,
  754. MODBUS_FC_WRITE_MULTIPLE_REGISTERS,
  755. write_raw_req,
  756. WRITE_RAW_REQ_LEN,
  757. MODBUS_MAX_WRITE_REGISTERS,
  758. 6,
  759. backend_length,
  760. backend_offset);
  761. if (rc == -1)
  762. goto close;
  763. rc = send_crafted_request(ctx,
  764. MODBUS_FC_WRITE_MULTIPLE_COILS,
  765. write_raw_req,
  766. WRITE_RAW_REQ_LEN,
  767. MODBUS_MAX_WRITE_BITS,
  768. 6,
  769. backend_length,
  770. backend_offset);
  771. if (rc == -1)
  772. goto close;
  773. /* Test invalid function code */
  774. modbus_send_raw_request(
  775. ctx, invalid_fc_raw_req, INVALID_FC_REQ_LEN * sizeof(uint8_t));
  776. rc = modbus_receive_confirmation(ctx, rsp);
  777. printf("Return an exception on unknown function code: ");
  778. ASSERT_TRUE(rc == (backend_length + EXCEPTION_RC) &&
  779. rsp[backend_offset] == (0x80 + INVALID_FC),
  780. "")
  781. modbus_set_response_timeout(ctx, old_response_to_sec, old_response_to_usec);
  782. return 0;
  783. close:
  784. modbus_set_response_timeout(ctx, old_response_to_sec, old_response_to_usec);
  785. return -1;
  786. }
  787. int send_crafted_request(modbus_t *ctx,
  788. int function,
  789. uint8_t *req,
  790. int req_len,
  791. uint16_t max_value,
  792. uint16_t bytes,
  793. int backend_length,
  794. int backend_offset)
  795. {
  796. uint8_t rsp[MODBUS_TCP_MAX_ADU_LENGTH];
  797. int j;
  798. for (j = 0; j < 2; j++) {
  799. int rc;
  800. req[1] = function;
  801. if (j == 0) {
  802. /* Try to read or write zero values on first iteration */
  803. req[4] = 0x00;
  804. req[5] = 0x00;
  805. if (bytes) {
  806. /* Write query */
  807. req[6] = 0x00;
  808. }
  809. } else {
  810. /* Try to read or write max values + 1 on second iteration */
  811. req[4] = (max_value >> 8) & 0xFF;
  812. req[5] = max_value & 0xFF;
  813. if (bytes) {
  814. /* Write query (nb values * 2 to convert in bytes for registers) */
  815. req[6] = bytes;
  816. }
  817. }
  818. modbus_send_raw_request(ctx, req, req_len * sizeof(uint8_t));
  819. if (j == 0) {
  820. printf(
  821. "* try function 0x%X: %s 0 values: ", function, bytes ? "write" : "read");
  822. } else {
  823. printf("* try function 0x%X: %s %d values: ",
  824. function,
  825. bytes ? "write" : "read",
  826. max_value);
  827. }
  828. rc = modbus_receive_confirmation(ctx, rsp);
  829. ASSERT_TRUE(rc == (backend_length + EXCEPTION_RC) &&
  830. rsp[backend_offset] == (0x80 + function) &&
  831. rsp[backend_offset + 1] == MODBUS_EXCEPTION_ILLEGAL_DATA_VALUE,
  832. "");
  833. }
  834. return 0;
  835. close:
  836. return -1;
  837. }