esp_websocket_client.c 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715
  1. // Copyright 2015-2018 Espressif Systems (Shanghai) PTE LTD
  2. //
  3. // Licensed under the Apache License, Version 2.0 (the "License");
  4. // you may not use this file except in compliance with the License.
  5. // You may obtain a copy of the License at
  6. // http://www.apache.org/licenses/LICENSE-2.0
  7. //
  8. // Unless required by applicable law or agreed to in writing, software
  9. // distributed under the License is distributed on an "AS IS" BASIS,
  10. // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  11. // See the License for the specific language governing permissions and
  12. // limitations under the License.
  13. #include <stdio.h>
  14. #include "esp_websocket_client.h"
  15. #include "esp_transport.h"
  16. #include "esp_transport_tcp.h"
  17. #include "esp_transport_ssl.h"
  18. #include "esp_transport_ws.h"
  19. /* using uri parser */
  20. #include "http_parser.h"
  21. #include "freertos/task.h"
  22. #include "freertos/semphr.h"
  23. #include "freertos/queue.h"
  24. #include "freertos/event_groups.h"
  25. #include "esp_log.h"
  26. #include "esp_timer.h"
  27. static const char *TAG = "WEBSOCKET_CLIENT";
  28. #define WEBSOCKET_TCP_DEFAULT_PORT (80)
  29. #define WEBSOCKET_SSL_DEFAULT_PORT (443)
  30. #define WEBSOCKET_BUFFER_SIZE_BYTE (1024)
  31. #define WEBSOCKET_RECONNECT_TIMEOUT_MS (10*1000)
  32. #define WEBSOCKET_TASK_PRIORITY (5)
  33. #define WEBSOCKET_TASK_STACK (4*1024)
  34. #define WEBSOCKET_NETWORK_TIMEOUT_MS (10*1000)
  35. #define WEBSOCKET_PING_TIMEOUT_MS (10*1000)
  36. #define WEBSOCKET_EVENT_QUEUE_SIZE (1)
  37. #define ESP_WS_CLIENT_MEM_CHECK(TAG, a, action) if (!(a)) { \
  38. ESP_LOGE(TAG,"%s:%d (%s): %s", __FILE__, __LINE__, __FUNCTION__, "Memory exhausted"); \
  39. action; \
  40. }
  41. #define ESP_WS_CLIENT_STATE_CHECK(TAG, a, action) if ((a->state) < WEBSOCKET_STATE_INIT) { \
  42. ESP_LOGE(TAG,"%s:%d (%s): %s", __FILE__, __LINE__, __FUNCTION__, "Websocket already stop"); \
  43. action; \
  44. }
  45. const static int STOPPED_BIT = BIT0;
  46. ESP_EVENT_DEFINE_BASE(WEBSOCKET_EVENTS);
  47. typedef struct {
  48. int task_stack;
  49. int task_prio;
  50. char *uri;
  51. char *host;
  52. char *path;
  53. char *scheme;
  54. char *username;
  55. char *password;
  56. int port;
  57. bool auto_reconnect;
  58. void *user_context;
  59. int network_timeout_ms;
  60. char *subprotocol;
  61. char *user_agent;
  62. char *headers;
  63. } websocket_config_storage_t;
  64. typedef enum {
  65. WEBSOCKET_STATE_ERROR = -1,
  66. WEBSOCKET_STATE_UNKNOW = 0,
  67. WEBSOCKET_STATE_INIT,
  68. WEBSOCKET_STATE_CONNECTED,
  69. WEBSOCKET_STATE_WAIT_TIMEOUT,
  70. } websocket_client_state_t;
  71. struct esp_websocket_client {
  72. esp_event_loop_handle_t event_handle;
  73. TaskHandle_t task_handle;
  74. esp_transport_list_handle_t transport_list;
  75. esp_transport_handle_t transport;
  76. websocket_config_storage_t *config;
  77. websocket_client_state_t state;
  78. uint64_t keepalive_tick_ms;
  79. uint64_t reconnect_tick_ms;
  80. uint64_t ping_tick_ms;
  81. int wait_timeout_ms;
  82. int auto_reconnect;
  83. bool run;
  84. EventGroupHandle_t status_bits;
  85. xSemaphoreHandle lock;
  86. char *rx_buffer;
  87. char *tx_buffer;
  88. int buffer_size;
  89. ws_transport_opcodes_t last_opcode;
  90. int payload_len;
  91. int payload_offset;
  92. };
  93. static uint64_t _tick_get_ms(void)
  94. {
  95. return esp_timer_get_time()/1000;
  96. }
  97. static esp_err_t esp_websocket_client_dispatch_event(esp_websocket_client_handle_t client,
  98. esp_websocket_event_id_t event,
  99. const char *data,
  100. int data_len)
  101. {
  102. esp_err_t err;
  103. esp_websocket_event_data_t event_data;
  104. event_data.client = client;
  105. event_data.user_context = client->config->user_context;
  106. event_data.data_ptr = data;
  107. event_data.data_len = data_len;
  108. event_data.op_code = client->last_opcode;
  109. event_data.payload_len = client->payload_len;
  110. event_data.payload_offset = client->payload_offset;
  111. if ((err = esp_event_post_to(client->event_handle,
  112. WEBSOCKET_EVENTS, event,
  113. &event_data,
  114. sizeof(esp_websocket_event_data_t),
  115. portMAX_DELAY)) != ESP_OK) {
  116. return err;
  117. }
  118. return esp_event_loop_run(client->event_handle, 0);
  119. }
  120. static esp_err_t esp_websocket_client_abort_connection(esp_websocket_client_handle_t client)
  121. {
  122. ESP_WS_CLIENT_STATE_CHECK(TAG, client, return ESP_FAIL);
  123. esp_transport_close(client->transport);
  124. if (client->config->auto_reconnect) {
  125. client->wait_timeout_ms = WEBSOCKET_RECONNECT_TIMEOUT_MS;
  126. client->reconnect_tick_ms = _tick_get_ms();
  127. ESP_LOGI(TAG, "Reconnect after %d ms", client->wait_timeout_ms);
  128. }
  129. client->state = WEBSOCKET_STATE_WAIT_TIMEOUT;
  130. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_DISCONNECTED, NULL, 0);
  131. return ESP_OK;
  132. }
  133. static esp_err_t esp_websocket_client_set_config(esp_websocket_client_handle_t client, const esp_websocket_client_config_t *config)
  134. {
  135. websocket_config_storage_t *cfg = client->config;
  136. cfg->task_prio = config->task_prio;
  137. if (cfg->task_prio <= 0) {
  138. cfg->task_prio = WEBSOCKET_TASK_PRIORITY;
  139. }
  140. cfg->task_stack = config->task_stack;
  141. if (cfg->task_stack == 0) {
  142. cfg->task_stack = WEBSOCKET_TASK_STACK;
  143. }
  144. if (config->host) {
  145. cfg->host = strdup(config->host);
  146. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->host, return ESP_ERR_NO_MEM);
  147. }
  148. if (config->port) {
  149. cfg->port = config->port;
  150. }
  151. if (config->username) {
  152. free(cfg->username);
  153. cfg->username = strdup(config->username);
  154. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->username, return ESP_ERR_NO_MEM);
  155. }
  156. if (config->password) {
  157. free(cfg->password);
  158. cfg->password = strdup(config->password);
  159. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->password, return ESP_ERR_NO_MEM);
  160. }
  161. if (config->uri) {
  162. free(cfg->uri);
  163. cfg->uri = strdup(config->uri);
  164. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->uri, return ESP_ERR_NO_MEM);
  165. }
  166. if (config->path) {
  167. free(cfg->path);
  168. cfg->path = strdup(config->path);
  169. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->path, return ESP_ERR_NO_MEM);
  170. }
  171. if (config->subprotocol) {
  172. free(cfg->subprotocol);
  173. cfg->subprotocol = strdup(config->subprotocol);
  174. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->subprotocol, return ESP_ERR_NO_MEM);
  175. }
  176. if (config->user_agent) {
  177. free(cfg->user_agent);
  178. cfg->user_agent = strdup(config->user_agent);
  179. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->user_agent, return ESP_ERR_NO_MEM);
  180. }
  181. if (config->headers) {
  182. free(cfg->headers);
  183. cfg->headers = strdup(config->headers);
  184. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->headers, return ESP_ERR_NO_MEM);
  185. }
  186. cfg->network_timeout_ms = WEBSOCKET_NETWORK_TIMEOUT_MS;
  187. cfg->user_context = config->user_context;
  188. cfg->auto_reconnect = true;
  189. if (config->disable_auto_reconnect) {
  190. cfg->auto_reconnect = false;
  191. }
  192. return ESP_OK;
  193. }
  194. static esp_err_t esp_websocket_client_destroy_config(esp_websocket_client_handle_t client)
  195. {
  196. if (client == NULL) {
  197. return ESP_ERR_INVALID_ARG;
  198. }
  199. websocket_config_storage_t *cfg = client->config;
  200. if (client->config == NULL) {
  201. return ESP_ERR_INVALID_ARG;
  202. }
  203. free(cfg->host);
  204. free(cfg->uri);
  205. free(cfg->path);
  206. free(cfg->scheme);
  207. free(cfg->username);
  208. free(cfg->password);
  209. free(cfg->subprotocol);
  210. free(cfg->user_agent);
  211. free(cfg->headers);
  212. memset(cfg, 0, sizeof(websocket_config_storage_t));
  213. free(client->config);
  214. client->config = NULL;
  215. return ESP_OK;
  216. }
  217. static void set_websocket_transport_optional_settings(esp_websocket_client_handle_t client, esp_transport_handle_t trans)
  218. {
  219. if (trans && client->config->path) {
  220. esp_transport_ws_set_path(trans, client->config->path);
  221. }
  222. if (trans && client->config->subprotocol) {
  223. esp_transport_ws_set_subprotocol(trans, client->config->subprotocol);
  224. }
  225. if (trans && client->config->user_agent) {
  226. esp_transport_ws_set_user_agent(trans, client->config->user_agent);
  227. }
  228. if (trans && client->config->headers) {
  229. esp_transport_ws_set_headers(trans, client->config->headers);
  230. }
  231. }
  232. esp_websocket_client_handle_t esp_websocket_client_init(const esp_websocket_client_config_t *config)
  233. {
  234. esp_websocket_client_handle_t client = calloc(1, sizeof(struct esp_websocket_client));
  235. ESP_WS_CLIENT_MEM_CHECK(TAG, client, return NULL);
  236. esp_event_loop_args_t event_args = {
  237. .queue_size = WEBSOCKET_EVENT_QUEUE_SIZE,
  238. .task_name = NULL // no task will be created
  239. };
  240. if (esp_event_loop_create(&event_args, &client->event_handle) != ESP_OK) {
  241. ESP_LOGE(TAG, "Error create event handler for websocket client");
  242. free(client);
  243. return NULL;
  244. }
  245. client->lock = xSemaphoreCreateRecursiveMutex();
  246. ESP_WS_CLIENT_MEM_CHECK(TAG, client->lock, goto _websocket_init_fail);
  247. client->config = calloc(1, sizeof(websocket_config_storage_t));
  248. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config, goto _websocket_init_fail);
  249. client->transport_list = esp_transport_list_init();
  250. ESP_WS_CLIENT_MEM_CHECK(TAG, client->transport_list, goto _websocket_init_fail);
  251. esp_transport_handle_t tcp = esp_transport_tcp_init();
  252. ESP_WS_CLIENT_MEM_CHECK(TAG, tcp, goto _websocket_init_fail);
  253. esp_transport_set_default_port(tcp, WEBSOCKET_TCP_DEFAULT_PORT);
  254. esp_transport_list_add(client->transport_list, tcp, "_tcp"); // need to save to transport list, for cleanup
  255. esp_transport_handle_t ws = esp_transport_ws_init(tcp);
  256. ESP_WS_CLIENT_MEM_CHECK(TAG, ws, goto _websocket_init_fail);
  257. esp_transport_set_default_port(ws, WEBSOCKET_TCP_DEFAULT_PORT);
  258. esp_transport_list_add(client->transport_list, ws, "ws");
  259. if (config->transport == WEBSOCKET_TRANSPORT_OVER_TCP) {
  260. asprintf(&client->config->scheme, "ws");
  261. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, goto _websocket_init_fail);
  262. }
  263. esp_transport_handle_t ssl = esp_transport_ssl_init();
  264. ESP_WS_CLIENT_MEM_CHECK(TAG, ssl, goto _websocket_init_fail);
  265. esp_transport_set_default_port(ssl, WEBSOCKET_SSL_DEFAULT_PORT);
  266. if (config->cert_pem) {
  267. esp_transport_ssl_set_cert_data(ssl, config->cert_pem, strlen(config->cert_pem));
  268. }
  269. esp_transport_list_add(client->transport_list, ssl, "_ssl"); // need to save to transport list, for cleanup
  270. esp_transport_handle_t wss = esp_transport_ws_init(ssl);
  271. ESP_WS_CLIENT_MEM_CHECK(TAG, wss, goto _websocket_init_fail);
  272. esp_transport_set_default_port(wss, WEBSOCKET_SSL_DEFAULT_PORT);
  273. esp_transport_list_add(client->transport_list, wss, "wss");
  274. if (config->transport == WEBSOCKET_TRANSPORT_OVER_SSL) {
  275. asprintf(&client->config->scheme, "wss");
  276. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, goto _websocket_init_fail);
  277. }
  278. if (config->uri) {
  279. if (esp_websocket_client_set_uri(client, config->uri) != ESP_OK) {
  280. ESP_LOGE(TAG, "Invalid uri");
  281. goto _websocket_init_fail;
  282. }
  283. }
  284. if (esp_websocket_client_set_config(client, config) != ESP_OK) {
  285. ESP_LOGE(TAG, "Failed to set the configuration");
  286. goto _websocket_init_fail;
  287. }
  288. if (client->config->scheme == NULL) {
  289. asprintf(&client->config->scheme, "ws");
  290. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, goto _websocket_init_fail);
  291. }
  292. set_websocket_transport_optional_settings(client, esp_transport_list_get_transport(client->transport_list, "ws"));
  293. set_websocket_transport_optional_settings(client, esp_transport_list_get_transport(client->transport_list, "wss"));
  294. client->keepalive_tick_ms = _tick_get_ms();
  295. client->reconnect_tick_ms = _tick_get_ms();
  296. client->ping_tick_ms = _tick_get_ms();
  297. int buffer_size = config->buffer_size;
  298. if (buffer_size <= 0) {
  299. buffer_size = WEBSOCKET_BUFFER_SIZE_BYTE;
  300. }
  301. client->rx_buffer = malloc(buffer_size);
  302. ESP_WS_CLIENT_MEM_CHECK(TAG, client->rx_buffer, {
  303. goto _websocket_init_fail;
  304. });
  305. client->tx_buffer = malloc(buffer_size);
  306. ESP_WS_CLIENT_MEM_CHECK(TAG, client->tx_buffer, {
  307. goto _websocket_init_fail;
  308. });
  309. client->status_bits = xEventGroupCreate();
  310. ESP_WS_CLIENT_MEM_CHECK(TAG, client->status_bits, {
  311. goto _websocket_init_fail;
  312. });
  313. client->buffer_size = buffer_size;
  314. return client;
  315. _websocket_init_fail:
  316. esp_websocket_client_destroy(client);
  317. return NULL;
  318. }
  319. esp_err_t esp_websocket_client_destroy(esp_websocket_client_handle_t client)
  320. {
  321. if (client == NULL) {
  322. return ESP_ERR_INVALID_ARG;
  323. }
  324. if (client->run) {
  325. esp_websocket_client_stop(client);
  326. }
  327. if (client->event_handle) {
  328. esp_event_loop_delete(client->event_handle);
  329. }
  330. esp_websocket_client_destroy_config(client);
  331. esp_transport_list_destroy(client->transport_list);
  332. vQueueDelete(client->lock);
  333. free(client->tx_buffer);
  334. free(client->rx_buffer);
  335. if (client->status_bits) {
  336. vEventGroupDelete(client->status_bits);
  337. }
  338. free(client);
  339. client = NULL;
  340. return ESP_OK;
  341. }
  342. esp_err_t esp_websocket_client_set_uri(esp_websocket_client_handle_t client, const char *uri)
  343. {
  344. if (client == NULL || uri == NULL) {
  345. return ESP_ERR_INVALID_ARG;
  346. }
  347. struct http_parser_url puri;
  348. http_parser_url_init(&puri);
  349. int parser_status = http_parser_parse_url(uri, strlen(uri), 0, &puri);
  350. if (parser_status != 0) {
  351. ESP_LOGE(TAG, "Error parse uri = %s", uri);
  352. return ESP_FAIL;
  353. }
  354. if (puri.field_data[UF_SCHEMA].len) {
  355. free(client->config->scheme);
  356. asprintf(&client->config->scheme, "%.*s", puri.field_data[UF_SCHEMA].len, uri + puri.field_data[UF_SCHEMA].off);
  357. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, return ESP_ERR_NO_MEM);
  358. }
  359. if (puri.field_data[UF_HOST].len) {
  360. free(client->config->host);
  361. asprintf(&client->config->host, "%.*s", puri.field_data[UF_HOST].len, uri + puri.field_data[UF_HOST].off);
  362. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->host, return ESP_ERR_NO_MEM);
  363. }
  364. if (puri.field_data[UF_PATH].len || puri.field_data[UF_QUERY].len) {
  365. free(client->config->path);
  366. if (puri.field_data[UF_QUERY].len == 0) {
  367. asprintf(&client->config->path, "%.*s", puri.field_data[UF_PATH].len, uri + puri.field_data[UF_PATH].off);
  368. } else if (puri.field_data[UF_PATH].len == 0) {
  369. asprintf(&client->config->path, "/?%.*s", puri.field_data[UF_QUERY].len, uri + puri.field_data[UF_QUERY].off);
  370. } else {
  371. asprintf(&client->config->path, "%.*s?%.*s", puri.field_data[UF_PATH].len, uri + puri.field_data[UF_PATH].off,
  372. puri.field_data[UF_QUERY].len, uri + puri.field_data[UF_QUERY].off);
  373. }
  374. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->path, return ESP_ERR_NO_MEM);
  375. }
  376. if (puri.field_data[UF_PORT].off) {
  377. client->config->port = strtol((const char*)(uri + puri.field_data[UF_PORT].off), NULL, 10);
  378. }
  379. if (puri.field_data[UF_USERINFO].len) {
  380. char *user_info = NULL;
  381. asprintf(&user_info, "%.*s", puri.field_data[UF_USERINFO].len, uri + puri.field_data[UF_USERINFO].off);
  382. if (user_info) {
  383. char *pass = strchr(user_info, ':');
  384. if (pass) {
  385. pass[0] = 0; //terminal username
  386. pass ++;
  387. free(client->config->password);
  388. client->config->password = strdup(pass);
  389. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->password, return ESP_ERR_NO_MEM);
  390. }
  391. free(client->config->username);
  392. client->config->username = strdup(user_info);
  393. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->username, return ESP_ERR_NO_MEM);
  394. free(user_info);
  395. } else {
  396. return ESP_ERR_NO_MEM;
  397. }
  398. }
  399. return ESP_OK;
  400. }
  401. static esp_err_t esp_websocket_client_recv(esp_websocket_client_handle_t client)
  402. {
  403. int rlen;
  404. client->payload_offset = 0;
  405. do {
  406. rlen = esp_transport_read(client->transport, client->rx_buffer, client->buffer_size, client->config->network_timeout_ms);
  407. if (rlen < 0) {
  408. ESP_LOGE(TAG, "Error read data");
  409. return ESP_FAIL;
  410. }
  411. client->payload_len = esp_transport_ws_get_read_payload_len(client->transport);
  412. client->last_opcode = esp_transport_ws_get_read_opcode(client->transport);
  413. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_DATA, client->rx_buffer, rlen);
  414. client->payload_offset += rlen;
  415. } while (client->payload_offset < client->payload_len);
  416. // if a PING message received -> send out the PONG, this will not work for PING messages with payload longer than buffer len
  417. if (client->last_opcode == WS_TRANSPORT_OPCODES_PING) {
  418. const char *data = (client->payload_len == 0) ? NULL : client->rx_buffer;
  419. esp_transport_ws_send_raw(client->transport, WS_TRANSPORT_OPCODES_PONG | WS_TRANSPORT_OPCODES_FIN, data, client->payload_len,
  420. client->config->network_timeout_ms);
  421. }
  422. return ESP_OK;
  423. }
  424. static void esp_websocket_client_task(void *pv)
  425. {
  426. const int lock_timeout = portMAX_DELAY;
  427. esp_websocket_client_handle_t client = (esp_websocket_client_handle_t) pv;
  428. client->run = true;
  429. //get transport by scheme
  430. client->transport = esp_transport_list_get_transport(client->transport_list, client->config->scheme);
  431. if (client->transport == NULL) {
  432. ESP_LOGE(TAG, "There are no transports valid, stop websocket client");
  433. client->run = false;
  434. }
  435. //default port
  436. if (client->config->port == 0) {
  437. client->config->port = esp_transport_get_default_port(client->transport);
  438. }
  439. client->state = WEBSOCKET_STATE_INIT;
  440. xEventGroupClearBits(client->status_bits, STOPPED_BIT);
  441. int read_select = 0;
  442. while (client->run) {
  443. if (xSemaphoreTakeRecursive(client->lock, lock_timeout) != pdPASS) {
  444. ESP_LOGE(TAG, "Failed to lock ws-client tasks, exitting the task...");
  445. break;
  446. }
  447. switch ((int)client->state) {
  448. case WEBSOCKET_STATE_INIT:
  449. if (client->transport == NULL) {
  450. ESP_LOGE(TAG, "There are no transport");
  451. client->run = false;
  452. break;
  453. }
  454. if (esp_transport_connect(client->transport,
  455. client->config->host,
  456. client->config->port,
  457. client->config->network_timeout_ms) < 0) {
  458. ESP_LOGE(TAG, "Error transport connect");
  459. esp_websocket_client_abort_connection(client);
  460. break;
  461. }
  462. ESP_LOGD(TAG, "Transport connected to %s://%s:%d", client->config->scheme, client->config->host, client->config->port);
  463. client->state = WEBSOCKET_STATE_CONNECTED;
  464. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_CONNECTED, NULL, 0);
  465. break;
  466. case WEBSOCKET_STATE_CONNECTED:
  467. if (_tick_get_ms() - client->ping_tick_ms > WEBSOCKET_PING_TIMEOUT_MS) {
  468. client->ping_tick_ms = _tick_get_ms();
  469. ESP_LOGD(TAG, "Sending PING...");
  470. esp_transport_ws_send_raw(client->transport, WS_TRANSPORT_OPCODES_PING | WS_TRANSPORT_OPCODES_FIN, NULL, 0, client->config->network_timeout_ms);
  471. }
  472. if (read_select == 0) {
  473. ESP_LOGV(TAG, "Read poll timeout: skipping esp_transport_read()...");
  474. break;
  475. }
  476. client->ping_tick_ms = _tick_get_ms();
  477. if (esp_websocket_client_recv(client) == ESP_FAIL) {
  478. ESP_LOGE(TAG, "Error receive data");
  479. esp_websocket_client_abort_connection(client);
  480. break;
  481. }
  482. break;
  483. case WEBSOCKET_STATE_WAIT_TIMEOUT:
  484. if (!client->config->auto_reconnect) {
  485. client->run = false;
  486. break;
  487. }
  488. if (_tick_get_ms() - client->reconnect_tick_ms > client->wait_timeout_ms) {
  489. client->state = WEBSOCKET_STATE_INIT;
  490. client->reconnect_tick_ms = _tick_get_ms();
  491. ESP_LOGD(TAG, "Reconnecting...");
  492. }
  493. break;
  494. }
  495. xSemaphoreGiveRecursive(client->lock);
  496. if (WEBSOCKET_STATE_CONNECTED == client->state) {
  497. read_select = esp_transport_poll_read(client->transport, 1000); //Poll every 1000ms
  498. if (read_select < 0) {
  499. ESP_LOGE(TAG, "Network error: esp_transport_poll_read() returned %d, errno=%d", read_select, errno);
  500. esp_websocket_client_abort_connection(client);
  501. }
  502. } else if (WEBSOCKET_STATE_WAIT_TIMEOUT == client->state) {
  503. // waiting for reconnecting...
  504. vTaskDelay(client->wait_timeout_ms / 2 / portTICK_RATE_MS);
  505. }
  506. }
  507. esp_transport_close(client->transport);
  508. xEventGroupSetBits(client->status_bits, STOPPED_BIT);
  509. client->state = WEBSOCKET_STATE_UNKNOW;
  510. vTaskDelete(NULL);
  511. }
  512. esp_err_t esp_websocket_client_start(esp_websocket_client_handle_t client)
  513. {
  514. if (client == NULL) {
  515. return ESP_ERR_INVALID_ARG;
  516. }
  517. if (client->state >= WEBSOCKET_STATE_INIT) {
  518. ESP_LOGE(TAG, "The client has started");
  519. return ESP_FAIL;
  520. }
  521. if (xTaskCreate(esp_websocket_client_task, "websocket_task", client->config->task_stack, client, client->config->task_prio, &client->task_handle) != pdTRUE) {
  522. ESP_LOGE(TAG, "Error create websocket task");
  523. return ESP_FAIL;
  524. }
  525. xEventGroupClearBits(client->status_bits, STOPPED_BIT);
  526. return ESP_OK;
  527. }
  528. esp_err_t esp_websocket_client_stop(esp_websocket_client_handle_t client)
  529. {
  530. if (client == NULL) {
  531. return ESP_ERR_INVALID_ARG;
  532. }
  533. if (!client->run) {
  534. ESP_LOGW(TAG, "Client was not started");
  535. return ESP_FAIL;
  536. }
  537. /* A running client cannot be stopped from the websocket task/event handler */
  538. TaskHandle_t running_task = xTaskGetCurrentTaskHandle();
  539. if (running_task == client->task_handle) {
  540. ESP_LOGE(TAG, "Client cannot be stopped from websocket task");
  541. return ESP_FAIL;
  542. }
  543. client->run = false;
  544. xEventGroupWaitBits(client->status_bits, STOPPED_BIT, false, true, portMAX_DELAY);
  545. client->state = WEBSOCKET_STATE_UNKNOW;
  546. return ESP_OK;
  547. }
  548. static int esp_websocket_client_send_with_opcode(esp_websocket_client_handle_t client, ws_transport_opcodes_t opcode, const char *data, int len, TickType_t timeout);
  549. int esp_websocket_client_send_text(esp_websocket_client_handle_t client, const char *data, int len, TickType_t timeout)
  550. {
  551. return esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_TEXT, data, len, timeout);
  552. }
  553. int esp_websocket_client_send(esp_websocket_client_handle_t client, const char *data, int len, TickType_t timeout)
  554. {
  555. return esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_BINARY, data, len, timeout);
  556. }
  557. int esp_websocket_client_send_bin(esp_websocket_client_handle_t client, const char *data, int len, TickType_t timeout)
  558. {
  559. return esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_BINARY, data, len, timeout);
  560. }
  561. static int esp_websocket_client_send_with_opcode(esp_websocket_client_handle_t client, ws_transport_opcodes_t opcode, const char *data, int len, TickType_t timeout)
  562. {
  563. int need_write = len;
  564. int wlen = 0, widx = 0;
  565. int ret = ESP_FAIL;
  566. if (client == NULL || data == NULL || len <= 0) {
  567. ESP_LOGE(TAG, "Invalid arguments");
  568. return ESP_FAIL;
  569. }
  570. if (xSemaphoreTakeRecursive(client->lock, timeout) != pdPASS) {
  571. ESP_LOGE(TAG, "Could not lock ws-client within %d timeout", timeout);
  572. return ESP_FAIL;
  573. }
  574. if (!esp_websocket_client_is_connected(client)) {
  575. ESP_LOGE(TAG, "Websocket client is not connected");
  576. goto unlock_and_return;
  577. }
  578. if (client->transport == NULL) {
  579. ESP_LOGE(TAG, "Invalid transport");
  580. goto unlock_and_return;
  581. }
  582. uint32_t current_opcode = opcode;
  583. while (widx < len) {
  584. if (need_write > client->buffer_size) {
  585. need_write = client->buffer_size;
  586. } else {
  587. current_opcode |= WS_TRANSPORT_OPCODES_FIN;
  588. }
  589. memcpy(client->tx_buffer, data + widx, need_write);
  590. // send with ws specific way and specific opcode
  591. wlen = esp_transport_ws_send_raw(client->transport, current_opcode, (char *)client->tx_buffer, need_write,
  592. (timeout==portMAX_DELAY)? -1 : timeout * portTICK_PERIOD_MS);
  593. if (wlen <= 0) {
  594. ret = wlen;
  595. ESP_LOGE(TAG, "Network error: esp_transport_write() returned %d, errno=%d", ret, errno);
  596. esp_websocket_client_abort_connection(client);
  597. goto unlock_and_return;
  598. }
  599. current_opcode = 0;
  600. widx += wlen;
  601. need_write = len - widx;
  602. }
  603. ret = widx;
  604. unlock_and_return:
  605. xSemaphoreGiveRecursive(client->lock);
  606. return ret;
  607. }
  608. bool esp_websocket_client_is_connected(esp_websocket_client_handle_t client)
  609. {
  610. if (client == NULL) {
  611. return false;
  612. }
  613. return client->state == WEBSOCKET_STATE_CONNECTED;
  614. }
  615. esp_err_t esp_websocket_register_events(esp_websocket_client_handle_t client,
  616. esp_websocket_event_id_t event,
  617. esp_event_handler_t event_handler,
  618. void *event_handler_arg)
  619. {
  620. if (client == NULL) {
  621. return ESP_ERR_INVALID_ARG;
  622. }
  623. return esp_event_handler_register_with(client->event_handle, WEBSOCKET_EVENTS, event, event_handler, event_handler_arg);
  624. }