test_i2c.c 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734
  1. /*
  2. * SPDX-FileCopyrightText: 2021-2022 Espressif Systems (Shanghai) CO LTD
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. */
  6. /**
  7. * test environment UT_T2_I2C:
  8. * please prepare two ESP32-WROVER-KIT board.
  9. * Then connect GPIO18 and GPIO18, GPIO19 and GPIO19 between these two boards.
  10. */
  11. #include <stdio.h>
  12. #include <string.h>
  13. #include "unity.h"
  14. #include "test_utils.h"
  15. #include "unity_config.h"
  16. #include "driver/i2c.h"
  17. #include "esp_attr.h"
  18. #include "esp_log.h"
  19. #include "soc/gpio_periph.h"
  20. #include "soc/i2c_periph.h"
  21. #include "esp_system.h"
  22. #include "soc/uart_struct.h"
  23. #include "esp_private/periph_ctrl.h"
  24. #include "esp_rom_gpio.h"
  25. #include "hal/gpio_hal.h"
  26. #include "hal/uart_ll.h"
  27. #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32C6)
  28. #if SOC_I2C_SUPPORT_SLAVE // i2c test can't work without slave
  29. #define DATA_LENGTH 512 /*!<Data buffer length for test buffer*/
  30. #define RW_TEST_LENGTH 129 /*!<Data length for r/w test, any value from 0-DATA_LENGTH*/
  31. #define DELAY_TIME_BETWEEN_ITEMS_MS 1234 /*!< delay time between different test items */
  32. #if CONFIG_IDF_TARGET_ESP32C3 || CONFIG_IDF_TARGET_ESP32S3 || CONFIG_IDF_TARGET_ESP32H4
  33. #define I2C_SLAVE_SCL_IO 5 /*!<gpio number for i2c slave clock */
  34. #define I2C_SLAVE_SDA_IO 6 /*!<gpio number for i2c slave data */
  35. #else
  36. #define I2C_SLAVE_SCL_IO 19 /*!<gpio number for i2c slave clock */
  37. #define I2C_SLAVE_SDA_IO 18 /*!<gpio number for i2c slave data */
  38. #endif
  39. #define I2C_SLAVE_NUM I2C_NUM_0 /*!<I2C port number for slave dev */
  40. #define I2C_SLAVE_TX_BUF_LEN (2*DATA_LENGTH) /*!<I2C slave tx buffer size */
  41. #define I2C_SLAVE_RX_BUF_LEN (2*DATA_LENGTH) /*!<I2C slave rx buffer size */
  42. #if CONFIG_IDF_TARGET_ESP32C3 || CONFIG_IDF_TARGET_ESP32H4
  43. #define I2C_MASTER_SCL_IO 5 /*!<gpio number for i2c master clock */
  44. #define I2C_MASTER_SDA_IO 6 /*!<gpio number for i2c master data */
  45. #elif CONFIG_IDF_TARGET_ESP32S3
  46. #define I2C_MASTER_SCL_IO 2 /*!<gpio number for i2c master clock */
  47. #define I2C_MASTER_SDA_IO 1 /*!<gpio number for i2c master data */
  48. #else
  49. #define I2C_MASTER_SCL_IO 19 /*!< gpio number for I2C master clock */
  50. #define I2C_MASTER_SDA_IO 18 /*!< gpio number for I2C master data */
  51. #endif
  52. #define I2C_MASTER_NUM I2C_NUM_0 /*!< I2C port number for master dev */
  53. #define I2C_MASTER_TX_BUF_DISABLE 0 /*!< I2C master do not need buffer */
  54. #define I2C_MASTER_RX_BUF_DISABLE 0 /*!< I2C master do not need buffer */
  55. #define I2C_MASTER_FREQ_HZ 100000 /*!< I2C master clock frequency */
  56. #define ESP_SLAVE_ADDR 0x28 /*!< ESP32 slave address, you can set any 7bit value */
  57. #define WRITE_BIT I2C_MASTER_WRITE /*!< I2C master write */
  58. #define READ_BIT I2C_MASTER_READ /*!< I2C master read */
  59. #define ACK_CHECK_EN 0x1 /*!< I2C master will check ack from slave*/
  60. #define ACK_CHECK_DIS 0x0 /*!< I2C master will not check ack from slave */
  61. #define ACK_VAL 0x0 /*!< I2C ack value */
  62. #define NACK_VAL 0x1 /*!< I2C nack value */
  63. #define PULSE_IO 19
  64. #define PCNT_INPUT_IO 4
  65. #define PCNT_CTRL_FLOATING_IO 5
  66. #define HIGHEST_LIMIT 10000
  67. #define LOWEST_LIMIT -10000
  68. static DRAM_ATTR i2c_dev_t *const I2C[SOC_I2C_NUM] = { &I2C0,
  69. #if SOC_I2C_NUM > 1
  70. &I2C1,
  71. #endif
  72. };
  73. static esp_err_t i2c_master_write_slave(i2c_port_t i2c_num, uint8_t *data_wr, size_t size)
  74. {
  75. i2c_cmd_handle_t cmd = i2c_cmd_link_create();
  76. i2c_master_start(cmd);
  77. TEST_ESP_OK(i2c_master_write_byte(cmd, ( ESP_SLAVE_ADDR << 1 ) | WRITE_BIT, ACK_CHECK_EN));
  78. TEST_ESP_OK(i2c_master_write(cmd, data_wr, size, ACK_CHECK_EN));
  79. TEST_ESP_OK(i2c_master_stop(cmd));
  80. esp_err_t ret = i2c_master_cmd_begin(i2c_num, cmd, 5000 / portTICK_PERIOD_MS);
  81. i2c_cmd_link_delete(cmd);
  82. return ret;
  83. }
  84. static i2c_config_t i2c_master_init(void)
  85. {
  86. i2c_config_t conf_master = {
  87. .mode = I2C_MODE_MASTER,
  88. .sda_pullup_en = GPIO_PULLUP_ENABLE,
  89. .scl_pullup_en = GPIO_PULLUP_ENABLE,
  90. .master.clk_speed = I2C_MASTER_FREQ_HZ,
  91. .sda_io_num = I2C_MASTER_SDA_IO,
  92. .scl_io_num = I2C_MASTER_SCL_IO,
  93. .clk_flags = 0,
  94. };
  95. return conf_master;
  96. }
  97. static i2c_config_t i2c_slave_init(void)
  98. {
  99. i2c_config_t conf_slave = {
  100. .mode = I2C_MODE_SLAVE,
  101. .sda_io_num = I2C_SLAVE_SDA_IO,
  102. .scl_io_num = I2C_SLAVE_SCL_IO,
  103. .sda_pullup_en = GPIO_PULLUP_ENABLE,
  104. .scl_pullup_en = GPIO_PULLUP_ENABLE,
  105. .slave.addr_10bit_en = 0,
  106. .slave.slave_addr = ESP_SLAVE_ADDR,
  107. };
  108. return conf_slave;
  109. }
  110. TEST_CASE("I2C i2c_set_pin() fails if sda and scl gpios are same", "[i2c]")
  111. {
  112. TEST_ASSERT_EQUAL(ESP_ERR_INVALID_ARG, i2c_set_pin(0, 0, 0, true, true , I2C_MODE_SLAVE));
  113. }
  114. TEST_CASE("I2C config test", "[i2c]")
  115. {
  116. // master test
  117. i2c_config_t conf_master = i2c_master_init();
  118. gpio_pullup_t sda_pull_up_en[2] = {GPIO_PULLUP_DISABLE, GPIO_PULLUP_ENABLE};
  119. gpio_pullup_t scl_pull_up_en[2] = {GPIO_PULLUP_DISABLE, GPIO_PULLUP_ENABLE};
  120. for (int i = 0; i < 2; i++) {
  121. for (int j = 0; j < 2; j++) {
  122. conf_master.sda_pullup_en = sda_pull_up_en[i];
  123. conf_master.scl_pullup_en = scl_pull_up_en[j];
  124. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  125. I2C_MASTER_RX_BUF_DISABLE,
  126. I2C_MASTER_TX_BUF_DISABLE, 0));
  127. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  128. TEST_ASSERT_EQUAL_INT32(I2C[I2C_MASTER_NUM]->ctr.ms_mode, 1);
  129. TEST_ESP_OK(i2c_driver_delete(I2C_MASTER_NUM));
  130. }
  131. }
  132. // slave test
  133. i2c_config_t conf_slave = i2c_slave_init();
  134. for (int i = 0; i < 2; i++) {
  135. for (int j = 0; j < 2; j++) {
  136. conf_slave.sda_pullup_en = sda_pull_up_en[i];
  137. conf_slave.scl_pullup_en = scl_pull_up_en[j];
  138. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  139. I2C_SLAVE_RX_BUF_LEN,
  140. I2C_SLAVE_TX_BUF_LEN, 0));
  141. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  142. TEST_ASSERT_EQUAL_INT32(I2C[I2C_SLAVE_NUM] -> ctr.ms_mode, 0);
  143. TEST_ESP_OK(i2c_driver_delete(I2C_SLAVE_NUM));
  144. }
  145. }
  146. }
  147. TEST_CASE("I2C set and get period test", "[i2c]")
  148. {
  149. int high_period, low_period;
  150. i2c_config_t conf_master = i2c_master_init();
  151. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  152. I2C_MASTER_RX_BUF_DISABLE,
  153. I2C_MASTER_TX_BUF_DISABLE, 0));
  154. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  155. TEST_ESP_OK(i2c_set_period(I2C_MASTER_NUM, I2C_SCL_HIGH_PERIOD_V, I2C_SCL_HIGH_PERIOD_V));
  156. TEST_ESP_OK(i2c_get_period(I2C_MASTER_NUM, &high_period, &low_period));
  157. TEST_ASSERT_EQUAL_INT(I2C_SCL_HIGH_PERIOD_V, high_period);
  158. TEST_ASSERT_EQUAL_INT(I2C_SCL_HIGH_PERIOD_V, low_period);
  159. TEST_ASSERT_NOT_NULL((void *)i2c_set_period(I2C_MASTER_NUM, I2C_SCL_HIGH_PERIOD_V + 1, I2C_SCL_HIGH_PERIOD_V + 1));
  160. TEST_ESP_OK(i2c_set_period(I2C_MASTER_NUM, 300, 400));
  161. TEST_ESP_OK(i2c_get_period(I2C_MASTER_NUM, &high_period, &low_period));
  162. TEST_ASSERT_EQUAL_INT(300, high_period);
  163. TEST_ASSERT_EQUAL_INT(400, low_period);
  164. TEST_ESP_OK(i2c_driver_delete(I2C_MASTER_NUM));
  165. }
  166. TEST_CASE("I2C config FIFO test", "[i2c]")
  167. {
  168. i2c_config_t conf_slave = i2c_slave_init();
  169. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  170. I2C_SLAVE_RX_BUF_LEN,
  171. I2C_SLAVE_TX_BUF_LEN, 0));
  172. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  173. TEST_ASSERT_BIT_LOW(1, I2C[I2C_SLAVE_NUM]->fifo_conf.tx_fifo_rst);
  174. TEST_ESP_OK(i2c_reset_tx_fifo(I2C_SLAVE_NUM));
  175. TEST_ASSERT_BIT_LOW(0, I2C[I2C_SLAVE_NUM]->fifo_conf.tx_fifo_rst);
  176. TEST_ESP_OK(i2c_reset_rx_fifo(I2C_SLAVE_NUM));
  177. TEST_ASSERT_BIT_LOW(0, I2C[I2C_SLAVE_NUM]->fifo_conf.rx_fifo_rst);
  178. TEST_ESP_OK(i2c_driver_delete(I2C_SLAVE_NUM));
  179. }
  180. TEST_CASE("I2C timing test", "[i2c]")
  181. {
  182. int test_setup_time, test_data_time, test_stop_time, test_hold_time;
  183. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  184. i2c_config_t conf_master = i2c_master_init();
  185. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  186. I2C_MASTER_RX_BUF_DISABLE,
  187. I2C_MASTER_TX_BUF_DISABLE, 0));
  188. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  189. TEST_ESP_OK(i2c_set_start_timing(I2C_MASTER_NUM, 50, 60));
  190. TEST_ESP_OK(i2c_set_data_timing(I2C_MASTER_NUM, 80, 60));
  191. TEST_ESP_OK(i2c_set_stop_timing(I2C_MASTER_NUM, 100, 60));
  192. for (int i = 0; i < DATA_LENGTH; i++) {
  193. data_wr[i] = i;
  194. }
  195. i2c_master_write_slave(I2C_MASTER_NUM, data_wr, RW_TEST_LENGTH);
  196. TEST_ESP_OK(i2c_get_start_timing(I2C_MASTER_NUM, &test_setup_time, &test_hold_time));
  197. TEST_ESP_OK(i2c_get_data_timing(I2C_MASTER_NUM, &test_data_time, &test_hold_time));
  198. TEST_ESP_OK(i2c_get_stop_timing(I2C_MASTER_NUM, &test_stop_time, &test_hold_time));
  199. TEST_ASSERT_EQUAL_INT32(50, test_setup_time);
  200. TEST_ASSERT_EQUAL_INT32(80, test_data_time);
  201. TEST_ASSERT_EQUAL_INT32(100, test_stop_time);
  202. TEST_ASSERT_EQUAL_INT32(60, test_hold_time);
  203. free(data_wr);
  204. i2c_driver_delete(I2C_MASTER_NUM);
  205. }
  206. TEST_CASE("I2C data mode test", "[i2c]")
  207. {
  208. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  209. i2c_trans_mode_t test_tx_trans_mode, test_rx_trans_mode;
  210. i2c_config_t conf_master = i2c_master_init();
  211. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  212. I2C_MASTER_RX_BUF_DISABLE,
  213. I2C_MASTER_TX_BUF_DISABLE, 0));
  214. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  215. for (int i = 0; i < DATA_LENGTH; i++) {
  216. data_wr[i] = i;
  217. }
  218. TEST_ESP_OK(i2c_set_data_mode(I2C_MASTER_NUM, I2C_DATA_MODE_LSB_FIRST, I2C_DATA_MODE_LSB_FIRST));
  219. TEST_ESP_OK(i2c_get_data_mode(I2C_MASTER_NUM, &test_tx_trans_mode, &test_rx_trans_mode));
  220. TEST_ASSERT_EQUAL_INT(I2C_DATA_MODE_LSB_FIRST, test_tx_trans_mode);
  221. TEST_ASSERT_EQUAL_INT(I2C_DATA_MODE_LSB_FIRST, test_rx_trans_mode);
  222. i2c_master_write_slave(I2C_MASTER_NUM, data_wr, RW_TEST_LENGTH);
  223. TEST_ESP_OK(i2c_set_data_mode(I2C_MASTER_NUM, I2C_DATA_MODE_MSB_FIRST, I2C_DATA_MODE_MSB_FIRST));
  224. TEST_ESP_OK(i2c_get_data_mode(I2C_MASTER_NUM, &test_tx_trans_mode, &test_rx_trans_mode));
  225. TEST_ASSERT_EQUAL_INT(I2C_DATA_MODE_MSB_FIRST, test_tx_trans_mode);
  226. TEST_ASSERT_EQUAL_INT(I2C_DATA_MODE_MSB_FIRST, test_rx_trans_mode);
  227. i2c_master_write_slave(I2C_MASTER_NUM, data_wr, RW_TEST_LENGTH);
  228. free(data_wr);
  229. i2c_driver_delete(I2C_MASTER_NUM);
  230. }
  231. TEST_CASE("I2C driver memory leaking check", "[i2c]")
  232. {
  233. esp_err_t ret;
  234. int size = esp_get_free_heap_size();
  235. for (uint32_t i = 0; i <= 1000; i++) {
  236. ret = i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  237. I2C_SLAVE_RX_BUF_LEN,
  238. I2C_SLAVE_TX_BUF_LEN, 0);
  239. TEST_ASSERT(ret == ESP_OK);
  240. vTaskDelay(10 / portTICK_PERIOD_MS);
  241. i2c_driver_delete(I2C_SLAVE_NUM);
  242. TEST_ASSERT(ret == ESP_OK);
  243. }
  244. TEST_ASSERT_INT_WITHIN(100, size, esp_get_free_heap_size());
  245. }
  246. #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2, ESP32S3, ESP32C2)
  247. // print the reading buffer
  248. static void disp_buf(uint8_t *buf, int len)
  249. {
  250. int i;
  251. for (i = 0; i < len; i++) {
  252. printf("%02x ", buf[i]);
  253. if (( i + 1 ) % 16 == 0) {
  254. printf("\n");
  255. }
  256. }
  257. printf("\n");
  258. }
  259. static void i2c_master_write_test(void)
  260. {
  261. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  262. int i;
  263. i2c_config_t conf_master = i2c_master_init();
  264. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  265. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  266. I2C_MASTER_RX_BUF_DISABLE,
  267. I2C_MASTER_TX_BUF_DISABLE, 0));
  268. unity_wait_for_signal("i2c slave init finish");
  269. unity_send_signal("master write");
  270. for (i = 0; i < DATA_LENGTH / 2; i++) {
  271. data_wr[i] = i;
  272. }
  273. i2c_master_write_slave(I2C_MASTER_NUM, data_wr, DATA_LENGTH / 2);
  274. disp_buf(data_wr, i + 1);
  275. free(data_wr);
  276. unity_wait_for_signal("ready to delete");
  277. TEST_ESP_OK(i2c_driver_delete(I2C_MASTER_NUM));
  278. }
  279. static void i2c_slave_read_test(void)
  280. {
  281. uint8_t *data_rd = (uint8_t *) malloc(DATA_LENGTH);
  282. int size_rd = 0;
  283. int len = 0;
  284. i2c_config_t conf_slave = i2c_slave_init();
  285. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  286. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  287. I2C_SLAVE_RX_BUF_LEN,
  288. I2C_SLAVE_TX_BUF_LEN, 0));
  289. unity_send_signal("i2c slave init finish");
  290. unity_wait_for_signal("master write");
  291. while (1) {
  292. len = i2c_slave_read_buffer( I2C_SLAVE_NUM, data_rd + size_rd, DATA_LENGTH, 10000 / portTICK_PERIOD_MS);
  293. if (len == 0) {
  294. break;
  295. }
  296. size_rd += len;
  297. }
  298. disp_buf(data_rd, size_rd);
  299. for (int i = 0; i < size_rd; i++) {
  300. TEST_ASSERT(data_rd[i] == i);
  301. }
  302. free(data_rd);
  303. unity_send_signal("ready to delete");
  304. TEST_ESP_OK(i2c_driver_delete(I2C_SLAVE_NUM));
  305. }
  306. TEST_CASE_MULTIPLE_DEVICES("I2C master write slave test", "[i2c][test_env=UT_T2_I2C][timeout=150]", i2c_master_write_test, i2c_slave_read_test);
  307. static void master_read_slave_test(void)
  308. {
  309. uint8_t *data_rd = (uint8_t *) malloc(DATA_LENGTH);
  310. memset(data_rd, 0, DATA_LENGTH);
  311. i2c_config_t conf_master = i2c_master_init();
  312. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  313. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  314. I2C_MASTER_RX_BUF_DISABLE,
  315. I2C_MASTER_TX_BUF_DISABLE, 0));
  316. unity_wait_for_signal("i2c slave init finish");
  317. i2c_cmd_handle_t cmd = i2c_cmd_link_create();
  318. i2c_master_start(cmd);
  319. i2c_master_write_byte(cmd, ( ESP_SLAVE_ADDR << 1 ) | READ_BIT, ACK_CHECK_EN);
  320. unity_send_signal("slave write");
  321. unity_wait_for_signal("master read");
  322. i2c_master_read(cmd, data_rd, RW_TEST_LENGTH-1, ACK_VAL);
  323. i2c_master_read_byte(cmd, data_rd + RW_TEST_LENGTH-1, NACK_VAL);
  324. i2c_master_stop(cmd);
  325. i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 5000 / portTICK_PERIOD_MS);
  326. i2c_cmd_link_delete(cmd);
  327. vTaskDelay(100 / portTICK_PERIOD_MS);
  328. for (int i = 0; i < RW_TEST_LENGTH; i++) {
  329. printf("%d\n", data_rd[i]);
  330. TEST_ASSERT(data_rd[i]==i);
  331. }
  332. free(data_rd);
  333. unity_send_signal("ready to delete");
  334. i2c_driver_delete(I2C_MASTER_NUM);
  335. }
  336. static void slave_write_buffer_test(void)
  337. {
  338. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  339. int size_rd;
  340. i2c_config_t conf_slave = i2c_slave_init();
  341. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  342. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  343. I2C_SLAVE_RX_BUF_LEN,
  344. I2C_SLAVE_TX_BUF_LEN, 0));
  345. unity_send_signal("i2c slave init finish");
  346. unity_wait_for_signal("slave write");
  347. for (int i = 0; i < DATA_LENGTH / 2; i++) {
  348. data_wr[i] = i;
  349. }
  350. size_rd = i2c_slave_write_buffer(I2C_SLAVE_NUM, data_wr, RW_TEST_LENGTH, 2000 / portTICK_PERIOD_MS);
  351. disp_buf(data_wr, size_rd);
  352. unity_send_signal("master read");
  353. unity_wait_for_signal("ready to delete");
  354. free(data_wr);
  355. i2c_driver_delete(I2C_SLAVE_NUM);
  356. }
  357. TEST_CASE_MULTIPLE_DEVICES("I2C master read slave test", "[i2c][test_env=UT_T2_I2C][timeout=150]", master_read_slave_test, slave_write_buffer_test);
  358. #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2, ESP32)
  359. static void i2c_master_write_read_test(void)
  360. {
  361. uint8_t *data_rd = (uint8_t *) malloc(DATA_LENGTH);
  362. memset(data_rd, 0, DATA_LENGTH);
  363. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  364. i2c_config_t conf_master = i2c_master_init();
  365. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  366. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  367. I2C_MASTER_RX_BUF_DISABLE,
  368. I2C_MASTER_TX_BUF_DISABLE, 0));
  369. unity_wait_for_signal("i2c slave init finish");
  370. i2c_cmd_handle_t cmd = i2c_cmd_link_create();
  371. i2c_master_start(cmd);
  372. i2c_master_write_byte(cmd, ( ESP_SLAVE_ADDR << 1 ) | READ_BIT, ACK_CHECK_EN);
  373. unity_send_signal("slave write");
  374. unity_wait_for_signal("master read and write");
  375. i2c_master_read(cmd, data_rd, RW_TEST_LENGTH, ACK_VAL);
  376. i2c_master_read_byte(cmd, data_rd + RW_TEST_LENGTH, NACK_VAL);
  377. i2c_master_stop(cmd);
  378. i2c_master_cmd_begin(I2C_MASTER_NUM, cmd, 5000 / portTICK_PERIOD_MS);
  379. i2c_cmd_link_delete(cmd);
  380. vTaskDelay(100 / portTICK_PERIOD_MS);
  381. disp_buf(data_rd, RW_TEST_LENGTH);
  382. for (int i = 0; i < RW_TEST_LENGTH; i++) {
  383. TEST_ASSERT(data_rd[i] == i/2);
  384. }
  385. for (int i = 0; i < DATA_LENGTH; i++) {
  386. data_wr[i] = i % 3;
  387. }
  388. vTaskDelay(100 / portTICK_PERIOD_MS);
  389. i2c_master_write_slave(I2C_MASTER_NUM, data_wr, RW_TEST_LENGTH);
  390. free(data_wr);
  391. free(data_rd);
  392. unity_send_signal("slave read");
  393. unity_wait_for_signal("ready to delete");
  394. i2c_driver_delete(I2C_MASTER_NUM);
  395. }
  396. static void i2c_slave_read_write_test(void)
  397. {
  398. uint8_t *data_rd = (uint8_t *) malloc(DATA_LENGTH);
  399. memset(data_rd, 0, DATA_LENGTH);
  400. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  401. int size_rd;
  402. i2c_config_t conf_slave = i2c_slave_init();
  403. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  404. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  405. I2C_SLAVE_RX_BUF_LEN,
  406. I2C_SLAVE_TX_BUF_LEN, 0));
  407. unity_send_signal("i2c slave init finish");
  408. unity_wait_for_signal("slave write");
  409. for (int i = 0; i < DATA_LENGTH / 2; i++) {
  410. data_wr[i] = i/2;
  411. }
  412. size_rd = i2c_slave_write_buffer(I2C_SLAVE_NUM, data_wr, RW_TEST_LENGTH, 2000 / portTICK_PERIOD_MS);
  413. disp_buf(data_wr, size_rd);
  414. unity_send_signal("master read and write");
  415. unity_wait_for_signal("slave read");
  416. size_rd = i2c_slave_read_buffer( I2C_SLAVE_NUM, data_rd, RW_TEST_LENGTH, 1000 / portTICK_PERIOD_MS);
  417. printf("slave read data is:\n");
  418. disp_buf(data_rd, size_rd);
  419. for (int i = 0; i < RW_TEST_LENGTH; i++) {
  420. TEST_ASSERT(data_rd[i] == i % 3);
  421. }
  422. free(data_wr);
  423. free(data_rd);
  424. unity_send_signal("ready to delete");
  425. i2c_driver_delete(I2C_SLAVE_NUM);
  426. }
  427. TEST_CASE_MULTIPLE_DEVICES("I2C read and write test", "[i2c][test_env=UT_T2_I2C][timeout=150]", i2c_master_write_read_test, i2c_slave_read_write_test);
  428. static void i2c_master_repeat_write(void)
  429. {
  430. uint8_t *data_wr = (uint8_t *) malloc(DATA_LENGTH);
  431. int times = 3;
  432. i2c_config_t conf_master = i2c_master_init();
  433. TEST_ESP_OK(i2c_param_config(I2C_MASTER_NUM, &conf_master));
  434. TEST_ESP_OK(i2c_driver_install(I2C_MASTER_NUM, I2C_MODE_MASTER,
  435. I2C_MASTER_RX_BUF_DISABLE,
  436. I2C_MASTER_TX_BUF_DISABLE, 0));
  437. unity_wait_for_signal("i2c slave init finish");
  438. for (int j = 0; j < times; j++) {
  439. for (int i = 0; i < DATA_LENGTH; i++) {
  440. data_wr[i] = j + i;
  441. }
  442. i2c_master_write_slave(I2C_MASTER_NUM, data_wr, RW_TEST_LENGTH);
  443. disp_buf(data_wr, RW_TEST_LENGTH);
  444. }
  445. free(data_wr);
  446. unity_send_signal("master write");
  447. unity_wait_for_signal("ready to delete");
  448. i2c_driver_delete(I2C_MASTER_NUM);
  449. }
  450. static void i2c_slave_repeat_read(void)
  451. {
  452. int size_rd = 0;
  453. int times = 3;
  454. uint8_t *data_rd = (uint8_t *) malloc(DATA_LENGTH * 3);
  455. i2c_config_t conf_slave = i2c_slave_init();
  456. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  457. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  458. I2C_SLAVE_RX_BUF_LEN,
  459. I2C_SLAVE_TX_BUF_LEN, 0));
  460. unity_send_signal("i2c slave init finish");
  461. unity_wait_for_signal("master write");
  462. while (1) {
  463. int len = i2c_slave_read_buffer( I2C_SLAVE_NUM, data_rd + size_rd, RW_TEST_LENGTH * 3, 10000 / portTICK_PERIOD_MS);
  464. if (len == 0) {
  465. break;
  466. }
  467. size_rd += len;
  468. }
  469. disp_buf(data_rd, size_rd);
  470. for (int j = 0; j < times; j++) {
  471. for (int i = 0; i < RW_TEST_LENGTH; i++) {
  472. printf("data: %d, %d\n", data_rd[j * RW_TEST_LENGTH + i], (i % 129 + j));
  473. TEST_ASSERT(data_rd[j * RW_TEST_LENGTH + i] == (i % 129 + j));
  474. }
  475. }
  476. free(data_rd);
  477. unity_send_signal("ready to delete");
  478. i2c_driver_delete(I2C_SLAVE_NUM);
  479. }
  480. TEST_CASE_MULTIPLE_DEVICES("I2C repeat write test", "[i2c][test_env=UT_T2_I2C][timeout=150]", i2c_master_repeat_write, i2c_slave_repeat_read);
  481. #endif //!TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2, ESP32S3)
  482. #endif //!TEMPORARY_DISABLED_FOR_TARGETS(ESP32S2, ESP32S3)
  483. static volatile bool exit_flag;
  484. static bool test_read_func;
  485. static void test_task(void *pvParameters)
  486. {
  487. SemaphoreHandle_t *sema = (SemaphoreHandle_t *) pvParameters;
  488. uint8_t *data = (uint8_t *) malloc(DATA_LENGTH);
  489. i2c_config_t conf_slave = i2c_slave_init();
  490. TEST_ESP_OK(i2c_driver_install(I2C_SLAVE_NUM, I2C_MODE_SLAVE,
  491. I2C_SLAVE_RX_BUF_LEN,
  492. I2C_SLAVE_TX_BUF_LEN, 0));
  493. TEST_ESP_OK(i2c_param_config( I2C_SLAVE_NUM, &conf_slave));
  494. while (exit_flag == false) {
  495. if (test_read_func) {
  496. i2c_slave_read_buffer(I2C_SLAVE_NUM, data, DATA_LENGTH, 0);
  497. } else {
  498. i2c_slave_write_buffer(I2C_SLAVE_NUM, data, DATA_LENGTH, 0);
  499. }
  500. vTaskDelay(10/portTICK_PERIOD_MS);
  501. }
  502. free(data);
  503. xSemaphoreGive(*sema);
  504. vTaskDelete(NULL);
  505. }
  506. TEST_CASE("test i2c_slave_read_buffer is not blocked when ticks_to_wait=0", "[i2c]")
  507. {
  508. SemaphoreHandle_t exit_sema = xSemaphoreCreateBinary();
  509. exit_flag = false;
  510. test_read_func = true;
  511. xTaskCreate(test_task, "tsk1", 2048, &exit_sema, 5, NULL);
  512. printf("Waiting for 5 sec\n");
  513. vTaskDelay(5000 / portTICK_PERIOD_MS);
  514. exit_flag = true;
  515. if (xSemaphoreTake(exit_sema, 1000 / portTICK_PERIOD_MS) == pdTRUE) {
  516. vSemaphoreDelete(exit_sema);
  517. } else {
  518. TEST_FAIL_MESSAGE("i2c_slave_read_buffer is blocked");
  519. }
  520. TEST_ESP_OK(i2c_driver_delete(I2C_SLAVE_NUM));
  521. }
  522. TEST_CASE("test i2c_slave_write_buffer is not blocked when ticks_to_wait=0", "[i2c]")
  523. {
  524. SemaphoreHandle_t exit_sema = xSemaphoreCreateBinary();
  525. exit_flag = false;
  526. test_read_func = false;
  527. xTaskCreate(test_task, "tsk1", 2048, &exit_sema, 5, NULL);
  528. printf("Waiting for 5 sec\n");
  529. vTaskDelay(5000 / portTICK_PERIOD_MS);
  530. exit_flag = true;
  531. if (xSemaphoreTake(exit_sema, 1000 / portTICK_PERIOD_MS) == pdTRUE) {
  532. vSemaphoreDelete(exit_sema);
  533. } else {
  534. TEST_FAIL_MESSAGE("i2c_slave_write_buffer is blocked");
  535. }
  536. TEST_ESP_OK(i2c_driver_delete(I2C_SLAVE_NUM));
  537. }
  538. TEST_CASE("I2C general API test", "[i2c]")
  539. {
  540. #if CONFIG_IDF_TARGET_ESP32 || CONFIG_IDF_TARGET_ESP32S2
  541. #define I2C_TEST_TIME 0x3ff
  542. #else
  543. #define I2C_TEST_TIME 0x1f
  544. #endif
  545. const int i2c_num = 0;
  546. i2c_config_t conf_master = {
  547. .mode = I2C_MODE_MASTER,
  548. .sda_pullup_en = GPIO_PULLUP_ENABLE,
  549. .scl_pullup_en = GPIO_PULLUP_ENABLE,
  550. .master.clk_speed = I2C_MASTER_FREQ_HZ,
  551. .sda_io_num = I2C_MASTER_SDA_IO,
  552. .scl_io_num = I2C_MASTER_SCL_IO,
  553. };
  554. TEST_ESP_OK(i2c_param_config( i2c_num, &conf_master));
  555. int time_get0, time_get1;
  556. for(int i = 10; i < I2C_TEST_TIME; i++) {
  557. //set period test
  558. TEST_ESP_OK(i2c_set_period(i2c_num, i, i));
  559. TEST_ESP_OK(i2c_get_period(i2c_num, &time_get0, &time_get1));
  560. TEST_ASSERT((time_get0 == i) && (time_get1 == i));
  561. //set start timing test
  562. TEST_ESP_OK(i2c_set_start_timing(i2c_num, i, i));
  563. TEST_ESP_OK(i2c_get_start_timing(i2c_num, &time_get0, &time_get1));
  564. TEST_ASSERT((time_get0 == i) && (time_get1 == i));
  565. //set stop timing test
  566. TEST_ESP_OK(i2c_set_stop_timing(i2c_num, i, i));
  567. TEST_ESP_OK(i2c_get_stop_timing(i2c_num, &time_get0, &time_get1));
  568. TEST_ASSERT((time_get0 == i) && (time_get1 == i));
  569. //set data timing test
  570. TEST_ESP_OK(i2c_set_data_timing(i2c_num, i, i));
  571. TEST_ESP_OK(i2c_get_data_timing(i2c_num, &time_get0, &time_get1));
  572. TEST_ASSERT((time_get0 == i) && (time_get1 == i));
  573. //set time out test
  574. TEST_ESP_OK(i2c_set_timeout(i2c_num, i));
  575. TEST_ESP_OK(i2c_get_timeout(i2c_num, &time_get0));
  576. TEST_ASSERT(time_get0 == i);
  577. }
  578. }
  579. //Init uart baud rate detection
  580. static void uart_aut_baud_det_init(int rxd_io_num)
  581. {
  582. gpio_hal_iomux_func_sel(GPIO_PIN_MUX_REG[rxd_io_num], PIN_FUNC_GPIO);
  583. gpio_set_direction(rxd_io_num, GPIO_MODE_INPUT_OUTPUT);
  584. esp_rom_gpio_connect_out_signal(rxd_io_num, I2CEXT0_SCL_OUT_IDX, 0, 0);
  585. esp_rom_gpio_connect_in_signal(rxd_io_num, U1RXD_IN_IDX, 0);
  586. periph_module_enable(PERIPH_UART1_MODULE);
  587. /* Reset all the bits */
  588. uart_ll_disable_intr_mask(&UART1, ~0);
  589. uart_ll_clr_intsts_mask(&UART1, ~0);
  590. uart_ll_set_autobaud_en(&UART1, true);
  591. }
  592. //Calculate I2C scl freq
  593. static void i2c_scl_freq_cal(void)
  594. {
  595. #if CONFIG_IDF_TARGET_ESP32 || CONFIG_IDF_TARGET_ESP32S2
  596. const int i2c_source_clk_freq = 80000000;
  597. const float i2c_cource_clk_period = 0.0125;
  598. int expt_cnt = 542;
  599. #else
  600. const int i2c_source_clk_freq = 18000000; // Clock sorce: RTC
  601. const float i2c_cource_clk_period = 0.056;
  602. int expt_cnt = 540;
  603. #endif
  604. int edg_cnt = uart_ll_get_rxd_edge_cnt(&UART1);
  605. int pospulse_cnt = uart_ll_get_pos_pulse_cnt(&UART1);
  606. int negpulse_cnt = uart_ll_get_neg_pulse_cnt(&UART1);
  607. int high_period_cnt = uart_ll_get_high_pulse_cnt(&UART1);
  608. int low_period_cnt = uart_ll_get_low_pulse_cnt(&UART1);
  609. if(edg_cnt != expt_cnt) {
  610. printf("\nedg_cnt != %d, test fail\n", expt_cnt);
  611. return;
  612. }
  613. printf("\nDetected SCL frequency: %d Hz\n", i2c_source_clk_freq / ((pospulse_cnt + negpulse_cnt) / 2) );
  614. printf("\nSCL high period %.3f (us), SCL low_period %.3f (us)\n\n", (float)(i2c_cource_clk_period * high_period_cnt), (float)(i2c_cource_clk_period * low_period_cnt));
  615. uart_ll_set_autobaud_en(&UART1, false);
  616. periph_module_disable(PERIPH_UART1_MODULE);
  617. }
  618. TEST_CASE("I2C SCL freq test (local test)", "[i2c][ignore]")
  619. {
  620. //Use the UART baud rate detection function to detect the I2C SCL frequency.
  621. const int i2c_num = 0;
  622. const int uart1_rxd_io = 5;
  623. i2c_config_t conf_master = {
  624. .mode = I2C_MODE_MASTER,
  625. .sda_pullup_en = GPIO_PULLUP_ENABLE,
  626. .scl_pullup_en = GPIO_PULLUP_ENABLE,
  627. .master.clk_speed = 400000,
  628. .sda_io_num = I2C_MASTER_SDA_IO,
  629. .scl_io_num = I2C_MASTER_SCL_IO,
  630. };
  631. uint8_t *data = (uint8_t *)malloc(30);
  632. TEST_ESP_OK(i2c_param_config( i2c_num, &conf_master));
  633. TEST_ESP_OK(i2c_driver_install(i2c_num, I2C_MODE_MASTER, 0, 0, 0));
  634. memset(data, 0, 0);
  635. uart_aut_baud_det_init(uart1_rxd_io);
  636. i2c_cmd_handle_t cmd = i2c_cmd_link_create();
  637. i2c_master_start(cmd);
  638. i2c_master_write(cmd, data, 30, ACK_CHECK_DIS);
  639. i2c_master_stop(cmd);
  640. i2c_master_cmd_begin(i2c_num, cmd, 5000 / portTICK_PERIOD_MS);
  641. i2c_cmd_link_delete(cmd);
  642. i2c_scl_freq_cal();
  643. free(data);
  644. TEST_ESP_OK(i2c_driver_delete(i2c_num));
  645. }
  646. #endif // SOC_I2C_SUPPORT_SLAVE
  647. #endif //!TEMPORARY_DISABLED_FOR_TARGETS(ESP32C6)