test_sdio.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815
  1. /*
  2. * SPDX-FileCopyrightText: 2019-2022 Espressif Systems (Shanghai) CO LTD
  3. *
  4. * SPDX-License-Identifier: Apache-2.0
  5. */
  6. #include "unity.h"
  7. #include "esp_serial_slave_link/essl_sdio.h"
  8. #include "driver/sdspi_host.h"
  9. #include "test_utils.h"
  10. #include "param_test.h"
  11. #include "esp_log.h"
  12. #include "esp_timer.h"
  13. #include "driver/spi_common.h"
  14. #include "soc/soc_caps.h"
  15. #include "ccomp_timer.h"
  16. #if !TEMPORARY_DISABLED_FOR_TARGETS(ESP32S3)
  17. #if SOC_SDMMC_HOST_SUPPORTED && SOC_SDIO_SLAVE_SUPPORTED
  18. #include "soc/sdio_slave_pins.h"
  19. #include "driver/sdio_slave.h"
  20. #include "driver/sdmmc_host.h"
  21. #define TIMEOUT_MAX UINT32_MAX
  22. #define INT_MASK_ALL 0xff
  23. #define SDIO_SLAVE_QUEUE_SIZE 20
  24. #define RX_BUFFER_SIZE 2048
  25. #define RX_BUFFER_NUM 10
  26. #define TX_BUFFER_SIZE 2048
  27. #define REG_ADDR_MAX 60
  28. //the test should run accross the boundary, i.e. over 0x100000 bytes.
  29. //TEST_CNT > 512
  30. #define TEST_CNT 10000
  31. #define TEST_SDSPI_HOST SPI2_HOST
  32. #define TEST_SDSPI_DMACHAN 1
  33. #define TEST_RESET_DATA_LEN 10
  34. #ifndef MIN
  35. #define MIN(a, b) ((a)<(b)? (a): (b))
  36. #endif
  37. typedef enum {
  38. SDIO_1BIT = 0,
  39. SDIO_4BIT = 1,
  40. SDIO_SPI = 2,
  41. } sdio_mode_t;
  42. typedef void (*sdio_test_func)(essl_handle_t handle);
  43. typedef struct {
  44. const char test_name[16];
  45. sdio_mode_t sdio_mode;
  46. uint32_t freq;
  47. bool check_data;
  48. bool packet_mode;
  49. } sdio_test_config_t;
  50. sdio_test_config_t test_cfg_array[] = {
  51. //the first item will be the default config used by all tests
  52. {
  53. .test_name = "HS4B",
  54. .sdio_mode = SDIO_4BIT,
  55. .freq = SDMMC_FREQ_HIGHSPEED,
  56. .check_data = true,
  57. },
  58. {
  59. .test_name = "HS1B",
  60. .sdio_mode = SDIO_1BIT,
  61. .freq = SDMMC_FREQ_HIGHSPEED,
  62. .check_data = true,
  63. },
  64. {
  65. .test_name = "SPI",
  66. .sdio_mode = SDIO_SPI,
  67. .freq = SDMMC_FREQ_HIGHSPEED,
  68. .check_data = true,
  69. },
  70. //the performance test is only done when psram is not enabled
  71. #if !CONFIG_SPIRAM && !CONFIG_FREERTOS_CHECK_PORT_CRITICAL_COMPLIANCE
  72. {
  73. .test_name = "HS4B (perf)",
  74. .sdio_mode = SDIO_4BIT,
  75. .freq = SDMMC_FREQ_HIGHSPEED,
  76. },
  77. {
  78. .test_name = "HS1B (perf)",
  79. .sdio_mode = SDIO_1BIT,
  80. .freq = SDMMC_FREQ_HIGHSPEED,
  81. },
  82. {
  83. .test_name = "SPI (perf)",
  84. .sdio_mode = SDIO_SPI,
  85. .freq = SDMMC_FREQ_HIGHSPEED,
  86. },
  87. #endif
  88. };
  89. sdio_test_config_t packet_config = {
  90. .test_name = "HS4B packet",
  91. .sdio_mode = SDIO_4BIT,
  92. .freq = SDMMC_FREQ_HIGHSPEED,
  93. .check_data = true,
  94. .packet_mode = true,
  95. };
  96. const sdio_test_config_t* default_config = &test_cfg_array[0];
  97. #define TEST_SIZE (sizeof(test_cfg_array)/sizeof(sdio_test_config_t))
  98. static const char MASTER_TAG[] = "master";
  99. static const char SLAVE_TAG[] = "slave";
  100. /*******************************************************************************
  101. * Master
  102. ******************************************************************************/
  103. static sdmmc_card_t s_card;
  104. typedef void (*test_func_t)(essl_handle_t handle, const sdio_test_config_t* config);
  105. static void init_sdmmc_host(void);
  106. static void init_essl(essl_handle_t *out_handle, const sdio_test_config_t *conf);
  107. static void deinit_essl(essl_handle_t handle, const sdio_test_config_t *conf);
  108. static void test_framework_master(test_func_t test_func, const sdio_test_config_t* config)
  109. {
  110. ESP_LOGI(MASTER_TAG, "### Testing %s... ####", config->test_name);
  111. essl_handle_t handle;
  112. esp_err_t err;
  113. init_essl(&handle, config);
  114. err = essl_init(handle, TIMEOUT_MAX);
  115. TEST_ESP_OK(err);
  116. (*test_func)(handle, config);
  117. deinit_essl(handle, config);
  118. }
  119. static void init_sdmmc_host(void)
  120. {
  121. esp_err_t err;
  122. sdmmc_slot_config_t slot_config = SDMMC_SLOT_CONFIG_DEFAULT();
  123. err = sdmmc_host_init();
  124. TEST_ESP_OK(err);
  125. err = sdmmc_host_init_slot(SDMMC_HOST_SLOT_1, &slot_config);
  126. TEST_ESP_OK(err);
  127. }
  128. static void init_essl(essl_handle_t *out_handle, const sdio_test_config_t *conf)
  129. {
  130. sdmmc_host_t config;
  131. esp_err_t err;
  132. spi_bus_config_t bus_config;
  133. /* Probe */
  134. switch (conf->sdio_mode) {
  135. case SDIO_4BIT:
  136. ESP_LOGI(MASTER_TAG, "Probe using SD 4-bit...\n");
  137. config = (sdmmc_host_t)SDMMC_HOST_DEFAULT();
  138. config.flags = SDMMC_HOST_FLAG_4BIT;
  139. config.max_freq_khz = conf->freq;
  140. init_sdmmc_host();
  141. break;
  142. case SDIO_1BIT:
  143. ESP_LOGI(MASTER_TAG, "Probe using SD 1-bit...\n");
  144. config = (sdmmc_host_t)SDMMC_HOST_DEFAULT();
  145. config.flags = SDMMC_HOST_FLAG_1BIT;
  146. config.max_freq_khz = conf->freq;
  147. init_sdmmc_host();
  148. break;
  149. case SDIO_SPI:
  150. bus_config = (spi_bus_config_t) {
  151. .mosi_io_num = SDIO_SLAVE_SLOT1_IOMUX_PIN_NUM_CMD,
  152. .miso_io_num = SDIO_SLAVE_SLOT1_IOMUX_PIN_NUM_D0,
  153. .sclk_io_num = SDIO_SLAVE_SLOT1_IOMUX_PIN_NUM_CLK,
  154. .quadwp_io_num = -1,
  155. .quadhd_io_num = -1,
  156. };
  157. err = spi_bus_initialize(TEST_SDSPI_HOST, &bus_config, TEST_SDSPI_DMACHAN);
  158. TEST_ESP_OK(err);
  159. sdspi_device_config_t device_config = SDSPI_DEVICE_CONFIG_DEFAULT();
  160. device_config.host_id = TEST_SDSPI_HOST;
  161. device_config.gpio_cs = SDIO_SLAVE_SLOT1_IOMUX_PIN_NUM_D3;
  162. device_config.gpio_int= SDIO_SLAVE_SLOT1_IOMUX_PIN_NUM_D1;
  163. err = gpio_install_isr_service(0);
  164. TEST_ASSERT(err == ESP_OK || err == ESP_ERR_INVALID_STATE);
  165. sdspi_dev_handle_t sdspi_handle;
  166. err = sdspi_host_init();
  167. TEST_ESP_OK(err);
  168. err = sdspi_host_init_device(&device_config, &sdspi_handle);
  169. TEST_ESP_OK(err);
  170. ESP_LOGI(MASTER_TAG, "Probe using SPI...\n");
  171. config = (sdmmc_host_t)SDSPI_HOST_DEFAULT();
  172. config.slot = sdspi_handle;
  173. break;
  174. }
  175. sdmmc_card_t *card = &s_card;
  176. //wait for at least 5 seconds
  177. int retry_times = 5;
  178. do {
  179. if (sdmmc_card_init(&config, card) == ESP_OK) {
  180. break;
  181. }
  182. ESP_LOGW(MASTER_TAG, "slave init failed, retry...");
  183. vTaskDelay(1000 / portTICK_PERIOD_MS);
  184. } while (--retry_times);
  185. TEST_ASSERT_MESSAGE(retry_times != 0, "Initializing slave failed.");
  186. essl_sdio_config_t ser_config = {
  187. .card = card,
  188. .recv_buffer_size = RX_BUFFER_SIZE,
  189. };
  190. err = essl_sdio_init_dev(out_handle, &ser_config);
  191. TEST_ESP_OK(err);
  192. err = essl_init(*out_handle, TIMEOUT_MAX);
  193. TEST_ESP_OK(err);
  194. }
  195. static void deinit_essl(essl_handle_t handle, const sdio_test_config_t *conf)
  196. {
  197. esp_err_t err;
  198. essl_sdio_deinit_dev(handle);
  199. if (conf->sdio_mode == SDIO_SPI) {
  200. gpio_uninstall_isr_service();
  201. err = sdspi_host_deinit();
  202. TEST_ESP_OK(err);
  203. err = spi_bus_free(TEST_SDSPI_HOST);
  204. TEST_ESP_OK(err);
  205. } else {
  206. err = sdmmc_host_deinit();
  207. TEST_ESP_OK(err);
  208. }
  209. }
  210. static void send_finish_test(essl_handle_t handle)
  211. {
  212. //the slave needs a signal to quite the test
  213. essl_send_slave_intr(handle, BIT(7), TIMEOUT_MAX);
  214. }
  215. static void test_int(essl_handle_t handle, const sdio_test_config_t* config)
  216. {
  217. esp_err_t err;
  218. err = essl_set_intr_ena(handle, INT_MASK_ALL, TIMEOUT_MAX);
  219. TEST_ESP_OK(err);
  220. err = essl_wait_int(handle, 0);
  221. TEST_ASSERT_EQUAL_HEX(ESP_ERR_TIMEOUT, err);
  222. //tests all 8 interrupts of the slave, in which int 7 is used to terminate the test on the slave.
  223. for (int i = 0; i < 8; i ++) {
  224. uint32_t int_st;
  225. err = essl_send_slave_intr(handle, BIT(i), TIMEOUT_MAX);
  226. TEST_ESP_OK(err);
  227. //the slave should return interrupt with the same bit in 10 ms
  228. err = essl_wait_int(handle, 10);
  229. TEST_ESP_OK(err);
  230. err = essl_get_intr(handle, NULL, &int_st, TIMEOUT_MAX);
  231. TEST_ESP_OK(err);
  232. //check and clear the returned interrupt
  233. TEST_ASSERT_EQUAL_HEX(BIT(i), int_st);
  234. err = essl_clear_intr(handle, int_st, TIMEOUT_MAX);
  235. TEST_ESP_OK(err);
  236. }
  237. }
  238. static void test_sdio_interrupt_master(void)
  239. {
  240. test_framework_master(test_int, default_config);
  241. }
  242. static void test_reg(essl_handle_t handle, const sdio_test_config_t* config)
  243. {
  244. esp_err_t err;
  245. uint8_t data[REG_ADDR_MAX];
  246. srand(850);
  247. //initialize the buffer
  248. for (int i = 0; i < REG_ADDR_MAX; i++) {
  249. data[i] = rand();
  250. err = essl_write_reg(handle, i, data[i], NULL, 10);
  251. TEST_ESP_OK(err);
  252. }
  253. for (int i = 0; i < 512; i++) {
  254. //randomly write one
  255. int offset = rand() % REG_ADDR_MAX;
  256. uint8_t data_write = rand();
  257. data[offset] = data_write;
  258. err = essl_write_reg(handle, offset, data_write, NULL, 10);
  259. TEST_ESP_OK(err);
  260. //randomly read another one and compare
  261. offset = rand() % REG_ADDR_MAX;
  262. uint8_t data_read;
  263. err = essl_read_reg(handle, offset, &data_read, 10);
  264. TEST_ESP_OK(err);
  265. TEST_ASSERT_EQUAL_HEX8(data[offset], data_read);
  266. }
  267. send_finish_test(handle);
  268. }
  269. static void test_sdio_reg_master(void)
  270. {
  271. test_framework_master(test_reg, default_config);
  272. }
  273. static uint8_t tx_buffer[TX_BUFFER_SIZE*2];
  274. static uint8_t rcv_buffer[RX_BUFFER_SIZE*RX_BUFFER_NUM];
  275. static void init_tx_buffer(void)
  276. {
  277. srand(776);
  278. for (int i = 0; i < sizeof(tx_buffer); i++) {
  279. tx_buffer[i] = rand();
  280. }
  281. }
  282. static void get_master_send_data(int offset, uint8_t** out_start, int* out_len)
  283. {
  284. int page_cnt = offset / TX_BUFFER_SIZE;
  285. int offset_in_page = offset % TX_BUFFER_SIZE;
  286. srand(page_cnt);
  287. int page_offset = (rand() % (sizeof(tx_buffer) - (TX_BUFFER_SIZE) + 1)) & (~3);
  288. *out_start = &tx_buffer[page_offset + offset_in_page];
  289. *out_len = TX_BUFFER_SIZE - offset_in_page;
  290. }
  291. static void log_performance_tohost(uint32_t speed, const sdio_test_config_t* config)
  292. {
  293. if (!config->check_data) {
  294. switch (config->sdio_mode) {
  295. case SDIO_4BIT:
  296. TEST_PERFORMANCE_CCOMP_GREATER_THAN(SDIO_THROUGHPUT_KBSEC_TOHOST_4BIT, "%d", speed);
  297. break;
  298. case SDIO_1BIT:
  299. TEST_PERFORMANCE_CCOMP_GREATER_THAN(SDIO_THROUGHPUT_KBSEC_TOHOST_1BIT, "%d", speed);
  300. break;
  301. case SDIO_SPI:
  302. TEST_PERFORMANCE_CCOMP_GREATER_THAN(SDIO_THROUGHPUT_KBSEC_TOHOST_SPI, "%d", speed);
  303. break;
  304. }
  305. }
  306. }
  307. static void test_tp_tohost_master(essl_handle_t handle, const sdio_test_config_t* config)
  308. {
  309. esp_err_t err;
  310. int expected_length = TEST_CNT * TX_BUFFER_SIZE;
  311. int recv_size = 4096;
  312. init_tx_buffer();
  313. //wait for the slave to get ready
  314. vTaskDelay(20);
  315. int remain_length = expected_length;
  316. int offset = 0;
  317. // Two counters are used. The `esp_timer_get_time()` is for the typical time, and the
  318. // `ccomp_timer` is for performance test to reduce influence caused by cache miss.
  319. int64_t pre_us = esp_timer_get_time();
  320. err = ccomp_timer_start();
  321. assert(err == ESP_OK);
  322. // though the flow is the same, the check of config->check_data influences the throughput much, put it outside
  323. if (config->check_data) {
  324. do {
  325. size_t rcv_len;
  326. err = essl_get_packet(handle, rcv_buffer, recv_size, &rcv_len, TIMEOUT_MAX);
  327. TEST_ASSERT(err == ESP_OK || err == ESP_ERR_NOT_FINISHED);
  328. TEST_ASSERT_LESS_OR_EQUAL(remain_length, rcv_len);
  329. //compare until all received data are used
  330. int compared_len = 0;
  331. do {
  332. //get the expected master sent data, there may be several segments, so get and compare
  333. //several times
  334. uint8_t* cmp_start;
  335. int seg_len;
  336. get_master_send_data(offset, &cmp_start, &seg_len);
  337. int cmp_len = MIN(rcv_len-compared_len, seg_len);
  338. TEST_ASSERT_EQUAL_HEX8_ARRAY(cmp_start, &rcv_buffer[compared_len], cmp_len);
  339. compared_len += cmp_len;
  340. offset += cmp_len;
  341. } while (compared_len < rcv_len);
  342. remain_length -= rcv_len;
  343. } while (remain_length > 0);
  344. } else {
  345. do {
  346. size_t rcv_len;
  347. err = essl_get_packet(handle, rcv_buffer, recv_size, &rcv_len, TIMEOUT_MAX);
  348. TEST_ASSERT(err == ESP_OK || err == ESP_ERR_NOT_FINISHED);
  349. TEST_ASSERT_LESS_OR_EQUAL(remain_length, rcv_len);
  350. offset += rcv_len;
  351. remain_length -= rcv_len;
  352. } while (remain_length > 0);
  353. }
  354. int64_t c_time_ms = ccomp_timer_stop()/1000;
  355. int64_t end_us = esp_timer_get_time();
  356. uint32_t total_time_ms = (end_us - pre_us)/1000;
  357. ESP_LOGI(MASTER_TAG, "test done, total time: %d ms (%d ms compensated), bytes transferred: %d", total_time_ms, (int)c_time_ms, expected_length);
  358. uint32_t throughput_byte_per_ms = expected_length / c_time_ms;
  359. ESP_LOGI(MASTER_TAG, "Throughput: compensated %.2lf MB/s, typical %.2lf MB/s",
  360. throughput_byte_per_ms/1000., expected_length/(total_time_ms*1000.));
  361. log_performance_tohost(throughput_byte_per_ms, config);
  362. send_finish_test(handle);
  363. }
  364. static void log_performance_frhost(uint32_t speed, const sdio_test_config_t* config)
  365. {
  366. if (!config->check_data) {
  367. switch (config->sdio_mode) {
  368. case SDIO_4BIT:
  369. TEST_PERFORMANCE_CCOMP_GREATER_THAN(SDIO_THROUGHPUT_KBSEC_FRHOST_4BIT, "%d", speed);
  370. break;
  371. case SDIO_1BIT:
  372. TEST_PERFORMANCE_CCOMP_GREATER_THAN(SDIO_THROUGHPUT_KBSEC_FRHOST_1BIT, "%d", speed);
  373. break;
  374. case SDIO_SPI:
  375. TEST_PERFORMANCE_CCOMP_GREATER_THAN(SDIO_THROUGHPUT_KBSEC_FRHOST_SPI, "%d", speed);
  376. break;
  377. }
  378. }
  379. }
  380. static void test_tp_frhost_master(essl_handle_t handle, const sdio_test_config_t* config)
  381. {
  382. esp_err_t err;
  383. int expected_length = TEST_CNT * TX_BUFFER_SIZE;
  384. init_tx_buffer();
  385. //wait for the slave to get ready
  386. vTaskDelay(20);
  387. int remain_length = expected_length;
  388. int offset = 0;
  389. // Two counters are used. The `esp_timer_get_time()` is for the typical time, and the
  390. // `ccomp_timer` is for performance test to reduce influence caused by cache miss.
  391. int64_t pre_us = esp_timer_get_time();
  392. err = ccomp_timer_start();
  393. assert(err == ESP_OK);
  394. do {
  395. int send_len;
  396. uint8_t* send_start;
  397. get_master_send_data(offset, &send_start, &send_len);
  398. TEST_ASSERT_EQUAL(TX_BUFFER_SIZE, send_len);
  399. err = essl_send_packet(handle, send_start, send_len, TIMEOUT_MAX);
  400. TEST_ASSERT(err == ESP_OK);
  401. remain_length -= send_len;
  402. offset += send_len;
  403. } while (remain_length > 0);
  404. int64_t c_time_ms = ccomp_timer_stop()/1000;
  405. int64_t end_us = esp_timer_get_time();
  406. uint32_t total_time_ms = (end_us - pre_us)/1000;
  407. ESP_LOGI(MASTER_TAG, "test done, total time: %d ms (%d ms compensated), bytes transferred: %d", total_time_ms, (int)c_time_ms, expected_length);
  408. uint32_t throughput_byte_per_ms = expected_length / c_time_ms;
  409. ESP_LOGI(MASTER_TAG, "Throughput: compensated %.2lf MB/s, typical %.2lf MB/s",
  410. throughput_byte_per_ms/1000., expected_length/(total_time_ms*1000.));
  411. log_performance_frhost(throughput_byte_per_ms, config);
  412. send_finish_test(handle);
  413. }
  414. void test_reset_master(essl_handle_t handle, const sdio_test_config_t* config)
  415. {
  416. init_tx_buffer();
  417. //wait for the slave to stop, reset and start again
  418. vTaskDelay(10);
  419. for (int i = 0; i < 10; i++) {
  420. WORD_ALIGNED_ATTR uint8_t buffer[TEST_RESET_DATA_LEN];
  421. size_t read_len;
  422. esp_err_t err = essl_get_packet(handle, buffer, TEST_RESET_DATA_LEN, &read_len, portMAX_DELAY);
  423. if (err == ESP_ERR_NOT_FINISHED) {
  424. TEST_ASSERT_LESS_THAN(10, i);
  425. err = ESP_OK;
  426. }
  427. TEST_ESP_OK(err);
  428. TEST_ASSERT_EQUAL(TEST_RESET_DATA_LEN, read_len);
  429. TEST_ASSERT_EQUAL_HEX8_ARRAY(tx_buffer + 4*i, buffer, read_len);
  430. }
  431. for (int i = 0; i < 10; i++) {
  432. esp_err_t err = essl_send_packet(handle, tx_buffer + i * 8, TEST_RESET_DATA_LEN, portMAX_DELAY);
  433. TEST_ESP_OK(err);
  434. }
  435. send_finish_test(handle);
  436. }
  437. void test_sdio_reset_master(void)
  438. {
  439. test_framework_master(test_reset_master, &packet_config);
  440. }
  441. /*******************************************************************************
  442. * Slave
  443. ******************************************************************************/
  444. typedef struct {
  445. int queued_cnt;
  446. bool s_finished;
  447. } slave_context_t;
  448. typedef void (*test_func_slave_t)(slave_context_t *context, const sdio_test_config_t* config);
  449. static slave_context_t slave_context;
  450. static void event_cb(uint8_t event)
  451. {
  452. ESP_EARLY_LOGI(SLAVE_TAG, "event: %d", event);
  453. sdio_slave_send_host_int(event);
  454. if (event == 7) slave_context.s_finished = true;
  455. }
  456. static void wait_for_finish(slave_context_t *ctx)
  457. {
  458. while (!ctx->s_finished) {
  459. vTaskDelay(10);
  460. }
  461. //wait for host to read the respond from slave
  462. vTaskDelay(10);
  463. }
  464. static void test_framework_slave(test_func_slave_t test_func, const sdio_test_config_t* config)
  465. {
  466. slave_context.s_finished = false;
  467. esp_err_t err;
  468. sdio_slave_config_t slave_config = {
  469. .sending_mode = (config->packet_mode? SDIO_SLAVE_SEND_PACKET: SDIO_SLAVE_SEND_STREAM),
  470. .send_queue_size = SDIO_SLAVE_QUEUE_SIZE,
  471. .recv_buffer_size = RX_BUFFER_SIZE,
  472. .event_cb = event_cb,
  473. };
  474. err = sdio_slave_initialize(&slave_config);
  475. TEST_ESP_OK(err);
  476. err = sdio_slave_start();
  477. TEST_ESP_OK(err);
  478. ESP_LOGI(SLAVE_TAG, "slave ready");
  479. test_func(&slave_context, config);
  480. sdio_slave_stop();
  481. sdio_slave_deinit();
  482. }
  483. static void test_int_slave(slave_context_t* ctx, const sdio_test_config_t* config)
  484. {
  485. wait_for_finish(ctx);
  486. }
  487. static void test_sdio_interrupt_slave(void)
  488. {
  489. test_framework_slave(test_int_slave, default_config);
  490. }
  491. static void test_tp_tohost_slave(slave_context_t* ctx, const sdio_test_config_t* config)
  492. {
  493. #define QUEUE_FULL() (ctx->queued_cnt == SDIO_SLAVE_QUEUE_SIZE)
  494. #define QUEUE_EMPTY() (ctx->queued_cnt == 0)
  495. init_tx_buffer();
  496. esp_err_t err;
  497. int offset = 0;
  498. for (int i = 0; i < TEST_CNT; i++) {
  499. do {
  500. void* arg;
  501. //when the queue is full, do a blocking wait for 10ms, otherwise non-blocking
  502. err = sdio_slave_send_get_finished(&arg, QUEUE_FULL()? 1: 0);
  503. if (err == ESP_OK) {
  504. ctx->queued_cnt --;
  505. continue;
  506. }
  507. TEST_ASSERT_EQUAL(ESP_ERR_TIMEOUT, err);
  508. } while (QUEUE_FULL());
  509. uint8_t* start;
  510. int send_len;
  511. get_master_send_data(offset, &start, &send_len);
  512. TEST_ASSERT_EQUAL(TX_BUFFER_SIZE, send_len);
  513. err = sdio_slave_send_queue(start, send_len, NULL, portMAX_DELAY);
  514. TEST_ESP_OK(err);
  515. ctx->queued_cnt++;
  516. offset += TX_BUFFER_SIZE;
  517. }
  518. while (!QUEUE_EMPTY()) {
  519. void* arg;
  520. err = sdio_slave_send_get_finished(&arg, portMAX_DELAY);
  521. TEST_ESP_OK(err);
  522. ctx->queued_cnt--;
  523. }
  524. wait_for_finish(ctx);
  525. }
  526. static void slave_parepare_recv_buffer(void)
  527. {
  528. for (int i = 0; i < RX_BUFFER_NUM; i++) {
  529. sdio_slave_buf_handle_t buf_handle = sdio_slave_recv_register_buf(&rcv_buffer[i*RX_BUFFER_SIZE]);
  530. esp_err_t err = sdio_slave_recv_load_buf(buf_handle);
  531. TEST_ESP_OK(err);
  532. }
  533. }
  534. static void test_tp_frhost_slave(slave_context_t *ctx, const sdio_test_config_t* config)
  535. {
  536. esp_err_t err;
  537. init_tx_buffer();
  538. slave_parepare_recv_buffer();
  539. int offset = 0;
  540. for (int i = 0; i < TEST_CNT; i++) {
  541. sdio_slave_buf_handle_t buf_handle;
  542. uint8_t* buf;
  543. size_t rcv_len;
  544. err = sdio_slave_recv(&buf_handle, &buf, &rcv_len, portMAX_DELAY);
  545. TEST_ESP_OK(err);
  546. if (config->check_data) {
  547. //compare until all received data are used
  548. int compared_len = 0;
  549. do {
  550. //get the expected master sent data, there may be several segments, so get and compare
  551. //several times
  552. uint8_t* cmp_start;
  553. int seg_len;
  554. get_master_send_data(offset, &cmp_start, &seg_len);
  555. int cmp_len = MIN(rcv_len-compared_len, seg_len);
  556. TEST_ASSERT_EQUAL_HEX8_ARRAY(cmp_start, &buf[compared_len], cmp_len);
  557. compared_len += cmp_len;
  558. offset += cmp_len;
  559. } while (compared_len < rcv_len);
  560. } else {
  561. offset += rcv_len;
  562. }
  563. err = sdio_slave_recv_load_buf(buf_handle);
  564. TEST_ESP_OK(err);
  565. }
  566. wait_for_finish(ctx);
  567. }
  568. static void slave_tx_rx_short_data(void)
  569. {
  570. esp_err_t err;
  571. for (int i = 0; i < 10; i++) {
  572. err = sdio_slave_send_queue(tx_buffer + 4*i, TEST_RESET_DATA_LEN, (void*)i, portMAX_DELAY);
  573. TEST_ESP_OK(err);
  574. }
  575. for (int i = 0; i < 10; i++) {
  576. uint8_t* addr;
  577. size_t size;
  578. sdio_slave_buf_handle_t recv_handle;
  579. err = sdio_slave_recv(&recv_handle, &addr, &size, portMAX_DELAY);
  580. TEST_ESP_OK(err);
  581. TEST_ASSERT_EQUAL(TEST_RESET_DATA_LEN, size);
  582. TEST_ASSERT_EQUAL_HEX8_ARRAY(tx_buffer+i*8, addr, size);
  583. }
  584. for (int i = 0; i < 10; i++) {
  585. void* arg;
  586. err = sdio_slave_send_get_finished(&arg, portMAX_DELAY);
  587. TEST_ESP_OK(err);
  588. TEST_ASSERT_EQUAL(i, arg);
  589. }
  590. }
  591. void test_reset_slave(slave_context_t *context, const sdio_test_config_t* config)
  592. {
  593. sdio_slave_stop();
  594. esp_err_t err = sdio_slave_reset();
  595. TEST_ESP_OK(err);
  596. err = sdio_slave_start();
  597. TEST_ESP_OK(err);
  598. init_tx_buffer();
  599. slave_parepare_recv_buffer();
  600. slave_tx_rx_short_data();
  601. wait_for_finish(context);
  602. }
  603. void test_sdio_reset_slave(void)
  604. {
  605. test_framework_slave(test_reset_slave, &packet_config);
  606. }
  607. TEST_CASE_MULTIPLE_DEVICES("sdio interrupt", "[sdio][test_env=UT_SDIO]", test_sdio_interrupt_master, test_sdio_interrupt_slave);
  608. TEST_CASE_MULTIPLE_DEVICES("sdio register", "[sdio][test_env=UT_SDIO]", test_sdio_reg_master, test_sdio_interrupt_slave);
  609. #if !CONFIG_FREERTOS_UNICORE
  610. TEST_CASE_MULTIPLE_DEVICES("sdio reset", "[sdio][test_env=UT_SDIO]", test_sdio_reset_master, test_sdio_reset_slave);
  611. #else
  612. //Currently there is weird issue on the runner, when tested with single core config, seems to relate to receiving
  613. TEST_CASE_MULTIPLE_DEVICES("sdio reset", "[sdio][test_env=UT_SDIO][ignore]", test_sdio_reset_master, test_sdio_reset_slave);
  614. #endif
  615. static void test_sdio_frhost_master(const void* pset, void* context)
  616. {
  617. test_framework_master(test_tp_frhost_master, pset);
  618. }
  619. static void test_sdio_frhost_slave(const void* pset, void* context)
  620. {
  621. test_framework_slave(test_tp_frhost_slave, pset);
  622. }
  623. static void test_sdio_tohost_master(const void* pset, void* context)
  624. {
  625. test_framework_master(test_tp_tohost_master, pset);
  626. }
  627. static void test_sdio_tohost_slave(const void* pset, void* context)
  628. {
  629. test_framework_slave(test_tp_tohost_slave, pset);
  630. }
  631. static void null_pre(void** arg)
  632. {
  633. }
  634. static void null_post(void* arg)
  635. {
  636. }
  637. ptest_func_t frhost_master = {
  638. .pre_test = null_pre,
  639. .loop = test_sdio_frhost_master,
  640. .post_test = null_post,
  641. };
  642. ptest_func_t frhost_slave = {
  643. .pre_test = null_pre,
  644. .loop = test_sdio_frhost_slave,
  645. .post_test = null_post,
  646. };
  647. PARAM_GROUP_DECLARE_TYPE(IO_MODE, sdio_test_config_t, test_cfg_array);
  648. #if !CONFIG_FREERTOS_UNICORE
  649. TEST_MASTER_SLAVE(SDIO_FRHOST, test_cfg_array, "[sdio][timeout=180][test_env=UT_SDIO]", &frhost_master, &frhost_slave);
  650. #else
  651. //Currently there is weird issue on the runner, when tested with single core config, seems to relate to receiving
  652. TEST_MASTER_SLAVE(SDIO_FRHOST, test_cfg_array, "[sdio][timeout=180][test_env=UT_SDIO][ignore]", &frhost_master, &frhost_slave);
  653. #endif
  654. ptest_func_t tohost_master = {
  655. .pre_test = null_pre,
  656. .loop = test_sdio_tohost_master,
  657. .post_test = null_post,
  658. };
  659. ptest_func_t tohost_slave = {
  660. .pre_test = null_pre,
  661. .loop = test_sdio_tohost_slave,
  662. .post_test = null_post,
  663. };
  664. TEST_MASTER_SLAVE(SDIO_TOHOST, test_cfg_array, "[sdio][timeout=180][test_env=UT_SDIO]", &tohost_master, &tohost_slave);
  665. #endif //SOC_SDMMC_HOST_SUPPORTED && SOC_SDIO_SLAVE_SUPPORTED
  666. #endif