unit-test-client.c 33 KB

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