esp_websocket_client.c 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870
  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 WEBSOCKET_PINGPONG_TIMEOUT_SEC (120)
  38. #define ESP_WS_CLIENT_MEM_CHECK(TAG, a, action) if (!(a)) { \
  39. ESP_LOGE(TAG,"%s(%d): %s", __FUNCTION__, __LINE__, "Memory exhausted"); \
  40. action; \
  41. }
  42. #define ESP_WS_CLIENT_STATE_CHECK(TAG, a, action) if ((a->state) < WEBSOCKET_STATE_INIT) { \
  43. ESP_LOGE(TAG,"%s:%d (%s): %s", __FILE__, __LINE__, __FUNCTION__, "Websocket already stop"); \
  44. action; \
  45. }
  46. const static int STOPPED_BIT = BIT0;
  47. const static int CLOSE_FRAME_SENT_BIT = BIT1; // Indicates that a close frame was sent by the client
  48. // and we are waiting for the server to continue with clean close
  49. ESP_EVENT_DEFINE_BASE(WEBSOCKET_EVENTS);
  50. typedef struct {
  51. int task_stack;
  52. int task_prio;
  53. char *uri;
  54. char *host;
  55. char *path;
  56. char *scheme;
  57. char *username;
  58. char *password;
  59. int port;
  60. bool auto_reconnect;
  61. void *user_context;
  62. int network_timeout_ms;
  63. char *subprotocol;
  64. char *user_agent;
  65. char *headers;
  66. int pingpong_timeout_sec;
  67. } websocket_config_storage_t;
  68. typedef enum {
  69. WEBSOCKET_STATE_ERROR = -1,
  70. WEBSOCKET_STATE_UNKNOW = 0,
  71. WEBSOCKET_STATE_INIT,
  72. WEBSOCKET_STATE_CONNECTED,
  73. WEBSOCKET_STATE_WAIT_TIMEOUT,
  74. WEBSOCKET_STATE_CLOSING,
  75. } websocket_client_state_t;
  76. struct esp_websocket_client {
  77. esp_event_loop_handle_t event_handle;
  78. TaskHandle_t task_handle;
  79. esp_transport_list_handle_t transport_list;
  80. esp_transport_handle_t transport;
  81. websocket_config_storage_t *config;
  82. websocket_client_state_t state;
  83. uint64_t keepalive_tick_ms;
  84. uint64_t reconnect_tick_ms;
  85. uint64_t ping_tick_ms;
  86. uint64_t pingpong_tick_ms;
  87. int wait_timeout_ms;
  88. int auto_reconnect;
  89. bool run;
  90. bool wait_for_pong_resp;
  91. EventGroupHandle_t status_bits;
  92. xSemaphoreHandle lock;
  93. char *rx_buffer;
  94. char *tx_buffer;
  95. int buffer_size;
  96. ws_transport_opcodes_t last_opcode;
  97. int payload_len;
  98. int payload_offset;
  99. };
  100. static uint64_t _tick_get_ms(void)
  101. {
  102. return esp_timer_get_time()/1000;
  103. }
  104. static esp_err_t esp_websocket_client_dispatch_event(esp_websocket_client_handle_t client,
  105. esp_websocket_event_id_t event,
  106. const char *data,
  107. int data_len)
  108. {
  109. esp_err_t err;
  110. esp_websocket_event_data_t event_data;
  111. event_data.client = client;
  112. event_data.user_context = client->config->user_context;
  113. event_data.data_ptr = data;
  114. event_data.data_len = data_len;
  115. event_data.op_code = client->last_opcode;
  116. event_data.payload_len = client->payload_len;
  117. event_data.payload_offset = client->payload_offset;
  118. if ((err = esp_event_post_to(client->event_handle,
  119. WEBSOCKET_EVENTS, event,
  120. &event_data,
  121. sizeof(esp_websocket_event_data_t),
  122. portMAX_DELAY)) != ESP_OK) {
  123. return err;
  124. }
  125. return esp_event_loop_run(client->event_handle, 0);
  126. }
  127. static esp_err_t esp_websocket_client_abort_connection(esp_websocket_client_handle_t client)
  128. {
  129. ESP_WS_CLIENT_STATE_CHECK(TAG, client, return ESP_FAIL);
  130. esp_transport_close(client->transport);
  131. if (client->config->auto_reconnect) {
  132. client->wait_timeout_ms = WEBSOCKET_RECONNECT_TIMEOUT_MS;
  133. client->reconnect_tick_ms = _tick_get_ms();
  134. ESP_LOGI(TAG, "Reconnect after %d ms", client->wait_timeout_ms);
  135. }
  136. client->state = WEBSOCKET_STATE_WAIT_TIMEOUT;
  137. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_DISCONNECTED, NULL, 0);
  138. return ESP_OK;
  139. }
  140. static esp_err_t esp_websocket_client_set_config(esp_websocket_client_handle_t client, const esp_websocket_client_config_t *config)
  141. {
  142. websocket_config_storage_t *cfg = client->config;
  143. cfg->task_prio = config->task_prio;
  144. if (cfg->task_prio <= 0) {
  145. cfg->task_prio = WEBSOCKET_TASK_PRIORITY;
  146. }
  147. cfg->task_stack = config->task_stack;
  148. if (cfg->task_stack == 0) {
  149. cfg->task_stack = WEBSOCKET_TASK_STACK;
  150. }
  151. if (config->host) {
  152. cfg->host = strdup(config->host);
  153. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->host, return ESP_ERR_NO_MEM);
  154. }
  155. if (config->port) {
  156. cfg->port = config->port;
  157. }
  158. if (config->username) {
  159. free(cfg->username);
  160. cfg->username = strdup(config->username);
  161. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->username, return ESP_ERR_NO_MEM);
  162. }
  163. if (config->password) {
  164. free(cfg->password);
  165. cfg->password = strdup(config->password);
  166. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->password, return ESP_ERR_NO_MEM);
  167. }
  168. if (config->uri) {
  169. free(cfg->uri);
  170. cfg->uri = strdup(config->uri);
  171. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->uri, return ESP_ERR_NO_MEM);
  172. }
  173. if (config->path) {
  174. free(cfg->path);
  175. cfg->path = strdup(config->path);
  176. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->path, return ESP_ERR_NO_MEM);
  177. }
  178. if (config->subprotocol) {
  179. free(cfg->subprotocol);
  180. cfg->subprotocol = strdup(config->subprotocol);
  181. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->subprotocol, return ESP_ERR_NO_MEM);
  182. }
  183. if (config->user_agent) {
  184. free(cfg->user_agent);
  185. cfg->user_agent = strdup(config->user_agent);
  186. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->user_agent, return ESP_ERR_NO_MEM);
  187. }
  188. if (config->headers) {
  189. free(cfg->headers);
  190. cfg->headers = strdup(config->headers);
  191. ESP_WS_CLIENT_MEM_CHECK(TAG, cfg->headers, return ESP_ERR_NO_MEM);
  192. }
  193. cfg->network_timeout_ms = WEBSOCKET_NETWORK_TIMEOUT_MS;
  194. cfg->user_context = config->user_context;
  195. cfg->auto_reconnect = true;
  196. if (config->disable_auto_reconnect) {
  197. cfg->auto_reconnect = false;
  198. }
  199. if (config->disable_pingpong_discon){
  200. cfg->pingpong_timeout_sec = 0;
  201. } else if (config->pingpong_timeout_sec) {
  202. cfg->pingpong_timeout_sec = config->pingpong_timeout_sec;
  203. } else {
  204. cfg->pingpong_timeout_sec = WEBSOCKET_PINGPONG_TIMEOUT_SEC;
  205. }
  206. return ESP_OK;
  207. }
  208. static esp_err_t esp_websocket_client_destroy_config(esp_websocket_client_handle_t client)
  209. {
  210. if (client == NULL) {
  211. return ESP_ERR_INVALID_ARG;
  212. }
  213. websocket_config_storage_t *cfg = client->config;
  214. if (client->config == NULL) {
  215. return ESP_ERR_INVALID_ARG;
  216. }
  217. free(cfg->host);
  218. free(cfg->uri);
  219. free(cfg->path);
  220. free(cfg->scheme);
  221. free(cfg->username);
  222. free(cfg->password);
  223. free(cfg->subprotocol);
  224. free(cfg->user_agent);
  225. free(cfg->headers);
  226. memset(cfg, 0, sizeof(websocket_config_storage_t));
  227. free(client->config);
  228. client->config = NULL;
  229. return ESP_OK;
  230. }
  231. static void set_websocket_transport_optional_settings(esp_websocket_client_handle_t client, esp_transport_handle_t trans)
  232. {
  233. if (trans && client->config->path) {
  234. esp_transport_ws_set_path(trans, client->config->path);
  235. }
  236. if (trans && client->config->subprotocol) {
  237. esp_transport_ws_set_subprotocol(trans, client->config->subprotocol);
  238. }
  239. if (trans && client->config->user_agent) {
  240. esp_transport_ws_set_user_agent(trans, client->config->user_agent);
  241. }
  242. if (trans && client->config->headers) {
  243. esp_transport_ws_set_headers(trans, client->config->headers);
  244. }
  245. }
  246. esp_websocket_client_handle_t esp_websocket_client_init(const esp_websocket_client_config_t *config)
  247. {
  248. esp_websocket_client_handle_t client = calloc(1, sizeof(struct esp_websocket_client));
  249. ESP_WS_CLIENT_MEM_CHECK(TAG, client, return NULL);
  250. esp_event_loop_args_t event_args = {
  251. .queue_size = WEBSOCKET_EVENT_QUEUE_SIZE,
  252. .task_name = NULL // no task will be created
  253. };
  254. if (esp_event_loop_create(&event_args, &client->event_handle) != ESP_OK) {
  255. ESP_LOGE(TAG, "Error create event handler for websocket client");
  256. free(client);
  257. return NULL;
  258. }
  259. client->lock = xSemaphoreCreateRecursiveMutex();
  260. ESP_WS_CLIENT_MEM_CHECK(TAG, client->lock, goto _websocket_init_fail);
  261. client->config = calloc(1, sizeof(websocket_config_storage_t));
  262. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config, goto _websocket_init_fail);
  263. client->transport_list = esp_transport_list_init();
  264. ESP_WS_CLIENT_MEM_CHECK(TAG, client->transport_list, goto _websocket_init_fail);
  265. esp_transport_handle_t tcp = esp_transport_tcp_init();
  266. ESP_WS_CLIENT_MEM_CHECK(TAG, tcp, goto _websocket_init_fail);
  267. esp_transport_set_default_port(tcp, WEBSOCKET_TCP_DEFAULT_PORT);
  268. esp_transport_list_add(client->transport_list, tcp, "_tcp"); // need to save to transport list, for cleanup
  269. esp_transport_handle_t ws = esp_transport_ws_init(tcp);
  270. ESP_WS_CLIENT_MEM_CHECK(TAG, ws, goto _websocket_init_fail);
  271. esp_transport_set_default_port(ws, WEBSOCKET_TCP_DEFAULT_PORT);
  272. esp_transport_list_add(client->transport_list, ws, "ws");
  273. if (config->transport == WEBSOCKET_TRANSPORT_OVER_TCP) {
  274. asprintf(&client->config->scheme, "ws");
  275. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, goto _websocket_init_fail);
  276. }
  277. esp_transport_handle_t ssl = esp_transport_ssl_init();
  278. ESP_WS_CLIENT_MEM_CHECK(TAG, ssl, goto _websocket_init_fail);
  279. esp_transport_set_default_port(ssl, WEBSOCKET_SSL_DEFAULT_PORT);
  280. if (config->use_global_ca_store == true) {
  281. esp_transport_ssl_enable_global_ca_store(ssl);
  282. } else if (config->cert_pem) {
  283. if (!config->cert_len) {
  284. esp_transport_ssl_set_cert_data(ssl, config->cert_pem, strlen(config->cert_pem));
  285. } else {
  286. esp_transport_ssl_set_cert_data_der(ssl, config->cert_pem, config->cert_len);
  287. }
  288. }
  289. if (config->client_cert) {
  290. if (!config->client_cert_len) {
  291. esp_transport_ssl_set_client_cert_data(ssl, config->client_cert, strlen(config->client_cert));
  292. } else {
  293. esp_transport_ssl_set_client_cert_data_der(ssl, config->client_cert, config->client_cert_len);
  294. }
  295. }
  296. if (config->client_key) {
  297. if (!config->client_key_len) {
  298. esp_transport_ssl_set_client_key_data(ssl, config->client_key, strlen(config->client_key));
  299. } else {
  300. esp_transport_ssl_set_client_key_data_der(ssl, config->client_key, config->client_key_len);
  301. }
  302. }
  303. if (config->skip_cert_common_name_check) {
  304. esp_transport_ssl_skip_common_name_check(ssl);
  305. }
  306. esp_transport_list_add(client->transport_list, ssl, "_ssl"); // need to save to transport list, for cleanup
  307. esp_transport_handle_t wss = esp_transport_ws_init(ssl);
  308. ESP_WS_CLIENT_MEM_CHECK(TAG, wss, goto _websocket_init_fail);
  309. esp_transport_set_default_port(wss, WEBSOCKET_SSL_DEFAULT_PORT);
  310. esp_transport_list_add(client->transport_list, wss, "wss");
  311. if (config->transport == WEBSOCKET_TRANSPORT_OVER_SSL) {
  312. asprintf(&client->config->scheme, "wss");
  313. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, goto _websocket_init_fail);
  314. }
  315. if (config->uri) {
  316. if (esp_websocket_client_set_uri(client, config->uri) != ESP_OK) {
  317. ESP_LOGE(TAG, "Invalid uri");
  318. goto _websocket_init_fail;
  319. }
  320. }
  321. if (esp_websocket_client_set_config(client, config) != ESP_OK) {
  322. ESP_LOGE(TAG, "Failed to set the configuration");
  323. goto _websocket_init_fail;
  324. }
  325. if (client->config->scheme == NULL) {
  326. asprintf(&client->config->scheme, "ws");
  327. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, goto _websocket_init_fail);
  328. }
  329. set_websocket_transport_optional_settings(client, esp_transport_list_get_transport(client->transport_list, "ws"));
  330. set_websocket_transport_optional_settings(client, esp_transport_list_get_transport(client->transport_list, "wss"));
  331. client->keepalive_tick_ms = _tick_get_ms();
  332. client->reconnect_tick_ms = _tick_get_ms();
  333. client->ping_tick_ms = _tick_get_ms();
  334. client->wait_for_pong_resp = false;
  335. int buffer_size = config->buffer_size;
  336. if (buffer_size <= 0) {
  337. buffer_size = WEBSOCKET_BUFFER_SIZE_BYTE;
  338. }
  339. client->rx_buffer = malloc(buffer_size);
  340. ESP_WS_CLIENT_MEM_CHECK(TAG, client->rx_buffer, {
  341. goto _websocket_init_fail;
  342. });
  343. client->tx_buffer = malloc(buffer_size);
  344. ESP_WS_CLIENT_MEM_CHECK(TAG, client->tx_buffer, {
  345. goto _websocket_init_fail;
  346. });
  347. client->status_bits = xEventGroupCreate();
  348. ESP_WS_CLIENT_MEM_CHECK(TAG, client->status_bits, {
  349. goto _websocket_init_fail;
  350. });
  351. client->buffer_size = buffer_size;
  352. return client;
  353. _websocket_init_fail:
  354. esp_websocket_client_destroy(client);
  355. return NULL;
  356. }
  357. esp_err_t esp_websocket_client_destroy(esp_websocket_client_handle_t client)
  358. {
  359. if (client == NULL) {
  360. return ESP_ERR_INVALID_ARG;
  361. }
  362. if (client->run) {
  363. esp_websocket_client_stop(client);
  364. }
  365. if (client->event_handle) {
  366. esp_event_loop_delete(client->event_handle);
  367. }
  368. esp_websocket_client_destroy_config(client);
  369. esp_transport_list_destroy(client->transport_list);
  370. vQueueDelete(client->lock);
  371. free(client->tx_buffer);
  372. free(client->rx_buffer);
  373. if (client->status_bits) {
  374. vEventGroupDelete(client->status_bits);
  375. }
  376. free(client);
  377. client = NULL;
  378. return ESP_OK;
  379. }
  380. esp_err_t esp_websocket_client_set_uri(esp_websocket_client_handle_t client, const char *uri)
  381. {
  382. if (client == NULL || uri == NULL) {
  383. return ESP_ERR_INVALID_ARG;
  384. }
  385. struct http_parser_url puri;
  386. http_parser_url_init(&puri);
  387. int parser_status = http_parser_parse_url(uri, strlen(uri), 0, &puri);
  388. if (parser_status != 0) {
  389. ESP_LOGE(TAG, "Error parse uri = %s", uri);
  390. return ESP_FAIL;
  391. }
  392. if (puri.field_data[UF_SCHEMA].len) {
  393. free(client->config->scheme);
  394. asprintf(&client->config->scheme, "%.*s", puri.field_data[UF_SCHEMA].len, uri + puri.field_data[UF_SCHEMA].off);
  395. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->scheme, return ESP_ERR_NO_MEM);
  396. }
  397. if (puri.field_data[UF_HOST].len) {
  398. free(client->config->host);
  399. asprintf(&client->config->host, "%.*s", puri.field_data[UF_HOST].len, uri + puri.field_data[UF_HOST].off);
  400. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->host, return ESP_ERR_NO_MEM);
  401. }
  402. if (puri.field_data[UF_PATH].len || puri.field_data[UF_QUERY].len) {
  403. free(client->config->path);
  404. if (puri.field_data[UF_QUERY].len == 0) {
  405. asprintf(&client->config->path, "%.*s", puri.field_data[UF_PATH].len, uri + puri.field_data[UF_PATH].off);
  406. } else if (puri.field_data[UF_PATH].len == 0) {
  407. asprintf(&client->config->path, "/?%.*s", puri.field_data[UF_QUERY].len, uri + puri.field_data[UF_QUERY].off);
  408. } else {
  409. asprintf(&client->config->path, "%.*s?%.*s", puri.field_data[UF_PATH].len, uri + puri.field_data[UF_PATH].off,
  410. puri.field_data[UF_QUERY].len, uri + puri.field_data[UF_QUERY].off);
  411. }
  412. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->path, return ESP_ERR_NO_MEM);
  413. }
  414. if (puri.field_data[UF_PORT].off) {
  415. client->config->port = strtol((const char*)(uri + puri.field_data[UF_PORT].off), NULL, 10);
  416. }
  417. if (puri.field_data[UF_USERINFO].len) {
  418. char *user_info = NULL;
  419. asprintf(&user_info, "%.*s", puri.field_data[UF_USERINFO].len, uri + puri.field_data[UF_USERINFO].off);
  420. if (user_info) {
  421. char *pass = strchr(user_info, ':');
  422. if (pass) {
  423. pass[0] = 0; //terminal username
  424. pass ++;
  425. free(client->config->password);
  426. client->config->password = strdup(pass);
  427. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->password, return ESP_ERR_NO_MEM);
  428. }
  429. free(client->config->username);
  430. client->config->username = strdup(user_info);
  431. ESP_WS_CLIENT_MEM_CHECK(TAG, client->config->username, return ESP_ERR_NO_MEM);
  432. free(user_info);
  433. } else {
  434. return ESP_ERR_NO_MEM;
  435. }
  436. }
  437. return ESP_OK;
  438. }
  439. static esp_err_t esp_websocket_client_recv(esp_websocket_client_handle_t client)
  440. {
  441. int rlen;
  442. client->payload_offset = 0;
  443. do {
  444. rlen = esp_transport_read(client->transport, client->rx_buffer, client->buffer_size, client->config->network_timeout_ms);
  445. if (rlen < 0) {
  446. ESP_LOGE(TAG, "Error read data");
  447. return ESP_FAIL;
  448. }
  449. client->payload_len = esp_transport_ws_get_read_payload_len(client->transport);
  450. client->last_opcode = esp_transport_ws_get_read_opcode(client->transport);
  451. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_DATA, client->rx_buffer, rlen);
  452. client->payload_offset += rlen;
  453. } while (client->payload_offset < client->payload_len);
  454. // if a PING message received -> send out the PONG, this will not work for PING messages with payload longer than buffer len
  455. if (client->last_opcode == WS_TRANSPORT_OPCODES_PING) {
  456. const char *data = (client->payload_len == 0) ? NULL : client->rx_buffer;
  457. esp_transport_ws_send_raw(client->transport, WS_TRANSPORT_OPCODES_PONG | WS_TRANSPORT_OPCODES_FIN, data, client->payload_len,
  458. client->config->network_timeout_ms);
  459. } else if (client->last_opcode == WS_TRANSPORT_OPCODES_PONG) {
  460. client->wait_for_pong_resp = false;
  461. } else if (client->last_opcode == WS_TRANSPORT_OPCODES_CLOSE) {
  462. ESP_LOGD(TAG, "Received close frame");
  463. client->state = WEBSOCKET_STATE_CLOSING;
  464. }
  465. return ESP_OK;
  466. }
  467. static int esp_websocket_client_send_with_opcode(esp_websocket_client_handle_t client, ws_transport_opcodes_t opcode, const uint8_t *data, int len, TickType_t timeout);
  468. static int esp_websocket_client_send_close(esp_websocket_client_handle_t client, int code, const char *additional_data, int total_len, TickType_t timeout);
  469. static void esp_websocket_client_task(void *pv)
  470. {
  471. const int lock_timeout = portMAX_DELAY;
  472. esp_websocket_client_handle_t client = (esp_websocket_client_handle_t) pv;
  473. client->run = true;
  474. //get transport by scheme
  475. client->transport = esp_transport_list_get_transport(client->transport_list, client->config->scheme);
  476. if (client->transport == NULL) {
  477. ESP_LOGE(TAG, "There are no transports valid, stop websocket client");
  478. client->run = false;
  479. }
  480. //default port
  481. if (client->config->port == 0) {
  482. client->config->port = esp_transport_get_default_port(client->transport);
  483. }
  484. client->state = WEBSOCKET_STATE_INIT;
  485. xEventGroupClearBits(client->status_bits, STOPPED_BIT | CLOSE_FRAME_SENT_BIT);
  486. int read_select = 0;
  487. while (client->run) {
  488. if (xSemaphoreTakeRecursive(client->lock, lock_timeout) != pdPASS) {
  489. ESP_LOGE(TAG, "Failed to lock ws-client tasks, exitting the task...");
  490. break;
  491. }
  492. switch ((int)client->state) {
  493. case WEBSOCKET_STATE_INIT:
  494. if (client->transport == NULL) {
  495. ESP_LOGE(TAG, "There are no transport");
  496. client->run = false;
  497. break;
  498. }
  499. if (esp_transport_connect(client->transport,
  500. client->config->host,
  501. client->config->port,
  502. client->config->network_timeout_ms) < 0) {
  503. ESP_LOGE(TAG, "Error transport connect");
  504. esp_websocket_client_abort_connection(client);
  505. break;
  506. }
  507. ESP_LOGD(TAG, "Transport connected to %s://%s:%d", client->config->scheme, client->config->host, client->config->port);
  508. client->state = WEBSOCKET_STATE_CONNECTED;
  509. client->wait_for_pong_resp = false;
  510. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_CONNECTED, NULL, 0);
  511. break;
  512. case WEBSOCKET_STATE_CONNECTED:
  513. if ((CLOSE_FRAME_SENT_BIT & xEventGroupGetBits(client->status_bits)) == 0) { // only send and check for PING
  514. // if closing hasn't been initiated
  515. if (_tick_get_ms() - client->ping_tick_ms > WEBSOCKET_PING_TIMEOUT_MS) {
  516. client->ping_tick_ms = _tick_get_ms();
  517. ESP_LOGD(TAG, "Sending PING...");
  518. esp_transport_ws_send_raw(client->transport, WS_TRANSPORT_OPCODES_PING | WS_TRANSPORT_OPCODES_FIN, NULL, 0, client->config->network_timeout_ms);
  519. if (!client->wait_for_pong_resp && client->config->pingpong_timeout_sec) {
  520. client->pingpong_tick_ms = _tick_get_ms();
  521. client->wait_for_pong_resp = true;
  522. }
  523. }
  524. if ( _tick_get_ms() - client->pingpong_tick_ms > client->config->pingpong_timeout_sec*1000 ) {
  525. if (client->wait_for_pong_resp) {
  526. ESP_LOGE(TAG, "Error, no PONG received for more than %d seconds after PING", client->config->pingpong_timeout_sec);
  527. esp_websocket_client_abort_connection(client);
  528. break;
  529. }
  530. }
  531. }
  532. if (read_select == 0) {
  533. ESP_LOGV(TAG, "Read poll timeout: skipping esp_transport_read()...");
  534. break;
  535. }
  536. client->ping_tick_ms = _tick_get_ms();
  537. if (esp_websocket_client_recv(client) == ESP_FAIL) {
  538. ESP_LOGE(TAG, "Error receive data");
  539. esp_websocket_client_abort_connection(client);
  540. break;
  541. }
  542. break;
  543. case WEBSOCKET_STATE_WAIT_TIMEOUT:
  544. if (!client->config->auto_reconnect) {
  545. client->run = false;
  546. break;
  547. }
  548. if (_tick_get_ms() - client->reconnect_tick_ms > client->wait_timeout_ms) {
  549. client->state = WEBSOCKET_STATE_INIT;
  550. client->reconnect_tick_ms = _tick_get_ms();
  551. ESP_LOGD(TAG, "Reconnecting...");
  552. }
  553. break;
  554. case WEBSOCKET_STATE_CLOSING:
  555. // if closing not initiated by the client echo the close message back
  556. if ((CLOSE_FRAME_SENT_BIT & xEventGroupGetBits(client->status_bits)) == 0) {
  557. ESP_LOGD(TAG, "Closing initiated by the server, sending close frame");
  558. esp_transport_ws_send_raw(client->transport, WS_TRANSPORT_OPCODES_CLOSE | WS_TRANSPORT_OPCODES_FIN, NULL, 0, client->config->network_timeout_ms);
  559. xEventGroupSetBits(client->status_bits, CLOSE_FRAME_SENT_BIT);
  560. }
  561. break;
  562. default:
  563. ESP_LOGD(TAG, "Client run iteration in a default state: %d", client->state);
  564. break;
  565. }
  566. xSemaphoreGiveRecursive(client->lock);
  567. if (WEBSOCKET_STATE_CONNECTED == client->state) {
  568. read_select = esp_transport_poll_read(client->transport, 1000); //Poll every 1000ms
  569. if (read_select < 0) {
  570. ESP_LOGE(TAG, "Network error: esp_transport_poll_read() returned %d, errno=%d", read_select, errno);
  571. esp_websocket_client_abort_connection(client);
  572. }
  573. } else if (WEBSOCKET_STATE_WAIT_TIMEOUT == client->state) {
  574. // waiting for reconnecting...
  575. vTaskDelay(client->wait_timeout_ms / 2 / portTICK_RATE_MS);
  576. } else if (WEBSOCKET_STATE_CLOSING == client->state &&
  577. (CLOSE_FRAME_SENT_BIT & xEventGroupGetBits(client->status_bits))) {
  578. ESP_LOGD(TAG, " Waiting for TCP connection to be closed by the server");
  579. int ret = esp_transport_ws_poll_connection_closed(client->transport, 1000);
  580. if (ret == 0) {
  581. // still waiting
  582. break;
  583. }
  584. if (ret < 0) {
  585. ESP_LOGW(TAG, "Connection terminated while waiting for clean TCP close");
  586. }
  587. client->run = false;
  588. client->state = WEBSOCKET_STATE_UNKNOW;
  589. esp_websocket_client_dispatch_event(client, WEBSOCKET_EVENT_CLOSED, NULL, 0);
  590. break;
  591. }
  592. }
  593. esp_transport_close(client->transport);
  594. xEventGroupSetBits(client->status_bits, STOPPED_BIT);
  595. client->state = WEBSOCKET_STATE_UNKNOW;
  596. vTaskDelete(NULL);
  597. }
  598. esp_err_t esp_websocket_client_start(esp_websocket_client_handle_t client)
  599. {
  600. if (client == NULL) {
  601. return ESP_ERR_INVALID_ARG;
  602. }
  603. if (client->state >= WEBSOCKET_STATE_INIT) {
  604. ESP_LOGE(TAG, "The client has started");
  605. return ESP_FAIL;
  606. }
  607. if (xTaskCreate(esp_websocket_client_task, "websocket_task", client->config->task_stack, client, client->config->task_prio, &client->task_handle) != pdTRUE) {
  608. ESP_LOGE(TAG, "Error create websocket task");
  609. return ESP_FAIL;
  610. }
  611. xEventGroupClearBits(client->status_bits, STOPPED_BIT | CLOSE_FRAME_SENT_BIT);
  612. return ESP_OK;
  613. }
  614. esp_err_t esp_websocket_client_stop(esp_websocket_client_handle_t client)
  615. {
  616. if (client == NULL) {
  617. return ESP_ERR_INVALID_ARG;
  618. }
  619. if (!client->run) {
  620. ESP_LOGW(TAG, "Client was not started");
  621. return ESP_FAIL;
  622. }
  623. /* A running client cannot be stopped from the websocket task/event handler */
  624. TaskHandle_t running_task = xTaskGetCurrentTaskHandle();
  625. if (running_task == client->task_handle) {
  626. ESP_LOGE(TAG, "Client cannot be stopped from websocket task");
  627. return ESP_FAIL;
  628. }
  629. client->run = false;
  630. xEventGroupWaitBits(client->status_bits, STOPPED_BIT, false, true, portMAX_DELAY);
  631. client->state = WEBSOCKET_STATE_UNKNOW;
  632. return ESP_OK;
  633. }
  634. static int esp_websocket_client_send_close(esp_websocket_client_handle_t client, int code, const char *additional_data, int total_len, TickType_t timeout)
  635. {
  636. uint8_t *close_status_data = NULL;
  637. // RFC6455#section-5.5.1: The Close frame MAY contain a body (indicated by total_len >= 2)
  638. if (total_len >= 2) {
  639. close_status_data = calloc(1, total_len);
  640. ESP_WS_CLIENT_MEM_CHECK(TAG, close_status_data, return -1);
  641. // RFC6455#section-5.5.1: The first two bytes of the body MUST be a 2-byte representing a status
  642. uint16_t *code_network_order = (uint16_t *) close_status_data;
  643. *code_network_order = htons(code);
  644. memcpy(close_status_data + 2, additional_data, total_len - 2);
  645. }
  646. int ret = esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_CLOSE, close_status_data, total_len, timeout);
  647. free(close_status_data);
  648. return ret;
  649. }
  650. static esp_err_t esp_websocket_client_close_with_optional_body(esp_websocket_client_handle_t client, bool send_body, int code, const char *data, int len, TickType_t timeout)
  651. {
  652. if (client == NULL) {
  653. return ESP_ERR_INVALID_ARG;
  654. }
  655. if (!client->run) {
  656. ESP_LOGW(TAG, "Client was not started");
  657. return ESP_FAIL;
  658. }
  659. /* A running client cannot be stopped from the websocket task/event handler */
  660. TaskHandle_t running_task = xTaskGetCurrentTaskHandle();
  661. if (running_task == client->task_handle) {
  662. ESP_LOGE(TAG, "Client cannot be stopped from websocket task");
  663. return ESP_FAIL;
  664. }
  665. if (send_body) {
  666. esp_websocket_client_send_close(client, code, data, len + 2, portMAX_DELAY); // len + 2 -> always sending the code
  667. } else {
  668. esp_websocket_client_send_close(client, 0, NULL, 0, portMAX_DELAY); // only opcode frame
  669. }
  670. // Set closing bit to prevent from sending PING frames while connected
  671. xEventGroupSetBits(client->status_bits, CLOSE_FRAME_SENT_BIT);
  672. if (STOPPED_BIT & xEventGroupWaitBits(client->status_bits, STOPPED_BIT, false, true, timeout)) {
  673. return ESP_OK;
  674. }
  675. // If could not close gracefully within timeout, stop the client and disconnect
  676. client->run = false;
  677. xEventGroupWaitBits(client->status_bits, STOPPED_BIT, false, true, portMAX_DELAY);
  678. client->state = WEBSOCKET_STATE_UNKNOW;
  679. return ESP_OK;
  680. }
  681. esp_err_t esp_websocket_client_close_with_code(esp_websocket_client_handle_t client, int code, const char *data, int len, TickType_t timeout)
  682. {
  683. return esp_websocket_client_close_with_optional_body(client, true, code, data, len, timeout);
  684. }
  685. esp_err_t esp_websocket_client_close(esp_websocket_client_handle_t client, TickType_t timeout)
  686. {
  687. return esp_websocket_client_close_with_optional_body(client, false, 0, NULL, 0, timeout);
  688. }
  689. int esp_websocket_client_send_text(esp_websocket_client_handle_t client, const char *data, int len, TickType_t timeout)
  690. {
  691. return esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_TEXT, (const uint8_t *)data, len, timeout);
  692. }
  693. int esp_websocket_client_send(esp_websocket_client_handle_t client, const char *data, int len, TickType_t timeout)
  694. {
  695. return esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_BINARY, (const uint8_t *)data, len, timeout);
  696. }
  697. int esp_websocket_client_send_bin(esp_websocket_client_handle_t client, const char *data, int len, TickType_t timeout)
  698. {
  699. return esp_websocket_client_send_with_opcode(client, WS_TRANSPORT_OPCODES_BINARY, (const uint8_t *)data, len, timeout);
  700. }
  701. static int esp_websocket_client_send_with_opcode(esp_websocket_client_handle_t client, ws_transport_opcodes_t opcode, const uint8_t *data, int len, TickType_t timeout)
  702. {
  703. int need_write = len;
  704. int wlen = 0, widx = 0;
  705. int ret = ESP_FAIL;
  706. if (client == NULL || len < 0 ||
  707. (opcode != WS_TRANSPORT_OPCODES_CLOSE && (data == NULL || len <= 0))) {
  708. ESP_LOGE(TAG, "Invalid arguments");
  709. return ESP_FAIL;
  710. }
  711. if (xSemaphoreTakeRecursive(client->lock, timeout) != pdPASS) {
  712. ESP_LOGE(TAG, "Could not lock ws-client within %d timeout", timeout);
  713. return ESP_FAIL;
  714. }
  715. if (!esp_websocket_client_is_connected(client)) {
  716. ESP_LOGE(TAG, "Websocket client is not connected");
  717. goto unlock_and_return;
  718. }
  719. if (client->transport == NULL) {
  720. ESP_LOGE(TAG, "Invalid transport");
  721. goto unlock_and_return;
  722. }
  723. uint32_t current_opcode = opcode;
  724. while (widx < len || current_opcode) { // allow for sending "current_opcode" only message with len==0
  725. if (need_write > client->buffer_size) {
  726. need_write = client->buffer_size;
  727. } else {
  728. current_opcode |= WS_TRANSPORT_OPCODES_FIN;
  729. }
  730. memcpy(client->tx_buffer, data + widx, need_write);
  731. // send with ws specific way and specific opcode
  732. wlen = esp_transport_ws_send_raw(client->transport, current_opcode, (char *)client->tx_buffer, need_write,
  733. (timeout==portMAX_DELAY)? -1 : timeout * portTICK_PERIOD_MS);
  734. if (wlen < 0 || (wlen == 0 && need_write != 0)) {
  735. ret = wlen;
  736. ESP_LOGE(TAG, "Network error: esp_transport_write() returned %d, errno=%d", ret, errno);
  737. esp_websocket_client_abort_connection(client);
  738. goto unlock_and_return;
  739. }
  740. current_opcode = 0;
  741. widx += wlen;
  742. need_write = len - widx;
  743. }
  744. ret = widx;
  745. unlock_and_return:
  746. xSemaphoreGiveRecursive(client->lock);
  747. return ret;
  748. }
  749. bool esp_websocket_client_is_connected(esp_websocket_client_handle_t client)
  750. {
  751. if (client == NULL) {
  752. return false;
  753. }
  754. return client->state == WEBSOCKET_STATE_CONNECTED;
  755. }
  756. esp_err_t esp_websocket_register_events(esp_websocket_client_handle_t client,
  757. esp_websocket_event_id_t event,
  758. esp_event_handler_t event_handler,
  759. void *event_handler_arg)
  760. {
  761. if (client == NULL) {
  762. return ESP_ERR_INVALID_ARG;
  763. }
  764. return esp_event_handler_register_with(client->event_handle, WEBSOCKET_EVENTS, event, event_handler, event_handler_arg);
  765. }