From ca9c2feebce5aac2ac7ac2eaeac343d8cdbe7e04 Mon Sep 17 00:00:00 2001 From: iranl Date: Mon, 26 Aug 2024 21:47:10 +0200 Subject: [PATCH] Switch HTTP Server --- lib/ESPAsyncWebServer/LICENSE | 165 --- lib/ESPAsyncWebServer/README.md | 126 -- lib/ESPAsyncWebServer/docs/_config.yml | 8 - lib/ESPAsyncWebServer/docs/index.md | 126 -- .../examples/CaptivePortal/CaptivePortal.ino | 57 - .../examples/Draft/Draft.ino | 37 - .../examples/Filters/Filters.ino | 111 -- .../examples/SimpleServer/SimpleServer.ino | 134 -- .../examples/StreamFiles/StreamConcat.h | 37 - .../examples/StreamFiles/StreamFiles.ino | 84 -- .../examples/StreamFiles/StreamString.h | 40 - .../examples/issues/Issue14/Issue14.ino | 107 -- lib/ESPAsyncWebServer/library.json | 64 - lib/ESPAsyncWebServer/library.properties | 10 - lib/ESPAsyncWebServer/platformio.ini | 80 -- .../src/AsyncEventSource.cpp | 405 ------ lib/ESPAsyncWebServer/src/AsyncEventSource.h | 158 --- lib/ESPAsyncWebServer/src/AsyncJson.h | 255 ---- lib/ESPAsyncWebServer/src/AsyncMessagePack.h | 145 -- lib/ESPAsyncWebServer/src/AsyncWebSocket.cpp | 1207 ----------------- lib/ESPAsyncWebServer/src/AsyncWebSocket.h | 379 ------ lib/ESPAsyncWebServer/src/ChunkPrint.h | 32 - lib/ESPAsyncWebServer/src/ESPAsyncWebServer.h | 714 ---------- .../src/WebAuthentication.cpp | 249 ---- lib/ESPAsyncWebServer/src/WebAuthentication.h | 39 - lib/ESPAsyncWebServer/src/WebHandlerImpl.h | 155 --- lib/ESPAsyncWebServer/src/WebHandlers.cpp | 250 ---- lib/ESPAsyncWebServer/src/WebRequest.cpp | 985 -------------- lib/ESPAsyncWebServer/src/WebResponseImpl.h | 157 --- lib/ESPAsyncWebServer/src/WebResponses.cpp | 849 ------------ lib/ESPAsyncWebServer/src/WebServer.cpp | 227 ---- lib/ESPAsyncWebServer/src/literals.h | 345 ----- .../src/port/SHA1Builder.cpp | 284 ---- lib/ESPAsyncWebServer/src/port/SHA1Builder.h | 39 - lib/PsychicHttp/CHANGELOG.md | 34 + .../CMakeLists.txt | 4 +- lib/PsychicHttp/LICENSE | 7 + lib/PsychicHttp/README.md | 826 +++++++++++ lib/PsychicHttp/RELEASE.md | 6 + lib/PsychicHttp/assets/handler-callbacks.svg | 4 + lib/PsychicHttp/assets/request-flow.svg | 4 + .../benchmark/arduinomongoose/.gitignore | 6 + .../arduinomongoose/data/www/alien.png | Bin 0 -> 28598 bytes .../benchmark/arduinomongoose/include/README | 39 + .../benchmark/arduinomongoose/lib/README | 46 + .../benchmark/arduinomongoose/platformio.ini | 22 + .../benchmark/arduinomongoose/src/main.cpp | 234 ++++ .../benchmark/arduinomongoose/test/README | 11 + lib/PsychicHttp/benchmark/comparison.ods | Bin 0 -> 82456 bytes .../benchmark/espasyncwebserver/.gitignore | 6 + .../espasyncwebserver/data/www/alien.png | Bin 0 -> 28598 bytes .../espasyncwebserver/include/README | 39 + .../benchmark/espasyncwebserver/lib/README | 46 + .../espasyncwebserver/platformio.ini | 22 + .../benchmark/espasyncwebserver/src/main.cpp | 276 ++++ .../benchmark/espasyncwebserver/test/README | 11 + .../benchmark/eventsource-client-test.js | 39 + lib/PsychicHttp/benchmark/http-client-test.js | 43 + lib/PsychicHttp/benchmark/latency.png | Bin 0 -> 50143 bytes lib/PsychicHttp/benchmark/loadtest-http.sh | 37 + .../benchmark/loadtest-websocket.sh | 31 + lib/PsychicHttp/benchmark/package.json | 7 + lib/PsychicHttp/benchmark/performance.png | Bin 0 -> 49201 bytes .../benchmark/psychichttp/.gitignore | 6 + .../benchmark/psychichttp/data/www/alien.png | Bin 0 -> 28598 bytes .../benchmark/psychichttp/include/README | 39 + .../benchmark/psychichttp/lib/README | 46 + .../benchmark/psychichttp/platformio.ini | 22 + .../benchmark/psychichttp/src/main.cpp | 228 ++++ .../benchmark/psychichttp/src/secret.h | 2 + .../benchmark/psychichttp/test/README | 11 + .../benchmark/psychichttps/.gitignore | 6 + .../benchmark/psychichttps/data/server.crt | 19 + .../benchmark/psychichttps/data/server.key | 28 + .../benchmark/psychichttps/data/www/alien.png | Bin 0 -> 28598 bytes .../benchmark/psychichttps/include/README | 39 + .../benchmark/psychichttps/lib/README | 46 + .../benchmark/psychichttps/platformio.ini | 22 + .../benchmark/psychichttps/src/main.cpp | 240 ++++ .../benchmark/psychichttps/src/secret.h | 2 + .../benchmark/psychichttps/test/README | 11 + .../results/arduinomongoose-http-loadtest.log | 1172 ++++++++++++++++ .../arduinomongoose-websocket-loadtest.log | 246 ++++ .../results/espasync-http-loadtest.log | 1165 ++++++++++++++++ .../results/espasync-websocket-loadtest.log | 252 ++++ .../results/psychic-http-loadtest.log | 1172 ++++++++++++++++ .../results/psychic-ssl-http-loadtest.log | 1194 ++++++++++++++++ .../psychic-ssl-websocket-loadtest.log | 246 ++++ .../results/psychic-v1.1-http-loadtest.log | 1179 ++++++++++++++++ .../psychic-v1.1-websocket-loadtest.log | 246 ++++ .../results/psychic-websocket-loadtest.log | 246 ++++ .../benchmark/websocket-client-test.js | 36 + lib/PsychicHttp/component.mk | 3 + lib/PsychicHttp/examples/arduino/.gitignore | 6 + lib/PsychicHttp/examples/arduino/arduino.ino | 497 +++++++ .../arduino/arduino_captive_portal/README.md | 60 + .../arduino_captive_portal.ino | 144 ++ .../images/accesspoint.png | Bin 0 -> 15389 bytes .../arduino_captive_portal/images/station.png | Bin 0 -> 10008 bytes .../examples/arduino/arduino_ota/README.md | 138 ++ .../arduino/arduino_ota/arduino_ota.ino | 219 +++ .../examples/arduino/arduino_ota/code.bin | Bin 0 -> 867072 bytes .../arduino/arduino_ota/data/update.html | 166 +++ .../arduino/arduino_ota/images/otaupdate1.png | Bin 0 -> 60478 bytes .../arduino/arduino_ota/images/otaupdate2.png | Bin 0 -> 60711 bytes .../arduino/arduino_ota/images/otaupdate3.png | Bin 0 -> 60047 bytes .../arduino/arduino_ota/images/otaupdate4.png | Bin 0 -> 59009 bytes .../arduino/arduino_ota/images/otaupdate5.png | Bin 0 -> 60143 bytes .../examples/arduino/arduino_ota/littlefs.bin | Bin 0 -> 1572864 bytes .../examples/arduino/data/custom.txt | 1 + .../arduino/data/img/request_flow.png | Bin 0 -> 30509 bytes .../examples/arduino/data/server.crt | 19 + .../examples/arduino/data/server.key | 28 + .../examples/arduino/data/www-ap/index.html | 15 + .../examples/arduino/data/www/alien.png | Bin 0 -> 28598 bytes .../examples/arduino/data/www/favicon.ico | Bin 0 -> 67646 bytes .../examples/arduino/data/www/index.html | 236 ++++ .../examples/arduino/data/www/text.txt | 1 + lib/PsychicHttp/examples/arduino/secret.h | 2 + lib/PsychicHttp/examples/esp-idf/.gitignore | 4 + .../examples/esp-idf/CMakeLists.txt | 19 + lib/PsychicHttp/examples/esp-idf/README.md | 7 + .../examples/esp-idf/data/custom.txt | 1 + .../esp-idf/data/img/request_flow.png | Bin 0 -> 30509 bytes .../examples/esp-idf/data/server.crt | 19 + .../examples/esp-idf/data/server.key | 28 + .../examples/esp-idf/data/www-ap/index.html | 15 + .../examples/esp-idf/data/www/alien.png | Bin 0 -> 28598 bytes .../examples/esp-idf/data/www/favicon.ico | Bin 0 -> 67646 bytes .../examples/esp-idf/data/www/index.html | 236 ++++ .../examples/esp-idf/data/www/text.txt | 1 + .../examples/esp-idf/include/README | 39 + lib/PsychicHttp/examples/esp-idf/lib/README | 46 + .../examples/esp-idf/main/CMakeLists.txt | 8 + .../examples/esp-idf/main/main.cpp | 510 +++++++ .../examples/esp-idf/main/secret.h | 2 + .../examples/esp-idf/partitions_custom.csv | 7 + .../examples/esp-idf/sdkconfig.defaults | 64 + .../old/esp_ota_http_server/.gitignore | 39 + .../old/esp_ota_http_server/include/README | 39 + .../old/esp_ota_http_server/lib/README | 46 + .../old/esp_ota_http_server/platformio.ini | 74 + .../src/esp_ota_http_server.cpp | 229 ++++ .../old/esp_ota_http_server/test/README | 11 + .../old/simple_http_server/.gitignore | 39 + .../old/simple_http_server/include/README | 39 + .../old/simple_http_server/lib/README | 46 + .../old/simple_http_server/platformio.ini | 64 + .../src/simple_http_server.cpp | 211 +++ .../old/simple_http_server/test/README | 11 + .../old/simple_http_server/test/tests.rest | 35 + .../old/simplest_web_server_esp/.gitignore | 39 + .../old/simplest_web_server_esp/.travis.yml | 67 + .../simplest_web_server_esp/include/README | 39 + .../old/simplest_web_server_esp/lib/README | 46 + .../simplest_web_server_esp/platformio.ini | 40 + .../src/simplest_web_server.cpp | 97 ++ .../old/simplest_web_server_esp/test/README | 11 + .../examples/old/websocket_chat/.gitignore | 39 + .../old/websocket_chat/include/README | 39 + .../examples/old/websocket_chat/lib/README | 46 + .../old/websocket_chat/platformio.ini | 64 + .../old/websocket_chat/src/websocket_chat.cpp | 235 ++++ .../examples/old/websocket_chat/test/README | 11 + .../old/websocket_chat/test/tests.rest | 35 + .../examples/platformio/.gitignore | 6 + .../examples/platformio/data/custom.txt | 1 + .../platformio/data/img/request_flow.png | Bin 0 -> 30509 bytes .../examples/platformio/data/server.crt | 19 + .../examples/platformio/data/server.key | 28 + .../platformio/data/www-ap/index.html | 15 + .../examples/platformio/data/www/alien.png | Bin 0 -> 28598 bytes .../examples/platformio/data/www/favicon.ico | Bin 0 -> 67646 bytes .../examples/platformio/data/www/index.html | 236 ++++ .../examples/platformio/data/www/text.txt | 1 + .../examples/platformio/include/README | 39 + .../examples/platformio/lib/README | 46 + .../examples/platformio/platformio.ini | 30 + .../examples/platformio/src/main.cpp | 583 ++++++++ .../examples/platformio/src/secret.h | 2 + .../examples/platformio/test/README | 11 + .../examples/websockets/.gitignore | 8 + .../examples/websockets/data/www/favicon.ico | Bin 0 -> 67646 bytes .../examples/websockets/data/www/index.html | 76 ++ .../examples/websockets/include/README | 39 + .../examples/websockets/lib/README | 46 + .../examples/websockets/platformio.ini | 25 + .../examples/websockets/src/main.cpp | 225 +++ .../examples/websockets/src/secret.h | 2 + .../examples/websockets/test/README | 11 + lib/PsychicHttp/library.json | 53 + lib/PsychicHttp/library.properties | 11 + lib/PsychicHttp/request flow.drawio | 1 + lib/PsychicHttp/src/ChunkPrinter.cpp | 85 ++ lib/PsychicHttp/src/ChunkPrinter.h | 27 + lib/PsychicHttp/src/PsychicClient.cpp | 72 + lib/PsychicHttp/src/PsychicClient.h | 35 + lib/PsychicHttp/src/PsychicCore.h | 107 ++ lib/PsychicHttp/src/PsychicEndpoint.cpp | 90 ++ lib/PsychicHttp/src/PsychicEndpoint.h | 37 + lib/PsychicHttp/src/PsychicEventSource.cpp | 225 +++ lib/PsychicHttp/src/PsychicEventSource.h | 82 ++ lib/PsychicHttp/src/PsychicFileResponse.cpp | 159 +++ lib/PsychicHttp/src/PsychicFileResponse.h | 23 + lib/PsychicHttp/src/PsychicHandler.cpp | 111 ++ lib/PsychicHttp/src/PsychicHandler.h | 66 + lib/PsychicHttp/src/PsychicHttp.h | 24 + lib/PsychicHttp/src/PsychicHttpServer.cpp | 366 +++++ lib/PsychicHttp/src/PsychicHttpServer.h | 81 ++ lib/PsychicHttp/src/PsychicHttpsServer.cpp | 61 + lib/PsychicHttp/src/PsychicHttpsServer.h | 39 + lib/PsychicHttp/src/PsychicJson.cpp | 133 ++ lib/PsychicHttp/src/PsychicJson.h | 89 ++ lib/PsychicHttp/src/PsychicRequest.cpp | 542 ++++++++ lib/PsychicHttp/src/PsychicRequest.h | 98 ++ lib/PsychicHttp/src/PsychicResponse.cpp | 162 +++ lib/PsychicHttp/src/PsychicResponse.h | 46 + .../src/PsychicStaticFileHander.cpp | 181 +++ .../src/PsychicStaticFileHandler.h | 41 + lib/PsychicHttp/src/PsychicStreamResponse.cpp | 94 ++ lib/PsychicHttp/src/PsychicStreamResponse.h | 35 + lib/PsychicHttp/src/PsychicUploadHandler.cpp | 395 ++++++ lib/PsychicHttp/src/PsychicUploadHandler.h | 68 + lib/PsychicHttp/src/PsychicWebHandler.cpp | 74 + lib/PsychicHttp/src/PsychicWebHandler.h | 34 + lib/PsychicHttp/src/PsychicWebParameter.h | 25 + lib/PsychicHttp/src/PsychicWebSocket.cpp | 258 ++++ lib/PsychicHttp/src/PsychicWebSocket.h | 70 + lib/PsychicHttp/src/TemplatePrinter.cpp | 90 ++ lib/PsychicHttp/src/TemplatePrinter.h | 51 + lib/PsychicHttp/src/async_worker.cpp | 203 +++ lib/PsychicHttp/src/async_worker.h | 36 + lib/PsychicHttp/src/http_status.cpp | 194 +++ lib/PsychicHttp/src/http_status.h | 15 + 234 files changed, 20090 insertions(+), 8061 deletions(-) delete mode 100644 lib/ESPAsyncWebServer/LICENSE delete mode 100644 lib/ESPAsyncWebServer/README.md delete mode 100644 lib/ESPAsyncWebServer/docs/_config.yml delete mode 100644 lib/ESPAsyncWebServer/docs/index.md delete mode 100644 lib/ESPAsyncWebServer/examples/CaptivePortal/CaptivePortal.ino delete mode 100644 lib/ESPAsyncWebServer/examples/Draft/Draft.ino delete mode 100644 lib/ESPAsyncWebServer/examples/Filters/Filters.ino delete mode 100644 lib/ESPAsyncWebServer/examples/SimpleServer/SimpleServer.ino delete mode 100644 lib/ESPAsyncWebServer/examples/StreamFiles/StreamConcat.h delete mode 100644 lib/ESPAsyncWebServer/examples/StreamFiles/StreamFiles.ino delete mode 100644 lib/ESPAsyncWebServer/examples/StreamFiles/StreamString.h delete mode 100644 lib/ESPAsyncWebServer/examples/issues/Issue14/Issue14.ino delete mode 100644 lib/ESPAsyncWebServer/library.json delete mode 100644 lib/ESPAsyncWebServer/library.properties delete mode 100644 lib/ESPAsyncWebServer/platformio.ini delete mode 100644 lib/ESPAsyncWebServer/src/AsyncEventSource.cpp delete mode 100644 lib/ESPAsyncWebServer/src/AsyncEventSource.h delete mode 100644 lib/ESPAsyncWebServer/src/AsyncJson.h delete mode 100644 lib/ESPAsyncWebServer/src/AsyncMessagePack.h delete mode 100644 lib/ESPAsyncWebServer/src/AsyncWebSocket.cpp delete mode 100644 lib/ESPAsyncWebServer/src/AsyncWebSocket.h delete mode 100644 lib/ESPAsyncWebServer/src/ChunkPrint.h delete mode 100644 lib/ESPAsyncWebServer/src/ESPAsyncWebServer.h delete mode 100644 lib/ESPAsyncWebServer/src/WebAuthentication.cpp delete mode 100644 lib/ESPAsyncWebServer/src/WebAuthentication.h delete mode 100644 lib/ESPAsyncWebServer/src/WebHandlerImpl.h delete mode 100644 lib/ESPAsyncWebServer/src/WebHandlers.cpp delete mode 100644 lib/ESPAsyncWebServer/src/WebRequest.cpp delete mode 100644 lib/ESPAsyncWebServer/src/WebResponseImpl.h delete mode 100644 lib/ESPAsyncWebServer/src/WebResponses.cpp delete mode 100644 lib/ESPAsyncWebServer/src/WebServer.cpp delete mode 100644 lib/ESPAsyncWebServer/src/literals.h delete mode 100644 lib/ESPAsyncWebServer/src/port/SHA1Builder.cpp delete mode 100644 lib/ESPAsyncWebServer/src/port/SHA1Builder.h create mode 100644 lib/PsychicHttp/CHANGELOG.md rename lib/{ESPAsyncWebServer => PsychicHttp}/CMakeLists.txt (82%) create mode 100644 lib/PsychicHttp/LICENSE create mode 100644 lib/PsychicHttp/README.md create mode 100644 lib/PsychicHttp/RELEASE.md create mode 100644 lib/PsychicHttp/assets/handler-callbacks.svg create mode 100644 lib/PsychicHttp/assets/request-flow.svg create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/.gitignore create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/data/www/alien.png create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/include/README create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/lib/README create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/platformio.ini create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/src/main.cpp create mode 100644 lib/PsychicHttp/benchmark/arduinomongoose/test/README create mode 100644 lib/PsychicHttp/benchmark/comparison.ods create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/.gitignore create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/data/www/alien.png create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/include/README create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/lib/README create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/platformio.ini create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/src/main.cpp create mode 100644 lib/PsychicHttp/benchmark/espasyncwebserver/test/README create mode 100644 lib/PsychicHttp/benchmark/eventsource-client-test.js create mode 100644 lib/PsychicHttp/benchmark/http-client-test.js create mode 100644 lib/PsychicHttp/benchmark/latency.png create mode 100644 lib/PsychicHttp/benchmark/loadtest-http.sh create mode 100644 lib/PsychicHttp/benchmark/loadtest-websocket.sh create mode 100644 lib/PsychicHttp/benchmark/package.json create mode 100644 lib/PsychicHttp/benchmark/performance.png create mode 100644 lib/PsychicHttp/benchmark/psychichttp/.gitignore create mode 100644 lib/PsychicHttp/benchmark/psychichttp/data/www/alien.png create mode 100644 lib/PsychicHttp/benchmark/psychichttp/include/README create mode 100644 lib/PsychicHttp/benchmark/psychichttp/lib/README create mode 100644 lib/PsychicHttp/benchmark/psychichttp/platformio.ini create mode 100644 lib/PsychicHttp/benchmark/psychichttp/src/main.cpp create mode 100644 lib/PsychicHttp/benchmark/psychichttp/src/secret.h create mode 100644 lib/PsychicHttp/benchmark/psychichttp/test/README create mode 100644 lib/PsychicHttp/benchmark/psychichttps/.gitignore create mode 100644 lib/PsychicHttp/benchmark/psychichttps/data/server.crt create mode 100644 lib/PsychicHttp/benchmark/psychichttps/data/server.key create mode 100644 lib/PsychicHttp/benchmark/psychichttps/data/www/alien.png create mode 100644 lib/PsychicHttp/benchmark/psychichttps/include/README create mode 100644 lib/PsychicHttp/benchmark/psychichttps/lib/README create mode 100644 lib/PsychicHttp/benchmark/psychichttps/platformio.ini create mode 100644 lib/PsychicHttp/benchmark/psychichttps/src/main.cpp create mode 100644 lib/PsychicHttp/benchmark/psychichttps/src/secret.h create mode 100644 lib/PsychicHttp/benchmark/psychichttps/test/README create mode 100644 lib/PsychicHttp/benchmark/results/arduinomongoose-http-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/arduinomongoose-websocket-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/espasync-http-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/espasync-websocket-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/psychic-http-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/psychic-ssl-http-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/psychic-ssl-websocket-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/psychic-v1.1-http-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/psychic-v1.1-websocket-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/results/psychic-websocket-loadtest.log create mode 100644 lib/PsychicHttp/benchmark/websocket-client-test.js create mode 100644 lib/PsychicHttp/component.mk create mode 100644 lib/PsychicHttp/examples/arduino/.gitignore create mode 100644 lib/PsychicHttp/examples/arduino/arduino.ino create mode 100644 lib/PsychicHttp/examples/arduino/arduino_captive_portal/README.md create mode 100644 lib/PsychicHttp/examples/arduino/arduino_captive_portal/arduino_captive_portal.ino create mode 100644 lib/PsychicHttp/examples/arduino/arduino_captive_portal/images/accesspoint.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_captive_portal/images/station.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/README.md create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/arduino_ota.ino create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/code.bin create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/data/update.html create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate1.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate2.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate3.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate4.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate5.png create mode 100644 lib/PsychicHttp/examples/arduino/arduino_ota/littlefs.bin create mode 100644 lib/PsychicHttp/examples/arduino/data/custom.txt create mode 100644 lib/PsychicHttp/examples/arduino/data/img/request_flow.png create mode 100644 lib/PsychicHttp/examples/arduino/data/server.crt create mode 100644 lib/PsychicHttp/examples/arduino/data/server.key create mode 100644 lib/PsychicHttp/examples/arduino/data/www-ap/index.html create mode 100644 lib/PsychicHttp/examples/arduino/data/www/alien.png create mode 100644 lib/PsychicHttp/examples/arduino/data/www/favicon.ico create mode 100644 lib/PsychicHttp/examples/arduino/data/www/index.html create mode 100644 lib/PsychicHttp/examples/arduino/data/www/text.txt create mode 100644 lib/PsychicHttp/examples/arduino/secret.h create mode 100644 lib/PsychicHttp/examples/esp-idf/.gitignore create mode 100644 lib/PsychicHttp/examples/esp-idf/CMakeLists.txt create mode 100644 lib/PsychicHttp/examples/esp-idf/README.md create mode 100644 lib/PsychicHttp/examples/esp-idf/data/custom.txt create mode 100644 lib/PsychicHttp/examples/esp-idf/data/img/request_flow.png create mode 100644 lib/PsychicHttp/examples/esp-idf/data/server.crt create mode 100644 lib/PsychicHttp/examples/esp-idf/data/server.key create mode 100644 lib/PsychicHttp/examples/esp-idf/data/www-ap/index.html create mode 100644 lib/PsychicHttp/examples/esp-idf/data/www/alien.png create mode 100644 lib/PsychicHttp/examples/esp-idf/data/www/favicon.ico create mode 100644 lib/PsychicHttp/examples/esp-idf/data/www/index.html create mode 100644 lib/PsychicHttp/examples/esp-idf/data/www/text.txt create mode 100644 lib/PsychicHttp/examples/esp-idf/include/README create mode 100644 lib/PsychicHttp/examples/esp-idf/lib/README create mode 100644 lib/PsychicHttp/examples/esp-idf/main/CMakeLists.txt create mode 100644 lib/PsychicHttp/examples/esp-idf/main/main.cpp create mode 100644 lib/PsychicHttp/examples/esp-idf/main/secret.h create mode 100644 lib/PsychicHttp/examples/esp-idf/partitions_custom.csv create mode 100644 lib/PsychicHttp/examples/esp-idf/sdkconfig.defaults create mode 100644 lib/PsychicHttp/examples/old/esp_ota_http_server/.gitignore create mode 100644 lib/PsychicHttp/examples/old/esp_ota_http_server/include/README create mode 100644 lib/PsychicHttp/examples/old/esp_ota_http_server/lib/README create mode 100644 lib/PsychicHttp/examples/old/esp_ota_http_server/platformio.ini create mode 100644 lib/PsychicHttp/examples/old/esp_ota_http_server/src/esp_ota_http_server.cpp create mode 100644 lib/PsychicHttp/examples/old/esp_ota_http_server/test/README create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/.gitignore create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/include/README create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/lib/README create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/platformio.ini create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/src/simple_http_server.cpp create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/test/README create mode 100644 lib/PsychicHttp/examples/old/simple_http_server/test/tests.rest create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/.gitignore create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/.travis.yml create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/include/README create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/lib/README create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/platformio.ini create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/src/simplest_web_server.cpp create mode 100644 lib/PsychicHttp/examples/old/simplest_web_server_esp/test/README create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/.gitignore create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/include/README create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/lib/README create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/platformio.ini create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/src/websocket_chat.cpp create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/test/README create mode 100644 lib/PsychicHttp/examples/old/websocket_chat/test/tests.rest create mode 100644 lib/PsychicHttp/examples/platformio/.gitignore create mode 100644 lib/PsychicHttp/examples/platformio/data/custom.txt create mode 100644 lib/PsychicHttp/examples/platformio/data/img/request_flow.png create mode 100644 lib/PsychicHttp/examples/platformio/data/server.crt create mode 100644 lib/PsychicHttp/examples/platformio/data/server.key create mode 100644 lib/PsychicHttp/examples/platformio/data/www-ap/index.html create mode 100644 lib/PsychicHttp/examples/platformio/data/www/alien.png create mode 100644 lib/PsychicHttp/examples/platformio/data/www/favicon.ico create mode 100644 lib/PsychicHttp/examples/platformio/data/www/index.html create mode 100644 lib/PsychicHttp/examples/platformio/data/www/text.txt create mode 100644 lib/PsychicHttp/examples/platformio/include/README create mode 100644 lib/PsychicHttp/examples/platformio/lib/README create mode 100644 lib/PsychicHttp/examples/platformio/platformio.ini create mode 100644 lib/PsychicHttp/examples/platformio/src/main.cpp create mode 100644 lib/PsychicHttp/examples/platformio/src/secret.h create mode 100644 lib/PsychicHttp/examples/platformio/test/README create mode 100644 lib/PsychicHttp/examples/websockets/.gitignore create mode 100644 lib/PsychicHttp/examples/websockets/data/www/favicon.ico create mode 100644 lib/PsychicHttp/examples/websockets/data/www/index.html create mode 100644 lib/PsychicHttp/examples/websockets/include/README create mode 100644 lib/PsychicHttp/examples/websockets/lib/README create mode 100644 lib/PsychicHttp/examples/websockets/platformio.ini create mode 100644 lib/PsychicHttp/examples/websockets/src/main.cpp create mode 100644 lib/PsychicHttp/examples/websockets/src/secret.h create mode 100644 lib/PsychicHttp/examples/websockets/test/README create mode 100644 lib/PsychicHttp/library.json create mode 100644 lib/PsychicHttp/library.properties create mode 100644 lib/PsychicHttp/request flow.drawio create mode 100644 lib/PsychicHttp/src/ChunkPrinter.cpp create mode 100644 lib/PsychicHttp/src/ChunkPrinter.h create mode 100644 lib/PsychicHttp/src/PsychicClient.cpp create mode 100644 lib/PsychicHttp/src/PsychicClient.h create mode 100644 lib/PsychicHttp/src/PsychicCore.h create mode 100644 lib/PsychicHttp/src/PsychicEndpoint.cpp create mode 100644 lib/PsychicHttp/src/PsychicEndpoint.h create mode 100644 lib/PsychicHttp/src/PsychicEventSource.cpp create mode 100644 lib/PsychicHttp/src/PsychicEventSource.h create mode 100644 lib/PsychicHttp/src/PsychicFileResponse.cpp create mode 100644 lib/PsychicHttp/src/PsychicFileResponse.h create mode 100644 lib/PsychicHttp/src/PsychicHandler.cpp create mode 100644 lib/PsychicHttp/src/PsychicHandler.h create mode 100644 lib/PsychicHttp/src/PsychicHttp.h create mode 100644 lib/PsychicHttp/src/PsychicHttpServer.cpp create mode 100644 lib/PsychicHttp/src/PsychicHttpServer.h create mode 100644 lib/PsychicHttp/src/PsychicHttpsServer.cpp create mode 100644 lib/PsychicHttp/src/PsychicHttpsServer.h create mode 100644 lib/PsychicHttp/src/PsychicJson.cpp create mode 100644 lib/PsychicHttp/src/PsychicJson.h create mode 100644 lib/PsychicHttp/src/PsychicRequest.cpp create mode 100644 lib/PsychicHttp/src/PsychicRequest.h create mode 100644 lib/PsychicHttp/src/PsychicResponse.cpp create mode 100644 lib/PsychicHttp/src/PsychicResponse.h create mode 100644 lib/PsychicHttp/src/PsychicStaticFileHander.cpp create mode 100644 lib/PsychicHttp/src/PsychicStaticFileHandler.h create mode 100644 lib/PsychicHttp/src/PsychicStreamResponse.cpp create mode 100644 lib/PsychicHttp/src/PsychicStreamResponse.h create mode 100644 lib/PsychicHttp/src/PsychicUploadHandler.cpp create mode 100644 lib/PsychicHttp/src/PsychicUploadHandler.h create mode 100644 lib/PsychicHttp/src/PsychicWebHandler.cpp create mode 100644 lib/PsychicHttp/src/PsychicWebHandler.h create mode 100644 lib/PsychicHttp/src/PsychicWebParameter.h create mode 100644 lib/PsychicHttp/src/PsychicWebSocket.cpp create mode 100644 lib/PsychicHttp/src/PsychicWebSocket.h create mode 100644 lib/PsychicHttp/src/TemplatePrinter.cpp create mode 100644 lib/PsychicHttp/src/TemplatePrinter.h create mode 100644 lib/PsychicHttp/src/async_worker.cpp create mode 100644 lib/PsychicHttp/src/async_worker.h create mode 100644 lib/PsychicHttp/src/http_status.cpp create mode 100644 lib/PsychicHttp/src/http_status.h diff --git a/lib/ESPAsyncWebServer/LICENSE b/lib/ESPAsyncWebServer/LICENSE deleted file mode 100644 index 153d416..0000000 --- a/lib/ESPAsyncWebServer/LICENSE +++ /dev/null @@ -1,165 +0,0 @@ - GNU LESSER GENERAL PUBLIC LICENSE - Version 3, 29 June 2007 - - Copyright (C) 2007 Free Software Foundation, Inc. - Everyone is permitted to copy and distribute verbatim copies - of this license document, but changing it is not allowed. - - - This version of the GNU Lesser General Public License incorporates -the terms and conditions of version 3 of the GNU General Public -License, supplemented by the additional permissions listed below. - - 0. Additional Definitions. - - As used herein, "this License" refers to version 3 of the GNU Lesser -General Public License, and the "GNU GPL" refers to version 3 of the GNU -General Public License. - - "The Library" refers to a covered work governed by this License, -other than an Application or a Combined Work as defined below. - - An "Application" is any work that makes use of an interface provided -by the Library, but which is not otherwise based on the Library. -Defining a subclass of a class defined by the Library is deemed a mode -of using an interface provided by the Library. - - A "Combined Work" is a work produced by combining or linking an -Application with the Library. The particular version of the Library -with which the Combined Work was made is also called the "Linked -Version". - - The "Minimal Corresponding Source" for a Combined Work means the -Corresponding Source for the Combined Work, excluding any source code -for portions of the Combined Work that, considered in isolation, are -based on the Application, and not on the Linked Version. - - The "Corresponding Application Code" for a Combined Work means the -object code and/or source code for the Application, including any data -and utility programs needed for reproducing the Combined Work from the -Application, but excluding the System Libraries of the Combined Work. - - 1. Exception to Section 3 of the GNU GPL. - - You may convey a covered work under sections 3 and 4 of this License -without being bound by section 3 of the GNU GPL. - - 2. Conveying Modified Versions. - - If you modify a copy of the Library, and, in your modifications, a -facility refers to a function or data to be supplied by an Application -that uses the facility (other than as an argument passed when the -facility is invoked), then you may convey a copy of the modified -version: - - a) under this License, provided that you make a good faith effort to - ensure that, in the event an Application does not supply the - function or data, the facility still operates, and performs - whatever part of its purpose remains meaningful, or - - b) under the GNU GPL, with none of the additional permissions of - this License applicable to that copy. - - 3. Object Code Incorporating Material from Library Header Files. - - The object code form of an Application may incorporate material from -a header file that is part of the Library. You may convey such object -code under terms of your choice, provided that, if the incorporated -material is not limited to numerical parameters, data structure -layouts and accessors, or small macros, inline functions and templates -(ten or fewer lines in length), you do both of the following: - - a) Give prominent notice with each copy of the object code that the - Library is used in it and that the Library and its use are - covered by this License. - - b) Accompany the object code with a copy of the GNU GPL and this license - document. - - 4. Combined Works. - - You may convey a Combined Work under terms of your choice that, -taken together, effectively do not restrict modification of the -portions of the Library contained in the Combined Work and reverse -engineering for debugging such modifications, if you also do each of -the following: - - a) Give prominent notice with each copy of the Combined Work that - the Library is used in it and that the Library and its use are - covered by this License. - - b) Accompany the Combined Work with a copy of the GNU GPL and this license - document. - - c) For a Combined Work that displays copyright notices during - execution, include the copyright notice for the Library among - these notices, as well as a reference directing the user to the - copies of the GNU GPL and this license document. - - d) Do one of the following: - - 0) Convey the Minimal Corresponding Source under the terms of this - License, and the Corresponding Application Code in a form - suitable for, and under terms that permit, the user to - recombine or relink the Application with a modified version of - the Linked Version to produce a modified Combined Work, in the - manner specified by section 6 of the GNU GPL for conveying - Corresponding Source. - - 1) Use a suitable shared library mechanism for linking with the - Library. A suitable mechanism is one that (a) uses at run time - a copy of the Library already present on the user's computer - system, and (b) will operate properly with a modified version - of the Library that is interface-compatible with the Linked - Version. - - e) Provide Installation Information, but only if you would otherwise - be required to provide such information under section 6 of the - GNU GPL, and only to the extent that such information is - necessary to install and execute a modified version of the - Combined Work produced by recombining or relinking the - Application with a modified version of the Linked Version. (If - you use option 4d0, the Installation Information must accompany - the Minimal Corresponding Source and Corresponding Application - Code. If you use option 4d1, you must provide the Installation - Information in the manner specified by section 6 of the GNU GPL - for conveying Corresponding Source.) - - 5. Combined Libraries. - - You may place library facilities that are a work based on the -Library side by side in a single library together with other library -facilities that are not Applications and are not covered by this -License, and convey such a combined library under terms of your -choice, if you do both of the following: - - a) Accompany the combined library with a copy of the same work based - on the Library, uncombined with any other library facilities, - conveyed under the terms of this License. - - b) Give prominent notice with the combined library that part of it - is a work based on the Library, and explaining where to find the - accompanying uncombined form of the same work. - - 6. Revised Versions of the GNU Lesser General Public License. - - The Free Software Foundation may publish revised and/or new versions -of the GNU Lesser General Public License from time to time. Such new -versions will be similar in spirit to the present version, but may -differ in detail to address new problems or concerns. - - Each version is given a distinguishing version number. If the -Library as you received it specifies that a certain numbered version -of the GNU Lesser General Public License "or any later version" -applies to it, you have the option of following the terms and -conditions either of that published version or of any later version -published by the Free Software Foundation. If the Library as you -received it does not specify a version number of the GNU Lesser -General Public License, you may choose any version of the GNU Lesser -General Public License ever published by the Free Software Foundation. - - If the Library as you received it specifies that a proxy can decide -whether future versions of the GNU Lesser General Public License shall -apply, that proxy's public statement of acceptance of any version is -permanent authorization for you to choose that version for the -Library. \ No newline at end of file diff --git a/lib/ESPAsyncWebServer/README.md b/lib/ESPAsyncWebServer/README.md deleted file mode 100644 index 6ca1d1e..0000000 --- a/lib/ESPAsyncWebServer/README.md +++ /dev/null @@ -1,126 +0,0 @@ -# ESPAsyncWebServer - -[![License: LGPL 3.0](https://img.shields.io/badge/License-LGPL%203.0-yellow.svg)](https://opensource.org/license/lgpl-3-0/) -[![Continuous Integration](https://github.com/mathieucarbou/ESPAsyncWebServer/actions/workflows/ci.yml/badge.svg)](https://github.com/mathieucarbou/ESPAsyncWebServer/actions/workflows/ci.yml) -[![PlatformIO Registry](https://badges.registry.platformio.org/packages/mathieucarbou/library/ESPAsyncWebServer.svg)](https://registry.platformio.org/libraries/mathieucarbou/ESPAsyncWebServer) - -Asynchronous HTTP and WebSocket Server Library for ESP32, ESP8266 and RP2040 -Supports: WebSocket, SSE, Authentication, Arduino Json 7, File Upload, Static File serving, URL Rewrite, URL Redirect, etc. - -This fork is based on [yubox-node-org/ESPAsyncWebServer](https://github.com/yubox-node-org/ESPAsyncWebServer) and includes all the concurrency fixes. - -## Coordinate and dependencies: - -**WARNING** The library name was changed from `ESP Async WebServer` to `ESPAsyncWebServer` as per the Arduino Lint recommendations. - -``` -mathieucarbou/ESPAsyncWebServer @ 3.1.5 -``` - -Dependency: - -- **ESP32**: `mathieucarbou/AsyncTCP @ 3.2.4` (Arduino IDE: [https://github.com/mathieucarbou/AsyncTCP#v3.2.4](https://github.com/mathieucarbou/AsyncTCP/releases/tag/v3.2.0)) -- **ESP8266**: `esphome/ESPAsyncTCP-esphome @ 2.0.0` (Arduino IDE: [https://github.com/mathieucarbou/esphome-ESPAsyncTCP#v2.0.0](https://github.com/mathieucarbou/esphome-ESPAsyncTCP/releases/tag/v2.0.0)) -- **RP2040**: `khoih-prog/AsyncTCP_RP2040W @ 1.2.0` (Arduino IDE: [https://github.com/khoih-prog/AsyncTCP_RP2040W#v1.2.0](https://github.com/khoih-prog/AsyncTCP_RP2040W/releases/tag/v1.2.0)) - -## Changes in this fork - -- [@ayushsharma82](https://github.com/ayushsharma82) and [@mathieucarbou](https://github.com/mathieucarbou): Add RP2040 support ([#31](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/31)) -- [@mathieucarbou](https://github.com/mathieucarbou): `SSE_MAX_QUEUED_MESSAGES` to control the maximum number of messages that can be queued for a SSE client -- [@mathieucarbou](https://github.com/mathieucarbou): `write()` function public in `AsyncEventSource.h` -- [@mathieucarbou](https://github.com/mathieucarbou): `WS_MAX_QUEUED_MESSAGES`: control the maximum number of messages that can be queued for a Websocket client -- [@mathieucarbou](https://github.com/mathieucarbou): Added `setAuthentication(const String& username, const String& password)` -- [@mathieucarbou](https://github.com/mathieucarbou): Added `setCloseClientOnQueueFull(bool)` which can be set on a client to either close the connection or discard messages but not close the connection when the queue is full -- [@mathieucarbou](https://github.com/mathieucarbou): Added `StreamConcat` example to show how to stream multiple files in one response -- [@mathieucarbou](https://github.com/mathieucarbou): Added all flavors of `binary()`, `text()`, `binaryAll()` and `textAll()` in `AsyncWebSocket` -- [@mathieucarbou](https://github.com/mathieucarbou): Arduino 3 / ESP-IDF 5.1 compatibility -- [@mathieucarbou](https://github.com/mathieucarbou): Arduino Json 7 compatibility and backward compatible with 6 and 6 (changes in `AsyncJson.h`). The API to use Json has not changed. These are only internal changes. -- [@mathieucarbou](https://github.com/mathieucarbou): CI -- [@mathieucarbou](https://github.com/mathieucarbou): Depends on `mathieucarbou/AsyncTCP @ 3.2.4` -- [@mathieucarbou](https://github.com/mathieucarbou): Deployed in PlatformIO registry and Arduino IDE library manager -- [@mathieucarbou](https://github.com/mathieucarbou): Firmware size optimization: remove mbedtls dependency (accounts for 33KB in firmware) -- [@mathieucarbou](https://github.com/mathieucarbou): Made DEFAULT_MAX_SSE_CLIENTS customizable -- [@mathieucarbou](https://github.com/mathieucarbou): Made DEFAULT_MAX_WS_CLIENTS customizable -- [@mathieucarbou](https://github.com/mathieucarbou): MessagePack Support ([#62](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/62)) -- [@mathieucarbou](https://github.com/mathieucarbou): Remove filename after inline in Content-Disposition header according to RFC2183 -- [@mathieucarbou](https://github.com/mathieucarbou): Removed SPIFFSEditor to reduce library size and maintainance. SPIFF si also deprecated. If you need it, please copy the files from the original repository in your project. This fork focus on maintaining the server part and the SPIFFEditor is an application which has nothing to do inside a server library. -- [@mathieucarbou](https://github.com/mathieucarbou): Resurrected `AsyncWebSocketMessageBuffer` and `makeBuffer()` in order to make the fork API-compatible with the original library from me-no-dev regarding WebSocket. -- [@mathieucarbou](https://github.com/mathieucarbou): Some code cleanup -- [@mathieucarbou](https://github.com/mathieucarbou): Use `-D DEFAULT_MAX_WS_CLIENTS` to change the number of allows WebSocket clients and use `cleanupClients()` to help cleanup resources about dead clients -- [@nilo85](https://github.com/nilo85): Add support for Auth & GET requests in AsyncCallbackJsonWebHandler ([#14](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/14)) -- [@p0p-x](https://github.com/p0p-x): ESP IDF Compatibility (added back CMakeLists.txt) ([#32](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/32)) -- [@tueddy](https://github.com/tueddy): Compile with Arduino 3 (ESP-IDF 5.1) ([#13](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/13)) -- [@vortigont](https://github.com/vortigont): Set real "Last-Modified" header based on file's LastWrite time ([#5](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/5)) -- [@vortigont](https://github.com/vortigont): Some websocket code cleanup ([#29](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/29)) -- [@vortigont](https://github.com/vortigont): Refactor code - replace DYI structs with STL objects ([#39](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/39)) - -## Documentation - -Usage and API stays the same as the original library. -Please look at the original libraries for more examples and documentation. - -- [https://github.com/me-no-dev/ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer) (original library) -- [https://github.com/yubox-node-org/ESPAsyncWebServer](https://github.com/yubox-node-org/ESPAsyncWebServer) (fork of the original library) - -## `AsyncWebSocketMessageBuffer` and `makeBuffer()` - -The fork from `yubox-node-org` introduces some breaking API changes compared to the original library, especially regarding the use of `std::shared_ptr>` for WebSocket. - -This fork is compatible with the original library from `me-no-dev` regarding WebSocket, and wraps the optimizations done by `yubox-node-org` in the `AsyncWebSocketMessageBuffer` class. -So you have the choice of which API to use. - -Here are examples for serializing a Json document in a websocket message buffer: - -```cpp -void send(JsonDocument& doc) { - const size_t len = measureJson(doc); - - // original API from me-no-dev - AsyncWebSocketMessageBuffer* buffer = _ws->makeBuffer(len); - assert(buffer); // up to you to keep or remove this - serializeJson(doc, buffer->get(), len); - _ws->textAll(buffer); -} -``` - -```cpp -void send(JsonDocument& doc) { - const size_t len = measureJson(doc); - - // this fork (originally from yubox-node-org), uses another API with shared pointer - auto buffer = std::make_shared>(len); - assert(buffer); // up to you to keep or remove this - serializeJson(doc, buffer->data(), len); - _ws->textAll(std::move(buffer)); -} -``` - -I recommend to use the official API `AsyncWebSocketMessageBuffer` to retain further compatibility. - -## Important recommendations - -Most of the crashes are caused by improper configuration of the library for the project. -Here are some recommendations to avoid them. - -1. Set the running core to be on the same core of your application (usually core 1) `-D CONFIG_ASYNC_TCP_RUNNING_CORE=1` -2. Set the stack size appropriately with `-D CONFIG_ASYNC_TCP_STACK_SIZE=16384`. - The default value of `16384` might be too much for your project. - You can look at the [MycilaTaskMonitor](https://oss.carbou.me/MycilaTaskMonitor) project to monitor the stack usage. -3. You can change **if you know what you are doing** the task priority with `-D CONFIG_ASYNC_TCP_PRIORITY=10`. - Default is `10`. -4. You can increase the queue size with `-D CONFIG_ASYNC_TCP_QUEUE_SIZE=128`. - Default is `64`. -5. You can decrease the maximum ack time `-D CONFIG_ASYNC_TCP_MAX_ACK_TIME=3000`. - Default is `5000`. - -I personally use the following configuration in my projects because my WS messages can be big (up to 4k). -If you have smaller messages, you can increase `WS_MAX_QUEUED_MESSAGES` to 128. - -```c++ - -D CONFIG_ASYNC_TCP_MAX_ACK_TIME=3000 - -D CONFIG_ASYNC_TCP_PRIORITY=10 - -D CONFIG_ASYNC_TCP_QUEUE_SIZE=128 - -D CONFIG_ASYNC_TCP_RUNNING_CORE=1 - -D CONFIG_ASYNC_TCP_STACK_SIZE=4096 - -D WS_MAX_QUEUED_MESSAGES=64 -``` diff --git a/lib/ESPAsyncWebServer/docs/_config.yml b/lib/ESPAsyncWebServer/docs/_config.yml deleted file mode 100644 index 3636597..0000000 --- a/lib/ESPAsyncWebServer/docs/_config.yml +++ /dev/null @@ -1,8 +0,0 @@ -# bundle exec jekyll serve --host=0.0.0.0 - -title: ESPAsyncWebServer -description: "Asynchronous HTTP and WebSocket Server Library for ESP32, ESP8266 and RP2040" -remote_theme: pages-themes/cayman@v0.2.0 -plugins: - - jekyll-remote-theme - \ No newline at end of file diff --git a/lib/ESPAsyncWebServer/docs/index.md b/lib/ESPAsyncWebServer/docs/index.md deleted file mode 100644 index 6ca1d1e..0000000 --- a/lib/ESPAsyncWebServer/docs/index.md +++ /dev/null @@ -1,126 +0,0 @@ -# ESPAsyncWebServer - -[![License: LGPL 3.0](https://img.shields.io/badge/License-LGPL%203.0-yellow.svg)](https://opensource.org/license/lgpl-3-0/) -[![Continuous Integration](https://github.com/mathieucarbou/ESPAsyncWebServer/actions/workflows/ci.yml/badge.svg)](https://github.com/mathieucarbou/ESPAsyncWebServer/actions/workflows/ci.yml) -[![PlatformIO Registry](https://badges.registry.platformio.org/packages/mathieucarbou/library/ESPAsyncWebServer.svg)](https://registry.platformio.org/libraries/mathieucarbou/ESPAsyncWebServer) - -Asynchronous HTTP and WebSocket Server Library for ESP32, ESP8266 and RP2040 -Supports: WebSocket, SSE, Authentication, Arduino Json 7, File Upload, Static File serving, URL Rewrite, URL Redirect, etc. - -This fork is based on [yubox-node-org/ESPAsyncWebServer](https://github.com/yubox-node-org/ESPAsyncWebServer) and includes all the concurrency fixes. - -## Coordinate and dependencies: - -**WARNING** The library name was changed from `ESP Async WebServer` to `ESPAsyncWebServer` as per the Arduino Lint recommendations. - -``` -mathieucarbou/ESPAsyncWebServer @ 3.1.5 -``` - -Dependency: - -- **ESP32**: `mathieucarbou/AsyncTCP @ 3.2.4` (Arduino IDE: [https://github.com/mathieucarbou/AsyncTCP#v3.2.4](https://github.com/mathieucarbou/AsyncTCP/releases/tag/v3.2.0)) -- **ESP8266**: `esphome/ESPAsyncTCP-esphome @ 2.0.0` (Arduino IDE: [https://github.com/mathieucarbou/esphome-ESPAsyncTCP#v2.0.0](https://github.com/mathieucarbou/esphome-ESPAsyncTCP/releases/tag/v2.0.0)) -- **RP2040**: `khoih-prog/AsyncTCP_RP2040W @ 1.2.0` (Arduino IDE: [https://github.com/khoih-prog/AsyncTCP_RP2040W#v1.2.0](https://github.com/khoih-prog/AsyncTCP_RP2040W/releases/tag/v1.2.0)) - -## Changes in this fork - -- [@ayushsharma82](https://github.com/ayushsharma82) and [@mathieucarbou](https://github.com/mathieucarbou): Add RP2040 support ([#31](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/31)) -- [@mathieucarbou](https://github.com/mathieucarbou): `SSE_MAX_QUEUED_MESSAGES` to control the maximum number of messages that can be queued for a SSE client -- [@mathieucarbou](https://github.com/mathieucarbou): `write()` function public in `AsyncEventSource.h` -- [@mathieucarbou](https://github.com/mathieucarbou): `WS_MAX_QUEUED_MESSAGES`: control the maximum number of messages that can be queued for a Websocket client -- [@mathieucarbou](https://github.com/mathieucarbou): Added `setAuthentication(const String& username, const String& password)` -- [@mathieucarbou](https://github.com/mathieucarbou): Added `setCloseClientOnQueueFull(bool)` which can be set on a client to either close the connection or discard messages but not close the connection when the queue is full -- [@mathieucarbou](https://github.com/mathieucarbou): Added `StreamConcat` example to show how to stream multiple files in one response -- [@mathieucarbou](https://github.com/mathieucarbou): Added all flavors of `binary()`, `text()`, `binaryAll()` and `textAll()` in `AsyncWebSocket` -- [@mathieucarbou](https://github.com/mathieucarbou): Arduino 3 / ESP-IDF 5.1 compatibility -- [@mathieucarbou](https://github.com/mathieucarbou): Arduino Json 7 compatibility and backward compatible with 6 and 6 (changes in `AsyncJson.h`). The API to use Json has not changed. These are only internal changes. -- [@mathieucarbou](https://github.com/mathieucarbou): CI -- [@mathieucarbou](https://github.com/mathieucarbou): Depends on `mathieucarbou/AsyncTCP @ 3.2.4` -- [@mathieucarbou](https://github.com/mathieucarbou): Deployed in PlatformIO registry and Arduino IDE library manager -- [@mathieucarbou](https://github.com/mathieucarbou): Firmware size optimization: remove mbedtls dependency (accounts for 33KB in firmware) -- [@mathieucarbou](https://github.com/mathieucarbou): Made DEFAULT_MAX_SSE_CLIENTS customizable -- [@mathieucarbou](https://github.com/mathieucarbou): Made DEFAULT_MAX_WS_CLIENTS customizable -- [@mathieucarbou](https://github.com/mathieucarbou): MessagePack Support ([#62](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/62)) -- [@mathieucarbou](https://github.com/mathieucarbou): Remove filename after inline in Content-Disposition header according to RFC2183 -- [@mathieucarbou](https://github.com/mathieucarbou): Removed SPIFFSEditor to reduce library size and maintainance. SPIFF si also deprecated. If you need it, please copy the files from the original repository in your project. This fork focus on maintaining the server part and the SPIFFEditor is an application which has nothing to do inside a server library. -- [@mathieucarbou](https://github.com/mathieucarbou): Resurrected `AsyncWebSocketMessageBuffer` and `makeBuffer()` in order to make the fork API-compatible with the original library from me-no-dev regarding WebSocket. -- [@mathieucarbou](https://github.com/mathieucarbou): Some code cleanup -- [@mathieucarbou](https://github.com/mathieucarbou): Use `-D DEFAULT_MAX_WS_CLIENTS` to change the number of allows WebSocket clients and use `cleanupClients()` to help cleanup resources about dead clients -- [@nilo85](https://github.com/nilo85): Add support for Auth & GET requests in AsyncCallbackJsonWebHandler ([#14](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/14)) -- [@p0p-x](https://github.com/p0p-x): ESP IDF Compatibility (added back CMakeLists.txt) ([#32](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/32)) -- [@tueddy](https://github.com/tueddy): Compile with Arduino 3 (ESP-IDF 5.1) ([#13](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/13)) -- [@vortigont](https://github.com/vortigont): Set real "Last-Modified" header based on file's LastWrite time ([#5](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/5)) -- [@vortigont](https://github.com/vortigont): Some websocket code cleanup ([#29](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/29)) -- [@vortigont](https://github.com/vortigont): Refactor code - replace DYI structs with STL objects ([#39](https://github.com/mathieucarbou/ESPAsyncWebServer/pull/39)) - -## Documentation - -Usage and API stays the same as the original library. -Please look at the original libraries for more examples and documentation. - -- [https://github.com/me-no-dev/ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer) (original library) -- [https://github.com/yubox-node-org/ESPAsyncWebServer](https://github.com/yubox-node-org/ESPAsyncWebServer) (fork of the original library) - -## `AsyncWebSocketMessageBuffer` and `makeBuffer()` - -The fork from `yubox-node-org` introduces some breaking API changes compared to the original library, especially regarding the use of `std::shared_ptr>` for WebSocket. - -This fork is compatible with the original library from `me-no-dev` regarding WebSocket, and wraps the optimizations done by `yubox-node-org` in the `AsyncWebSocketMessageBuffer` class. -So you have the choice of which API to use. - -Here are examples for serializing a Json document in a websocket message buffer: - -```cpp -void send(JsonDocument& doc) { - const size_t len = measureJson(doc); - - // original API from me-no-dev - AsyncWebSocketMessageBuffer* buffer = _ws->makeBuffer(len); - assert(buffer); // up to you to keep or remove this - serializeJson(doc, buffer->get(), len); - _ws->textAll(buffer); -} -``` - -```cpp -void send(JsonDocument& doc) { - const size_t len = measureJson(doc); - - // this fork (originally from yubox-node-org), uses another API with shared pointer - auto buffer = std::make_shared>(len); - assert(buffer); // up to you to keep or remove this - serializeJson(doc, buffer->data(), len); - _ws->textAll(std::move(buffer)); -} -``` - -I recommend to use the official API `AsyncWebSocketMessageBuffer` to retain further compatibility. - -## Important recommendations - -Most of the crashes are caused by improper configuration of the library for the project. -Here are some recommendations to avoid them. - -1. Set the running core to be on the same core of your application (usually core 1) `-D CONFIG_ASYNC_TCP_RUNNING_CORE=1` -2. Set the stack size appropriately with `-D CONFIG_ASYNC_TCP_STACK_SIZE=16384`. - The default value of `16384` might be too much for your project. - You can look at the [MycilaTaskMonitor](https://oss.carbou.me/MycilaTaskMonitor) project to monitor the stack usage. -3. You can change **if you know what you are doing** the task priority with `-D CONFIG_ASYNC_TCP_PRIORITY=10`. - Default is `10`. -4. You can increase the queue size with `-D CONFIG_ASYNC_TCP_QUEUE_SIZE=128`. - Default is `64`. -5. You can decrease the maximum ack time `-D CONFIG_ASYNC_TCP_MAX_ACK_TIME=3000`. - Default is `5000`. - -I personally use the following configuration in my projects because my WS messages can be big (up to 4k). -If you have smaller messages, you can increase `WS_MAX_QUEUED_MESSAGES` to 128. - -```c++ - -D CONFIG_ASYNC_TCP_MAX_ACK_TIME=3000 - -D CONFIG_ASYNC_TCP_PRIORITY=10 - -D CONFIG_ASYNC_TCP_QUEUE_SIZE=128 - -D CONFIG_ASYNC_TCP_RUNNING_CORE=1 - -D CONFIG_ASYNC_TCP_STACK_SIZE=4096 - -D WS_MAX_QUEUED_MESSAGES=64 -``` diff --git a/lib/ESPAsyncWebServer/examples/CaptivePortal/CaptivePortal.ino b/lib/ESPAsyncWebServer/examples/CaptivePortal/CaptivePortal.ino deleted file mode 100644 index 2d0de89..0000000 --- a/lib/ESPAsyncWebServer/examples/CaptivePortal/CaptivePortal.ino +++ /dev/null @@ -1,57 +0,0 @@ -#include -#ifdef ESP32 - #include - #include -#elif defined(ESP8266) - #include - #include -#elif defined(TARGET_RP2040) - #include - #include -#endif -#include "ESPAsyncWebServer.h" - -DNSServer dnsServer; -AsyncWebServer server(80); - -class CaptiveRequestHandler : public AsyncWebHandler { - public: - CaptiveRequestHandler() {} - virtual ~CaptiveRequestHandler() {} - - bool canHandle(__unused AsyncWebServerRequest* request) { - // request->addInterestingHeader("ANY"); - return true; - } - - void handleRequest(AsyncWebServerRequest* request) { - AsyncResponseStream* response = request->beginResponseStream("text/html"); - response->print("Captive Portal"); - response->print("

This is out captive portal front page.

"); - response->printf("

You were trying to reach: http://%s%s

", request->host().c_str(), request->url().c_str()); - response->printf("

Try opening this link instead

", WiFi.softAPIP().toString().c_str()); - response->print(""); - request->send(response); - } -}; - -void setup() { - Serial.begin(115200); - Serial.println(); - Serial.println("Configuring access point..."); - - if (!WiFi.softAP("esp-captive")) { - Serial.println("Soft AP creation failed."); - while (1) - ; - } - - dnsServer.start(53, "*", WiFi.softAPIP()); - server.addHandler(new CaptiveRequestHandler()).setFilter(ON_AP_FILTER); // only when requested from AP - // more handlers... - server.begin(); -} - -void loop() { - dnsServer.processNextRequest(); -} diff --git a/lib/ESPAsyncWebServer/examples/Draft/Draft.ino b/lib/ESPAsyncWebServer/examples/Draft/Draft.ino deleted file mode 100644 index f10a9e7..0000000 --- a/lib/ESPAsyncWebServer/examples/Draft/Draft.ino +++ /dev/null @@ -1,37 +0,0 @@ -#include "mbedtls/md5.h" -#include -#include - -void setup() { - Serial.begin(115200); - delay(2000); - - const char* data = "Hello World"; - - { - uint8_t md5[16]; - mbedtls_md5_context _ctx; - mbedtls_md5_init(&_ctx); - mbedtls_md5_starts(&_ctx); - mbedtls_md5_update(&_ctx, (const unsigned char*)data, strlen(data)); - mbedtls_md5_finish(&_ctx, md5); - char output[33]; - for (int i = 0; i < 16; i++) { - sprintf_P(output + (i * 2), PSTR("%02x"), md5[i]); - } - Serial.println(String(output)); - } - - { - MD5Builder md5; - md5.begin(); - md5.add(data, strlen(data); - md5.calculate(); - char output[33]; - md5.getChars(output); - Serial.println(String(output)); - } -} - -void loop() { -} diff --git a/lib/ESPAsyncWebServer/examples/Filters/Filters.ino b/lib/ESPAsyncWebServer/examples/Filters/Filters.ino deleted file mode 100644 index f031a1f..0000000 --- a/lib/ESPAsyncWebServer/examples/Filters/Filters.ino +++ /dev/null @@ -1,111 +0,0 @@ -// Reproduced issue https://github.com/mathieucarbou/ESPAsyncWebServer/issues/26 - -#include -#ifdef ESP32 - #include - #include -#elif defined(ESP8266) - #include - #include -#elif defined(TARGET_RP2040) - #include - #include -#endif -#include "ESPAsyncWebServer.h" - -DNSServer dnsServer; -AsyncWebServer server(80); - -class CaptiveRequestHandler : public AsyncWebHandler { - public: - CaptiveRequestHandler() {} - virtual ~CaptiveRequestHandler() {} - - bool canHandle(__unused AsyncWebServerRequest* request) { - // request->addInterestingHeader("ANY"); - return true; - } - - void handleRequest(AsyncWebServerRequest* request) { - AsyncResponseStream* response = request->beginResponseStream("text/html"); - response->print("Captive Portal"); - response->print("

This is out captive portal front page.

"); - response->printf("

You were trying to reach: http://%s%s

", request->host().c_str(), request->url().c_str()); - response->printf("

Try opening this link instead

", WiFi.softAPIP().toString().c_str()); - response->print(""); - request->send(response); - } -}; - -bool hit1 = false; -bool hit2 = false; - -void setup() { - Serial.begin(115200); - - server - .on("/", HTTP_GET, [](AsyncWebServerRequest* request) { - Serial.println("Captive portal request..."); - Serial.println("WiFi.localIP(): " + WiFi.localIP().toString()); - Serial.println("request->client()->localIP(): " + request->client()->localIP().toString()); -#if ESP_IDF_VERSION_MAJOR >= 5 - Serial.println("WiFi.type(): " + String((int)WiFi.localIP().type())); - Serial.println("request->client()->type(): " + String((int)request->client()->localIP().type())); -#endif - Serial.println(WiFi.localIP() == request->client()->localIP() ? "should be: ON_STA_FILTER" : "should be: ON_AP_FILTER"); - Serial.println(WiFi.localIP() == request->client()->localIP()); - Serial.println(WiFi.localIP().toString() == request->client()->localIP().toString()); - request->send(200, "text/plain", "This is the captive portal"); - hit1 = true; - }) - .setFilter(ON_AP_FILTER); - - server - .on("/", HTTP_GET, [](AsyncWebServerRequest* request) { - Serial.println("Website request..."); - Serial.println("WiFi.localIP(): " + WiFi.localIP().toString()); - Serial.println("request->client()->localIP(): " + request->client()->localIP().toString()); -#if ESP_IDF_VERSION_MAJOR >= 5 - Serial.println("WiFi.type(): " + String((int)WiFi.localIP().type())); - Serial.println("request->client()->type(): " + String((int)request->client()->localIP().type())); -#endif - Serial.println(WiFi.localIP() == request->client()->localIP() ? "should be: ON_STA_FILTER" : "should be: ON_AP_FILTER"); - Serial.println(WiFi.localIP() == request->client()->localIP()); - Serial.println(WiFi.localIP().toString() == request->client()->localIP().toString()); - request->send(200, "text/plain", "This is the website"); - hit2 = true; - }) - .setFilter(ON_STA_FILTER); - - // assert(WiFi.softAP("esp-captive-portal")); - // dnsServer.start(53, "*", WiFi.softAPIP()); - // server.begin(); - // Serial.println("Captive portal started!"); - - // while (!hit1) { - // dnsServer.processNextRequest(); - // yield(); - // } - // delay(1000); // Wait for the client to process the response - - // Serial.println("Captive portal opened, stopping it and connecting to WiFi..."); - // dnsServer.stop(); - // WiFi.softAPdisconnect(); - - WiFi.persistent(false); - WiFi.begin("IoT"); - while (WiFi.status() != WL_CONNECTED) { - delay(500); - } - Serial.println("Connected to WiFi with IP address: " + WiFi.localIP().toString()); - server.begin(); - - // while (!hit2) { - // delay(10); - // } - // delay(1000); // Wait for the client to process the response - // ESP.restart(); -} - -void loop() { -} diff --git a/lib/ESPAsyncWebServer/examples/SimpleServer/SimpleServer.ino b/lib/ESPAsyncWebServer/examples/SimpleServer/SimpleServer.ino deleted file mode 100644 index f3a1605..0000000 --- a/lib/ESPAsyncWebServer/examples/SimpleServer/SimpleServer.ino +++ /dev/null @@ -1,134 +0,0 @@ -// -// A simple server implementation showing how to: -// * serve static messages -// * read GET and POST parameters -// * handle missing pages / 404s -// - -#include -#ifdef ESP32 - #include - #include -#elif defined(ESP8266) - #include - #include -#elif defined(TARGET_RP2040) - #include - #include -#endif - -#include - -#include -#include -#include - -AsyncWebServer server(80); - -const char* PARAM_MESSAGE = "message"; - -void notFound(AsyncWebServerRequest* request) { - request->send(404, "text/plain", "Not found"); -} - -AsyncCallbackJsonWebHandler* jsonHandler = new AsyncCallbackJsonWebHandler("/json2"); -AsyncCallbackMessagePackWebHandler* msgPackHandler = new AsyncCallbackMessagePackWebHandler("/msgpack2"); - -void setup() { - - Serial.begin(115200); - - // WiFi.mode(WIFI_STA); - // WiFi.begin("YOUR_SSID", "YOUR_PASSWORD"); - // if (WiFi.waitForConnectResult() != WL_CONNECTED) { - // Serial.printf("WiFi Failed!\n"); - // return; - // } - // Serial.print("IP Address: "); - // Serial.println(WiFi.localIP()); - - WiFi.mode(WIFI_AP); - WiFi.softAP("esp-captive"); - - server.on("/", HTTP_GET, [](AsyncWebServerRequest* request) { - request->send(200, "text/plain", "Hello, world"); - }); - - // Send a GET request to /get?message= - server.on("/get", HTTP_GET, [](AsyncWebServerRequest* request) { - String message; - if (request->hasParam(PARAM_MESSAGE)) { - message = request->getParam(PARAM_MESSAGE)->value(); - } else { - message = "No message sent"; - } - request->send(200, "text/plain", "Hello, GET: " + message); - }); - - // Send a POST request to /post with a form field message set to - server.on("/post", HTTP_POST, [](AsyncWebServerRequest* request) { - String message; - if (request->hasParam(PARAM_MESSAGE, true)) { - message = request->getParam(PARAM_MESSAGE, true)->value(); - } else { - message = "No message sent"; - } - request->send(200, "text/plain", "Hello, POST: " + message); - }); - - // JSON - - // receives JSON and sends JSON - jsonHandler->onRequest([](AsyncWebServerRequest* request, JsonVariant& json) { - JsonObject jsonObj = json.as(); - // ... - - AsyncJsonResponse* response = new AsyncJsonResponse(); - JsonObject root = response->getRoot().to(); - root["hello"] = "world"; - response->setLength(); - request->send(response); - }); - - // sends JSON - server.on("/json1", HTTP_GET, [](AsyncWebServerRequest* request) { - AsyncJsonResponse* response = new AsyncJsonResponse(); - JsonObject root = response->getRoot().to(); - root["hello"] = "world"; - response->setLength(); - request->send(response); - }); - - // MessagePack - - // receives MessagePack and sends MessagePack - msgPackHandler->onRequest([](AsyncWebServerRequest* request, JsonVariant& json) { - JsonObject jsonObj = json.as(); - // ... - - AsyncMessagePackResponse* response = new AsyncMessagePackResponse(); - JsonObject root = response->getRoot().to(); - root["hello"] = "world"; - response->setLength(); - request->send(response); - }); - - // sends MessagePack - server.on("/msgpack1", HTTP_GET, [](AsyncWebServerRequest* request) { - AsyncMessagePackResponse* response = new AsyncMessagePackResponse(); - JsonObject root = response->getRoot().to(); - root["hello"] = "world"; - response->setLength(); - request->send(response); - }); - - server.addHandler(jsonHandler); - server.addHandler(msgPackHandler); - - server.onNotFound(notFound); - - server.begin(); -} - -void loop() { -} \ No newline at end of file diff --git a/lib/ESPAsyncWebServer/examples/StreamFiles/StreamConcat.h b/lib/ESPAsyncWebServer/examples/StreamFiles/StreamConcat.h deleted file mode 100644 index c1e1927..0000000 --- a/lib/ESPAsyncWebServer/examples/StreamFiles/StreamConcat.h +++ /dev/null @@ -1,37 +0,0 @@ -#pragma once - -#include - -class StreamConcat : public Stream { - public: - StreamConcat(Stream* s1, Stream* s2) : _s1(s1), _s2(s2) {} - - size_t write(__unused const uint8_t* p, __unused size_t n) override { return 0; } - size_t write(__unused uint8_t c) override { return 0; } - void flush() override {} - - int available() override { return _s1->available() + _s2->available(); } - - int read() override { - int c = _s1->read(); - return c != -1 ? c : _s2->read(); - } - -#if defined(TARGET_RP2040) - size_t readBytes(char* buffer, size_t length) { -#else - size_t readBytes(char* buffer, size_t length) override { -#endif - size_t count = _s1->readBytes(buffer, length); - return count > 0 ? count : _s2->readBytes(buffer, length); - } - - int peek() override { - int c = _s1->peek(); - return c != -1 ? c : _s2->peek(); - } - - private: - Stream* _s1; - Stream* _s2; -}; diff --git a/lib/ESPAsyncWebServer/examples/StreamFiles/StreamFiles.ino b/lib/ESPAsyncWebServer/examples/StreamFiles/StreamFiles.ino deleted file mode 100644 index 2a2c1b6..0000000 --- a/lib/ESPAsyncWebServer/examples/StreamFiles/StreamFiles.ino +++ /dev/null @@ -1,84 +0,0 @@ -#include -#include -#ifdef ESP32 - #include - #include -#elif defined(ESP8266) - #include - #include -#elif defined(TARGET_RP2040) - #include - #include -#endif -#include "StreamConcat.h" -#include "StreamString.h" -#include -#include - -DNSServer dnsServer; -AsyncWebServer server(80); - -void setup() { - Serial.begin(115200); - - LittleFS.begin(); - - WiFi.mode(WIFI_AP); - WiFi.softAP("esp-captive"); - dnsServer.start(53, "*", WiFi.softAPIP()); - - File file1 = LittleFS.open("/header.html", "w"); - file1.print("ESP Captive Portal"); - file1.close(); - - File file2 = LittleFS.open("/body.html", "w"); - file2.print("

Welcome to ESP Captive Portal

"); - file2.close(); - - File file3 = LittleFS.open("/footer.html", "w"); - file3.print(""); - file3.close(); - - server.on("/", HTTP_GET, [](AsyncWebServerRequest* request) { - File header = LittleFS.open("/header.html", "r"); - File body = LittleFS.open("/body.html", "r"); - StreamConcat stream1(&header, &body); - - StreamString content; -#if defined(TARGET_RP2040) - content.printf("FreeHeap: %d", rp2040.getFreeHeap()); -#else - content.printf("FreeHeap: %" PRIu32, ESP.getFreeHeap()); -#endif - StreamConcat stream2 = StreamConcat(&stream1, &content); - - File footer = LittleFS.open("/footer.html", "r"); - StreamConcat stream3 = StreamConcat(&stream2, &footer); - - request->send(stream3, "text/html", stream3.available()); - header.close(); - body.close(); - footer.close(); - }); - - server.onNotFound([](AsyncWebServerRequest* request) { - request->send(404, "text/plain", "Not found"); - }); - - server.begin(); -} - -uint32_t last = 0; - -void loop() { - // dnsServer.processNextRequest(); - - if (millis() - last > 2000) { -#if defined(TARGET_RP2040) - Serial.printf("FreeHeap: %d", rp2040.getFreeHeap()); -#else - Serial.printf("FreeHeap: %" PRIu32, ESP.getFreeHeap()); -#endif - last = millis(); - } -} \ No newline at end of file diff --git a/lib/ESPAsyncWebServer/examples/StreamFiles/StreamString.h b/lib/ESPAsyncWebServer/examples/StreamFiles/StreamString.h deleted file mode 100644 index a6e0655..0000000 --- a/lib/ESPAsyncWebServer/examples/StreamFiles/StreamString.h +++ /dev/null @@ -1,40 +0,0 @@ -#pragma once - -#include - -class StreamString : public Stream { - public: - size_t write(const uint8_t* p, size_t n) override { return _buffer.concat(reinterpret_cast(p), n) ? n : 0; } - size_t write(uint8_t c) override { return _buffer.concat(static_cast(c)) ? 1 : 0; } - void flush() override {} - - int available() override { return static_cast(_buffer.length()); } - - int read() override { - if (_buffer.length() == 0) - return -1; - char c = _buffer[0]; - _buffer.remove(0, 1); - return c; - } - -#if defined(TARGET_RP2040) - size_t readBytes(char* buffer, size_t length) { -#else - size_t readBytes(char* buffer, size_t length) override { -#endif - if (length > _buffer.length()) - length = _buffer.length(); - // Don't use _str.ToCharArray() because it inserts a terminator - memcpy(buffer, _buffer.c_str(), length); - _buffer.remove(0, static_cast(length)); - return length; - } - - int peek() override { return _buffer.length() > 0 ? _buffer[0] : -1; } - - const String& buffer() const { return _buffer; } - - private: - String _buffer; -}; diff --git a/lib/ESPAsyncWebServer/examples/issues/Issue14/Issue14.ino b/lib/ESPAsyncWebServer/examples/issues/Issue14/Issue14.ino deleted file mode 100644 index f62084a..0000000 --- a/lib/ESPAsyncWebServer/examples/issues/Issue14/Issue14.ino +++ /dev/null @@ -1,107 +0,0 @@ -#include -#ifdef ESP32 - #include - #include -#elif defined(ESP8266) - #include - #include -#elif defined(TARGET_RP2040) - #include - #include -#endif - -#include "ESPAsyncWebServer.h" - -const char appWebPage[] PROGMEM = R"rawliteral( - - - - -)rawliteral"; - -AsyncWebServer server(80); -AsyncEventSource events("/events"); - -const uint32_t interval = 1000; -const int button1Pin = 4; - -uint32_t lastSend = 0; - -void prepareJson(String& buffer) { - buffer.reserve(512); - buffer.concat("{\"button1\":"); - buffer.concat(digitalRead(button1Pin) == LOW); - buffer.concat(",\"1234567890abcdefghij1234567890abcdefghij1234567890abcdefghij1234567890abcdefghij1234567890abcdefghij1234567890abcdefghij\":"); - buffer.concat(random(0, 999999999)); - buffer.concat("}"); -} - -void setup() { - Serial.begin(115200); -#if ARDUINO_USB_CDC_ON_BOOT - Serial.setTxTimeoutMs(0); - delay(100); -#else - while (!Serial) - yield(); -#endif - - randomSeed(micros()); - - pinMode(button1Pin, OUTPUT); - digitalWrite(button1Pin, HIGH); - - WiFi.softAP("esp-captive"); - - server.on("/", HTTP_GET, [](AsyncWebServerRequest* request) { - request->send(200, "text/html", appWebPage); - }); - - server.on("/button1", HTTP_GET, [](AsyncWebServerRequest* request) { - request->send(200, "text/plain", "OK"); - digitalWrite(button1Pin, digitalRead(button1Pin) == LOW ? HIGH : LOW); - - String buffer; - prepareJson(buffer); - ESP_LOGI("async_tcp", "Sending from handler..."); - events.send(buffer.c_str(), "state", millis()); - ESP_LOGI("async_tcp", "Sent from handler!"); - }); - - events.onConnect([](AsyncEventSourceClient* client) { - String buffer; - prepareJson(buffer); - ESP_LOGI("async_tcp", "Sending from onConnect..."); - client->send(buffer.c_str(), "state", millis(), 5000); - ESP_LOGI("async_tcp", "Sent from onConnect!"); - }); - - server.addHandler(&events); - DefaultHeaders::Instance().addHeader("Access-Control-Allow-Origin", "*"); - - server.begin(); -} - -void loop() { - if (millis() - lastSend >= interval) { - String buffer; - prepareJson(buffer); - ESP_LOGI("loop", "Sending..."); - events.send(buffer.c_str(), "state", millis()); - ESP_LOGI("loop", "Sent!"); - lastSend = millis(); - } -} diff --git a/lib/ESPAsyncWebServer/library.json b/lib/ESPAsyncWebServer/library.json deleted file mode 100644 index eb946c6..0000000 --- a/lib/ESPAsyncWebServer/library.json +++ /dev/null @@ -1,64 +0,0 @@ -{ - "name": "ESPAsyncWebServer", - "version": "3.1.5", - "description": "Asynchronous HTTP and WebSocket Server Library for ESP32, ESP8266 and RP2040. Supports: WebSocket, SSE, Authentication, Arduino Json 7, File Upload, Static File serving, URL Rewrite, URL Redirect, etc.", - "keywords": "http,async,websocket,webserver", - "homepage": "https://github.com/mathieucarbou/ESPAsyncWebServer", - "repository": { - "type": "git", - "url": "https://github.com/mathieucarbou/ESPAsyncWebServer.git" - }, - "authors": [ - { - "name": "Hristo Gochkov" - }, - { - "name": "Mathieu Carbou", - "maintainer": true - } - ], - "license": "LGPL-3.0", - "frameworks": "arduino", - "platforms": [ - "espressif32", - "espressif8266", - "raspberrypi" - ], - "dependencies": [ - { - "owner": "mathieucarbou", - "name": "AsyncTCP", - "version": "^3.2.4", - "platforms": "espressif32" - }, - { - "owner": "esphome", - "name": "ESPAsyncTCP-esphome", - "version": "^2.0.0", - "platforms": "espressif8266" - }, - { - "name": "Hash", - "platforms": "espressif8266" - }, - { - "owner": "khoih-prog", - "name": "AsyncTCP_RP2040W", - "version": "^1.2.0", - "platforms": "raspberrypi" - } - ], - "export": { - "include": [ - "examples", - "src", - "library.json", - "library.properties", - "LICENSE", - "README.md" - ] - }, - "build": { - "libCompatMode": "strict" - } -} \ No newline at end of file diff --git a/lib/ESPAsyncWebServer/library.properties b/lib/ESPAsyncWebServer/library.properties deleted file mode 100644 index 3036044..0000000 --- a/lib/ESPAsyncWebServer/library.properties +++ /dev/null @@ -1,10 +0,0 @@ -name=ESPAsyncWebServer -version=3.1.5 -author=Me-No-Dev -maintainer=Mathieu Carbou -sentence=Asynchronous HTTP and WebSocket Server Library for ESP32, ESP8266 and RP2040 -paragraph=Supports: WebSocket, SSE, Authentication, Arduino Json 7, File Upload, Static File serving, URL Rewrite, URL Redirect, etc -category=Other -url=https://github.com/mathieucarbou/ESPAsyncWebServer -architectures=* -license=LGPL-3.0 diff --git a/lib/ESPAsyncWebServer/platformio.ini b/lib/ESPAsyncWebServer/platformio.ini deleted file mode 100644 index 6f68d0d..0000000 --- a/lib/ESPAsyncWebServer/platformio.ini +++ /dev/null @@ -1,80 +0,0 @@ -[env] -framework = arduino -build_flags = - -Wall -Wextra - -D CONFIG_ARDUHAL_LOG_COLORS - -D CORE_DEBUG_LEVEL=ARDUHAL_LOG_LEVEL_VERBOSE - -D CONFIG_ASYNC_TCP_MAX_ACK_TIME=3000 - -D CONFIG_ASYNC_TCP_PRIORITY=10 - -D CONFIG_ASYNC_TCP_QUEUE_SIZE=128 - -D CONFIG_ASYNC_TCP_RUNNING_CORE=1 - -D CONFIG_ASYNC_TCP_STACK_SIZE=4096 -upload_protocol = esptool -monitor_speed = 115200 -monitor_filters = esp32_exception_decoder, log2file - -[platformio] -lib_dir = . -; src_dir = examples/CaptivePortal -src_dir = examples/SimpleServer -; src_dir = examples/StreamFiles -; src_dir = examples/Filters -; src_dir = examples/Draft -; src_dir = examples/issues/Issue14 - -[env:arduino] -platform = espressif32 -board = esp32dev -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - mathieucarbou/AsyncTCP @ 3.2.4 - -[env:arduino-2] -platform = espressif32@6.8.1 -board = esp32dev -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - mathieucarbou/AsyncTCP @ 3.2.4 - -[env:arduino-3] -platform = espressif32 -platform_packages= - platformio/framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32.git#3.0.4 - platformio/framework-arduinoespressif32-libs @ https://github.com/espressif/arduino-esp32/releases/download/3.0.4/esp32-arduino-libs-3.0.4.zip -board = esp32dev -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - mathieucarbou/AsyncTCP @ 3.2.4 - -[env:esp8266] -platform = espressif8266 -board = huzzah -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - esphome/ESPAsyncTCP-esphome @ 2.0.0 - -; PlatformIO support for Raspberry Pi Pico is not official -; https://github.com/platformio/platform-raspberrypi/pull/36 -; https://github.com/earlephilhower/arduino-pico/blob/master/docs/platformio.rst -; board settings: https://github.com/earlephilhower/arduino-pico/blob/master/tools/json/rpipico.json -[env:rpipicow] -upload_protocol = picotool -platform = https://github.com/maxgerhardt/platform-raspberrypi.git -board = rpipicow -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - khoih-prog/AsyncTCP_RP2040W @ 1.2.0 - -[env:pioarduino-esp32dev] -platform = https://github.com/pioarduino/platform-espressif32/releases/download/51.03.04/platform-espressif32.zip -board = esp32dev -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - mathieucarbou/AsyncTCP @ 3.2.4 - -[env:pioarduino-c6] -platform = https://github.com/pioarduino/platform-espressif32/releases/download/51.03.04/platform-espressif32.zip -board = esp32-c6-devkitc-1 -lib_deps = - bblanchon/ArduinoJson @ 7.1.0 - mathieucarbou/AsyncTCP @ 3.2.4 diff --git a/lib/ESPAsyncWebServer/src/AsyncEventSource.cpp b/lib/ESPAsyncWebServer/src/AsyncEventSource.cpp deleted file mode 100644 index 639fd56..0000000 --- a/lib/ESPAsyncWebServer/src/AsyncEventSource.cpp +++ /dev/null @@ -1,405 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "Arduino.h" -#if defined(ESP32) - #include -#endif -#include "AsyncEventSource.h" -#include "literals.h" - -using namespace asyncsrv; - -static String generateEventMessage(const char* message, const char* event, uint32_t id, uint32_t reconnect) { - String ev; - - if (reconnect) { - ev += T_retry_; - ev += reconnect; - ev += T_rn; - } - - if (id) { - ev += T_id__; - ev += id; - ev += T_rn; - } - - if (event != NULL) { - ev += T_event_; - ev += event; - ev += T_rn; - } - - if (message != NULL) { - size_t messageLen = strlen(message); - char* lineStart = (char*)message; - char* lineEnd; - do { - char* nextN = strchr(lineStart, '\n'); - char* nextR = strchr(lineStart, '\r'); - if (nextN == NULL && nextR == NULL) { - size_t llen = ((char*)message + messageLen) - lineStart; - char* ldata = (char*)malloc(llen + 1); - if (ldata != NULL) { - memcpy(ldata, lineStart, llen); - ldata[llen] = 0; - ev += T_data_; - ev += ldata; - ev += T_rnrn; - free(ldata); - } - lineStart = (char*)message + messageLen; - } else { - char* nextLine = NULL; - if (nextN != NULL && nextR != NULL) { - if (nextR < nextN) { - lineEnd = nextR; - if (nextN == (nextR + 1)) - nextLine = nextN + 1; - else - nextLine = nextR + 1; - } else { - lineEnd = nextN; - if (nextR == (nextN + 1)) - nextLine = nextR + 1; - else - nextLine = nextN + 1; - } - } else if (nextN != NULL) { - lineEnd = nextN; - nextLine = nextN + 1; - } else { - lineEnd = nextR; - nextLine = nextR + 1; - } - - size_t llen = lineEnd - lineStart; - char* ldata = (char*)malloc(llen + 1); - if (ldata != NULL) { - memcpy(ldata, lineStart, llen); - ldata[llen] = 0; - ev += T_data_; - ev += ldata; - ev += T_rn; - free(ldata); - } - lineStart = nextLine; - if (lineStart == ((char*)message + messageLen)) - ev += T_rn; - } - } while (lineStart < ((char*)message + messageLen)); - } - - return ev; -} - -// Message - -AsyncEventSourceMessage::AsyncEventSourceMessage(const char* data, size_t len) - : _data(nullptr), _len(len), _sent(0), _acked(0) { - _data = (uint8_t*)malloc(_len + 1); - if (_data == nullptr) { - _len = 0; - } else { - memcpy(_data, data, len); - _data[_len] = 0; - } -} - -AsyncEventSourceMessage::~AsyncEventSourceMessage() { - if (_data != NULL) - free(_data); -} - -size_t AsyncEventSourceMessage::ack(size_t len, uint32_t time) { - (void)time; - // If the whole message is now acked... - if (_acked + len > _len) { - // Return the number of extra bytes acked (they will be carried on to the next message) - const size_t extra = _acked + len - _len; - _acked = _len; - return extra; - } - // Return that no extra bytes left. - _acked += len; - return 0; -} - -// This could also return void as the return value is not used. -// Leaving as-is for compatibility... -size_t AsyncEventSourceMessage::send(AsyncClient* client) { - if (_sent >= _len) { - return 0; - } - const size_t len_to_send = _len - _sent; - auto position = reinterpret_cast(_data + _sent); - const size_t sent_now = client->write(position, len_to_send); - _sent += sent_now; - return sent_now; -} - -// Client - -AsyncEventSourceClient::AsyncEventSourceClient(AsyncWebServerRequest* request, AsyncEventSource* server) { - _client = request->client(); - _server = server; - _lastId = 0; - if (request->hasHeader(T_Last_Event_ID)) - _lastId = atoi(request->getHeader(T_Last_Event_ID)->value().c_str()); - - _client->setRxTimeout(0); - _client->onError(NULL, NULL); - _client->onAck([](void* r, AsyncClient* c, size_t len, uint32_t time) { (void)c; ((AsyncEventSourceClient*)(r))->_onAck(len, time); }, this); - _client->onPoll([](void* r, AsyncClient* c) { (void)c; ((AsyncEventSourceClient*)(r))->_onPoll(); }, this); - _client->onData(NULL, NULL); - _client->onTimeout([this](void* r, AsyncClient* c __attribute__((unused)), uint32_t time) { ((AsyncEventSourceClient*)(r))->_onTimeout(time); }, this); - _client->onDisconnect([this](void* r, AsyncClient* c) { ((AsyncEventSourceClient*)(r))->_onDisconnect(); delete c; }, this); - - _server->_addClient(this); - delete request; -} - -AsyncEventSourceClient::~AsyncEventSourceClient() { -#ifdef ESP32 - std::lock_guard lock(_lockmq); -#endif - _messageQueue.clear(); - close(); -} - -void AsyncEventSourceClient::_queueMessage(const char* message, size_t len) { -#ifdef ESP32 - // length() is not thread-safe, thus acquiring the lock before this call.. - std::lock_guard lock(_lockmq); -#endif - - if (_messageQueue.size() >= SSE_MAX_QUEUED_MESSAGES) { -#ifdef ESP8266 - ets_printf(String(F("ERROR: Too many messages queued\n")).c_str()); -#elif defined(ESP32) - log_e("Too many messages queued: deleting message"); -#endif - return; - } - - _messageQueue.emplace_back(message, len); - // runqueue trigger when new messages added - if (_client->canSend()) { - _runQueue(); - } -} - -void AsyncEventSourceClient::_onAck(size_t len, uint32_t time) { -#ifdef ESP32 - // Same here, acquiring the lock early - std::lock_guard lock(_lockmq); -#endif - while (len && _messageQueue.size()) { - len = _messageQueue.front().ack(len, time); - if (_messageQueue.front().finished()) - _messageQueue.pop_front(); - } - _runQueue(); -} - -void AsyncEventSourceClient::_onPoll() { -#ifdef ESP32 - // Same here, acquiring the lock early - std::lock_guard lock(_lockmq); -#endif - if (_messageQueue.size()) { - _runQueue(); - } -} - -void AsyncEventSourceClient::_onTimeout(uint32_t time __attribute__((unused))) { - _client->close(true); -} - -void AsyncEventSourceClient::_onDisconnect() { - _client = NULL; - _server->_handleDisconnect(this); -} - -void AsyncEventSourceClient::close() { - if (_client != NULL) - _client->close(); -} - -void AsyncEventSourceClient::write(const char* message, size_t len) { - if (!connected()) - return; - _queueMessage(message, len); -} - -void AsyncEventSourceClient::send(const char* message, const char* event, uint32_t id, uint32_t reconnect) { - if (!connected()) - return; - String ev = generateEventMessage(message, event, id, reconnect); - _queueMessage(ev.c_str(), ev.length()); -} - -size_t AsyncEventSourceClient::packetsWaiting() const { -#ifdef ESP32 - std::lock_guard lock(_lockmq); -#endif - return _messageQueue.size(); -} - -void AsyncEventSourceClient::_runQueue() { - // Calls to this private method now already protected by _lockmq acquisition - // so no extra call of _lockmq.lock() here.. - for (auto& i : _messageQueue) { - if (!i.sent()) - i.send(_client); - } -} - -// Handler -void AsyncEventSource::onConnect(ArEventHandlerFunction cb) { - _connectcb = cb; -} - -void AsyncEventSource::authorizeConnect(ArAuthorizeConnectHandler cb) { - _authorizeConnectHandler = cb; -} - -void AsyncEventSource::_addClient(AsyncEventSourceClient* client) { - if (!client) - return; -#ifdef ESP32 - std::lock_guard lock(_client_queue_lock); -#endif - _clients.emplace_back(client); - if (_connectcb) - _connectcb(client); -} - -void AsyncEventSource::_handleDisconnect(AsyncEventSourceClient* client) { -#ifdef ESP32 - std::lock_guard lock(_client_queue_lock); -#endif - for (auto i = _clients.begin(); i != _clients.end(); ++i) { - if (i->get() == client) - _clients.erase(i); - } -} - -void AsyncEventSource::close() { - // While the whole loop is not done, the linked list is locked and so the - // iterator should remain valid even when AsyncEventSource::_handleDisconnect() - // is called very early -#ifdef ESP32 - std::lock_guard lock(_client_queue_lock); -#endif - for (const auto& c : _clients) { - if (c->connected()) - c->close(); - } -} - -// pmb fix -size_t AsyncEventSource::avgPacketsWaiting() const { - size_t aql = 0; - uint32_t nConnectedClients = 0; -#ifdef ESP32 - std::lock_guard lock(_client_queue_lock); -#endif - if (!_clients.size()) - return 0; - - for (const auto& c : _clients) { - if (c->connected()) { - aql += c->packetsWaiting(); - ++nConnectedClients; - } - } - return ((aql) + (nConnectedClients / 2)) / (nConnectedClients); // round up -} - -void AsyncEventSource::send( - const char* message, const char* event, uint32_t id, uint32_t reconnect) { - String ev = generateEventMessage(message, event, id, reconnect); -#ifdef ESP32 - std::lock_guard lock(_client_queue_lock); -#endif - for (const auto& c : _clients) { - if (c->connected()) { - c->write(ev.c_str(), ev.length()); - } - } -} - -size_t AsyncEventSource::count() const { -#ifdef ESP32 - std::lock_guard lock(_client_queue_lock); -#endif - size_t n_clients{0}; - for (const auto& i : _clients) - if (i->connected()) - ++n_clients; - - return n_clients; -} - -bool AsyncEventSource::canHandle(AsyncWebServerRequest* request) { - if (request->method() != HTTP_GET || !request->url().equals(_url)) { - return false; - } - request->addInterestingHeader(T_Last_Event_ID); - request->addInterestingHeader(T_Cookie); - return true; -} - -void AsyncEventSource::handleRequest(AsyncWebServerRequest* request) { - if ((_username.length() && _password.length()) && !request->authenticate(_username.c_str(), _password.c_str())) { - return request->requestAuthentication(); - } - if (_authorizeConnectHandler != NULL) { - if (!_authorizeConnectHandler(request)) { - return request->send(401); - } - } - request->send(new AsyncEventSourceResponse(this)); -} - -// Response - -AsyncEventSourceResponse::AsyncEventSourceResponse(AsyncEventSource* server) { - _server = server; - _code = 200; - _contentType = T_text_event_stream; - _sendContentLength = false; - addHeader(T_Cache_Control, T_no_cache); - addHeader(T_Connection, T_keep_alive); -} - -void AsyncEventSourceResponse::_respond(AsyncWebServerRequest* request) { - String out = _assembleHead(request->version()); - request->client()->write(out.c_str(), _headLength); - _state = RESPONSE_WAIT_ACK; -} - -size_t AsyncEventSourceResponse::_ack(AsyncWebServerRequest* request, size_t len, uint32_t time __attribute__((unused))) { - if (len) { - new AsyncEventSourceClient(request, _server); - } - return 0; -} diff --git a/lib/ESPAsyncWebServer/src/AsyncEventSource.h b/lib/ESPAsyncWebServer/src/AsyncEventSource.h deleted file mode 100644 index 0289ebf..0000000 --- a/lib/ESPAsyncWebServer/src/AsyncEventSource.h +++ /dev/null @@ -1,158 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#ifndef ASYNCEVENTSOURCE_H_ -#define ASYNCEVENTSOURCE_H_ - -#include -#include -#ifdef ESP32 - #include - #include - #ifndef SSE_MAX_QUEUED_MESSAGES - #define SSE_MAX_QUEUED_MESSAGES 32 - #endif -#elif defined(ESP8266) - #include - #ifndef SSE_MAX_QUEUED_MESSAGES - #define SSE_MAX_QUEUED_MESSAGES 8 - #endif -#elif defined(TARGET_RP2040) - #include - #ifndef SSE_MAX_QUEUED_MESSAGES - #define SSE_MAX_QUEUED_MESSAGES 32 - #endif -#endif - -#include - -#ifdef ESP8266 - #include - #ifdef CRYPTO_HASH_h // include Hash.h from espressif framework if the first include was from the crypto library - #include <../src/Hash.h> - #endif -#endif - -#ifndef DEFAULT_MAX_SSE_CLIENTS - #ifdef ESP32 - #define DEFAULT_MAX_SSE_CLIENTS 8 - #else - #define DEFAULT_MAX_SSE_CLIENTS 4 - #endif -#endif - -class AsyncEventSource; -class AsyncEventSourceResponse; -class AsyncEventSourceClient; -using ArEventHandlerFunction = std::function; -using ArAuthorizeConnectHandler = std::function; - -class AsyncEventSourceMessage { - private: - uint8_t* _data; - size_t _len; - size_t _sent; - // size_t _ack; - size_t _acked; - - public: - AsyncEventSourceMessage(const char* data, size_t len); - ~AsyncEventSourceMessage(); - size_t ack(size_t len, uint32_t time __attribute__((unused))); - size_t send(AsyncClient* client); - bool finished() { return _acked == _len; } - bool sent() { return _sent == _len; } -}; - -class AsyncEventSourceClient { - private: - AsyncClient* _client; - AsyncEventSource* _server; - uint32_t _lastId; - std::list _messageQueue; -#ifdef ESP32 - mutable std::mutex _lockmq; -#endif - void _queueMessage(const char* message, size_t len); - void _runQueue(); - - public: - AsyncEventSourceClient(AsyncWebServerRequest* request, AsyncEventSource* server); - ~AsyncEventSourceClient(); - - AsyncClient* client() { return _client; } - void close(); - void write(const char* message, size_t len); - void send(const char* message, const char* event = NULL, uint32_t id = 0, uint32_t reconnect = 0); - bool connected() const { return (_client != NULL) && _client->connected(); } - uint32_t lastId() const { return _lastId; } - size_t packetsWaiting() const; - - // system callbacks (do not call) - void _onAck(size_t len, uint32_t time); - void _onPoll(); - void _onTimeout(uint32_t time); - void _onDisconnect(); -}; - -class AsyncEventSource : public AsyncWebHandler { - private: - String _url; - std::list> _clients; -#ifdef ESP32 - // Same as for individual messages, protect mutations of _clients list - // since simultaneous access from different tasks is possible - mutable std::mutex _client_queue_lock; -#endif - ArEventHandlerFunction _connectcb{nullptr}; - ArAuthorizeConnectHandler _authorizeConnectHandler; - - public: - AsyncEventSource(const String& url) : _url(url){}; - ~AsyncEventSource() { close(); }; - - const char* url() const { return _url.c_str(); } - void close(); - void onConnect(ArEventHandlerFunction cb); - void authorizeConnect(ArAuthorizeConnectHandler cb); - void send(const char* message, const char* event = NULL, uint32_t id = 0, uint32_t reconnect = 0); - // number of clients connected - size_t count() const; - size_t avgPacketsWaiting() const; - - // system callbacks (do not call) - void _addClient(AsyncEventSourceClient* client); - void _handleDisconnect(AsyncEventSourceClient* client); - virtual bool canHandle(AsyncWebServerRequest* request) override final; - virtual void handleRequest(AsyncWebServerRequest* request) override final; -}; - -class AsyncEventSourceResponse : public AsyncWebServerResponse { - private: - String _content; - AsyncEventSource* _server; - - public: - AsyncEventSourceResponse(AsyncEventSource* server); - void _respond(AsyncWebServerRequest* request); - size_t _ack(AsyncWebServerRequest* request, size_t len, uint32_t time); - bool _sourceValid() const { return true; } -}; - -#endif /* ASYNCEVENTSOURCE_H_ */ diff --git a/lib/ESPAsyncWebServer/src/AsyncJson.h b/lib/ESPAsyncWebServer/src/AsyncJson.h deleted file mode 100644 index bca3f24..0000000 --- a/lib/ESPAsyncWebServer/src/AsyncJson.h +++ /dev/null @@ -1,255 +0,0 @@ -// AsyncJson.h -/* - Async Response to use with ArduinoJson and AsyncWebServer - Written by Andrew Melvin (SticilFace) with help from me-no-dev and BBlanchon. - - Example of callback in use - - server.on("/json", HTTP_ANY, [](AsyncWebServerRequest * request) { - - AsyncJsonResponse * response = new AsyncJsonResponse(); - JsonObject& root = response->getRoot(); - root["key1"] = "key number one"; - JsonObject& nested = root.createNestedObject("nested"); - nested["key1"] = "key number one"; - - response->setLength(); - request->send(response); - }); - - -------------------- - - Async Request to use with ArduinoJson and AsyncWebServer - Written by Arsène von Wyss (avonwyss) - - Example - - AsyncCallbackJsonWebHandler* handler = new AsyncCallbackJsonWebHandler("/rest/endpoint"); - handler->onRequest([](AsyncWebServerRequest *request, JsonVariant &json) { - JsonObject jsonObj = json.as(); - // ... - }); - server.addHandler(handler); - -*/ -#ifndef ASYNC_JSON_H_ -#define ASYNC_JSON_H_ -#include -#include - -#include "ChunkPrint.h" - -#if ARDUINOJSON_VERSION_MAJOR == 6 - #ifndef DYNAMIC_JSON_DOCUMENT_SIZE - #define DYNAMIC_JSON_DOCUMENT_SIZE 1024 - #endif -#endif - -constexpr const char* JSON_MIMETYPE = "application/json"; - -/* - * Json Response - * */ - -class AsyncJsonResponse : public AsyncAbstractResponse { - protected: -#if ARDUINOJSON_VERSION_MAJOR == 5 - DynamicJsonBuffer _jsonBuffer; -#elif ARDUINOJSON_VERSION_MAJOR == 6 - DynamicJsonDocument _jsonBuffer; -#else - JsonDocument _jsonBuffer; -#endif - - JsonVariant _root; - bool _isValid; - - public: -#if ARDUINOJSON_VERSION_MAJOR == 5 - AsyncJsonResponse(bool isArray = false) : _isValid{false} { - _code = 200; - _contentType = JSON_MIMETYPE; - if (isArray) - _root = _jsonBuffer.createArray(); - else - _root = _jsonBuffer.createObject(); - } -#elif ARDUINOJSON_VERSION_MAJOR == 6 - AsyncJsonResponse(bool isArray = false, size_t maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE) : _jsonBuffer(maxJsonBufferSize), _isValid{false} { - _code = 200; - _contentType = JSON_MIMETYPE; - if (isArray) - _root = _jsonBuffer.createNestedArray(); - else - _root = _jsonBuffer.createNestedObject(); - } -#else - AsyncJsonResponse(bool isArray = false) : _isValid{false} { - _code = 200; - _contentType = JSON_MIMETYPE; - if (isArray) - _root = _jsonBuffer.add(); - else - _root = _jsonBuffer.add(); - } -#endif - - JsonVariant& getRoot() { return _root; } - bool _sourceValid() const { return _isValid; } - size_t setLength() { - -#if ARDUINOJSON_VERSION_MAJOR == 5 - _contentLength = _root.measureLength(); -#else - _contentLength = measureJson(_root); -#endif - - if (_contentLength) { - _isValid = true; - } - return _contentLength; - } - - size_t getSize() const { return _jsonBuffer.size(); } - -#if ARDUINOJSON_VERSION_MAJOR >= 6 - bool overflowed() const { return _jsonBuffer.overflowed(); } -#endif - - size_t _fillBuffer(uint8_t* data, size_t len) { - ChunkPrint dest(data, _sentLength, len); - -#if ARDUINOJSON_VERSION_MAJOR == 5 - _root.printTo(dest); -#else - serializeJson(_root, dest); -#endif - return len; - } -}; - -class PrettyAsyncJsonResponse : public AsyncJsonResponse { - public: -#if ARDUINOJSON_VERSION_MAJOR == 6 - PrettyAsyncJsonResponse(bool isArray = false, size_t maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE) : AsyncJsonResponse{isArray, maxJsonBufferSize} {} -#else - PrettyAsyncJsonResponse(bool isArray = false) : AsyncJsonResponse{isArray} {} -#endif - size_t setLength() { -#if ARDUINOJSON_VERSION_MAJOR == 5 - _contentLength = _root.measurePrettyLength(); -#else - _contentLength = measureJsonPretty(_root); -#endif - if (_contentLength) { - _isValid = true; - } - return _contentLength; - } - size_t _fillBuffer(uint8_t* data, size_t len) { - ChunkPrint dest(data, _sentLength, len); -#if ARDUINOJSON_VERSION_MAJOR == 5 - _root.prettyPrintTo(dest); -#else - serializeJsonPretty(_root, dest); -#endif - return len; - } -}; - -typedef std::function ArJsonRequestHandlerFunction; - -class AsyncCallbackJsonWebHandler : public AsyncWebHandler { - private: - protected: - const String _uri; - WebRequestMethodComposite _method; - ArJsonRequestHandlerFunction _onRequest; - size_t _contentLength; -#if ARDUINOJSON_VERSION_MAJOR == 6 - const size_t maxJsonBufferSize; -#endif - size_t _maxContentLength; - - public: -#if ARDUINOJSON_VERSION_MAJOR == 6 - AsyncCallbackJsonWebHandler(const String& uri, ArJsonRequestHandlerFunction onRequest = nullptr, size_t maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE) - : _uri(uri), _method(HTTP_GET | HTTP_POST | HTTP_PUT | HTTP_PATCH), _onRequest(onRequest), maxJsonBufferSize(maxJsonBufferSize), _maxContentLength(16384) {} -#else - AsyncCallbackJsonWebHandler(const String& uri, ArJsonRequestHandlerFunction onRequest = nullptr) - : _uri(uri), _method(HTTP_GET | HTTP_POST | HTTP_PUT | HTTP_PATCH), _onRequest(onRequest), _maxContentLength(16384) {} -#endif - - void setMethod(WebRequestMethodComposite method) { _method = method; } - void setMaxContentLength(int maxContentLength) { _maxContentLength = maxContentLength; } - void onRequest(ArJsonRequestHandlerFunction fn) { _onRequest = fn; } - - virtual bool canHandle(AsyncWebServerRequest* request) override final { - if (!_onRequest) - return false; - - WebRequestMethodComposite request_method = request->method(); - if (!(_method & request_method)) - return false; - - if (_uri.length() && (_uri != request->url() && !request->url().startsWith(_uri + "/"))) - return false; - - if (request_method != HTTP_GET && !request->contentType().equalsIgnoreCase(JSON_MIMETYPE)) - return false; - - request->addInterestingHeader("ANY"); - return true; - } - - virtual void handleRequest(AsyncWebServerRequest* request) override final { - if ((_username != "" && _password != "") && !request->authenticate(_username.c_str(), _password.c_str())) - return request->requestAuthentication(); - if (_onRequest) { - if (request->method() == HTTP_GET) { - JsonVariant json; - _onRequest(request, json); - return; - } else if (request->_tempObject != NULL) { - -#if ARDUINOJSON_VERSION_MAJOR == 5 - DynamicJsonBuffer jsonBuffer; - JsonVariant json = jsonBuffer.parse((uint8_t*)(request->_tempObject)); - if (json.success()) { -#elif ARDUINOJSON_VERSION_MAJOR == 6 - DynamicJsonDocument jsonBuffer(this->maxJsonBufferSize); - DeserializationError error = deserializeJson(jsonBuffer, (uint8_t*)(request->_tempObject)); - if (!error) { - JsonVariant json = jsonBuffer.as(); -#else - JsonDocument jsonBuffer; - DeserializationError error = deserializeJson(jsonBuffer, (uint8_t*)(request->_tempObject)); - if (!error) { - JsonVariant json = jsonBuffer.as(); -#endif - - _onRequest(request, json); - return; - } - } - request->send(_contentLength > _maxContentLength ? 413 : 400); - } else { - request->send(500); - } - } - virtual void handleUpload(__unused AsyncWebServerRequest* request, __unused const String& filename, __unused size_t index, __unused uint8_t* data, __unused size_t len, __unused bool final) override final { - } - virtual void handleBody(AsyncWebServerRequest* request, uint8_t* data, size_t len, size_t index, size_t total) override final { - if (_onRequest) { - _contentLength = total; - if (total > 0 && request->_tempObject == NULL && total < _maxContentLength) { - request->_tempObject = malloc(total); - } - if (request->_tempObject != NULL) { - memcpy((uint8_t*)(request->_tempObject) + index, data, len); - } - } - } - virtual bool isRequestHandlerTrivial() override final { return _onRequest ? false : true; } -}; -#endif diff --git a/lib/ESPAsyncWebServer/src/AsyncMessagePack.h b/lib/ESPAsyncWebServer/src/AsyncMessagePack.h deleted file mode 100644 index 57a8824..0000000 --- a/lib/ESPAsyncWebServer/src/AsyncMessagePack.h +++ /dev/null @@ -1,145 +0,0 @@ -#pragma once - -/* - server.on("/msg_pack", HTTP_ANY, [](AsyncWebServerRequest * request) { - AsyncMessagePackResponse * response = new AsyncMessagePackResponse(); - JsonObject& root = response->getRoot(); - root["key1"] = "key number one"; - JsonObject& nested = root.createNestedObject("nested"); - nested["key1"] = "key number one"; - response->setLength(); - request->send(response); - }); - - -------------------- - - AsyncCallbackMessagePackWebHandler* handler = new AsyncCallbackMessagePackWebHandler("/msg_pack/endpoint"); - handler->onRequest([](AsyncWebServerRequest *request, JsonVariant &json) { - JsonObject jsonObj = json.as(); - // ... - }); - server.addHandler(handler); -*/ - -#include -#include - -#include "ChunkPrint.h" -#include "literals.h" - -class AsyncMessagePackResponse : public AsyncAbstractResponse { - protected: - JsonDocument _jsonBuffer; - JsonVariant _root; - bool _isValid; - - public: - AsyncMessagePackResponse(bool isArray = false) : _isValid{false} { - _code = 200; - _contentType = asyncsrv::T_application_msgpack; - if (isArray) - _root = _jsonBuffer.add(); - else - _root = _jsonBuffer.add(); - } - - JsonVariant& getRoot() { return _root; } - - bool _sourceValid() const { return _isValid; } - - size_t setLength() { - _contentLength = measureMsgPack(_root); - if (_contentLength) { - _isValid = true; - } - return _contentLength; - } - - size_t getSize() const { return _jsonBuffer.size(); } - - size_t _fillBuffer(uint8_t* data, size_t len) { - ChunkPrint dest(data, _sentLength, len); - serializeMsgPack(_root, dest); - return len; - } -}; - -class AsyncCallbackMessagePackWebHandler : public AsyncWebHandler { - public: - typedef std::function ArJsonRequestHandlerFunction; - - protected: - const String _uri; - WebRequestMethodComposite _method; - ArJsonRequestHandlerFunction _onRequest; - size_t _contentLength; - size_t _maxContentLength; - - public: - AsyncCallbackMessagePackWebHandler(const String& uri, ArJsonRequestHandlerFunction onRequest = nullptr) - : _uri(uri), _method(HTTP_GET | HTTP_POST | HTTP_PUT | HTTP_PATCH), _onRequest(onRequest), _maxContentLength(16384) {} - - void setMethod(WebRequestMethodComposite method) { _method = method; } - void setMaxContentLength(int maxContentLength) { _maxContentLength = maxContentLength; } - void onRequest(ArJsonRequestHandlerFunction fn) { _onRequest = fn; } - - virtual bool canHandle(AsyncWebServerRequest* request) override final { - if (!_onRequest) - return false; - - WebRequestMethodComposite request_method = request->method(); - if (!(_method & request_method)) - return false; - - if (_uri.length() && (_uri != request->url() && !request->url().startsWith(_uri + "/"))) - return false; - - if (request_method != HTTP_GET && !request->contentType().equalsIgnoreCase(asyncsrv::T_application_msgpack)) - return false; - - request->addInterestingHeader("ANY"); - return true; - } - - virtual void handleRequest(AsyncWebServerRequest* request) override final { - if ((_username != "" && _password != "") && !request->authenticate(_username.c_str(), _password.c_str())) - return request->requestAuthentication(); - - if (_onRequest) { - if (request->method() == HTTP_GET) { - JsonVariant json; - _onRequest(request, json); - return; - - } else if (request->_tempObject != NULL) { - JsonDocument jsonBuffer; - DeserializationError error = deserializeMsgPack(jsonBuffer, (uint8_t*)(request->_tempObject)); - - if (!error) { - JsonVariant json = jsonBuffer.as(); - _onRequest(request, json); - return; - } - } - request->send(_contentLength > _maxContentLength ? 413 : 400); - } else { - request->send(500); - } - } - - virtual void handleUpload(__unused AsyncWebServerRequest* request, __unused const String& filename, __unused size_t index, __unused uint8_t* data, __unused size_t len, __unused bool final) override final {} - - virtual void handleBody(AsyncWebServerRequest* request, uint8_t* data, size_t len, size_t index, size_t total) override final { - if (_onRequest) { - _contentLength = total; - if (total > 0 && request->_tempObject == NULL && total < _maxContentLength) { - request->_tempObject = malloc(total); - } - if (request->_tempObject != NULL) { - memcpy((uint8_t*)(request->_tempObject) + index, data, len); - } - } - } - - virtual bool isRequestHandlerTrivial() override final { return _onRequest ? false : true; } -}; diff --git a/lib/ESPAsyncWebServer/src/AsyncWebSocket.cpp b/lib/ESPAsyncWebServer/src/AsyncWebSocket.cpp deleted file mode 100644 index 88d88ec..0000000 --- a/lib/ESPAsyncWebServer/src/AsyncWebSocket.cpp +++ /dev/null @@ -1,1207 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "AsyncWebSocket.h" -#include "Arduino.h" - -#include - -#include - -#if defined(ESP32) - #if ESP_IDF_VERSION_MAJOR < 5 - #include "./port/SHA1Builder.h" - #else - #include - #endif - #include -#elif defined(TARGET_RP2040) || defined(ESP8266) - #include -#endif - -#define MAX_PRINTF_LEN 64 - -using namespace asyncsrv; - - -size_t webSocketSendFrameWindow(AsyncClient* client) { - if (!client->canSend()) - return 0; - size_t space = client->space(); - if (space < 9) - return 0; - return space - 8; -} - -size_t webSocketSendFrame(AsyncClient* client, bool final, uint8_t opcode, bool mask, uint8_t* data, size_t len) { - if (!client->canSend()) { - // Serial.println("SF 1"); - return 0; - } - size_t space = client->space(); - if (space < 2) { - // Serial.println("SF 2"); - return 0; - } - uint8_t mbuf[4] = {0, 0, 0, 0}; - uint8_t headLen = 2; - if (len && mask) { - headLen += 4; - mbuf[0] = rand() % 0xFF; - mbuf[1] = rand() % 0xFF; - mbuf[2] = rand() % 0xFF; - mbuf[3] = rand() % 0xFF; - } - if (len > 125) - headLen += 2; - if (space < headLen) { - // Serial.println("SF 2"); - return 0; - } - space -= headLen; - - if (len > space) - len = space; - - uint8_t* buf = (uint8_t*)malloc(headLen); - if (buf == NULL) { - // os_printf("could not malloc %u bytes for frame header\n", headLen); - // Serial.println("SF 3"); - return 0; - } - - buf[0] = opcode & 0x0F; - if (final) - buf[0] |= 0x80; - if (len < 126) - buf[1] = len & 0x7F; - else { - buf[1] = 126; - buf[2] = (uint8_t)((len >> 8) & 0xFF); - buf[3] = (uint8_t)(len & 0xFF); - } - if (len && mask) { - buf[1] |= 0x80; - memcpy(buf + (headLen - 4), mbuf, 4); - } - if (client->add((const char*)buf, headLen) != headLen) { - // os_printf("error adding %lu header bytes\n", headLen); - free(buf); - // Serial.println("SF 4"); - return 0; - } - free(buf); - - if (len) { - if (len && mask) { - size_t i; - for (i = 0; i < len; i++) - data[i] = data[i] ^ mbuf[i % 4]; - } - if (client->add((const char*)data, len) != len) { - // os_printf("error adding %lu data bytes\n", len); - // Serial.println("SF 5"); - return 0; - } - } - if (!client->send()) { - // os_printf("error sending frame: %lu\n", headLen+len); - // Serial.println("SF 6"); - return 0; - } - // Serial.println("SF"); - return len; -} - -/* - * AsyncWebSocketMessageBuffer - */ - -AsyncWebSocketMessageBuffer::AsyncWebSocketMessageBuffer(const uint8_t* data, size_t size) - : _buffer(std::make_shared>(size)) { - if (_buffer->capacity() < size) { - _buffer->reserve(size); - } else { - std::memcpy(_buffer->data(), data, size); - } -} - -AsyncWebSocketMessageBuffer::AsyncWebSocketMessageBuffer(size_t size) - : _buffer(std::make_shared>(size)) { - if (_buffer->capacity() < size) { - _buffer->reserve(size); - } -} - -bool AsyncWebSocketMessageBuffer::reserve(size_t size) { - if (_buffer->capacity() >= size) - return true; - _buffer->reserve(size); - return _buffer->capacity() >= size; -} - -/* - * Control Frame - */ - -class AsyncWebSocketControl { - private: - uint8_t _opcode; - uint8_t* _data; - size_t _len; - bool _mask; - bool _finished; - - public: - AsyncWebSocketControl(uint8_t opcode, const uint8_t* data = NULL, size_t len = 0, bool mask = false) - : _opcode(opcode), _len(len), _mask(len && mask), _finished(false) { - if (data == NULL) - _len = 0; - if (_len) { - if (_len > 125) - _len = 125; - - _data = (uint8_t*)malloc(_len); - - if (_data == NULL) - _len = 0; - else - memcpy(_data, data, len); - } else - _data = NULL; - } - - virtual ~AsyncWebSocketControl() { - if (_data != NULL) - free(_data); - } - - virtual bool finished() const { return _finished; } - uint8_t opcode() { return _opcode; } - uint8_t len() { return _len + 2; } - size_t send(AsyncClient* client) { - _finished = true; - return webSocketSendFrame(client, true, _opcode & 0x0F, _mask, _data, _len); - } -}; - -/* - * AsyncWebSocketMessage Message - */ - -AsyncWebSocketMessage::AsyncWebSocketMessage(AsyncWebSocketSharedBuffer buffer, uint8_t opcode, bool mask) : _WSbuffer{buffer}, - _opcode(opcode & 0x07), - _mask{mask}, - _status{_WSbuffer ? WS_MSG_SENDING : WS_MSG_ERROR} { -} - -void AsyncWebSocketMessage::ack(size_t len, uint32_t time) { - (void)time; - _acked += len; - if (_sent >= _WSbuffer->size() && _acked >= _ack) { - _status = WS_MSG_SENT; - } - // ets_printf("A: %u\n", len); -} - -size_t AsyncWebSocketMessage::send(AsyncClient* client) { - if (_status != WS_MSG_SENDING) - return 0; - if (_acked < _ack) { - return 0; - } - if (_sent == _WSbuffer->size()) { - if (_acked == _ack) - _status = WS_MSG_SENT; - return 0; - } - if (_sent > _WSbuffer->size()) { - _status = WS_MSG_ERROR; - // ets_printf("E: %u > %u\n", _sent, _WSbuffer->length()); - return 0; - } - - size_t toSend = _WSbuffer->size() - _sent; - size_t window = webSocketSendFrameWindow(client); - - if (window < toSend) { - toSend = window; - } - - _sent += toSend; - _ack += toSend + ((toSend < 126) ? 2 : 4) + (_mask * 4); - - // ets_printf("W: %u %u\n", _sent - toSend, toSend); - - bool final = (_sent == _WSbuffer->size()); - uint8_t* dPtr = (uint8_t*)(_WSbuffer->data() + (_sent - toSend)); - uint8_t opCode = (toSend && _sent == toSend) ? _opcode : (uint8_t)WS_CONTINUATION; - - size_t sent = webSocketSendFrame(client, final, opCode, _mask, dPtr, toSend); - _status = WS_MSG_SENDING; - if (toSend && sent != toSend) { - // ets_printf("E: %u != %u\n", toSend, sent); - _sent -= (toSend - sent); - _ack -= (toSend - sent); - } - // ets_printf("S: %u %u\n", _sent, sent); - return sent; -} - -/* - * Async WebSocket Client - */ -const char* AWSC_PING_PAYLOAD = "ESPAsyncWebServer-PING"; -const size_t AWSC_PING_PAYLOAD_LEN = 22; - -AsyncWebSocketClient::AsyncWebSocketClient(AsyncWebServerRequest* request, AsyncWebSocket* server) - : _tempObject(NULL) { - _client = request->client(); - _server = server; - _clientId = _server->_getNextId(); - _status = WS_CONNECTED; - _pstate = 0; - _lastMessageTime = millis(); - _keepAlivePeriod = 0; - _client->setRxTimeout(0); - _client->onError([](void* r, AsyncClient* c, int8_t error) { (void)c; ((AsyncWebSocketClient*)(r))->_onError(error); }, this); - _client->onAck([](void* r, AsyncClient* c, size_t len, uint32_t time) { (void)c; ((AsyncWebSocketClient*)(r))->_onAck(len, time); }, this); - _client->onDisconnect([](void* r, AsyncClient* c) { ((AsyncWebSocketClient*)(r))->_onDisconnect(); delete c; }, this); - _client->onTimeout([](void* r, AsyncClient* c, uint32_t time) { (void)c; ((AsyncWebSocketClient*)(r))->_onTimeout(time); }, this); - _client->onData([](void* r, AsyncClient* c, void* buf, size_t len) { (void)c; ((AsyncWebSocketClient*)(r))->_onData(buf, len); }, this); - _client->onPoll([](void* r, AsyncClient* c) { (void)c; ((AsyncWebSocketClient*)(r))->_onPoll(); }, this); - _server->_handleEvent(this, WS_EVT_CONNECT, request, NULL, 0); - delete request; - memset(&_pinfo, 0, sizeof(_pinfo)); -} - -AsyncWebSocketClient::~AsyncWebSocketClient() { - { -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - _messageQueue.clear(); - _controlQueue.clear(); - } - _server->_handleEvent(this, WS_EVT_DISCONNECT, NULL, NULL, 0); -} - -void AsyncWebSocketClient::_clearQueue() { - while (!_messageQueue.empty() && _messageQueue.front().finished()) - _messageQueue.pop_front(); -} - -void AsyncWebSocketClient::_onAck(size_t len, uint32_t time) { - _lastMessageTime = millis(); - -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - - if (!_controlQueue.empty()) { - auto& head = _controlQueue.front(); - if (head.finished()) { - len -= head.len(); - if (_status == WS_DISCONNECTING && head.opcode() == WS_DISCONNECT) { - _controlQueue.pop_front(); - _status = WS_DISCONNECTED; - if (_client) - _client->close(true); - return; - } - _controlQueue.pop_front(); - } - } - - if (len && !_messageQueue.empty()) { - _messageQueue.front().ack(len, time); - } - - _clearQueue(); - - _runQueue(); -} - -void AsyncWebSocketClient::_onPoll() { - if (!_client) - return; - -#ifdef ESP32 - std::unique_lock lock(_lock); -#endif - if (_client->canSend() && (!_controlQueue.empty() || !_messageQueue.empty())) { - _runQueue(); - } else if (_keepAlivePeriod > 0 && (millis() - _lastMessageTime) >= _keepAlivePeriod && (_controlQueue.empty() && _messageQueue.empty())) { -#ifdef ESP32 - lock.unlock(); -#endif - ping((uint8_t*)AWSC_PING_PAYLOAD, AWSC_PING_PAYLOAD_LEN); - } -} - -void AsyncWebSocketClient::_runQueue() { - // all calls to this method MUST be protected by a mutex lock! - if (!_client) - return; - - _clearQueue(); - - if (!_controlQueue.empty() && (_messageQueue.empty() || _messageQueue.front().betweenFrames()) && webSocketSendFrameWindow(_client) > (size_t)(_controlQueue.front().len() - 1)) { - _controlQueue.front().send(_client); - } else if (!_messageQueue.empty() && _messageQueue.front().betweenFrames() && webSocketSendFrameWindow(_client)) { - _messageQueue.front().send(_client); - } -} - -bool AsyncWebSocketClient::queueIsFull() const { -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - size_t size = _messageQueue.size(); - ; - return (size >= WS_MAX_QUEUED_MESSAGES) || (_status != WS_CONNECTED); -} - -size_t AsyncWebSocketClient::queueLen() const { -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - - return _messageQueue.size() + _controlQueue.size(); -} - -bool AsyncWebSocketClient::canSend() const { -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - return _messageQueue.size() < WS_MAX_QUEUED_MESSAGES; -} - -void AsyncWebSocketClient::_queueControl(uint8_t opcode, const uint8_t* data, size_t len, bool mask) { - if (!_client) - return; - - { -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - _controlQueue.emplace_back(opcode, data, len, mask); - } - - if (_client && _client->canSend()) - _runQueue(); -} - -void AsyncWebSocketClient::_queueMessage(AsyncWebSocketSharedBuffer buffer, uint8_t opcode, bool mask) { - if (!_client || buffer->size() == 0 || _status != WS_CONNECTED) - return; - -#ifdef ESP32 - std::lock_guard lock(_lock); -#endif - if (_messageQueue.size() >= WS_MAX_QUEUED_MESSAGES) { - if (closeWhenFull) { -#ifdef ESP8266 - ets_printf("AsyncWebSocketClient::_queueMessage: Too many messages queued: closing connection\n"); -#elif defined(ESP32) - log_e("Too many messages queued: closing connection"); -#endif - _status = WS_DISCONNECTED; - if (_client) - _client->close(true); - } else { -#ifdef ESP8266 - ets_printf("AsyncWebSocketClient::_queueMessage: Too many messages queued: discarding new message\n"); -#elif defined(ESP32) - log_e("Too many messages queued: discarding new message"); -#endif - } - return; - } else { - _messageQueue.emplace_back(buffer, opcode, mask); - } - - if (_client && _client->canSend()) - _runQueue(); -} - -void AsyncWebSocketClient::close(uint16_t code, const char* message) { - if (_status != WS_CONNECTED) - return; - - if (code) { - uint8_t packetLen = 2; - if (message != NULL) { - size_t mlen = strlen(message); - if (mlen > 123) - mlen = 123; - packetLen += mlen; - } - char* buf = (char*)malloc(packetLen); - if (buf != NULL) { - buf[0] = (uint8_t)(code >> 8); - buf[1] = (uint8_t)(code & 0xFF); - if (message != NULL) { - memcpy(buf + 2, message, packetLen - 2); - } - _queueControl(WS_DISCONNECT, (uint8_t*)buf, packetLen); - free(buf); - return; - } - } - _queueControl(WS_DISCONNECT); -} - -void AsyncWebSocketClient::ping(const uint8_t* data, size_t len) { - if (_status == WS_CONNECTED) - _queueControl(WS_PING, data, len); -} - -void AsyncWebSocketClient::_onError(int8_t) { - // Serial.println("onErr"); -} - -void AsyncWebSocketClient::_onTimeout(uint32_t time) { - // Serial.println("onTime"); - (void)time; - _client->close(true); -} - -void AsyncWebSocketClient::_onDisconnect() { - // Serial.println("onDis"); - _client = NULL; -} - -void AsyncWebSocketClient::_onData(void* pbuf, size_t plen) { - // Serial.println("onData"); - _lastMessageTime = millis(); - uint8_t* data = (uint8_t*)pbuf; - while (plen > 0) { - if (!_pstate) { - const uint8_t* fdata = data; - _pinfo.index = 0; - _pinfo.final = (fdata[0] & 0x80) != 0; - _pinfo.opcode = fdata[0] & 0x0F; - _pinfo.masked = (fdata[1] & 0x80) != 0; - _pinfo.len = fdata[1] & 0x7F; - data += 2; - plen -= 2; - if (_pinfo.len == 126) { - _pinfo.len = fdata[3] | (uint16_t)(fdata[2]) << 8; - data += 2; - plen -= 2; - } else if (_pinfo.len == 127) { - _pinfo.len = fdata[9] | (uint16_t)(fdata[8]) << 8 | (uint32_t)(fdata[7]) << 16 | (uint32_t)(fdata[6]) << 24 | (uint64_t)(fdata[5]) << 32 | (uint64_t)(fdata[4]) << 40 | (uint64_t)(fdata[3]) << 48 | (uint64_t)(fdata[2]) << 56; - data += 8; - plen -= 8; - } - - if (_pinfo.masked) { - memcpy(_pinfo.mask, data, 4); - data += 4; - plen -= 4; - } - } - - const size_t datalen = std::min((size_t)(_pinfo.len - _pinfo.index), plen); - const auto datalast = data[datalen]; - - if (_pinfo.masked) { - for (size_t i = 0; i < datalen; i++) - data[i] ^= _pinfo.mask[(_pinfo.index + i) % 4]; - } - - if ((datalen + _pinfo.index) < _pinfo.len) { - _pstate = 1; - - if (_pinfo.index == 0) { - if (_pinfo.opcode) { - _pinfo.message_opcode = _pinfo.opcode; - _pinfo.num = 0; - } - } - if (datalen > 0) - _server->_handleEvent(this, WS_EVT_DATA, (void*)&_pinfo, (uint8_t*)data, datalen); - - _pinfo.index += datalen; - } else if ((datalen + _pinfo.index) == _pinfo.len) { - _pstate = 0; - if (_pinfo.opcode == WS_DISCONNECT) { - if (datalen) { - uint16_t reasonCode = (uint16_t)(data[0] << 8) + data[1]; - char* reasonString = (char*)(data + 2); - if (reasonCode > 1001) { - _server->_handleEvent(this, WS_EVT_ERROR, (void*)&reasonCode, (uint8_t*)reasonString, strlen(reasonString)); - } - } - if (_status == WS_DISCONNECTING) { - _status = WS_DISCONNECTED; - _client->close(true); - } else { - _status = WS_DISCONNECTING; - _client->ackLater(); - _queueControl(WS_DISCONNECT, data, datalen); - } - } else if (_pinfo.opcode == WS_PING) { - _queueControl(WS_PONG, data, datalen); - } else if (_pinfo.opcode == WS_PONG) { - if (datalen != AWSC_PING_PAYLOAD_LEN || memcmp(AWSC_PING_PAYLOAD, data, AWSC_PING_PAYLOAD_LEN) != 0) - _server->_handleEvent(this, WS_EVT_PONG, NULL, data, datalen); - } else if (_pinfo.opcode < 8) { // continuation or text/binary frame - _server->_handleEvent(this, WS_EVT_DATA, (void*)&_pinfo, data, datalen); - if (_pinfo.final) - _pinfo.num = 0; - else - _pinfo.num += 1; - } - } else { - // os_printf("frame error: len: %u, index: %llu, total: %llu\n", datalen, _pinfo.index, _pinfo.len); - // what should we do? - break; - } - - // restore byte as _handleEvent may have added a null terminator i.e., data[len] = 0; - if (datalen > 0) - data[datalen] = datalast; - - data += datalen; - plen -= datalen; - } -} - -size_t AsyncWebSocketClient::printf(const char* format, ...) { - va_list arg; - va_start(arg, format); - char* temp = new char[MAX_PRINTF_LEN]; - if (!temp) { - va_end(arg); - return 0; - } - char* buffer = temp; - size_t len = vsnprintf(temp, MAX_PRINTF_LEN, format, arg); - va_end(arg); - - if (len > (MAX_PRINTF_LEN - 1)) { - buffer = new char[len + 1]; - if (!buffer) { - delete[] temp; - return 0; - } - va_start(arg, format); - vsnprintf(buffer, len + 1, format, arg); - va_end(arg); - } - text(buffer, len); - if (buffer != temp) { - delete[] buffer; - } - delete[] temp; - return len; -} - -#ifdef ESP8266 -size_t AsyncWebSocketClient::printf_P(PGM_P formatP, ...) { - va_list arg; - va_start(arg, formatP); - char* temp = new char[MAX_PRINTF_LEN]; - if (!temp) { - va_end(arg); - return 0; - } - char* buffer = temp; - size_t len = vsnprintf_P(temp, MAX_PRINTF_LEN, formatP, arg); - va_end(arg); - - if (len > (MAX_PRINTF_LEN - 1)) { - buffer = new char[len + 1]; - if (!buffer) { - delete[] temp; - return 0; - } - va_start(arg, formatP); - vsnprintf_P(buffer, len + 1, formatP, arg); - va_end(arg); - } - text(buffer, len); - if (buffer != temp) { - delete[] buffer; - } - delete[] temp; - return len; -} -#endif - -namespace { - AsyncWebSocketSharedBuffer makeSharedBuffer(const uint8_t* message, size_t len) { - auto buffer = std::make_shared>(len); - std::memcpy(buffer->data(), message, len); - return buffer; - } -} - -void AsyncWebSocketClient::text(AsyncWebSocketMessageBuffer* buffer) { - if (buffer) { - text(std::move(buffer->_buffer)); - delete buffer; - } -} - -void AsyncWebSocketClient::text(AsyncWebSocketSharedBuffer buffer) { - _queueMessage(buffer); -} - -void AsyncWebSocketClient::text(const uint8_t* message, size_t len) { - text(makeSharedBuffer(message, len)); -} - -void AsyncWebSocketClient::text(const char* message, size_t len) { - text((const uint8_t*)message, len); -} - -void AsyncWebSocketClient::text(const char* message) { - text(message, strlen(message)); -} - -void AsyncWebSocketClient::text(const String& message) { - text(message.c_str(), message.length()); -} - -#ifdef ESP8266 -void AsyncWebSocketClient::text(const __FlashStringHelper* data) { - PGM_P p = reinterpret_cast(data); - - size_t n = 0; - while (1) { - if (pgm_read_byte(p + n) == 0) - break; - n += 1; - } - - char* message = (char*)malloc(n + 1); - if (message) { - memcpy_P(message, p, n); - message[n] = 0; - text(message, n); - free(message); - } -} -#endif // ESP8266 - -void AsyncWebSocketClient::binary(AsyncWebSocketMessageBuffer* buffer) { - if (buffer) { - binary(std::move(buffer->_buffer)); - delete buffer; - } -} - -void AsyncWebSocketClient::binary(AsyncWebSocketSharedBuffer buffer) { - _queueMessage(buffer, WS_BINARY); -} - -void AsyncWebSocketClient::binary(const uint8_t* message, size_t len) { - binary(makeSharedBuffer(message, len)); -} - -void AsyncWebSocketClient::binary(const char* message, size_t len) { - binary((const uint8_t*)message, len); -} - -void AsyncWebSocketClient::binary(const char* message) { - binary(message, strlen(message)); -} - -void AsyncWebSocketClient::binary(const String& message) { - binary(message.c_str(), message.length()); -} - -#ifdef ESP8266 -void AsyncWebSocketClient::binary(const __FlashStringHelper* data, size_t len) { - PGM_P p = reinterpret_cast(data); - char* message = (char*)malloc(len); - if (message) { - memcpy_P(message, p, len); - binary(message, len); - free(message); - } -} -#endif - -IPAddress AsyncWebSocketClient::remoteIP() const { - if (!_client) - return IPAddress((uint32_t)0U); - - return _client->remoteIP(); -} - -uint16_t AsyncWebSocketClient::remotePort() const { - if (!_client) - return 0; - - return _client->remotePort(); -} - -/* - * Async Web Socket - Each separate socket location - */ - -void AsyncWebSocket::_handleEvent(AsyncWebSocketClient* client, AwsEventType type, void* arg, uint8_t* data, size_t len) { - if (_eventHandler != NULL) { - _eventHandler(this, client, type, arg, data, len); - } -} - -AsyncWebSocketClient* AsyncWebSocket::_newClient(AsyncWebServerRequest* request) { - _clients.emplace_back(request, this); - return &_clients.back(); -} - -bool AsyncWebSocket::availableForWriteAll() { - return std::none_of(std::begin(_clients), std::end(_clients), [](const AsyncWebSocketClient& c) { return c.queueIsFull(); }); -} - -bool AsyncWebSocket::availableForWrite(uint32_t id) { - const auto iter = std::find_if(std::begin(_clients), std::end(_clients), [id](const AsyncWebSocketClient& c) { return c.id() == id; }); - if (iter == std::end(_clients)) - return true; - return !iter->queueIsFull(); -} - -size_t AsyncWebSocket::count() const { - return std::count_if(std::begin(_clients), std::end(_clients), [](const AsyncWebSocketClient& c) { return c.status() == WS_CONNECTED; }); -} - -AsyncWebSocketClient* AsyncWebSocket::client(uint32_t id) { - const auto iter = std::find_if(_clients.begin(), _clients.end(), [id](const AsyncWebSocketClient& c) { return c.id() == id && c.status() == WS_CONNECTED; }); - if (iter == std::end(_clients)) - return nullptr; - - return &(*iter); -} - -void AsyncWebSocket::close(uint32_t id, uint16_t code, const char* message) { - if (AsyncWebSocketClient* c = client(id)) - c->close(code, message); -} - -void AsyncWebSocket::closeAll(uint16_t code, const char* message) { - for (auto& c : _clients) - if (c.status() == WS_CONNECTED) - c.close(code, message); -} - -void AsyncWebSocket::cleanupClients(uint16_t maxClients) { - if (count() > maxClients) - _clients.front().close(); - - for (auto iter = std::begin(_clients); iter != std::end(_clients);) { - if (iter->shouldBeDeleted()) - iter = _clients.erase(iter); - else - iter++; - } -} - -void AsyncWebSocket::ping(uint32_t id, const uint8_t* data, size_t len) { - if (AsyncWebSocketClient* c = client(id)) - c->ping(data, len); -} - -void AsyncWebSocket::pingAll(const uint8_t* data, size_t len) { - for (auto& c : _clients) - if (c.status() == WS_CONNECTED) - c.ping(data, len); -} - -void AsyncWebSocket::text(uint32_t id, const uint8_t* message, size_t len) { - if (AsyncWebSocketClient* c = client(id)) - c->text(makeSharedBuffer(message, len)); -} -void AsyncWebSocket::text(uint32_t id, const char* message, size_t len) { - text(id, (const uint8_t*)message, len); -} -void AsyncWebSocket::text(uint32_t id, const char* message) { - text(id, message, strlen(message)); -} -void AsyncWebSocket::text(uint32_t id, const String& message) { - text(id, message.c_str(), message.length()); -} - -#ifdef ESP8266 -void AsyncWebSocket::text(uint32_t id, const __FlashStringHelper* data) { - PGM_P p = reinterpret_cast(data); - - size_t n = 0; - while (true) { - if (pgm_read_byte(p + n) == 0) - break; - n += 1; - } - - char* message = (char*)malloc(n + 1); - if (message) { - memcpy_P(message, p, n); - message[n] = 0; - text(id, message, n); - free(message); - } -} -#endif // ESP8266 - -void AsyncWebSocket::text(uint32_t id, AsyncWebSocketMessageBuffer* buffer) { - if (buffer) { - text(id, std::move(buffer->_buffer)); - delete buffer; - } -} -void AsyncWebSocket::text(uint32_t id, AsyncWebSocketSharedBuffer buffer) { - if (AsyncWebSocketClient* c = client(id)) - c->text(buffer); -} - -void AsyncWebSocket::textAll(const uint8_t* message, size_t len) { - textAll(makeSharedBuffer(message, len)); -} -void AsyncWebSocket::textAll(const char* message, size_t len) { - textAll((const uint8_t*)message, len); -} -void AsyncWebSocket::textAll(const char* message) { - textAll(message, strlen(message)); -} -void AsyncWebSocket::textAll(const String& message) { - textAll(message.c_str(), message.length()); -} -#ifdef ESP8266 -void AsyncWebSocket::textAll(const __FlashStringHelper* data) { - PGM_P p = reinterpret_cast(data); - - size_t n = 0; - while (1) { - if (pgm_read_byte(p + n) == 0) - break; - n += 1; - } - - char* message = (char*)malloc(n + 1); - if (message) { - memcpy_P(message, p, n); - message[n] = 0; - textAll(message, n); - free(message); - } -} -#endif // ESP8266 -void AsyncWebSocket::textAll(AsyncWebSocketMessageBuffer* buffer) { - if (buffer) { - textAll(std::move(buffer->_buffer)); - delete buffer; - } -} - -void AsyncWebSocket::textAll(AsyncWebSocketSharedBuffer buffer) { - for (auto& c : _clients) - if (c.status() == WS_CONNECTED) - c.text(buffer); -} - -void AsyncWebSocket::binary(uint32_t id, const uint8_t* message, size_t len) { - if (AsyncWebSocketClient* c = client(id)) - c->binary(makeSharedBuffer(message, len)); -} -void AsyncWebSocket::binary(uint32_t id, const char* message, size_t len) { - binary(id, (const uint8_t*)message, len); -} -void AsyncWebSocket::binary(uint32_t id, const char* message) { - binary(id, message, strlen(message)); -} -void AsyncWebSocket::binary(uint32_t id, const String& message) { - binary(id, message.c_str(), message.length()); -} - -#ifdef ESP8266 -void AsyncWebSocket::binary(uint32_t id, const __FlashStringHelper* data, size_t len) { - PGM_P p = reinterpret_cast(data); - char* message = (char*)malloc(len); - if (message) { - memcpy_P(message, p, len); - binary(id, message, len); - free(message); - } -} -#endif // ESP8266 - -void AsyncWebSocket::binary(uint32_t id, AsyncWebSocketMessageBuffer* buffer) { - if (buffer) { - binary(id, std::move(buffer->_buffer)); - delete buffer; - } -} -void AsyncWebSocket::binary(uint32_t id, AsyncWebSocketSharedBuffer buffer) { - if (AsyncWebSocketClient* c = client(id)) - c->binary(buffer); -} - -void AsyncWebSocket::binaryAll(const uint8_t* message, size_t len) { - binaryAll(makeSharedBuffer(message, len)); -} -void AsyncWebSocket::binaryAll(const char* message, size_t len) { - binaryAll((const uint8_t*)message, len); -} -void AsyncWebSocket::binaryAll(const char* message) { - binaryAll(message, strlen(message)); -} -void AsyncWebSocket::binaryAll(const String& message) { - binaryAll(message.c_str(), message.length()); -} - -#ifdef ESP8266 -void AsyncWebSocket::binaryAll(const __FlashStringHelper* data, size_t len) { - PGM_P p = reinterpret_cast(data); - char* message = (char*)malloc(len); - if (message) { - memcpy_P(message, p, len); - binaryAll(message, len); - free(message); - } -} -#endif // ESP8266 - -void AsyncWebSocket::binaryAll(AsyncWebSocketMessageBuffer* buffer) { - if (buffer) { - binaryAll(std::move(buffer->_buffer)); - delete buffer; - } -} -void AsyncWebSocket::binaryAll(AsyncWebSocketSharedBuffer buffer) { - for (auto& c : _clients) - if (c.status() == WS_CONNECTED) - c.binary(buffer); -} - -size_t AsyncWebSocket::printf(uint32_t id, const char* format, ...) { - AsyncWebSocketClient* c = client(id); - if (c) { - va_list arg; - va_start(arg, format); - size_t len = c->printf(format, arg); - va_end(arg); - return len; - } - return 0; -} - -size_t AsyncWebSocket::printfAll(const char* format, ...) { - va_list arg; - char* temp = new char[MAX_PRINTF_LEN]; - if (!temp) - return 0; - - va_start(arg, format); - size_t len = vsnprintf(temp, MAX_PRINTF_LEN, format, arg); - va_end(arg); - delete[] temp; - - AsyncWebSocketSharedBuffer buffer = std::make_shared>(len); - - va_start(arg, format); - vsnprintf((char*)buffer->data(), len + 1, format, arg); - va_end(arg); - - textAll(buffer); - return len; -} - -#ifdef ESP8266 -size_t AsyncWebSocket::printf_P(uint32_t id, PGM_P formatP, ...) { - AsyncWebSocketClient* c = client(id); - if (c != NULL) { - va_list arg; - va_start(arg, formatP); - size_t len = c->printf_P(formatP, arg); - va_end(arg); - return len; - } - return 0; -} - -size_t AsyncWebSocket::printfAll_P(PGM_P formatP, ...) { - va_list arg; - char* temp = new char[MAX_PRINTF_LEN]; - if (!temp) - return 0; - - va_start(arg, formatP); - size_t len = vsnprintf_P(temp, MAX_PRINTF_LEN, formatP, arg); - va_end(arg); - delete[] temp; - - AsyncWebSocketSharedBuffer buffer = std::make_shared>(len + 1); - - va_start(arg, formatP); - vsnprintf_P((char*)buffer->data(), len + 1, formatP, arg); - va_end(arg); - - textAll(buffer); - return len; -} -#endif - -const char __WS_STR_CONNECTION[] PROGMEM = {"Connection"}; -const char __WS_STR_UPGRADE[] PROGMEM = {"Upgrade"}; -const char __WS_STR_ORIGIN[] PROGMEM = {"Origin"}; -const char __WS_STR_COOKIE[] PROGMEM = {"Cookie"}; -const char __WS_STR_VERSION[] PROGMEM = {"Sec-WebSocket-Version"}; -const char __WS_STR_KEY[] PROGMEM = {"Sec-WebSocket-Key"}; -const char __WS_STR_PROTOCOL[] PROGMEM = {"Sec-WebSocket-Protocol"}; -const char __WS_STR_ACCEPT[] PROGMEM = {"Sec-WebSocket-Accept"}; -const char __WS_STR_UUID[] PROGMEM = {"258EAFA5-E914-47DA-95CA-C5AB0DC85B11"}; - -#define WS_STR_UUID_LEN 36 - -#define WS_STR_CONNECTION FPSTR(__WS_STR_CONNECTION) -#define WS_STR_UPGRADE FPSTR(__WS_STR_UPGRADE) -#define WS_STR_ORIGIN FPSTR(__WS_STR_ORIGIN) -#define WS_STR_COOKIE FPSTR(__WS_STR_COOKIE) -#define WS_STR_VERSION FPSTR(__WS_STR_VERSION) -#define WS_STR_KEY FPSTR(__WS_STR_KEY) -#define WS_STR_PROTOCOL FPSTR(__WS_STR_PROTOCOL) -#define WS_STR_ACCEPT FPSTR(__WS_STR_ACCEPT) -#define WS_STR_UUID FPSTR(__WS_STR_UUID) - -bool AsyncWebSocket::canHandle(AsyncWebServerRequest* request) { - if (!_enabled) - return false; - - if (request->method() != HTTP_GET || !request->url().equals(_url) || !request->isExpectedRequestedConnType(RCT_WS)) - return false; - - request->addInterestingHeader(WS_STR_CONNECTION); - request->addInterestingHeader(WS_STR_UPGRADE); - request->addInterestingHeader(WS_STR_ORIGIN); - request->addInterestingHeader(WS_STR_COOKIE); - request->addInterestingHeader(WS_STR_VERSION); - request->addInterestingHeader(WS_STR_KEY); - request->addInterestingHeader(WS_STR_PROTOCOL); - return true; -} - -void AsyncWebSocket::handleRequest(AsyncWebServerRequest* request) { - if (!request->hasHeader(WS_STR_VERSION) || !request->hasHeader(WS_STR_KEY)) { - request->send(400); - return; - } - if ((_username.length() && _password.length()) && !request->authenticate(_username.c_str(), _password.c_str())) { - return request->requestAuthentication(); - } - if (_handshakeHandler != nullptr) { - if (!_handshakeHandler(request)) { - request->send(401); - return; - } - } - const AsyncWebHeader* version = request->getHeader(WS_STR_VERSION); - if (version->value().toInt() != 13) { - AsyncWebServerResponse* response = request->beginResponse(400); - response->addHeader(WS_STR_VERSION, T_13); - request->send(response); - return; - } - const AsyncWebHeader* key = request->getHeader(WS_STR_KEY); - AsyncWebServerResponse* response = new AsyncWebSocketResponse(key->value(), this); - if (request->hasHeader(WS_STR_PROTOCOL)) { - const AsyncWebHeader* protocol = request->getHeader(WS_STR_PROTOCOL); - // ToDo: check protocol - response->addHeader(WS_STR_PROTOCOL, protocol->value()); - } - request->send(response); -} - -AsyncWebSocketMessageBuffer* AsyncWebSocket::makeBuffer(size_t size) { - AsyncWebSocketMessageBuffer* buffer = new AsyncWebSocketMessageBuffer(size); - if (buffer->length() != size) { - delete buffer; - return nullptr; - } else { - return buffer; - } -} - -AsyncWebSocketMessageBuffer* AsyncWebSocket::makeBuffer(const uint8_t* data, size_t size) { - AsyncWebSocketMessageBuffer* buffer = new AsyncWebSocketMessageBuffer(data, size); - if (buffer->length() != size) { - delete buffer; - return nullptr; - } else { - return buffer; - } -} - -/* - * Response to Web Socket request - sends the authorization and detaches the TCP Client from the web server - * Authentication code from https://github.com/Links2004/arduinoWebSockets/blob/master/src/WebSockets.cpp#L480 - */ - -AsyncWebSocketResponse::AsyncWebSocketResponse(const String& key, AsyncWebSocket* server) { - _server = server; - _code = 101; - _sendContentLength = false; - - uint8_t hash[20]; - char buffer[33]; - -#if defined(ESP8266) || defined(TARGET_RP2040) - sha1(key + WS_STR_UUID, hash); -#else - String k; - k.reserve(key.length() + WS_STR_UUID_LEN); - k.concat(key); - k.concat(WS_STR_UUID); - SHA1Builder sha1; - sha1.begin(); - sha1.add((const uint8_t*)k.c_str(), k.length()); - sha1.calculate(); - sha1.getBytes(hash); -#endif - base64_encodestate _state; - base64_init_encodestate(&_state); - int len = base64_encode_block((const char*)hash, 20, buffer, &_state); - len = base64_encode_blockend((buffer + len), &_state); - addHeader(WS_STR_CONNECTION, WS_STR_UPGRADE); - addHeader(WS_STR_UPGRADE, T_WS); - addHeader(WS_STR_ACCEPT, buffer); -} - -void AsyncWebSocketResponse::_respond(AsyncWebServerRequest* request) { - if (_state == RESPONSE_FAILED) { - request->client()->close(true); - return; - } - String out(_assembleHead(request->version())); - request->client()->write(out.c_str(), _headLength); - _state = RESPONSE_WAIT_ACK; -} - -size_t AsyncWebSocketResponse::_ack(AsyncWebServerRequest* request, size_t len, uint32_t time) { - (void)time; - - if (len) - _server->_newClient(request); - - return 0; -} diff --git a/lib/ESPAsyncWebServer/src/AsyncWebSocket.h b/lib/ESPAsyncWebServer/src/AsyncWebSocket.h deleted file mode 100644 index 34256a7..0000000 --- a/lib/ESPAsyncWebServer/src/AsyncWebSocket.h +++ /dev/null @@ -1,379 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#ifndef ASYNCWEBSOCKET_H_ -#define ASYNCWEBSOCKET_H_ - -#include -#ifdef ESP32 - #include - #include - #ifndef WS_MAX_QUEUED_MESSAGES - #define WS_MAX_QUEUED_MESSAGES 32 - #endif -#elif defined(ESP8266) - #include - #ifndef WS_MAX_QUEUED_MESSAGES - #define WS_MAX_QUEUED_MESSAGES 8 - #endif -#elif defined(TARGET_RP2040) - #include - #ifndef WS_MAX_QUEUED_MESSAGES - #define WS_MAX_QUEUED_MESSAGES 32 - #endif -#endif - -#include - -#include -#include -#include - -#ifdef ESP8266 - #include - #ifdef CRYPTO_HASH_h // include Hash.h from espressif framework if the first include was from the crypto library - #include <../src/Hash.h> - #endif -#endif - -#ifndef DEFAULT_MAX_WS_CLIENTS - #ifdef ESP32 - #define DEFAULT_MAX_WS_CLIENTS 8 - #else - #define DEFAULT_MAX_WS_CLIENTS 4 - #endif -#endif - -using AsyncWebSocketSharedBuffer = std::shared_ptr>; - -class AsyncWebSocket; -class AsyncWebSocketResponse; -class AsyncWebSocketClient; -class AsyncWebSocketControl; - -typedef struct { - /** Message type as defined by enum AwsFrameType. - * Note: Applications will only see WS_TEXT and WS_BINARY. - * All other types are handled by the library. */ - uint8_t message_opcode; - /** Frame number of a fragmented message. */ - uint32_t num; - /** Is this the last frame in a fragmented message ?*/ - uint8_t final; - /** Is this frame masked? */ - uint8_t masked; - /** Message type as defined by enum AwsFrameType. - * This value is the same as message_opcode for non-fragmented - * messages, but may also be WS_CONTINUATION in a fragmented message. */ - uint8_t opcode; - /** Length of the current frame. - * This equals the total length of the message if num == 0 && final == true */ - uint64_t len; - /** Mask key */ - uint8_t mask[4]; - /** Offset of the data inside the current frame. */ - uint64_t index; -} AwsFrameInfo; - -typedef enum { WS_DISCONNECTED, - WS_CONNECTED, - WS_DISCONNECTING } AwsClientStatus; -typedef enum { WS_CONTINUATION, - WS_TEXT, - WS_BINARY, - WS_DISCONNECT = 0x08, - WS_PING, - WS_PONG } AwsFrameType; -typedef enum { WS_MSG_SENDING, - WS_MSG_SENT, - WS_MSG_ERROR } AwsMessageStatus; -typedef enum { WS_EVT_CONNECT, - WS_EVT_DISCONNECT, - WS_EVT_PONG, - WS_EVT_ERROR, - WS_EVT_DATA } AwsEventType; - -class AsyncWebSocketMessageBuffer { - friend AsyncWebSocket; - friend AsyncWebSocketClient; - - private: - AsyncWebSocketSharedBuffer _buffer; - - public: - AsyncWebSocketMessageBuffer() {} - explicit AsyncWebSocketMessageBuffer(size_t size); - AsyncWebSocketMessageBuffer(const uint8_t* data, size_t size); - //~AsyncWebSocketMessageBuffer(); - bool reserve(size_t size); - uint8_t* get() { return _buffer->data(); } - size_t length() const { return _buffer->size(); } -}; - -class AsyncWebSocketMessage { - private: - AsyncWebSocketSharedBuffer _WSbuffer; - uint8_t _opcode{WS_TEXT}; - bool _mask{false}; - AwsMessageStatus _status{WS_MSG_ERROR}; - size_t _sent{}; - size_t _ack{}; - size_t _acked{}; - - public: - AsyncWebSocketMessage(AsyncWebSocketSharedBuffer buffer, uint8_t opcode = WS_TEXT, bool mask = false); - - bool finished() const { return _status != WS_MSG_SENDING; } - bool betweenFrames() const { return _acked == _ack; } - - void ack(size_t len, uint32_t time); - size_t send(AsyncClient* client); -}; - -class AsyncWebSocketClient { - private: - AsyncClient* _client; - AsyncWebSocket* _server; - uint32_t _clientId; - AwsClientStatus _status; -#ifdef ESP32 - mutable std::mutex _lock; -#endif - std::deque _controlQueue; - std::deque _messageQueue; - bool closeWhenFull = true; - - uint8_t _pstate; - AwsFrameInfo _pinfo; - - uint32_t _lastMessageTime; - uint32_t _keepAlivePeriod; - - void _queueControl(uint8_t opcode, const uint8_t* data = NULL, size_t len = 0, bool mask = false); - void _queueMessage(AsyncWebSocketSharedBuffer buffer, uint8_t opcode = WS_TEXT, bool mask = false); - void _runQueue(); - void _clearQueue(); - - public: - void* _tempObject; - - AsyncWebSocketClient(AsyncWebServerRequest* request, AsyncWebSocket* server); - ~AsyncWebSocketClient(); - - // client id increments for the given server - uint32_t id() const { return _clientId; } - AwsClientStatus status() const { return _status; } - AsyncClient* client() { return _client; } - const AsyncClient* client() const { return _client; } - AsyncWebSocket* server() { return _server; } - const AsyncWebSocket* server() const { return _server; } - AwsFrameInfo const& pinfo() const { return _pinfo; } - - // - If "true" (default), the connection will be closed if the message queue is full. - // This is the default behavior in yubox-node-org, which is not silently discarding messages but instead closes the connection. - // The big issue with this behavior is that is can cause the UI to automatically re-create a new WS connection, which can be filled again, - // and so on, causing a resource exhaustion. - // - // - If "false", the incoming message will be discarded if the queue is full. - // This is the default behavior in the original ESPAsyncWebServer library from me-no-dev. - // This behavior allows the best performance at the expense of unreliable message delivery in case the queue is full (some messages may be lost). - // - // - In any case, when the queue is full, a message is logged. - // - IT is recommended to use the methods queueIsFull(), availableForWriteAll(), availableForWrite(clientId) to check if the queue is full before sending a message. - // - // Usage: - // - can be set in the onEvent listener when connecting (event type is: WS_EVT_CONNECT) - // - // Use cases:, - // - if using websocket to send logging messages, maybe some loss is acceptable. - // - But if using websocket to send UI update messages, maybe the connection should be closed and the UI redrawn. - void setCloseClientOnQueueFull(bool close) { closeWhenFull = close; } - bool willCloseClientOnQueueFull() const { return closeWhenFull; } - - IPAddress remoteIP() const; - uint16_t remotePort() const; - - bool shouldBeDeleted() const { return !_client; } - - // control frames - void close(uint16_t code = 0, const char* message = NULL); - void ping(const uint8_t* data = NULL, size_t len = 0); - - // set auto-ping period in seconds. disabled if zero (default) - void keepAlivePeriod(uint16_t seconds) { - _keepAlivePeriod = seconds * 1000; - } - uint16_t keepAlivePeriod() { - return (uint16_t)(_keepAlivePeriod / 1000); - } - - // data packets - void message(AsyncWebSocketSharedBuffer buffer, uint8_t opcode = WS_TEXT, bool mask = false) { _queueMessage(buffer, opcode, mask); } - bool queueIsFull() const; - size_t queueLen() const; - - size_t printf(const char* format, ...) __attribute__((format(printf, 2, 3))); - - void text(AsyncWebSocketSharedBuffer buffer); - void text(const uint8_t* message, size_t len); - void text(const char* message, size_t len); - void text(const char* message); - void text(const String& message); - void text(AsyncWebSocketMessageBuffer* buffer); - - void binary(AsyncWebSocketSharedBuffer buffer); - void binary(const uint8_t* message, size_t len); - void binary(const char* message, size_t len); - void binary(const char* message); - void binary(const String& message); - void binary(AsyncWebSocketMessageBuffer* buffer); - - bool canSend() const; - - // system callbacks (do not call) - void _onAck(size_t len, uint32_t time); - void _onError(int8_t); - void _onPoll(); - void _onTimeout(uint32_t time); - void _onDisconnect(); - void _onData(void* pbuf, size_t plen); - -#ifdef ESP8266 - size_t printf_P(PGM_P formatP, ...) __attribute__((format(printf, 2, 3))); - void text(const __FlashStringHelper* message); - void binary(const __FlashStringHelper* message, size_t len); -#endif -}; - -using AwsHandshakeHandler = std::function; -using AwsEventHandler = std::function; - -// WebServer Handler implementation that plays the role of a socket server -class AsyncWebSocket : public AsyncWebHandler { - private: - String _url; - std::list _clients; - uint32_t _cNextId; - AwsEventHandler _eventHandler{nullptr}; - AwsHandshakeHandler _handshakeHandler; - bool _enabled; -#ifdef ESP32 - mutable std::mutex _lock; -#endif - - public: - explicit AsyncWebSocket(const char* url) : _url(url), _cNextId(1), _enabled(true) {} - AsyncWebSocket(const String& url) : _url(url), _cNextId(1), _enabled(true) {} - ~AsyncWebSocket(){}; - const char* url() const { return _url.c_str(); } - void enable(bool e) { _enabled = e; } - bool enabled() const { return _enabled; } - bool availableForWriteAll(); - bool availableForWrite(uint32_t id); - - size_t count() const; - AsyncWebSocketClient* client(uint32_t id); - bool hasClient(uint32_t id) { return client(id) != nullptr; } - - void close(uint32_t id, uint16_t code = 0, const char* message = NULL); - void closeAll(uint16_t code = 0, const char* message = NULL); - void cleanupClients(uint16_t maxClients = DEFAULT_MAX_WS_CLIENTS); - - void ping(uint32_t id, const uint8_t* data = NULL, size_t len = 0); - void pingAll(const uint8_t* data = NULL, size_t len = 0); // done - - void text(uint32_t id, const uint8_t* message, size_t len); - void text(uint32_t id, const char* message, size_t len); - void text(uint32_t id, const char* message); - void text(uint32_t id, const String& message); - void text(uint32_t id, AsyncWebSocketMessageBuffer* buffer); - void text(uint32_t id, AsyncWebSocketSharedBuffer buffer); - - void textAll(const uint8_t* message, size_t len); - void textAll(const char* message, size_t len); - void textAll(const char* message); - void textAll(const String& message); - void textAll(AsyncWebSocketMessageBuffer* buffer); - void textAll(AsyncWebSocketSharedBuffer buffer); - - void binary(uint32_t id, const uint8_t* message, size_t len); - void binary(uint32_t id, const char* message, size_t len); - void binary(uint32_t id, const char* message); - void binary(uint32_t id, const String& message); - void binary(uint32_t id, AsyncWebSocketMessageBuffer* buffer); - void binary(uint32_t id, AsyncWebSocketSharedBuffer buffer); - - void binaryAll(const uint8_t* message, size_t len); - void binaryAll(const char* message, size_t len); - void binaryAll(const char* message); - void binaryAll(const String& message); - void binaryAll(AsyncWebSocketMessageBuffer* buffer); - void binaryAll(AsyncWebSocketSharedBuffer buffer); - - size_t printf(uint32_t id, const char* format, ...) __attribute__((format(printf, 3, 4))); - size_t printfAll(const char* format, ...) __attribute__((format(printf, 2, 3))); - -#ifdef ESP8266 - void text(uint32_t id, const __FlashStringHelper* message); - void textAll(const __FlashStringHelper* message); - void binary(uint32_t id, const __FlashStringHelper* message, size_t len); - void binaryAll(const __FlashStringHelper* message, size_t len); - size_t printf_P(uint32_t id, PGM_P formatP, ...) __attribute__((format(printf, 3, 4))); - size_t printfAll_P(PGM_P formatP, ...) __attribute__((format(printf, 2, 3))); -#endif - - // event listener - void onEvent(AwsEventHandler handler) { - _eventHandler = handler; - } - - // Handshake Handler - void handleHandshake(AwsHandshakeHandler handler) { - _handshakeHandler = handler; - } - - // system callbacks (do not call) - uint32_t _getNextId() { return _cNextId++; } - AsyncWebSocketClient* _newClient(AsyncWebServerRequest* request); - void _handleEvent(AsyncWebSocketClient* client, AwsEventType type, void* arg, uint8_t* data, size_t len); - virtual bool canHandle(AsyncWebServerRequest* request) override final; - virtual void handleRequest(AsyncWebServerRequest* request) override final; - - // messagebuffer functions/objects. - AsyncWebSocketMessageBuffer* makeBuffer(size_t size = 0); - AsyncWebSocketMessageBuffer* makeBuffer(const uint8_t* data, size_t size); - - const std::list& getClients() const { return _clients; } -}; - -// WebServer response to authenticate the socket and detach the tcp client from the web server request -class AsyncWebSocketResponse : public AsyncWebServerResponse { - private: - String _content; - AsyncWebSocket* _server; - - public: - AsyncWebSocketResponse(const String& key, AsyncWebSocket* server); - void _respond(AsyncWebServerRequest* request); - size_t _ack(AsyncWebServerRequest* request, size_t len, uint32_t time); - bool _sourceValid() const { return true; } -}; - -#endif /* ASYNCWEBSOCKET_H_ */ diff --git a/lib/ESPAsyncWebServer/src/ChunkPrint.h b/lib/ESPAsyncWebServer/src/ChunkPrint.h deleted file mode 100644 index 2f40741..0000000 --- a/lib/ESPAsyncWebServer/src/ChunkPrint.h +++ /dev/null @@ -1,32 +0,0 @@ -#ifndef CHUNKPRINT_H -#define CHUNKPRINT_H - -#include - -class ChunkPrint : public Print { - private: - uint8_t* _destination; - size_t _to_skip; - size_t _to_write; - size_t _pos; - - public: - ChunkPrint(uint8_t* destination, size_t from, size_t len) - : _destination(destination), _to_skip(from), _to_write(len), _pos{0} {} - virtual ~ChunkPrint() {} - size_t write(uint8_t c) { - if (_to_skip > 0) { - _to_skip--; - return 1; - } else if (_to_write > 0) { - _to_write--; - _destination[_pos++] = c; - return 1; - } - return 0; - } - size_t write(const uint8_t* buffer, size_t size) { - return this->Print::write(buffer, size); - } -}; -#endif diff --git a/lib/ESPAsyncWebServer/src/ESPAsyncWebServer.h b/lib/ESPAsyncWebServer/src/ESPAsyncWebServer.h deleted file mode 100644 index de08bc0..0000000 --- a/lib/ESPAsyncWebServer/src/ESPAsyncWebServer.h +++ /dev/null @@ -1,714 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#ifndef _ESPAsyncWebServer_H_ -#define _ESPAsyncWebServer_H_ - -#include "Arduino.h" - -#include "FS.h" -#include -#include -#include - -#ifdef ESP32 - #include - #include -#elif defined(ESP8266) - #include - #include -#elif defined(TARGET_RP2040) - #include - #include - #include - #include -#else - #error Platform not supported -#endif - -#include "literals.h" - -#define ASYNCWEBSERVER_VERSION "3.1.5" -#define ASYNCWEBSERVER_VERSION_MAJOR 3 -#define ASYNCWEBSERVER_VERSION_MINOR 1 -#define ASYNCWEBSERVER_VERSION_REVISION 5 -#define ASYNCWEBSERVER_FORK_mathieucarbou - -#ifdef ASYNCWEBSERVER_REGEX - #define ASYNCWEBSERVER_REGEX_ATTRIBUTE -#else - #define ASYNCWEBSERVER_REGEX_ATTRIBUTE __attribute__((warning("ASYNCWEBSERVER_REGEX not defined"))) -#endif - -class AsyncWebServer; -class AsyncWebServerRequest; -class AsyncWebServerResponse; -class AsyncWebHeader; -class AsyncWebParameter; -class AsyncWebRewrite; -class AsyncWebHandler; -class AsyncStaticWebHandler; -class AsyncCallbackWebHandler; -class AsyncResponseStream; - -#if defined(TARGET_RP2040) -typedef enum http_method WebRequestMethod; -#else - #ifndef WEBSERVER_H -typedef enum { - HTTP_GET = 0b00000001, - HTTP_POST = 0b00000010, - HTTP_DELETE = 0b00000100, - HTTP_PUT = 0b00001000, - HTTP_PATCH = 0b00010000, - HTTP_HEAD = 0b00100000, - HTTP_OPTIONS = 0b01000000, - HTTP_ANY = 0b01111111, -} WebRequestMethod; - #endif -#endif - -#ifndef HAVE_FS_FILE_OPEN_MODE -namespace fs { - class FileOpenMode { - public: - static const char* read; - static const char* write; - static const char* append; - }; -}; -#else - #include "FileOpenMode.h" -#endif - -// if this value is returned when asked for data, packet will not be sent and you will be asked for data again -#define RESPONSE_TRY_AGAIN 0xFFFFFFFF - -typedef uint8_t WebRequestMethodComposite; -typedef std::function ArDisconnectHandler; - -/* - * PARAMETER :: Chainable object to hold GET/POST and FILE parameters - * */ - -class AsyncWebParameter { - private: - String _name; - String _value; - size_t _size; - bool _isForm; - bool _isFile; - - public: - AsyncWebParameter(const String& name, const String& value, bool form = false, bool file = false, size_t size = 0) : _name(name), _value(value), _size(size), _isForm(form), _isFile(file) {} - const String& name() const { return _name; } - const String& value() const { return _value; } - size_t size() const { return _size; } - bool isPost() const { return _isForm; } - bool isFile() const { return _isFile; } -}; - -/* - * HEADER :: Chainable object to hold the headers - * */ - -class AsyncWebHeader { - private: - String _name; - String _value; - - public: - AsyncWebHeader() = default; - AsyncWebHeader(const AsyncWebHeader&) = default; - - AsyncWebHeader(const char* name, const char* value) : _name(name), _value(value) {} - AsyncWebHeader(const String& name, const String& value) : _name(name), _value(value) {} - AsyncWebHeader(const String& data) { - if (!data) - return; - int index = data.indexOf(':'); - if (index < 0) - return; - _name = data.substring(0, index); - _value = data.substring(index + 2); - } - - AsyncWebHeader& operator=(const AsyncWebHeader&) = default; - - const String& name() const { return _name; } - const String& value() const { return _value; } - String toString() const { - String str = _name; - str.concat((char)0x3a); - str.concat((char)0x20); - str.concat(_value); - str.concat(asyncsrv::T_rn); - return str; - } -}; - -/* - * REQUEST :: Each incoming Client is wrapped inside a Request and both live together until disconnect - * */ - -typedef enum { RCT_NOT_USED = -1, - RCT_DEFAULT = 0, - RCT_HTTP, - RCT_WS, - RCT_EVENT, - RCT_MAX } RequestedConnectionType; - -typedef std::function AwsResponseFiller; -typedef std::function AwsTemplateProcessor; - -class AsyncWebServerRequest { - using File = fs::File; - using FS = fs::FS; - friend class AsyncWebServer; - friend class AsyncCallbackWebHandler; - - private: - AsyncClient* _client; - AsyncWebServer* _server; - AsyncWebHandler* _handler; - AsyncWebServerResponse* _response; - std::vector _interestingHeaders; - ArDisconnectHandler _onDisconnectfn; - - String _temp; - uint8_t _parseState; - - uint8_t _version; - WebRequestMethodComposite _method; - String _url; - String _host; - String _contentType; - String _boundary; - String _authorization; - RequestedConnectionType _reqconntype; - void _removeNotInterestingHeaders(); - bool _isDigest; - bool _isMultipart; - bool _isPlainPost; - bool _expectingContinue; - size_t _contentLength; - size_t _parsedLength; - - std::list _headers; - std::list _params; - std::vector _pathParams; - - uint8_t _multiParseState; - uint8_t _boundaryPosition; - size_t _itemStartIndex; - size_t _itemSize; - String _itemName; - String _itemFilename; - String _itemType; - String _itemValue; - uint8_t* _itemBuffer; - size_t _itemBufferIndex; - bool _itemIsFile; - - void _onPoll(); - void _onAck(size_t len, uint32_t time); - void _onError(int8_t error); - void _onTimeout(uint32_t time); - void _onDisconnect(); - void _onData(void* buf, size_t len); - - void _addPathParam(const char* param); - - bool _parseReqHead(); - bool _parseReqHeader(); - void _parseLine(); - void _parsePlainPostChar(uint8_t data); - void _parseMultipartPostByte(uint8_t data, bool last); - void _addGetParams(const String& params); - - void _handleUploadStart(); - void _handleUploadByte(uint8_t data, bool last); - void _handleUploadEnd(); - - public: - File _tempFile; - void* _tempObject; - - AsyncWebServerRequest(AsyncWebServer*, AsyncClient*); - ~AsyncWebServerRequest(); - - AsyncClient* client() { return _client; } - uint8_t version() const { return _version; } - WebRequestMethodComposite method() const { return _method; } - const String& url() const { return _url; } - const String& host() const { return _host; } - const String& contentType() const { return _contentType; } - size_t contentLength() const { return _contentLength; } - bool multipart() const { return _isMultipart; } - -#ifndef ESP8266 - const char* methodToString() const; - const char* requestedConnTypeToString() const; -#else - const __FlashStringHelper* methodToString() const; - const __FlashStringHelper* requestedConnTypeToString() const; -#endif - - RequestedConnectionType requestedConnType() const { return _reqconntype; } - bool isExpectedRequestedConnType(RequestedConnectionType erct1, RequestedConnectionType erct2 = RCT_NOT_USED, RequestedConnectionType erct3 = RCT_NOT_USED); - void onDisconnect(ArDisconnectHandler fn); - - // hash is the string representation of: - // base64(user:pass) for basic or - // user:realm:md5(user:realm:pass) for digest - bool authenticate(const char* hash); - bool authenticate(const char* username, const char* password, const char* realm = NULL, bool passwordIsHash = false); - void requestAuthentication(const char* realm = NULL, bool isDigest = true); - - void setHandler(AsyncWebHandler* handler) { _handler = handler; } - - /** - * @brief add header to collect from a response - * - * @param name - */ - void addInterestingHeader(const char* name); - void addInterestingHeader(const String& name) { return addInterestingHeader(name.c_str()); }; - - /** - * @brief issue 302 redirect response - * - * @param url - */ - void redirect(const char* url); - void redirect(const String& url) { return redirect(url.c_str()); }; - - void send(AsyncWebServerResponse* response); - - void send(int code, const char* contentType = asyncsrv::empty, const char* content = asyncsrv::empty, AwsTemplateProcessor callback = nullptr) { send(beginResponse(code, contentType, content, callback)); } - void send(int code, const String& contentType, const String& content = emptyString, AwsTemplateProcessor callback = nullptr) { send(beginResponse(code, contentType, content, callback)); } - - void send(int code, const char* contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr) { send(beginResponse(code, contentType, content, len, callback)); } - void send(int code, const String& contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr) { send(beginResponse(code, contentType, content, len, callback)); } - - void send(FS& fs, const String& path, const char* contentType = asyncsrv::empty, bool download = false, AwsTemplateProcessor callback = nullptr) { - if (fs.exists(path) || (!download && fs.exists(path + asyncsrv::T__gz))) { - send(beginResponse(fs, path, contentType, download, callback)); - } else - send(404); - } - void send(FS& fs, const String& path, const String& contentType = emptyString, bool download = false, AwsTemplateProcessor callback = nullptr) { send(fs, path, contentType.c_str(), download, callback); } - - void send(File content, const String& path, const char* contentType = asyncsrv::empty, bool download = false, AwsTemplateProcessor callback = nullptr) { - if (content) { - send(beginResponse(content, path, contentType, download, callback)); - } else - send(404); - } - void send(File content, const String& path, const String& contentType = emptyString, bool download = false, AwsTemplateProcessor callback = nullptr) { send(content, path, contentType.c_str(), download, callback); } - - void send(Stream& stream, const char* contentType, size_t len, AwsTemplateProcessor callback = nullptr) { send(beginResponse(stream, contentType, len, callback)); } - void send(Stream& stream, const String& contentType, size_t len, AwsTemplateProcessor callback = nullptr) { send(beginResponse(stream, contentType, len, callback)); } - - void send(const char* contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) { send(beginResponse(contentType, len, callback, templateCallback)); } - void send(const String& contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) { send(beginResponse(contentType, len, callback, templateCallback)); } - - void sendChunked(const char* contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) { send(beginChunkedResponse(contentType, callback, templateCallback)); } - void sendChunked(const String& contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) { send(beginChunkedResponse(contentType, callback, templateCallback)); } - - [[deprecated("Replaced by send(...)")]] - void send_P(int code, const String& contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr) { - send(code, contentType, content, len, callback); - } - [[deprecated("Replaced by send(...)")]] - void send_P(int code, const String& contentType, PGM_P content, AwsTemplateProcessor callback = nullptr) { - send(code, contentType, content, callback); - } - -#ifdef ESP8266 - void send(int code, const String& contentType, PGM_P content, AwsTemplateProcessor callback = nullptr) { send(beginResponse(code, contentType, content, callback)); } -#endif - - AsyncWebServerResponse* beginResponse(int code, const char* contentType = asyncsrv::empty, const char* content = asyncsrv::empty, AwsTemplateProcessor callback = nullptr); - AsyncWebServerResponse* beginResponse(int code, const String& contentType, const String& content = emptyString, AwsTemplateProcessor callback = nullptr) { return beginResponse(code, contentType.c_str(), content.c_str(), callback); } - - AsyncWebServerResponse* beginResponse(int code, const char* contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr); - AsyncWebServerResponse* beginResponse(int code, const String& contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr) { return beginResponse(code, contentType.c_str(), content, len, callback); } - - AsyncWebServerResponse* beginResponse(FS& fs, const String& path, const char* contentType = asyncsrv::empty, bool download = false, AwsTemplateProcessor callback = nullptr); - AsyncWebServerResponse* beginResponse(FS& fs, const String& path, const String& contentType = emptyString, bool download = false, AwsTemplateProcessor callback = nullptr) { return beginResponse(fs, path, contentType.c_str(), download, callback); } - - AsyncWebServerResponse* beginResponse(File content, const String& path, const char* contentType = asyncsrv::empty, bool download = false, AwsTemplateProcessor callback = nullptr); - AsyncWebServerResponse* beginResponse(File content, const String& path, const String& contentType = emptyString, bool download = false, AwsTemplateProcessor callback = nullptr) { return beginResponse(content, path, contentType.c_str(), download, callback); } - - AsyncWebServerResponse* beginResponse(Stream& stream, const char* contentType, size_t len, AwsTemplateProcessor callback = nullptr); - AsyncWebServerResponse* beginResponse(Stream& stream, const String& contentType, size_t len, AwsTemplateProcessor callback = nullptr) { return beginResponse(stream, contentType.c_str(), len, callback); } - - AsyncWebServerResponse* beginResponse(const char* contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr); - AsyncWebServerResponse* beginResponse(const String& contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) { return beginResponse(contentType.c_str(), len, callback, templateCallback); } - - AsyncWebServerResponse* beginChunkedResponse(const char* contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr); - AsyncWebServerResponse* beginChunkedResponse(const String& contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr); - - AsyncResponseStream* beginResponseStream(const char* contentType, size_t bufferSize = 1460); - AsyncResponseStream* beginResponseStream(const String& contentType, size_t bufferSize = 1460) { return beginResponseStream(contentType.c_str(), bufferSize); } - - [[deprecated("Replaced by beginResponse(...)")]] - AsyncWebServerResponse* beginResponse_P(int code, const String& contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr) { - return beginResponse(code, contentType, content, len, callback); - } - [[deprecated("Replaced by beginResponse(...)")]] - AsyncWebServerResponse* beginResponse_P(int code, const String& contentType, PGM_P content, AwsTemplateProcessor callback = nullptr) { - return beginResponse(code, contentType, content, callback); - } - -#ifdef ESP8266 - AsyncWebServerResponse* beginResponse(int code, const String& contentType, PGM_P content, AwsTemplateProcessor callback = nullptr); -#endif - - size_t headers() const; // get header count - - // check if header exists - bool hasHeader(const char* name) const; - bool hasHeader(const String& name) const { return hasHeader(name.c_str()); }; -#ifdef ESP8266 - bool hasHeader(const __FlashStringHelper* data) const; // check if header exists -#endif - - const AsyncWebHeader* getHeader(const char* name) const; - const AsyncWebHeader* getHeader(const String& name) const { return getHeader(name.c_str()); }; -#ifdef ESP8266 - const AsyncWebHeader* getHeader(const __FlashStringHelper* data) const; -#endif - const AsyncWebHeader* getHeader(size_t num) const; - - size_t params() const; // get arguments count - bool hasParam(const char* name, bool post = false, bool file = false) const; - bool hasParam(const String& name, bool post = false, bool file = false) const { return hasParam(name.c_str(), post, file); }; -#ifdef ESP8266 - bool hasParam(const __FlashStringHelper* data, bool post = false, bool file = false) const { return hasParam(String(data).c_str(), post, file); }; -#endif - - /** - * @brief Get the Request parameter by name - * - * @param name - * @param post - * @param file - * @return const AsyncWebParameter* - */ - const AsyncWebParameter* getParam(const char* name, bool post = false, bool file = false) const; - - const AsyncWebParameter* getParam(const String& name, bool post = false, bool file = false) const { return getParam(name.c_str(), post, file); }; -#ifdef ESP8266 - const AsyncWebParameter* getParam(const __FlashStringHelper* data, bool post, bool file) const; -#endif - - /** - * @brief Get request parameter by number - * i.e., n-th parameter - * @param num - * @return const AsyncWebParameter* - */ - const AsyncWebParameter* getParam(size_t num) const; - - size_t args() const { return params(); } // get arguments count - - // get request argument value by name - const String& arg(const char* name) const; - // get request argument value by name - const String& arg(const String& name) const { return arg(name.c_str()); }; -#ifdef ESP8266 - const String& arg(const __FlashStringHelper* data) const; // get request argument value by F(name) -#endif - const String& arg(size_t i) const; // get request argument value by number - const String& argName(size_t i) const; // get request argument name by number - bool hasArg(const char* name) const; // check if argument exists - bool hasArg(const String& name) const { return hasArg(name.c_str()); }; -#ifdef ESP8266 - bool hasArg(const __FlashStringHelper* data) const; // check if F(argument) exists -#endif - - const String& ASYNCWEBSERVER_REGEX_ATTRIBUTE pathArg(size_t i) const; - - // get request header value by name - const String& header(const char* name) const; - const String& header(const String& name) const { return header(name.c_str()); }; - -#ifdef ESP8266 - const String& header(const __FlashStringHelper* data) const; // get request header value by F(name) -#endif - - const String& header(size_t i) const; // get request header value by number - const String& headerName(size_t i) const; // get request header name by number - - String urlDecode(const String& text) const; -}; - -/* - * FILTER :: Callback to filter AsyncWebRewrite and AsyncWebHandler (done by the Server) - * */ - -using ArRequestFilterFunction = std::function; - -bool ON_STA_FILTER(AsyncWebServerRequest* request); - -bool ON_AP_FILTER(AsyncWebServerRequest* request); - -/* - * REWRITE :: One instance can be handle any Request (done by the Server) - * */ - -class AsyncWebRewrite { - protected: - String _from; - String _toUrl; - String _params; - ArRequestFilterFunction _filter{nullptr}; - - public: - AsyncWebRewrite(const char* from, const char* to) : _from(from), _toUrl(to) { - int index = _toUrl.indexOf('?'); - if (index > 0) { - _params = _toUrl.substring(index + 1); - _toUrl = _toUrl.substring(0, index); - } - } - virtual ~AsyncWebRewrite() {} - AsyncWebRewrite& setFilter(ArRequestFilterFunction fn) { - _filter = fn; - return *this; - } - bool filter(AsyncWebServerRequest* request) const { return _filter == NULL || _filter(request); } - const String& from(void) const { return _from; } - const String& toUrl(void) const { return _toUrl; } - const String& params(void) const { return _params; } - virtual bool match(AsyncWebServerRequest* request) { return from() == request->url() && filter(request); } -}; - -/* - * HANDLER :: One instance can be attached to any Request (done by the Server) - * */ - -class AsyncWebHandler { - protected: - ArRequestFilterFunction _filter{nullptr}; - String _username; - String _password; - - public: - AsyncWebHandler() {} - AsyncWebHandler& setFilter(ArRequestFilterFunction fn) { - _filter = fn; - return *this; - } - AsyncWebHandler& setAuthentication(const char* username, const char* password) { - _username = username; - _password = password; - return *this; - }; - AsyncWebHandler& setAuthentication(const String& username, const String& password) { - _username = username; - _password = password; - return *this; - }; - bool filter(AsyncWebServerRequest* request) { return _filter == NULL || _filter(request); } - virtual ~AsyncWebHandler() {} - virtual bool canHandle(AsyncWebServerRequest* request __attribute__((unused))) { - return false; - } - virtual void handleRequest(AsyncWebServerRequest* request __attribute__((unused))) {} - virtual void handleUpload(AsyncWebServerRequest* request __attribute__((unused)), const String& filename __attribute__((unused)), size_t index __attribute__((unused)), uint8_t* data __attribute__((unused)), size_t len __attribute__((unused)), bool final __attribute__((unused))) {} - virtual void handleBody(AsyncWebServerRequest* request __attribute__((unused)), uint8_t* data __attribute__((unused)), size_t len __attribute__((unused)), size_t index __attribute__((unused)), size_t total __attribute__((unused))) {} - virtual bool isRequestHandlerTrivial() { return true; } -}; - -/* - * RESPONSE :: One instance is created for each Request (attached by the Handler) - * */ - -typedef enum { - RESPONSE_SETUP, - RESPONSE_HEADERS, - RESPONSE_CONTENT, - RESPONSE_WAIT_ACK, - RESPONSE_END, - RESPONSE_FAILED -} WebResponseState; - -class AsyncWebServerResponse { - protected: - int _code; - std::list _headers; - String _contentType; - size_t _contentLength; - bool _sendContentLength; - bool _chunked; - size_t _headLength; - size_t _sentLength; - size_t _ackedLength; - size_t _writtenLength; - WebResponseState _state; - - public: -#ifndef ESP8266 - static const char* responseCodeToString(int code); -#else - static const __FlashStringHelper* responseCodeToString(int code); -#endif - - public: - AsyncWebServerResponse(); - virtual ~AsyncWebServerResponse(); - virtual void setCode(int code); - virtual void setContentLength(size_t len); - void setContentType(const String& type) { setContentType(type.c_str()); } - virtual void setContentType(const char* type); - virtual void addHeader(const char* name, const char* value); - void addHeader(const String& name, const String& value) { addHeader(name.c_str(), value.c_str()); } - virtual String _assembleHead(uint8_t version); - virtual bool _started() const; - virtual bool _finished() const; - virtual bool _failed() const; - virtual bool _sourceValid() const; - virtual void _respond(AsyncWebServerRequest* request); - virtual size_t _ack(AsyncWebServerRequest* request, size_t len, uint32_t time); -}; - -/* - * SERVER :: One instance - * */ - -typedef std::function ArRequestHandlerFunction; -typedef std::function ArUploadHandlerFunction; -typedef std::function ArBodyHandlerFunction; - -class AsyncWebServer { - protected: - AsyncServer _server; - std::list> _rewrites; - std::list> _handlers; - AsyncCallbackWebHandler* _catchAllHandler; - - public: - AsyncWebServer(uint16_t port); - ~AsyncWebServer(); - - void begin(); - void end(); - -#if ASYNC_TCP_SSL_ENABLED - void onSslFileRequest(AcSSlFileHandler cb, void* arg); - void beginSecure(const char* cert, const char* private_key_file, const char* password); -#endif - - AsyncWebRewrite& addRewrite(AsyncWebRewrite* rewrite); - - /** - * @brief (compat) Add url rewrite rule by pointer - * a deep copy of the pounter object will be created, - * it is up to user to manage further lifetime of the object in argument - * - * @param rewrite pointer to rewrite object to copy setting from - * @return AsyncWebRewrite& reference to a newly created rewrite rule - */ - AsyncWebRewrite& addRewrite(std::shared_ptr rewrite); - - /** - * @brief add url rewrite rule - * - * @param from - * @param to - * @return AsyncWebRewrite& - */ - AsyncWebRewrite& rewrite(const char* from, const char* to); - - /** - * @brief (compat) remove rewrite rule via referenced object - * this will NOT deallocate pointed object itself, internal rule with same from/to urls will be removed if any - * it's a compat method, better use `removeRewrite(const char* from, const char* to)` - * @param rewrite - * @return true - * @return false - */ - bool removeRewrite(AsyncWebRewrite* rewrite); - - /** - * @brief remove rewrite rule - * - * @param from - * @param to - * @return true - * @return false - */ - bool removeRewrite(const char* from, const char* to); - - AsyncWebHandler& addHandler(AsyncWebHandler* handler); - bool removeHandler(AsyncWebHandler* handler); - - AsyncCallbackWebHandler& on(const char* uri, ArRequestHandlerFunction onRequest); - AsyncCallbackWebHandler& on(const char* uri, WebRequestMethodComposite method, ArRequestHandlerFunction onRequest); - AsyncCallbackWebHandler& on(const char* uri, WebRequestMethodComposite method, ArRequestHandlerFunction onRequest, ArUploadHandlerFunction onUpload); - AsyncCallbackWebHandler& on(const char* uri, WebRequestMethodComposite method, ArRequestHandlerFunction onRequest, ArUploadHandlerFunction onUpload, ArBodyHandlerFunction onBody); - - AsyncStaticWebHandler& serveStatic(const char* uri, fs::FS& fs, const char* path, const char* cache_control = NULL); - - void onNotFound(ArRequestHandlerFunction fn); // called when handler is not assigned - void onFileUpload(ArUploadHandlerFunction fn); // handle file uploads - void onRequestBody(ArBodyHandlerFunction fn); // handle posts with plain body content (JSON often transmitted this way as a request) - - void reset(); // remove all writers and handlers, with onNotFound/onFileUpload/onRequestBody - - void _handleDisconnect(AsyncWebServerRequest* request); - void _attachHandler(AsyncWebServerRequest* request); - void _rewriteRequest(AsyncWebServerRequest* request); -}; - -class DefaultHeaders { - using headers_t = std::list; - headers_t _headers; - - public: - DefaultHeaders() = default; - - using ConstIterator = headers_t::const_iterator; - - void addHeader(const String& name, const String& value) { - _headers.emplace_back(name, value); - } - - ConstIterator begin() const { return _headers.begin(); } - ConstIterator end() const { return _headers.end(); } - - DefaultHeaders(DefaultHeaders const&) = delete; - DefaultHeaders& operator=(DefaultHeaders const&) = delete; - - static DefaultHeaders& Instance() { - static DefaultHeaders instance; - return instance; - } -}; - -#include "AsyncEventSource.h" -#include "AsyncWebSocket.h" -#include "WebHandlerImpl.h" -#include "WebResponseImpl.h" - -#endif /* _AsyncWebServer_H_ */ diff --git a/lib/ESPAsyncWebServer/src/WebAuthentication.cpp b/lib/ESPAsyncWebServer/src/WebAuthentication.cpp deleted file mode 100644 index b5962fc..0000000 --- a/lib/ESPAsyncWebServer/src/WebAuthentication.cpp +++ /dev/null @@ -1,249 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "WebAuthentication.h" -#include -#if defined(ESP32) || defined(TARGET_RP2040) - #include -#else - #include "md5.h" -#endif -#include "literals.h" - -using namespace asyncsrv; - -// Basic Auth hash = base64("username:password") - -bool checkBasicAuthentication(const char* hash, const char* username, const char* password) { - if (username == NULL || password == NULL || hash == NULL) - return false; - - size_t toencodeLen = strlen(username) + strlen(password) + 1; - size_t encodedLen = base64_encode_expected_len(toencodeLen); - if (strlen(hash) != encodedLen) -// Fix from https://github.com/me-no-dev/ESPAsyncWebServer/issues/667 -#ifdef ARDUINO_ARCH_ESP32 - if (strlen(hash) != encodedLen) -#else - if (strlen(hash) != encodedLen - 1) -#endif - return false; - - char* toencode = new char[toencodeLen + 1]; - if (toencode == NULL) { - return false; - } - char* encoded = new char[base64_encode_expected_len(toencodeLen) + 1]; - if (encoded == NULL) { - delete[] toencode; - return false; - } - sprintf_P(toencode, PSTR("%s:%s"), username, password); - if (base64_encode_chars(toencode, toencodeLen, encoded) > 0 && memcmp(hash, encoded, encodedLen) == 0) { - delete[] toencode; - delete[] encoded; - return true; - } - delete[] toencode; - delete[] encoded; - return false; -} - -static bool getMD5(uint8_t* data, uint16_t len, char* output) { // 33 bytes or more -#if defined(ESP32) || defined(TARGET_RP2040) - MD5Builder md5; - md5.begin(); - md5.add(data, len); - md5.calculate(); - md5.getChars(output); -#else - md5_context_t _ctx; - - uint8_t* _buf = (uint8_t*)malloc(16); - if (_buf == NULL) - return false; - memset(_buf, 0x00, 16); - - MD5Init(&_ctx); - MD5Update(&_ctx, data, len); - MD5Final(_buf, &_ctx); - - for (uint8_t i = 0; i < 16; i++) { - sprintf_P(output + (i * 2), PSTR("%02x"), _buf[i]); - } - - free(_buf); -#endif - return true; -} - -static String genRandomMD5() { -#ifdef ESP8266 - uint32_t r = RANDOM_REG32; -#else - uint32_t r = rand(); -#endif - char* out = (char*)malloc(33); - if (out == NULL || !getMD5((uint8_t*)(&r), 4, out)) - return emptyString; - String res = String(out); - free(out); - return res; -} - -static String stringMD5(const String& in) { - char* out = (char*)malloc(33); - if (out == NULL || !getMD5((uint8_t*)(in.c_str()), in.length(), out)) - return emptyString; - String res = String(out); - free(out); - return res; -} - -String generateDigestHash(const char* username, const char* password, const char* realm) { - if (username == NULL || password == NULL || realm == NULL) { - return emptyString; - } - char* out = (char*)malloc(33); - String res = String(username); - res += ':'; - res.concat(realm); - res += ':'; - String in = res; - in.concat(password); - if (out == NULL || !getMD5((uint8_t*)(in.c_str()), in.length(), out)) - return emptyString; - res.concat(out); - free(out); - return res; -} - -String requestDigestAuthentication(const char* realm) { - String header(T_realm__); - if (realm == NULL) - header.concat(T_asyncesp); - else - header.concat(realm); - header.concat(T_auth_nonce); - header.concat(genRandomMD5()); - header.concat(T__opaque); - header.concat(genRandomMD5()); - header += (char)0x22; // '"' - return header; -} - -#ifndef ESP8266 -bool checkDigestAuthentication(const char* header, const char* method, const char* username, const char* password, const char* realm, bool passwordIsHash, const char* nonce, const char* opaque, const char* uri) -#else -bool checkDigestAuthentication(const char* header, const __FlashStringHelper* method, const char* username, const char* password, const char* realm, bool passwordIsHash, const char* nonce, const char* opaque, const char* uri) -#endif -{ - if (username == NULL || password == NULL || header == NULL || method == NULL) { - // os_printf("AUTH FAIL: missing requred fields\n"); - return false; - } - - String myHeader(header); - int nextBreak = myHeader.indexOf(','); - if (nextBreak < 0) { - // os_printf("AUTH FAIL: no variables\n"); - return false; - } - - String myUsername; - String myRealm; - String myNonce; - String myUri; - String myResponse; - String myQop; - String myNc; - String myCnonce; - - myHeader += (char)0x2c; // ',' - myHeader += (char)0x20; // ' ' - do { - String avLine(myHeader.substring(0, nextBreak)); - avLine.trim(); - myHeader = myHeader.substring(nextBreak + 1); - nextBreak = myHeader.indexOf(','); - - int eqSign = avLine.indexOf('='); - if (eqSign < 0) { - // os_printf("AUTH FAIL: no = sign\n"); - return false; - } - String varName(avLine.substring(0, eqSign)); - avLine = avLine.substring(eqSign + 1); - if (avLine.startsWith(String('"'))) { - avLine = avLine.substring(1, avLine.length() - 1); - } - - if (varName.equals(T_username)) { - if (!avLine.equals(username)) { - // os_printf("AUTH FAIL: username\n"); - return false; - } - myUsername = avLine; - } else if (varName.equals(T_realm)) { - if (realm != NULL && !avLine.equals(realm)) { - // os_printf("AUTH FAIL: realm\n"); - return false; - } - myRealm = avLine; - } else if (varName.equals(T_nonce)) { - if (nonce != NULL && !avLine.equals(nonce)) { - // os_printf("AUTH FAIL: nonce\n"); - return false; - } - myNonce = avLine; - } else if (varName.equals(T_opaque)) { - if (opaque != NULL && !avLine.equals(opaque)) { - // os_printf("AUTH FAIL: opaque\n"); - return false; - } - } else if (varName.equals(T_uri)) { - if (uri != NULL && !avLine.equals(uri)) { - // os_printf("AUTH FAIL: uri\n"); - return false; - } - myUri = avLine; - } else if (varName.equals(T_response)) { - myResponse = avLine; - } else if (varName.equals(T_qop)) { - myQop = avLine; - } else if (varName.equals(T_nc)) { - myNc = avLine; - } else if (varName.equals(T_cnonce)) { - myCnonce = avLine; - } - } while (nextBreak > 0); - - String ha1 = (passwordIsHash) ? String(password) : stringMD5(myUsername + ':' + myRealm + ':' + password); - String ha2 = String(method) + ':' + myUri; - String response = ha1 + ':' + myNonce + ':' + myNc + ':' + myCnonce + ':' + myQop + ':' + stringMD5(ha2); - - if (myResponse.equals(stringMD5(response))) { - // os_printf("AUTH SUCCESS\n"); - return true; - } - - // os_printf("AUTH FAIL: password\n"); - return false; -} diff --git a/lib/ESPAsyncWebServer/src/WebAuthentication.h b/lib/ESPAsyncWebServer/src/WebAuthentication.h deleted file mode 100644 index d519777..0000000 --- a/lib/ESPAsyncWebServer/src/WebAuthentication.h +++ /dev/null @@ -1,39 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ - -#ifndef WEB_AUTHENTICATION_H_ -#define WEB_AUTHENTICATION_H_ - -#include "Arduino.h" - -bool checkBasicAuthentication(const char* header, const char* username, const char* password); -String requestDigestAuthentication(const char* realm); - -bool checkDigestAuthentication(const char* header, const char* method, const char* username, const char* password, const char* realm, bool passwordIsHash, const char* nonce, const char* opaque, const char* uri); - -#ifdef ESP8266 -bool checkDigestAuthentication(const char* header, const __FlashStringHelper* method, const char* username, const char* password, const char* realm, bool passwordIsHash, const char* nonce, const char* opaque, const char* uri); -#endif - -// for storing hashed versions on the device that can be authenticated against -String generateDigestHash(const char* username, const char* password, const char* realm); - -#endif diff --git a/lib/ESPAsyncWebServer/src/WebHandlerImpl.h b/lib/ESPAsyncWebServer/src/WebHandlerImpl.h deleted file mode 100644 index 22757d7..0000000 --- a/lib/ESPAsyncWebServer/src/WebHandlerImpl.h +++ /dev/null @@ -1,155 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#ifndef ASYNCWEBSERVERHANDLERIMPL_H_ -#define ASYNCWEBSERVERHANDLERIMPL_H_ - -#include -#ifdef ASYNCWEBSERVER_REGEX - #include -#endif - -#include "stddef.h" -#include - -class AsyncStaticWebHandler : public AsyncWebHandler { - using File = fs::File; - using FS = fs::FS; - - private: - bool _getFile(AsyncWebServerRequest* request); - bool _fileExists(AsyncWebServerRequest* request, const String& path); - uint8_t _countBits(const uint8_t value) const; - - protected: - FS _fs; - String _uri; - String _path; - String _default_file; - String _cache_control; - String _last_modified; - AwsTemplateProcessor _callback; - bool _isDir; - bool _gzipFirst; - uint8_t _gzipStats; - - public: - AsyncStaticWebHandler(const char* uri, FS& fs, const char* path, const char* cache_control); - virtual bool canHandle(AsyncWebServerRequest* request) override final; - virtual void handleRequest(AsyncWebServerRequest* request) override final; - AsyncStaticWebHandler& setIsDir(bool isDir); - AsyncStaticWebHandler& setDefaultFile(const char* filename); - AsyncStaticWebHandler& setCacheControl(const char* cache_control); - AsyncStaticWebHandler& setLastModified(const char* last_modified); - AsyncStaticWebHandler& setLastModified(struct tm* last_modified); -#ifdef ESP8266 - AsyncStaticWebHandler& setLastModified(time_t last_modified); - AsyncStaticWebHandler& setLastModified(); // sets to current time. Make sure sntp is runing and time is updated -#endif - AsyncStaticWebHandler& setTemplateProcessor(AwsTemplateProcessor newCallback) { - _callback = newCallback; - return *this; - } -}; - -class AsyncCallbackWebHandler : public AsyncWebHandler { - private: - protected: - String _uri; - WebRequestMethodComposite _method; - ArRequestHandlerFunction _onRequest; - ArUploadHandlerFunction _onUpload; - ArBodyHandlerFunction _onBody; - bool _isRegex; - - public: - AsyncCallbackWebHandler() : _uri(), _method(HTTP_ANY), _onRequest(NULL), _onUpload(NULL), _onBody(NULL), _isRegex(false) {} - void setUri(const String& uri) { - _uri = uri; - _isRegex = uri.startsWith("^") && uri.endsWith("$"); - } - void setMethod(WebRequestMethodComposite method) { _method = method; } - void onRequest(ArRequestHandlerFunction fn) { _onRequest = fn; } - void onUpload(ArUploadHandlerFunction fn) { _onUpload = fn; } - void onBody(ArBodyHandlerFunction fn) { _onBody = fn; } - - virtual bool canHandle(AsyncWebServerRequest* request) override final { - - if (!_onRequest) - return false; - - if (!(_method & request->method())) - return false; - -#ifdef ASYNCWEBSERVER_REGEX - if (_isRegex) { - std::regex pattern(_uri.c_str()); - std::smatch matches; - std::string s(request->url().c_str()); - if (std::regex_search(s, matches, pattern)) { - for (size_t i = 1; i < matches.size(); ++i) { // start from 1 - request->_addPathParam(matches[i].str().c_str()); - } - } else { - return false; - } - } else -#endif - if (_uri.length() && _uri.startsWith("/*.")) { - String uriTemplate = String(_uri); - uriTemplate = uriTemplate.substring(uriTemplate.lastIndexOf(".")); - if (!request->url().endsWith(uriTemplate)) - return false; - } else if (_uri.length() && _uri.endsWith("*")) { - String uriTemplate = String(_uri); - uriTemplate = uriTemplate.substring(0, uriTemplate.length() - 1); - if (!request->url().startsWith(uriTemplate)) - return false; - } else if (_uri.length() && (_uri != request->url() && !request->url().startsWith(_uri + "/"))) - return false; - - request->addInterestingHeader("ANY"); - return true; - } - - virtual void handleRequest(AsyncWebServerRequest* request) override final { - if ((_username != "" && _password != "") && !request->authenticate(_username.c_str(), _password.c_str())) - return request->requestAuthentication(); - if (_onRequest) - _onRequest(request); - else - request->send(500); - } - virtual void handleUpload(AsyncWebServerRequest* request, const String& filename, size_t index, uint8_t* data, size_t len, bool final) override final { - if ((_username != "" && _password != "") && !request->authenticate(_username.c_str(), _password.c_str())) - return request->requestAuthentication(); - if (_onUpload) - _onUpload(request, filename, index, data, len, final); - } - virtual void handleBody(AsyncWebServerRequest* request, uint8_t* data, size_t len, size_t index, size_t total) override final { - if ((_username != "" && _password != "") && !request->authenticate(_username.c_str(), _password.c_str())) - return request->requestAuthentication(); - if (_onBody) - _onBody(request, data, len, index, total); - } - virtual bool isRequestHandlerTrivial() override final { return _onRequest ? false : true; } -}; - -#endif /* ASYNCWEBSERVERHANDLERIMPL_H_ */ diff --git a/lib/ESPAsyncWebServer/src/WebHandlers.cpp b/lib/ESPAsyncWebServer/src/WebHandlers.cpp deleted file mode 100644 index d904a39..0000000 --- a/lib/ESPAsyncWebServer/src/WebHandlers.cpp +++ /dev/null @@ -1,250 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "ESPAsyncWebServer.h" -#include "WebHandlerImpl.h" - -using namespace asyncsrv; - - -AsyncStaticWebHandler::AsyncStaticWebHandler(const char* uri, FS& fs, const char* path, const char* cache_control) - : _fs(fs), _uri(uri), _path(path), _default_file(F("index.htm")), _cache_control(cache_control), _last_modified(), _callback(nullptr) { - // Ensure leading '/' - if (_uri.length() == 0 || _uri[0] != '/') - _uri = String('/') + _uri; - if (_path.length() == 0 || _path[0] != '/') - _path = String('/') + _path; - - // If path ends with '/' we assume a hint that this is a directory to improve performance. - // However - if it does not end with '/' we, can't assume a file, path can still be a directory. - _isDir = _path[_path.length() - 1] == '/'; - - // Remove the trailing '/' so we can handle default file - // Notice that root will be "" not "/" - if (_uri[_uri.length() - 1] == '/') - _uri = _uri.substring(0, _uri.length() - 1); - if (_path[_path.length() - 1] == '/') - _path = _path.substring(0, _path.length() - 1); - - // Reset stats - _gzipFirst = false; - _gzipStats = 0xF8; -} - -AsyncStaticWebHandler& AsyncStaticWebHandler::setIsDir(bool isDir) { - _isDir = isDir; - return *this; -} - -AsyncStaticWebHandler& AsyncStaticWebHandler::setDefaultFile(const char* filename) { - _default_file = String(filename); - return *this; -} - -AsyncStaticWebHandler& AsyncStaticWebHandler::setCacheControl(const char* cache_control) { - _cache_control = String(cache_control); - return *this; -} - -AsyncStaticWebHandler& AsyncStaticWebHandler::setLastModified(const char* last_modified) { - _last_modified = last_modified; - return *this; -} - -AsyncStaticWebHandler& AsyncStaticWebHandler::setLastModified(struct tm* last_modified) { - auto formatP = PSTR("%a, %d %b %Y %H:%M:%S %Z"); - char format[strlen_P(formatP) + 1]; - strcpy_P(format, formatP); - - char result[30]; - strftime(result, sizeof(result), format, last_modified); - return setLastModified((const char*)result); -} - -#ifdef ESP8266 -AsyncStaticWebHandler& AsyncStaticWebHandler::setLastModified(time_t last_modified) { - return setLastModified((struct tm*)gmtime(&last_modified)); -} - -AsyncStaticWebHandler& AsyncStaticWebHandler::setLastModified() { - time_t last_modified; - if (time(&last_modified) == 0) // time is not yet set - return *this; - return setLastModified(last_modified); -} -#endif -bool AsyncStaticWebHandler::canHandle(AsyncWebServerRequest* request) { - if (request->method() != HTTP_GET || !request->url().startsWith(_uri) || !request->isExpectedRequestedConnType(RCT_DEFAULT, RCT_HTTP)) { - return false; - } - if (_getFile(request)) { - // We interested in "If-Modified-Since" header to check if file was modified - if (_last_modified.length()) - request->addInterestingHeader(F("If-Modified-Since")); - - if (_cache_control.length()) - request->addInterestingHeader(F("If-None-Match")); - - return true; - } - - return false; -} - -bool AsyncStaticWebHandler::_getFile(AsyncWebServerRequest* request) { - // Remove the found uri - String path = request->url().substring(_uri.length()); - - // We can skip the file check and look for default if request is to the root of a directory or that request path ends with '/' - bool canSkipFileCheck = (_isDir && path.length() == 0) || (path.length() && path[path.length() - 1] == '/'); - - path = _path + path; - - // Do we have a file or .gz file - if (!canSkipFileCheck && _fileExists(request, path)) - return true; - - // Can't handle if not default file - if (_default_file.length() == 0) - return false; - - // Try to add default file, ensure there is a trailing '/' ot the path. - if (path.length() == 0 || path[path.length() - 1] != '/') - path += String('/'); - path += _default_file; - - return _fileExists(request, path); -} - -#ifdef ESP32 - #define FILE_IS_REAL(f) (f == true && !f.isDirectory()) -#else - #define FILE_IS_REAL(f) (f == true) -#endif - -bool AsyncStaticWebHandler::_fileExists(AsyncWebServerRequest* request, const String& path) { - bool fileFound = false; - bool gzipFound = false; - - String gzip = path + F(".gz"); - - if (_gzipFirst) { - if (_fs.exists(gzip)) { - request->_tempFile = _fs.open(gzip, fs::FileOpenMode::read); - gzipFound = FILE_IS_REAL(request->_tempFile); - } - if (!gzipFound) { - if (_fs.exists(path)) { - request->_tempFile = _fs.open(path, fs::FileOpenMode::read); - fileFound = FILE_IS_REAL(request->_tempFile); - } - } - } else { - if (_fs.exists(path)) { - request->_tempFile = _fs.open(path, fs::FileOpenMode::read); - fileFound = FILE_IS_REAL(request->_tempFile); - } - if (!fileFound) { - if (_fs.exists(gzip)) { - request->_tempFile = _fs.open(gzip, fs::FileOpenMode::read); - gzipFound = FILE_IS_REAL(request->_tempFile); - } - } - } - - bool found = fileFound || gzipFound; - - if (found) { - // Extract the file name from the path and keep it in _tempObject - size_t pathLen = path.length(); - char* _tempPath = (char*)malloc(pathLen + 1); - snprintf_P(_tempPath, pathLen + 1, PSTR("%s"), path.c_str()); - request->_tempObject = (void*)_tempPath; - - // Calculate gzip statistic - _gzipStats = (_gzipStats << 1) + (gzipFound ? 1 : 0); - if (_gzipStats == 0x00) - _gzipFirst = false; // All files are not gzip - else if (_gzipStats == 0xFF) - _gzipFirst = true; // All files are gzip - else - _gzipFirst = _countBits(_gzipStats) > 4; // IF we have more gzip files - try gzip first - } - - return found; -} - -uint8_t AsyncStaticWebHandler::_countBits(const uint8_t value) const { - uint8_t w = value; - uint8_t n; - for (n = 0; w != 0; n++) - w &= w - 1; - return n; -} - -void AsyncStaticWebHandler::handleRequest(AsyncWebServerRequest* request) { - // Get the filename from request->_tempObject and free it - String filename = String((char*)request->_tempObject); - free(request->_tempObject); - request->_tempObject = NULL; - if ((_username.length() && _password.length()) && !request->authenticate(_username.c_str(), _password.c_str())) - return request->requestAuthentication(); - - if (request->_tempFile == true) { - time_t lw = request->_tempFile.getLastWrite(); // get last file mod time (if supported by FS) - // set etag to lastmod timestamp if available, otherwise to size - String etag; - if (lw) { - setLastModified(gmtime(&lw)); -#if defined(TARGET_RP2040) - // time_t == long long int - const size_t len = 1 + 8 * sizeof(time_t); - char buf[len]; - char* ret = lltoa(lw, buf, len, 10); - etag = ret ? String(ret) : String(request->_tempFile.size()); -#else - etag = String(lw); -#endif - } else { - etag = String(request->_tempFile.size()); - } - if (_last_modified.length() && _last_modified == request->header(T_IMS)) { - request->_tempFile.close(); - request->send(304); // Not modified - } else if (_cache_control.length() && request->hasHeader(T_INM) && request->header(T_INM).equals(etag)) { - request->_tempFile.close(); - AsyncWebServerResponse* response = new AsyncBasicResponse(304); // Not modified - response->addHeader(T_Cache_Control, _cache_control.c_str()); - response->addHeader(T_ETag, etag.c_str()); - request->send(response); - } else { - AsyncWebServerResponse* response = new AsyncFileResponse(request->_tempFile, filename, String(), false, _callback); - if (_last_modified.length()) - response->addHeader(T_Last_Modified, _last_modified.c_str()); - if (_cache_control.length()) { - response->addHeader(T_Cache_Control, _cache_control.c_str()); - response->addHeader(T_ETag, etag.c_str()); - } - request->send(response); - } - } else { - request->send(404); - } -} diff --git a/lib/ESPAsyncWebServer/src/WebRequest.cpp b/lib/ESPAsyncWebServer/src/WebRequest.cpp deleted file mode 100644 index 95fda7e..0000000 --- a/lib/ESPAsyncWebServer/src/WebRequest.cpp +++ /dev/null @@ -1,985 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "ESPAsyncWebServer.h" -#include "WebAuthentication.h" -#include "WebResponseImpl.h" -#include "literals.h" -#include - -#define __is_param_char(c) ((c) && ((c) != '{') && ((c) != '[') && ((c) != '&') && ((c) != '=')) - -using namespace asyncsrv; - -enum { PARSE_REQ_START, - PARSE_REQ_HEADERS, - PARSE_REQ_BODY, - PARSE_REQ_END, - PARSE_REQ_FAIL }; - -AsyncWebServerRequest::AsyncWebServerRequest(AsyncWebServer* s, AsyncClient* c) - : _client(c), _server(s), _handler(NULL), _response(NULL), _temp(), _parseState(0), _version(0), _method(HTTP_ANY), _url(), _host(), _contentType(), _boundary(), _authorization(), _reqconntype(RCT_HTTP), _isDigest(false), _isMultipart(false), _isPlainPost(false), _expectingContinue(false), _contentLength(0), _parsedLength(0), _multiParseState(0), _boundaryPosition(0), _itemStartIndex(0), _itemSize(0), _itemName(), _itemFilename(), _itemType(), _itemValue(), _itemBuffer(0), _itemBufferIndex(0), _itemIsFile(false), _tempObject(NULL) { - c->onError([](void* r, AsyncClient* c, int8_t error) { (void)c; AsyncWebServerRequest *req = (AsyncWebServerRequest*)r; req->_onError(error); }, this); - c->onAck([](void* r, AsyncClient* c, size_t len, uint32_t time) { (void)c; AsyncWebServerRequest *req = (AsyncWebServerRequest*)r; req->_onAck(len, time); }, this); - c->onDisconnect([](void* r, AsyncClient* c) { AsyncWebServerRequest *req = (AsyncWebServerRequest*)r; req->_onDisconnect(); delete c; }, this); - c->onTimeout([](void* r, AsyncClient* c, uint32_t time) { (void)c; AsyncWebServerRequest *req = (AsyncWebServerRequest*)r; req->_onTimeout(time); }, this); - c->onData([](void* r, AsyncClient* c, void* buf, size_t len) { (void)c; AsyncWebServerRequest *req = (AsyncWebServerRequest*)r; req->_onData(buf, len); }, this); - c->onPoll([](void* r, AsyncClient* c) { (void)c; AsyncWebServerRequest *req = ( AsyncWebServerRequest*)r; req->_onPoll(); }, this); -} - -AsyncWebServerRequest::~AsyncWebServerRequest() { - _headers.clear(); - - _pathParams.clear(); - - _interestingHeaders.clear(); - - if (_response != NULL) { - delete _response; - } - - if (_tempObject != NULL) { - free(_tempObject); - } - - if (_tempFile) { - _tempFile.close(); - } - - if (_itemBuffer) { - free(_itemBuffer); - } -} - -void AsyncWebServerRequest::_onData(void* buf, size_t len) { - size_t i = 0; - while (true) { - - if (_parseState < PARSE_REQ_BODY) { - // Find new line in buf - char* str = (char*)buf; - for (i = 0; i < len; i++) { - if (str[i] == '\n') { - break; - } - } - if (i == len) { // No new line, just add the buffer in _temp - char ch = str[len - 1]; - str[len - 1] = 0; - _temp.reserve(_temp.length() + len); - _temp.concat(str); - _temp.concat(ch); - } else { // Found new line - extract it and parse - str[i] = 0; // Terminate the string at the end of the line. - _temp.concat(str); - _temp.trim(); - _parseLine(); - if (++i < len) { - // Still have more buffer to process - buf = str + i; - len -= i; - continue; - } - } - } else if (_parseState == PARSE_REQ_BODY) { - // A handler should be already attached at this point in _parseLine function. - // If handler does nothing (_onRequest is NULL), we don't need to really parse the body. - const bool needParse = _handler && !_handler->isRequestHandlerTrivial(); - if (_isMultipart) { - if (needParse) { - size_t i; - for (i = 0; i < len; i++) { - _parseMultipartPostByte(((uint8_t*)buf)[i], i == len - 1); - _parsedLength++; - } - } else - _parsedLength += len; - } else { - if (_parsedLength == 0) { - if (_contentType.startsWith(T_app_xform_urlencoded)) { - _isPlainPost = true; - } else if (_contentType == T_text_plain && __is_param_char(((char*)buf)[0])) { - size_t i = 0; - while (i < len && __is_param_char(((char*)buf)[i++])) - ; - if (i < len && ((char*)buf)[i - 1] == '=') { - _isPlainPost = true; - } - } - } - if (!_isPlainPost) { - // check if authenticated before calling the body - if (_handler) - _handler->handleBody(this, (uint8_t*)buf, len, _parsedLength, _contentLength); - _parsedLength += len; - } else if (needParse) { - size_t i; - for (i = 0; i < len; i++) { - _parsedLength++; - _parsePlainPostChar(((uint8_t*)buf)[i]); - } - } else { - _parsedLength += len; - } - } - if (_parsedLength == _contentLength) { - _parseState = PARSE_REQ_END; - // check if authenticated before calling handleRequest and request auth instead - if (_handler) - _handler->handleRequest(this); - else - send(501); - } - } - break; - } -} - -void AsyncWebServerRequest::_removeNotInterestingHeaders() { - if (std::any_of(std::begin(_interestingHeaders), std::end(_interestingHeaders), [](const String& str) { return str.equalsIgnoreCase(T_ANY); })) - return; // nothing to do - - for (auto iter = std::begin(_headers); iter != std::end(_headers);) { - const auto name = iter->name(); - - if (std::none_of(std::begin(_interestingHeaders), std::end(_interestingHeaders), [&name](const String& str) { return str.equalsIgnoreCase(name); })) - iter = _headers.erase(iter); - else - iter++; - } -} - -void AsyncWebServerRequest::_onPoll() { - // os_printf("p\n"); - if (_response != NULL && _client != NULL && _client->canSend()) { - if (!_response->_finished()) { - _response->_ack(this, 0, 0); - } else { - AsyncWebServerResponse* r = _response; - _response = NULL; - delete r; - - _client->close(); - } - } -} - -void AsyncWebServerRequest::_onAck(size_t len, uint32_t time) { - // os_printf("a:%u:%u\n", len, time); - if (_response != NULL) { - if (!_response->_finished()) { - _response->_ack(this, len, time); - } else if (_response->_finished()) { - AsyncWebServerResponse* r = _response; - _response = NULL; - delete r; - - _client->close(); - } - } -} - -void AsyncWebServerRequest::_onError(int8_t error) { - (void)error; -} - -void AsyncWebServerRequest::_onTimeout(uint32_t time) { - (void)time; - // os_printf("TIMEOUT: %u, state: %s\n", time, _client->stateToString()); - _client->close(); -} - -void AsyncWebServerRequest::onDisconnect(ArDisconnectHandler fn) { - _onDisconnectfn = fn; -} - -void AsyncWebServerRequest::_onDisconnect() { - // os_printf("d\n"); - if (_onDisconnectfn) { - _onDisconnectfn(); - } - _server->_handleDisconnect(this); -} - -void AsyncWebServerRequest::_addPathParam(const char* p) { - _pathParams.emplace_back(p); -} - -void AsyncWebServerRequest::_addGetParams(const String& params) { - size_t start = 0; - while (start < params.length()) { - int end = params.indexOf('&', start); - if (end < 0) - end = params.length(); - int equal = params.indexOf('=', start); - if (equal < 0 || equal > end) - equal = end; - String name(params.substring(start, equal)); - String value(equal + 1 < end ? params.substring(equal + 1, end) : String()); - _params.emplace_back(urlDecode(name), urlDecode(value)); - start = end + 1; - } -} - -bool AsyncWebServerRequest::_parseReqHead() { - // Split the head into method, url and version - int index = _temp.indexOf(' '); - String m = _temp.substring(0, index); - index = _temp.indexOf(' ', index + 1); - String u = _temp.substring(m.length() + 1, index); - _temp = _temp.substring(index + 1); - - if (m == T_GET) { - _method = HTTP_GET; - } else if (m == T_POST) { - _method = HTTP_POST; - } else if (m == T_DELETE) { - _method = HTTP_DELETE; - } else if (m == T_PUT) { - _method = HTTP_PUT; - } else if (m == T_PATCH) { - _method = HTTP_PATCH; - } else if (m == T_HEAD) { - _method = HTTP_HEAD; - } else if (m == T_OPTIONS) { - _method = HTTP_OPTIONS; - } - - String g; - index = u.indexOf('?'); - if (index > 0) { - g = u.substring(index + 1); - u = u.substring(0, index); - } - _url = urlDecode(u); - _addGetParams(g); - - if (!_temp.startsWith(T_HTTP_1_0)) - _version = 1; - - _temp = emptyString; - return true; -} - -bool AsyncWebServerRequest::_parseReqHeader() { - int index = _temp.indexOf(':'); - if (index) { - String name(_temp.substring(0, index)); - String value(_temp.substring(index + 2)); - if (name.equalsIgnoreCase(T_Host)) { - _host = value; - } else if (name.equalsIgnoreCase(T_Content_Type)) { - _contentType = value.substring(0, value.indexOf(';')); - if (value.startsWith(T_MULTIPART_)) { - _boundary = value.substring(value.indexOf('=') + 1); - _boundary.replace(String('"'), String()); - _isMultipart = true; - } - } else if (name.equalsIgnoreCase(T_Content_Length)) { - _contentLength = atoi(value.c_str()); - } else if (name.equalsIgnoreCase(T_EXPECT) && value == T_100_CONTINUE) { - _expectingContinue = true; - } else if (name.equalsIgnoreCase(T_AUTH)) { - if (value.length() > 5 && value.substring(0, 5).equalsIgnoreCase(T_BASIC)) { - _authorization = value.substring(6); - } else if (value.length() > 6 && value.substring(0, 6).equalsIgnoreCase(T_DIGEST)) { - _isDigest = true; - _authorization = value.substring(7); - } - } else { - if (name.equalsIgnoreCase(T_UPGRADE) && value.equalsIgnoreCase(T_WS)) { - // WebSocket request can be uniquely identified by header: [Upgrade: websocket] - _reqconntype = RCT_WS; - } else if (name.equalsIgnoreCase(T_ACCEPT)) { - String lowcase(value); - lowcase.toLowerCase(); -#ifndef ESP8266 - const char* substr = std::strstr(lowcase.c_str(), T_text_event_stream); -#else - const char* substr = std::strstr(lowcase.c_str(), String(T_text_event_stream).c_str()); -#endif - if (substr != NULL) { - // WebEvent request can be uniquely identified by header: [Accept: text/event-stream] - _reqconntype = RCT_EVENT; - } - } - } - _headers.emplace_back(name, value); - } -#ifndef TARGET_RP2040 - _temp.clear(); -#else - // Ancient PRI core does not have String::clear() method 8-() - _temp = emptyString; -#endif - return true; -} - -void AsyncWebServerRequest::_parsePlainPostChar(uint8_t data) { - if (data && (char)data != '&') - _temp += (char)data; - if (!data || (char)data == '&' || _parsedLength == _contentLength) { - String name(T_BODY); - String value(_temp); - if (!(_temp.charAt(0) == '{') && !(_temp.charAt(0) == '[') && _temp.indexOf('=') > 0) { - name = _temp.substring(0, _temp.indexOf('=')); - value = _temp.substring(_temp.indexOf('=') + 1); - } - _params.emplace_back(urlDecode(name), urlDecode(value), true); - -#ifndef TARGET_RP2040 - _temp.clear(); -#else - // Ancient PRI core does not have String::clear() method 8-() - _temp = emptyString; -#endif - } -} - -void AsyncWebServerRequest::_handleUploadByte(uint8_t data, bool last) { - _itemBuffer[_itemBufferIndex++] = data; - - if (last || _itemBufferIndex == 1460) { - // check if authenticated before calling the upload - if (_handler) - _handler->handleUpload(this, _itemFilename, _itemSize - _itemBufferIndex, _itemBuffer, _itemBufferIndex, false); - _itemBufferIndex = 0; - } -} - -enum { - EXPECT_BOUNDARY, - PARSE_HEADERS, - WAIT_FOR_RETURN1, - EXPECT_FEED1, - EXPECT_DASH1, - EXPECT_DASH2, - BOUNDARY_OR_DATA, - DASH3_OR_RETURN2, - EXPECT_FEED2, - PARSING_FINISHED, - PARSE_ERROR -}; - -void AsyncWebServerRequest::_parseMultipartPostByte(uint8_t data, bool last) { -#define itemWriteByte(b) \ - do { \ - _itemSize++; \ - if (_itemIsFile) \ - _handleUploadByte(b, last); \ - else \ - _itemValue += (char)(b); \ - } while (0) - - if (!_parsedLength) { - _multiParseState = EXPECT_BOUNDARY; - _temp = emptyString; - _itemName = emptyString; - _itemFilename = emptyString; - _itemType = emptyString; - } - - if (_multiParseState == WAIT_FOR_RETURN1) { - if (data != '\r') { - itemWriteByte(data); - } else { - _multiParseState = EXPECT_FEED1; - } - } else if (_multiParseState == EXPECT_BOUNDARY) { - if (_parsedLength < 2 && data != '-') { - _multiParseState = PARSE_ERROR; - return; - } else if (_parsedLength - 2 < _boundary.length() && _boundary.c_str()[_parsedLength - 2] != data) { - _multiParseState = PARSE_ERROR; - return; - } else if (_parsedLength - 2 == _boundary.length() && data != '\r') { - _multiParseState = PARSE_ERROR; - return; - } else if (_parsedLength - 3 == _boundary.length()) { - if (data != '\n') { - _multiParseState = PARSE_ERROR; - return; - } - _multiParseState = PARSE_HEADERS; - _itemIsFile = false; - } - } else if (_multiParseState == PARSE_HEADERS) { - if ((char)data != '\r' && (char)data != '\n') - _temp += (char)data; - if ((char)data == '\n') { - if (_temp.length()) { - if (_temp.length() > 12 && _temp.substring(0, 12).equalsIgnoreCase(T_Content_Type)) { - _itemType = _temp.substring(14); - _itemIsFile = true; - } else if (_temp.length() > 19 && _temp.substring(0, 19).equalsIgnoreCase(T_Content_Disposition)) { - _temp = _temp.substring(_temp.indexOf(';') + 2); - while (_temp.indexOf(';') > 0) { - String name = _temp.substring(0, _temp.indexOf('=')); - String nameVal = _temp.substring(_temp.indexOf('=') + 2, _temp.indexOf(';') - 1); - if (name == T_name) { - _itemName = nameVal; - } else if (name == T_filename) { - _itemFilename = nameVal; - _itemIsFile = true; - } - _temp = _temp.substring(_temp.indexOf(';') + 2); - } - String name = _temp.substring(0, _temp.indexOf('=')); - String nameVal = _temp.substring(_temp.indexOf('=') + 2, _temp.length() - 1); - if (name == T_name) { - _itemName = nameVal; - } else if (name == T_filename) { - _itemFilename = nameVal; - _itemIsFile = true; - } - } - _temp = emptyString; - } else { - _multiParseState = WAIT_FOR_RETURN1; - // value starts from here - _itemSize = 0; - _itemStartIndex = _parsedLength; - _itemValue = emptyString; - if (_itemIsFile) { - if (_itemBuffer) - free(_itemBuffer); - _itemBuffer = (uint8_t*)malloc(1460); - if (_itemBuffer == NULL) { - _multiParseState = PARSE_ERROR; - return; - } - _itemBufferIndex = 0; - } - } - } - } else if (_multiParseState == EXPECT_FEED1) { - if (data != '\n') { - _multiParseState = WAIT_FOR_RETURN1; - itemWriteByte('\r'); - _parseMultipartPostByte(data, last); - } else { - _multiParseState = EXPECT_DASH1; - } - } else if (_multiParseState == EXPECT_DASH1) { - if (data != '-') { - _multiParseState = WAIT_FOR_RETURN1; - itemWriteByte('\r'); - itemWriteByte('\n'); - _parseMultipartPostByte(data, last); - } else { - _multiParseState = EXPECT_DASH2; - } - } else if (_multiParseState == EXPECT_DASH2) { - if (data != '-') { - _multiParseState = WAIT_FOR_RETURN1; - itemWriteByte('\r'); - itemWriteByte('\n'); - itemWriteByte('-'); - _parseMultipartPostByte(data, last); - } else { - _multiParseState = BOUNDARY_OR_DATA; - _boundaryPosition = 0; - } - } else if (_multiParseState == BOUNDARY_OR_DATA) { - if (_boundaryPosition < _boundary.length() && _boundary.c_str()[_boundaryPosition] != data) { - _multiParseState = WAIT_FOR_RETURN1; - itemWriteByte('\r'); - itemWriteByte('\n'); - itemWriteByte('-'); - itemWriteByte('-'); - uint8_t i; - for (i = 0; i < _boundaryPosition; i++) - itemWriteByte(_boundary.c_str()[i]); - _parseMultipartPostByte(data, last); - } else if (_boundaryPosition == _boundary.length() - 1) { - _multiParseState = DASH3_OR_RETURN2; - if (!_itemIsFile) { - _params.emplace_back(_itemName, _itemValue, true); - } else { - if (_itemSize) { - // check if authenticated before calling the upload - if (_handler) - _handler->handleUpload(this, _itemFilename, _itemSize - _itemBufferIndex, _itemBuffer, _itemBufferIndex, true); - _itemBufferIndex = 0; - _params.emplace_back(_itemName, _itemFilename, true, true, _itemSize); - } - free(_itemBuffer); - _itemBuffer = NULL; - } - - } else { - _boundaryPosition++; - } - } else if (_multiParseState == DASH3_OR_RETURN2) { - if (data == '-' && (_contentLength - _parsedLength - 4) != 0) { - // os_printf("ERROR: The parser got to the end of the POST but is expecting %u bytes more!\nDrop an issue so we can have more info on the matter!\n", _contentLength - _parsedLength - 4); - _contentLength = _parsedLength + 4; // lets close the request gracefully - } - if (data == '\r') { - _multiParseState = EXPECT_FEED2; - } else if (data == '-' && _contentLength == (_parsedLength + 4)) { - _multiParseState = PARSING_FINISHED; - } else { - _multiParseState = WAIT_FOR_RETURN1; - itemWriteByte('\r'); - itemWriteByte('\n'); - itemWriteByte('-'); - itemWriteByte('-'); - uint8_t i; - for (i = 0; i < _boundary.length(); i++) - itemWriteByte(_boundary.c_str()[i]); - _parseMultipartPostByte(data, last); - } - } else if (_multiParseState == EXPECT_FEED2) { - if (data == '\n') { - _multiParseState = PARSE_HEADERS; - _itemIsFile = false; - } else { - _multiParseState = WAIT_FOR_RETURN1; - itemWriteByte('\r'); - itemWriteByte('\n'); - itemWriteByte('-'); - itemWriteByte('-'); - uint8_t i; - for (i = 0; i < _boundary.length(); i++) - itemWriteByte(_boundary.c_str()[i]); - itemWriteByte('\r'); - _parseMultipartPostByte(data, last); - } - } -} - -void AsyncWebServerRequest::_parseLine() { - if (_parseState == PARSE_REQ_START) { - if (!_temp.length()) { - _parseState = PARSE_REQ_FAIL; - _client->close(); - } else { - _parseReqHead(); - _parseState = PARSE_REQ_HEADERS; - } - return; - } - - if (_parseState == PARSE_REQ_HEADERS) { - if (!_temp.length()) { - // end of headers - _server->_rewriteRequest(this); - _server->_attachHandler(this); - _removeNotInterestingHeaders(); - if (_expectingContinue) { - String response(T_HTTP_100_CONT); - _client->write(response.c_str(), response.length()); - } - // check handler for authentication - if (_contentLength) { - _parseState = PARSE_REQ_BODY; - } else { - _parseState = PARSE_REQ_END; - if (_handler) - _handler->handleRequest(this); - else - send(501); - } - } else - _parseReqHeader(); - } -} - -size_t AsyncWebServerRequest::headers() const { - return _headers.size(); -} - -bool AsyncWebServerRequest::hasHeader(const char* name) const { - for (const auto& h : _headers) { - if (h.name().equalsIgnoreCase(name)) { - return true; - } - } - return false; -} - -#ifdef ESP8266 -bool AsyncWebServerRequest::hasHeader(const __FlashStringHelper* data) const { - return hasHeader(String(data)); -} -#endif - -const AsyncWebHeader* AsyncWebServerRequest::getHeader(const char* name) const { - auto iter = std::find_if(std::begin(_headers), std::end(_headers), [&name](const AsyncWebHeader& header) { return header.name().equalsIgnoreCase(name); }); - - return (iter == std::end(_headers)) ? nullptr : &(*iter); -} - -#ifdef ESP8266 -const AsyncWebHeader* AsyncWebServerRequest::getHeader(const __FlashStringHelper* data) const { - PGM_P p = reinterpret_cast(data); - size_t n = strlen_P(p); - char* name = (char*)malloc(n + 1); - if (name) { - strcpy_P(name, p); - const AsyncWebHeader* result = getHeader(String(name)); - free(name); - return result; - } else { - return nullptr; - } -} -#endif - -const AsyncWebHeader* AsyncWebServerRequest::getHeader(size_t num) const { - if (num >= _headers.size()) - return nullptr; - return &(*std::next(_headers.cbegin(), num)); -} - -size_t AsyncWebServerRequest::params() const { - return _params.size(); -} - -bool AsyncWebServerRequest::hasParam(const char* name, bool post, bool file) const { - for (const auto& p : _params) { - if (p.name().equals(name) && p.isPost() == post && p.isFile() == file) { - return true; - } - } - return false; -} - -const AsyncWebParameter* AsyncWebServerRequest::getParam(const char* name, bool post, bool file) const { - for (const auto& p : _params) { - if (p.name() == name && p.isPost() == post && p.isFile() == file) { - return &p; - } - } - return nullptr; -} - -#ifdef ESP8266 -const AsyncWebParameter* AsyncWebServerRequest::getParam(const __FlashStringHelper* data, bool post, bool file) const { - return getParam(String(data), post, file); -} -#endif - -const AsyncWebParameter* AsyncWebServerRequest::getParam(size_t num) const { - if (num >= _params.size()) - return nullptr; - return &(*std::next(_params.cbegin(), num)); -} - -void AsyncWebServerRequest::addInterestingHeader(const char* name) { - if (std::none_of(std::begin(_interestingHeaders), std::end(_interestingHeaders), [&name](const String& str) { return str.equalsIgnoreCase(name); })) - _interestingHeaders.emplace_back(name); -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(int code, const char* contentType, const char* content, AwsTemplateProcessor callback) { - if (callback) - return new AsyncProgmemResponse(code, contentType, (const uint8_t*)content, strlen(content), callback); - return new AsyncBasicResponse(code, contentType, content); -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(int code, const char* contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback) { - return new AsyncProgmemResponse(code, contentType, content, len, callback); -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(FS& fs, const String& path, const char* contentType, bool download, AwsTemplateProcessor callback) { - if (fs.exists(path) || (!download && fs.exists(path + T__gz))) - return new AsyncFileResponse(fs, path, contentType, download, callback); - return NULL; -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(File content, const String& path, const char* contentType, bool download, AwsTemplateProcessor callback) { - if (content == true) - return new AsyncFileResponse(content, path, contentType, download, callback); - return NULL; -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(Stream& stream, const char* contentType, size_t len, AwsTemplateProcessor callback) { - return new AsyncStreamResponse(stream, contentType, len, callback); -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(const char* contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback) { - return new AsyncCallbackResponse(contentType, len, callback, templateCallback); -} - -AsyncWebServerResponse* AsyncWebServerRequest::beginChunkedResponse(const char* contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback) { - if (_version) - return new AsyncChunkedResponse(contentType, callback, templateCallback); - return new AsyncCallbackResponse(contentType, 0, callback, templateCallback); -} - -AsyncResponseStream* AsyncWebServerRequest::beginResponseStream(const char* contentType, size_t bufferSize) { - return new AsyncResponseStream(contentType, bufferSize); -} - -#ifdef ESP8266 -AsyncWebServerResponse* AsyncWebServerRequest::beginResponse(int code, const String& contentType, PGM_P content, AwsTemplateProcessor callback) { - return new AsyncProgmemResponse(code, contentType, (const uint8_t*)content, strlen_P(content), callback); -} -#endif - -void AsyncWebServerRequest::send(AsyncWebServerResponse* response) { - _response = response; - if (_response == NULL) { - _client->close(true); - _onDisconnect(); - return; - } - if (!_response->_sourceValid()) { - delete response; - _response = NULL; - send(500); - } else { - _client->setRxTimeout(0); - _response->_respond(this); - } -} - -void AsyncWebServerRequest::redirect(const char* url) { - AsyncWebServerResponse* response = beginResponse(302); - response->addHeader(T_LOCATION, url); - send(response); -} - -bool AsyncWebServerRequest::authenticate(const char* username, const char* password, const char* realm, bool passwordIsHash) { - if (_authorization.length()) { - if (_isDigest) - return checkDigestAuthentication(_authorization.c_str(), methodToString(), username, password, realm, passwordIsHash, NULL, NULL, NULL); - else if (!passwordIsHash) - return checkBasicAuthentication(_authorization.c_str(), username, password); - else - return _authorization.equals(password); - } - return false; -} - -bool AsyncWebServerRequest::authenticate(const char* hash) { - if (!_authorization.length() || hash == NULL) - return false; - - if (_isDigest) { - String hStr = String(hash); - int separator = hStr.indexOf(':'); - if (separator <= 0) - return false; - String username = hStr.substring(0, separator); - hStr = hStr.substring(separator + 1); - separator = hStr.indexOf(':'); - if (separator <= 0) - return false; - String realm = hStr.substring(0, separator); - hStr = hStr.substring(separator + 1); - return checkDigestAuthentication(_authorization.c_str(), methodToString(), username.c_str(), hStr.c_str(), realm.c_str(), true, NULL, NULL, NULL); - } - - return (_authorization.equals(hash)); -} - -void AsyncWebServerRequest::requestAuthentication(const char* realm, bool isDigest) { - AsyncWebServerResponse* r = beginResponse(401); - if (!isDigest && realm == NULL) { - r->addHeader(T_WWW_AUTH, T_BASIC_REALM_LOGIN_REQ); - } else if (!isDigest) { - String header(T_BASIC_REALM); - header.concat(realm); - header += '"'; - r->addHeader(T_WWW_AUTH, header.c_str()); - } else { - String header(T_DIGEST_); - header.concat(requestDigestAuthentication(realm)); - r->addHeader(T_WWW_AUTH, header.c_str()); - } - send(r); -} - -bool AsyncWebServerRequest::hasArg(const char* name) const { - for (const auto& arg : _params) { - if (arg.name() == name) { - return true; - } - } - return false; -} - -#ifdef ESP8266 -bool AsyncWebServerRequest::hasArg(const __FlashStringHelper* data) const { - return hasArg(String(data).c_str()); -} -#endif - -const String& AsyncWebServerRequest::arg(const char* name) const { - for (const auto& arg : _params) { - if (arg.name() == name) { - return arg.value(); - } - } - return emptyString; -} - -#ifdef ESP8266 -const String& AsyncWebServerRequest::arg(const __FlashStringHelper* data) const { - return arg(String(data).c_str()); -} -#endif - -const String& AsyncWebServerRequest::arg(size_t i) const { - return getParam(i)->value(); -} - -const String& AsyncWebServerRequest::argName(size_t i) const { - return getParam(i)->name(); -} - -const String& AsyncWebServerRequest::pathArg(size_t i) const { - return i < _pathParams.size() ? _pathParams[i] : emptyString; -} - -const String& AsyncWebServerRequest::header(const char* name) const { - const AsyncWebHeader* h = getHeader(name); - return h ? h->value() : emptyString; -} - -#ifdef ESP8266 -const String& AsyncWebServerRequest::header(const __FlashStringHelper* data) const { - return header(String(data).c_str()); -}; -#endif - -const String& AsyncWebServerRequest::header(size_t i) const { - const AsyncWebHeader* h = getHeader(i); - return h ? h->value() : emptyString; -} - -const String& AsyncWebServerRequest::headerName(size_t i) const { - const AsyncWebHeader* h = getHeader(i); - return h ? h->name() : emptyString; -} - -String AsyncWebServerRequest::urlDecode(const String& text) const { - char temp[] = "0x00"; - unsigned int len = text.length(); - unsigned int i = 0; - String decoded; - decoded.reserve(len); // Allocate the string internal buffer - never longer from source text - while (i < len) { - char decodedChar; - char encodedChar = text.charAt(i++); - if ((encodedChar == '%') && (i + 1 < len)) { - temp[2] = text.charAt(i++); - temp[3] = text.charAt(i++); - decodedChar = strtol(temp, NULL, 16); - } else if (encodedChar == '+') { - decodedChar = ' '; - } else { - decodedChar = encodedChar; // normal ascii char - } - decoded.concat(decodedChar); - } - return decoded; -} - -#ifndef ESP8266 -const char* AsyncWebServerRequest::methodToString() const { - if (_method == HTTP_ANY) - return T_ANY; - if (_method & HTTP_GET) - return T_GET; - if (_method & HTTP_POST) - return T_POST; - if (_method & HTTP_DELETE) - return T_DELETE; - if (_method & HTTP_PUT) - return T_PUT; - if (_method & HTTP_PATCH) - return T_PATCH; - if (_method & HTTP_HEAD) - return T_HEAD; - if (_method & HTTP_OPTIONS) - return T_OPTIONS; - return T_UNKNOWN; -} -#else // ESP8266 -const __FlashStringHelper* AsyncWebServerRequest::methodToString() const { - if (_method == HTTP_ANY) - return FPSTR(T_ANY); - if (_method & HTTP_GET) - return FPSTR(T_GET); - if (_method & HTTP_POST) - return FPSTR(T_POST); - if (_method & HTTP_DELETE) - return FPSTR(T_DELETE); - if (_method & HTTP_PUT) - return FPSTR(T_PUT); - if (_method & HTTP_PATCH) - return FPSTR(T_PATCH); - if (_method & HTTP_HEAD) - return FPSTR(T_HEAD); - if (_method & HTTP_OPTIONS) - return FPSTR(T_OPTIONS); - return FPSTR(T_UNKNOWN); -} -#endif // ESP8266 - -#ifndef ESP8266 -const char* AsyncWebServerRequest::requestedConnTypeToString() const { - switch (_reqconntype) { - case RCT_NOT_USED: - return T_RCT_NOT_USED; - case RCT_DEFAULT: - return T_RCT_DEFAULT; - case RCT_HTTP: - return T_RCT_HTTP; - case RCT_WS: - return T_RCT_WS; - case RCT_EVENT: - return T_RCT_EVENT; - default: - return T_ERROR; - } -} -#else // ESP8266 -const __FlashStringHelper* AsyncWebServerRequest::requestedConnTypeToString() const { - switch (_reqconntype) { - case RCT_NOT_USED: - return FPSTR(T_RCT_NOT_USED); - case RCT_DEFAULT: - return FPSTR(T_RCT_DEFAULT); - case RCT_HTTP: - return FPSTR(T_RCT_HTTP); - case RCT_WS: - return FPSTR(T_RCT_WS); - case RCT_EVENT: - return FPSTR(T_RCT_EVENT); - default: - return FPSTR(T_ERROR); - } -} -#endif // ESP8266 - -bool AsyncWebServerRequest::isExpectedRequestedConnType(RequestedConnectionType erct1, RequestedConnectionType erct2, RequestedConnectionType erct3) { - bool res = false; - if ((erct1 != RCT_NOT_USED) && (erct1 == _reqconntype)) - res = true; - if ((erct2 != RCT_NOT_USED) && (erct2 == _reqconntype)) - res = true; - if ((erct3 != RCT_NOT_USED) && (erct3 == _reqconntype)) - res = true; - return res; -} diff --git a/lib/ESPAsyncWebServer/src/WebResponseImpl.h b/lib/ESPAsyncWebServer/src/WebResponseImpl.h deleted file mode 100644 index a6f71bb..0000000 --- a/lib/ESPAsyncWebServer/src/WebResponseImpl.h +++ /dev/null @@ -1,157 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#ifndef ASYNCWEBSERVERRESPONSEIMPL_H_ -#define ASYNCWEBSERVERRESPONSEIMPL_H_ - -#ifdef Arduino_h - // arduino is not compatible with std::vector - #undef min - #undef max -#endif -#include -#include -#include "literals.h" - -// It is possible to restore these defines, but one can use _min and _max instead. Or std::min, std::max. - -class AsyncBasicResponse : public AsyncWebServerResponse { - private: - String _content; - - public: - explicit AsyncBasicResponse(int code, const char* contentType = asyncsrv::empty, const char* content = asyncsrv::empty); - AsyncBasicResponse(int code, const String& contentType, const String& content = emptyString) : AsyncBasicResponse(code, contentType.c_str(), content.c_str()) {} - void _respond(AsyncWebServerRequest* request); - size_t _ack(AsyncWebServerRequest* request, size_t len, uint32_t time); - bool _sourceValid() const { return true; } -}; - -class AsyncAbstractResponse : public AsyncWebServerResponse { - private: - String _head; - // Data is inserted into cache at begin(). - // This is inefficient with vector, but if we use some other container, - // we won't be able to access it as contiguous array of bytes when reading from it, - // so by gaining performance in one place, we'll lose it in another. - std::vector _cache; - size_t _readDataFromCacheOrContent(uint8_t* data, const size_t len); - size_t _fillBufferAndProcessTemplates(uint8_t* buf, size_t maxLen); - - protected: - AwsTemplateProcessor _callback; - - public: - AsyncAbstractResponse(AwsTemplateProcessor callback = nullptr); - void _respond(AsyncWebServerRequest* request); - size_t _ack(AsyncWebServerRequest* request, size_t len, uint32_t time); - bool _sourceValid() const { return false; } - virtual size_t _fillBuffer(uint8_t* buf __attribute__((unused)), size_t maxLen __attribute__((unused))) { return 0; } -}; - -#ifndef TEMPLATE_PLACEHOLDER - #define TEMPLATE_PLACEHOLDER '%' -#endif - -#define TEMPLATE_PARAM_NAME_LENGTH 32 -class AsyncFileResponse : public AsyncAbstractResponse { - using File = fs::File; - using FS = fs::FS; - - private: - File _content; - String _path; - void _setContentTypeFromPath(const String& path); - - public: - AsyncFileResponse(FS& fs, const String& path, const char* contentType = asyncsrv::empty, bool download = false, AwsTemplateProcessor callback = nullptr); - AsyncFileResponse(FS& fs, const String& path, const String& contentType, bool download = false, AwsTemplateProcessor callback = nullptr) : AsyncFileResponse(fs, path, contentType.c_str(), download, callback) {} - AsyncFileResponse(File content, const String& path, const char* contentType = asyncsrv::empty, bool download = false, AwsTemplateProcessor callback = nullptr); - AsyncFileResponse(File content, const String& path, const String& contentType, bool download = false, AwsTemplateProcessor callack = nullptr) : AsyncFileResponse(content, path, contentType.c_str(), download, callack) {} - ~AsyncFileResponse(); - bool _sourceValid() const { return !!(_content); } - virtual size_t _fillBuffer(uint8_t* buf, size_t maxLen) override; -}; - -class AsyncStreamResponse : public AsyncAbstractResponse { - private: - Stream* _content; - - public: - AsyncStreamResponse(Stream& stream, const char* contentType, size_t len, AwsTemplateProcessor callback = nullptr); - AsyncStreamResponse(Stream& stream, const String& contentType, size_t len, AwsTemplateProcessor callback = nullptr) : AsyncStreamResponse(stream, contentType.c_str(), len, callback) {} - bool _sourceValid() const { return !!(_content); } - virtual size_t _fillBuffer(uint8_t* buf, size_t maxLen) override; -}; - -class AsyncCallbackResponse : public AsyncAbstractResponse { - private: - AwsResponseFiller _content; - size_t _filledLength; - - public: - AsyncCallbackResponse(const char* contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr); - AsyncCallbackResponse(const String& contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) : AsyncCallbackResponse(contentType.c_str(), len, callback, templateCallback) {} - bool _sourceValid() const { return !!(_content); } - virtual size_t _fillBuffer(uint8_t* buf, size_t maxLen) override; -}; - -class AsyncChunkedResponse : public AsyncAbstractResponse { - private: - AwsResponseFiller _content; - size_t _filledLength; - - public: - AsyncChunkedResponse(const char* contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr); - AsyncChunkedResponse(const String& contentType, AwsResponseFiller callback, AwsTemplateProcessor templateCallback = nullptr) : AsyncChunkedResponse(contentType.c_str(), callback, templateCallback) {} - bool _sourceValid() const { return !!(_content); } - virtual size_t _fillBuffer(uint8_t* buf, size_t maxLen) override; -}; - -class AsyncProgmemResponse : public AsyncAbstractResponse { - private: - const uint8_t* _content; - size_t _readLength; - - public: - AsyncProgmemResponse(int code, const char* contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr); - AsyncProgmemResponse(int code, const String& contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback = nullptr) : AsyncProgmemResponse(code, contentType.c_str(), content, len, callback) {} - bool _sourceValid() const { return true; } - virtual size_t _fillBuffer(uint8_t* buf, size_t maxLen) override; -}; - -class cbuf; - -class AsyncResponseStream : public AsyncAbstractResponse, public Print { - private: - std::unique_ptr _content; - - public: - AsyncResponseStream(const char* contentType, size_t bufferSize); - AsyncResponseStream(const String& contentType, size_t bufferSize) : AsyncResponseStream(contentType.c_str(), bufferSize) {} - ~AsyncResponseStream(); - bool _sourceValid() const { return (_state < RESPONSE_END); } - virtual size_t _fillBuffer(uint8_t* buf, size_t maxLen) override; - size_t write(const uint8_t* data, size_t len); - size_t write(uint8_t data); - using Print::write; -}; - -#endif /* ASYNCWEBSERVERRESPONSEIMPL_H_ */ diff --git a/lib/ESPAsyncWebServer/src/WebResponses.cpp b/lib/ESPAsyncWebServer/src/WebResponses.cpp deleted file mode 100644 index f1994b1..0000000 --- a/lib/ESPAsyncWebServer/src/WebResponses.cpp +++ /dev/null @@ -1,849 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "ESPAsyncWebServer.h" -#include "WebResponseImpl.h" -#include "cbuf.h" - -using namespace asyncsrv; - -// Since ESP8266 does not link memchr by default, here's its implementation. -void* memchr(void* ptr, int ch, size_t count) { - unsigned char* p = static_cast(ptr); - while (count--) - if (*p++ == static_cast(ch)) - return --p; - return nullptr; -} - -/* - * Abstract Response - * - */ - -#ifndef ESP8266 -const char* AsyncWebServerResponse::responseCodeToString(int code) { - switch (code) { - case 100: - return T_HTTP_CODE_100; - case 101: - return T_HTTP_CODE_101; - case 200: - return T_HTTP_CODE_200; - case 201: - return T_HTTP_CODE_201; - case 202: - return T_HTTP_CODE_202; - case 203: - return T_HTTP_CODE_203; - case 204: - return T_HTTP_CODE_204; - case 205: - return T_HTTP_CODE_205; - case 206: - return T_HTTP_CODE_206; - case 300: - return T_HTTP_CODE_300; - case 301: - return T_HTTP_CODE_301; - case 302: - return T_HTTP_CODE_302; - case 303: - return T_HTTP_CODE_303; - case 304: - return T_HTTP_CODE_304; - case 305: - return T_HTTP_CODE_305; - case 307: - return T_HTTP_CODE_307; - case 400: - return T_HTTP_CODE_400; - case 401: - return T_HTTP_CODE_401; - case 402: - return T_HTTP_CODE_402; - case 403: - return T_HTTP_CODE_403; - case 404: - return T_HTTP_CODE_404; - case 405: - return T_HTTP_CODE_405; - case 406: - return T_HTTP_CODE_406; - case 407: - return T_HTTP_CODE_407; - case 408: - return T_HTTP_CODE_408; - case 409: - return T_HTTP_CODE_409; - case 410: - return T_HTTP_CODE_410; - case 411: - return T_HTTP_CODE_411; - case 412: - return T_HTTP_CODE_412; - case 413: - return T_HTTP_CODE_413; - case 414: - return T_HTTP_CODE_414; - case 415: - return T_HTTP_CODE_415; - case 416: - return T_HTTP_CODE_416; - case 417: - return T_HTTP_CODE_417; - case 500: - return T_HTTP_CODE_500; - case 501: - return T_HTTP_CODE_501; - case 502: - return T_HTTP_CODE_502; - case 503: - return T_HTTP_CODE_503; - case 504: - return T_HTTP_CODE_504; - case 505: - return T_HTTP_CODE_505; - default: - return T_HTTP_CODE_ANY; - } -} -#else // ESP8266 -const __FlashStringHelper* AsyncWebServerResponse::responseCodeToString(int code) -{ - switch (code) { - case 100: - return FPSTR(T_HTTP_CODE_100); - case 101: - return FPSTR(T_HTTP_CODE_101); - case 200: - return FPSTR(T_HTTP_CODE_200); - case 201: - return FPSTR(T_HTTP_CODE_201); - case 202: - return FPSTR(T_HTTP_CODE_202); - case 203: - return FPSTR(T_HTTP_CODE_203); - case 204: - return FPSTR(T_HTTP_CODE_204); - case 205: - return FPSTR(T_HTTP_CODE_205); - case 206: - return FPSTR(T_HTTP_CODE_206); - case 300: - return FPSTR(T_HTTP_CODE_300); - case 301: - return FPSTR(T_HTTP_CODE_301); - case 302: - return FPSTR(T_HTTP_CODE_302); - case 303: - return FPSTR(T_HTTP_CODE_303); - case 304: - return FPSTR(T_HTTP_CODE_304); - case 305: - return FPSTR(T_HTTP_CODE_305); - case 307: - return FPSTR(T_HTTP_CODE_307); - case 400: - return FPSTR(T_HTTP_CODE_400); - case 401: - return FPSTR(T_HTTP_CODE_401); - case 402: - return FPSTR(T_HTTP_CODE_402); - case 403: - return FPSTR(T_HTTP_CODE_403); - case 404: - return FPSTR(T_HTTP_CODE_404); - case 405: - return FPSTR(T_HTTP_CODE_405); - case 406: - return FPSTR(T_HTTP_CODE_406); - case 407: - return FPSTR(T_HTTP_CODE_407); - case 408: - return FPSTR(T_HTTP_CODE_408); - case 409: - return FPSTR(T_HTTP_CODE_409); - case 410: - return FPSTR(T_HTTP_CODE_410); - case 411: - return FPSTR(T_HTTP_CODE_411); - case 412: - return FPSTR(T_HTTP_CODE_412); - case 413: - return FPSTR(T_HTTP_CODE_413); - case 414: - return FPSTR(T_HTTP_CODE_414); - case 415: - return FPSTR(T_HTTP_CODE_415); - case 416: - return FPSTR(T_HTTP_CODE_416); - case 417: - return FPSTR(T_HTTP_CODE_417); - case 500: - return FPSTR(T_HTTP_CODE_500); - case 501: - return FPSTR(T_HTTP_CODE_501); - case 502: - return FPSTR(T_HTTP_CODE_502); - case 503: - return FPSTR(T_HTTP_CODE_503); - case 504: - return FPSTR(T_HTTP_CODE_504); - case 505: - return FPSTR(T_HTTP_CODE_505); - default: - return FPSTR(T_HTTP_CODE_ANY); - } -} -#endif // ESP8266 - -AsyncWebServerResponse::AsyncWebServerResponse() - : _code(0), _contentType(), _contentLength(0), _sendContentLength(true), _chunked(false), _headLength(0), _sentLength(0), _ackedLength(0), _writtenLength(0), _state(RESPONSE_SETUP) { - for (const auto& header : DefaultHeaders::Instance()) { - _headers.emplace_back(header); - } -} - -AsyncWebServerResponse::~AsyncWebServerResponse() = default; - -void AsyncWebServerResponse::setCode(int code) { - if (_state == RESPONSE_SETUP) - _code = code; -} - -void AsyncWebServerResponse::setContentLength(size_t len) { - if (_state == RESPONSE_SETUP) - _contentLength = len; -} - -void AsyncWebServerResponse::setContentType(const char* type) { - if (_state == RESPONSE_SETUP) - _contentType = type; -} - -void AsyncWebServerResponse::addHeader(const char* name, const char* value) { - _headers.emplace_back(name, value); -} - -String AsyncWebServerResponse::_assembleHead(uint8_t version) { - if (version) { - addHeader(T_Accept_Ranges, T_none); - if (_chunked) - addHeader(Transfer_Encoding, T_chunked); - } - String out; - int bufSize = 300; - char buf[bufSize]; - -#ifndef ESP8266 - snprintf(buf, bufSize, "HTTP/1.%d %d %s\r\n", version, _code, responseCodeToString(_code)); -#else - snprintf_P(buf, bufSize, PSTR("HTTP/1.%d %d %s\r\n"), version, _code, String(responseCodeToString(_code)).c_str()); -#endif - out.concat(buf); - - if (_sendContentLength) { - snprintf_P(buf, bufSize, PSTR("Content-Length: %d\r\n"), _contentLength); - out.concat(buf); - } - if (_contentType.length()) { - snprintf_P(buf, bufSize, PSTR("Content-Type: %s\r\n"), _contentType.c_str()); - out.concat(buf); - } - - for (const auto& header : _headers) { - snprintf_P(buf, bufSize, PSTR("%s: %s\r\n"), header.name().c_str(), header.value().c_str()); - out.concat(buf); - } - _headers.clear(); - - out.concat(T_rn); - _headLength = out.length(); - return out; -} - -bool AsyncWebServerResponse::_started() const { return _state > RESPONSE_SETUP; } -bool AsyncWebServerResponse::_finished() const { return _state > RESPONSE_WAIT_ACK; } -bool AsyncWebServerResponse::_failed() const { return _state == RESPONSE_FAILED; } -bool AsyncWebServerResponse::_sourceValid() const { return false; } -void AsyncWebServerResponse::_respond(AsyncWebServerRequest* request) { - _state = RESPONSE_END; - request->client()->close(); -} -size_t AsyncWebServerResponse::_ack(AsyncWebServerRequest* request, size_t len, uint32_t time) { - (void)request; - (void)len; - (void)time; - return 0; -} - -/* - * String/Code Response - * */ -AsyncBasicResponse::AsyncBasicResponse(int code, const char* contentType, const char* content) { - _code = code; - _content = content; - _contentType = contentType; - if (_content.length()) { - _contentLength = _content.length(); - if (!_contentType.length()) - _contentType = T_text_plain; - } - addHeader(T_Connection, T_close); -} - -void AsyncBasicResponse::_respond(AsyncWebServerRequest* request) { - _state = RESPONSE_HEADERS; - String out = _assembleHead(request->version()); - size_t outLen = out.length(); - size_t space = request->client()->space(); - if (!_contentLength && space >= outLen) { - _writtenLength += request->client()->write(out.c_str(), outLen); - _state = RESPONSE_WAIT_ACK; - } else if (_contentLength && space >= outLen + _contentLength) { - out += _content; - outLen += _contentLength; - _writtenLength += request->client()->write(out.c_str(), outLen); - _state = RESPONSE_WAIT_ACK; - } else if (space && space < outLen) { - String partial = out.substring(0, space); - _content = out.substring(space) + _content; - _contentLength += outLen - space; - _writtenLength += request->client()->write(partial.c_str(), partial.length()); - _state = RESPONSE_CONTENT; - } else if (space > outLen && space < (outLen + _contentLength)) { - size_t shift = space - outLen; - outLen += shift; - _sentLength += shift; - out += _content.substring(0, shift); - _content = _content.substring(shift); - _writtenLength += request->client()->write(out.c_str(), outLen); - _state = RESPONSE_CONTENT; - } else { - _content = out + _content; - _contentLength += outLen; - _state = RESPONSE_CONTENT; - } -} - -size_t AsyncBasicResponse::_ack(AsyncWebServerRequest* request, size_t len, uint32_t time) { - (void)time; - _ackedLength += len; - if (_state == RESPONSE_CONTENT) { - size_t available = _contentLength - _sentLength; - size_t space = request->client()->space(); - // we can fit in this packet - if (space > available) { - _writtenLength += request->client()->write(_content.c_str(), available); - _content = emptyString; - _state = RESPONSE_WAIT_ACK; - return available; - } - // send some data, the rest on ack - String out = _content.substring(0, space); - _content = _content.substring(space); - _sentLength += space; - _writtenLength += request->client()->write(out.c_str(), space); - return space; - } else if (_state == RESPONSE_WAIT_ACK) { - if (_ackedLength >= _writtenLength) { - _state = RESPONSE_END; - } - } - return 0; -} - -/* - * Abstract Response - * */ - -AsyncAbstractResponse::AsyncAbstractResponse(AwsTemplateProcessor callback) : _callback(callback) { - // In case of template processing, we're unable to determine real response size - if (callback) { - _contentLength = 0; - _sendContentLength = false; - _chunked = true; - } -} - -void AsyncAbstractResponse::_respond(AsyncWebServerRequest* request) { - addHeader(T_Connection, T_close); - _head = _assembleHead(request->version()); - _state = RESPONSE_HEADERS; - _ack(request, 0, 0); -} - -size_t AsyncAbstractResponse::_ack(AsyncWebServerRequest* request, size_t len, uint32_t time) { - (void)time; - if (!_sourceValid()) { - _state = RESPONSE_FAILED; - request->client()->close(); - return 0; - } - _ackedLength += len; - size_t space = request->client()->space(); - - size_t headLen = _head.length(); - if (_state == RESPONSE_HEADERS) { - if (space >= headLen) { - _state = RESPONSE_CONTENT; - space -= headLen; - } else { - String out = _head.substring(0, space); - _head = _head.substring(space); - _writtenLength += request->client()->write(out.c_str(), out.length()); - return out.length(); - } - } - - if (_state == RESPONSE_CONTENT) { - size_t outLen; - if (_chunked) { - if (space <= 8) { - return 0; - } - outLen = space; - } else if (!_sendContentLength) { - outLen = space; - } else { - outLen = ((_contentLength - _sentLength) > space) ? space : (_contentLength - _sentLength); - } - - uint8_t* buf = (uint8_t*)malloc(outLen + headLen); - if (!buf) { - // os_printf("_ack malloc %d failed\n", outLen+headLen); - return 0; - } - - if (headLen) { - memcpy(buf, _head.c_str(), _head.length()); - } - - size_t readLen = 0; - - if (_chunked) { - // HTTP 1.1 allows leading zeros in chunk length. Or spaces may be added. - // See RFC2616 sections 2, 3.6.1. - readLen = _fillBufferAndProcessTemplates(buf + headLen + 6, outLen - 8); - if (readLen == RESPONSE_TRY_AGAIN) { - free(buf); - return 0; - } - outLen = sprintf_P((char*)buf + headLen, PSTR("%x"), readLen) + headLen; - while (outLen < headLen + 4) - buf[outLen++] = ' '; - buf[outLen++] = '\r'; - buf[outLen++] = '\n'; - outLen += readLen; - buf[outLen++] = '\r'; - buf[outLen++] = '\n'; - } else { - readLen = _fillBufferAndProcessTemplates(buf + headLen, outLen); - if (readLen == RESPONSE_TRY_AGAIN) { - free(buf); - return 0; - } - outLen = readLen + headLen; - } - - if (headLen) { - _head = emptyString; - } - - if (outLen) { - _writtenLength += request->client()->write((const char*)buf, outLen); - } - - if (_chunked) { - _sentLength += readLen; - } else { - _sentLength += outLen - headLen; - } - - free(buf); - - if ((_chunked && readLen == 0) || (!_sendContentLength && outLen == 0) || (!_chunked && _sentLength == _contentLength)) { - _state = RESPONSE_WAIT_ACK; - } - return outLen; - - } else if (_state == RESPONSE_WAIT_ACK) { - if (!_sendContentLength || _ackedLength >= _writtenLength) { - _state = RESPONSE_END; - if (!_chunked && !_sendContentLength) - request->client()->close(true); - } - } - return 0; -} - -size_t AsyncAbstractResponse::_readDataFromCacheOrContent(uint8_t* data, const size_t len) { - // If we have something in cache, copy it to buffer - const size_t readFromCache = std::min(len, _cache.size()); - if (readFromCache) { - memcpy(data, _cache.data(), readFromCache); - _cache.erase(_cache.begin(), _cache.begin() + readFromCache); - } - // If we need to read more... - const size_t needFromFile = len - readFromCache; - const size_t readFromContent = _fillBuffer(data + readFromCache, needFromFile); - return readFromCache + readFromContent; -} - -size_t AsyncAbstractResponse::_fillBufferAndProcessTemplates(uint8_t* data, size_t len) { - if (!_callback) - return _fillBuffer(data, len); - - const size_t originalLen = len; - len = _readDataFromCacheOrContent(data, len); - // Now we've read 'len' bytes, either from cache or from file - // Search for template placeholders - uint8_t* pTemplateStart = data; - while ((pTemplateStart < &data[len]) && (pTemplateStart = (uint8_t*)memchr(pTemplateStart, TEMPLATE_PLACEHOLDER, &data[len - 1] - pTemplateStart + 1))) { // data[0] ... data[len - 1] - uint8_t* pTemplateEnd = (pTemplateStart < &data[len - 1]) ? (uint8_t*)memchr(pTemplateStart + 1, TEMPLATE_PLACEHOLDER, &data[len - 1] - pTemplateStart) : nullptr; - // temporary buffer to hold parameter name - uint8_t buf[TEMPLATE_PARAM_NAME_LENGTH + 1]; - String paramName; - // If closing placeholder is found: - if (pTemplateEnd) { - // prepare argument to callback - const size_t paramNameLength = std::min((size_t)sizeof(buf) - 1, (size_t)(pTemplateEnd - pTemplateStart - 1)); - if (paramNameLength) { - memcpy(buf, pTemplateStart + 1, paramNameLength); - buf[paramNameLength] = 0; - paramName = String(reinterpret_cast(buf)); - } else { // double percent sign encountered, this is single percent sign escaped. - // remove the 2nd percent sign - memmove(pTemplateEnd, pTemplateEnd + 1, &data[len] - pTemplateEnd - 1); - len += _readDataFromCacheOrContent(&data[len - 1], 1) - 1; - ++pTemplateStart; - } - } else if (&data[len - 1] - pTemplateStart + 1 < TEMPLATE_PARAM_NAME_LENGTH + 2) { // closing placeholder not found, check if it's in the remaining file data - memcpy(buf, pTemplateStart + 1, &data[len - 1] - pTemplateStart); - const size_t readFromCacheOrContent = _readDataFromCacheOrContent(buf + (&data[len - 1] - pTemplateStart), TEMPLATE_PARAM_NAME_LENGTH + 2 - (&data[len - 1] - pTemplateStart + 1)); - if (readFromCacheOrContent) { - pTemplateEnd = (uint8_t*)memchr(buf + (&data[len - 1] - pTemplateStart), TEMPLATE_PLACEHOLDER, readFromCacheOrContent); - if (pTemplateEnd) { - // prepare argument to callback - *pTemplateEnd = 0; - paramName = String(reinterpret_cast(buf)); - // Copy remaining read-ahead data into cache - _cache.insert(_cache.begin(), pTemplateEnd + 1, buf + (&data[len - 1] - pTemplateStart) + readFromCacheOrContent); - pTemplateEnd = &data[len - 1]; - } else // closing placeholder not found in file data, store found percent symbol as is and advance to the next position - { - // but first, store read file data in cache - _cache.insert(_cache.begin(), buf + (&data[len - 1] - pTemplateStart), buf + (&data[len - 1] - pTemplateStart) + readFromCacheOrContent); - ++pTemplateStart; - } - } else // closing placeholder not found in content data, store found percent symbol as is and advance to the next position - ++pTemplateStart; - } else // closing placeholder not found in content data, store found percent symbol as is and advance to the next position - ++pTemplateStart; - if (paramName.length()) { - // call callback and replace with result. - // Everything in range [pTemplateStart, pTemplateEnd] can be safely replaced with parameter value. - // Data after pTemplateEnd may need to be moved. - // The first byte of data after placeholder is located at pTemplateEnd + 1. - // It should be located at pTemplateStart + numBytesCopied (to begin right after inserted parameter value). - const String paramValue(_callback(paramName)); - const char* pvstr = paramValue.c_str(); - const unsigned int pvlen = paramValue.length(); - const size_t numBytesCopied = std::min(pvlen, static_cast(&data[originalLen - 1] - pTemplateStart + 1)); - // make room for param value - // 1. move extra data to cache if parameter value is longer than placeholder AND if there is no room to store - if ((pTemplateEnd + 1 < pTemplateStart + numBytesCopied) && (originalLen - (pTemplateStart + numBytesCopied - pTemplateEnd - 1) < len)) { - _cache.insert(_cache.begin(), &data[originalLen - (pTemplateStart + numBytesCopied - pTemplateEnd - 1)], &data[len]); - // 2. parameter value is longer than placeholder text, push the data after placeholder which not saved into cache further to the end - memmove(pTemplateStart + numBytesCopied, pTemplateEnd + 1, &data[originalLen] - pTemplateStart - numBytesCopied); - len = originalLen; // fix issue with truncated data, not sure if it has any side effects - } else if (pTemplateEnd + 1 != pTemplateStart + numBytesCopied) - // 2. Either parameter value is shorter than placeholder text OR there is enough free space in buffer to fit. - // Move the entire data after the placeholder - memmove(pTemplateStart + numBytesCopied, pTemplateEnd + 1, &data[len] - pTemplateEnd - 1); - // 3. replace placeholder with actual value - memcpy(pTemplateStart, pvstr, numBytesCopied); - // If result is longer than buffer, copy the remainder into cache (this could happen only if placeholder text itself did not fit entirely in buffer) - if (numBytesCopied < pvlen) { - _cache.insert(_cache.begin(), pvstr + numBytesCopied, pvstr + pvlen); - } else if (pTemplateStart + numBytesCopied < pTemplateEnd + 1) { // result is copied fully; if result is shorter than placeholder text... - // there is some free room, fill it from cache - const size_t roomFreed = pTemplateEnd + 1 - pTemplateStart - numBytesCopied; - const size_t totalFreeRoom = originalLen - len + roomFreed; - len += _readDataFromCacheOrContent(&data[len - roomFreed], totalFreeRoom) - roomFreed; - } else { // result is copied fully; it is longer than placeholder text - const size_t roomTaken = pTemplateStart + numBytesCopied - pTemplateEnd - 1; - len = std::min(len + roomTaken, originalLen); - } - } - } // while(pTemplateStart) - return len; -} - -/* - * File Response - * */ - -AsyncFileResponse::~AsyncFileResponse() { - if (_content) - _content.close(); -} - -void AsyncFileResponse::_setContentTypeFromPath(const String& path) { -#if HAVE_EXTERN_GET_Content_Type_FUNCTION - #ifndef ESP8266 - extern const char* getContentType(const String& path); - #else - extern const __FlashStringHelper* getContentType(const String& path); - #endif - _contentType = getContentType(path); -#else - if (path.endsWith(T__html)) - _contentType = T_text_html; - else if (path.endsWith(T__htm)) - _contentType = T_text_html; - else if (path.endsWith(T__css)) - _contentType = T_text_css; - else if (path.endsWith(T__json)) - _contentType = T_application_json; - else if (path.endsWith(T__js)) - _contentType = T_application_javascript; - else if (path.endsWith(T__png)) - _contentType = T_image_png; - else if (path.endsWith(T__gif)) - _contentType = T_image_gif; - else if (path.endsWith(T__jpg)) - _contentType = T_image_jpeg; - else if (path.endsWith(T__ico)) - _contentType = T_image_x_icon; - else if (path.endsWith(T__svg)) - _contentType = T_image_svg_xml; - else if (path.endsWith(T__eot)) - _contentType = T_font_eot; - else if (path.endsWith(T__woff)) - _contentType = T_font_woff; - else if (path.endsWith(T__woff2)) - _contentType = T_font_woff2; - else if (path.endsWith(T__ttf)) - _contentType = T_font_ttf; - else if (path.endsWith(T__xml)) - _contentType = T_text_xml; - else if (path.endsWith(T__pdf)) - _contentType = T_application_pdf; - else if (path.endsWith(T__zip)) - _contentType = T_application_zip; - else if (path.endsWith(T__gz)) - _contentType = T_application_x_gzip; - else - _contentType = T_text_plain; -#endif -} - -AsyncFileResponse::AsyncFileResponse(FS& fs, const String& path, const char* contentType, bool download, AwsTemplateProcessor callback) : AsyncAbstractResponse(callback) { - _code = 200; - _path = path; - - if (!download && !fs.exists(_path) && fs.exists(_path + T__gz)) { - _path = _path + T__gz; - addHeader(T_Content_Encoding, T_gzip); - _callback = nullptr; // Unable to process zipped templates - _sendContentLength = true; - _chunked = false; - } - - _content = fs.open(_path, fs::FileOpenMode::read); - _contentLength = _content.size(); - - if (strlen(contentType) == 0) - _setContentTypeFromPath(path); - else - _contentType = contentType; - - int filenameStart = path.lastIndexOf('/') + 1; - char buf[26 + path.length() - filenameStart]; - char* filename = (char*)path.c_str() + filenameStart; - - if (download) { - // set filename and force download - snprintf_P(buf, sizeof(buf), PSTR("attachment; filename=\"%s\""), filename); - } else { - // set filename and force rendering - snprintf_P(buf, sizeof(buf), PSTR("inline")); - } - addHeader(T_Content_Disposition, buf); -} - -AsyncFileResponse::AsyncFileResponse(File content, const String& path, const char* contentType, bool download, AwsTemplateProcessor callback) : AsyncAbstractResponse(callback) { - _code = 200; - _path = path; - - if (!download && String(content.name()).endsWith(T__gz) && !path.endsWith(T__gz)) { - addHeader(T_Content_Encoding, T_gzip); - _callback = nullptr; // Unable to process gzipped templates - _sendContentLength = true; - _chunked = false; - } - - _content = content; - _contentLength = _content.size(); - - if (strlen(contentType) == 0) - _setContentTypeFromPath(path); - else - _contentType = contentType; - - int filenameStart = path.lastIndexOf('/') + 1; - char buf[26 + path.length() - filenameStart]; - char* filename = (char*)path.c_str() + filenameStart; - - if (download) { - snprintf_P(buf, sizeof(buf), PSTR("attachment; filename=\"%s\""), filename); - } else { - snprintf_P(buf, sizeof(buf), PSTR("inline")); - } - addHeader(T_Content_Disposition, buf); -} - -size_t AsyncFileResponse::_fillBuffer(uint8_t* data, size_t len) { - return _content.read(data, len); -} - -/* - * Stream Response - * */ - -AsyncStreamResponse::AsyncStreamResponse(Stream& stream, const char* contentType, size_t len, AwsTemplateProcessor callback) : AsyncAbstractResponse(callback) { - _code = 200; - _content = &stream; - _contentLength = len; - _contentType = contentType; -} - -size_t AsyncStreamResponse::_fillBuffer(uint8_t* data, size_t len) { - size_t available = _content->available(); - size_t outLen = (available > len) ? len : available; - size_t i; - for (i = 0; i < outLen; i++) - data[i] = _content->read(); - return outLen; -} - -/* - * Callback Response - * */ - -AsyncCallbackResponse::AsyncCallbackResponse(const char* contentType, size_t len, AwsResponseFiller callback, AwsTemplateProcessor templateCallback) : AsyncAbstractResponse(templateCallback) { - _code = 200; - _content = callback; - _contentLength = len; - if (!len) - _sendContentLength = false; - _contentType = contentType; - _filledLength = 0; -} - -size_t AsyncCallbackResponse::_fillBuffer(uint8_t* data, size_t len) { - size_t ret = _content(data, len, _filledLength); - if (ret != RESPONSE_TRY_AGAIN) { - _filledLength += ret; - } - return ret; -} - -/* - * Chunked Response - * */ - -AsyncChunkedResponse::AsyncChunkedResponse(const char* contentType, AwsResponseFiller callback, AwsTemplateProcessor processorCallback) : AsyncAbstractResponse(processorCallback) { - _code = 200; - _content = callback; - _contentLength = 0; - _contentType = contentType; - _sendContentLength = false; - _chunked = true; - _filledLength = 0; -} - -size_t AsyncChunkedResponse::_fillBuffer(uint8_t* data, size_t len) { - size_t ret = _content(data, len, _filledLength); - if (ret != RESPONSE_TRY_AGAIN) { - _filledLength += ret; - } - return ret; -} - -/* - * Progmem Response - * */ - -AsyncProgmemResponse::AsyncProgmemResponse(int code, const char* contentType, const uint8_t* content, size_t len, AwsTemplateProcessor callback) : AsyncAbstractResponse(callback) { - _code = code; - _content = content; - _contentType = contentType; - _contentLength = len; - _readLength = 0; -} - -size_t AsyncProgmemResponse::_fillBuffer(uint8_t* data, size_t len) { - size_t left = _contentLength - _readLength; - if (left > len) { - memcpy_P(data, _content + _readLength, len); - _readLength += len; - return len; - } - memcpy_P(data, _content + _readLength, left); - _readLength += left; - return left; -} - -/* - * Response Stream (You can print/write/printf to it, up to the contentLen bytes) - * */ - -AsyncResponseStream::AsyncResponseStream(const char* contentType, size_t bufferSize) { - _code = 200; - _contentLength = 0; - _contentType = contentType; - _content = std::unique_ptr(new cbuf(bufferSize)); // std::make_unique(bufferSize); -} - -AsyncResponseStream::~AsyncResponseStream() = default; - -size_t AsyncResponseStream::_fillBuffer(uint8_t* buf, size_t maxLen) { - return _content->read((char*)buf, maxLen); -} - -size_t AsyncResponseStream::write(const uint8_t* data, size_t len) { - if (_started()) - return 0; - - if (len > _content->room()) { - size_t needed = len - _content->room(); - _content->resizeAdd(needed); - } - size_t written = _content->write((const char*)data, len); - _contentLength += written; - return written; -} - -size_t AsyncResponseStream::write(uint8_t data) { - return write(&data, 1); -} diff --git a/lib/ESPAsyncWebServer/src/WebServer.cpp b/lib/ESPAsyncWebServer/src/WebServer.cpp deleted file mode 100644 index d7c9a02..0000000 --- a/lib/ESPAsyncWebServer/src/WebServer.cpp +++ /dev/null @@ -1,227 +0,0 @@ -/* - Asynchronous WebServer library for Espressif MCUs - - Copyright (c) 2016 Hristo Gochkov. All rights reserved. - This file is part of the esp8266 core for Arduino environment. - - This library is free software; you can redistribute it and/or - modify it under the terms of the GNU Lesser General Public - License as published by the Free Software Foundation; either - version 2.1 of the License, or (at your option) any later version. - - This library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU - Lesser General Public License for more details. - - You should have received a copy of the GNU Lesser General Public - License along with this library; if not, write to the Free Software - Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA -*/ -#include "ESPAsyncWebServer.h" -#include "WebHandlerImpl.h" - -using namespace asyncsrv; - -bool ON_STA_FILTER(AsyncWebServerRequest* request) { - #ifndef CONFIG_IDF_TARGET_ESP32H2 - return WiFi.localIP() == request->client()->localIP(); - #else - return false; - #endif -} - -bool ON_AP_FILTER(AsyncWebServerRequest* request) { - #ifndef CONFIG_IDF_TARGET_ESP32H2 - return WiFi.localIP() != request->client()->localIP(); - #else - return false; - #endif -} - -#ifndef HAVE_FS_FILE_OPEN_MODE -const char* fs::FileOpenMode::read = "r"; -const char* fs::FileOpenMode::write = "w"; -const char* fs::FileOpenMode::append = "a"; -#endif - -AsyncWebServer::AsyncWebServer(uint16_t port) - : _server(port) { - _catchAllHandler = new AsyncCallbackWebHandler(); - if (_catchAllHandler == NULL) - return; - _server.onClient([](void* s, AsyncClient* c) { - if (c == NULL) - return; - c->setRxTimeout(3); - AsyncWebServerRequest* r = new AsyncWebServerRequest((AsyncWebServer*)s, c); - if (r == NULL) { - c->close(true); - c->free(); - delete c; - } - }, - this); -} - -AsyncWebServer::~AsyncWebServer() { - reset(); - end(); - if (_catchAllHandler) - delete _catchAllHandler; -} - -AsyncWebRewrite& AsyncWebServer::addRewrite(std::shared_ptr rewrite) { - _rewrites.emplace_back(rewrite); - return *_rewrites.back().get(); -} - -AsyncWebRewrite& AsyncWebServer::addRewrite(AsyncWebRewrite* rewrite) { - _rewrites.emplace_back(rewrite); - return *_rewrites.back().get(); -} - -bool AsyncWebServer::removeRewrite(AsyncWebRewrite* rewrite) { - return removeRewrite(rewrite->from().c_str(), rewrite->toUrl().c_str()); -} - -bool AsyncWebServer::removeRewrite(const char* from, const char* to) { - for (auto r = _rewrites.begin(); r != _rewrites.end(); ++r) { - if (r->get()->from() == from && r->get()->toUrl() == to) { - _rewrites.erase(r); - return true; - } - } - return false; -} - -AsyncWebRewrite& AsyncWebServer::rewrite(const char* from, const char* to) { - _rewrites.emplace_back(std::make_shared(from, to)); - return *_rewrites.back().get(); -} - -AsyncWebHandler& AsyncWebServer::addHandler(AsyncWebHandler* handler) { - _handlers.emplace_back(handler); - return *(_handlers.back().get()); -} - -bool AsyncWebServer::removeHandler(AsyncWebHandler* handler) { - for (auto i = _handlers.begin(); i != _handlers.end(); ++i) { - if (i->get() == handler) { - _handlers.erase(i); - return true; - } - } - return false; -} - -void AsyncWebServer::begin() { - _server.setNoDelay(true); - _server.begin(); -} - -void AsyncWebServer::end() { - _server.end(); -} - -#if ASYNC_TCP_SSL_ENABLED -void AsyncWebServer::onSslFileRequest(AcSSlFileHandler cb, void* arg) { - _server.onSslFileRequest(cb, arg); -} - -void AsyncWebServer::beginSecure(const char* cert, const char* key, const char* password) { - _server.beginSecure(cert, key, password); -} -#endif - -void AsyncWebServer::_handleDisconnect(AsyncWebServerRequest* request) { - delete request; -} - -void AsyncWebServer::_rewriteRequest(AsyncWebServerRequest* request) { - for (const auto& r : _rewrites) { - if (r->match(request)) { - request->_url = r->toUrl(); - request->_addGetParams(r->params()); - } - } -} - -void AsyncWebServer::_attachHandler(AsyncWebServerRequest* request) { - for (auto& h : _handlers) { - if (h->filter(request) && h->canHandle(request)) { - request->setHandler(h.get()); - return; - } - } - - request->addInterestingHeader(T_ANY); - request->setHandler(_catchAllHandler); -} - -AsyncCallbackWebHandler& AsyncWebServer::on(const char* uri, WebRequestMethodComposite method, ArRequestHandlerFunction onRequest, ArUploadHandlerFunction onUpload, ArBodyHandlerFunction onBody) { - AsyncCallbackWebHandler* handler = new AsyncCallbackWebHandler(); - handler->setUri(uri); - handler->setMethod(method); - handler->onRequest(onRequest); - handler->onUpload(onUpload); - handler->onBody(onBody); - addHandler(handler); - return *handler; -} - -AsyncCallbackWebHandler& AsyncWebServer::on(const char* uri, WebRequestMethodComposite method, ArRequestHandlerFunction onRequest, ArUploadHandlerFunction onUpload) { - AsyncCallbackWebHandler* handler = new AsyncCallbackWebHandler(); - handler->setUri(uri); - handler->setMethod(method); - handler->onRequest(onRequest); - handler->onUpload(onUpload); - addHandler(handler); - return *handler; -} - -AsyncCallbackWebHandler& AsyncWebServer::on(const char* uri, WebRequestMethodComposite method, ArRequestHandlerFunction onRequest) { - AsyncCallbackWebHandler* handler = new AsyncCallbackWebHandler(); - handler->setUri(uri); - handler->setMethod(method); - handler->onRequest(onRequest); - addHandler(handler); - return *handler; -} - -AsyncCallbackWebHandler& AsyncWebServer::on(const char* uri, ArRequestHandlerFunction onRequest) { - AsyncCallbackWebHandler* handler = new AsyncCallbackWebHandler(); - handler->setUri(uri); - handler->onRequest(onRequest); - addHandler(handler); - return *handler; -} - -AsyncStaticWebHandler& AsyncWebServer::serveStatic(const char* uri, fs::FS& fs, const char* path, const char* cache_control) { - AsyncStaticWebHandler* handler = new AsyncStaticWebHandler(uri, fs, path, cache_control); - addHandler(handler); - return *handler; -} - -void AsyncWebServer::onNotFound(ArRequestHandlerFunction fn) { - _catchAllHandler->onRequest(fn); -} - -void AsyncWebServer::onFileUpload(ArUploadHandlerFunction fn) { - _catchAllHandler->onUpload(fn); -} - -void AsyncWebServer::onRequestBody(ArBodyHandlerFunction fn) { - _catchAllHandler->onBody(fn); -} - -void AsyncWebServer::reset() { - _rewrites.clear(); - _handlers.clear(); - - if (_catchAllHandler != NULL) { - _catchAllHandler->onRequest(NULL); - _catchAllHandler->onUpload(NULL); - _catchAllHandler->onBody(NULL); - } -} diff --git a/lib/ESPAsyncWebServer/src/literals.h b/lib/ESPAsyncWebServer/src/literals.h deleted file mode 100644 index 8a7293b..0000000 --- a/lib/ESPAsyncWebServer/src/literals.h +++ /dev/null @@ -1,345 +0,0 @@ -#pragma once - -namespace asyncsrv { - -static constexpr const char* empty = ""; - -#ifndef ESP8622 -static constexpr const char* T_100_CONTINUE = "100-continue"; -static constexpr const char* T_ACCEPT = "Accept"; -static constexpr const char* T_Accept_Ranges = "Accept-Ranges"; -static constexpr const char* T_app_xform_urlencoded = "application/x-www-form-urlencoded"; -static constexpr const char* T_AUTH = "Authorization"; -static constexpr const char* T_BASIC = "Basic"; -static constexpr const char* T_BASIC_REALM = "Basic realm=\""; -static constexpr const char* T_BASIC_REALM_LOGIN_REQ = "Basic realm=\"Login Required\""; -static constexpr const char* T_BODY = "body"; -static constexpr const char* T_Cache_Control = "Cache-Control"; -static constexpr const char* T_chunked = "chunked"; -static constexpr const char* T_close = "close"; -static constexpr const char* T_Connection = "Connection"; -static constexpr const char* T_Content_Disposition = "Content-Disposition"; -static constexpr const char* T_Content_Encoding = "Content-Encoding"; -static constexpr const char* T_Content_Length = "Content-Length"; -static constexpr const char* T_Content_Type = "Content-Type"; -static constexpr const char* T_Cookie = "Cookie"; -static constexpr const char* T_DIGEST = "Digest"; -static constexpr const char* T_DIGEST_ = "Digest "; -static constexpr const char* T_ETag = "ETag"; -static constexpr const char* T_EXPECT = "Expect"; -static constexpr const char* T_HTTP_1_0 = "HTTP/1.0"; -static constexpr const char* T_HTTP_100_CONT = "HTTP/1.1 100 Continue\r\n\r\n"; -static constexpr const char* T_IMS = "If-Modified-Since"; -static constexpr const char* T_INM = "If-None-Match"; -static constexpr const char* T_keep_alive = "keep-alive"; -static constexpr const char* T_Last_Event_ID = "Last-Event-ID"; -static constexpr const char* T_Last_Modified = "Last-Modified"; -static constexpr const char* T_LOCATION = "Location"; -static constexpr const char* T_MULTIPART_ = "multipart/"; -static constexpr const char* T_no_cache = "no-cache"; -static constexpr const char* T_none = "none"; -static constexpr const char* T_UPGRADE = "Upgrade"; -static constexpr const char* T_WS = "websocket"; -static constexpr const char* T_WWW_AUTH = "WWW-Authenticate"; -static constexpr const char* Transfer_Encoding = "Transfer-Encoding"; - -// HTTP Methods -static constexpr const char* T_ANY = "ANY"; -static constexpr const char* T_GET = "GET"; -static constexpr const char* T_POST = "POST"; -static constexpr const char* T_PUT = "PUT"; -static constexpr const char* T_DELETE = "DELETE"; -static constexpr const char* T_PATCH = "PATCH"; -static constexpr const char* T_HEAD = "HEAD"; -static constexpr const char* T_OPTIONS = "OPTIONS"; -static constexpr const char* T_UNKNOWN = "UNKNOWN"; - -// Req content types -static constexpr const char* T_RCT_NOT_USED = "RCT_NOT_USED"; -static constexpr const char* T_RCT_DEFAULT = "RCT_DEFAULT"; -static constexpr const char* T_RCT_HTTP = "RCT_HTTP"; -static constexpr const char* T_RCT_WS = "RCT_WS"; -static constexpr const char* T_RCT_EVENT = "RCT_EVENT"; -static constexpr const char* T_ERROR = "ERROR"; - -// extentions & MIME-Types -static constexpr const char* T__css = ".css"; -static constexpr const char* T__eot = ".eot"; -static constexpr const char* T__gif = ".gif"; -static constexpr const char* T__gz = ".gz"; -static constexpr const char* T__htm = ".htm"; -static constexpr const char* T__html = ".html"; -static constexpr const char* T__ico = ".ico"; -static constexpr const char* T__jpg = ".jpg"; -static constexpr const char* T__js = ".js"; -static constexpr const char* T__json = ".json"; -static constexpr const char* T__pdf = ".pdf"; -static constexpr const char* T__png = ".png"; -static constexpr const char* T__svg = ".svg"; -static constexpr const char* T__ttf = ".ttf"; -static constexpr const char* T__woff = ".woff"; -static constexpr const char* T__woff2 = ".woff2"; -static constexpr const char* T__xml = ".xml"; -static constexpr const char* T__zip = ".zip"; -static constexpr const char* T_application_javascript = "application/javascript"; -static constexpr const char* T_application_json = "application/json"; -static constexpr const char* T_application_msgpack = "application/msgpack"; -static constexpr const char* T_application_pdf = "application/pdf"; -static constexpr const char* T_application_x_gzip = "application/x-gzip"; -static constexpr const char* T_application_zip = "application/zip"; -static constexpr const char* T_font_eot = "font/eot"; -static constexpr const char* T_font_ttf = "font/ttf"; -static constexpr const char* T_font_woff = "font/woff"; -static constexpr const char* T_font_woff2 = "font/woff2"; -static constexpr const char* T_image_gif = "image/gif"; -static constexpr const char* T_image_jpeg = "image/jpeg"; -static constexpr const char* T_image_png = "image/png"; -static constexpr const char* T_image_svg_xml = "image/svg+xml"; -static constexpr const char* T_image_x_icon = "image/x-icon"; -static constexpr const char* T_text_css = "text/css"; -static constexpr const char* T_text_event_stream = "text/event-stream"; -static constexpr const char* T_text_html = "text/html"; -static constexpr const char* T_text_plain = "text/plain"; -static constexpr const char* T_text_xml = "text/xml"; - -// Responce codes -static constexpr const char* T_HTTP_CODE_100 = "Continue"; -static constexpr const char* T_HTTP_CODE_101 = "Switching Protocols"; -static constexpr const char* T_HTTP_CODE_200 = "OK"; -static constexpr const char* T_HTTP_CODE_201 = "Created"; -static constexpr const char* T_HTTP_CODE_202 = "Accepted"; -static constexpr const char* T_HTTP_CODE_203 = "Non-Authoritative Information"; -static constexpr const char* T_HTTP_CODE_204 = "No Content"; -static constexpr const char* T_HTTP_CODE_205 = "Reset Content"; -static constexpr const char* T_HTTP_CODE_206 = "Partial Content"; -static constexpr const char* T_HTTP_CODE_300 = "Multiple Choices"; -static constexpr const char* T_HTTP_CODE_301 = "Moved Permanently"; -static constexpr const char* T_HTTP_CODE_302 = "Found"; -static constexpr const char* T_HTTP_CODE_303 = "See Other"; -static constexpr const char* T_HTTP_CODE_304 = "Not Modified"; -static constexpr const char* T_HTTP_CODE_305 = "Use Proxy"; -static constexpr const char* T_HTTP_CODE_307 = "Temporary Redirect"; -static constexpr const char* T_HTTP_CODE_400 = "Bad Request"; -static constexpr const char* T_HTTP_CODE_401 = "Unauthorized"; -static constexpr const char* T_HTTP_CODE_402 = "Payment Required"; -static constexpr const char* T_HTTP_CODE_403 = "Forbidden"; -static constexpr const char* T_HTTP_CODE_404 = "Not Found"; -static constexpr const char* T_HTTP_CODE_405 = "Method Not Allowed"; -static constexpr const char* T_HTTP_CODE_406 = "Not Acceptable"; -static constexpr const char* T_HTTP_CODE_407 = "Proxy Authentication Required"; -static constexpr const char* T_HTTP_CODE_408 = "Request Time-out"; -static constexpr const char* T_HTTP_CODE_409 = "Conflict"; -static constexpr const char* T_HTTP_CODE_410 = "Gone"; -static constexpr const char* T_HTTP_CODE_411 = "Length Required"; -static constexpr const char* T_HTTP_CODE_412 = "Precondition Failed"; -static constexpr const char* T_HTTP_CODE_413 = "Request Entity Too Large"; -static constexpr const char* T_HTTP_CODE_414 = "Request-URI Too Large"; -static constexpr const char* T_HTTP_CODE_415 = "Unsupported Media Type"; -static constexpr const char* T_HTTP_CODE_416 = "Requested range not satisfiable"; -static constexpr const char* T_HTTP_CODE_417 = "Expectation Failed"; -static constexpr const char* T_HTTP_CODE_500 = "Internal Server Error"; -static constexpr const char* T_HTTP_CODE_501 = "Not Implemented"; -static constexpr const char* T_HTTP_CODE_502 = "Bad Gateway"; -static constexpr const char* T_HTTP_CODE_503 = "Service Unavailable"; -static constexpr const char* T_HTTP_CODE_504 = "Gateway Time-out"; -static constexpr const char* T_HTTP_CODE_505 = "HTTP Version not supported"; -static constexpr const char* T_HTTP_CODE_ANY = "Unknown code"; - -// other -static constexpr const char* T__opaque = "\", opaque=\""; -static constexpr const char* T_13 = "13"; -static constexpr const char* T_asyncesp = "asyncesp"; -static constexpr const char* T_auth_nonce = "\", qop=\"auth\", nonce=\""; -static constexpr const char* T_cnonce = "cnonce"; -static constexpr const char* T_data_ = "data: "; -static constexpr const char* T_event_ = "event: "; -static constexpr const char* T_filename = "filename"; -static constexpr const char* T_gzip = "gzip"; -static constexpr const char* T_Host = "Host"; -static constexpr const char* T_id__ = "id: "; -static constexpr const char* T_name = "name"; -static constexpr const char* T_nc = "nc"; -static constexpr const char* T_nonce = "nonce"; -static constexpr const char* T_opaque = "opaque"; -static constexpr const char* T_qop = "qop"; -static constexpr const char* T_realm = "realm"; -static constexpr const char* T_realm__ = "realm=\""; -static constexpr const char* T_response = "response"; -static constexpr const char* T_retry_ = "retry: "; -static constexpr const char* T_rn = "\r\n"; -static constexpr const char* T_rnrn = "\r\n\r\n"; -static constexpr const char* T_uri = "uri"; -static constexpr const char* T_username = "username"; - - -#else // ESP8622 - -static const char T_100_CONTINUE[] PROGMEM = "100-continue"; -static const char T_ACCEPT[] PROGMEM = "Accept"; -static const char T_Accept_Ranges[] PROGMEM = "Accept-Ranges"; -static const char T_app_xform_urlencoded[] PROGMEM = "application/x-www-form-urlencoded"; -static const char T_AUTH[] PROGMEM = "Authorization"; -static const char T_BASIC[] PROGMEM = "Basic"; -static const char T_BASIC_REALM[] PROGMEM = "Basic realm=\""; -static const char T_BASIC_REALM_LOGIN_REQ[] PROGMEM = "Basic realm=\"Login Required\""; -static const char T_BODY[] PROGMEM = "body"; -static const char T_Cache_Control[] PROGMEM = "Cache-Control"; -static const char T_chunked[] PROGMEM = "chunked"; -static const char T_close[] PROGMEM = "close"; -static const char T_Connection[] PROGMEM = "Connection"; -static const char T_Content_Disposition[] PROGMEM = "Content-Disposition"; -static const char T_Content_Encoding[] PROGMEM = "Content-Encoding"; -static const char T_Content_Length[] PROGMEM = "Content-Length"; -static const char T_Content_Type[] PROGMEM = "Content-Type"; -static const char T_Cookie[] PROGMEM = "Cookie"; -static const char T_DIGEST[] PROGMEM = "Digest"; -static const char T_DIGEST_[] PROGMEM = "Digest "; -static const char T_ETag[] PROGMEM = "ETag"; -static const char T_EXPECT[] PROGMEM = "Expect"; -static const char T_HTTP_1_0[] PROGMEM = "HTTP/1.0"; -static const char T_HTTP_100_CONT[] PROGMEM = "HTTP/1.1 100 Continue\r\n\r\n"; -static const char T_IMS[] PROGMEM = "If-Modified-Since"; -static const char T_INM[] PROGMEM = "If-None-Match"; -static const char T_keep_alive[] PROGMEM = "keep-alive"; -static const char T_Last_Event_ID[] PROGMEM = "Last-Event-ID"; -static const char T_Last_Modified[] PROGMEM = "Last-Modified"; -static const char T_LOCATION[] PROGMEM = "Location"; -static const char T_MULTIPART_[] PROGMEM = "multipart/"; -static const char T_no_cache[] PROGMEM = "no-cache"; -static const char T_none[] PROGMEM = "none"; -static const char T_UPGRADE[] PROGMEM = "Upgrade"; -static const char T_WS[] PROGMEM = "websocket"; -static const char T_WWW_AUTH[] PROGMEM = "WWW-Authenticate"; -static const char Transfer_Encoding[] PROGMEM = "Transfer-Encoding"; - -// HTTP Methods -static const char T_ANY[] PROGMEM = "ANY"; -static const char T_GET[] PROGMEM = "GET"; -static const char T_POST[] PROGMEM = "POST"; -static const char T_PUT[] PROGMEM = "PUT"; -static const char T_DELETE[] PROGMEM = "DELETE"; -static const char T_PATCH[] PROGMEM = "PATCH"; -static const char T_HEAD[] PROGMEM = "HEAD"; -static const char T_OPTIONS[] PROGMEM = "OPTIONS"; -static const char T_UNKNOWN[] PROGMEM = "UNKNOWN"; - -// Req content types -static const char T_RCT_NOT_USED[] PROGMEM = "RCT_NOT_USED"; -static const char T_RCT_DEFAULT[] PROGMEM = "RCT_DEFAULT"; -static const char T_RCT_HTTP[] PROGMEM = "RCT_HTTP"; -static const char T_RCT_WS[] PROGMEM = "RCT_WS"; -static const char T_RCT_EVENT[] PROGMEM = "RCT_EVENT"; -static const char T_ERROR[] PROGMEM = "ERROR"; - -// extentions & MIME-Types -static const char T__css[] PROGMEM = ".css"; -static const char T__eot[] PROGMEM = ".eot"; -static const char T__gif[] PROGMEM = ".gif"; -static const char T__gz[] PROGMEM = ".gz"; -static const char T__htm[] PROGMEM = ".htm"; -static const char T__html[] PROGMEM = ".html"; -static const char T__ico[] PROGMEM = ".ico"; -static const char T__jpg[] PROGMEM = ".jpg"; -static const char T__js[] PROGMEM = ".js"; -static const char T__json[] PROGMEM = ".json"; -static const char T__pdf[] PROGMEM = ".pdf"; -static const char T__png[] PROGMEM = ".png"; -static const char T__svg[] PROGMEM = ".svg"; -static const char T__ttf[] PROGMEM = ".ttf"; -static const char T__woff[] PROGMEM = ".woff"; -static const char T__woff2[] PROGMEM = ".woff2"; -static const char T__xml[] PROGMEM = ".xml"; -static const char T__zip[] PROGMEM = ".zip"; -static const char T_application_javascript[] PROGMEM = "application/javascript"; -static const char T_application_json[] PROGMEM = "application/json"; -static const char T_application_msgpack[] PROGMEM = "application/msgpack"; -static const char T_application_pdf[] PROGMEM = "application/pdf"; -static const char T_application_x_gzip[] PROGMEM = "application/x-gzip"; -static const char T_application_zip[] PROGMEM = "application/zip"; -static const char T_font_eot[] PROGMEM = "font/eot"; -static const char T_font_ttf[] PROGMEM = "font/ttf"; -static const char T_font_woff[] PROGMEM = "font/woff"; -static const char T_font_woff2[] PROGMEM = "font/woff2"; -static const char T_image_gif[] PROGMEM = "image/gif"; -static const char T_image_jpeg[] PROGMEM = "image/jpeg"; -static const char T_image_png[] PROGMEM = "image/png"; -static const char T_image_svg_xml[] PROGMEM = "image/svg+xml"; -static const char T_image_x_icon[] PROGMEM = "image/x-icon"; -static const char T_text_css[] PROGMEM = "text/css"; -static const char T_text_event_stream[] PROGMEM = "text/event-stream"; -static const char T_text_html[] PROGMEM = "text/html"; -static const char T_text_plain[] PROGMEM = "text/plain"; -static const char T_text_xml[] PROGMEM = "text/xml"; - -// Responce codes -static const char T_HTTP_CODE_100[] PROGMEM = "Continue"; -static const char T_HTTP_CODE_101[] PROGMEM = "Switching Protocols"; -static const char T_HTTP_CODE_200[] PROGMEM = "OK"; -static const char T_HTTP_CODE_201[] PROGMEM = "Created"; -static const char T_HTTP_CODE_202[] PROGMEM = "Accepted"; -static const char T_HTTP_CODE_203[] PROGMEM = "Non-Authoritative Information"; -static const char T_HTTP_CODE_204[] PROGMEM = "No Content"; -static const char T_HTTP_CODE_205[] PROGMEM = "Reset Content"; -static const char T_HTTP_CODE_206[] PROGMEM = "Partial Content"; -static const char T_HTTP_CODE_300[] PROGMEM = "Multiple Choices"; -static const char T_HTTP_CODE_301[] PROGMEM = "Moved Permanently"; -static const char T_HTTP_CODE_302[] PROGMEM = "Found"; -static const char T_HTTP_CODE_303[] PROGMEM = "See Other"; -static const char T_HTTP_CODE_304[] PROGMEM = "Not Modified"; -static const char T_HTTP_CODE_305[] PROGMEM = "Use Proxy"; -static const char T_HTTP_CODE_307[] PROGMEM = "Temporary Redirect"; -static const char T_HTTP_CODE_400[] PROGMEM = "Bad Request"; -static const char T_HTTP_CODE_401[] PROGMEM = "Unauthorized"; -static const char T_HTTP_CODE_402[] PROGMEM = "Payment Required"; -static const char T_HTTP_CODE_403[] PROGMEM = "Forbidden"; -static const char T_HTTP_CODE_404[] PROGMEM = "Not Found"; -static const char T_HTTP_CODE_405[] PROGMEM = "Method Not Allowed"; -static const char T_HTTP_CODE_406[] PROGMEM = "Not Acceptable"; -static const char T_HTTP_CODE_407[] PROGMEM = "Proxy Authentication Required"; -static const char T_HTTP_CODE_408[] PROGMEM = "Request Time-out"; -static const char T_HTTP_CODE_409[] PROGMEM = "Conflict"; -static const char T_HTTP_CODE_410[] PROGMEM = "Gone"; -static const char T_HTTP_CODE_411[] PROGMEM = "Length Required"; -static const char T_HTTP_CODE_412[] PROGMEM = "Precondition Failed"; -static const char T_HTTP_CODE_413[] PROGMEM = "Request Entity Too Large"; -static const char T_HTTP_CODE_414[] PROGMEM = "Request-URI Too Large"; -static const char T_HTTP_CODE_415[] PROGMEM = "Unsupported Media Type"; -static const char T_HTTP_CODE_416[] PROGMEM = "Requested range not satisfiable"; -static const char T_HTTP_CODE_417[] PROGMEM = "Expectation Failed"; -static const char T_HTTP_CODE_500[] PROGMEM = "Internal Server Error"; -static const char T_HTTP_CODE_501[] PROGMEM = "Not Implemented"; -static const char T_HTTP_CODE_502[] PROGMEM = "Bad Gateway"; -static const char T_HTTP_CODE_503[] PROGMEM = "Service Unavailable"; -static const char T_HTTP_CODE_504[] PROGMEM = "Gateway Time-out"; -static const char T_HTTP_CODE_505[] PROGMEM = "HTTP Version not supported"; -static const char T_HTTP_CODE_ANY[] PROGMEM = "Unknown code"; - -// other -static const char T__opaque[] PROGMEM = "\", opaque=\""; -static const char T_13[] PROGMEM = "13"; -static const char T_asyncesp[] PROGMEM = "asyncesp"; -static const char T_auth_nonce[] PROGMEM = "\", qop=\"auth\", nonce=\""; -static const char T_cnonce[] PROGMEM = "cnonce"; -static const char T_data_[] PROGMEM = "data: "; -static const char T_event_[] PROGMEM = "event: "; -static const char T_filename[] PROGMEM = "filename"; -static const char T_gzip[] PROGMEM = "gzip"; -static const char T_Host[] PROGMEM = "Host"; -static const char T_id__[] PROGMEM = "id: "; -static const char T_name[] PROGMEM = "name"; -static const char T_nc[] PROGMEM = "nc"; -static const char T_nonce[] PROGMEM = "nonce"; -static const char T_opaque[] PROGMEM = "opaque"; -static const char T_qop[] PROGMEM = "qop"; -static const char T_realm[] PROGMEM = "realm"; -static const char T_realm__[] PROGMEM = "realm=\""; -static const char T_response[] PROGMEM = "response"; -static const char T_retry_[] PROGMEM = "retry: "; -static const char T_rn[] PROGMEM = "\r\n"; -static const char T_rnrn[] PROGMEM = "\r\n\r\n"; -static const char T_uri[] PROGMEM = "uri"; -static const char T_username[] PROGMEM = "username"; - -#endif // ESP8622 - -} // namespace asyncsrv {} diff --git a/lib/ESPAsyncWebServer/src/port/SHA1Builder.cpp b/lib/ESPAsyncWebServer/src/port/SHA1Builder.cpp deleted file mode 100644 index 901fb80..0000000 --- a/lib/ESPAsyncWebServer/src/port/SHA1Builder.cpp +++ /dev/null @@ -1,284 +0,0 @@ -/* - * FIPS-180-1 compliant SHA-1 implementation - * - * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved - * SPDX-License-Identifier: Apache-2.0 - * - * Licensed under the Apache License, Version 2.0 (the "License"); you may - * not use this file except in compliance with the License. - * You may obtain a copy of the License at - * - * http://www.apache.org/licenses/LICENSE-2.0 - * - * Unless required by applicable law or agreed to in writing, software - * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT - * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - * See the License for the specific language governing permissions and - * limitations under the License. - * - * This file is part of mbed TLS (https://tls.mbed.org) - * Modified for esp32 by Lucas Saavedra Vaz on 11 Jan 2024 - */ - -#include -#if ESP_IDF_VERSION_MAJOR < 5 - -#include "SHA1Builder.h" - -// 32-bit integer manipulation macros (big endian) - -#ifndef GET_UINT32_BE -#define GET_UINT32_BE(n, b, i) \ - { (n) = ((uint32_t)(b)[(i)] << 24) | ((uint32_t)(b)[(i) + 1] << 16) | ((uint32_t)(b)[(i) + 2] << 8) | ((uint32_t)(b)[(i) + 3]); } -#endif - -#ifndef PUT_UINT32_BE -#define PUT_UINT32_BE(n, b, i) \ - { \ - (b)[(i)] = (uint8_t)((n) >> 24); \ - (b)[(i) + 1] = (uint8_t)((n) >> 16); \ - (b)[(i) + 2] = (uint8_t)((n) >> 8); \ - (b)[(i) + 3] = (uint8_t)((n)); \ - } -#endif - -// Constants - -static const uint8_t sha1_padding[64] = {0x80, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, - 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}; - -// Private methods - -void SHA1Builder::process(const uint8_t *data) { - uint32_t temp, W[16], A, B, C, D, E; - - GET_UINT32_BE(W[0], data, 0); - GET_UINT32_BE(W[1], data, 4); - GET_UINT32_BE(W[2], data, 8); - GET_UINT32_BE(W[3], data, 12); - GET_UINT32_BE(W[4], data, 16); - GET_UINT32_BE(W[5], data, 20); - GET_UINT32_BE(W[6], data, 24); - GET_UINT32_BE(W[7], data, 28); - GET_UINT32_BE(W[8], data, 32); - GET_UINT32_BE(W[9], data, 36); - GET_UINT32_BE(W[10], data, 40); - GET_UINT32_BE(W[11], data, 44); - GET_UINT32_BE(W[12], data, 48); - GET_UINT32_BE(W[13], data, 52); - GET_UINT32_BE(W[14], data, 56); - GET_UINT32_BE(W[15], data, 60); - -#define sha1_S(x, n) ((x << n) | ((x & 0xFFFFFFFF) >> (32 - n))) - -#define sha1_R(t) (temp = W[(t - 3) & 0x0F] ^ W[(t - 8) & 0x0F] ^ W[(t - 14) & 0x0F] ^ W[t & 0x0F], (W[t & 0x0F] = sha1_S(temp, 1))) - -#define sha1_P(a, b, c, d, e, x) \ - { \ - e += sha1_S(a, 5) + sha1_F(b, c, d) + sha1_K + x; \ - b = sha1_S(b, 30); \ - } - - A = state[0]; - B = state[1]; - C = state[2]; - D = state[3]; - E = state[4]; - -#define sha1_F(x, y, z) (z ^ (x & (y ^ z))) -#define sha1_K 0x5A827999 - - sha1_P(A, B, C, D, E, W[0]); - sha1_P(E, A, B, C, D, W[1]); - sha1_P(D, E, A, B, C, W[2]); - sha1_P(C, D, E, A, B, W[3]); - sha1_P(B, C, D, E, A, W[4]); - sha1_P(A, B, C, D, E, W[5]); - sha1_P(E, A, B, C, D, W[6]); - sha1_P(D, E, A, B, C, W[7]); - sha1_P(C, D, E, A, B, W[8]); - sha1_P(B, C, D, E, A, W[9]); - sha1_P(A, B, C, D, E, W[10]); - sha1_P(E, A, B, C, D, W[11]); - sha1_P(D, E, A, B, C, W[12]); - sha1_P(C, D, E, A, B, W[13]); - sha1_P(B, C, D, E, A, W[14]); - sha1_P(A, B, C, D, E, W[15]); - sha1_P(E, A, B, C, D, sha1_R(16)); - sha1_P(D, E, A, B, C, sha1_R(17)); - sha1_P(C, D, E, A, B, sha1_R(18)); - sha1_P(B, C, D, E, A, sha1_R(19)); - -#undef sha1_K -#undef sha1_F - -#define sha1_F(x, y, z) (x ^ y ^ z) -#define sha1_K 0x6ED9EBA1 - - sha1_P(A, B, C, D, E, sha1_R(20)); - sha1_P(E, A, B, C, D, sha1_R(21)); - sha1_P(D, E, A, B, C, sha1_R(22)); - sha1_P(C, D, E, A, B, sha1_R(23)); - sha1_P(B, C, D, E, A, sha1_R(24)); - sha1_P(A, B, C, D, E, sha1_R(25)); - sha1_P(E, A, B, C, D, sha1_R(26)); - sha1_P(D, E, A, B, C, sha1_R(27)); - sha1_P(C, D, E, A, B, sha1_R(28)); - sha1_P(B, C, D, E, A, sha1_R(29)); - sha1_P(A, B, C, D, E, sha1_R(30)); - sha1_P(E, A, B, C, D, sha1_R(31)); - sha1_P(D, E, A, B, C, sha1_R(32)); - sha1_P(C, D, E, A, B, sha1_R(33)); - sha1_P(B, C, D, E, A, sha1_R(34)); - sha1_P(A, B, C, D, E, sha1_R(35)); - sha1_P(E, A, B, C, D, sha1_R(36)); - sha1_P(D, E, A, B, C, sha1_R(37)); - sha1_P(C, D, E, A, B, sha1_R(38)); - sha1_P(B, C, D, E, A, sha1_R(39)); - -#undef sha1_K -#undef sha1_F - -#define sha1_F(x, y, z) ((x & y) | (z & (x | y))) -#define sha1_K 0x8F1BBCDC - - sha1_P(A, B, C, D, E, sha1_R(40)); - sha1_P(E, A, B, C, D, sha1_R(41)); - sha1_P(D, E, A, B, C, sha1_R(42)); - sha1_P(C, D, E, A, B, sha1_R(43)); - sha1_P(B, C, D, E, A, sha1_R(44)); - sha1_P(A, B, C, D, E, sha1_R(45)); - sha1_P(E, A, B, C, D, sha1_R(46)); - sha1_P(D, E, A, B, C, sha1_R(47)); - sha1_P(C, D, E, A, B, sha1_R(48)); - sha1_P(B, C, D, E, A, sha1_R(49)); - sha1_P(A, B, C, D, E, sha1_R(50)); - sha1_P(E, A, B, C, D, sha1_R(51)); - sha1_P(D, E, A, B, C, sha1_R(52)); - sha1_P(C, D, E, A, B, sha1_R(53)); - sha1_P(B, C, D, E, A, sha1_R(54)); - sha1_P(A, B, C, D, E, sha1_R(55)); - sha1_P(E, A, B, C, D, sha1_R(56)); - sha1_P(D, E, A, B, C, sha1_R(57)); - sha1_P(C, D, E, A, B, sha1_R(58)); - sha1_P(B, C, D, E, A, sha1_R(59)); - -#undef sha1_K -#undef sha1_F - -#define sha1_F(x, y, z) (x ^ y ^ z) -#define sha1_K 0xCA62C1D6 - - sha1_P(A, B, C, D, E, sha1_R(60)); - sha1_P(E, A, B, C, D, sha1_R(61)); - sha1_P(D, E, A, B, C, sha1_R(62)); - sha1_P(C, D, E, A, B, sha1_R(63)); - sha1_P(B, C, D, E, A, sha1_R(64)); - sha1_P(A, B, C, D, E, sha1_R(65)); - sha1_P(E, A, B, C, D, sha1_R(66)); - sha1_P(D, E, A, B, C, sha1_R(67)); - sha1_P(C, D, E, A, B, sha1_R(68)); - sha1_P(B, C, D, E, A, sha1_R(69)); - sha1_P(A, B, C, D, E, sha1_R(70)); - sha1_P(E, A, B, C, D, sha1_R(71)); - sha1_P(D, E, A, B, C, sha1_R(72)); - sha1_P(C, D, E, A, B, sha1_R(73)); - sha1_P(B, C, D, E, A, sha1_R(74)); - sha1_P(A, B, C, D, E, sha1_R(75)); - sha1_P(E, A, B, C, D, sha1_R(76)); - sha1_P(D, E, A, B, C, sha1_R(77)); - sha1_P(C, D, E, A, B, sha1_R(78)); - sha1_P(B, C, D, E, A, sha1_R(79)); - -#undef sha1_K -#undef sha1_F - - state[0] += A; - state[1] += B; - state[2] += C; - state[3] += D; - state[4] += E; -} - -// Public methods - -void SHA1Builder::begin(void) { - total[0] = 0; - total[1] = 0; - - state[0] = 0x67452301; - state[1] = 0xEFCDAB89; - state[2] = 0x98BADCFE; - state[3] = 0x10325476; - state[4] = 0xC3D2E1F0; - - memset(buffer, 0x00, sizeof(buffer)); - memset(hash, 0x00, sizeof(hash)); -} - -void SHA1Builder::add(const uint8_t *data, size_t len) { - size_t fill; - uint32_t left; - - if (len == 0) { - return; - } - - left = total[0] & 0x3F; - fill = 64 - left; - - total[0] += (uint32_t)len; - total[0] &= 0xFFFFFFFF; - - if (total[0] < (uint32_t)len) { - total[1]++; - } - - if (left && len >= fill) { - memcpy((void *)(buffer + left), data, fill); - process(buffer); - data += fill; - len -= fill; - left = 0; - } - - while (len >= 64) { - process(data); - data += 64; - len -= 64; - } - - if (len > 0) { - memcpy((void *)(buffer + left), data, len); - } -} - -void SHA1Builder::calculate(void) { - uint32_t last, padn; - uint32_t high, low; - uint8_t msglen[8]; - - high = (total[0] >> 29) | (total[1] << 3); - low = (total[0] << 3); - - PUT_UINT32_BE(high, msglen, 0); - PUT_UINT32_BE(low, msglen, 4); - - last = total[0] & 0x3F; - padn = (last < 56) ? (56 - last) : (120 - last); - - add((uint8_t *)sha1_padding, padn); - add(msglen, 8); - - PUT_UINT32_BE(state[0], hash, 0); - PUT_UINT32_BE(state[1], hash, 4); - PUT_UINT32_BE(state[2], hash, 8); - PUT_UINT32_BE(state[3], hash, 12); - PUT_UINT32_BE(state[4], hash, 16); -} - -void SHA1Builder::getBytes(uint8_t *output) { - memcpy(output, hash, SHA1_HASH_SIZE); -} - -#endif // ESP_IDF_VERSION_MAJOR < 5 diff --git a/lib/ESPAsyncWebServer/src/port/SHA1Builder.h b/lib/ESPAsyncWebServer/src/port/SHA1Builder.h deleted file mode 100644 index da9a77a..0000000 --- a/lib/ESPAsyncWebServer/src/port/SHA1Builder.h +++ /dev/null @@ -1,39 +0,0 @@ -// Copyright 2024 Espressif Systems (Shanghai) PTE LTD -// -// Licensed under the Apache License, Version 2.0 (the "License"); -// you may not use this file except in compliance with the License. -// You may obtain a copy of the License at -// -// http://www.apache.org/licenses/LICENSE-2.0 -// -// Unless required by applicable law or agreed to in writing, software -// distributed under the License is distributed on an "AS IS" BASIS, -// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. -// See the License for the specific language governing permissions and -// limitations under the License. - -#ifndef SHA1Builder_h -#define SHA1Builder_h - -#include -#include - -#define SHA1_HASH_SIZE 20 - -class SHA1Builder { - private: - uint32_t total[2]; /* number of bytes processed */ - uint32_t state[5]; /* intermediate digest state */ - unsigned char buffer[64]; /* data block being processed */ - uint8_t hash[SHA1_HASH_SIZE]; /* SHA-1 result */ - - void process(const uint8_t* data); - - public: - void begin(); - void add(const uint8_t* data, size_t len); - void calculate(); - void getBytes(uint8_t* output); -}; - -#endif // SHA1Builder_h diff --git a/lib/PsychicHttp/CHANGELOG.md b/lib/PsychicHttp/CHANGELOG.md new file mode 100644 index 0000000..ca99a11 --- /dev/null +++ b/lib/PsychicHttp/CHANGELOG.md @@ -0,0 +1,34 @@ +# v1.2.1 + +* Fix bug with missing include preventing the HTTPS server from compiling. + +# v1.2 + +* Added TemplatePrinter from https://github.com/Chris--A/PsychicHttp/tree/templatePrint +* Support using as ESP IDF component +* Optional using https server in ESP IDF +* Fixed bug with headers +* Add ESP IDF example + CI script +* Added Arduino Captive Portal example and OTAUpdate from @06GitHub +* HTTPS fix for ESP-IDF v5.0.2+ from @06GitHub +* lots of bugfixes from @mathieucarbou + +Thanks to @Chris--A, @06GitHub, and @dzungpv for your contributions. + +# v1.1 + +* Changed the internal structure to support request handlers on endpoints and generic requests that do not match an endpoint + * websockets, uploads, etc should now create an appropriate handler and attach to an endpoint with the server.on() syntax +* Added PsychicClient to abstract away some of the internals of ESP-IDF sockets + add convenience + * onOpen and onClose callbacks have changed as a result +* Added support for EventSource / SSE +* Added support for multipart file uploads +* changed getParam() to return a PsychicWebParameter in line with ESPAsyncWebserver +* Renamed various classes / files: + * PsychicHttpFileResponse -> PsychicFileResponse + * PsychicHttpServerEndpoint -> PsychicEndpoint + * PsychicHttpServerRequest -> PsychicRequest + * PsychicHttpServerResponse -> PsychicResponse + * PsychicHttpWebsocket.h -> PsychicWebSocket.h + * Websocket => WebSocket +* Quite a few bugfixes from the community. Thank you @glennsky, @gb88, @KastanEr, @kstam, and @zekageri \ No newline at end of file diff --git a/lib/ESPAsyncWebServer/CMakeLists.txt b/lib/PsychicHttp/CMakeLists.txt similarity index 82% rename from lib/ESPAsyncWebServer/CMakeLists.txt rename to lib/PsychicHttp/CMakeLists.txt index 64292ec..4f76477 100644 --- a/lib/ESPAsyncWebServer/CMakeLists.txt +++ b/lib/PsychicHttp/CMakeLists.txt @@ -8,7 +8,9 @@ set(COMPONENT_ADD_INCLUDEDIRS set(COMPONENT_REQUIRES "arduino-esp32" - "AsyncTCP" + "esp_https_server" + "ArduinoJson" + "UrlEncode" ) register_component() diff --git a/lib/PsychicHttp/LICENSE b/lib/PsychicHttp/LICENSE new file mode 100644 index 0000000..8e797d9 --- /dev/null +++ b/lib/PsychicHttp/LICENSE @@ -0,0 +1,7 @@ +Copyright (c) 2024 Jeremy Poulter, Zachary Smith, and Mathieu Carbou + +Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. \ No newline at end of file diff --git a/lib/PsychicHttp/README.md b/lib/PsychicHttp/README.md new file mode 100644 index 0000000..5c4289e --- /dev/null +++ b/lib/PsychicHttp/README.md @@ -0,0 +1,826 @@ +# PsychicHttp - HTTP on your ESP 🧙🔮 + +PsychicHttp is a webserver library for ESP32 + Arduino framework which uses the [ESP-IDF HTTP Server](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/protocols/esp_http_server.html) library under the hood. It is written in a similar style to the [Arduino WebServer](https://github.com/espressif/arduino-esp32/tree/master/libraries/WebServer), [ESPAsyncWebServer](https://github.com/me-no-dev/ESPAsyncWebServer), and [ArduinoMongoose](https://github.com/jeremypoulter/ArduinoMongoose) libraries to make writing code simple and porting from those other libraries straightforward. + +# Features + +* Asynchronous approach (server runs in its own FreeRTOS thread) +* Handles all HTTP methods with lots of convenience functions: + * GET/POST parameters + * get/set headers + * get/set cookies + * basic key/value session data storage + * authentication (basic and digest mode) +* HTTPS / SSL support +* Static fileserving (SPIFFS, LittleFS, etc.) +* Chunked response serving for large files +* File uploads (Basic + Multipart) +* Websocket support with onOpen, onFrame, and onClose callbacks +* EventSource / SSE support with onOpen, and onClose callbacks +* Request filters, including Client vs AP mode (ON_STA_FILTER / ON_AP_FILTER) +* TemplatePrinter class for dynamic variables at runtime + +## Differences from ESPAsyncWebserver + +* No templating system (anyone actually use this?) +* No url rewriting (but you can use request->redirect) + +# Usage + +## Installation + +### Platformio + +[PlatformIO](http://platformio.org) is an open source ecosystem for IoT development. + + Add "PsychicHttp" to project using [Project Configuration File `platformio.ini`](http://docs.platformio.org/page/projectconf.html) and [lib_deps](http://docs.platformio.org/page/projectconf/section_env_library.html#lib-deps) option: + +```ini +[env:myboard] +platform = espressif... +board = ... +framework = arduino + +# using the latest stable version +lib_deps = hoeken/PsychicHttp + +# or using GIT Url (the latest development version) +lib_deps = https://github.com/hoeken/PsychicHttp +``` + +### Installation - Arduino + +Open *Tools -> Manage Libraries...* and search for PsychicHttp. + +# Principles of Operation + +## Things to Note + +* PsychicHttp is a fully asynchronous server and as such does not run on the loop thread. +* You should not use yield or delay or any function that uses them inside the callbacks. +* The server is smart enough to know when to close the connection and free resources. +* You can not send more than one response to a single request. + +## PsychicHttp + +* Listens for connections. +* Wraps the incoming request into PsychicRequest. +* Keeps track of clients + calls optional callbacks on client open and close. +* Find the appropriate handler (if any) for a request and pass it on. + +## Request Life Cycle + +* TCP connection is received by the server. +* HTTP request is wrapped inside ```PsychicRequest``` object + TCP Connection wrapped inside PsychicConnection object. +* When the request head is received, the server goes through all ```PsychicEndpoints``` and finds one that matches the url + method. + * ```handler->filter()``` and ```handler->canHandle()``` are called on the handler to verify the handler should process the request. + * ```handler->needsAuthentication()``` is called and sends an authorization response if required. + * ```handler->handleRequest()``` is called to actually process the HTTP request. +* If the handler cannot process the request, the server will loop through any global handlers and call that handler if it passes filter(), canHandle(), and needsAuthentication(). +* If no global handlers are called, the server.defaultEndpoint handler will be called. +* Each handler is responsible for processing the request and sending a response. +* When the response is sent, the client is closed and freed from the memory. + * Unless its a special handler like websockets or eventsource. + +![Flowchart of Request Lifecycle](/assets/request-flow.svg) + +### Handlers + +* ```PsychicHandler``` is used for processing and responding to specific HTTP requests. +* ```PsychicHandler``` instances can be attached to any endpoint or as global handlers. +* Setting a ```Filter``` to the ```PsychicHandler``` controls when to apply the handler, decision can be based on + request method, url, request host/port/target host, the request client's localIP or remoteIP. +* Two filter callbacks are provided: ```ON_AP_FILTER``` to execute the rewrite when request is made to the AP interface, + ```ON_STA_FILTER``` to execute the rewrite when request is made to the STA interface. +* The ```canHandle``` method is used for handler specific control on whether the requests can be handled. Decision can be based on request method, request url, request host/port/target host. +* Depending on how the handler is implemented, it may provide callbacks for adding your own custom processing code to the handler. +* Global ```Handlers``` are evaluated in the order they are attached to the server. The ```canHandle``` is called only + if the ```Filter``` that was set to the ```Handler``` return true. +* The first global ```Handler``` that can handle the request is selected, no further processing of handlers is called. + +![Flowchart of Request Lifecycle](/assets/handler-callbacks.svg) + +### Responses and how do they work + +* The ```PsychicResponse``` objects are used to send the response data back to the client. +* Typically the response should be fully generated and sent from the callback. +* It may be possible to generate the response outside the callback, but it will be difficult. + * The exceptions are websockets + eventsource where the response is sent, but the connection is maintained and new data can be sent/received outside the handler. + +# Porting From ESPAsyncWebserver + +If you have existing code using ESPAsyncWebserver, you will feel right at home with PsychicHttp. Even if internally it is much different, the external interface is very similar. Some things are mostly cosmetic, like different class names and callback definitions. A few things might require a bit more in-depth approach. If you're porting your code and run into issues that aren't covered here, please post and issue. + +## Globals Stuff + +* Change your #include to ```#include ``` +* Change your server instance: ```PsychicHttpServer server;``` +* Define websocket handler if you have one: ```PsychicWebSocketHandler websocketHandler;``` +* Define eventsource if you have one: ```PsychicEventSource eventSource;``` + +## setup() Stuff + +* no more server.begin(), call server.listen(80), before you add your handlers +* server has a configurable limit on .on() endpoints. change it with ```server.config.max_uri_handlers = 20;``` as needed. +* check your callback function definitions: + * AsyncWebServerRequest -> PsychicRequest + * no more onBody() event + * for small bodies (server.maxRequestBodySize, default 16k) it will be automatically loaded and accessed by request->body() + * for large bodies, use an upload handler and onUpload() + * websocket callbacks are much different (and simpler!) + * websocket / eventsource handlers get attached to url in server.on("/url", &handler) instead of passing url to handler constructor. + * eventsource callbacks are onOpen and onClose now. +* HTTP_ANY is not supported by ESP-IDF, so we can't use it either. +* NO server.onFileUpload(onUpload); (you could attach an UploadHandler to the default endpoint i guess?) +* NO server.onRequestBody(onBody); (same) + +## Requests / Responses + +* request->send is now request->reply() +* if you create a response, call response->send() directly, not request->send(reply) +* request->headers() is not supported by ESP-IDF, you have to just check for the header you need. +* No AsyncCallbackJsonWebHandler (for now... can add if needed) +* No request->beginResponse(). Instanciate a PsychicResponse instead: ```PsychicResponse response(request);``` +* No PROGMEM suppport (its not relevant to ESP32: https://esp32.com/viewtopic.php?t=20595) +* No Stream response support just yet + +# Usage + +## Create the Server + +Here is an example of the typical server setup: + +```cpp +#include +PsychicHttpServer server; + +void setup() +{ + //optional low level setup server config stuff here. + //server.config is an ESP-IDF httpd_config struct + //see: https://docs.espressif.com/projects/esp-idf/en/v4.4.6/esp32/api-reference/protocols/esp_http_server.html#_CPPv412httpd_config + //increase maximum number of uri endpoint handlers (.on() calls) + server.config.max_uri_handlers = 20; + + //connect to wifi + + //start the server listening on port 80 (standard HTTP port) + server.listen(80); + + //call server methods to attach endpoints and handlers + server.on(...); + server.serveStatic(...); + server.attachHandler(...); +} +``` + +## Add Handlers + +One major difference from ESPAsyncWebserver is that handlers can be attached to a specific url (endpoint) or as a global handler. The reason for this, is that attaching to a specific URL is more efficient and makes for cleaner code. + +### Endpoint Handlers + +An endpoint is basically just the URL path (eg. /path/to/file) without any query string. The ```server.on(...)``` function is a convenience function for creating endpoints and attaching a handler to them. There are two main styles: attaching a basic ```WebRequest``` handler and attaching an external handler. + +```cpp +//creates a basic PsychicWebHandler that calls the request_callback callback +server.on("/url", HTTP_GET, request_callback); + +//same as above, but defaults to HTTP_GET +server.on("/url", request_callback); + +//attaches a websocket handler to /ws +PsychicWebSocketHandler websocketHandler; +server.on("/ws", &websocketHandler); +``` + +The ```server.on(...)``` returns a pointer to the endpoint, which can be used to call various functions like ```setHandler()```, ```setFilter()```, and ```setAuthentication()```. + +```cpp +//respond to /url only from requests to the AP +server.on("/url", HTTP_GET, request_callback)->setFilter(ON_AP_FILTER); + +//require authentication on /url +server.on("/url", HTTP_GET, request_callback)->setAuthentication("user", "pass"); + +//attach websocket handler to /ws +PsychicWebSocketHandler websocketHandler; +server.on("/ws")->attachHandler(&websocketHandler); +``` + +### Basic Requests + +The ```PsychicWebHandler``` class is for handling standard web requests. It provides a single callback: ```onRequest()```. This callback is called when the handler receives a valid HTTP request. + +One major difference from ESPAsyncWebserver is that this callback needs to return an esp_err_t variable to let the server know the result of processing the request. The ```response->reply()``` and ```request->send()``` functions will return this. It is a good habit to return the result of these functions as sending the response will close the connection. + +The function definition for the onRequest callback is: + +```cpp +esp_err_t function_name(PsychicRequest *request); +``` + +Here is a simple example that sends back the client's IP on the URL /ip + +```cpp +server.on("/ip", [](PsychicRequest *request) +{ + String output = "Your IP is: " + request->client()->remoteIP().toString(); + return request->reply(output.c_str()); +}); +``` + +### Uploads + +The ```PsychicUploadHandler``` class is for handling uploads, both large POST bodies and multipart encoded forms. It provides two callbacks: ```onUpload()``` and ```onRequest()```. + +```onUpload(...)``` is called when there is new data. This function may be called multiple times so that you can process the data in chunks. The function definition for the onUpload callback is: + +```cpp +esp_err_t function_name(PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool final); +``` + +* request is a pointer to the Request object +* filename is the name of the uploaded file +* index is the overall byte position of the current data +* data is a pointer to the data buffer +* len is the length of the data buffer +* final is a flag to tell if its the last chunk of data + +```onRequest(...)``` is called after the successful handling of the upload. Its definition and usage is the same as the basic request example as above. + +#### Basic Upload (file is the entire POST body) + +It's worth noting that there is no standard way of passing in a filename for this method, so the handler attempts to guess the filename with the following methods: + +* Checking the Content-Disposition header +* Checking the _filename query parameter (eg. /upload?filename=filename.txt becomes filename.txt) +* Checking the url and taking the last part as filename (eg. /upload/filename.txt becomes filename.txt). You must set a wildcard url for this to work as in the example below. + +```cpp +//handle a very basic upload as post body + PsychicUploadHandler *uploadHandler = new PsychicUploadHandler(); + uploadHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + Serial.printf("Writing %d/%d bytes to: %s\n", (int)index+(int)len, request->contentLength(), path.c_str()); + + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + uploadHandler->onRequest([](PsychicRequest *request) + { + String url = "/" + request->getFilename(); + String output = "" + url + ""; + + return request->reply(output.c_str()); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + server.on("/upload/*", HTTP_POST, uploadHandler); +``` + +#### Multipart Upload + +Very similar to the basic upload, with 2 key differences: + +* multipart requests don't know the total size of the file until after it has been fully processed. You can get a rough idea with request->contentLength(), but that is the length of the entire multipart encoded request. +* you can access form variables, including multipart file infor (name + size) in the onRequest handler using request->getParam() + +```cpp + //a little bit more complicated multipart form + PsychicUploadHandler *multipartHandler = new PsychicUploadHandler(); + multipartHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + //some progress over serial. + Serial.printf("Writing %d bytes to: %s\n", (int)len, path.c_str()); + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + multipartHandler->onRequest([](PsychicRequest *request) + { + PsychicWebParameter *file = request->getParam("file_upload"); + + String url = "/" + file->value(); + String output; + + output += "" + url + "
\n"; + output += "Bytes: " + String(file->size()) + "
\n"; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + }); + + //upload to /multipart url + server.on("/multipart", HTTP_POST, multipartHandler); +``` + +### Static File Serving + +The ```PsychicStaticFileHandler``` is a special handler that does not provide any callbacks. It is used to serve a file or files from a specific directory in a filesystem to a directory on the webserver. The syntax is exactly the same as ESPAsyncWebserver. Anything that is derived from the ```FS``` class should work (eg. SPIFFS, LittleFS, SD, etc) + +A couple important notes: + +* If it finds a file with an extra .gz extension, it will serve it as gzip encoded (eg: /targetfile.ext -> {targetfile.ext}.gz) +* If the file is larger than FILE_CHUNK_SIZE (default 8kb) then it will send it as a chunked response. +* It will detect most basic filetypes and automatically set the appropriate Content-Type + +The ```server.serveStatic()``` function handles creating the handler and assigning it to the server: + +```cpp +//serve static files from LittleFS/www on / only to clients on same wifi network +//this is where our /index.html file lives +server.serveStatic("/", LittleFS, "/www/")->setFilter(ON_STA_FILTER); + +//serve static files from LittleFS/www-ap on / only to clients on SoftAP +//this is where our /index.html file lives +server.serveStatic("/", LittleFS, "/www-ap/")->setFilter(ON_AP_FILTER); + +//serve static files from LittleFS/img on /img +//it's more efficient to serve everything from a single www directory, but this is also possible. +server.serveStatic("/img", LittleFS, "/img/"); + +//you can also serve single files +server.serveStatic("/myfile.txt", LittleFS, "/custom.txt"); +``` + +You could also theoretically use the file response directly: + +```cpp +server.on("/ip", [](PsychicRequest *request) +{ + String filename = "/path/to/file"; + PsychicFileResponse response(request, LittleFS, filename); + + return response.send(); +}); +PsychicFileResponse(PsychicRequest *request, FS &fs, const String& path) +``` + +### Websockets + +The ```PsychicWebSocketHandler``` class is for handling WebSocket connections. It provides 3 callbacks: + +```onOpen(...)``` is called when a new WebSocket client connects. +```onFrame(...)``` is called when a new WebSocket frame has arrived. +```onClose(...)``` is called when a new WebSocket client disconnects. + +Here are the callback definitions: + +```cpp +void open_function(PsychicWebSocketClient *client); +esp_err_t frame_function(PsychicWebSocketRequest *request, httpd_ws_frame *frame); +void close_function(PsychicWebSocketClient *client); +``` + +WebSockets were the main reason for starting PsychicHttp, so they are well tested. They are also much simplified from the ESPAsyncWebserver style. You do not need to worry about error handling, partial frame assembly, PONG messages, etc. The onFrame() function is called when a complete frame has been received, and can handle frames up to the entire available heap size. + +Here is a basic example of using WebSockets: + +```cpp + //create our handler... note this should be located as a global or somewhere it wont go out of scope and be destroyed. + PsychicWebSocketHandler websocketHandler(); + + websocketHandler.onOpen([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + client->sendMessage("Hello!"); + }); + + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) { + Serial.printf("[socket] #%d sent: %s\n", request->client()->socket(), (char *)frame->payload); + return request->reply(frame); + }); + + websocketHandler.onClose([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + + //attach the handler to /ws. You can then connect to ws://ip.address/ws + server.on("/ws", &websocketHandler); +``` + +The onFrame() callback has 2 parameters: + +* ```PsychicWebSocketRequest *request``` a special request with helper functions for replying in websocket format. +* ```httpd_ws_frame *frame``` ESP-IDF websocket struct. The important struct members we care about are: + * ```uint8_t *payload; /*!< Pre-allocated data buffer */``` + * ```size_t len; /*!< Length of the WebSocket data */``` + +For sending data on the websocket connection, there are 3 methods: + +* ```request->reply()``` - only available in the onFrame() callback context. +* ```webSocketHandler.sendAll()``` - can be used anywhere to send websocket messages to all connected clients. +* ```client->send()``` - can be used anywhere* to send a websocket message to a specific client + +All of the above functions either accept simple ```char *``` string of you can construct your own httpd_ws_frame. + +*Special Note:* Do not hold on to the ```PsychicWebSocketClient``` for sending messages to clients outside the callbacks. That pointer is destroyed when a client disconnects. Instead, store the ```int client->socket()```. Then when you want to send a message, use this code: + +```cpp +//make sure our client is still connected. +PsychicWebSocketClient *client = websocketHandler.getClient(socket); +if (client != NULL) + client->send("Your Message") +``` + +### EventSource / SSE + +The ```PsychicEventSource``` class is for handling EventSource / SSE connections. It provides 2 callbacks: + +```onOpen(...)``` is called when a new EventSource client connects. +```onClose(...)``` is called when a new EventSource client disconnects. + +Here are the callback definitions: + +```cpp +void open_function(PsychicEventSourceClient *client); +void close_function(PsychicEventSourceClient *client); +``` + +Here is a basic example of using PsychicEventSource: + +```cpp + //create our handler... note this should be located as a global or somewhere it wont go out of scope and be destroyed. + PsychicEventSource eventSource; + + eventSource.onOpen([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + client->send("Hello user!", NULL, millis(), 1000); + }); + + eventSource.onClose([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + + //attach the handler to /events + server.on("/events", &eventSource); +``` + +For sending data on the EventSource connection, there are 2 methods: + +* ```eventSource.send()``` - can be used anywhere to send events to all connected clients. +* ```client->send()``` - can be used anywhere* to send events to a specific client + +All of the above functions accept a simple ```char *``` message, and optionally: ```char *``` event name, id, and reconnect time. + +*Special Note:* Do not hold on to the ```PsychicEventSourceClient``` for sending messages to clients outside the callbacks. That pointer is destroyed when a client disconnects. Instead, store the ```int client->socket()```. Then when you want to send a message, use this code: + +```cpp +//make sure our client is still connected. +PsychicEventSourceClient *client = eventSource.getClient(socket); +if (client != NULL) + client->send("Your Event") +``` + +### HTTPS / SSL + +PsychicHttp supports HTTPS / SSL out of the box, however there are some limitations (see performance below). Enabling it also increases the code size by about 100kb. To use HTTPS, you need to modify your setup like so: + +```cpp +#include +#include +PsychicHttpsServer server; +server.listen(443, server_cert, server_key); +``` + +```server_cert``` and ```server_key``` are both ```const char *``` parameters which contain the server certificate and private key, respectively. + +To generate your own key and self signed certificate, you can use the command below: + +``` +openssl req -x509 -newkey rsa:4096 -nodes -keyout server.key -out server.crt -sha256 -days 365 +``` + +Including the ```PsychicHttpsServer.h``` also defines ```PSY_ENABLE_SSL``` which you can use in your code to allow enabling / disabling calls in your code based on if the HTTPS server is available: + +```cpp +//our main server object +#ifdef PSY_ENABLE_SSL + PsychicHttpsServer server; +#else + PsychicHttpServer server; +#endif +``` + +Last, but not least, you can create a separate HTTP server on port 80 that redirects all requests to the HTTPS server: + +```cpp +//this creates a 2nd server listening on port 80 and redirects all requests HTTPS +PsychicHttpServer *redirectServer = new PsychicHttpServer(); +redirectServer->config.ctrl_port = 20420; // just a random port different from the default one +redirectServer->listen(80); +redirectServer->onNotFound([](PsychicRequest *request) { + String url = "https://" + request->host() + request->url(); + return request->redirect(url.c_str()); +}); +``` + +# TemplatePrinter + +**This is not specific to PsychicHttp, and it works with any `Print` object. You could for example, template data out to `File`, `Serial`, etc...**. + +The template engine is a `Print` interface and can be printed to directly, however, if you are just templating a few short strings, I'd probably just use `response.printf()` instead. **Its benefit will be seen when templating large inputs such as files.** + +One benefit may be **templating a **JSON** file avoiding the need to use ArduinoJson.** + +Before closing the underlying `Print`/`Stream` that this writes to, it must be flushed as small amounts of data can be buffered. A convenience method to take care of this is shows in `example 3`. + +The header file is not currently added to `PsychicHttp.h` and users will have to add it manually: + +```C++ +#include +``` + +## Template parameter definition: + +- Must start and end with a preset delimiter, the default is `%` +- Can only contain `a-z`, `A-Z`, `0-9`, and `_` +- Maximum length of 63 characters (buffer is 64 including `null`). +- A parameter must not be zero length (not including delimiters). +- Spaces or any other character do not match as a parameter, and will be output as is. +- Valid examples + - `%MY_PARAM%` + - `%SOME1%` +- **Invalid** examples + - `%MY PARAM%` + - `%SOME1 %` + - `%UNFINISHED` + - `%%` + +## Template processing +A function or lambda is used to receive the parameter replacement. + +```C++ +bool templateHandler(Print &output, const char *param){ + //... +} + +[](Print &output, const char *param){ + //... +} +``` + +Parameters: +- `Print &output` - the underlying `Print`, print the results of templating to this. +- `const char *param` - a string containing the current parameter. + +The handler must return a `bool`. +- `true`: the parameter was handled, continue as normal. +- `false`: the input detected as a parameter is not, print literal. + +See output in **example 1** regarding the effects of returning `true` or `false`. + +## Template input handler +This is not needed unless using the static convenience function `TemplatePrinter::start()`. See **example 3**. + +```C++ +bool inputHandler(TemplatePrinter &printer){ + //... +} + +[](TemplatePrinter &printer){ + //... +} +``` + +Parameters: +- `TemplatePrinter &printer` - The template engine, print your template text to this for processing. + + +## Example 1 - Simple use with `PsychicStreamResponse`: +This example highlights its most basic usage. + +```C++ + +// Function to handle parameter requests. + +bool templateHandler(Print &output, const char *param){ + + if(strcmp(param, "FREE_HEAP") == 0){ + output.print((double)ESP.getFreeHeap() / 1024.0, 2); + + }else if(strcmp(param, "MIN_FREE_HEAP") == 0){ + output.print((double)ESP.getMinFreeHeap() / 1024.0, 2); + + }else if(strcmp(param, "MAX_ALLOC_HEAP") == 0){ + output.print((double)ESP.getMaxAllocHeap() / 1024.0, 2); + + }else if(strcmp(param, "HEAP_SIZE") == 0){ + output.print((double)ESP.getHeapSize() / 1024.0, 2); + }else{ + return false; + } + output.print("Kb"); + return true; +} + +// Example serving a request +server.on("/template", [](PsychicRequest *request) { + PsychicStreamResponse response(request, "text/plain"); + + response.beginSend(); + + TemplatePrinter printer(response, templateHandler); + + printer.println("My ESP has %FREE_HEAP% left. Its lifetime minimum heap is %MIN_FREE_HEAP%."); + printer.println("The maximum allocation size is %MAX_ALLOC_HEAP%, and its total size is %HEAP_SIZE%."); + printer.println("This is an unhandled parameter: %UNHANDLED_PARAM% and this is an invalid param %INVALID PARAM%."); + printer.println("This line finished with %UNFIN"); + printer.flush(); + + return response.endSend(); +}); +``` + +The output for example looks like: +``` +My ESP has 170.92Kb left. Its lifetime minimum heap is 169.83Kb. +The maximum allocation size is 107.99Kb, and its total size is 284.19Kb. +This is an unhandled parameter: %UNHANDLED_PARAM% and this is an invalid param %INVALID PARAM%. +This line finished with %UNFIN +``` + +## Example 2 - Templating a file + +```C++ +server.on("/home", [](PsychicRequest *request) { + PsychicStreamResponse response(request, "text/html"); + File file = SD.open("/www/index.html"); + + response.beginSend(); + + TemplatePrinter printer(response, templateHandler); + + printer.copyFrom(file); + printer.flush(); + file.close(); + + return response.endSend(); +}); +``` + +## Example 3 - Using the `TemplatePrinter::start` method. +This static method allows an RAII approach, allowing you to template a stream, etc... without needing a `flush()`. The function call is laid out as: + +```C++ +TemplatePrinter::start(host_stream, template_handler, input_handler); +``` + +\*these examples use the `templateHandler` function defined in example 1. + +### Serve a file like example 2 +```C++ +server.on("/home", [](PsychicRequest *request) { + PsychicStreamResponse response(request, "text/html"); + File file = SD.open("/www/index.html"); + + response.beginSend(); + TemplatePrinter::start(response, templateHandler, [&file](TemplatePrinter &printer){ + printer.copyFrom(file); + }); + file.close(); + + return response.endSend(); +}); +``` + +### Template a string like example 1 +```C++ +server.on("/template2", [](PsychicRequest *request) { + + PsychicStreamResponse response(request, "text/plain"); + + response.beginSend(); + + TemplatePrinter::start(response, templateHandler, [](TemplatePrinter &printer){ + printer.println("My ESP has %FREE_HEAP% left. Its lifetime minimum heap is %MIN_FREE_HEAP%."); + printer.println("The maximum allocation size is %MAX_ALLOC_HEAP%, and its total size is %HEAP_SIZE%."); + printer.println("This is an unhandled parameter: %UNHANDLED_PARAM% and this is an invalid param %INVALID PARAM%."); + }); + + return response.endSend(); +}); +``` + +# Performance + +In order to really see the differences between libraries, I created some basic benchmark firmwares for PsychicHttp, ESPAsyncWebserver, and ArduinoMongoose. I then ran the loadtest-http.sh and loadtest-websocket.sh scripts against each firmware to get some real numbers on the performance of each server library. All of the code and results are available in the /benchmark folder. If you want to see the collated data and graphs, there is a [LibreOffice spreadsheet](/benchmark/comparison.ods). + +![Performance graph](/benchmark/performance.png) +![Latency graph](/benchmark/latency.png) + +## HTTPS / SSL + +Yes, PsychicHttp supports SSL out of the box, but there are a few caveats: + +* Due to memory limitations, it can only handle 2 connections at a time. Each SSL connection takes about 45k ram, and a blank PsychicHttp sketch has about 150k ram free. +* Speed and latency are still pretty good (see graph above) but the SSH handshake seems to take 1500ms. With websockets or browser its not an issue since the connection is kept alive, but if you are loading requests in another way it will be a bit slow +* Unless you want to expose your ESP to the internet, you are limited to self signed keys and the annoying browser security warnings that come with them. + +## Analysis + +The results clearly show some of the reasons for writing PsychicHttp: ESPAsyncWebserver crashes under heavy load on each test, across the board in a 60s test. That means in normal usage, you're just rolling the dice with how long it will go until it crashes. Every other number is moot, IMHO. + +ArduinoMongoose doesn't crash under heavy load, but it does bog down with extremely high latency (15s) for web requests and appears to not even respond at the highest loadings as the loadtest script crashes instead. The code itself doesnt crash, so bonus points there. After the high load, it does go back to serving normally. One area ArduinoMongoose does shine, is in websockets where its performance is almost 2x the performance of PsychicHttp. Both in requests per second and latency. Clearly an area of improvement for PsychicHttp. + +PsychicHttp has good performance across the board. No crashes and continously responds during each test. It is a clear winner in requests per second when serving files from memory, dynamic JSON, and has consistent performance when serving files from LittleFS. The only real downside is the lower performance of the websockets with a single connection handling 38rps, and maxing out at 120rps across multiple connections. + +## Takeaways + +With all due respect to @me-no-dev who has done some amazing work in the open source community, I cannot recommend anyone use the ESPAsyncWebserver for anything other than simple projects that don't need to be reliable. Even then, PsychicHttp has taken the arcane api of the ESP-IDF web server library and made it nice and friendly to use with a very similar API to ESPAsyncWebserver. Also, ESPAsyncWebserver is more or less abandoned, with 150 open issues, 77 pending pull requests, and the last commit in over 2 years. + +ArduinoMongoose is a good alternative, although the latency issues when it gets fully loaded can be very annoying. I believe it is also cross platform to other microcontrollers as well, but I haven't tested that. The other issue here is that it is based on an old version of a modified Mongoose library that will be difficult to update as it is a major revision behind and several security updates behind as well. Big thanks to @jeremypoulter though as PsychicHttp is a fork of ArduinoMongoose so it's built on strong bones. + +# Roadmap + +## v1.2: ESPAsyncWebserver Parity + + +Change: +Modify the request handling to bring initail url matching and filtering into PsychicHttpServer itself. + +Benefits: +* Fix a bug with filter() where endpoint is matched, but filter fails and it doesn't continue matching further endpoints (checks are in different codebases) +* HTTP_ANY support +* unlimited endpoints + * we would use a List to store endpoints + * dont have to pre-declare config.max_uri_handlers; +* much more flexibility for future + +Issues +* it would log a warning on every request as if its a 404. (httpd_uri.c:298) +* req->user_ctx is not passed in. (httpd_uri.c:309) + * but... user_ctx is something we could store in the psychicendpoint data + * Websocket support assumes an endpoint with matching url / method (httpd_uri.c:312) + * we could copy and bring this code into our own internal request processor + * would need to manually maintain more code (~100 lines?) and be more prone to esp-idf http_server updates causing problems. + +How to implement +* set config.max_uri_handlers = 1; +* possibly do not register any uri_handlers (looks like it would be fastest way to exit httpd_find_uri_handler (httpd_uri.c:94)) + * looks like 404 is set by default, so should work. +* modify PsychicEndpoint to store the stuff we would pass to http_server +* create a new function handleRequest() before PsychicHttpServer::defaultNotFoundHandler to process incoming requests. + * bring in code from PsychicHttpServer::notFoundHandler + * add new code to loop over endpoints to call match and filter +* bring code from esp-idf library + +* templating system +* regex url matching +* rewrite urls? +* What else are we missing? + + +## Longterm Wants + +* investigate websocket performance gap +* support for esp-idf framework +* support for arduino 3.0 framework +* Enable worker based multithreading with esp-idf v5.x +* 100-continue support? + +If anyone wants to take a crack at implementing any of the above features I am more than happy to accept pull requests. diff --git a/lib/PsychicHttp/RELEASE.md b/lib/PsychicHttp/RELEASE.md new file mode 100644 index 0000000..98db528 --- /dev/null +++ b/lib/PsychicHttp/RELEASE.md @@ -0,0 +1,6 @@ +* Update CHANGELOG +* Bump version in library.json +* Bump version in library.properties +* Make new release + tag + * this will get pulled in automatically by Arduino Library Indexer +* run ```pio pkg publish``` to publish to Platform.io \ No newline at end of file diff --git a/lib/PsychicHttp/assets/handler-callbacks.svg b/lib/PsychicHttp/assets/handler-callbacks.svg new file mode 100644 index 0000000..62fcbdf --- /dev/null +++ b/lib/PsychicHttp/assets/handler-callbacks.svg @@ -0,0 +1,4 @@ + + + +
WebHandler
WebHandler
Handlers with Callbacks
Handlers with Callbacks
onRequest()
onRequest()
WebSocketHandler
WebSocketHandler
onOpen()
onOpen()
onFrame()
onFrame()
onClose()
onClose()
UploadHandler
UploadHandler
onRequest()
onRequest()
onUpload()
onUpload()
EventSource
EventSource
onOpen()
onOpen()
onClose()
onClose()Text is not SVG - cannot display \ No newline at end of file diff --git a/lib/PsychicHttp/assets/request-flow.svg b/lib/PsychicHttp/assets/request-flow.svg new file mode 100644 index 0000000..999fb00 --- /dev/null +++ b/lib/PsychicHttp/assets/request-flow.svg @@ -0,0 +1,4 @@ + + + +
HTTP Request
HTTP Request
Yes
Yes
No
No
Endpoint Matched?
Endpoint Matche...
PsychicHandler
PsychicHandler
Yes
Yes
Matching
 Handler?
Matching...
Default Endpoint
Default Endpoint
No
No
Yes
Yes
New Connection?
New Connection?
server.onOpen Callback
server.onOpen Callba...
Connection Closed?
Connection Closed?
handler.onClose
server.onClose
Callbacks
handler.onClose...
Finish
Finish
handler.onOpen + specific callbacks
handler.onOpen + spe...
filter() ?
filter() ?
canHandle() ?
canHandle() ?
authenticate() ?
authenticate() ?
requestAuthentication()
requestAuthentication()
handleRequest()
handleRequest()
response.send()
response.send()
PsychicHttp Request Flow
PsychicHttp Request FlowText is not SVG - cannot display \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/arduinomongoose/.gitignore b/lib/PsychicHttp/benchmark/arduinomongoose/.gitignore new file mode 100644 index 0000000..9e5f911 --- /dev/null +++ b/lib/PsychicHttp/benchmark/arduinomongoose/.gitignore @@ -0,0 +1,6 @@ +.pio +.vscode/ +.vscode/.browse.c_cpp.db* +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/ipch diff --git a/lib/PsychicHttp/benchmark/arduinomongoose/data/www/alien.png b/lib/PsychicHttp/benchmark/arduinomongoose/data/www/alien.png new file mode 100644 index 0000000000000000000000000000000000000000..a030da0761a60fbfc813fbef0716f801b7aa5ca6 GIT binary patch literal 28598 zcmYJaWmuG5*Dws@07I9c(v3)ofOHIvbW4}Clyr9^NOyN5-5@DFv~)>#H+&~v_w#_92^|Fq=bkf931@l^B)8e_|M?S$Wr;jgr@UiH3RbUqIq6nxmxyTg3pllF+C|;?J8R22|OHS|$5C&}~C$Cp7CMXc++U4Q4NgN|sM6}41E?6Tp^Y-YI z6#fhiLo&L$mU?MXaTZi`JA7SWs9of%+UM(=S3bi+!8kp6V9v*Az4tWod4Y=G#KQ2K zDcB2cxINq5-$Y_hu6%la!EBxtD%w8(hSb9e7Pwy4*Eb&|887A+KvZ>oyX1?J- zM_ibe8Z;Ta%NmvTHtCP(e8mmObB2XPqVT@qFQ_-LKpD z4T?X3%T@C>*_O^`P3Wj<7WhmK$V3NUz+mPR`cM4KCr_Q)UaR$Yx(0YN%qF?DZ&y`N zAGIOqU_mk>5Z1YkX;uX#^55%EvUo4Qj6EtfAk?lN4O`*o5JZ5poyLV8JS&{(Mbn>< zPX+E(pQQT2yBS@Z13j>QB*B5TH)n+hSOA@+1Vb@U^q_?yjMU z2~%{?Q*7L)c~U=7T$BaddgOG67^VOH%SVnbMvG+wfrm5+(-4@EWOT?a39i3J(fMud z%doaamh8Zr9~Utk%RLx+ZlaL!XTy>H=3cr z^tlDkmg$ILOCXLaEFjp1f~;drXNd6l^U4k(HtE%O+S*0|5bJ9YXdDoR6psUhR~e*p zR7Vh`eK)eTaTZ4Rx+QqIV=*g2R3HQyvbx^*=o>lZq0au<&P=SA?v8o{G0U$*5?K%? z7YZT%LRl#i{D%PHQC9gENY)

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> 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 c1aJ>H;&fJ5 THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/benchmark/arduinomongoose/platformio.ini b/lib/PsychicHttp/benchmark/arduinomongoose/platformio.ini new file mode 100644 index 0000000..b5604fb --- /dev/null +++ b/lib/PsychicHttp/benchmark/arduinomongoose/platformio.ini @@ -0,0 +1,22 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[env] +platform = espressif32 +framework = arduino +board = esp32dev +monitor_speed = 115200 +monitor_filters = esp32_exception_decoder +lib_deps = + jeremypoulter/ArduinoMongoose + bblanchon/ArduinoJson +board_build.filesystem = littlefs + +[env:default] \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/arduinomongoose/src/main.cpp b/lib/PsychicHttp/benchmark/arduinomongoose/src/main.cpp new file mode 100644 index 0000000..f7e0a9d --- /dev/null +++ b/lib/PsychicHttp/benchmark/arduinomongoose/src/main.cpp @@ -0,0 +1,234 @@ +/* Wi-Fi STA Connect and Disconnect Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. + +*/ +#include +#include +#include +#include +#include +#include + +const char *ssid = ""; +const char *password = ""; + +MongooseHttpServer server; + +const char *htmlContent = R"( + + + + Sample HTML + + +

Hello, World!

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+ + +)"; + +bool connectToWifi() +{ + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.setSleep(false); + WiFi.useStaticBuffers(true); + + WiFi.begin(ssid, password); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + Serial.println("ArduinoMongoose Benchmark"); + + // We start by connecting to a WiFi network + // To debug, please enable Core Debug Level to Verbose + if (connectToWifi()) + { + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + //start our server + Mongoose.begin(); + server.begin(80); + + //index file + server.on("/", HTTP_GET, [](MongooseHttpServerRequest *request) + { + request->send(200, "text/html", htmlContent); + }); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/api", HTTP_GET, [](MongooseHttpServerRequest *request) + { + //create a response object + StaticJsonDocument<128> output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + String foo = request->getParam("foo"); + output["foo"] = foo; + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + request->send(200, "application/json", jsonBuffer.c_str()); + }); + + //websocket + server.on("/ws$")-> + onFrame([](MongooseHttpWebSocketConnection *connection, int flags, uint8_t *data, size_t len) { + connection->send(WEBSOCKET_OP_TEXT, data, len); + //server.sendAll(connection, (char *)data); + }); + + //hack - no servestatic + server.on("/alien.png", HTTP_GET, [](MongooseHttpServerRequest *request) + { + //open our file + File fp = LittleFS.open("/www/alien.png"); + size_t length = fp.size(); + + //read our data + uint8_t * data = (uint8_t *)malloc(length); + if (data != NULL) + { + fp.readBytes((char *)data, length); + + //send it off + MongooseHttpServerResponseBasic *response = request->beginResponse(); + response->setContent(data, length); + response->setContentType("image/png"); + response->setCode(200); + request->send(response); + + //free the memory + free(data); + } + else + request->send(503); + }); + } +} + +void loop() +{ + Mongoose.poll(1000); +} \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/arduinomongoose/test/README b/lib/PsychicHttp/benchmark/arduinomongoose/test/README new file mode 100644 index 0000000..9b1e87b --- /dev/null +++ b/lib/PsychicHttp/benchmark/arduinomongoose/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PlatformIO Test Runner and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PlatformIO Unit Testing: +- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html diff --git a/lib/PsychicHttp/benchmark/comparison.ods b/lib/PsychicHttp/benchmark/comparison.ods new file mode 100644 index 0000000000000000000000000000000000000000..47e6587342544ef945bd9e94c41b83f41deec708 GIT binary patch literal 82456 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 tyUIDC literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/benchmark/espasyncwebserver/.gitignore b/lib/PsychicHttp/benchmark/espasyncwebserver/.gitignore new file mode 100644 index 0000000..9e5f911 --- /dev/null +++ b/lib/PsychicHttp/benchmark/espasyncwebserver/.gitignore @@ -0,0 +1,6 @@ +.pio +.vscode/ +.vscode/.browse.c_cpp.db* +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/ipch diff --git a/lib/PsychicHttp/benchmark/espasyncwebserver/data/www/alien.png b/lib/PsychicHttp/benchmark/espasyncwebserver/data/www/alien.png new file mode 100644 index 0000000000000000000000000000000000000000..a030da0761a60fbfc813fbef0716f801b7aa5ca6 GIT binary patch literal 28598 zcmYJaWmuG5*Dws@07I9c(v3)ofOHIvbW4}Clyr9^NOyN5-5@DFv~)>#H+&~v_w#_92^|Fq=bkf931@l^B)8e_|M?S$Wr;jgr@UiH3RbUqIq6nxmxyTg3pllF+C|;?J8R22|OHS|$5C&}~C$Cp7CMXc++U4Q4NgN|sM6}41E?6Tp^Y-YI z6#fhiLo&L$mU?MXaTZi`JA7SWs9of%+UM(=S3bi+!8kp6V9v*Az4tWod4Y=G#KQ2K zDcB2cxINq5-$Y_hu6%la!EBxtD%w8(hSb9e7Pwy4*Eb&|887A+KvZ>oyX1?J- zM_ibe8Z;Ta%NmvTHtCP(e8mmObB2XPqVT@qFQ_-LKpD z4T?X3%T@C>*_O^`P3Wj<7WhmK$V3NUz+mPR`cM4KCr_Q)UaR$Yx(0YN%qF?DZ&y`N zAGIOqU_mk>5Z1YkX;uX#^55%EvUo4Qj6EtfAk?lN4O`*o5JZ5poyLV8JS&{(Mbn>< zPX+E(pQQT2yBS@Z13j>QB*B5TH)n+hSOA@+1Vb@U^q_?yjMU z2~%{?Q*7L)c~U=7T$BaddgOG67^VOH%SVnbMvG+wfrm5+(-4@EWOT?a39i3J(fMud z%doaamh8Zr9~Utk%RLx+ZlaL!XTy>H=3cr z^tlDkmg$ILOCXLaEFjp1f~;drXNd6l^U4k(HtE%O+S*0|5bJ9YXdDoR6psUhR~e*p zR7Vh`eK)eTaTZ4Rx+QqIV=*g2R3HQyvbx^*=o>lZq0au<&P=SA?v8o{G0U$*5?K%? z7YZT%LRl#i{D%PHQC9gENY)

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> 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 c1aJ>H;&fJ5 THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/benchmark/espasyncwebserver/platformio.ini b/lib/PsychicHttp/benchmark/espasyncwebserver/platformio.ini new file mode 100644 index 0000000..0f883e3 --- /dev/null +++ b/lib/PsychicHttp/benchmark/espasyncwebserver/platformio.ini @@ -0,0 +1,22 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[env] +platform = espressif32 +framework = arduino +board = esp32dev +monitor_speed = 115200 +monitor_filters = esp32_exception_decoder +lib_deps = + https://github.com/me-no-dev/ESPAsyncWebServer + bblanchon/ArduinoJson +board_build.filesystem = littlefs + +[env:default] \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/espasyncwebserver/src/main.cpp b/lib/PsychicHttp/benchmark/espasyncwebserver/src/main.cpp new file mode 100644 index 0000000..c76c1cd --- /dev/null +++ b/lib/PsychicHttp/benchmark/espasyncwebserver/src/main.cpp @@ -0,0 +1,276 @@ +/* Wi-Fi STA Connect and Disconnect Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. + +*/ +#include +#include +#include +#include +#include + +const char *ssid = ""; +const char *password = ""; + +AsyncWebServer server(80); +AsyncWebSocket ws("/ws"); + +const char *htmlContent = R"( + + + + Sample HTML + + +

Hello, World!

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+ + +)"; + +bool connectToWifi() +{ + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.setSleep(false); + WiFi.useStaticBuffers(true); + + WiFi.begin(ssid, password); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void onEvent(AsyncWebSocket * server, AsyncWebSocketClient * client, AwsEventType type, void * arg, uint8_t *data, size_t len){ + if(type == WS_EVT_CONNECT){ + //client connected + // Serial.printf("ws[%s][%u] connect\n", server->url(), client->id()); + // client->printf("Hello Client %u :)", client->id()); + // client->ping(); + } else if(type == WS_EVT_DISCONNECT){ + //client disconnected + // Serial.printf("ws[%s][%u] disconnect: %u\n", server->url(), client->id()); + } else if(type == WS_EVT_ERROR){ + //error was received from the other end + // Serial.printf("ws[%s][%u] error(%u): %s\n", server->url(), client->id(), *((uint16_t*)arg), (char*)data); + } else if(type == WS_EVT_PONG){ + //pong message was received (in response to a ping request maybe) + // Serial.printf("ws[%s][%u] pong[%u]: %s\n", server->url(), client->id(), len, (len)?(char*)data:""); + } else if(type == WS_EVT_DATA){ + //data packet + AwsFrameInfo * info = (AwsFrameInfo*)arg; + if(info->final && info->index == 0 && info->len == len){ + //the whole message is in a single frame and we got all of it's data + // Serial.printf("ws[%s][%u] %s-message[%llu]: ", server->url(), client->id(), (info->opcode == WS_TEXT)?"text":"binary", info->len); + if(info->opcode == WS_TEXT){ + data[len] = 0; + // Serial.printf("%s\n", (char*)data); + } else { + // for(size_t i=0; i < info->len; i++){ + // Serial.printf("%02x ", data[i]); + // } + // Serial.printf("\n"); + } + if(info->opcode == WS_TEXT) + { + client->text((char *)data, len); + } + // else + // client->binary("I got your binary message"); + } else { + //message is comprised of multiple frames or the frame is split into multiple packets + if(info->index == 0){ + // if(info->num == 0) + // Serial.printf("ws[%s][%u] %s-message start\n", server->url(), client->id(), (info->message_opcode == WS_TEXT)?"text":"binary"); + // Serial.printf("ws[%s][%u] frame[%u] start[%llu]\n", server->url(), client->id(), info->num, info->len); + } + + Serial.printf("ws[%s][%u] frame[%u] %s[%llu - %llu]: ", server->url(), client->id(), info->num, (info->message_opcode == WS_TEXT)?"text":"binary", info->index, info->index + len); + if(info->message_opcode == WS_TEXT){ + data[len] = 0; + // Serial.printf("%s\n", (char*)data); + } else { + // for(size_t i=0; i < len; i++){ + // Serial.printf("%02x ", data[i]); + // } + // Serial.printf("\n"); + } + + if((info->index + len) == info->len){ + // Serial.printf("ws[%s][%u] frame[%u] end[%llu]\n", server->url(), client->id(), info->num, info->len); + if(info->final){ + // Serial.printf("ws[%s][%u] %s-message end\n", server->url(), client->id(), (info->message_opcode == WS_TEXT)?"text":"binary"); + if(info->message_opcode == WS_TEXT) + { + client->text((char *)data, info->len); + } + // else + // client->binary("I got your binary message"); + } + } + } + } +} + +void setup() +{ + Serial.begin(115200); + delay(10); + Serial.println("ESPAsyncWebserver Benchmark"); + + // We start by connecting to a WiFi network + // To debug, please enable Core Debug Level to Verbose + if (connectToWifi()) + { + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/", HTTP_GET, [](AsyncWebServerRequest *request) + { + request->send(200, "text/html", htmlContent); + }); + + //serve static files from LittleFS/www on / + server.serveStatic("/", LittleFS, "/www/"); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/api", HTTP_GET, [](AsyncWebServerRequest *request) + { + //create a response object + StaticJsonDocument<128> output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + AsyncWebParameter* foo = request->getParam("foo"); + output["foo"] = foo->value(); + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + request->send(200, "application/json", jsonBuffer.c_str()); + }); + + ws.onEvent(onEvent); + server.addHandler(&ws); + + server.begin(); + } +} + +void loop() +{ + ws.cleanupClients(); + delay(1000); +} \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/espasyncwebserver/test/README b/lib/PsychicHttp/benchmark/espasyncwebserver/test/README new file mode 100644 index 0000000..9b1e87b --- /dev/null +++ b/lib/PsychicHttp/benchmark/espasyncwebserver/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PlatformIO Test Runner and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PlatformIO Unit Testing: +- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html diff --git a/lib/PsychicHttp/benchmark/eventsource-client-test.js b/lib/PsychicHttp/benchmark/eventsource-client-test.js new file mode 100644 index 0000000..8253789 --- /dev/null +++ b/lib/PsychicHttp/benchmark/eventsource-client-test.js @@ -0,0 +1,39 @@ +#!/usr/bin/env node + +const EventSource = require('eventsource'); +const url = 'http://192.168.2.131/events'; + +async function eventSourceClient() { + console.log(`Starting test`); + for (let i = 0; i < 1000000; i++) + { + if (i % 100 == 0) + console.log(`Count: ${i}`); + + let eventSource = new EventSource(url); + + eventSource.onopen = () => { + //console.log('EventSource connection opened.'); + }; + + eventSource.onerror = (error) => { + console.error('EventSource error:', error); + + // Close the connection on error + eventSource.close(); + }; + + await new Promise((resolve) => { + eventSource.onmessage = (event) => { + //console.log('Received message:', event.data); + + // Close the connection after receiving the first message + eventSource.close(); + + resolve(); + } + }); + } +} + +eventSourceClient(); \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/http-client-test.js b/lib/PsychicHttp/benchmark/http-client-test.js new file mode 100644 index 0000000..29588b9 --- /dev/null +++ b/lib/PsychicHttp/benchmark/http-client-test.js @@ -0,0 +1,43 @@ +#!/usr/bin/env node + +const axios = require('axios'); + +const url = 'http://192.168.2.131/api'; +const queryParams = { + foo: 'bar', + foo1: 'bar', + foo2: 'bar', + foo3: 'bar', + foo4: 'bar', + foo5: 'bar', + foo6: 'bar', +}; + +const totalRequests = 1000000; +const requestsPerCount = 100; + +let requestCount = 0; + +function fetchData() { + axios.get(url, { params: queryParams }) + .then(response => { + requestCount++; + + if (requestCount % requestsPerCount === 0) { + console.log(`Requests completed: ${requestCount}`); + } + + if (requestCount < totalRequests) { + fetchData(); + } else { + console.log('All requests completed.'); + } + }) + .catch(error => { + console.error('Error making request:', error.message); + }); +} + +// Start making requests +console.log(`Starting test`); +fetchData(); \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/latency.png b/lib/PsychicHttp/benchmark/latency.png new file mode 100644 index 0000000000000000000000000000000000000000..1cedc9372a018705ec8ea78b4cf5bfc947c6e318 GIT binary patch literal 50143 zcmdSBWmp_-5G@!15(0z(!7Vt!-6bKo1{vH3cL)vxAwVFwYk=S~z#zc}1_A_kg1ZKH z_wC7d_wL=jzxR1|`{&GbPrvn6ojP@@y1#u?mce>K^5W5>M_6*Ql4_40J%v4b^aS@g z8t@5Cs?rqNhuU#-<8x<9mii-<(Yc#*wRlWNQ zaQDWxwzgXqdFZXJt=m^TT`k4Ge!ZKTn))?8Ehtx~vQ^u=NQh%}6VVX$cE)6@x& zEHpGO956=z_VIe3fcGh*%|z+9(R_vUweKBa`0A8~lw!VCaVNy9ORa(Res@B;bqu$Z=Y3qi<2UdUv~?ew4=|WO6Bm z)8DB7h`-49>e%yqm$(UmP~R0hwa&uxf>fFHxM}(=EwL+n&=lBme~ppK zWzIDXxxYDRnQHRl?oDD1XET7OoX$CtqD$j0a9IvUv^?C;vRu5qP;YQCcikS73syys z>Etli3&AA*5{yBZBl!)Nvkl7Wuh)Nc(KYA4+SJr^*u#+Z!?Ys|ewa2k85Y{Df%K%( zAe5Vqa6<6RPwQg7CYyl_VZs`lakUnOy205x$JJ=@`(HCPw#!RPKb{m8dwO~nWr^RN z;t9F$T2-AiNBZ5JY0V*g2p?`wu&XSG9FlGl*!|ZO(#s7RP3P*JFZb#eBj6duGjQis zX?*>+VZK*utE+)uu}DkyhKE1)r*J-HV`JMK$(4ySWTvK8Hv!@zJpLmMWrWz}($h1l zt=p>;r%#_g#M3Js0>&WKzxWmKRJ+cBJX6H$O9=>CvY+GZb#uvm3jD#WeJDt-V85`PL(7oD{-<;lc%%q^;Thb z5^K5;TeJ`0w%Zp*epjfd7zDpJviu#!R%LfTU0xo6LGNQv1O)}N{qC+WH*=$nEiDTN z*{MFZo$xRE;;lM&KhyH}_rJYdjXsKEPuy=ERc0-o;IW-h6lFuNprWF3a&_goKC-6F zg+ie(I^r2rq|5aiG(6Vk8$F<_P|dQo>1s=mxe-NUlgwJ*qpcFQjl`0fE=vChz|%T> z2DAL{rz8>V@~d@jQ}2ZJ+5h34*8$Cv96h6{1i-_HX# z7%T0SA~uGypp%lBG+sue3JaFUVo4WSBF}U)Gc&atTA!uJ2YY(fU%#bXaoHFw6Z4h3(7EEc>>xBM+F>=jWOP0Tw+DoL?=8-oTHR3pe4J^&6Os=3m1*IqFn zHH$t{o#`v2o9UNSMyuRjZDcWN^!?_=rV#mPWGMSNj{VK=1%waCDh7M&cxtxBwy;gD z!DW4HH4ghk?X7OL1r`af&Fc-pnq^R?0=gj{z2Zj`J&BHibpG+13ZIMp?e<2L6;ghO zqDgg$j^XSNk$wYsCvf7M8M?n$5e@*-lw=^h&%%y6BwaEwuD-~%K~ZRcrF$!72!Rk{ zE?E*YZ!d0ucr1a88t{r8)$nrCdiMHAmcVccBB`Pq&HIv=cK4?$KhzoBzXZVy4fclO z8KSQ*M9h0%_owk<00xXa@$GCX*F7eYt$>_v#(J}@i{&K;HhG|7Q*~R1$Wk1YD#yMEvR%dw{%{h=REqJ$al{GACF% zmolVsC_CmI6=mGIyIN)J8|n+@SuVlwxsV`nblAzp5dU-7OnEcH=R$e(y#Y;WSlzx}*Q3nB-_~CW(cN>nIl6TBxgwlN}LN!!ImV6X> zOl4T2U74Y-aPz%4F+nM`3T4!?uoB- zp(y=E1Y7Y?@SOA)+i(I_4bP+>Z}*az7Ou~BKr!Q*o9lk-SF!H2uR~XCp|0x5;pdAV z_46V}ZzS%^yBD8;WjnOKK%0`+y~ZCds0{4$b68-(O;IvYWFwFf8vnx64@F{NL#?}; z820%*kI;T0mT|iVm91?k7Ob=RLQ?<0UogwAZ?WUy?!bS$A+GC3VhS=#Bmh~W+orqj zZl*F5h&LwQL54n z_;zOBzxzIlFDdk`XV(2$RH7`~@t#yd@x9m^1#`&~E?us-5py1=sb2Bd0zX%LUYh&< zK=E%Vt7Xph^-SE3(a_9OfW?$&tBoYME0{~`Imf=EoqxT$Q&L8EQ4Fy=ey?jNTpXt$ zRSrPSc8$XB>L1OiylaMe-c{;VTRMU68%a|AU=a&1<-95u`*`_m&W!}NxS5?ELD~wr zMCG=$nC&Fjj0Bq$O;e+jOGAE>e%s`Pi*T_mL)MM41BtA;4T)xBT&{*V7z|d@+z07y z(ec9G^r%jnm505smXR>Eh5B+*&nMCi%kk=Uj`o6+_j|Ymzt2fODRdo5nzZ=!`SJGo z@p>XBt$=*6h9Mz(;%JSq(AF^wLY~iD9wgxf$)l#2J+awsk%Jub%Qxyr_5WnS*S@=u zH(l_lL_Fl1GOvc_hgZx=!xJF*g>?`WlW+`@kz87Lb+?WrOjiu(K z=a2hAYc~Dj>QRA8V?wY-(AtM4-_J=el6{HdZDKSi%=8{UxVgwBsxr~3Wyjql?gv*j zg~u={=;NLUNJcY%O`TxN4e6CA1E^=s-izW4$u_K>pP)Nl;0X;YUTD$6z038 zbgfwvOmvtzUKV~EtE*J3IkwUvOk$|q}~yBw2P^$>DPcoWK|B)!OWpR@N}Yr=h$9}YuNC^nN} z@K?xdY!UN{mV2JqVpNIfin!x1rh7Qg+ku=yU|TB=_vSJPC3iD^O0p30U5zeEnY1ZC%%WeAuA9N4MRwQLp}&8$v&mh~OYBTe zOZ&>>RdSvPp+u)tFUp5win#K&<0e_cNm$FhE{N$&&Rnx37X4dU*(k40=gqcw%kg)G zr3CrBAfe(;1>;1A>rrye`@Oysx;$NGScY96cvP8@-prH%JzJt=fJ>9_+DCf9ainX} zX3>#rpNH?;7604Q+1KfLw}@|hckHt>d_Bnom7M<*%H{EYa_icN|FD%y*0_39)G|@x z&Zk41Zqa`o&4s4;1*$=57Dtb6&m}heIU{?(S@TZ5+6_=GM?MJat@DkVD*)gE~A;Y(Wr z$UXM^qzD^emmWxqEG%&Ip;__$mmd+_N#VD8<7hI(DsMsBduuupQKZ%GR(AH0WnY*s z$nQj%VUaO6$qKH=-f{wolky6)<2n|gq}gZ+QC+v}2?nE3*+&!DUuK+0CL@}F)mum8 zHC@DA-}C=3OFrHhg85O1`A!+PC=%h`Jx$dxTWc?fc=%%!Cnd|TUHqh1oAYXz9z;yc zua_&0wL4ucqx6d!yp#t8OU$cBX73R&zE}2tLcCWcaBRXal=_{iGP<2;G*}(ZCyy%E zNo~Ur6YKnWG}2}G$9tQI^rZe6rezTQgv|tf46C=$9iszm3!c6OEacRkB=Flfnvu?612z+%k(%9p=ZtQj!af**xe^$M(Vf;)@0D>RPj6fy2%7%!NY zdsEmW1<86<5x$^ zl;GE8`VDGzM)baMPK=aG`L-3lDe*ft%+En38m*x?G_DE?Rt$t;;r%~INp<`_0DSLb zs)$VIv^7I|Tnv?c+>xK!bOO5T+EavUP2y1i?z_CkTty*p|Eesem;SMS&(+Ur9))+w zUD*bj9~90N5*0I_5-SibVz$VcZ+8{a8MNjz7bxoHikn2ExTtHz)I4Y+yBol-~bd6VX{d^r!-lZ{GJlg!cS zi(M7)L2TE3`?AqEIyC%ZK#--z{BF89o%B&E{l9EtK}UIR_V(4Ce2~WZPX(LJ_;0Ft zE6VTcOpf=o9J~W1o*UUO;%8Fq%mMx-lSd4wdQYA9HGMc@)i*eo@ zD3f7&a66MXAaN_@FFw7=~jd-eQ|Ge zad1*`0ZAz}(bp=>ur*w)nWg#ecvfwVgw#wO!W@Oj3J3HwM%jEDUKT$xgNU4laHd|`1=Pl!p=SWZB z^nVeiyNl_U3lBiDwUv@IlSk@fX7Awd9Tu8&+)NU}YD;acw~4)agyh~Nuob8c*a4zI z1h16(mk5L8oA?+3*UgW)j+WnQoA=_bkrsM^6y1np%mdBhD2uK7;^;@1=M&s};CZ9- zy6`l454+S$hWwu0mQe&~pTE}a`>N^xc5bTjx`ZPGG2!ju@`vjAtp2GCjlT{%vuuJe ze4N;~|9?{d6h1AFPfikoyP|?4BO|Yg=aX3VDgd>?)7v{ovrPB$Z@S~s%1TaD@Yk=V zE5E-9cpkp_o{=%q4DoT@nHZSE4){;W%#l-HJ_AZsK;U^MA|mp!$@7S486;slS#B`W z=;1h4r2167K(VzOkBG+NOLDV|G z_)y5Ap9tSDOAHd0A?!gy79J7t8z=!sU`FDKSz-ozP=iLk{keu*zvNeqF6;96PK~Zx zIp@=}v*5NMbf*59>FLyq)>r>77pt810v1llE?sLk&EdK^Ow!}Del+*Kg3_N_ts2Joid%} zFBljY03%5RYi&`mtQsB6H->!v{D@aBUQ9+t=8T(zV|aJ(Kjk=we)TSj!J@u!Yj~+zu)8B}*=qOjYzmzmcAv!GF*N`^n zw}Sfe_~N3`9VR;Zdr8S42ffZpd4V$Z!l<-ZZ9n-l5IwjzmL^13v(T(3t~*1RUpkT` zm`)+7s02!u{3eY~fj~iw1$jB@oI1labeM^WiIbZf?^NNun9n&2lSa{Jpr+0Skdvum zW@e`35%YV{Y^3&t&)#r$U|PN06Q^&ubYr>||3eSgv8Hd5pETM!X5ML#*2qRnkz-zG(pg zfgdjGz0MTLZbr7_CFZ>a|9PD%SAOdMDbrgM{{L2-|7WlN_uB{gE*D1nADR{ESmrT- z9e&+`G+jcN=*7kFP1cMfrIQv_9z8k*{*cg6#*TlWm~U!3q!es)s8A{*ioRHTIXgN) zMNKWw`LE?soSI^+C;ni??jR=Gz761XzRv&ruAQbWhmYD`8$w5&!xM?@p)lf) z!r)=Dl1sNAG>yK6GVUSOMrwI;Y8sl#%gYpgkk+2xK=3%wS&@hS>!qm0hOj#t?`JzY zjqiA}$j~_NFH`(GQ%U~+frH8U3dyDbMx}6>znGhw8*2tcY{l;aIM1*tf~u>zXX+fI z0hu!ux&_$U`2{*g+sui2#nCNGkW^5okHNodvdaH&m?+S`GY-`nsdF?!K|@2z=I}#6 za@WGQdWJ<3qy;m~wj9dzyuTF$dyo~edUmZg*E7#Ql=KR;$m)camlIXnP}TLFM0i(W0J0o+yf zW_NFo)1(ar-(qifxBr+30JNWmsABDlUDB(=dv4#F_p0z(OwH003mjhq?W^Ft;zPLS zk*Qf<64r;1mystz$Ua8kGi(maL9(CLf28Y>GF}PPxzT;k_2z#8OD3sVWl70AIy|nu z=4Q-??_?McOIm1MYb_ub5h|^wsFlM#tRjPYh&*q6XlQrosD@|a5=j;y%7ITeN3f$|m>v5}A{)uK;x(*(T!(zhQ@&0K4cszZ2AYFS0LnB)8|xm{D!< zy)N;`&A@e%=k~=rdv*~a-26}DUwq(~4>z)aXOaM`A<2q~c{QG24@iwx<0be}WP+wn zB5&TjQyR@18W~Z&OQ@_Ik^3R)b!=98QDgmw9vm10>+);Cv_@f?e@PP7E^j(QksSgP=$8OZDA-=Bd3V^ZXY^^Z7KBAY7u{l2s^yJ7|Hha zkFQA%jSC5WnUm*b+qM(%^x4wJMo1cOE?iGaQnDxuis$OSTV54Y zJYUZmuw{}3=Uj(x3CKxTAKVfc#H-aj+-@d*qp9Av$gi1%(`D@pohP{4^ z3pN7Umd;zFbZgzQAL?L0F?e`-s$nwO(Sd5-o3MOc4xEJBY7(IBW`SF)pB8=?$}#UJ zBW&qfDnPW?dlrZ&3zR#kmcK8s(kbDuHOz$7VlV1MAA9X&n^dyVBPfA9`bn0188m@V z=y%}*sLP*7`^e@NfTtDMk>KDU)(1tVB3oYiM_c+`V4WxT8K@|ACvby%2g(jrYaW)v zCOJJtTJmZM$*yn!43ToEOEKC78r3@0Jb1`XbLl|%BX$-Mp%+~un3e=?3d#8MB@dx+ zDWL*SQnKCe97U}>zIByYUnHKsA|v?RqEU*Q4`sb!*GbKyCbky#u&OV4W{lQ+0YnU}<(w)bYWd;n9U z`!(5*T^y%(nw0YvrZ4|S8!J^N(B9R2-k8+{fW z995fN$lPQ0WR%=vee2tlw--elO`F?|xkP~n^UL>*E?KRE6IBn>canISj#d&i{UVr> zrV|0nmxxt&Gx;o<)>)((NRSC%l`EsU4(}w|H`?+Z8|z%F`_C(c?ZX!`;$yuc^RJ`A z7QdFh{^7LwBm*FQEB_R!`UO@eHfwTgXXnJ|06?9>{;fe3*Xx-`XHKs8N=lbz;NAXK zRj$ujY>`18B3PH8E@zr)<*wIgB`bb)?A&~)UE9NtL`aj!ZaE16^^Skz0gSO`5(Rr& z1j~!+Ei@csDs_u!wN`4!G`<>VdU+oGR;>h`DiaBaO|MrQloTIlnN?IIw!YV>QpLLKVarl=uzbzfznvMl24h<6T4rLY7UXNYj13O>&u`hzbAn0cD2G0oQ7@!p}#A70Y zsebXY?STBDdV5$&QqqzC-#`KlO7Jy!eM`LJ?ATXn%7>dOJ{}_ETEg?%zW21|GDz{; za;8`#{V(O;Fk$aEz%;J}p1vt}^eo%ub?H32urUhW8gv`8wCmi2bc3ZY;kGq^A?Ba_R#TlF z!a!gpvGdL6fp|AL-`snQ=v!Lwj82hx!HG#C%xV3|WX{k1y*;~-kbId``XnMHSWg=8 ziO_#cfnGPjnos; zf3Ou@xyRqyI@t4XS4WZkYUYI{)sL*cM%v!7<(j{Dy*R`MRadv(9I%|~=)Qk25ML3lZD3LYvOAoG$C+q1%p0~P z^k%)=XuvRR~rLF<;R|FI<9%7Ph?j|Yq9x(Jsg%$XLB`mlg zo#}J}J^Fc9ZJ)o%daC%V*Can?9c{tkfAitF3W+dKj1MXPpsuo#Y|YvwQ4M5#he$Ik zzmm*N_YVu29roUm674YGavm0E{61^P`B zs+8JXf4TW+P;3fXJNZ2$qN>3rTVpUS$({&U$vBe8F%AfN+Lr0UTzhXqT=B<#y)t4E z7o`v`XW>eT>6u1DTxW(uN&_Tr@qeBe4#->N)%$RMQ(X85@uC#_IB7F4@iMInI(7!}x zZUgq&6T0kmt~#7Q7R(~%?<@ZbMry1ET9Ok5;3#eAz^wseB_W+Qhi84M%nfGQSJRrL zaN;z-^BMqXbEgcJ@`mB+P8EGL`o~oo$~RS6;JaXAo0~PnL&aV1qK!TWK)o9NyD2Kr z7eD7?9L>wn~r%G8;_4Es#q4E5#5a*LEof^dDB~e1Z4*3;# z;!nGF!0Kh~NK~}$Y@JneL*VUjrb^WT$&FXMFTDX&oQ^1aipHA~<;ee2@?9vqM0+5I z`Ou??y$a$e_rW9w3c%J<|7@+~iL(@pU)b5@U21brKr~^-$6zL(Lq>dJ`{hAEaa#DJ zy|||rd3aQmnh}?@}l!a4Ps|ToH4zT!Uo^Q772kPvtN)gt5(*RDO0($iCzD&Vk0sc7NjzaaqHoQ zBb0F9SX-MfC2AYhdd5(AxH-;RBYH7B$(U4zTLu4H`Jco6O9;hLt~iF?x0bw}z3FwHKT}$HIR9E)<*ofcW!>y;ijXA3#V1knktZn-_jK z0eJjbsyGhOwxv`5LMMg0yYqwPfcS4MkkM@NgGhdQY5{(~8X6_&?qzsXq{b|NW@cOO zAO9afRIto(0T zk*T9{CTIp`VUM-UF~sLxF&sRES6W;G7n5qOG5dRe$W0HALbkIMOWLHl8;=D+jCM%bOWWXgB%cPK9AcKisC9fyGpO++pO) zV8&{v8=?VRCvV2k<(4p^U-g61u4DpH_HwIJ#iuG)?$GWqWT?b;6tlGvZkP@<^gMro z#UY>xb<%S!JEy6tU#kKxB<5awPBiB9qFHAV_r6suZITN`{ru&x`j>hFoCL&ssf!=_ zMK~}YY%3*CGFJ#SBwq_79iXb{1p5NKthz<*+h^=gagnnLIsFdo>G|m&BsIg3JIAup@bG~}NQk8C zz=3z_V0Y<@GJePpw^SAF068hZ_{f~sR&M)Hw1?o={Gp$DU8G(g2xPH|{o=)^yNG*s zJL7OS%fcL!%8O}8N~r0-g4+V0gyPEp;fC>E!`tUCF?a+t_3&Kbnl}`w1}?fqZV6=b zwh?W-Fg(vgE}NV(uaIV`O1s1u(GPwAQ7D~GtBwc6&~iV2oJ*8h7@KrD7ldVwiMmSK znyu;j`r34Ns?r8a=&JYtm>f$HaHfu;6o2{b*|V`SJwhYjBUE7QsxT_#>(`Ri|65@^ z{wJ?ReTRj79;WDd$I%O?N?h?x+^qMsq{HSqhtPZFUf_1C`7$~wYNV7?g$v+ z03;==g(kuM#g^#DPtl5EguPF#^qYN&{U7e?;L1S#Q3(tuV3P1W2PXU^hB8HuZm&LJ z5_A2Q01_LceT+juc(fehvOU_(AHn*ZPx;w4*7#r3e^U7u#BJ*CJp)`DG1Gju%W^Nu zOF;>`nE>L@_UCoKS&edqCXh>RzZe?ttfP7s-af*pjR-AOO}ozH_`l1R!fxBI2Qx*( zfwB+!3d#$)c4g81`Ml0?v9mXkxe}0C0Ub_?yt=NgD+nD=Bc%pV7k0o@)bbc+Tj7y} z7T~)pYfkv{N!Ht!V&(UuT=_#L*%PYr)|yp~x=^hf^Nz0=)nmW)fRL+m>g!JX?o~m0 z<5(V1X_T{TF|Zixk3 zZ+*P@M`b6ftITraaBdL~SH@zOGHg-!J|tpL2gtHj96BUBi}5YsKONJd8sx!Pa%a46 z##C6d#v6_~Fn-2_mVy8&16O}Fmr|b{kY)in7(7)`BpzmHXb4Q_%3Pm1c51El;@1=` z0SW{$fE*F0zYoOj#e`lk9N6v9hZ}08!kgGjTc%Soz{9fCFj|mnA8({ zzcS*v!gttOIWS0`sTh8rz~cz=1jbs+(p0rAi0}6s4=|(fS#>o)+UDoW02)9cYC4Hd zdVu7tz>^%>y)Amw5FXqmZQTZ4ruEt)=LYJY_K_wH?5P>2w#K^DvNCcszLYPp$-2*g zDi|aaRN|1^;y(4l@);pOJ=Ic5Z-m_zjYUp;e#|l`ECIO%H&VgZtThR!_!0`*pe-#e z*TlHEUqVBl&(}tP&j2OAFv~AYMeItF6_P7jAi9tzhqpGEL7FQa*#^uBYm9^FZR411 zl2~+Djy-`?3X;`+HDQzzfVE*+L>#S80+@Au!a9yCGz*h1EAv~Lut^v)z&;Ce1IncCF*5_p;#$KC zq3l_Pc-NY@e+VfxZb;5+qX_KCaq=zxQz~#JXlTI74TgYp{+dPm;{XR4sURB(kJTd; z6%~9}1AYCE1&YMw2lA4qY01$c^gpA1r`|MToi_@=m+yLMhD$a0-Ej&$-OBEtmfJiT zKoDw;og2wCf2bq_#c+e)_whw2{_WnwO7XeWLkYUvJZ~uMiyGQdkqj2WVwvIs5N%Y^ zGm&?FMQ^aPr$?@AD=h|qzU=>@UZ|E3kP(EQZ4`o6gLTjhg7V`=e_Z-p7HvPojHI?R zGnz!54-(Beku=XvX(C`>+HN_$RQw~X>nP4^Ujl5E?!(6-ab$IL<50@+ufD|BzvBNA zsz@~ugp>>scph~oBO@c8e;f{non+@ zBxPKJst=w488U8rqWV)xmB*_l-~G*V!70Jz)slw~09Jgi^EEJP`SmI&D42Bj1nWge z9c)=Gf_PNeI+I`T6JI3b_&*LzBw{o_5;PGjaN`u+>PN`n;rnr&ndj{hr=9&JRd`&1 z^|xrJqvgkBXQ8@mW+(X#01tl2v~CMX0jj2w($dE5!PDAa-Xd+(3#EJCClN%*D)mX~ z>ORf|U(fJz^b~e~0~uIr?c7nlo>#J%6v^whWVHrsHVTYSIs^e`JF-_7z)FID@C6&{ z7l=8S$~q+>&wM>`h0mXr(aPNtl2#@QFdwp2VF#5@J6;8#g~!pH;Kf(^ry^z*Ejm38 zo0@kr<5D7Gd;?v?5F<=i$vhQ?_0_JUnZVW$k z1OC!CQVNrj26b`aFyJ5%NP@V4n=Bf=(z}|wsbL-3dM^WWFlim3bXs119C%lrhMh~P zc|`(1!gEsQed^m@@#p*G48#zKrgN#x(JpAXc!i@>K-AFQ$k+81>EMt=$Z?ilz4_m| z)l+hw2aAT0$-3V++7ljzzP_05O@{lj3UFWSB5~r>(G3ot^iqS<%5upB5oGb}7!ca+ z)Gxq+;@1irZgRy2(V@S@__bXfU%9@bA9!SgtC9Zt;Sr_AoiwVpt)-m_y(K-Nh~IKn zRb;lLPhs05eQ#f)WC|%aaRcXVkAy+c(~c@o=fa7H^WjP$%HSg&sQzp4p|vxfx7fiNP{22%@>6vS+Is6C2uL-8=vu8VyP-n#YcrLdm7uP*hLo%0C#>O_I}}c zG-mr4BJgNdSZ~DYx43l1YDn;nj;ab3?#ns@olt+}Thj`Sr1VdQO?uue$7U?y+;y36 zXeIGhX#0b$KCGs{B0d$`M751VZFw2c8R|)X+k2itici*_6Z~OdXxM3WP)gGJDd5Pe zBn+TQUP}hVy{H68m&W8WK!x7q`W^f^;lrrY3Da~8*W-6jS3S5z=w4JfOdMz}V)Qp(jI>^v8y)Wa zA}(z+PighC+r9k=Z}aa?x~qLpxST7fbg@;^WY$Xm9d_$^&T** zu!Xv})3eiUJ*~z*@#3kjnrlnp=7_REd`f$(hsM0 zI%$$@+I}o}N(XXW3H`A70=6P*OzrHN;3He_rTp*>*U}{SVqox3p`i1r6*tPIWvCbF z06sZ6?U=R1cltR&L21YRUXu`G}=(Q!}XAfUhrAWOT*h-c%lX-fnD zWXcKT6R~-ki(tDH+>yw-KeIm)Sz=Qby~5{kRm1-NGKJ?Tg zs5nJLmaX5J_s_>`J>GUX?p)P|t?pVy`%ZI}gljlrtaXPr!2<0A>{Q=tm4lf&eK#k$ zCTXP~w`Qw89-Dn|;}{S6c)*{1s`L))<0?DeF;gi;iPmDS-%!F9F_VTs7C&D?&sc^8DAK0$~AW>E*-%?3^}3xg@LT} z6T7-r5Qb)EDEFeGkK0Lx_|*I2RFafZD~^l)w%;g8(z;;1@X%sV@_f;bpnHl#K#_gL zu@&y4Vrb1K#>wWvOPKX}DM+P+3XJb4a;lj;^}BQdPO9NhR^!dQDuLiJQD@3C9C=d2 zR@5AEy+ul7I(pOmsqwYTT7C2rRELs1(~iOR9cKy=Z;j`*d^n*omdvAv#Oaqh@l#Lp z5w(5W>94l!9ttpQPxs5*3AQara2-<5-rWTnnG9ybocqDmt@paYGubK`M$0QHBh-7i z%hqNYsZ-68z{6a4Gqv`%0TZwC|7rf#p{0p}=8JEdUihXhxtULgS7V4NsS+D zL;YCwYSwv^PZlmxnim&`edjNooX=Fj?9j=nK>OLMT&ocb&oeIO{YC!oJXThPV+Q0u zA)>#=raAA~>Tx@j)`4D?;;b+cz$>=S1*Z#ThSJ2dRgc){8?&aItZAs_U;K0LcO^wT zgG%ka-2O%DP7(OH1flDNeqD8}1ck;sah>9fuQ6&f+Oup`mXbF5h`Q*8vHS{OT-TOA zzle&*70E)W{_W)9rkQ*kT;1iZ-{S3a;Z}1VV7Pu>ZqefS**ROcq^>gxp%kHVKUF%J zIH?kequk@hnID(R{bz@x1pSBV`!T6H_K-#>TPa*XnBKFwJvS{^?hkK8P2}fz^;g?t z3tw4uvVL`Skz-T5o@hGwGiWBF#DuRQ9w@N_`&BOH$vS<3Pl59lWO@Jl`a~V;-thIH z+RH!^;nz9`5=AM&$TR(q(jM zyy?l;shq0{YwS+s9-@kk5mEW6tB~8@7h(nb*u= zR=N!_<|HX7otlmZ&E*RVC&#UUg<^2|eT1ZjBOY@+6wgKWa111Ea0WkuZ@1a-4X6m~ z_4z)gHc|G*kCRGMGSNl|Wc5t3^9r-b^UTH&aZQT$ zzj*xMh{}W>S1~(%l6K+ocMTHLEPsBz&ND(pG7Cw<7G9>DXN_z;G#Sv1gZQ=n7JW`z zbxYKcD0yr7PFaqRul7@nLy^1`0vi}>fz?OjgrF09jqK<*vJm# zQ+_SdU0589SPaVlm^gzQ=s-$Jev22n?*rQSLTbFJZpJ84i}N|N3}EWnBq@+8ZHxO0VN;F5y5f9JM64NGCZGa2<`4weQ z5b5AO%VYPep2dpuU5(cRn&@;c8lYs;>5?~y)!Dnu5s#BCVnFJD4oGv`=YlhWxwbV2 zBLELZie8LINW!2N+qjU-={#w9cziaz_sPvg=Hc2u$EBG*$u=eS_Q{9C$%!Jl6p<#w z4gt36otIv9LSojS_XE_5w3->IMHcc=N>193*t{sz2&q>2Pb`=M;-;ZFo`WT6S>rLR zAH+WKO)_;$Dgq?_V|;xNijwXXck=IF*ME4#6|^hdBqimLt&RlwUHCaR0r}m?k0&5n zJt<6U0rit*5g4jo635VnUkd!5*1|z37v3tZm9MSLi~h&wOrfOwr=%`0$J9O|oF38a zM@!99*O0>|TrM?`lkwKzn~cm7kx{^4q(ht6jQ zpml&$@X9y(HvqKhc`?g?@G1GrIbHLL7V|B`P2Ia^&`k2vxGwJ7%5BD^{f3AbZF&@;NETiIUwIy*GjwQ0y=h~mAR(q-X>6Xm`& zMkr3lYf@XUVO6aa5UxIFdtX4$AX003o()?fyj81X&;3NeTU#UFT##f-gcFO7>^tgI z%CI|{u4MXo9306oXK{kxFRk2nh>eDGt>3y_KV&ELk2*T_JtW+Fjb^Qv3z_@tX#_dyay_t7DfA( zo*`$HRW2>x2{u1x@enoadxZw?9!j{@h#qOqeLT;SP(7DaYRk&AWs(3pS@ zF{K{}&w_5)a1v!E1m@65B+hIQN!ip?&em8i6)djfB9A&f3AV&Ae`{HTAQNd~H|fm` z@XYhF(;c0_F7b`zGZ$BKvlYd|=|FP-?%trUAxj6~+=|t0)4;pPFpu}JH1YP41$Za) z3Izqcp9E+I`$4+Bba07=IgX!Tw^Ik5$83WWSIb$Y>Oh;USV2wBsxP%N2F}BBo;kxX zZw>Rw7)6YOHyVeNLjyzZLx3e~je%X;j0!RCdX z#Vw?|$LkY6(Ejl3v0AoH00Uvj7YfAUd#(6T`tR?D%nl9hocCNdsn|rmf2!nJLyw(# zW!jsDmr{MkVtCa>W~q&kWQ*9;e|j*%{8(5|xlMB7{S(XeTct6npx}_U)hj7|A99QQ z#-qN^g`5tABoslmhF#;Rgl5rL$MyIl>Ca2jbbKUb>odKK1%PfXxWcG;ZCmGrL14O& zUr#SIwEv&2+3NvAIfI!Wu$hbB8x-X>5~a05%-}&9QR!JJ9u&&97o^ zo!Oe%?sCoI)YP`f#*EGUSMhAxus4~o z^5Qq=x#s?3`lC}NtyNN$!6NjyoD(d+ zDD{gvXn4#LlR;#S!fC>A&YNSI~$sauDkrNI-n?`ASg~=s<<%o{jz7wo_O`yRA zNY{$*H77-Syrv{2|Gh1u`%BXuCHQ#ZzW%S91Tb=T=nlPqs++KH-S8DbKtd3;?!&f< ztz;$Yu^|_+s>9t&tC+}H@d4k=!=v&Y#y7RhaCK>o{#jXrAVpla$(yii4=9|(*3bLd z@9%jmEYy;Op8O@EeBHnR16zOZ)U=3$6d0jWT;fnKfM=5S%Nr0|%-nm5uk<)yT{N-p zl!I--A;`uRxa0k{2hf#_LPmtd+S9EuNFV?N`gQD$wuZhVRs>;YP~+C5_mL(U)$5q_ zFu`vjLl7_-dm01Y*JeE|(ez{)ZwA2W90`T>o`F;o6`)*MMG%!c3M+}yej74;s{=%R z3H**EEU0kE-fh|k96Un9 zTha$h>L(B}w;!WbY<^6|S#AW?pg?jd@}1WqWvt1IZ$^9nrfC^$6L`tkKMT5E`5Vs- zgH|&DgJZ-f!DzqhGy45}|K2OR;f$W-7$Z}p!L3##0Kq{ zp>O4d+wE_0{(zWcT4|x`%-3tus>=7Qq>VfsOI-B>K zYLR{L1skLZ-*$`tmMQDnb6cAmJe1@>$&Dq8)G12M(#~ zT>XsZznwH!L9iq3A<>xDF?Oj*U4@xyqCMdfsh)=gkQd~`U5;fugoY3ZgwuUjd&)}e zbB_unJ3AZMFnviO^4!wW@~7h>#XQ`N`&s}ew$feS;7dz%B+um=T@fFAAX4a&U25Y# zOt&Hs=1%n7@GXnOR>3R8xbK%HUVr}kuZS{Vp70w5T4GY4o)eDVwG#X0PJmpaR|g|s zMzK3vhdl{1>H;2c0Q4u|%^SzrChcFlQ@IP}_E-O(4`tK<&tyzBLxj=(_le^%XX>1w zZZ)D${|8rZ9aZHTt?{~5R6t}40@8{C(j{Grh!T>EZYiaaZlzRGxJo0IRY*CA+*Ax}U8#Sh{c+3tsj zhcWE>UN|TMCy=L2Orp_ccNNBuW}EG0#xF>z>Z)=k=-1diR2;9u>^w2`=%SJBmMw2` zbIAd{&EHrn|7nuDu}SAaYSU+R8S&4>4Tlt;)+7l!!U)+;Uf=%m{N!CNXZe5gNTooq@*1sgOK#>0<# z%10N@s{AC3(!|o`Axg8#sW<##t$}|D%)h_14Z^SCak3bVT+8KvLC{A5dqvB`8cY%e zJ6r_2mxi64yNpF7Bqhifnvb?ulL|7z8m>8}+&XWsYKVO5zI;NP4rR%a& zP816j0mau`o-%!A6Hrm=oF08j{n;dc{_h#LNvC>vIheh_JfTg0=QM<$SM9i^GUYvj zR!^f-Ssly?#|d0$32OTI&$YK&GlM{w$)oe{KiXZCo+|VSenmet3MiEp7u|Rs3n>rp zuWiUFToLayk$}4dCv+55V~gUof$np*L)h_oahqEot>pPGtA7W*F-cyi^z6!OP}kb% z%XA|yVT{Mh>q)8bI4oGYYEEH(E_C(08d@pw;U4p1yrZ=dd=||zM7^}?yi_FP+?3-? zGsN!((RDzsVQ~5TUvg&f|B^GwK62Py;4f}0HtC%grb_Jk#!UF;B|Y^Og9$nD_b=4M zpIq{D+&N?G<{s6}+7|qyxva`37_(_L7Iaf#L7ilS5C8A?n3Phf!i4*~mfUvl<;m_G zmeEz~f?-Jgyz$$U_gw@!-rn9edrNP)*9x+-=z(D53qLCrKJVj$5#1q~dhirW9$vJ4 z5E7&F^8fPXmqjPvFx{KD2acPQ_W>{hL(Wtrl9M$2dN)vT9y=v``BVA#k<9b}^+<9; z|AuXWt@zPu+Anm(%COJ0>n0Ulu1N43&LnQmC8uGBQvbIxbS1-V$sY)xW3n;o*Cu*r=M^+&8DoOBnwW{=A`V|?nG|mnFN#Ci3a@F z;BoX#G?*LcM6+rmhg~9(#t2ONzD;bt%Lvvp@glq`IrpXF(U$`&saL9~JP_tc4`g3RmHc)T!?q}^3Lt$>7 z)xA!7{c+)=AB2{iR0K82OY)U(Hwh@enkqU8bEAfDMErfIdLt_ERpg@e>Hf-pWT%~s z)6@`U+9Eo(Ye{cMhG=hv+-i!F_MEGgYGR&x%$agPl9{G)Nep_kjD>W}l(jycO2Vb~ zUfk!kJXKaX;oGL{M5Kv?qMtNhzvGMAs`dGblAE90P-`j9v=!eXUgS7VL_P@3$#*rV%sH|9w z+gX*@Ck)xSH|UI0xCj$=bU(91?}7!Fjb)00^OOB@<|AeyaVxpUJUTJHT9&>Fw4Pj} z69PY-HH$2J&#B&S1reMAS;ySMf$^h_>MyNLb43KPLVq0+2L2ol z*!xu_Lw%qhqnKQQ%(HP`x4p^Kd!AA$BM!=leEmE6LB>Ji70LmLe6PXHIaEBKiz{L9 zG=N&8vl| z6Vq5eKVDFEOsWf#M9ICK$Qf-Z9#1u(R8KCwVH(+Efcy+;9C2|M#r=Vj@^W5Ili)ae zN2sMh7q7)hq1%?@sw|o@DsI zzRZWF&e=m1QsMbm1g=mYaDKHq3zHHGf?W@-T}>?LxEZ+TGW@3xrO9_McNKXcMrdfr zGmuGJ6<4VoK|wVgJxl)EqCn0|-dz9P)X7TBpfj6D-XWz3`V@~ z!O(#~&W&|Oy~aIbJlW?fk|_h8xhyTT5>o=FpHT26C!mdWihka8gLt3mGs zH-=zDuacZL2zNH;n>-XXm1HEs_z!6~#T;uvaGQl3i+*#?&XYt`=BkQTt)5xBtu^j(B2o zC++W;_ZRCX&+<~K#RgDfeih1MkN$T+gpTcR%}`%nTGh!%Jy0)sr?3yMtCy~pE|6wd zD||azWzVEhW=^_L@%i&je-gG}fPbYzN^2)cn(75u#I}JR3E2{%5{Nu@B?)W3v1AIL z)T#Fn?%4y&=ylC9bIEN1+vT3pHruE$#it639g(=0GM24{+VlKVp+PJ1g7Z_joAkpE zfTf(SbzOjCN<330$BY#F!69NL}Nl-rdV;PBT4=@$B_?Y{1AEvqv>=yRndBS z7T$4jKgenW9C{M)XV)pdgwgiWIeGfx>Na$fFX~yD1vst|jra_&W-Ek6et_D+9b@IO zuWj3yp=CUC5PoCABCWUj4!8jTe7Gqrtl=7oxgmmB~9gh zJ35d`2aJgRPz~$D@R6}b3QJXUQP_6rHdup$dqrG}scI7w6BR}ZhnJc86>BKoSy_cZ z%0DN-?qQwH!i^+R&pc$lq7IueZ+OxJOrecB2(!=$q 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 E2Mk-18UO$Q literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/benchmark/loadtest-http.sh b/lib/PsychicHttp/benchmark/loadtest-http.sh new file mode 100644 index 0000000..4e75b84 --- /dev/null +++ b/lib/PsychicHttp/benchmark/loadtest-http.sh @@ -0,0 +1,37 @@ +#!/usr/bin/env bash +#Command to install the testers: +# npm install -g autocannon + +TEST_IP="192.168.2.131" +TEST_TIME=60 +LOG_FILE=psychic-http-loadtest.log +TIMEOUT=10000 +PROTOCOL=http +#PROTOCOL=https + +if test -f "$LOG_FILE"; then + rm $LOG_FILE +fi + +for CONCURRENCY in 1 2 3 4 5 6 7 8 9 10 15 20 +#for CONCURRENCY in 20 +do + printf "\n\nCLIENTS: *** $CONCURRENCY ***\n\n" >> $LOG_FILE + echo "Testing $CONCURRENCY clients on $PROTOCOL://$TEST_IP/" + #loadtest -c $CONCURRENCY --cores 1 -t $TEST_TIME --timeout $TIMEOUT "$PROTOCOL://$TEST_IP/" --quiet >> $LOG_FILE + autocannon -c $CONCURRENCY -w 1 -d $TEST_TIME --renderStatusCodes "$PROTOCOL://$TEST_IP/" >> $LOG_FILE 2>&1 + printf "\n\n----------------\n\n" >> $LOG_FILE + sleep 1 + + echo "Testing $CONCURRENCY clients on $PROTOCOL://$TEST_IP/api" + #loadtest -c $CONCURRENCY --cores 1 -t $TEST_TIME --timeout $TIMEOUT "$PROTOCOL://$TEST_IP/api?foo=bar" --quiet >> $LOG_FILE + autocannon -c $CONCURRENCY -w 1 -d $TEST_TIME --renderStatusCodes "$PROTOCOL://$TEST_IP/api?foo=bar" >> $LOG_FILE 2>&1 + printf "\n\n----------------\n\n" >> $LOG_FILE + sleep 1 + + echo "Testing $CONCURRENCY clients on $PROTOCOL://$TEST_IP/alien.png" + #loadtest -c $CONCURRENCY --cores 1 -t $TEST_TIME --timeout $TIMEOUT "$PROTOCOL://$TEST_IP/alien.png" --quiet >> $LOG_FILE + autocannon -c $CONCURRENCY -w 1 -d $TEST_TIME --renderStatusCodes "$PROTOCOL://$TEST_IP/alien.png" >> $LOG_FILE 2>&1 + printf "\n\n----------------\n\n" >> $LOG_FILE + sleep 1 +done \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/loadtest-websocket.sh b/lib/PsychicHttp/benchmark/loadtest-websocket.sh new file mode 100644 index 0000000..a9b5a41 --- /dev/null +++ b/lib/PsychicHttp/benchmark/loadtest-websocket.sh @@ -0,0 +1,31 @@ +#!/usr/bin/env bash +#Command to install the testers: +# npm install -g loadtest + +TEST_IP="192.168.2.131" +TEST_TIME=60 +LOG_FILE=psychic-websocket-loadtest.log +PROTOCOL=ws +#PROTOCOL=wss + +if test -f "$LOG_FILE"; then + rm $LOG_FILE +fi + +for CONCURRENCY in 1 2 3 4 5 6 7 +do + printf "\n\nCLIENTS: *** $CONCURRENCY ***\n\n" >> $LOG_FILE + echo "Testing $CONCURRENCY clients on $PROTOCOL://$TEST_IP/ws" + loadtest -c $CONCURRENCY --cores 1 -t $TEST_TIME --insecure $PROTOCOL://$TEST_IP/ws --quiet 2> /dev/null >> $LOG_FILE + sleep 1 +done + +for CONNECTIONS in 8 10 16 20 +#for CONNECTIONS in 20 +do + CONCURRENCY=$((CONNECTIONS / 2)) + printf "\n\nCLIENTS: *** $CONNECTIONS ***\n\n" >> $LOG_FILE + echo "Testing $CONNECTIONS clients on $PROTOCOL://$TEST_IP/ws" + loadtest -c $CONCURRENCY --cores 2 -t $TEST_TIME --insecure $PROTOCOL://$TEST_IP/ws --quiet 2> /dev/null >> $LOG_FILE + sleep 1 +done \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/package.json b/lib/PsychicHttp/benchmark/package.json new file mode 100644 index 0000000..3237d56 --- /dev/null +++ b/lib/PsychicHttp/benchmark/package.json @@ -0,0 +1,7 @@ +{ + "dependencies": { + "axios": "^1.6.2", + "eventsource": "^2.0.2", + "ws": "^8.14.2" + } +} diff --git a/lib/PsychicHttp/benchmark/performance.png b/lib/PsychicHttp/benchmark/performance.png new file mode 100644 index 0000000000000000000000000000000000000000..81d2a3f4841593c573dd828ff0d7845c3044c725 GIT binary patch literal 49201 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"N)0%H7lIx**@ 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

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> 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 c1aJ>H;&fJ5 THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/benchmark/psychichttp/platformio.ini b/lib/PsychicHttp/benchmark/psychichttp/platformio.ini new file mode 100644 index 0000000..868f0ca --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttp/platformio.ini @@ -0,0 +1,22 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[env] +platform = espressif32 +framework = arduino +board = esp32dev +monitor_speed = 115200 +monitor_filters = esp32_exception_decoder +lib_deps = + https://github.com/hoeken/PsychicHttp + bblanchon/ArduinoJson +board_build.filesystem = littlefs + +[env:default] diff --git a/lib/PsychicHttp/benchmark/psychichttp/src/main.cpp b/lib/PsychicHttp/benchmark/psychichttp/src/main.cpp new file mode 100644 index 0000000..c42d644 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttp/src/main.cpp @@ -0,0 +1,228 @@ +/* Wi-Fi STA Connect and Disconnect Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. + +*/ +#include +#include +#include +#include +#include +#include "_secret.h" + +#ifndef WIFI_SSID + #error "You need to enter your wifi credentials. Copy secret.h to _secret.h and enter your credentials there." +#endif + +//Enter your WIFI credentials in secret.h +const char *ssid = WIFI_SSID; +const char *password = WIFI_PASS; + +PsychicHttpServer server; +PsychicWebSocketHandler websocketHandler; +PsychicEventSource eventSource; + +const char *htmlContent = R"( + + + + Sample HTML + + +

Hello, World!

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+ + +)"; + +bool connectToWifi() +{ + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.setSleep(false); + WiFi.useStaticBuffers(true); + + WiFi.begin(ssid, password); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + Serial.println("PsychicHTTP Benchmark"); + + if (connectToWifi()) + { + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + //start our server + server.listen(80); + + //our index + server.on("/", HTTP_GET, [](PsychicRequest *request) + { + return request->reply(200, "text/html", htmlContent); + }); + + //serve static files from LittleFS/www on / + server.serveStatic("/", LittleFS, "/www/"); + + //a websocket echo server + websocketHandler.onOpen([](PsychicWebSocketClient *client) { + client->sendMessage("Hello!"); + }); + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) { + request->reply(frame); + return ESP_OK; + }); + server.on("/ws", &websocketHandler); + + //EventSource server + eventSource.onOpen([](PsychicEventSourceClient *client) { + client->send("Hello", NULL, millis(), 1000); + }); + server.on("/events", &eventSource); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/api", HTTP_GET, [](PsychicRequest *request) + { + //create a response object + StaticJsonDocument<128> output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + String foo = request->getParam("foo")->value(); + output["foo"] = foo; + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + return request->reply(200, "application/json", jsonBuffer.c_str()); + }); + } +} + +unsigned long last; +void loop() +{ + if (millis() - last > 1000) + { + Serial.printf("Free Heap: %d\n", esp_get_free_heap_size()); + last = millis(); + } +} \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/psychichttp/src/secret.h b/lib/PsychicHttp/benchmark/psychichttp/src/secret.h new file mode 100644 index 0000000..6d4bb15 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttp/src/secret.h @@ -0,0 +1,2 @@ +#define WIFI_SSID "Your_SSID" +#define WIFI_PASS "Your_PASS" \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/psychichttp/test/README b/lib/PsychicHttp/benchmark/psychichttp/test/README new file mode 100644 index 0000000..9b1e87b --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttp/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PlatformIO Test Runner and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PlatformIO Unit Testing: +- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html diff --git a/lib/PsychicHttp/benchmark/psychichttps/.gitignore b/lib/PsychicHttp/benchmark/psychichttps/.gitignore new file mode 100644 index 0000000..9e5f911 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/.gitignore @@ -0,0 +1,6 @@ +.pio +.vscode/ +.vscode/.browse.c_cpp.db* +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/ipch diff --git a/lib/PsychicHttp/benchmark/psychichttps/data/server.crt b/lib/PsychicHttp/benchmark/psychichttps/data/server.crt new file mode 100644 index 0000000..34a1e01 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/data/server.crt @@ -0,0 +1,19 @@ +-----BEGIN CERTIFICATE----- +MIIDKzCCAhOgAwIBAgIUBxM3WJf2bP12kAfqhmhhjZWv0ukwDQYJKoZIhvcNAQEL +BQAwJTEjMCEGA1UEAwwaRVNQMzIgSFRUUFMgc2VydmVyIGV4YW1wbGUwHhcNMTgx +MDE3MTEzMjU3WhcNMjgxMDE0MTEzMjU3WjAlMSMwIQYDVQQDDBpFU1AzMiBIVFRQ +UyBzZXJ2ZXIgZXhhbXBsZTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEB +ALBint6nP77RCQcmKgwPtTsGK0uClxg+LwKJ3WXuye3oqnnjqJCwMEneXzGdG09T +sA0SyNPwrEgebLCH80an3gWU4pHDdqGHfJQa2jBL290e/5L5MB+6PTs2NKcojK/k +qcZkn58MWXhDW1NpAnJtjVniK2Ksvr/YIYSbyD+JiEs0MGxEx+kOl9d7hRHJaIzd +GF/vO2pl295v1qXekAlkgNMtYIVAjUy9CMpqaQBCQRL+BmPSJRkXBsYk8GPnieS4 +sUsp53DsNvCCtWDT6fd9D1v+BB6nDk/FCPKhtjYOwOAZlX4wWNSZpRNr5dfrxKsb +jAn4PCuR2akdF4G8WLUeDWECAwEAAaNTMFEwHQYDVR0OBBYEFMnmdJKOEepXrHI/ +ivM6mVqJgAX8MB8GA1UdIwQYMBaAFMnmdJKOEepXrHI/ivM6mVqJgAX8MA8GA1Ud +EwEB/wQFMAMBAf8wDQYJKoZIhvcNAQELBQADggEBADiXIGEkSsN0SLSfCF1VNWO3 +emBurfOcDq4EGEaxRKAU0814VEmU87btIDx80+z5Dbf+GGHCPrY7odIkxGNn0DJY +W1WcF+DOcbiWoUN6DTkAML0SMnp8aGj9ffx3x+qoggT+vGdWVVA4pgwqZT7Ybntx +bkzcNFW0sqmCv4IN1t4w6L0A87ZwsNwVpre/j6uyBw7s8YoJHDLRFT6g7qgn0tcN +ZufhNISvgWCVJQy/SZjNBHSpnIdCUSJAeTY2mkM4sGxY0Widk8LnjydxZUSxC3Nl +hb6pnMh3jRq4h0+5CZielA4/a+TdrNPv/qok67ot/XJdY3qHCCd8O2b14OVq9jo= +-----END CERTIFICATE----- \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/psychichttps/data/server.key b/lib/PsychicHttp/benchmark/psychichttps/data/server.key new file mode 100644 index 0000000..a591325 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/data/server.key @@ -0,0 +1,28 @@ +-----BEGIN PRIVATE KEY----- +MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCwYp7epz++0QkH +JioMD7U7BitLgpcYPi8Cid1l7snt6Kp546iQsDBJ3l8xnRtPU7ANEsjT8KxIHmyw +h/NGp94FlOKRw3ahh3yUGtowS9vdHv+S+TAfuj07NjSnKIyv5KnGZJ+fDFl4Q1tT +aQJybY1Z4itirL6/2CGEm8g/iYhLNDBsRMfpDpfXe4URyWiM3Rhf7ztqZdveb9al +3pAJZIDTLWCFQI1MvQjKamkAQkES/gZj0iUZFwbGJPBj54nkuLFLKedw7DbwgrVg +0+n3fQ9b/gQepw5PxQjyobY2DsDgGZV+MFjUmaUTa+XX68SrG4wJ+DwrkdmpHReB +vFi1Hg1hAgMBAAECggEAaTCnZkl/7qBjLexIryC/CBBJyaJ70W1kQ7NMYfniWwui +f0aRxJgOdD81rjTvkINsPp+xPRQO6oOadjzdjImYEuQTqrJTEUnntbu924eh+2D9 +Mf2CAanj0mglRnscS9mmljZ0KzoGMX6Z/EhnuS40WiJTlWlH6MlQU/FDnwC6U34y +JKy6/jGryfsx+kGU/NRvKSru6JYJWt5v7sOrymHWD62IT59h3blOiP8GMtYKeQlX +49om9Mo1VTIFASY3lrxmexbY+6FG8YO+tfIe0tTAiGrkb9Pz6tYbaj9FjEWOv4Vc ++3VMBUVdGJjgqvE8fx+/+mHo4Rg69BUPfPSrpEg7sQKBgQDlL85G04VZgrNZgOx6 +pTlCCl/NkfNb1OYa0BELqWINoWaWQHnm6lX8YjrUjwRpBF5s7mFhguFjUjp/NW6D +0EEg5BmO0ePJ3dLKSeOA7gMo7y7kAcD/YGToqAaGljkBI+IAWK5Su5yldrECTQKG +YnMKyQ1MWUfCYEwHtPvFvE5aPwKBgQDFBWXekpxHIvt/B41Cl/TftAzE7/f58JjV +MFo/JCh9TDcH6N5TMTRS1/iQrv5M6kJSSrHnq8pqDXOwfHLwxetpk9tr937VRzoL +CuG1Ar7c1AO6ujNnAEmUVC2DppL/ck5mRPWK/kgLwZSaNcZf8sydRgphsW1ogJin +7g0nGbFwXwKBgQCPoZY07Pr1TeP4g8OwWTu5F6dSvdU2CAbtZthH5q98u1n/cAj1 +noak1Srpa3foGMTUn9CHu+5kwHPIpUPNeAZZBpq91uxa5pnkDMp3UrLIRJ2uZyr8 +4PxcknEEh8DR5hsM/IbDcrCJQglM19ZtQeW3LKkY4BsIxjDf45ymH407IQKBgE/g +Ul6cPfOxQRlNLH4VMVgInSyyxWx1mODFy7DRrgCuh5kTVh+QUVBM8x9lcwAn8V9/ +nQT55wR8E603pznqY/jX0xvAqZE6YVPcw4kpZcwNwL1RhEl8GliikBlRzUL3SsW3 +q30AfqEViHPE3XpE66PPo6Hb1ymJCVr77iUuC3wtAoGBAIBrOGunv1qZMfqmwAY2 +lxlzRgxgSiaev0lTNxDzZkmU/u3dgdTwJ5DDANqPwJc6b8SGYTp9rQ0mbgVHnhIB +jcJQBQkTfq6Z0H6OoTVi7dPs3ibQJFrtkoyvYAbyk36quBmNRjVh6rc8468bhXYr +v/t+MeGJP/0Zw8v/X2CFll96 +-----END PRIVATE KEY----- \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/psychichttps/data/www/alien.png b/lib/PsychicHttp/benchmark/psychichttps/data/www/alien.png new file mode 100644 index 0000000000000000000000000000000000000000..a030da0761a60fbfc813fbef0716f801b7aa5ca6 GIT binary patch literal 28598 zcmYJaWmuG5*Dws@07I9c(v3)ofOHIvbW4}Clyr9^NOyN5-5@DFv~)>#H+&~v_w#_92^|Fq=bkf931@l^B)8e_|M?S$Wr;jgr@UiH3RbUqIq6nxmxyTg3pllF+C|;?J8R22|OHS|$5C&}~C$Cp7CMXc++U4Q4NgN|sM6}41E?6Tp^Y-YI z6#fhiLo&L$mU?MXaTZi`JA7SWs9of%+UM(=S3bi+!8kp6V9v*Az4tWod4Y=G#KQ2K zDcB2cxINq5-$Y_hu6%la!EBxtD%w8(hSb9e7Pwy4*Eb&|887A+KvZ>oyX1?J- zM_ibe8Z;Ta%NmvTHtCP(e8mmObB2XPqVT@qFQ_-LKpD z4T?X3%T@C>*_O^`P3Wj<7WhmK$V3NUz+mPR`cM4KCr_Q)UaR$Yx(0YN%qF?DZ&y`N zAGIOqU_mk>5Z1YkX;uX#^55%EvUo4Qj6EtfAk?lN4O`*o5JZ5poyLV8JS&{(Mbn>< zPX+E(pQQT2yBS@Z13j>QB*B5TH)n+hSOA@+1Vb@U^q_?yjMU z2~%{?Q*7L)c~U=7T$BaddgOG67^VOH%SVnbMvG+wfrm5+(-4@EWOT?a39i3J(fMud z%doaamh8Zr9~Utk%RLx+ZlaL!XTy>H=3cr z^tlDkmg$ILOCXLaEFjp1f~;drXNd6l^U4k(HtE%O+S*0|5bJ9YXdDoR6psUhR~e*p zR7Vh`eK)eTaTZ4Rx+QqIV=*g2R3HQyvbx^*=o>lZq0au<&P=SA?v8o{G0U$*5?K%? z7YZT%LRl#i{D%PHQC9gENY)

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> 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 c1aJ>H;&fJ5 THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/benchmark/psychichttps/platformio.ini b/lib/PsychicHttp/benchmark/psychichttps/platformio.ini new file mode 100644 index 0000000..868f0ca --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/platformio.ini @@ -0,0 +1,22 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[env] +platform = espressif32 +framework = arduino +board = esp32dev +monitor_speed = 115200 +monitor_filters = esp32_exception_decoder +lib_deps = + https://github.com/hoeken/PsychicHttp + bblanchon/ArduinoJson +board_build.filesystem = littlefs + +[env:default] diff --git a/lib/PsychicHttp/benchmark/psychichttps/src/main.cpp b/lib/PsychicHttp/benchmark/psychichttps/src/main.cpp new file mode 100644 index 0000000..2639758 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/src/main.cpp @@ -0,0 +1,240 @@ +/* Wi-Fi STA Connect and Disconnect Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. + +*/ +#include +#include +#include +#include +#include +#include "_secret.h" +#include +#include + +#ifndef WIFI_SSID + #error "You need to enter your wifi credentials. Rename secret.h to _secret.h and enter your credentials there." +#endif + +//Enter your WIFI credentials in secret.h +const char *ssid = WIFI_SSID; +const char *password = WIFI_PASS; + +PsychicHttpsServer server; +PsychicWebSocketHandler websocketHandler; + +String server_cert; +String server_key; + +const char *htmlContent = R"( + + + + Sample HTML + + +

Hello, World!

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Proin euismod, purus a euismod + rhoncus, urna ipsum cursus massa, eu dictum tellus justo ac justo. Quisque ullamcorper + arcu nec tortor ullamcorper, vel fermentum justo fermentum. Vivamus sed velit ut elit + accumsan congue ut ut enim. Ut eu justo eu lacus varius gravida ut a tellus. Nulla facilisi. + Integer auctor consectetur ultricies. Fusce feugiat, mi sit amet bibendum viverra, orci leo + dapibus elit, id varius sem dui id lacus.

+ + +)"; + +bool connectToWifi() +{ + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.setSleep(false); + + WiFi.begin(ssid, password); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + Serial.println("PsychicHTTP Benchmark"); + + if (connectToWifi()) + { + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + File fp = LittleFS.open("/server.crt"); + if (fp) { + server_cert = fp.readString(); + } else { + Serial.println("server.pem not found, SSL not available"); + return; + } + fp.close(); + + File fp2 = LittleFS.open("/server.key"); + if (fp2) { + server_key = fp2.readString(); + } else { + Serial.println("server.key not found, SSL not available"); + return; + } + fp2.close(); + + //start our server + server.listen(443, server_cert.c_str(), server_key.c_str()); + + //our index + server.on("/", HTTP_GET, [](PsychicRequest *request) + { + return request->reply(200, "text/html", htmlContent); + }); + + //serve static files from LittleFS/www on / + server.serveStatic("/", LittleFS, "/www/"); + + //a websocket echo server + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) { + request->reply(frame); + return ESP_OK; + }); + server.on("/ws", &websocketHandler); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/api", HTTP_GET, [](PsychicRequest *request) + { + //create a response object + StaticJsonDocument<128> output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + String foo = request->getParam("foo")->value(); + output["foo"] = foo; + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + return request->reply(200, "application/json", jsonBuffer.c_str()); + }); + } +} + +unsigned long last; +void loop() +{ + if (millis() - last > 1000) + { + Serial.printf("Free Heap: %d\n", esp_get_free_heap_size()); + last = millis(); + } +} \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/psychichttps/src/secret.h b/lib/PsychicHttp/benchmark/psychichttps/src/secret.h new file mode 100644 index 0000000..6d4bb15 --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/src/secret.h @@ -0,0 +1,2 @@ +#define WIFI_SSID "Your_SSID" +#define WIFI_PASS "Your_PASS" \ No newline at end of file diff --git a/lib/PsychicHttp/benchmark/psychichttps/test/README b/lib/PsychicHttp/benchmark/psychichttps/test/README new file mode 100644 index 0000000..9b1e87b --- /dev/null +++ b/lib/PsychicHttp/benchmark/psychichttps/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PlatformIO Test Runner and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PlatformIO Unit Testing: +- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html diff --git a/lib/PsychicHttp/benchmark/results/arduinomongoose-http-loadtest.log b/lib/PsychicHttp/benchmark/results/arduinomongoose-http-loadtest.log new file mode 100644 index 0000000..24a6e34 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/arduinomongoose-http-loadtest.log @@ -0,0 +1,1172 @@ + + +CLIENTS: *** 1 *** + +Running 60s test @ http://192.168.2.131/ +1 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 720 ms │ 14880 ms │ 29087 ms │ 29519 ms │ 15024.03 ms │ 8572.14 ms │ 29737 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 11 │ 11 │ 12 │ 14 │ 12.47 │ 0.87 │ 11 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 48.2 kB │ 48.2 kB │ 52.6 kB │ 61.3 kB │ 54.6 kB │ 3.79 kB │ 48.2 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 748 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.07s, 3.28 MB read +748 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +1 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 781 ms │ 15061 ms │ 29571 ms │ 30046 ms │ 15137.29 ms │ 8833.98 ms │ 30393 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 17 │ 18 │ 20 │ 23 │ 20.34 │ 1.27 │ 17 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 2.99 kB │ 3.15 kB │ 3.52 kB │ 4.03 kB │ 3.57 kB │ 220 B │ 2.99 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1220 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.06s, 214 kB read +1k errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +1 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 969 ms │ 15300 ms │ 29831 ms │ 30132 ms │ 15143.83 ms │ 8807.54 ms │ 30385 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 3 │ 4 │ 3.15 │ 0.36 │ 3 │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.1 kB │ 86.1 kB │ 86.1 kB │ 115 kB │ 90.4 kB │ 10.3 kB │ 86.1 kB │ +└───────────┴─────────┴─────────┴─────────┴────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 189 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +378 requests in 60.06s, 5.43 MB read +188 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 2 *** + +Running 60s test @ http://192.168.2.131/ +2 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 803 ms │ 14773 ms │ 29269 ms │ 29642 ms │ 14925.25 ms │ 8556.82 ms │ 29974 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬───────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼───────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 17 │ 17 │ 19 │ 21 │ 18.9 │ 0.98 │ 17 │ +├───────────┼─────────┼─────────┼─────────┼───────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 74.5 kB │ 74.5 kB │ 83.3 kB │ 92 kB │ 82.8 kB │ 4.29 kB │ 74.5 kB │ +└───────────┴─────────┴─────────┴─────────┴───────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1134 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.06s, 4.97 MB read +29 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +2 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 772 ms │ 15252 ms │ 29307 ms │ 29709 ms │ 15094.92 ms │ 8732.51 ms │ 30070 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 26 │ 27 │ 29 │ 32 │ 29.72 │ 1.43 │ 26 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 4.58 kB │ 4.75 kB │ 5.11 kB │ 5.63 kB │ 5.23 kB │ 251 B │ 4.58 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1783 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 314 kB read +1k errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +2 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 856 ms │ 15635 ms │ 28880 ms │ 29310 ms │ 15261.99 ms │ 8577.65 ms │ 29700 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 4 │ 4 │ 5 │ 6 │ 4.64 │ 0.64 │ 4 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 115 kB │ 115 kB │ 144 kB │ 172 kB │ 133 kB │ 18.1 kB │ 115 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 278 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +558 requests in 60.06s, 7.98 MB read +17 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 3 *** + +Running 60s test @ http://192.168.2.131/ +3 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 794 ms │ 15166 ms │ 29323 ms │ 29697 ms │ 15066.78 ms │ 8676.25 ms │ 30114 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 22 │ 23 │ 26 │ 29 │ 25.99 │ 1.42 │ 22 │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 96.4 kB │ 101 kB │ 114 kB │ 127 kB │ 114 kB │ 6.22 kB │ 96.4 kB │ +└───────────┴─────────┴────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1559 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 6.83 MB read +14 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +3 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 826 ms │ 14949 ms │ 29377 ms │ 29790 ms │ 15049.95 ms │ 8720.15 ms │ 30168 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 32 │ 32 │ 36 │ 39 │ 36.1 │ 1.82 │ 32 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 5.63 kB │ 5.63 kB │ 6.34 kB │ 6.87 kB │ 6.36 kB │ 319 B │ 5.63 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2166 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.1s, 381 kB read +1k errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +3 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬─────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼─────────┼──────────┤ +│ Latency │ 995 ms │ 15127 ms │ 29464 ms │ 29993 ms │ 15219.94 ms │ 8704 ms │ 30258 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴─────────┴──────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 6 │ 6 │ 5.62 │ 0.99 │ 3 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.1 kB │ 86.1 kB │ 172 kB │ 172 kB │ 161 kB │ 28.3 kB │ 86.1 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 337 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +677 requests in 60.07s, 9.67 MB read +54 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 4 *** + +Running 60s test @ http://192.168.2.131/ +4 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 702 ms │ 15255 ms │ 29811 ms │ 30226 ms │ 15144.93 ms │ 8830.16 ms │ 30616 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤ +│ Req/Sec │ 26 │ 27 │ 29 │ 32 │ 29.05 │ 1.58 │ 26 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤ +│ Bytes/Sec │ 114 kB │ 118 kB │ 127 kB │ 140 kB │ 127 kB │ 6.9 kB │ 114 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1743 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 7.63 MB read +20 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +4 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬───────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼───────────┼──────────┤ +│ Latency │ 762 ms │ 15231 ms │ 29096 ms │ 29534 ms │ 15112.66 ms │ 8660.6 ms │ 29997 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴───────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼────────┼───────┼─────────┤ +│ Req/Sec │ 35 │ 35 │ 41 │ 44 │ 40.89 │ 1.9 │ 35 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼────────┼───────┼─────────┤ +│ Bytes/Sec │ 6.16 kB │ 6.16 kB │ 7.22 kB │ 7.75 kB │ 7.2 kB │ 334 B │ 6.16 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2453 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 432 kB read +977 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +4 connections +1 workers + + +┌─────────┬─────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 1175 ms │ 15413 ms │ 29485 ms │ 30066 ms │ 15217.07 ms │ 8604.35 ms │ 30126 ms │ +└─────────┴─────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 4 │ 4 │ 8 │ 8 │ 6.47 │ 1.87 │ 4 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 115 kB │ 115 kB │ 230 kB │ 230 kB │ 186 kB │ 53.6 kB │ 115 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 388 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +780 requests in 60.05s, 11.1 MB read +39 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 5 *** + +Running 60s test @ http://192.168.2.131/ +5 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 802 ms │ 14978 ms │ 29391 ms │ 29863 ms │ 15042.57 ms │ 8642.88 ms │ 30280 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤ +│ Req/Sec │ 26 │ 29 │ 33 │ 37 │ 33.19 │ 2.13 │ 26 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤ +│ Bytes/Sec │ 114 kB │ 127 kB │ 145 kB │ 162 kB │ 145 kB │ 9.3 kB │ 114 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1991 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.07s, 8.72 MB read +10 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +5 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 724 ms │ 15356 ms │ 29304 ms │ 29791 ms │ 15198.71 ms │ 8761.23 ms │ 30174 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 40 │ 40 │ 45 │ 50 │ 44.84 │ 2.78 │ 40 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.04 kB │ 7.04 kB │ 7.92 kB │ 8.81 kB │ 7.89 kB │ 489 B │ 7.04 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2690 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 473 kB read +603 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +5 connections +1 workers + + +┌─────────┬─────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 1250 ms │ 15289 ms │ 29607 ms │ 30193 ms │ 15345.82 ms │ 8719.55 ms │ 30354 ms │ +└─────────┴─────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 10 │ 7.25 │ 2.25 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 172 kB │ 287 kB │ 208 kB │ 64.5 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 435 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +875 requests in 60.06s, 12.5 MB read +36 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 6 *** + +Running 60s test @ http://192.168.2.131/ +6 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 847 ms │ 14920 ms │ 28899 ms │ 29392 ms │ 15008.54 ms │ 8456.33 ms │ 29870 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 33 │ 33 │ 36 │ 39 │ 35.75 │ 1.75 │ 33 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 145 kB │ 145 kB │ 158 kB │ 171 kB │ 157 kB │ 7.65 kB │ 145 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2145 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 9.4 MB read +3 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +6 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 890 ms │ 14807 ms │ 29142 ms │ 29732 ms │ 14934.33 ms │ 8513.39 ms │ 30168 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 44 │ 44 │ 48 │ 53 │ 48.3 │ 2.22 │ 44 │ +├───────────┼─────────┼─────────┼────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.75 kB │ 7.75 kB │ 8.5 kB │ 9.38 kB │ 8.54 kB │ 395 B │ 7.74 kB │ +└───────────┴─────────┴─────────┴────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2898 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +6k requests in 60.07s, 512 kB read +386 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +6 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 853 ms │ 15325 ms │ 29742 ms │ 30578 ms │ 15287.1 ms │ 8714.92 ms │ 30650 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 6 │ 6 │ 6 │ 12 │ 7.7 │ 2.44 │ 6 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 172 kB │ 172 kB │ 172 kB │ 345 kB │ 221 kB │ 70 kB │ 172 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 462 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +930 requests in 60.06s, 13.3 MB read +24 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 7 *** + +Running 60s test @ http://192.168.2.131/ +7 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 785 ms │ 15141 ms │ 29506 ms │ 29981 ms │ 15124.91 ms │ 8769.84 ms │ 30379 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤ +│ Req/Sec │ 32 │ 33 │ 37 │ 40 │ 36.64 │ 2.04 │ 32 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼────────┼────────┤ +│ Bytes/Sec │ 140 kB │ 145 kB │ 162 kB │ 175 kB │ 160 kB │ 8.9 kB │ 140 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2198 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 9.63 MB read +1 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +7 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 773 ms │ 15322 ms │ 29472 ms │ 29911 ms │ 15145.75 ms │ 8792.14 ms │ 30238 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 45 │ 45 │ 51 │ 56 │ 50.62 │ 3.07 │ 45 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.97 kB │ 7.97 kB │ 9.03 kB │ 9.92 kB │ 8.96 kB │ 541 B │ 7.96 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3037 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +6k requests in 60.06s, 538 kB read +252 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +7 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 903 ms │ 15426 ms │ 29337 ms │ 30187 ms │ 15395.14 ms │ 8592.24 ms │ 30239 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 7 │ 7 │ 7 │ 14 │ 8.06 │ 2.03 │ 7 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 201 kB │ 201 kB │ 201 kB │ 402 kB │ 231 kB │ 58 kB │ 201 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 483 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +973 requests in 60.06s, 13.9 MB read +27 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 8 *** + +Running 60s test @ http://192.168.2.131/ +8 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 947 ms │ 15230 ms │ 29194 ms │ 29710 ms │ 15139.81 ms │ 8698.37 ms │ 30418 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 31 │ 33 │ 38 │ 43 │ 37.92 │ 2.7 │ 31 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 136 kB │ 145 kB │ 167 kB │ 188 kB │ 166 kB │ 11.8 kB │ 136 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2275 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 9.96 MB read +1 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +8 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 818 ms │ 15102 ms │ 29043 ms │ 29502 ms │ 14999.69 ms │ 8454.75 ms │ 30295 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 44 │ 45 │ 51 │ 60 │ 51.37 │ 3.35 │ 44 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.79 kB │ 7.97 kB │ 9.03 kB │ 10.6 kB │ 9.09 kB │ 591 B │ 7.79 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3082 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +6k requests in 60s, 546 kB read +222 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +8 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 951 ms │ 15565 ms │ 30182 ms │ 30252 ms │ 15396.59 ms │ 8860.08 ms │ 31138 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 7 │ 8 │ 8 │ 14 │ 8.56 │ 1.59 │ 7 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 201 kB │ 230 kB │ 230 kB │ 402 kB │ 245 kB │ 45.5 kB │ 201 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 513 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.06s, 14.7 MB read +31 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 9 *** + +Running 60s test @ http://192.168.2.131/ +9 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬───────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼───────────┼──────────┤ +│ Latency │ 951 ms │ 15246 ms │ 28914 ms │ 29402 ms │ 15108.58 ms │ 8543.6 ms │ 30524 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴───────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 31 │ 32 │ 37 │ 43 │ 37.42 │ 2.9 │ 31 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 136 kB │ 140 kB │ 162 kB │ 188 kB │ 164 kB │ 12.7 kB │ 136 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2245 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.05s, 9.83 MB read +1 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +9 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 885 ms │ 15043 ms │ 29217 ms │ 29730 ms │ 14953.4 ms │ 8530.16 ms │ 30399 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 44 │ 46 │ 52 │ 58 │ 52.1 │ 3.22 │ 44 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.79 kB │ 8.14 kB │ 9.21 kB │ 10.3 kB │ 9.22 kB │ 570 B │ 7.79 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3126 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +6k requests in 60.07s, 553 kB read +189 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +9 connections +1 workers + + +┌─────────┬─────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 1079 ms │ 15444 ms │ 28978 ms │ 29935 ms │ 15389.63 ms │ 8469.15 ms │ 30003 ms │ +└─────────┴─────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 9 │ 10 │ 8.56 │ 2.21 │ 1 │ +├───────────┼─────┼──────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 258 kB │ 287 kB │ 245 kB │ 63.4 kB │ 28.7 kB │ +└───────────┴─────┴──────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 513 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.06s, 14.7 MB read +20 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 10 *** + +Running 60s test @ http://192.168.2.131/ +10 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 996 ms │ 15183 ms │ 29343 ms │ 29946 ms │ 15135.07 ms │ 8665.13 ms │ 30794 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 32 │ 32 │ 37 │ 43 │ 37.59 │ 2.43 │ 32 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 140 kB │ 140 kB │ 162 kB │ 188 kB │ 165 kB │ 10.6 kB │ 140 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2255 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 9.88 MB read +5 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +10 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 876 ms │ 15390 ms │ 29322 ms │ 29837 ms │ 15193.95 ms │ 8726.45 ms │ 30887 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 46 │ 47 │ 52 │ 60 │ 52.42 │ 3.63 │ 46 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 8.14 kB │ 8.32 kB │ 9.21 kB │ 10.6 kB │ 9.28 kB │ 642 B │ 8.14 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3145 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +6k requests in 60.07s, 557 kB read +193 errors (0 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +10 connections +1 workers + + +┌─────────┬─────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 1126 ms │ 15812 ms │ 30288 ms │ 31239 ms │ 15913.56 ms │ 8747.22 ms │ 32439 ms │ +└─────────┴─────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────┬─────────┬────────┬────────┬────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼─────────┼────────┼────────┼────────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 2 │ 10 │ 10 │ 8.84 │ 2.37 │ 2 │ +├───────────┼─────┼─────────┼────────┼────────┼────────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 57.4 kB │ 287 kB │ 287 kB │ 254 kB │ 68 kB │ 57.4 kB │ +└───────────┴─────┴─────────┴────────┴────────┴────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 530 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.06s, 15.2 MB read +42 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 15 *** + +Running 60s test @ http://192.168.2.131/ +15 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +15 connections +1 workers + + +┌─────────┬────────┬──────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼──────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 690 ms │ 12131 ms │ 28685 ms │ 29798 ms │ 13051.88 ms │ 8385.32 ms │ 32739 ms │ +└─────────┴────────┴──────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 46 │ 50 │ 56 │ 63 │ 55.99 │ 3.53 │ 46 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 8.14 kB │ 8.86 kB │ 9.92 kB │ 11.2 kB │ 9.91 kB │ 624 B │ 8.14 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3359 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +7k requests in 60.06s, 595 kB read +269 errors (5 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +15 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + + + +CLIENTS: *** 20 *** + +Running 60s test @ http://192.168.2.131/ +20 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +20 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 377 ms │ 5749 ms │ 19598 ms │ 21657 ms │ 6953.55 ms │ 5299.16 ms │ 23969 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 45 │ 45 │ 55 │ 60 │ 54.27 │ 3.9 │ 45 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.88 kB │ 7.88 kB │ 9.63 kB │ 10.6 kB │ 9.53 kB │ 687 B │ 7.88 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3256 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +7k requests in 60.06s, 571 kB read +312 errors (30 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +20 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + diff --git a/lib/PsychicHttp/benchmark/results/arduinomongoose-websocket-loadtest.log b/lib/PsychicHttp/benchmark/results/arduinomongoose-websocket-loadtest.log new file mode 100644 index 0000000..8c18045 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/arduinomongoose-websocket-loadtest.log @@ -0,0 +1,246 @@ + + +CLIENTS: *** 1 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 1 +Agent: none + +Completed requests: 3750 +Total errors: 0 +Total time: 60.001 s +Mean latency: 15.5 ms +Effective rps: 62 + +Percentage of requests served within a certain time + 50% 12 ms + 90% 18 ms + 95% 36 ms + 99% 80 ms + 100% 223 ms (longest request) + + +CLIENTS: *** 2 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 2 +Agent: none + +Completed requests: 5795 +Total errors: 0 +Total time: 60.004 s +Mean latency: 20.2 ms +Effective rps: 97 + +Percentage of requests served within a certain time + 50% 16 ms + 90% 27 ms + 95% 64 ms + 99% 86 ms + 100% 108 ms (longest request) + + +CLIENTS: *** 3 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 3 +Agent: none + +Completed requests: 7445 +Total errors: 0 +Total time: 60.003 s +Mean latency: 23.6 ms +Effective rps: 124 + +Percentage of requests served within a certain time + 50% 19 ms + 90% 32 ms + 95% 70 ms + 99% 92 ms + 100% 121 ms (longest request) + + +CLIENTS: *** 4 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 4 +Agent: none + +Completed requests: 8751 +Total errors: 0 +Total time: 60.005 s +Mean latency: 26.9 ms +Effective rps: 146 + +Percentage of requests served within a certain time + 50% 22 ms + 90% 38 ms + 95% 73 ms + 99% 95 ms + 100% 115 ms (longest request) + + +CLIENTS: *** 5 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 5 +Agent: none + +Completed requests: 9953 +Total errors: 0 +Total time: 60.004 s +Mean latency: 29.6 ms +Effective rps: 166 + +Percentage of requests served within a certain time + 50% 25 ms + 90% 42 ms + 95% 74 ms + 99% 93 ms + 100% 116 ms (longest request) + + +CLIENTS: *** 6 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 6 +Agent: none + +Completed requests: 10871 +Total errors: 0 +Total time: 60.005 s +Mean latency: 32.6 ms +Effective rps: 181 + +Percentage of requests served within a certain time + 50% 27 ms + 90% 50 ms + 95% 82 ms + 99% 100 ms + 100% 116 ms (longest request) + + +CLIENTS: *** 7 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 7 +Agent: none + +Completed requests: 11777 +Total errors: 0 +Total time: 60.003 s +Mean latency: 35.1 ms +Effective rps: 196 + +Percentage of requests served within a certain time + 50% 30 ms + 90% 66 ms + 95% 83 ms + 99% 101 ms + 100% 137 ms (longest request) + + +CLIENTS: *** 8 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 8 +Running on cores: 2 +Agent: none + +Completed requests: 11639 +Total errors: 0 +Total time: 60.004 s +Mean latency: 35.4 ms +Effective rps: 194 + +Percentage of requests served within a certain time + 50% 30 ms + 90% 67 ms + 95% 86 ms + 99% 106 ms + 100% 135 ms (longest request) + + +CLIENTS: *** 10 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 10 +Running on cores: 2 +Agent: none + +Completed requests: 11619 +Total errors: 0 +Total time: 60.004 s +Mean latency: 35.6 ms +Effective rps: 194 + +Percentage of requests served within a certain time + 50% 30 ms + 90% 71 ms + 95% 87 ms + 99% 105 ms + 100% 125 ms (longest request) + + +CLIENTS: *** 16 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 16 +Running on cores: 2 +Agent: none + +Completed requests: 15314 +Total errors: 0 +Total time: 60.005 s +Mean latency: 54.2 ms +Effective rps: 255 + +Percentage of requests served within a certain time + 50% 46 ms + 90% 91 ms + 95% 105 ms + 99% 127 ms + 100% 826 ms (longest request) + + +CLIENTS: *** 20 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 20 +Running on cores: 2 +Agent: none + +Completed requests: 15370 +Total errors: 0 +Total time: 60.005 s +Mean latency: 57.7 ms +Effective rps: 256 + +Percentage of requests served within a certain time + 50% 48 ms + 90% 96 ms + 95% 110 ms + 99% 132 ms + 100% 851 ms (longest request) diff --git a/lib/PsychicHttp/benchmark/results/espasync-http-loadtest.log b/lib/PsychicHttp/benchmark/results/espasync-http-loadtest.log new file mode 100644 index 0000000..cafa123 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/espasync-http-loadtest.log @@ -0,0 +1,1165 @@ + + +CLIENTS: *** 1 *** + +Running 60s test @ http://192.168.2.131/ +1 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 32 ms │ 40 ms │ 118 ms │ 118 ms │ 54.67 ms │ 29.29 ms │ 118 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.1 │ 0.31 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 4.38 kB │ 438 B │ 1.31 kB │ 4.38 kB │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 6 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +12 requests in 60.08s, 26.3 kB read +5 errors (5 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +1 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 61 ms │ 64 ms │ 131 ms │ 131 ms │ 93.84 ms │ 31.05 ms │ 131 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬───────┬────────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼───────┼────────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.1 │ 0.31 │ 1 │ +├───────────┼─────┼──────┼─────┼───────┼────────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 174 B │ 17.4 B │ 52.2 B │ 174 B │ +└───────────┴─────┴──────┴─────┴───────┴────────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 6 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +12 requests in 60.08s, 1.04 kB read +5 errors (5 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +1 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 135 ms │ 142 ms │ 162 ms │ 162 ms │ 145.84 ms │ 10.32 ms │ 162 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.1 │ 0.31 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 28.8 kB │ 2.88 kB │ 8.63 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 6 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +12 requests in 60.07s, 173 kB read +5 errors (5 timeouts) + + +---------------- + + + +CLIENTS: *** 2 *** + +Running 60s test @ http://192.168.2.131/ +2 connections +1 workers + + +┌─────────┬───────┬───────┬───────┬───────┬──────────┬──────────┬───────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼───────┼───────┼──────────┼──────────┼───────┤ +│ Latency │ 29 ms │ 52 ms │ 93 ms │ 93 ms │ 56.09 ms │ 17.92 ms │ 93 ms │ +└─────────┴───────┴───────┴───────┴───────┴──────────┴──────────┴───────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 2 │ 0.2 │ 0.61 │ 2 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 8.76 kB │ 876 B │ 2.63 kB │ 8.76 kB │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 12 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +24 requests in 60.08s, 52.5 kB read +10 errors (10 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +2 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 60 ms │ 106 ms │ 126 ms │ 126 ms │ 102.5 ms │ 21.86 ms │ 126 ms │ +└─────────┴───────┴────────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬───────┬────────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼───────┼────────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 2 │ 0.2 │ 0.61 │ 2 │ +├───────────┼─────┼──────┼─────┼───────┼────────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 348 B │ 34.8 B │ 104 B │ 348 B │ +└───────────┴─────┴──────┴─────┴───────┴────────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 12 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +24 requests in 60.08s, 2.09 kB read +10 errors (10 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +2 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 228 ms │ 245 ms │ 268 ms │ 268 ms │ 245.34 ms │ 13.38 ms │ 268 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 2 │ 0.2 │ 0.61 │ 2 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 57.5 kB │ 5.75 kB │ 17.3 kB │ 57.5 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 12 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +24 requests in 60.07s, 345 kB read +10 errors (10 timeouts) + + +---------------- + + + +CLIENTS: *** 3 *** + +Running 60s test @ http://192.168.2.131/ +3 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 40 ms │ 97 ms │ 133 ms │ 133 ms │ 95.45 ms │ 30.82 ms │ 133 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 3 │ 0.3 │ 0.91 │ 3 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 13.1 kB │ 1.31 kB │ 3.94 kB │ 13.1 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 18 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +36 requests in 60.08s, 78.8 kB read +15 errors (15 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +3 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 55 ms │ 66 ms │ 211 ms │ 211 ms │ 82.78 ms │ 37.03 ms │ 211 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬───────┬────────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼───────┼────────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 3 │ 0.3 │ 0.91 │ 3 │ +├───────────┼─────┼──────┼─────┼───────┼────────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 522 B │ 52.2 B │ 157 B │ 522 B │ +└───────────┴─────┴──────┴─────┴───────┴────────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 18 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +36 requests in 60.1s, 3.13 kB read +15 errors (15 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +3 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 215 ms │ 278 ms │ 348 ms │ 348 ms │ 280.56 ms │ 30.51 ms │ 348 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 3 │ 0.3 │ 0.91 │ 3 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 86.3 kB │ 8.62 kB │ 25.9 kB │ 86.3 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 18 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +36 requests in 60.15s, 518 kB read +15 errors (15 timeouts) + + +---------------- + + + +CLIENTS: *** 4 *** + +Running 60s test @ http://192.168.2.131/ +4 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 29 ms │ 76 ms │ 137 ms │ 137 ms │ 86.55 ms │ 35.16 ms │ 137 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 4 │ 0.4 │ 1.21 │ 4 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 17.5 kB │ 1.75 kB │ 5.25 kB │ 17.5 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 24 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +48 requests in 60.13s, 105 kB read +20 errors (20 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +4 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬───────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼───────────┼────────┤ +│ Latency │ 54 ms │ 108 ms │ 523 ms │ 523 ms │ 164.71 ms │ 130.96 ms │ 523 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴───────────┴────────┘ +┌───────────┬─────┬──────┬─────┬───────┬────────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼───────┼────────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 4 │ 0.4 │ 1.21 │ 4 │ +├───────────┼─────┼──────┼─────┼───────┼────────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 696 B │ 69.6 B │ 209 B │ 696 B │ +└───────────┴─────┴──────┴─────┴───────┴────────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 24 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +48 requests in 60.09s, 4.18 kB read +20 errors (20 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +4 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬─────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼─────────┼────────┤ +│ Latency │ 322 ms │ 379 ms │ 405 ms │ 405 ms │ 372.55 ms │ 20.5 ms │ 405 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴─────────┴────────┘ +┌───────────┬─────┬──────┬─────┬────────┬─────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 4 │ 0.4 │ 1.21 │ 4 │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 115 kB │ 11.5 kB │ 34.5 kB │ 115 kB │ +└───────────┴─────┴──────┴─────┴────────┴─────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 24 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +48 requests in 60.08s, 690 kB read +20 errors (20 timeouts) + + +---------------- + + + +CLIENTS: *** 5 *** + +Running 60s test @ http://192.168.2.131/ +5 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬─────────┬─────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼─────────┼─────────┼────────┤ +│ Latency │ 36 ms │ 104 ms │ 148 ms │ 148 ms │ 94.7 ms │ 35.9 ms │ 148 ms │ +└─────────┴───────┴────────┴────────┴────────┴─────────┴─────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 5 │ 0.5 │ 1.5 │ 5 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 21.9 kB │ 2.19 kB │ 6.57 kB │ 21.9 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 30 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +60 requests in 60.05s, 131 kB read +25 errors (25 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +5 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 66 ms │ 123 ms │ 263 ms │ 263 ms │ 127.67 ms │ 37.33 ms │ 263 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬───────┬──────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼───────┼──────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 5 │ 0.5 │ 1.5 │ 5 │ +├───────────┼─────┼──────┼─────┼───────┼──────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 870 B │ 87 B │ 261 B │ 870 B │ +└───────────┴─────┴──────┴─────┴───────┴──────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 30 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +60 requests in 60.07s, 5.22 kB read +25 errors (25 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +5 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 348 ms │ 398 ms │ 465 ms │ 465 ms │ 399.27 ms │ 31.99 ms │ 465 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬────────┬─────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 5 │ 0.5 │ 1.5 │ 5 │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 144 kB │ 14.4 kB │ 43.1 kB │ 144 kB │ +└───────────┴─────┴──────┴─────┴────────┴─────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 30 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +60 requests in 60.08s, 863 kB read +25 errors (25 timeouts) + + +---------------- + + + +CLIENTS: *** 6 *** + +Running 60s test @ http://192.168.2.131/ +6 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 34 ms │ 111 ms │ 188 ms │ 188 ms │ 113.25 ms │ 41.29 ms │ 188 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 6 │ 0.6 │ 1.81 │ 6 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 26.3 kB │ 2.63 kB │ 7.88 kB │ 26.3 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +72 requests in 60.07s, 158 kB read +30 errors (30 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +6 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 61 ms │ 121 ms │ 296 ms │ 296 ms │ 134.95 ms │ 46.95 ms │ 296 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 6 │ 0.6 │ 1.81 │ 6 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 1.05 kB │ 105 B │ 315 B │ 1.05 kB │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +72 requests in 60.09s, 6.3 kB read +30 errors (30 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +6 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 322 ms │ 422 ms │ 522 ms │ 522 ms │ 422.98 ms │ 51.58 ms │ 522 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬────────┬─────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 6 │ 0.6 │ 1.81 │ 6 │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 173 kB │ 17.2 kB │ 51.7 kB │ 173 kB │ +└───────────┴─────┴──────┴─────┴────────┴─────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +72 requests in 60.08s, 1.04 MB read +30 errors (30 timeouts) + + +---------------- + + + +CLIENTS: *** 7 *** + +Running 60s test @ http://192.168.2.131/ +7 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 60 ms │ 129 ms │ 220 ms │ 280 ms │ 127.81 ms │ 51.08 ms │ 280 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 7 │ 0.7 │ 2.1 │ 7 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 30.7 kB │ 3.06 kB │ 9.19 kB │ 30.6 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 42 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +84 requests in 60.08s, 184 kB read +35 errors (35 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +7 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 63 ms │ 125 ms │ 252 ms │ 289 ms │ 126.22 ms │ 46.41 ms │ 289 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 7 │ 0.7 │ 2.1 │ 7 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 1.23 kB │ 123 B │ 368 B │ 1.23 kB │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 42 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +84 requests in 60.07s, 7.35 kB read +35 errors (35 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +7 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬──────────┬───────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼──────────┼───────────┼────────┤ +│ Latency │ 144 ms │ 439 ms │ 877 ms │ 921 ms │ 439.3 ms │ 138.35 ms │ 921 ms │ +└─────────┴────────┴────────┴────────┴────────┴──────────┴───────────┴────────┘ +┌───────────┬─────┬──────┬─────┬────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 7 │ 0.69 │ 1.87 │ 1 │ +├───────────┼─────┼──────┼─────┼────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 201 kB │ 19.6 kB │ 53.7 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 41 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +83 requests in 60.07s, 1.18 MB read +35 errors (35 timeouts) + + +---------------- + + + +CLIENTS: *** 8 *** + +Running 60s test @ http://192.168.2.131/ +8 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼────────┼──────────┼────────┤ +│ Latency │ 74 ms │ 141 ms │ 193 ms │ 198 ms │ 143 ms │ 31.11 ms │ 198 ms │ +└─────────┴───────┴────────┴────────┴────────┴────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬───────┬────────┬─────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼───────┼────────┼─────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 8 │ 0.8 │ 2.41 │ 8 │ +├───────────┼─────┼──────┼─────┼───────┼────────┼─────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 35 kB │ 3.5 kB │ 10.5 kB │ 35 kB │ +└───────────┴─────┴──────┴─────┴───────┴────────┴─────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 48 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +96 requests in 60.08s, 210 kB read +40 errors (40 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +8 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 59 ms │ 138 ms │ 284 ms │ 319 ms │ 139.8 ms │ 53.96 ms │ 319 ms │ +└─────────┴───────┴────────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬────────┬───────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼────────┼───────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 8 │ 0.8 │ 2.36 │ 1 │ +├───────────┼─────┼──────┼─────┼────────┼───────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 1.4 kB │ 140 B │ 411 B │ 175 B │ +└───────────┴─────┴──────┴─────┴────────┴───────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 48 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +96 requests in 60.07s, 8.4 kB read +40 errors (40 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +8 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + + + +CLIENTS: *** 9 *** + +Running 60s test @ http://192.168.2.131/ +9 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 31 ms │ 116 ms │ 206 ms │ 210 ms │ 109.58 ms │ 45.11 ms │ 210 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 9 │ 0.9 │ 2.7 │ 9 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 39.4 kB │ 3.94 kB │ 11.8 kB │ 39.4 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 54 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +108 requests in 60.08s, 236 kB read +45 errors (45 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +9 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 66 ms │ 131 ms │ 313 ms │ 349 ms │ 139.95 ms │ 60.66 ms │ 349 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 9 │ 0.9 │ 2.7 │ 9 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 1.57 kB │ 158 B │ 473 B │ 1.57 kB │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 54 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +108 requests in 60.08s, 9.45 kB read +45 errors (45 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +9 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + + + +CLIENTS: *** 10 *** + +Running 60s test @ http://192.168.2.131/ +10 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 35 ms │ 96 ms │ 264 ms │ 267 ms │ 103.97 ms │ 54.56 ms │ 267 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 10 │ 1 │ 3 │ 10 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 43.8 kB │ 4.38 kB │ 13.1 kB │ 43.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 60 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +120 requests in 60.08s, 263 kB read +50 errors (50 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +10 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 64 ms │ 144 ms │ 411 ms │ 437 ms │ 156.64 ms │ 80.67 ms │ 437 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 10 │ 1 │ 2.83 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 1.75 kB │ 175 B │ 495 B │ 175 B │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 60 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +120 requests in 60.08s, 10.5 kB read +50 errors (50 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +10 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + + + +CLIENTS: *** 15 *** + +Running 60s test @ http://192.168.2.131/ +15 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬──────────┬─────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼──────────┼─────────┼────────┤ +│ Latency │ 29 ms │ 104 ms │ 359 ms │ 362 ms │ 121.5 ms │ 77.5 ms │ 362 ms │ +└─────────┴───────┴────────┴────────┴────────┴──────────┴─────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 14 │ 1.34 │ 4.02 │ 12 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 52.6 kB │ 5.12 kB │ 15.4 kB │ 48.3 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 80 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +170 requests in 60.09s, 307 kB read +75 errors (75 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +15 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬───────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼───────────┼────────┤ +│ Latency │ 91 ms │ 148 ms │ 505 ms │ 574 ms │ 174.38 ms │ 100.31 ms │ 574 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴───────────┴────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 15 │ 1.5 │ 4.06 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 2.63 kB │ 263 B │ 710 B │ 175 B │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 90 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +180 requests in 60.08s, 15.8 kB read +75 errors (75 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +15 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + + + +CLIENTS: *** 20 *** + +Running 60s test @ http://192.168.2.131/ +20 connections +1 workers + + +┌─────────┬───────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤ +│ Latency │ 62 ms │ 1134 ms │ 6942 ms │ 6976 ms │ 1884.35 ms │ 1805.12 ms │ 6976 ms │ +└─────────┴───────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 15 │ 1.44 │ 4.15 │ 4 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 57.2 kB │ 4.42 kB │ 14.2 kB │ 5.82 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 86 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +211 requests in 60.08s, 265 kB read +105 errors (100 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +20 connections +1 workers + + +┌─────────┬───────┬────────┬─────────┬─────────┬───────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼─────────┼─────────┼───────────┼────────────┼─────────┤ +│ Latency │ 62 ms │ 232 ms │ 4030 ms │ 6972 ms │ 586.75 ms │ 1218.03 ms │ 6972 ms │ +└─────────┴───────┴────────┴─────────┴─────────┴───────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬───────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 11 │ 1.39 │ 3.08 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼───────┼───────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 1.89 kB │ 238 B │ 529 B │ 172 B │ +└───────────┴─────┴──────┴─────┴─────────┴───────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 83 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +203 requests in 60.09s, 14.3 kB read +100 errors (100 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +20 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + diff --git a/lib/PsychicHttp/benchmark/results/espasync-websocket-loadtest.log b/lib/PsychicHttp/benchmark/results/espasync-websocket-loadtest.log new file mode 100644 index 0000000..acc21d1 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/espasync-websocket-loadtest.log @@ -0,0 +1,252 @@ + + +CLIENTS: *** 1 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 1 +Agent: none + +Completed requests: 4231 +Total errors: 0 +Total time: 60.002 s +Mean latency: 13.6 ms +Effective rps: 71 + +Percentage of requests served within a certain time + 50% 10 ms + 90% 16 ms + 95% 24 ms + 99% 81 ms + 100% 280 ms (longest request) + + +CLIENTS: *** 2 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 2 +Agent: none + +Completed requests: 5914 +Total errors: 0 +Total time: 60.001 s +Mean latency: 19.7 ms +Effective rps: 99 + +Percentage of requests served within a certain time + 50% 15 ms + 90% 26 ms + 95% 67 ms + 99% 86 ms + 100% 109 ms (longest request) + + +CLIENTS: *** 3 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 3 +Agent: none + +Completed requests: 8204 +Total errors: 0 +Total time: 60.003 s +Mean latency: 21.4 ms +Effective rps: 137 + +Percentage of requests served within a certain time + 50% 17 ms + 90% 29 ms + 95% 68 ms + 99% 87 ms + 100% 104 ms (longest request) + + +CLIENTS: *** 4 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 4 +Agent: none + +Completed requests: 9634 +Total errors: 0 +Total time: 60.004 s +Mean latency: 24.4 ms +Effective rps: 161 + +Percentage of requests served within a certain time + 50% 19 ms + 90% 33 ms + 95% 73 ms + 99% 91 ms + 100% 145 ms (longest request) + + +CLIENTS: *** 5 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 5 +Agent: none + +Completed requests: 10759 +Total errors: 0 +Total time: 60.003 s +Mean latency: 27.3 ms +Effective rps: 179 + +Percentage of requests served within a certain time + 50% 22 ms + 90% 39 ms + 95% 76 ms + 99% 95 ms + 100% 117 ms (longest request) + + +CLIENTS: *** 6 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 6 +Agent: none + +Completed requests: 11302 +Total errors: 0 +Total time: 60.004 s +Mean latency: 31.3 ms +Effective rps: 188 + +Percentage of requests served within a certain time + 50% 26 ms + 90% 58 ms + 95% 81 ms + 99% 100 ms + 100% 122 ms (longest request) + + +CLIENTS: *** 7 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 7 +Agent: none + +Completed requests: 12713 +Total errors: 0 +Total time: 60.003 s +Mean latency: 32.5 ms +Effective rps: 212 + +Percentage of requests served within a certain time + 50% 27 ms + 90% 52 ms + 95% 81 ms + 99% 99 ms + 100% 125 ms (longest request) + + +CLIENTS: *** 8 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 8 +Running on cores: 2 +Agent: none + +Completed requests: 13157 +Total errors: 0 +Total time: 60.003 s +Mean latency: 35.9 ms +Effective rps: 219 + +Percentage of requests served within a certain time + 50% 30 ms + 90% 71 ms + 95% 88 ms + 99% 107 ms + 100% 132 ms (longest request) + + +CLIENTS: *** 10 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 10 +Running on cores: 2 +Agent: none + +Completed requests: 13417 +Total errors: 2 +Total time: 60.001 s +Mean latency: 34.4 ms +Effective rps: 224 + +Percentage of requests served within a certain time + 50% 30 ms + 90% 53 ms + 95% 81 ms + 99% 101 ms + 100% 124 ms (longest request) + + -1: 2 errors + + +CLIENTS: *** 16 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 16 +Running on cores: 2 +Agent: none + +Completed requests: 12804 +Total errors: 7 +Total time: 60.001 s +Mean latency: 36.4 ms +Effective rps: 213 + +Percentage of requests served within a certain time + 50% 30 ms + 90% 70 ms + 95% 86 ms + 99% 106 ms + 100% 135 ms (longest request) + + -1: 7 errors + + +CLIENTS: *** 20 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 20 +Running on cores: 2 +Agent: none + +Completed requests: 8421 +Total errors: 13 +Total time: 60.003 s +Mean latency: 37.2 ms +Effective rps: 140 + +Percentage of requests served within a certain time + 50% 20 ms + 90% 50 ms + 95% 77 ms + 99% 105 ms + 100% 9227 ms (longest request) + + -1: 13 errors diff --git a/lib/PsychicHttp/benchmark/results/psychic-http-loadtest.log b/lib/PsychicHttp/benchmark/results/psychic-http-loadtest.log new file mode 100644 index 0000000..148d378 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/psychic-http-loadtest.log @@ -0,0 +1,1172 @@ + + +CLIENTS: *** 1 *** + +Running 60s test @ http://192.168.2.131/ +1 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 24 ms │ 31 ms │ 100 ms │ 134 ms │ 39.16 ms │ 22.82 ms │ 270 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 18 │ 21 │ 25 │ 30 │ 25.19 │ 2.28 │ 18 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 78.1 kB │ 91.1 kB │ 108 kB │ 130 kB │ 109 kB │ 9.88 kB │ 78.1 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1511 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.05s, 6.55 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +1 connections +1 workers + + +┌─────────┬───────┬───────┬───────┬───────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼───────┼───────┼──────────┼──────────┼────────┤ +│ Latency │ 19 ms │ 25 ms │ 91 ms │ 99 ms │ 31.42 ms │ 18.78 ms │ 116 ms │ +└─────────┴───────┴───────┴───────┴───────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 26 │ 28 │ 31 │ 34 │ 31.29 │ 1.79 │ 26 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 3.46 kB │ 3.73 kB │ 4.16 kB │ 4.56 kB │ 4.19 kB │ 241 B │ 3.46 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1877 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.06s, 251 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +1 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 141 ms │ 201 ms │ 317 ms │ 331 ms │ 206.85 ms │ 51.73 ms │ 366 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 4 │ 4 │ 5 │ 6 │ 4.82 │ 0.62 │ 4 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 115 kB │ 115 kB │ 144 kB │ 173 kB │ 139 kB │ 17.8 kB │ 115 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 289 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +290 requests in 60.07s, 8.32 MB read + + +---------------- + + + +CLIENTS: *** 2 *** + +Running 60s test @ http://192.168.2.131/ +2 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 26 ms │ 41 ms │ 167 ms │ 203 ms │ 55.52 ms │ 37.23 ms │ 373 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 29 │ 31 │ 35 │ 40 │ 35.64 │ 2.36 │ 29 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 126 kB │ 135 kB │ 152 kB │ 174 kB │ 155 kB │ 10.2 kB │ 126 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2138 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.06s, 9.27 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +2 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 25 ms │ 35 ms │ 103 ms │ 112 ms │ 43.19 ms │ 21.44 ms │ 142 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 40 │ 40 │ 46 │ 50 │ 45.7 │ 2.76 │ 40 │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 5.36 kB │ 5.36 kB │ 6.17 kB │ 6.7 kB │ 6.12 kB │ 370 B │ 5.36 kB │ +└───────────┴─────────┴─────────┴─────────┴────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2742 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 367 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +2 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 188 ms │ 322 ms │ 475 ms │ 507 ms │ 324.51 ms │ 70.51 ms │ 535 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.15 │ 0.63 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 177 kB │ 18 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 369 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +371 requests in 60.06s, 10.6 MB read + + +---------------- + + + +CLIENTS: *** 3 *** + +Running 60s test @ http://192.168.2.131/ +3 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 31 ms │ 54 ms │ 185 ms │ 212 ms │ 68.63 ms │ 39.36 ms │ 386 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 38 │ 39 │ 43 │ 47 │ 43.32 │ 2.31 │ 38 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 165 kB │ 169 kB │ 187 kB │ 204 kB │ 188 kB │ 10 kB │ 165 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2599 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 11.3 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +3 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 29 ms │ 42 ms │ 116 ms │ 126 ms │ 51.59 ms │ 23.91 ms │ 175 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 40 │ 51 │ 58 │ 64 │ 57.59 │ 4.25 │ 40 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 5.36 kB │ 6.83 kB │ 7.78 kB │ 8.58 kB │ 7.72 kB │ 569 B │ 5.36 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3455 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 463 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +3 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬───────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼───────────┼────────┤ +│ Latency │ 203 ms │ 458 ms │ 761 ms │ 814 ms │ 474.54 ms │ 168.16 ms │ 902 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴───────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 4 │ 5 │ 6 │ 7 │ 6.29 │ 0.67 │ 4 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 115 kB │ 144 kB │ 173 kB │ 201 kB │ 181 kB │ 19 kB │ 115 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 377 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +380 requests in 60.06s, 10.9 MB read + + +---------------- + + + +CLIENTS: *** 4 *** + +Running 60s test @ http://192.168.2.131/ +4 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 37 ms │ 63 ms │ 206 ms │ 239 ms │ 81.32 ms │ 45.45 ms │ 396 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 42 │ 44 │ 49 │ 56 │ 48.87 │ 3.01 │ 42 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 182 kB │ 191 kB │ 213 kB │ 243 kB │ 212 kB │ 13 kB │ 182 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2932 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.05s, 12.7 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +4 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 33 ms │ 50 ms │ 123 ms │ 131 ms │ 58.29 ms │ 23.99 ms │ 159 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 59 │ 59 │ 68 │ 78 │ 68 │ 4.3 │ 59 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 7.91 kB │ 7.91 kB │ 9.12 kB │ 10.5 kB │ 9.11 kB │ 576 B │ 7.91 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4080 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.05s, 547 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +4 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬───────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼───────────┼───────────┼─────────┤ +│ Latency │ 326 ms │ 534 ms │ 1064 ms │ 1141 ms │ 635.61 ms │ 238.71 ms │ 1210 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴───────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.27 │ 0.63 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 180 kB │ 18.1 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 376 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +380 requests in 60.05s, 10.8 MB read + + +---------------- + + + +CLIENTS: *** 5 *** + +Running 60s test @ http://192.168.2.131/ +5 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 44 ms │ 74 ms │ 222 ms │ 261 ms │ 91.54 ms │ 47.88 ms │ 417 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 47 │ 47 │ 54 │ 60 │ 54.29 │ 3.05 │ 47 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 204 kB │ 204 kB │ 234 kB │ 260 kB │ 235 kB │ 13.2 kB │ 204 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3257 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 14.1 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +5 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 36 ms │ 57 ms │ 126 ms │ 138 ms │ 64.99 ms │ 24.42 ms │ 195 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 64 │ 69 │ 76 │ 84 │ 76.32 │ 3.97 │ 64 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 8.58 kB │ 9.25 kB │ 10.2 kB │ 11.3 kB │ 10.2 kB │ 532 B │ 8.58 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4579 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 614 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +5 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬───────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼───────────┼───────────┼─────────┤ +│ Latency │ 439 ms │ 652 ms │ 1393 ms │ 1458 ms │ 780.62 ms │ 290.11 ms │ 2018 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴───────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 4 │ 5 │ 6 │ 8 │ 6.35 │ 0.78 │ 4 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 115 kB │ 144 kB │ 173 kB │ 230 kB │ 183 kB │ 22.1 kB │ 115 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 381 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +386 requests in 60.06s, 11 MB read + + +---------------- + + + +CLIENTS: *** 6 *** + +Running 60s test @ http://192.168.2.131/ +6 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 50 ms │ 85 ms │ 238 ms │ 268 ms │ 102.35 ms │ 50.03 ms │ 517 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 49 │ 53 │ 58 │ 65 │ 58.3 │ 3.13 │ 49 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 213 kB │ 230 kB │ 252 kB │ 282 kB │ 253 kB │ 13.6 kB │ 213 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3498 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.05s, 15.2 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +6 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 41 ms │ 64 ms │ 138 ms │ 151 ms │ 74.53 ms │ 27.06 ms │ 286 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 71 │ 71 │ 80 │ 90 │ 79.92 │ 4.07 │ 71 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 9.59 kB │ 9.59 kB │ 10.8 kB │ 12.2 kB │ 10.8 kB │ 548 B │ 9.59 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4795 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 647 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +6 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬───────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼───────────┼──────────┼─────────┤ +│ Latency │ 579 ms │ 840 ms │ 1766 ms │ 1816 ms │ 973.38 ms │ 355.3 ms │ 2392 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴───────────┴──────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 4 │ 4 │ 6 │ 8 │ 6.1 │ 0.87 │ 4 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 115 kB │ 115 kB │ 173 kB │ 230 kB │ 176 kB │ 25 kB │ 115 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 366 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +372 requests in 60.06s, 10.5 MB read + + +---------------- + + + +CLIENTS: *** 7 *** + +Running 60s test @ http://192.168.2.131/ +7 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 57 ms │ 96 ms │ 249 ms │ 293 ms │ 113.4 ms │ 53.05 ms │ 640 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 53 │ 54 │ 62 │ 68 │ 61.44 │ 3.82 │ 53 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 230 kB │ 234 kB │ 269 kB │ 295 kB │ 266 kB │ 16.6 kB │ 230 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3686 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.05s, 16 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +7 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 45 ms │ 69 ms │ 145 ms │ 154 ms │ 79.11 ms │ 27.06 ms │ 274 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬───────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼───────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 78 │ 80 │ 89 │ 99 │ 87.9 │ 4.78 │ 78 │ +├───────────┼─────────┼─────────┼───────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 10.5 kB │ 10.8 kB │ 12 kB │ 13.4 kB │ 11.9 kB │ 644 B │ 10.5 kB │ +└───────────┴─────────┴─────────┴───────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5274 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 712 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +7 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 671 ms │ 952 ms │ 1965 ms │ 2059 ms │ 1094.09 ms │ 402.31 ms │ 3654 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 8 │ 6.34 │ 0.79 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 230 kB │ 182 kB │ 22.7 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 380 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +387 requests in 60.07s, 10.9 MB read + + +---------------- + + + +CLIENTS: *** 8 *** + +Running 60s test @ http://192.168.2.131/ +8 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼─────────┤ +│ Latency │ 56 ms │ 95 ms │ 243 ms │ 275 ms │ 110.53 ms │ 52.27 ms │ 1027 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 52 │ 54 │ 62 │ 73 │ 62.99 │ 4.89 │ 52 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 226 kB │ 234 kB │ 269 kB │ 317 kB │ 273 kB │ 21.2 kB │ 226 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3779 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 16.4 MB read +6 errors (6 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +8 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬─────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼─────────┼──────────┼────────┤ +│ Latency │ 45 ms │ 70 ms │ 146 ms │ 156 ms │ 80.9 ms │ 28.68 ms │ 308 ms │ +└─────────┴───────┴───────┴────────┴────────┴─────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 77 │ 77 │ 86 │ 95 │ 85.92 │ 4.89 │ 77 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 10.4 kB │ 10.4 kB │ 11.6 kB │ 12.8 kB │ 11.6 kB │ 659 B │ 10.4 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5155 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 696 kB read +6 errors (6 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +8 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 699 ms │ 979 ms │ 2038 ms │ 2128 ms │ 1111.14 ms │ 406.26 ms │ 3506 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.25 │ 0.6 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 180 kB │ 17.1 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 375 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +389 requests in 60.06s, 10.8 MB read +6 errors (6 timeouts) + + +---------------- + + + +CLIENTS: *** 9 *** + +Running 60s test @ http://192.168.2.131/ +9 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 57 ms │ 96 ms │ 249 ms │ 277 ms │ 112.81 ms │ 51.23 ms │ 626 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 52 │ 57 │ 61 │ 68 │ 61.7 │ 3.18 │ 52 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 226 kB │ 247 kB │ 265 kB │ 295 kB │ 268 kB │ 13.8 kB │ 226 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3702 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 16.1 MB read +12 errors (12 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +9 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 45 ms │ 70 ms │ 144 ms │ 154 ms │ 79.64 ms │ 27.25 ms │ 239 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬───────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼───────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 76 │ 79 │ 87 │ 96 │ 87.34 │ 4.79 │ 76 │ +├───────────┼─────────┼─────────┼─────────┼───────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 10.3 kB │ 10.7 kB │ 11.8 kB │ 13 kB │ 11.8 kB │ 647 B │ 10.3 kB │ +└───────────┴─────────┴─────────┴─────────┴───────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5240 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.1s, 707 kB read +12 errors (12 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +9 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 664 ms │ 952 ms │ 2001 ms │ 2055 ms │ 1092.56 ms │ 399.94 ms │ 3588 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.35 │ 0.63 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 183 kB │ 18 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 381 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +402 requests in 60.06s, 11 MB read +12 errors (12 timeouts) + + +---------------- + + + +CLIENTS: *** 10 *** + +Running 60s test @ http://192.168.2.131/ +10 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 56 ms │ 97 ms │ 244 ms │ 277 ms │ 113.43 ms │ 51.43 ms │ 616 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 48 │ 51 │ 61 │ 69 │ 61.42 │ 3.92 │ 48 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 208 kB │ 221 kB │ 265 kB │ 300 kB │ 266 kB │ 17 kB │ 208 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3685 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 16 MB read +18 errors (18 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +10 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 45 ms │ 71 ms │ 147 ms │ 154 ms │ 81.57 ms │ 28.91 ms │ 335 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 75 │ 76 │ 86 │ 92 │ 85.32 │ 4.46 │ 75 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 10.1 kB │ 10.3 kB │ 11.6 kB │ 12.4 kB │ 11.5 kB │ 601 B │ 10.1 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5119 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 691 kB read +18 errors (18 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +10 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 705 ms │ 940 ms │ 1962 ms │ 2052 ms │ 1075.72 ms │ 385.45 ms │ 3313 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.45 │ 0.65 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 186 kB │ 18.5 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 387 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +415 requests in 60.05s, 11.1 MB read +18 errors (18 timeouts) + + +---------------- + + + +CLIENTS: *** 15 *** + +Running 60s test @ http://192.168.2.131/ +15 connections +1 workers + +node:internal/event_target:1084 + process.nextTick(() => { throw err; }); + ^ + +TypeError: colorize is not a function + at /Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:46:31 + at Array.forEach () + at printResult (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/printResult.js:43:43) + at EventEmitter. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/progressTracker.js:79:28) + at EventEmitter.emit (node:events:527:35) + at _cb (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/init.js:76:13) + at handleFinish (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:41:5) + at Worker. (/Users/hoeken/.nvm/versions/node/v21.1.0/lib/node_modules/autocannon/lib/manager.js:78:13) + at Worker.emit (node:events:515:28) + at MessagePort. (node:internal/worker:263:53) + +Node.js v21.1.0 + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +15 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼─────────┤ +│ Latency │ 44 ms │ 69 ms │ 158 ms │ 318 ms │ 82.99 ms │ 44.17 ms │ 1074 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴─────────┘ +┌───────────┬─────────┬────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 22 │ 23 │ 88 │ 98 │ 83.74 │ 16.45 │ 22 │ +├───────────┼─────────┼────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 2.97 kB │ 3.1 kB │ 11.9 kB │ 13.2 kB │ 11.3 kB │ 2.22 kB │ 2.97 kB │ +└───────────┴─────────┴────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5024 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.06s, 678 kB read +48 errors (48 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +15 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 665 ms │ 954 ms │ 1989 ms │ 2105 ms │ 1092.91 ms │ 396.34 ms │ 3476 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.35 │ 0.66 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 183 kB │ 18.8 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 381 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +444 requests in 60.06s, 11 MB read +48 errors (48 timeouts) + + +---------------- + + + +CLIENTS: *** 20 *** + +Running 60s test @ http://192.168.2.131/ +20 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 57 ms │ 97 ms │ 255 ms │ 322 ms │ 114.69 ms │ 55.79 ms │ 683 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 26 │ 48 │ 61 │ 67 │ 60.75 │ 5.8 │ 26 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 113 kB │ 208 kB │ 265 kB │ 291 kB │ 264 kB │ 25.2 kB │ 113 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3645 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.05s, 15.8 MB read +78 errors (78 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +20 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 44 ms │ 69 ms │ 142 ms │ 153 ms │ 78.14 ms │ 26.88 ms │ 256 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬───────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼───────┼───────┼─────────┤ +│ Req/Sec │ 76 │ 78 │ 88 │ 100 │ 88.92 │ 5.59 │ 76 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼───────┼───────┼─────────┤ +│ Bytes/Sec │ 10.3 kB │ 10.5 kB │ 11.9 kB │ 13.5 kB │ 12 kB │ 754 B │ 10.3 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴───────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5335 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 720 kB read +78 errors (78 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +20 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 705 ms │ 940 ms │ 1991 ms │ 2070 ms │ 1085.97 ms │ 389.59 ms │ 3357 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 5 │ 5 │ 6 │ 7 │ 6.39 │ 0.64 │ 5 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 144 kB │ 144 kB │ 173 kB │ 201 kB │ 184 kB │ 18.2 kB │ 144 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 383 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +481 requests in 60.06s, 11 MB read +78 errors (78 timeouts) + + +---------------- + diff --git a/lib/PsychicHttp/benchmark/results/psychic-ssl-http-loadtest.log b/lib/PsychicHttp/benchmark/results/psychic-ssl-http-loadtest.log new file mode 100644 index 0000000..17e3414 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/psychic-ssl-http-loadtest.log @@ -0,0 +1,1194 @@ + + +CLIENTS: *** 1 *** + +Running 60s test @ https://192.168.2.131/ +1 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬─────────┬─────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼─────────┼─────────┼─────────┤ +│ Latency │ 33 ms │ 40 ms │ 139 ms │ 157 ms │ 51.6 ms │ 58.1 ms │ 1757 ms │ +└─────────┴───────┴───────┴────────┴────────┴─────────┴─────────┴─────────┘ +┌───────────┬─────┬─────────┬─────────┬────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 5 │ 20 │ 24 │ 19.19 │ 4.05 │ 5 │ +├───────────┼─────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 21.7 kB │ 86.8 kB │ 104 kB │ 83.2 kB │ 17.5 kB │ 21.7 kB │ +└───────────┴─────┴─────────┴─────────┴────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1151 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.07s, 4.99 MB read + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +1 connections +1 workers + + +┌─────────┬───────┬───────┬───────┬────────┬──────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼───────┼────────┼──────────┼──────────┼─────────┤ +│ Latency │ 21 ms │ 27 ms │ 89 ms │ 100 ms │ 32.17 ms │ 43.71 ms │ 1745 ms │ +└─────────┴───────┴───────┴───────┴────────┴──────────┴──────────┴─────────┘ +┌───────────┬─────┬─────────┬─────────┬─────────┬────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼─────────┼─────────┼─────────┼────────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 8 │ 32 │ 38 │ 30.57 │ 5.91 │ 8 │ +├───────────┼─────┼─────────┼─────────┼─────────┼────────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 1.07 kB │ 4.29 kB │ 5.09 kB │ 4.1 kB │ 791 B │ 1.07 kB │ +└───────────┴─────┴─────────┴─────────┴─────────┴────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1834 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.07s, 246 kB read + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +1 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼───────────┼─────────┤ +│ Latency │ 216 ms │ 252 ms │ 400 ms │ 408 ms │ 281.55 ms │ 122.23 ms │ 1871 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴───────────┴─────────┘ +┌───────────┬─────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 1 │ 4 │ 5 │ 3.54 │ 0.83 │ 1 │ +├───────────┼─────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 28.8 kB │ 115 kB │ 144 kB │ 102 kB │ 23.8 kB │ 28.8 kB │ +└───────────┴─────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 212 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +213 requests in 60.07s, 6.1 MB read + + +---------------- + + + +CLIENTS: *** 2 *** + +Running 60s test @ https://192.168.2.131/ +2 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼───────────┼─────────┤ +│ Latency │ 37 ms │ 54 ms │ 149 ms │ 164 ms │ 64.14 ms │ 106.26 ms │ 3230 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 0 │ 0 │ 33 │ 36 │ 30.92 │ 7.43 │ 27 │ +├───────────┼─────┼──────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 143 kB │ 156 kB │ 134 kB │ 32.2 kB │ 117 kB │ +└───────────┴─────┴──────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1855 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.06s, 8.05 MB read + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +2 connections +1 workers + + +┌─────────┬───────┬───────┬───────┬────────┬──────────┬─────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼───────┼────────┼──────────┼─────────┼─────────┤ +│ Latency │ 27 ms │ 38 ms │ 95 ms │ 106 ms │ 44.65 ms │ 87.8 ms │ 3211 ms │ +└─────────┴───────┴───────┴───────┴────────┴──────────┴─────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 47 │ 52 │ 44.29 │ 10.57 │ 35 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 6.35 kB │ 7.02 kB │ 5.98 kB │ 1.43 kB │ 4.72 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2657 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.07s, 359 kB read + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +2 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼───────────┼─────────┤ +│ Latency │ 320 ms │ 456 ms │ 633 ms │ 701 ms │ 488.51 ms │ 296.92 ms │ 3820 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 4 │ 5 │ 4.09 │ 1.09 │ 3 │ +├───────────┼─────┼──────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 115 kB │ 144 kB │ 118 kB │ 31.2 kB │ 86.3 kB │ +└───────────┴─────┴──────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 245 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +247 requests in 60.07s, 7.05 MB read + + +---------------- + + + +CLIENTS: *** 3 *** + +Running 60s test @ https://192.168.2.131/ +3 connections +1 workers + + +┌─────────┬─────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 1535 ms │ 6477 ms │ 14517 ms │ 14517 ms │ 6462.25 ms │ 2849.18 ms │ 14517 ms │ +└─────────┴─────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.53 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.6 kB │ 2.27 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +75 requests in 60.1s, 156 kB read +5 errors (0 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +3 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 1517 ms │ 1638 ms │ 3675 ms │ 3675 ms │ 1697.95 ms │ 343.44 ms │ 3675 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬────────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.59 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 78.8 B │ 66.6 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴────────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +73 requests in 60.11s, 4.72 kB read +1 errors (0 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +3 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬─────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼─────────────┼────────────┼──────────┤ +│ Latency │ 386 ms │ 9117 ms │ 50313 ms │ 50313 ms │ 12942.77 ms │ 11833.9 ms │ 50313 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴─────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 3 │ 0.57 │ 0.7 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 86.4 kB │ 16.3 kB │ 19.9 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 34 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +68 requests in 60.11s, 979 kB read +28 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 4 *** + +Running 60s test @ https://192.168.2.131/ +4 connections +1 workers + + +┌─────────┬─────────┬─────────┬──────────┬──────────┬─────────────┬─────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼──────────┼──────────┼─────────────┼─────────────┼──────────┤ +│ Latency │ 1530 ms │ 1686 ms │ 40733 ms │ 40733 ms │ 10336.06 ms │ 12608.67 ms │ 40733 ms │ +└─────────┴─────────┴─────────┴──────────┴──────────┴─────────────┴─────────────┴──────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.53 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.6 kB │ 2.27 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +76 requests in 60.15s, 156 kB read +11 errors (0 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +4 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼──────────┼─────────┤ +│ Latency │ 1495 ms │ 1586 ms │ 4490 ms │ 4490 ms │ 1673.35 ms │ 485.3 ms │ 4490 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴──────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬────────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.59 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 78.8 B │ 66.6 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴────────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +74 requests in 60.15s, 4.72 kB read +3 errors (0 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +4 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬─────────────┬─────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼─────────────┼─────────────┼──────────┤ +│ Latency │ 340 ms │ 3642 ms │ 49950 ms │ 49950 ms │ 13180.63 ms │ 14189.21 ms │ 49950 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴─────────────┴─────────────┴──────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 2 │ 0.59 │ 0.65 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 28.8 kB │ 57.6 kB │ 16.8 kB │ 18.4 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +72 requests in 60.15s, 1.01 MB read +30 errors (0 timeouts) + + +---------------- + + + +CLIENTS: *** 5 *** + +Running 60s test @ https://192.168.2.131/ +5 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 1449 ms │ 1597 ms │ 4810 ms │ 4810 ms │ 1691.72 ms │ 537.09 ms │ 4810 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.59 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.53 kB │ 2.14 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +75 requests in 60.13s, 152 kB read +11 errors (0 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +5 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 1510 ms │ 1584 ms │ 4971 ms │ 4971 ms │ 1685.03 ms │ 564.99 ms │ 4971 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬────────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.59 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 78.8 B │ 66.6 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴────────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +75 requests in 60.14s, 4.72 kB read +1 errors (0 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +5 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 409 ms │ 5565 ms │ 38132 ms │ 38132 ms │ 9430.76 ms │ 9263.66 ms │ 38132 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 2 │ 0.56 │ 0.62 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 57.6 kB │ 15.8 kB │ 17.8 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 33 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +69 requests in 60.14s, 950 kB read +29 errors (1 timeouts) + + +---------------- + + + +CLIENTS: *** 6 *** + +Running 60s test @ https://192.168.2.131/ +6 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 1007 ms │ 1603 ms │ 5373 ms │ 5373 ms │ 1696.69 ms │ 639.15 ms │ 5373 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.59 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.53 kB │ 2.14 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +76 requests in 60.14s, 152 kB read +15 errors (2 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +6 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 976 ms │ 1586 ms │ 6118 ms │ 6118 ms │ 1683.15 ms │ 773.87 ms │ 6118 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬────────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.59 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 78.8 B │ 66.6 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴────────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 35 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +76 requests in 60.14s, 4.72 kB read +4 errors (2 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +6 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 437 ms │ 3543 ms │ 18174 ms │ 18174 ms │ 4264.16 ms │ 3629.94 ms │ 18174 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.54 │ 0.6 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 28.8 kB │ 15.3 kB │ 17 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 32 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +69 requests in 60.15s, 921 kB read +30 errors (5 timeouts) + + +---------------- + + + +CLIENTS: *** 7 *** + +Running 60s test @ https://192.168.2.131/ +7 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬───────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼───────────┼──────────┤ +│ Latency │ 979 ms │ 1600 ms │ 37778 ms │ 37778 ms │ 2654.48 ms │ 5987.7 ms │ 37778 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴───────────┴──────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.53 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.6 kB │ 2.27 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +80 requests in 60.1s, 156 kB read +17 errors (7 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +7 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 928 ms │ 1591 ms │ 7128 ms │ 7128 ms │ 1648.53 ms │ 955.92 ms │ 7128 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬──────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 81 B │ 66.1 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴──────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +79 requests in 60.09s, 4.86 kB read +13 errors (8 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +7 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬───────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼───────────┼────────────┼──────────┤ +│ Latency │ 487 ms │ 1740 ms │ 24134 ms │ 24134 ms │ 3069.3 ms │ 4835.41 ms │ 24134 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴───────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.4 │ 0.53 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 28.8 kB │ 11.5 kB │ 15 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 24 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +69 requests in 60.08s, 691 kB read +37 errors (21 timeouts) + + +---------------- + + + +CLIENTS: *** 8 *** + +Running 60s test @ https://192.168.2.131/ +8 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 892 ms │ 1585 ms │ 6973 ms │ 6973 ms │ 1613.52 ms │ 927.38 ms │ 6973 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.62 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.68 kB │ 2.11 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 37 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +89 requests in 60.09s, 161 kB read +25 errors (16 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +8 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 964 ms │ 1593 ms │ 7380 ms │ 7380 ms │ 1645.62 ms │ 998.66 ms │ 7380 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬──────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.53 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 81 B │ 70.6 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴──────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +86 requests in 60.1s, 4.86 kB read +14 errors (14 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +8 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 341 ms │ 4820 ms │ 26999 ms │ 26999 ms │ 7220.49 ms │ 6874.47 ms │ 26999 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 3 │ 0.56 │ 0.67 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 86.4 kB │ 15.8 kB │ 19.3 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 33 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +84 requests in 60.08s, 950 kB read +41 errors (27 timeouts) + + +---------------- + + + +CLIENTS: *** 9 *** + +Running 60s test @ https://192.168.2.131/ +9 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤ +│ Latency │ 960 ms │ 1598 ms │ 7751 ms │ 7751 ms │ 1665.89 ms │ 1056.66 ms │ 7751 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.6 kB │ 2.13 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +93 requests in 60.1s, 156 kB read +25 errors (21 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +9 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤ +│ Latency │ 933 ms │ 1589 ms │ 7703 ms │ 7703 ms │ 1649.14 ms │ 1051.77 ms │ 7703 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬──────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 81 B │ 66.1 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴──────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +93 requests in 60.09s, 4.86 kB read +21 errors (20 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +9 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼─────────┤ +│ Latency │ 1049 ms │ 1783 ms │ 7382 ms │ 7382 ms │ 1758 ms │ 1027.58 ms │ 7382 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.57 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 28.8 kB │ 28.8 kB │ 16.3 kB │ 14.3 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 34 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +91 requests in 60.1s, 979 kB read +48 errors (29 timeouts) + + +---------------- + + + +CLIENTS: *** 10 *** + +Running 60s test @ https://192.168.2.131/ +10 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤ +│ Latency │ 979 ms │ 1597 ms │ 7548 ms │ 7548 ms │ 1660.23 ms │ 1024.01 ms │ 7548 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.6 kB │ 2.13 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +100 requests in 60.09s, 156 kB read +29 errors (26 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +10 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 976 ms │ 1590 ms │ 7480 ms │ 7480 ms │ 1628.95 ms │ 1021.2 ms │ 7480 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬──────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 81 B │ 66.1 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴──────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +101 requests in 60.12s, 4.86 kB read +28 errors (28 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +10 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 585 ms │ 5882 ms │ 27503 ms │ 27503 ms │ 6338.82 ms │ 6773.89 ms │ 27503 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.54 │ 0.6 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 28.8 kB │ 15.3 kB │ 17 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 32 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +97 requests in 60.14s, 921 kB read +54 errors (38 timeouts) + + +---------------- + + + +CLIENTS: *** 15 *** + +Running 60s test @ https://192.168.2.131/ +15 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤ +│ Latency │ 957 ms │ 1601 ms │ 7609 ms │ 7609 ms │ 1654.73 ms │ 1034.04 ms │ 7609 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 4.34 kB │ 4.34 kB │ 2.6 kB │ 2.13 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +135 requests in 60.14s, 156 kB read +64 errors (56 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +15 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 966 ms │ 1576 ms │ 7369 ms │ 7369 ms │ 1612.68 ms │ 991.59 ms │ 7369 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬────────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.62 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼────────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 83.3 B │ 65.6 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴────────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 37 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +136 requests in 60.14s, 5 kB read +61 errors (60 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +15 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬──────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼──────────┼────────────┼──────────┤ +│ Latency │ 300 ms │ 7281 ms │ 34953 ms │ 34953 ms │ 10153 ms │ 9647.72 ms │ 34953 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴──────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 3 │ 0.52 │ 0.68 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 86.4 kB │ 14.9 kB │ 19.3 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 31 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +132 requests in 60.11s, 892 kB read +84 errors (70 timeouts) + + +---------------- + + + +CLIENTS: *** 20 *** + +Running 60s test @ https://192.168.2.131/ +20 connections +1 workers + + +┌─────────┬────────┬─────────┬──────────┬──────────┬────────────┬────────────┬──────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼──────────┼──────────┼────────────┼────────────┼──────────┤ +│ Latency │ 944 ms │ 1600 ms │ 36783 ms │ 36783 ms │ 2881.21 ms │ 6487.79 ms │ 36783 ms │ +└─────────┴────────┴─────────┴──────────┴──────────┴────────────┴────────────┴──────────┘ +┌───────────┬─────┬──────┬─────┬─────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────┼─────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 0 │ 1 │ 0.49 │ 0.54 │ 1 │ +├───────────┼─────┼──────┼─────┼─────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 0 B │ 4.34 kB │ 2.1 kB │ 2.31 kB │ 4.34 kB │ +└───────────┴─────┴──────┴─────┴─────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 29 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +165 requests in 60.1s, 126 kB read +96 errors (92 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/api?foo=bar +20 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 931 ms │ 1568 ms │ 7097 ms │ 7097 ms │ 1637.53 ms │ 950.49 ms │ 7097 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────┬──────┬───────┬───────┬──────┬────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.6 │ 0.49 │ 1 │ +├───────────┼─────┼──────┼───────┼───────┼──────┼────────┼───────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 135 B │ 135 B │ 81 B │ 66.1 B │ 135 B │ +└───────────┴─────┴──────┴───────┴───────┴──────┴────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 36 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +170 requests in 60.12s, 4.86 kB read +87 errors (85 timeouts) + + +---------------- + +Running 60s test @ https://192.168.2.131/alien.png +20 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬────────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼────────────┼─────────┤ +│ Latency │ 1116 ms │ 1707 ms │ 7481 ms │ 7481 ms │ 1754.83 ms │ 1032.66 ms │ 7481 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴────────────┴─────────┘ +┌───────────┬─────┬──────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 0 │ 0 │ 1 │ 1 │ 0.57 │ 0.5 │ 1 │ +├───────────┼─────┼──────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 0 B │ 0 B │ 28.8 kB │ 28.8 kB │ 16.3 kB │ 14.3 kB │ 28.8 kB │ +└───────────┴─────┴──────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 34 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +168 requests in 60.09s, 979 kB read +114 errors (95 timeouts) + + +---------------- + diff --git a/lib/PsychicHttp/benchmark/results/psychic-ssl-websocket-loadtest.log b/lib/PsychicHttp/benchmark/results/psychic-ssl-websocket-loadtest.log new file mode 100644 index 0000000..4e9aa5c --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/psychic-ssl-websocket-loadtest.log @@ -0,0 +1,246 @@ + + +CLIENTS: *** 1 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 1 +Agent: none + +Completed requests: 2039 +Total errors: 0 +Total time: 60.002 s +Mean latency: 27.8 ms +Effective rps: 34 + +Percentage of requests served within a certain time + 50% 24 ms + 90% 34 ms + 95% 62 ms + 99% 97 ms + 100% 109 ms (longest request) + + +CLIENTS: *** 2 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 2 +Agent: none + +Completed requests: 2969 +Total errors: 0 +Total time: 60.003 s +Mean latency: 37.7 ms +Effective rps: 49 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 52 ms + 95% 92 ms + 99% 110 ms + 100% 126 ms (longest request) + + +CLIENTS: *** 3 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 3 +Agent: none + +Completed requests: 2883 +Total errors: 0 +Total time: 60.003 s +Mean latency: 38.2 ms +Effective rps: 48 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 52 ms + 95% 86 ms + 99% 109 ms + 100% 1711 ms (longest request) + + +CLIENTS: *** 4 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 4 +Agent: none + +Completed requests: 2858 +Total errors: 0 +Total time: 60.003 s +Mean latency: 37.9 ms +Effective rps: 48 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 49 ms + 95% 76 ms + 99% 104 ms + 100% 1740 ms (longest request) + + +CLIENTS: *** 5 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 5 +Agent: none + +Completed requests: 2772 +Total errors: 0 +Total time: 60.003 s +Mean latency: 38.6 ms +Effective rps: 46 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 49 ms + 95% 79 ms + 99% 106 ms + 100% 1634 ms (longest request) + + +CLIENTS: *** 6 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 6 +Agent: none + +Completed requests: 2722 +Total errors: 0 +Total time: 60.003 s +Mean latency: 38.7 ms +Effective rps: 45 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 49 ms + 95% 72 ms + 99% 102 ms + 100% 1694 ms (longest request) + + +CLIENTS: *** 7 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 7 +Agent: none + +Completed requests: 2552 +Total errors: 0 +Total time: 60.003 s +Mean latency: 40.7 ms +Effective rps: 43 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 52 ms + 95% 86 ms + 99% 112 ms + 100% 1816 ms (longest request) + + +CLIENTS: *** 8 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 8 +Running on cores: 2 +Agent: none + +Completed requests: 2507 +Total errors: 0 +Total time: 60.005 s +Mean latency: 40.8 ms +Effective rps: 42 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 50 ms + 95% 80 ms + 99% 112 ms + 100% 1646 ms (longest request) + + +CLIENTS: *** 10 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 10 +Running on cores: 2 +Agent: none + +Completed requests: 2265 +Total errors: 0 +Total time: 60.008 s +Mean latency: 43.7 ms +Effective rps: 38 + +Percentage of requests served within a certain time + 50% 33 ms + 90% 52 ms + 95% 79 ms + 99% 114 ms + 100% 1675 ms (longest request) + + +CLIENTS: *** 16 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 16 +Running on cores: 2 +Agent: none + +Completed requests: 1795 +Total errors: 0 +Total time: 60.003 s +Mean latency: 49.7 ms +Effective rps: 30 + +Percentage of requests served within a certain time + 50% 33 ms + 90% 51 ms + 95% 77 ms + 99% 112 ms + 100% 1741 ms (longest request) + + +CLIENTS: *** 20 *** + + +Target URL: wss://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 20 +Running on cores: 2 +Agent: none + +Completed requests: 1603 +Total errors: 0 +Total time: 60.004 s +Mean latency: 54.1 ms +Effective rps: 27 + +Percentage of requests served within a certain time + 50% 33 ms + 90% 60 ms + 95% 94 ms + 99% 133 ms + 100% 1729 ms (longest request) diff --git a/lib/PsychicHttp/benchmark/results/psychic-v1.1-http-loadtest.log b/lib/PsychicHttp/benchmark/results/psychic-v1.1-http-loadtest.log new file mode 100644 index 0000000..9fc5dae --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/psychic-v1.1-http-loadtest.log @@ -0,0 +1,1179 @@ + + +CLIENTS: *** 1 *** + +Running 60s test @ http://192.168.2.131/ +1 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 25 ms │ 34 ms │ 137 ms │ 175 ms │ 44.75 ms │ 33.04 ms │ 363 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 13 │ 14 │ 23 │ 27 │ 22.05 │ 3.62 │ 13 │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 56.4 kB │ 60.7 kB │ 99.8 kB │ 117 kB │ 95.6 kB │ 15.7 kB │ 56.4 kB │ +└───────────┴─────────┴─────────┴─────────┴────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1323 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.06s, 5.74 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +1 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 21 ms │ 29 ms │ 122 ms │ 173 ms │ 40.61 ms │ 38.19 ms │ 646 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬───────┬───────┬─────────┬─────────┬─────────┬─────────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼───────┼───────┼─────────┼─────────┼─────────┼─────────┼───────┤ +│ Req/Sec │ 2 │ 6 │ 27 │ 34 │ 24.29 │ 7.62 │ 2 │ +├───────────┼───────┼───────┼─────────┼─────────┼─────────┼─────────┼───────┤ +│ Bytes/Sec │ 268 B │ 804 B │ 3.62 kB │ 4.56 kB │ 3.25 kB │ 1.02 kB │ 268 B │ +└───────────┴───────┴───────┴─────────┴─────────┴─────────┴─────────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1457 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +1k requests in 60.07s, 195 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +1 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 254 ms │ 291 ms │ 441 ms │ 487 ms │ 311.18 ms │ 52.89 ms │ 503 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 2 │ 3 │ 4 │ 3.2 │ 0.58 │ 2 │ +├───────────┼─────────┼─────────┼─────────┼────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 57.6 kB │ 86.4 kB │ 115 kB │ 92.1 kB │ 16.4 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴─────────┴────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 192 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +193 requests in 60.07s, 5.53 MB read + + +---------------- + + + +CLIENTS: *** 2 *** + +Running 60s test @ http://192.168.2.131/ +2 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 29 ms │ 46 ms │ 184 ms │ 213 ms │ 63.03 ms │ 43.98 ms │ 437 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 13 │ 13 │ 34 │ 43 │ 31.44 │ 7.44 │ 13 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 56.4 kB │ 56.4 kB │ 148 kB │ 187 kB │ 136 kB │ 32.2 kB │ 56.4 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 1886 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +2k requests in 60.07s, 8.18 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +2 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 27 ms │ 37 ms │ 107 ms │ 120 ms │ 44.09 ms │ 20.34 ms │ 188 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬───────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼───────┼───────┼─────────┤ +│ Req/Sec │ 24 │ 25 │ 46 │ 52 │ 44.79 │ 6.1 │ 24 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼───────┼───────┼─────────┤ +│ Bytes/Sec │ 3.22 kB │ 3.35 kB │ 6.17 kB │ 6.97 kB │ 6 kB │ 817 B │ 3.22 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴───────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2687 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.06s, 360 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +2 connections +1 workers + + +┌─────────┬────────┬────────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 375 ms │ 552 ms │ 759 ms │ 848 ms │ 556.76 ms │ 95.75 ms │ 875 ms │ +└─────────┴────────┴────────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 4 │ 4 │ 3.59 │ 0.53 │ 3 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.4 kB │ 86.4 kB │ 115 kB │ 115 kB │ 103 kB │ 15.1 kB │ 86.3 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 215 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +217 requests in 60.09s, 6.19 MB read + + +---------------- + + + +CLIENTS: *** 3 *** + +Running 60s test @ http://192.168.2.131/ +3 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬─────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼─────────┼────────┤ +│ Latency │ 36 ms │ 56 ms │ 167 ms │ 193 ms │ 67.22 ms │ 33.6 ms │ 343 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴─────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 32 │ 34 │ 45 │ 52 │ 44.25 │ 4.31 │ 32 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 139 kB │ 148 kB │ 195 kB │ 226 kB │ 192 kB │ 18.7 kB │ 139 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 2655 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.08s, 11.5 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +3 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬─────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼─────────┼────────┤ +│ Latency │ 30 ms │ 45 ms │ 114 ms │ 128 ms │ 51.89 ms │ 22.2 ms │ 294 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴─────────┴────────┘ +┌───────────┬─────────┬────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 37 │ 44 │ 58 │ 67 │ 57.24 │ 6.16 │ 37 │ +├───────────┼─────────┼────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 4.96 kB │ 5.9 kB │ 7.78 kB │ 8.98 kB │ 7.67 kB │ 825 B │ 4.96 kB │ +└───────────┴─────────┴────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3434 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.1s, 460 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +3 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬───────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼───────────┼───────────┼─────────┤ +│ Latency │ 412 ms │ 786 ms │ 1293 ms │ 1397 ms │ 829.09 ms │ 295.53 ms │ 1412 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴───────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 3 │ 4 │ 4 │ 3.59 │ 0.53 │ 2 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 86.4 kB │ 115 kB │ 115 kB │ 103 kB │ 15.1 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 215 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +218 requests in 60.11s, 6.19 MB read + + +---------------- + + + +CLIENTS: *** 4 *** + +Running 60s test @ http://192.168.2.131/ +4 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 41 ms │ 65 ms │ 189 ms │ 221 ms │ 79.49 ms │ 39.69 ms │ 385 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 41 │ 41 │ 51 │ 56 │ 50 │ 4.07 │ 41 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 178 kB │ 178 kB │ 221 kB │ 243 kB │ 217 kB │ 17.6 kB │ 178 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3000 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.1s, 13 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +4 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 35 ms │ 51 ms │ 128 ms │ 154 ms │ 58.79 ms │ 24.56 ms │ 347 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 38 │ 50 │ 69 │ 77 │ 67.49 │ 7.34 │ 38 │ +├───────────┼─────────┼────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 5.09 kB │ 6.7 kB │ 9.25 kB │ 10.3 kB │ 9.04 kB │ 983 B │ 5.09 kB │ +└───────────┴─────────┴────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4049 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.11s, 543 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +4 connections +1 workers + + +┌─────────┬────────┬────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 630 ms │ 885 ms │ 1840 ms │ 1877 ms │ 1082.82 ms │ 406.47 ms │ 2050 ms │ +└─────────┴────────┴────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 4 │ 5 │ 3.65 │ 0.55 │ 3 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.4 kB │ 86.4 kB │ 115 kB │ 144 kB │ 105 kB │ 15.6 kB │ 86.3 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 219 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +223 requests in 60.08s, 6.3 MB read + + +---------------- + + + +CLIENTS: *** 5 *** + +Running 60s test @ http://192.168.2.131/ +5 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 47 ms │ 77 ms │ 213 ms │ 242 ms │ 91.79 ms │ 44.06 ms │ 398 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 41 │ 42 │ 55 │ 62 │ 54.12 │ 4.67 │ 41 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 178 kB │ 182 kB │ 239 kB │ 269 kB │ 235 kB │ 20.2 kB │ 178 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3247 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +3k requests in 60.08s, 14.1 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +5 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 39 ms │ 60 ms │ 126 ms │ 141 ms │ 65.76 ms │ 21.03 ms │ 172 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬─────────┬─────────┬─────────┬─────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼─────────┼─────────┼─────────┼─────────┼───────┼────────┤ +│ Req/Sec │ 53 │ 58 │ 76 │ 86 │ 75.34 │ 7.04 │ 53 │ +├───────────┼────────┼─────────┼─────────┼─────────┼─────────┼───────┼────────┤ +│ Bytes/Sec │ 7.1 kB │ 7.78 kB │ 10.2 kB │ 11.5 kB │ 10.1 kB │ 943 B │ 7.1 kB │ +└───────────┴────────┴─────────┴─────────┴─────────┴─────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4520 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.08s, 606 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +5 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 832 ms │ 1125 ms │ 2405 ms │ 2530 ms │ 1344.04 ms │ 504.13 ms │ 3485 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 3 │ 4 │ 5 │ 3.69 │ 0.57 │ 2 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 86.4 kB │ 115 kB │ 144 kB │ 106 kB │ 16.2 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 221 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +226 requests in 60.08s, 6.36 MB read + + +---------------- + + + +CLIENTS: *** 6 *** + +Running 60s test @ http://192.168.2.131/ +6 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 51 ms │ 84 ms │ 214 ms │ 249 ms │ 98.05 ms │ 44.48 ms │ 553 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 40 │ 50 │ 62 │ 66 │ 60.87 │ 4.59 │ 40 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 174 kB │ 217 kB │ 269 kB │ 286 kB │ 264 kB │ 19.9 kB │ 174 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3652 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.09s, 15.8 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +6 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 45 ms │ 68 ms │ 144 ms │ 159 ms │ 75.43 ms │ 24.46 ms │ 223 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 53 │ 63 │ 80 │ 91 │ 78.95 │ 7.74 │ 53 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 7.16 kB │ 8.51 kB │ 10.8 kB │ 12.3 kB │ 10.7 kB │ 1.04 kB │ 7.16 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4737 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.08s, 639 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +6 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 893 ms │ 1385 ms │ 3045 ms │ 3336 ms │ 1630.97 ms │ 621.58 ms │ 4350 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 3 │ 4 │ 5 │ 3.62 │ 0.58 │ 2 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 86.4 kB │ 115 kB │ 144 kB │ 104 kB │ 16.7 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 217 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +223 requests in 60.1s, 6.25 MB read + + +---------------- + + + +CLIENTS: *** 7 *** + +Running 60s test @ http://192.168.2.131/ +7 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 59 ms │ 96 ms │ 232 ms │ 260 ms │ 109.85 ms │ 47.04 ms │ 531 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬───────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Req/Sec │ 44 │ 53 │ 65 │ 72 │ 63.39 │ 5.76 │ 44 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼───────┼────────┤ +│ Bytes/Sec │ 191 kB │ 230 kB │ 282 kB │ 313 kB │ 275 kB │ 25 kB │ 191 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴───────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3803 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.08s, 16.5 MB read + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +7 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 48 ms │ 75 ms │ 139 ms │ 152 ms │ 80.37 ms │ 22.69 ms │ 291 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬───────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼───────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 52 │ 67 │ 88 │ 96 │ 86.59 │ 7.62 │ 52 │ +├───────────┼─────────┼─────────┼─────────┼───────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 7.02 kB │ 9.05 kB │ 11.9 kB │ 13 kB │ 11.7 kB │ 1.03 kB │ 7.02 kB │ +└───────────┴─────────┴─────────┴─────────┴───────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5195 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.11s, 701 kB read + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +7 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 845 ms │ 1642 ms │ 3537 ms │ 3656 ms │ 1887.17 ms │ 728.73 ms │ 6130 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 4 │ 4 │ 3.64 │ 0.52 │ 3 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.4 kB │ 86.4 kB │ 115 kB │ 115 kB │ 105 kB │ 14.8 kB │ 86.3 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 218 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +225 requests in 60.1s, 6.27 MB read + + +---------------- + + + +CLIENTS: *** 8 *** + +Running 60s test @ http://192.168.2.131/ +8 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼────────┤ +│ Latency │ 58 ms │ 96 ms │ 225 ms │ 256 ms │ 108.89 ms │ 45.19 ms │ 571 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴────────┘ +┌───────────┬────────┬────────┬────────┬────────┬────────┬─────────┬────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Req/Sec │ 51 │ 54 │ 65 │ 70 │ 63.92 │ 4.63 │ 51 │ +├───────────┼────────┼────────┼────────┼────────┼────────┼─────────┼────────┤ +│ Bytes/Sec │ 221 kB │ 234 kB │ 282 kB │ 304 kB │ 277 kB │ 20.1 kB │ 221 kB │ +└───────────┴────────┴────────┴────────┴────────┴────────┴─────────┴────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3835 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.07s, 16.6 MB read +6 errors (6 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +8 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬─────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼─────────┼────────┤ +│ Latency │ 50 ms │ 76 ms │ 148 ms │ 166 ms │ 83.61 ms │ 26.5 ms │ 282 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴─────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 63 │ 66 │ 82 │ 98 │ 83.15 │ 8.78 │ 63 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 8.51 kB │ 8.91 kB │ 11.1 kB │ 13.2 kB │ 11.2 kB │ 1.18 kB │ 8.51 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4989 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.08s, 674 kB read +6 errors (6 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +8 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬───────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼───────────┼───────────┼─────────┤ +│ Latency │ 806 ms │ 1614 ms │ 3526 ms │ 3769 ms │ 1851.3 ms │ 712.64 ms │ 5877 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴───────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 4 │ 5 │ 3.72 │ 0.52 │ 3 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.4 kB │ 86.4 kB │ 115 kB │ 144 kB │ 107 kB │ 14.9 kB │ 86.3 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 223 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +237 requests in 60.09s, 6.42 MB read +6 errors (6 timeouts) + + +---------------- + + + +CLIENTS: *** 9 *** + +Running 60s test @ http://192.168.2.131/ +9 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬─────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼─────────┼─────────┤ +│ Latency │ 60 ms │ 98 ms │ 232 ms │ 268 ms │ 111.69 ms │ 57.8 ms │ 1065 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴─────────┴─────────┘ +┌───────────┬───────┬────────┬────────┬────────┬────────┬───────┬───────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼───────┼────────┼────────┼────────┼────────┼───────┼───────┤ +│ Req/Sec │ 3 │ 54 │ 63 │ 72 │ 62.37 │ 8.98 │ 3 │ +├───────────┼───────┼────────┼────────┼────────┼────────┼───────┼───────┤ +│ Bytes/Sec │ 13 kB │ 234 kB │ 273 kB │ 313 kB │ 271 kB │ 39 kB │ 13 kB │ +└───────────┴───────┴────────┴────────┴────────┴────────┴───────┴───────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3742 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.07s, 16.2 MB read +12 errors (12 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +9 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 50 ms │ 77 ms │ 148 ms │ 160 ms │ 83.55 ms │ 24.72 ms │ 275 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬───────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Req/Sec │ 63 │ 67 │ 85 │ 95 │ 83.27 │ 7.2 │ 63 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼───────┼─────────┤ +│ Bytes/Sec │ 8.51 kB │ 9.05 kB │ 11.5 kB │ 12.8 kB │ 11.2 kB │ 972 B │ 8.51 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴───────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4996 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.08s, 674 kB read +12 errors (12 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +9 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 857 ms │ 1631 ms │ 3541 ms │ 3814 ms │ 1883.14 ms │ 730.83 ms │ 6021 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 3 │ 3 │ 4 │ 4 │ 3.67 │ 0.48 │ 3 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 86.4 kB │ 86.4 kB │ 115 kB │ 115 kB │ 106 kB │ 13.5 kB │ 86.3 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 220 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +241 requests in 60.08s, 6.33 MB read +12 errors (12 timeouts) + + +---------------- + + + +CLIENTS: *** 10 *** + +Running 60s test @ http://192.168.2.131/ +10 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼─────────┤ +│ Latency │ 59 ms │ 95 ms │ 235 ms │ 276 ms │ 111.77 ms │ 57.35 ms │ 1010 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴─────────┘ +┌───────────┬─────────┬────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 17 │ 47 │ 64 │ 70 │ 62.32 │ 8.14 │ 17 │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 73.8 kB │ 204 kB │ 278 kB │ 304 kB │ 270 kB │ 35.3 kB │ 73.7 kB │ +└───────────┴─────────┴────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3739 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.08s, 16.2 MB read +18 errors (18 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +10 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 49 ms │ 82 ms │ 179 ms │ 209 ms │ 91.77 ms │ 33.92 ms │ 312 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 46 │ 48 │ 76 │ 92 │ 75.85 │ 11.6 │ 46 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 6.21 kB │ 6.48 kB │ 10.3 kB │ 12.4 kB │ 10.2 kB │ 1.57 kB │ 6.21 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4551 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 614 kB read +18 errors (18 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +10 connections +1 workers + + +┌─────────┬─────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼─────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 1062 ms │ 1673 ms │ 3588 ms │ 3643 ms │ 1903.02 ms │ 693.11 ms │ 5495 ms │ +└─────────┴─────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 2 │ 4 │ 5 │ 3.6 │ 0.64 │ 2 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 57.6 kB │ 115 kB │ 144 kB │ 104 kB │ 18.3 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 216 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +244 requests in 60.08s, 6.22 MB read +18 errors (18 timeouts) + + +---------------- + + + +CLIENTS: *** 15 *** + +Running 60s test @ http://192.168.2.131/ +15 connections +1 workers + + +┌─────────┬───────┬────────┬────────┬────────┬───────────┬─────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼────────┼────────┼────────┼───────────┼─────────┼─────────┤ +│ Latency │ 62 ms │ 103 ms │ 252 ms │ 297 ms │ 119.53 ms │ 58.1 ms │ 1050 ms │ +└─────────┴───────┴────────┴────────┴────────┴───────────┴─────────┴─────────┘ +┌───────────┬─────────┬────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 22 │ 41 │ 60 │ 70 │ 58.27 │ 8.6 │ 22 │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 95.5 kB │ 178 kB │ 260 kB │ 304 kB │ 253 kB │ 37.3 kB │ 95.4 kB │ +└───────────┴─────────┴────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3496 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.06s, 15.2 MB read +48 errors (48 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +15 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬──────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼──────────┼──────────┼────────┤ +│ Latency │ 49 ms │ 75 ms │ 151 ms │ 164 ms │ 82.32 ms │ 25.95 ms │ 313 ms │ +└─────────┴───────┴───────┴────────┴────────┴──────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 61 │ 66 │ 85 │ 99 │ 84.52 │ 8.42 │ 61 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 8.24 kB │ 8.91 kB │ 11.5 kB │ 13.4 kB │ 11.4 kB │ 1.14 kB │ 8.23 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 5071 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 685 kB read +48 errors (48 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +15 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 801 ms │ 1709 ms │ 3676 ms │ 3762 ms │ 1929.08 ms │ 744.64 ms │ 5846 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 3 │ 4 │ 5 │ 3.57 │ 0.59 │ 2 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 86.4 kB │ 115 kB │ 144 kB │ 103 kB │ 16.9 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 214 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +277 requests in 60.09s, 6.16 MB read +48 errors (48 timeouts) + + +---------------- + + + +CLIENTS: *** 20 *** + +Running 60s test @ http://192.168.2.131/ +20 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬───────────┬──────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼───────────┼──────────┼─────────┤ +│ Latency │ 60 ms │ 97 ms │ 232 ms │ 267 ms │ 112.02 ms │ 53.32 ms │ 1054 ms │ +└─────────┴───────┴───────┴────────┴────────┴───────────┴──────────┴─────────┘ +┌───────────┬─────────┬────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 21 │ 52 │ 63 │ 69 │ 62.12 │ 6.59 │ 21 │ +├───────────┼─────────┼────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 91.1 kB │ 226 kB │ 273 kB │ 300 kB │ 269 kB │ 28.6 kB │ 91.1 kB │ +└───────────┴─────────┴────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 3727 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +4k requests in 60.1s, 16.2 MB read +78 errors (78 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/api?foo=bar +20 connections +1 workers + + +┌─────────┬───────┬───────┬────────┬────────┬─────────┬──────────┬────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼───────┼───────┼────────┼────────┼─────────┼──────────┼────────┤ +│ Latency │ 49 ms │ 78 ms │ 164 ms │ 178 ms │ 87.8 ms │ 35.83 ms │ 658 ms │ +└─────────┴───────┴───────┴────────┴────────┴─────────┴──────────┴────────┘ +┌───────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Req/Sec │ 35 │ 55 │ 81 │ 95 │ 79.27 │ 10.5 │ 35 │ +├───────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┼─────────┤ +│ Bytes/Sec │ 4.73 kB │ 7.43 kB │ 10.9 kB │ 12.8 kB │ 10.7 kB │ 1.42 kB │ 4.72 kB │ +└───────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 4756 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +5k requests in 60.07s, 642 kB read +78 errors (78 timeouts) + + +---------------- + +Running 60s test @ http://192.168.2.131/alien.png +20 connections +1 workers + + +┌─────────┬────────┬─────────┬─────────┬─────────┬────────────┬───────────┬─────────┐ +│ Stat │ 2.5% │ 50% │ 97.5% │ 99% │ Avg │ Stdev │ Max │ +├─────────┼────────┼─────────┼─────────┼─────────┼────────────┼───────────┼─────────┤ +│ Latency │ 806 ms │ 1613 ms │ 3348 ms │ 4009 ms │ 1854.07 ms │ 733.32 ms │ 6606 ms │ +└─────────┴────────┴─────────┴─────────┴─────────┴────────────┴───────────┴─────────┘ +┌───────────┬─────────┬─────────┬────────┬────────┬────────┬─────────┬─────────┐ +│ Stat │ 1% │ 2.5% │ 50% │ 97.5% │ Avg │ Stdev │ Min │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Req/Sec │ 2 │ 3 │ 4 │ 5 │ 3.7 │ 0.62 │ 2 │ +├───────────┼─────────┼─────────┼────────┼────────┼────────┼─────────┼─────────┤ +│ Bytes/Sec │ 57.6 kB │ 86.4 kB │ 115 kB │ 144 kB │ 106 kB │ 17.7 kB │ 57.6 kB │ +└───────────┴─────────┴─────────┴────────┴────────┴────────┴─────────┴─────────┘ +┌──────┬───────┐ +│ Code │ Count │ +├──────┼───────┤ +│ 200 │ 222 │ +└──────┴───────┘ + +Req/Bytes counts sampled once per second. +# of samples: 60 + +320 requests in 60.05s, 6.39 MB read +78 errors (78 timeouts) + + +---------------- + diff --git a/lib/PsychicHttp/benchmark/results/psychic-v1.1-websocket-loadtest.log b/lib/PsychicHttp/benchmark/results/psychic-v1.1-websocket-loadtest.log new file mode 100644 index 0000000..8c507a9 --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/psychic-v1.1-websocket-loadtest.log @@ -0,0 +1,246 @@ + + +CLIENTS: *** 1 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 1 +Agent: none + +Completed requests: 1972 +Total errors: 0 +Total time: 60.003 s +Mean latency: 29.8 ms +Effective rps: 33 + +Percentage of requests served within a certain time + 50% 25 ms + 90% 40 ms + 95% 66 ms + 99% 96 ms + 100% 147 ms (longest request) + + +CLIENTS: *** 2 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 2 +Agent: none + +Completed requests: 3144 +Total errors: 0 +Total time: 60.003 s +Mean latency: 37.6 ms +Effective rps: 52 + +Percentage of requests served within a certain time + 50% 32 ms + 90% 58 ms + 95% 82 ms + 99% 114 ms + 100% 160 ms (longest request) + + +CLIENTS: *** 3 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 3 +Agent: none + +Completed requests: 4113 +Total errors: 0 +Total time: 60.005 s +Mean latency: 43.2 ms +Effective rps: 69 + +Percentage of requests served within a certain time + 50% 38 ms + 90% 63 ms + 95% 88 ms + 99% 119 ms + 100% 339 ms (longest request) + + +CLIENTS: *** 4 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 4 +Agent: none + +Completed requests: 4902 +Total errors: 0 +Total time: 60.004 s +Mean latency: 48.3 ms +Effective rps: 82 + +Percentage of requests served within a certain time + 50% 42 ms + 90% 74 ms + 95% 97 ms + 99% 125 ms + 100% 217 ms (longest request) + + +CLIENTS: *** 5 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 5 +Agent: none + +Completed requests: 5522 +Total errors: 0 +Total time: 60.003 s +Mean latency: 53.7 ms +Effective rps: 92 + +Percentage of requests served within a certain time + 50% 48 ms + 90% 81 ms + 95% 102 ms + 99% 122 ms + 100% 324 ms (longest request) + + +CLIENTS: *** 6 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 6 +Agent: none + +Completed requests: 5808 +Total errors: 0 +Total time: 60.004 s +Mean latency: 61.4 ms +Effective rps: 97 + +Percentage of requests served within a certain time + 50% 54 ms + 90% 94 ms + 95% 117 ms + 99% 142 ms + 100% 348 ms (longest request) + + +CLIENTS: *** 7 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 7 +Agent: none + +Completed requests: 6478 +Total errors: 0 +Total time: 60.006 s +Mean latency: 64.1 ms +Effective rps: 108 + +Percentage of requests served within a certain time + 50% 59 ms + 90% 94 ms + 95% 110 ms + 99% 137 ms + 100% 195 ms (longest request) + + +CLIENTS: *** 8 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 8 +Running on cores: 2 +Agent: none + +Completed requests: 6124 +Total errors: 0 +Total time: 60.004 s +Mean latency: 67.8 ms +Effective rps: 102 + +Percentage of requests served within a certain time + 50% 59 ms + 90% 107 ms + 95% 131 ms + 99% 173 ms + 100% 260 ms (longest request) + + +CLIENTS: *** 10 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 10 +Running on cores: 2 +Agent: none + +Completed requests: 5640 +Total errors: 0 +Total time: 60.004 s +Mean latency: 73.7 ms +Effective rps: 94 + +Percentage of requests served within a certain time + 50% 61 ms + 90% 120 ms + 95% 140 ms + 99% 240 ms + 100% 780 ms (longest request) + + +CLIENTS: *** 16 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 16 +Running on cores: 2 +Agent: none + +Completed requests: 5809 +Total errors: 0 +Total time: 60.006 s +Mean latency: 71.6 ms +Effective rps: 97 + +Percentage of requests served within a certain time + 50% 64 ms + 90% 111 ms + 95% 130 ms + 99% 162 ms + 100% 226 ms (longest request) + + +CLIENTS: *** 20 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 20 +Running on cores: 2 +Agent: none + +Completed requests: 5590 +Total errors: 0 +Total time: 60.003 s +Mean latency: 74.4 ms +Effective rps: 93 + +Percentage of requests served within a certain time + 50% 61 ms + 90% 122 ms + 95% 151 ms + 99% 247 ms + 100% 513 ms (longest request) diff --git a/lib/PsychicHttp/benchmark/results/psychic-websocket-loadtest.log b/lib/PsychicHttp/benchmark/results/psychic-websocket-loadtest.log new file mode 100644 index 0000000..812026c --- /dev/null +++ b/lib/PsychicHttp/benchmark/results/psychic-websocket-loadtest.log @@ -0,0 +1,246 @@ + + +CLIENTS: *** 1 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 1 +Agent: none + +Completed requests: 2304 +Total errors: 0 +Total time: 60.002 s +Mean latency: 25.5 ms +Effective rps: 38 + +Percentage of requests served within a certain time + 50% 22 ms + 90% 32 ms + 95% 58 ms + 99% 92 ms + 100% 105 ms (longest request) + + +CLIENTS: *** 2 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 2 +Agent: none + +Completed requests: 3647 +Total errors: 0 +Total time: 60.002 s +Mean latency: 32.3 ms +Effective rps: 61 + +Percentage of requests served within a certain time + 50% 28 ms + 90% 43 ms + 95% 67 ms + 99% 93 ms + 100% 135 ms (longest request) + + +CLIENTS: *** 3 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 3 +Agent: none + +Completed requests: 4629 +Total errors: 0 +Total time: 60.004 s +Mean latency: 38.3 ms +Effective rps: 77 + +Percentage of requests served within a certain time + 50% 34 ms + 90% 51 ms + 95% 79 ms + 99% 110 ms + 100% 152 ms (longest request) + + +CLIENTS: *** 4 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 4 +Agent: none + +Completed requests: 5290 +Total errors: 0 +Total time: 60.003 s +Mean latency: 44.7 ms +Effective rps: 88 + +Percentage of requests served within a certain time + 50% 40 ms + 90% 67 ms + 95% 92 ms + 99% 115 ms + 100% 159 ms (longest request) + + +CLIENTS: *** 5 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 5 +Agent: none + +Completed requests: 5935 +Total errors: 0 +Total time: 60.002 s +Mean latency: 50 ms +Effective rps: 99 + +Percentage of requests served within a certain time + 50% 45 ms + 90% 74 ms + 95% 97 ms + 99% 123 ms + 100% 172 ms (longest request) + + +CLIENTS: *** 6 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 6 +Agent: none + +Completed requests: 6533 +Total errors: 0 +Total time: 60.003 s +Mean latency: 54.5 ms +Effective rps: 109 + +Percentage of requests served within a certain time + 50% 49 ms + 90% 78 ms + 95% 101 ms + 99% 129 ms + 100% 170 ms (longest request) + + +CLIENTS: *** 7 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 7 +Agent: none + +Completed requests: 7086 +Total errors: 0 +Total time: 60.004 s +Mean latency: 58.6 ms +Effective rps: 118 + +Percentage of requests served within a certain time + 50% 54 ms + 90% 85 ms + 95% 107 ms + 99% 130 ms + 100% 184 ms (longest request) + + +CLIENTS: *** 8 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 8 +Running on cores: 2 +Agent: none + +Completed requests: 6994 +Total errors: 0 +Total time: 60.004 s +Mean latency: 59.3 ms +Effective rps: 117 + +Percentage of requests served within a certain time + 50% 54 ms + 90% 88 ms + 95% 109 ms + 99% 134 ms + 100% 176 ms (longest request) + + +CLIENTS: *** 10 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 10 +Running on cores: 2 +Agent: none + +Completed requests: 7197 +Total errors: 0 +Total time: 60.004 s +Mean latency: 57.7 ms +Effective rps: 120 + +Percentage of requests served within a certain time + 50% 53 ms + 90% 83 ms + 95% 98 ms + 99% 123 ms + 100% 176 ms (longest request) + + +CLIENTS: *** 16 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 16 +Running on cores: 2 +Agent: none + +Completed requests: 7173 +Total errors: 0 +Total time: 60.002 s +Mean latency: 57.9 ms +Effective rps: 120 + +Percentage of requests served within a certain time + 50% 53 ms + 90% 83 ms + 95% 100 ms + 99% 123 ms + 100% 156 ms (longest request) + + +CLIENTS: *** 20 *** + + +Target URL: ws://192.168.2.131/ws +Max time (s): 60 +Concurrent clients: 20 +Running on cores: 2 +Agent: none + +Completed requests: 6883 +Total errors: 0 +Total time: 60.002 s +Mean latency: 60.4 ms +Effective rps: 115 + +Percentage of requests served within a certain time + 50% 55 ms + 90% 92 ms + 95% 111 ms + 99% 138 ms + 100% 175 ms (longest request) diff --git a/lib/PsychicHttp/benchmark/websocket-client-test.js b/lib/PsychicHttp/benchmark/websocket-client-test.js new file mode 100644 index 0000000..3021bb0 --- /dev/null +++ b/lib/PsychicHttp/benchmark/websocket-client-test.js @@ -0,0 +1,36 @@ +#!/usr/bin/env node + +const WebSocket = require('ws'); + +const uri = 'ws://192.168.2.131/ws'; + +async function websocketClient() { + console.log(`Starting test`); + for (let i = 0; i < 1000000; i++) { + const ws = new WebSocket(uri); + + if (i % 100 == 0) + console.log(`Count: ${i}`); + + ws.on('open', () => { + //console.log(`Connected`); + }); + + ws.on('message', (message) => { + //console.log(`Message: ${message}`); + ws.close(); + }); + + ws.on('error', (error) => { + console.error(`Error: ${error.message}`); + }); + + await new Promise((resolve) => { + ws.on('close', () => { + resolve(); + }); + }); + } +} + +websocketClient(); \ No newline at end of file diff --git a/lib/PsychicHttp/component.mk b/lib/PsychicHttp/component.mk new file mode 100644 index 0000000..bb5bb16 --- /dev/null +++ b/lib/PsychicHttp/component.mk @@ -0,0 +1,3 @@ +COMPONENT_ADD_INCLUDEDIRS := src +COMPONENT_SRCDIRS := src +CXXFLAGS += -fno-rtti diff --git a/lib/PsychicHttp/examples/arduino/.gitignore b/lib/PsychicHttp/examples/arduino/.gitignore new file mode 100644 index 0000000..9e5f911 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/.gitignore @@ -0,0 +1,6 @@ +.pio +.vscode/ +.vscode/.browse.c_cpp.db* +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/ipch diff --git a/lib/PsychicHttp/examples/arduino/arduino.ino b/lib/PsychicHttp/examples/arduino/arduino.ino new file mode 100644 index 0000000..c0fe060 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/arduino.ino @@ -0,0 +1,497 @@ +/* + PsychicHTTP Server Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. +*/ + +/********************************************************************************************** +* Note: this demo relies on the following libraries (Install via Library Manager) +* ArduinoJson UrlEncode +**********************************************************************************************/ + +/********************************************************************************************** +* Note: this demo relies on various files to be uploaded on the LittleFS partition +* Follow instructions here: https://randomnerdtutorials.com/esp32-littlefs-arduino-ide/ +**********************************************************************************************/ + +#include +#include +#include +#include +#include +#include "_secret.h" +#include +#include //uncomment this to enable HTTPS / SSL + +#ifndef WIFI_SSID + #error "You need to enter your wifi credentials. Rename secret.h to _secret.h and enter your credentials there." +#endif + +//Enter your WIFI credentials in secret.h +const char *ssid = WIFI_SSID; +const char *password = WIFI_PASS; + +// Set your SoftAP credentials +const char *softap_ssid = "PsychicHttp"; +const char *softap_password = ""; +IPAddress softap_ip(10, 0, 0, 1); + +//credentials for the /auth-basic and /auth-digest examples +const char *app_user = "admin"; +const char *app_pass = "admin"; +const char *app_name = "Your App"; + +//hostname for mdns (psychic.local) +const char *local_hostname = "psychic"; + +//#define PSY_ENABLE_SSL to enable ssl +#ifdef PSY_ENABLE_SSL + bool app_enable_ssl = true; + String server_cert; + String server_key; +#endif + +//our main server object +#ifdef PSY_ENABLE_SSL + PsychicHttpsServer server; +#else + PsychicHttpServer server; +#endif +PsychicWebSocketHandler websocketHandler; +PsychicEventSource eventSource; + +bool connectToWifi() +{ + //dual client and AP mode + WiFi.mode(WIFI_AP_STA); + + // Configure SoftAP + WiFi.softAPConfig(softap_ip, softap_ip, IPAddress(255, 255, 255, 0)); // subnet FF FF FF 00 + WiFi.softAP(softap_ssid, softap_password); + IPAddress myIP = WiFi.softAPIP(); + Serial.print("SoftAP IP Address: "); + Serial.println(myIP); + + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.begin(ssid, password); + // Auto reconnect is set true as default + // To set auto connect off, use the following function + // WiFi.setAutoReconnect(false); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + + // We start by connecting to a WiFi network + // To debug, please enable Core Debug Level to Verbose + if (connectToWifi()) + { + //set up our esp32 to listen on the local_hostname.local domain + if (!MDNS.begin(local_hostname)) { + Serial.println("Error starting mDNS"); + return; + } + MDNS.addService("http", "tcp", 80); + + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + //look up our keys? + #ifdef PSY_ENABLE_SSL + if (app_enable_ssl) + { + File fp = LittleFS.open("/server.crt"); + if (fp) + { + server_cert = fp.readString(); + + // Serial.println("Server Cert:"); + // Serial.println(server_cert); + } + else + { + Serial.println("server.pem not found, SSL not available"); + app_enable_ssl = false; + } + fp.close(); + + File fp2 = LittleFS.open("/server.key"); + if (fp2) + { + server_key = fp2.readString(); + + // Serial.println("Server Key:"); + // Serial.println(server_key); + } + else + { + Serial.println("server.key not found, SSL not available"); + app_enable_ssl = false; + } + fp2.close(); + } + #endif + + //setup server config stuff here + server.config.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + + #ifdef PSY_ENABLE_SSL + server.ssl_config.httpd.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + + //do we want secure or not? + if (app_enable_ssl) + { + server.listen(443, server_cert.c_str(), server_key.c_str()); + + //this creates a 2nd server listening on port 80 and redirects all requests HTTPS + PsychicHttpServer *redirectServer = new PsychicHttpServer(); + redirectServer->config.ctrl_port = 20424; // just a random port different from the default one + redirectServer->listen(80); + redirectServer->onNotFound([](PsychicRequest *request) { + String url = "https://" + request->host() + request->url(); + return request->redirect(url.c_str()); + }); + } + else + server.listen(80); + #else + server.listen(80); + #endif + + //serve static files from LittleFS/www on / only to clients on same wifi network + //this is where our /index.html file lives + server.serveStatic("/", LittleFS, "/www/")->setFilter(ON_STA_FILTER); + + //serve static files from LittleFS/www-ap on / only to clients on SoftAP + //this is where our /index.html file lives + server.serveStatic("/", LittleFS, "/www-ap/")->setFilter(ON_AP_FILTER); + + //serve static files from LittleFS/img on /img + //it's more efficient to serve everything from a single www directory, but this is also possible. + server.serveStatic("/img", LittleFS, "/img/"); + + //you can also serve single files + server.serveStatic("/myfile.txt", LittleFS, "/custom.txt"); + + //example callback everytime a connection is opened + server.onOpen([](PsychicClient *client) { + Serial.printf("[http] connection #%u connected from %s\n", client->socket(), client->localIP().toString()); + }); + + //example callback everytime a connection is closed + server.onClose([](PsychicClient *client) { + Serial.printf("[http] connection #%u closed from %s\n", client->socket(), client->localIP().toString()); + }); + + //api - json message passed in as post body + server.on("/api", HTTP_POST, [](PsychicRequest *request) + { + //load our JSON request + StaticJsonDocument<1024> json; + String body = request->body(); + DeserializationError err = deserializeJson(json, body); + + //create our response json + StaticJsonDocument<128> output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (json.containsKey("foo")) + { + String foo = json["foo"]; + output["foo"] = foo; + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + return request->reply(200, "application/json", jsonBuffer.c_str()); + }); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/ip", HTTP_GET, [](PsychicRequest *request) + { + String output = "Your IP is: " + request->client()->remoteIP().toString(); + return request->reply(output.c_str()); + }); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/api", HTTP_GET, [](PsychicRequest *request) + { + //create a response object + StaticJsonDocument<128> output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + String foo = request->getParam("foo")->name(); + output["foo"] = foo; + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + return request->reply(200, "application/json", jsonBuffer.c_str()); + }); + + //how to redirect a request + server.on("/redirect", HTTP_GET, [](PsychicRequest *request) + { + return request->redirect("/alien.png"); + }); + + //how to do basic auth + server.on("/auth-basic", HTTP_GET, [](PsychicRequest *request) + { + if (!request->authenticate(app_user, app_pass)) + return request->requestAuthentication(BASIC_AUTH, app_name, "You must log in."); + return request->reply("Auth Basic Success!"); + }); + + //how to do digest auth + server.on("/auth-digest", HTTP_GET, [](PsychicRequest *request) + { + if (!request->authenticate(app_user, app_pass)) + return request->requestAuthentication(DIGEST_AUTH, app_name, "You must log in."); + return request->reply("Auth Digest Success!"); + }); + + //example of getting / setting cookies + server.on("/cookies", HTTP_GET, [](PsychicRequest *request) + { + PsychicResponse response(request); + + int counter = 0; + if (request->hasCookie("counter")) + { + counter = std::stoi(request->getCookie("counter").c_str()); + counter++; + } + + char cookie[10]; + sprintf(cookie, "%i", counter); + + response.setCookie("counter", cookie); + response.setContent(cookie); + return response.send(); + }); + + //example of getting POST variables + server.on("/post", HTTP_POST, [](PsychicRequest *request) + { + String output; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + }); + + //you can set up a custom 404 handler. + server.onNotFound([](PsychicRequest *request) + { + return request->reply(404, "text/html", "Custom 404 Handler"); + }); + + //handle a very basic upload as post body + PsychicUploadHandler *uploadHandler = new PsychicUploadHandler(); + uploadHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + Serial.printf("Writing %d/%d bytes to: %s\n", (int)index+(int)len, request->contentLength(), path.c_str()); + + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + uploadHandler->onRequest([](PsychicRequest *request) + { + String url = "/" + request->getFilename(); + String output = "" + url + ""; + + return request->reply(output.c_str()); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + server.on("/upload/*", HTTP_POST, uploadHandler); + + //a little bit more complicated multipart form + PsychicUploadHandler *multipartHandler = new PsychicUploadHandler(); + multipartHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + //some progress over serial. + Serial.printf("Writing %d bytes to: %s\n", (int)len, path.c_str()); + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + multipartHandler->onRequest([](PsychicRequest *request) + { + PsychicWebParameter *file = request->getParam("file_upload"); + + String url = "/" + file->value(); + String output; + + output += "" + url + "
\n"; + output += "Bytes: " + String(file->size()) + "
\n"; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + server.on("/multipart", HTTP_POST, multipartHandler); + + //a websocket echo server + websocketHandler.onOpen([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u connected from %s\n", client->socket(), client->localIP().toString()); + client->sendMessage("Hello!"); + }); + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) { + Serial.printf("[socket] #%d sent: %s\n", request->client()->socket(), (char *)frame->payload); + return request->reply(frame); + }); + websocketHandler.onClose([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u closed from %s\n", client->socket(), client->localIP().toString()); + }); + server.on("/ws", &websocketHandler); + + //EventSource server + eventSource.onOpen([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u connected from %s\n", client->socket(), client->localIP().toString()); + client->send("Hello user!", NULL, millis(), 1000); + }); + eventSource.onClose([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u closed from %s\n", client->socket(), client->localIP().toString()); + }); + server.on("/events", &eventSource); + } +} + +unsigned long lastUpdate = 0; +char output[60]; + +void loop() +{ + if (millis() - lastUpdate > 2000) + { + sprintf(output, "Millis: %d\n", millis()); + websocketHandler.sendAll(output); + + sprintf(output, "%d", millis()); + eventSource.send(output, "millis", millis(), 0); + + lastUpdate = millis(); + } +} \ No newline at end of file diff --git a/lib/PsychicHttp/examples/arduino/arduino_captive_portal/README.md b/lib/PsychicHttp/examples/arduino/arduino_captive_portal/README.md new file mode 100644 index 0000000..f965eda --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/arduino_captive_portal/README.md @@ -0,0 +1,60 @@ +**1) SUMMARY** + +This example implements a **captive portal** with library DNSServer, ie web page which opens automatically when user connects Wifi network (eg "PsychitHttp"). + +Captiveportal is implemented in **ESPAsyncWebServer** [https://github.com/me-no-dev/ESPAsyncWebServer/blob/master/examples/CaptivePortal/CaptivePortal.ino](url) and in **arduino-esp32 examples** [https://github.com/espressif/arduino-esp32/blob/master/libraries/DNSServer/examples/CaptivePortal/CaptivePortal.ino](url) + +This feature can be implemented with Psychichttp with a **dedicated handler**, as shown in code below. + +Code highlights are added below for reference. + +**2) CODE** + +**Definitions** +``` +// captiveportal +// credits https://github.com/me-no-dev/ESPAsyncWebServer/blob/master/examples/CaptivePortal/CaptivePortal.ino +//https://github.com/espressif/arduino-esp32/blob/master/libraries/DNSServer/examples/CaptivePortal/CaptivePortal.ino +#include +DNSServer dnsServer; +class CaptiveRequestHandler : public PsychicWebHandler { // handler +public: + CaptiveRequestHandler() {}; + virtual ~CaptiveRequestHandler() {}; + bool canHandle(PsychicRequest*request){ + // ... if needed some tests ... return(false); + return true; // activate captive portal + } + esp_err_t handleRequest(PsychicRequest *request) { + //PsychicFileResponse response(request, LittleFS, "/captiveportal.html"); // uncomment : for captive portal page, if any, eg "captiveportal.html" + //return response.send(); // uncomment : return captive portal page + return request->reply(200,"text/html","Welcome to captive portal !"); // simple text, comment if captive portal page + } +}; +CaptiveRequestHandler *captivehandler=NULL; // handler for captive portal +``` + +**setup()** +``` + // captive portal + dnsServer.start(53, "*", WiFi.softAPIP()); // DNS requests are executed over port 53 (standard) + captivehandler= new CaptiveRequestHandler(); // create captive portal handler, important : after server.on since handlers are triggered on a first created/first trigerred basis + server.addHandler(captivehandler); // captive portal handler (last handler) +``` + +**loop()** +``` + dnsServer.processNextRequest(); // captive portal +``` + +**3) RESULT** + +**Access Point (web page is opened automatically when connecting to PsychicHttp AP)** +![captive portal access point](images/accesspoint.png) + +**Station (web page is shown whatever url for Station IP, eg 192.168.1.50/abcdefg** +![captive portal station point](images/station.png) + + + + diff --git a/lib/PsychicHttp/examples/arduino/arduino_captive_portal/arduino_captive_portal.ino b/lib/PsychicHttp/examples/arduino/arduino_captive_portal/arduino_captive_portal.ino new file mode 100644 index 0000000..fbe83a3 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/arduino_captive_portal/arduino_captive_portal.ino @@ -0,0 +1,144 @@ +/* + PsychicHTTP Server Captive Portal Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. +*/ + +#include +#include +#include +#include +#include + +char* TAG = "CAPTPORT"; + +// captiveportal +// credits https://github.com/me-no-dev/ESPAsyncWebServer/blob/master/examples/CaptivePortal/CaptivePortal.ino +//https://github.com/espressif/arduino-esp32/blob/master/libraries/DNSServer/examples/CaptivePortal/CaptivePortal.ino +#include +DNSServer dnsServer; +class CaptiveRequestHandler : public PsychicWebHandler { // handler +public: + CaptiveRequestHandler() {}; + virtual ~CaptiveRequestHandler() {}; + bool canHandle(PsychicRequest*request){ + // ... if needed some tests ... return(false); + return true; // activate captive portal + } + esp_err_t handleRequest(PsychicRequest *request) { + //PsychicFileResponse response(request, LittleFS, "/captiveportal.html"); // uncomment : for captive portal page, if any, eg "captiveportal.html" + //return response.send(); // uncomment : return captive portal page + return request->reply(200,"text/html","Welcome to captive portal !"); // simple text, comment if captive portal page + } +}; +CaptiveRequestHandler *captivehandler=NULL; // handler for captive portal + +const char* ssid = "mySSID"; // replace with your SSID (mode STATION) +const char* password = "myPassword"; // replace with you password (mode STATION) + +// Set your SoftAP credentials +const char *softap_ssid = "PsychicHttp"; +const char *softap_password = ""; +IPAddress softap_ip(10, 0, 0, 1); + +//hostname for mdns (psychic.local) +const char *local_hostname = "psychic"; + +//our main server object +PsychicHttpServer server; + +bool connectToWifi() { + //dual client and AP mode + WiFi.mode(WIFI_AP_STA); + + // Configure SoftAP + WiFi.softAPConfig(softap_ip, softap_ip, IPAddress(255, 255, 255, 0)); // subnet FF FF FF 00 + WiFi.softAP(softap_ssid, softap_password); + IPAddress myIP = WiFi.softAPIP(); + ESP_LOGI(TAG,"SoftAP IP Address: %s", myIP.toString().c_str()); + ESP_LOGI(TAG,"[WiFi] Connecting to %s", ssid); + + WiFi.begin(ssid, password); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) { + switch (WiFi.status()) { + case WL_NO_SSID_AVAIL: + ESP_LOGE(TAG,"[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + ESP_LOGI(TAG,"[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + ESP_LOGI(TAG,"[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + ESP_LOGI(TAG,"[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + ESP_LOGI(TAG,"[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + ESP_LOGI(TAG,"[WiFi] WiFi is connected, IP address %s",WiFi.localIP().toString().c_str()); + return true; + break; + default: + ESP_LOGI(TAG,"[WiFi] WiFi Status: %d",WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) { + ESP_LOGI(TAG,"[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else numberOfTries--; + } + + return false; +} // end connectToWifi + +void setup() { + Serial.begin(115200); + delay(10); + + // Wifi + if (connectToWifi()) { // set up our esp32 to listen on the local_hostname.local domain + if (!MDNS.begin(local_hostname)) { + ESP_LOGE(TAG,"Error starting mDNS"); + return; + } + MDNS.addService("http", "tcp", 80); + + if(!LittleFS.begin()) { + ESP_LOGI(TAG,"ERROR : LittleFS Mount Failed."); + return; + } + + //setup server config stuff here + server.config.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + server.listen(80); + + DefaultHeaders::Instance().addHeader("Server", "PsychicHttp"); + + // captive portal + dnsServer.start(53, "*", WiFi.softAPIP()); // DNS requests are executed over port 53 (standard) + captivehandler= new CaptiveRequestHandler(); // create captive portal handler, important : after server.on since handlers are triggered on a first created/first trigerred basis + server.addHandler(captivehandler); // captive portal handler (last handler) + } // end set up our esp32 to listen on the local_hostname.local domain +} // end setup + +void loop() { + dnsServer.processNextRequest(); // captive portal +} diff --git a/lib/PsychicHttp/examples/arduino/arduino_captive_portal/images/accesspoint.png b/lib/PsychicHttp/examples/arduino/arduino_captive_portal/images/accesspoint.png new file mode 100644 index 0000000000000000000000000000000000000000..76c35902b11e00dd438664abe730418f15c77a14 GIT binary patch literal 15389 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 literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/arduino_captive_portal/images/station.png b/lib/PsychicHttp/examples/arduino/arduino_captive_portal/images/station.png new file mode 100644 index 0000000000000000000000000000000000000000..525a530a5b43726e51eccd3ff544e8819818fa0a GIT binary patch literal 10008 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 literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/README.md b/lib/PsychicHttp/examples/arduino/arduino_ota/README.md new file mode 100644 index 0000000..d5f8183 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/arduino_ota/README.md @@ -0,0 +1,138 @@ +**OTA update example for PsychicHttp** + +Example of OTA (Over The Air) update implementation for PsychicHttp, using Arduino IDE. + +**Requirements** +Requirements for project are : +- OTA update for code (firmware) +- OTA update for data (littlefs) +- manual restart of ESP32, triggered by User (no automatic restart after code or data file upload) + +**Implementation** + +OTA update relies on handler PsychicUploadHandler. + +Screenshots and Code are shown below. + +**Credits** + +https://github.com/hoeken/PsychicHttp/blob/master/src/PsychicUploadHandler.cpp + +https://github.com/hoeken/PsychicHttp/issues/30 + +**Configuration** + +Example has been implemented with following configuration :\ +Arduino IDE 1.8.19\ +arduino-32 v2.0.15\ +PsychicHttp 1.1.1\ +ESP32S3 + +**Example Files Structure** + +``` +arduino_ota + data + | update.html + arduino_ota.ino + code.bin + littlefs.bin + README +``` +"code.bin" and "littlefs.bin" are example update files which can be used to update respectily code (firmware) or data (littlefs). + +"Real" update files can be generated on Arduino IDE 1.x : +- for code, menu "Sketch -> Export bin" +- for data, using plugin arduino-esp32fs-plugin https://github.com/lorol/arduino-esp32fs-plugin/releases + +**SCREENSHOTS** + +**Update code (firmware)** +![otaupdate1](images/otaupdate1.png) + +![otaupdate2](images/otaupdate2.png)\ +```ESP-ROM:esp32s3-20210327 +Build:Mar 27 2021 +rst:0x1 (POWERON),boot:0x2b (SPI_FAST_FLASH_BOOT) +SPIWP:0xee +mode:DIO, clock div:1 +load:0x3fce3808,len:0x4bc +load:0x403c9700,len:0xbd8 +load:0x403cc700,len:0x2a0c +entry 0x403c98d0 +[332885][I][PsychicHttpServer.cpp:236] openCallback(): [psychic] New client connected 51 +[332895][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 867306 +[332908][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 862016 +[332919][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[332929][I][arduino_ota.ino:133] operator()(): [OTA] update begin, filename code.bin +[333082][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 856272 +[333095][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[snip] +[339557][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 416 +[339566][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 1 +[339718][I][arduino_ota.ino:165] operator()(): [OTA] Update Success: 867072 written +[339726][I][arduino_ota.ino:184] operator()(): [OTA] Update code or data OK Update.errorString() No Error +[339738][I][PsychicHttpServer.cpp:236] openCallback(): [psychic] New client connected 52 +[339747][I][PsychicHttpServer.cpp:262] closeCallback(): [psychic] Client disconnected 52 + +``` + + +**Update data (littlefs)** + +![otaupdate3](images/otaupdate3.png) +``` +[ 48216][I][PsychicHttpServer.cpp:236] openCallback(): [psychic] New client connected 51 +[ 48226][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 1573100 +[ 48239][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 1567810 +[ 48250][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[ 48261][I][arduino_ota.ino:133] operator()(): [OTA] update begin, filename littlefs.bin +[ 48376][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 1562066 +[ 48389][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[ 48408][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 1556322 +[ 48421][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 1550578 +[ 48432][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[snip] +[ 54317][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 16930 +[ 54327][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[ 54340][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 11186 +[ 54351][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[ 54363][I][PsychicUploadHandler.cpp:164] _multipartUploadHandler(): [psychic] Remaining size : 5442 +[ 54375][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 0 +[ 54386][I][arduino_ota.ino:128] operator()(): [OTA] updateHandler->onUpload _error 0 Update.hasError() 0 last 1 +[ 54396][I][arduino_ota.ino:165] operator()(): [OTA] Update Success: 1572864 written +[ 54404][I][arduino_ota.ino:184] operator()(): [OTA] Update code or data OK Update.errorString() No Error +[ 54415][I][PsychicHttpServer.cpp:236] openCallback(): [psychic] New client connected 52 +[ 54424][I][PsychicHttpServer.cpp:262] closeCallback(): [psychic] Client disconnected 52 + +``` + +**Restart** + +![otaupdate4](images/otaupdate4.png) + +![otaupdate5](images/otaupdate5.png) + +``` +[110318][I][PsychicHttpServer.cpp:236] openCallback(): [psychic] New client connected 51 +[110327][I][arduino_ota.ino:205] operator()(): [OTA] Restarting ... +[110338][I][PsychicHttpServer.cpp:236] openCallback(): [psychic] New client connected 52 +[111317][W][WiFiGeneric.cpp:1062] _eventCallback(): Reason: 8 - ASSOC_LEAVE +[111319][I][PsychicHttpServer.cpp:262] closeCallback(): [psychic] Client disconnected 51 +[111332][I][PsychicHttpServer.cpp:262] closeCallback(): [psychic] Client disconnected 52 +ESP-ROM:esp32s3-20210327 +Build:Mar 27 2021 +rst:0xc (RTC_SW_CPU_RST),boot:0x8 (SPI_FAST_FLASH_BOOT) +Saved PC:0x420984ae +SPIWP:0xee +mode:DIO, clock div:1 +load:0x3fce3808,len:0x4bc +load:0x403c9700,len:0xbd8 +load:0x403cc700,len:0x2a0c +entry 0x403c98d0 +[ 283][I][arduino_ota.ino:57] connectToWifi(): [OTA] [WiFi] WiFi is disconnected +[ 791][I][arduino_ota.ino:60] connectToWifi(): [OTA] [WiFi] WiFi is connected, IP address 192.168.1.50 + +``` + + diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/arduino_ota.ino b/lib/PsychicHttp/examples/arduino/arduino_ota/arduino_ota.ino new file mode 100644 index 0000000..47f611f --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/arduino_ota/arduino_ota.ino @@ -0,0 +1,219 @@ +/* + Over The Air (OTA) update example for PsychicHttp web server + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. + +*/ +char *TAG = "OTA"; // ESP_LOG tag + +// PsychicHttp +#include +#include +#include +#include +#include +PsychicHttpServer server; // main server object +const char *local_hostname = "psychichttp"; // hostname for mdns + +// OTA +#include +bool esprestart=false; // true if/when ESP should be restarted, after OTA update + +// Wifi +const char *ssid = "SSID"; // your SSID +const char *password = "PASSWORD"; // your PASSWORD + +bool connectToWifi() { // Wifi + //client in STA mode + WiFi.mode(WIFI_AP_STA); + WiFi.begin(ssid,password); + + WiFi.begin(ssid, password); + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) { + switch (WiFi.status()) { + case WL_NO_SSID_AVAIL: + ESP_LOGE(TAG,"[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + ESP_LOGI(TAG,"[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + ESP_LOGI(TAG,"[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + ESP_LOGI(TAG,"[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + ESP_LOGI(TAG,"[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + ESP_LOGI(TAG,"[WiFi] WiFi is connected, IP address %s",WiFi.localIP().toString().c_str()); + return true; + break; + default: + ESP_LOGI(TAG,"[WiFi] WiFi Status: %d",WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) { + ESP_LOGI(TAG,"[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else numberOfTries--; + } + return false; +} + + +// ======================================================================= +// setup +// ======================================================================= +void setup() +{ Serial.begin(115200); + delay(10); + + // Wifi + if (connectToWifi()) { //set up our esp32 to listen on the local_hostname.local domain + if (!MDNS.begin(local_hostname)) { + ESP_LOGE(TAG,"Error starting mDNS"); + return; + } + MDNS.addService("http", "tcp", 80); + + if(!LittleFS.begin()) { + ESP_LOGI(TAG,"ERROR : LittleFS Mount Failed."); + return; + } + + //setup server config stuff here + server.config.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + server.listen(80); + + DefaultHeaders::Instance().addHeader("Server", "PsychicHttp"); + + //server.maxRequestBodySize=2*1024*1024; // 2Mb, change default value if needed + //server.maxUploadSize=64*1024*1024; // 64Mb, change default value if needed + + //you can set up a custom 404 handler. + // curl -i http://psychic.local/404 + server.onNotFound([](PsychicRequest *request) { + return request->reply(404, "text/html", "Custom 404 Handler"); + }); + + // OTA + PsychicUploadHandler *updateHandler = new PsychicUploadHandler(); // create handler for OTA update + updateHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { // onUpload + /* callback to upload code (firmware) or data (littlefs) + * callback is triggered for each file chunk, from first chunk (index is 0) to last chunk (last is true) + * callback is triggered by handler in handleRequest(), after _multipartUploadHandler() * + * filename : name of file to upload, with naming convention below + * "*code.bin" for code (firmware) update, eg "v1_code.bin" + * "*littlefs.bin" for data (little fs) update, eg "v1_littlefs.bin" * + */ + + int command; //command : firmware and filesystem update type, ie code (U_FLASH 0) or data (U_SPIFFS 100) + ESP_LOGI(TAG,"updateHandler->onUpload _error %d Update.hasError() %d last %d", Update.getError(), Update.hasError(), last); + + // Update.abort() replaces 1st error (eg "UPDATE_ERROR_ERASE") with abort error ("UPDATE_ERROR_ABORT") so root cause is lost + if (!Update.hasError()) { // no error encountered so far during update, process current chunk + if (!index){ // index is 0, begin update (first chunk) + ESP_LOGI(TAG,"update begin, filename %s", filename.c_str()); + Update.clearError(); // first chunk, clear Update error if any + // check if update file is code, data or sd card one + if (!filename.endsWith("code.bin") && !filename.endsWith("littlefs.bin")) { // incorrect file name + ESP_LOGE(TAG,"ERROR : filename %s format is incorrect", filename.c_str()); + if (!Update.hasError()) Update.abort(); + return(ESP_FAIL); + } // end incorrect file name + else { // file name is correct + // check update type : code or data + if (filename.endsWith("code.bin")) command=U_FLASH; // update code + else command=U_SPIFFS; // update data + if (!Update.begin(UPDATE_SIZE_UNKNOWN, command)) { // start update with max available size + // error, begin is KO + if (!Update.hasError()) Update.abort(); // abort + ESP_LOGE(TAG,"ERROR : update.begin error Update.errorString() %s",Update.errorString()); + return(ESP_FAIL); + } + } // end file name is correct + } // end begin update + + if ((len) && (!Update.hasError())) { // ongoing update if no error encountered + if (Update.write(data, len) != len) { + // error, write is KO + if (!Update.hasError()) Update.abort(); + ESP_LOGE(TAG,"ERROR : update.write len %d Update.errorString() %s",len, Update.errorString()) ; + return(ESP_FAIL); + } + } // end ongoing update + + if ((last) && (!Update.hasError())) { // last update if no error encountered + if (Update.end(true)) { // update end is OKTEST + ESP_LOGI(TAG, "Update Success: %u written", index+len); + } + else { // update end is KO + if (!Update.hasError()) Update.abort(); // abort + ESP_LOGE(TAG,"ERROR : update end error Update.errorString() %s", Update.errorString()); + return(ESP_FAIL); + } + } // last update if no error encountered + return(ESP_OK); + } // end no error encountered so far during update, process current chunk + else { // error encountered so far during update + return(ESP_FAIL); + } + }); // end onUpload + + updateHandler->onRequest([](PsychicRequest *request) { // triggered when update is completed (either OK or KO) and returns request's response (important) + String result; // request result + // code below is executed when update is finished + if (!Update.hasError()) { // update is OK + ESP_LOGI(TAG,"Update code or data OK Update.errorString() %s", Update.errorString()); + result = "Update done for file."; + return request->reply(200,"text/html",result.c_str()); + // ESP.restart(); // restart ESP if needed + } // end update is OK + else { // update is KO, send request with pretty print error + result = " Update.errorString() " + String(Update.errorString()); + ESP_LOGE(TAG,"ERROR : error %s",result.c_str()); + return request->reply(500, "text/html", result.c_str()); + } // end update is KO + }); + + server.on("/update", HTTP_GET, [](PsychicRequest*request){ + PsychicFileResponse response(request, LittleFS, "/update.html"); + return response.send(); + }); + + server.on("/update", HTTP_POST, updateHandler); + + server.on("/restart", HTTP_POST, [](PsychicRequest *request) { + String output = "Restarting ..."; + ESP_LOGI(TAG,"%s",output.c_str()); + esprestart=true; + return request->reply(output.c_str()); + }); + } // end onRequest + +} // end setup + +// ======================================================================= +// loop +// ======================================================================= +void loop() { + delay(2000); + if (esprestart) ESP.restart(); // restart ESP +} // end loop diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/code.bin b/lib/PsychicHttp/examples/arduino/arduino_ota/code.bin new file mode 100644 index 0000000000000000000000000000000000000000..f9842f4704d38260b3fa3521102a8467f506f9cf GIT binary patch literal 867072 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

cts&2Y+gU+pPh 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�a&iBL(}{+9+#0>}(()tQQqRa5! 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 ixz@ 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

BQ_-s78@tSeX_|i4LbSiU?WLe~B@Pj(*%xD3V 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 ZEV-@mkjRI2=)bdUyp>m#E0Zw|`Y&h}P)q;- literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate3.png b/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate3.png new file mode 100644 index 0000000000000000000000000000000000000000..ecefade79f45571ff7f1f40d8e1af9a59c1321fd GIT binary patch literal 60047 zcmd?R^;cU@6zB`Z3KS>>ic6s_R-m|BAyC|*c#FFQCqRJ~*W&JO#U((X6nA%m2e$wr z=%wF#@B8V#`v<(2waz*-lQ}b!efHjG=CkJ{OjTJH4~GH=1qB69?z6Ny3d%F&(_!)) z^Qpv;dgc1*gbGxb{e)6AO11ZtLAR7tl0-qNiNU@5hVhigcKWOfL_vAw`tLwpwV?Gx zLD_#RCoQSzX>_=P4VpH)!8#3jOsH*??@})qGE8vMQYQS?RmED8U?_>pgzLgg(}QNH zuTuY88$SZ8`5Ddudx*<(reu8y)z{LJ=#m&eT!;Y@OchCPI4g)pv4Qkd#rMF=jwMv;gmSVQf35?&b}RUfMB^K(>1Czq!N z7oDiE#^3z!-kys8b^GVV|NDSE$zOjT@P9ne^zG46b&8&?(3P?^?{hd@i1!|37ZQ@E zWLNRII?Ux2w6#826?Hvc_GjkgjB_};Wwe>d`ftPr+BA(zKfPiCU;$EBl#LECI>>atm-#IW5^EVX?`PHE11LuEHWC7YG76 zjiI`A2jkVBwK=G%CHJr0XtT|8a6CRB-lvJ$Hi|6V%U~jI2DmvmVw5w50RF9)D$_db z1Sk@KG;v3Jzw&Q*7=_U z7W?Mf_4)M{*n2B~up2n3(eW`{Ia^GLoSeXR2ww;tsrt+xdB`iPwiI*pA1y;x7zbK5tl>eY;F_d!_mF9$MGgbG@K7+cixG0(rcG>DWm zM}(j9h~K-GeWJBZMY|(p2=32miWp`9nw_>3enPuf4Z7p#xK_ta6KsYBy}_EM7H-tZ z_CEJ`qpD7*u@h%{OVj#spO0mK!brbrp>8!#E}qecglI$J5edsmzBQp9^rSb8!a!j% z?llDAAChC;6}s_5DuO^_G0JHd^8KhC0ciIZ7qaz0SHQ=>Ed}-#X`jFcFw_u6n0+Rg zb`s5@->43jGMeCDtMF_QyZ)MJ5HdGI_KUM;Xb~D2$+-v(?n!oGx0j}HHVh}x7YX3xXmhw z$J2F&>1JmJ-hkpcqs+1u-t>EfuFVS+38cIaof2kClp#Omd*u{q@%sxRB|qz5Pq*Hj zdJA&3_`>VO{on!B>lX~2JK#+c=edPz-wxZywIGD|GJ3rRxkIO}))gJ}^X3MVa@KjF zVi3r`%Rmdh8PnImWt+%64!g+YvoE?TiSp3K->US0H911%Y-d4llYJrXZvB!SMyT*X zoCU(b0U{DF3G8?Mw49)VtNOP_;M z{u?gtY;{vK9g|FPf5In&4S2XHUY%}o45!fdi)`*3q}T#hnD#o4g%Wxs`Y^wWc8gRe z$=ztCAOETId+W#WgA|anM1n*+ih5d=P|}adD=+WaKi&H!qQ@RDp^tGh z+8$DJ)9rsnzMJe8>pzn?vR9b=-d07R;+nhe# z^hW;32p=OvWNY6^+v8b`zxvT)!}h>+jE&*~t8(m^o94r1HI?^nF4hd$b6FWtI(GU& ze%@%R0gY@Yx(7<{d>CsIwJczd>uO>5|+Gc6m%|Z|DB6`pm2+blF2NES$F^Q<|Ew zV~`>9V@4Gk7|vVdaz>Vz_QT}|Z!oKVE_-i`FW8h zJ)QS=^@Vv^DVmt(lgfSqnAa6X?W|_O5P6z<9JAg904ckHYIcISpC*aj_c3x`_|Dk0 zYR_|Cl~eoy;hiF-?1Ar(**13De{`05+SM(65Qj56YGrvGxp0-3g0X1YLU{EkLm#7Y z8Nnb8Rz8)8KAIKxLu8O9zFEtr-@ygJviRa<3nw1dy$rWchm+F?ycRbDPlVur%gGY& zw7QL}>vG}5Kl{)lGlkRmc$gF`;IwUIs4Fv-a19Q4?%(V0b?@0m&A#t+b*Q_)cqzn- znPWmua!-zRU_cwDkJw-rWsstD?A?qUYx%_PA95z*X_Pnv95c73&OWH{r1HPIgX`KT z_N;yRzKI!4J}fDe+}>2Ke|qBY(~Aef$}Zl7yLfHjN+-pgg*LvBv5fM)9tc9hLuguc zz#rE(H+ssZgYKO0PVo}ojKg?#xURhksUK0rpn^`hKjA&W!%MlQ;=xR>q>xkz< zEUb0&Vu*qtDsJvQvCTXtu`8q^oc=PCR2^^EgWBtjXlp=>~4JGP;Ey~ZSUi&Ib z*r6j?7%U_uGJ1WN8$vr>1UoqwiTqm4wL$3sirxff3Xbzo_v0SK=gdM{91ZCz0+iaOf(pE=^5@)AGZ_~D%`=sz^+H{ zz5ldme*OK3ck$|+XWiGK7H(tn^C0H(v5Fz0;qz1sa7927cliDn4kH1m^VvJw8<&^u z=0lb|t|ef6T&#Znm1zachcKH+vCNhaB3N^97(|MblXJRosG-VQa9qrFH&!+kIl@(a z`txs&q(^JkYp2dpz>i_`bFbEUp_(c$a)|XqmYd)U5pj!(kh63qu(6wSRwfJFGtGP2#5T8)xDW_z?~SV_Xn%<-^~dg=m! zkDAOG`Wn}y7?$&G2b_dcJ~`VNnKB#%n_QGs660+zKPGOTO&=DgwQQtpOw9rjq3%v4hBNBKj+t$0ylUQFUQ*m*n|e>U)bn-4_rU9o4_X?-r?jN5Q=? z5w=a?Zu6*!&eId8-}Y+{mj^2(e~wOh?%KaT1NlcXVvC69--&q4nh1bovx>RJ2;OxP zkR(_0`-KEOe7(kT73hTQ53AU#0Ao+A?e`J{w4+nU)1ccU553=Gm(RE?4>J=Aiapv_8xbVKnP z3qxP2B|47;_yN}9>(!j6NhF3kmyF51@%z2JJ8TUpt^))8<4>Z2eeiAY_Krk$^1)zv zm5UPmw410KbnUR?t*&D9IY!gOxHrG{P`vpk{n`BENo= zVy%wXcGlM4mn5Ez} zlg5yB;jEY8O)@#gsrmqB<|;DhyX!L?+|x^K!*JvGql?jYfc2|eqz!1fnXy6E`YxG3 zVp-WyYvQ0NYmuv3w@xMsJMzf~o_Y)^y~DW}31EZrBDA!#Pwar-$EFr|dvvMpw*DHp zXTgR@ETV)^L26x7DcKZcQ%;2|wPqr0Yv!kY&GVn_);lyhyx_%p62}~C_AWfLawIv$ULJ9uoSzufBUq6zv1j`i3#?}o1s zS+OsC)hWs>o=Fcm&Kt=WX|OAW$R!?J)|6^kS^->F{rwA}qgK43LB7$VgSQqR9-q{9 z^WS0%HV(Z%*5d_i6T6c*;;mEd!ZAzwQL>%ET@?Z`WsxUj@DeM7$UaXV^E zPGSVTQ#!m$lV#J|Q}02!McnU-a2Gyg#qtVjs3La;Y6*AeH^hACr9PhQ^ne|)zxNa& z9r)J4F5sDV&NOMp-eHb@){#Y*0w=)gGI!n>85=7WlEi$(^egKe>fSyX0k{YDkh1pv z3}|5;bAQaWa|%KOF*XB+I{P}Vs26Rgk}Pn)7Dh$XJ57*80|ULDjZ8V6X+GdX?8@5C zI0GFkoO6bc+cb0y8E7`QduB0uV8kjo{3HwR;YFh=)a=FYS30yM7k`%(d(E8{{B*lDpQlS?L-`i! z0`)3Ch7Y8iOv9-`9YCYS${D9}9{26X%7Avl)ATc*LS6qqq#dzq+h#H^$2@vQJm;S@ zQakhH*Am9G$U{Qmg5<&PEa?EZ=K13L zagOS3PEr7;UJPe)6AU~{wVSq7+SKiF(=wB;dioO`t8eGzjLT`w@h;17`>QDhd-|9s zITC?JQqEcD7ZOrAG)DSl?K`+MRn?t+2_muV)wN>$Q#A`1etB$Mcj?IZjTGlM0&+ zxTyH2P+yN45wV%%spYC2^arQbb9eUtDOpV9Fx75)xDpy`hm9 z11;J1==G=ZPAq^CX-As*Qq##e%gw3b&+~rq-1>OOkdyhbEM5h6ZkR{=YIhui*Lf%O zyG$gNZV{>&R_C&V_@e{(s;fcj{?c-3H#iEah6u)fdwim@94)3vEu)t8D?tagmWE~z zq`X2g@A6E>+GG^`2bXlxksys9`p|XycaaA#oa6qeCb|hD1ISRV0hm1jr(UUOz8%*a zM_q1P*ULj^6ttv~m}1v~-%r+brdypVzP9<~NQJoD*nMrIS&qfxfSj3(L@2djAXVLm zg;_Q;6IqMMgqf1N_^ZZQUnQe%F$#4U<=Te~p`W{?bD$5Z%LReZ#9fTy^GR)Y7s`_j zLMGdB4{@`lTRg*@17G~04MBkSUbk-7NnJpaluE5W_v{cpH?qcnJwMMCIg5JfM@~zs z1lLlG&6aVgX;EMgW4Vfo3&%e%$LSzjhjT&jl7lv;idAem(fH#BP{nm>D@(YpEewbU zjWe-~uXlF(3J6G#y??oKR3Y>TZJjKsw2+&YC-5>_j=P7yxrOHWL{Ld7(UC8spE6H)_VoJ`tIgSeVw9@*l?VT*=@Xy%6ie_g@zUa{&cDPD z@+VCD9v{mc8|8c1izf_AeT9xfl<@?B|0jl>CqhxA!p8zg3;f4$-+}ISHU&^}u$55s z0RTYlZT2iGio|xW$H^r=s@Qi_NwI&8N~B0SQ~yi+pLp^ACb)_X_DhYq8*KkwKvw$x z?aY58L-~f%b$9?r;63 zx>PJdw2GtD1u?6`Ik|I9MXV%^bemo2 z4E2s|C_E&hm>7D7puYXBLXsoJwPyR7hKsPTwTqi@J>C9!6fO6UGE? z+o}dihn1^ah8jv1>}3$ApCp?kbIIPTswzkD|GK=R&Tf>8VpVW4UTIQ{JYOtUG*qnZ zUv>F(tt4;RA<$}`MP`?!Vn!L)XqSCjqpwLPCT1S7MK&eW+KL`$REtLZ6y^Ax69ihZ z=4=43UyKlS*-kK|(?cG<+{5PEQ=O#qmu>z0do&(=rMvMv zt-!8=G=Ia+FByEzL->(OSX9fk>6YDNrFf9)b=wqBUE0+uj=^89K)N{eB}6MAgWgdq z&5FociQ_&`&}YTL`A?`2u5#$gfkk+IRn01?36)jVU_1~$!q6XM%@%A?O$0XNwiG+B zJv6w56iH;vw=0|Jvp<(w)ZDqF7M1wGT#e#&&qQdcX90w@M59tABMrcG5lIKs@>T5q zLs$TxN?QOXvS+ax6{S-l)co95qcW{*F1cS%^Kns<$9aZE=p*Y-lWD8uymlUVQu5KkZW#L*A-5=_wP8?*0To*<-sLu zqTcrI9TZHaZkzo&R}QJu+Lsu)$9U75^2d8JO?c0RbaX<4@v2mP6D4Y{Y*A2t6S?#( z70hCnam0SM`Dns--vE}vODFb~8(S649Nep?&RWFJ6DF#(KFGPc$5LhB)#TGt!)5bi zuG-gJd9UzM_Hw_B<0W|o0j(l@tgMTUq>4;ANa|i4Lx>Z>*LqeuHqiPP+jMraw`OiY zb&+%xku<(|A)U%FJUR(eS^3;FBAOd~^mnSnT*1o8koOCHT!Mf%wvs}acDLkUwo-Mw zB|bddsvBCQ-m*+;H4`YG&~6xcUmygKv0?ru`$zphnVyyor;k^x6us*y^;22en^Gzx4KH?3No!sw6a1Nj ziy>;18$1|9IURGf8PbO?MzRbOxSElslVFB|ziK-QYQ`6!<8DA_7_X}%3GQha{`fS+o^I)#Lx!TLRHf6zu25?) zUk7^*!YKVnjl<$JT=Zg2+a@RB-I#zRD`q)r_POkQ)x*Jt#WvS zF&c`5>Yzyf81$YkQ}dpNDzg-<(E_<aB<<{y;zh$xWs#JjuVoH+)kat83W02PgNDqRwWnj z!S}?sp|16Bx3h7^#*=9yi|f;c)uvcYX3i8&Z2lTZR{B_ugR*h;+U^&X*C+g^h+{4{ zp^oyI!AiOQ$yOMsC}jdO2^Qn-1&s6crHAEsdz&UU9=FLue_!Yw&sZSN1evRn?RyG_ z$Bn}^V_9d-5hQqu9H{43pLG3>Pu>|$v==RO7!0IBR6bBTR47D#9$j^KtW66Xp`Wty z$XL3bTcqH4nJ$|?)%C{2N15d61bIHE+@WDNa^7(0lI08QC$3)~CcWLkBR+G7!sj0R z!sY-lc%htRgFUsK{y}SXw&NyjTi@LaB-N5pWQ15*N)jL*I3%95FVrvKq?#(`{Rv)JC39a1Dy1= zN@@M>)L0{#5cl(KkY!%DSTzgIA8 zsMydZ-rF+cI|&zC82suLdGFE_rB_{4lWWv$>d}?!>_Dc3{?*1HfWV}qmAA7|=cBPx!CRF(%2n2h@NvCI&K=38+B*JF? zxQS}O@yEqv{dj_L?ARbzb*f{URpzC+Tasy@C5*K{xla%7JamBJ?#`j;+7D_p_I1!| zyH9hZ8`-n<-qXKhs#yiSgeF+DV!vW&TIsoXCiArCgq(OzP?iz$5L$HMC^;gt$cs9k zT05(^w7!!JZ8Pz<17{|2T-pr@*G@_633jv>t~g4)bxS*C!TV*&QyvdrrK`UADgV%` z!kqkTcf#4%ZV)9qr=@Adie+pi>sXn){YA0btA=`>M_=~^=`=rSJam_9UW&wfqLtY8 z%=64Z9QUX~d?QvJ30BKd_?cM1qUKPCOkEV05oypIgFCp2TB){DQ*VJpO>L92-hETL zwSl?m8!Qg7>ZWbR@ym^)gn&nNAAqwMVhpG)V_F}49 znU?MBSd>_gm9bG&0f~CC*}|onI2(DT4(a0KrV#{sY2b*0q9!x-(T=g*0p;1)8`j0^ zROB{4Mgn&k$z|GxE_?fesYbm!1hQhTu`g0f5H<9>ZkN*AB? z+xmBbQx6%1y#tW5_1!zKzh87T(s#<{wiOmH!uIhBcGX*vM~+Oei7QQo_p+MliWI=Q zn_;`#V$I1UnIVuNJI(~pS|RpUsv83{GT@DwJ$0>>>FX#~i>@oDj(}my>N*{1^am~P0 zlk(vq$e-7X&+jeT?rrZl4)0$(XpYahk5HMn!r@;YZ>PY$PeB{Itu(Vip3itW`43g= zVQ1Wi``NS4wGEyE&IHR9(Yo zMP{QZ+$d$UDdIY+-64qrfK^j{x=SdR0lHC0n z-aJ&_%AsEpmA)KV#k~x>UPHD3eICb(8%3N^^#MH!wh%YYg5mWIW7Jma1RB@$y~F{M z>9<|N#i~ok(><(X)cG?fq#QZFN6-e5e@-i;OZe0GVkHlQwg}63ePU@&3BS|$+-ha3 z?3Q)B+TpF{$E;&534keAPZu2s-HrmaqkicP4q@O{Z^|t!rrvYeUo?MjiEOL(r&Q~P zmKnW6+ygG6_OVc!$r7G)C$^)TxZf}*P@`|}`YfpasM~-1ua84c`L%n4%A6XkT&p^S zUZ?>nxUVN1a5J`AE=q32cf~67abhQ$IO0%NcaJY_uV(M!!gb69JKZ=-8T`Qm-!OVO zA7EVOC!Qu+6KYXt1W=<2k)F*zsCzx`NgJ`#qn24#ZX|WN-vw2})$^(t0U{#^158CPhD8SVB_;h&&-Pcz#a`)ccY{>~M!1%a5vD*xkuQ_^4H z@lhP_`y--N4}83AKV{=mBM3c__1`>SO(#jCd4ZUTU`F8u5fY|SxMm(@bE1vmA2n7R z=fZv7r6%EK*Cwl(!hByYGn>me6lAmNO}7O{(oA0N!+R@xyQXmhtQKx1x$y z0C?rC>pK!^sRm8Q0gU81cZbJ8&4j{wz=WGA|M)~8?#)O>K4twzvL1KReY(bx(A@a^ zn4i{E(oYqu_&KErgS6>UJw!1Do^Gj_J2L4|-uoHKk8=4}TSPM*j;QUKCK|xm!cgT( zuUI|)TW;O`E$=d4+IFXGCC%TqI8lbVvO_-=VB@!tRYivOW2*ggl~z{QmMuS}jx-Jq z{oB&F{7$TMtp?KJ`om@V9<9B7Gso+`KAOf%=X+bsv~P@E`CH#y1S1p@ucV`X?TRhQ z+ElPcooPus&bgMg0pPf$vDE{E`AiY-s<*Ri{O`Y}3N)o#xHv%zghd-Kc-(xpZ5J;- zpZ55FO7ahW$oF1(#pD}uM!aC`@f{?Jj*0SIHt~HwW0^uwGDt?lr}w5KpM!)tQ{~># zZ{mcyt;&?9;L35C$^*MU&rTY-m%u zW~>WR@IjQXy0~BXEX@%larvcc@t0|EhaDTVWrJ%`**3 zHl;Vi_*1tLWvg|oPa|e|S0%PUoQ?myCLUsbf$imZwKyyXajAH z`9-zuhdeC|+viGLUXP41RPs)<5)C*Ie9%g2OPXG+vbZHk(8-XecUP{+oserNJpiW5 z`F|#sVs`ZZq*1lGBR2G9>23POhdd?PL<_V`6qNN`7Yt+?lMUPo|NivygS`Dd>kE#Y zOWGSBWm>uWEO~|#jTO!`F}sWtoTlK{BLl|)z~c=5@>SN$ZfnD`UzkdE=f+O-w{434 z4ejZV@7m$+R)ymPZIHCXGUnbFgSGZTjdxTzrT$A2fHUj*fkvyJmM{aZ&W@^26PP#p zrF?1G(v6(87g9`W=W&J?m2Ka{Y=5aVn2?E;U+_HwWD zTa-%nCf`7sCTqXyl2DLNGp}oFK53-A^XTCb&Soi!s*h7wYn7Mp+X?Hm7onmWB`Wi1b0Xl~u!;*nX;Rg^(C$suRA7B?3vrlQbrT$Go`(xE#Av1`>{Zp^@G;vQ!` z#Upmu`e))j{Y;yTRE>wK?h79|dLZPczxtk@d*C{HwWru#JsZR6#&Cka7Y?psuPyzY zSp&#m8fRqtN98`-v(Vco`-gm1`JMVi@9zFiMPHzw>@i6e=rc~Ei$f>%Nv|3_g(fV- zmN62s8pAoG>^oS&y{3(2)`!>EMy?#33}eh0NZN?uQBI>JkAsxnRcNl&gsn`LlMuY8 zFEtaO2ul0tKjbIO^SUv@!@F$PA$4}bw@jc)jJ##*bZiIO|8Hr_T@&2nr?$XN5I&W<9g0Nl5p_vrA%q#}=yd(eY4cV~E z4x+cxecNa6d#^l9)Ge@6S3oX1Y%hZ-PHR|XE_@O76bJgc+YL`#uAYZaMIrjwq|Dp| zHtQO)^qm!b(8hM{S| ztmtl@;9Q$P8|~JK{`*OAZ+QRT;`W#b6qIl5f9Z@dHr=swylSyQ^6(M2GddNrI=j)l zCmsj(V=X!XOFkyS2H58#&@xYmatuis)OY4H9fAmYkI>YOB|Bo`^9^G;5=UDPLwlefx+opy`*(A#yjE5&zh`(>Q{1iOMi=B zFjua}8~N4^miY|k)?U3JijdHwwD&vqf-L7z<}3nl@aC(TqhPgArpgYa&i=D}gI-stL$n)528vK3tr@~SE~9a!G~tE+J3M4C^DWOLQS zm~7|=DWiKe5%*N!8f zq~^hYT-c=Pc9`^43?q6p=0>mLCb|ZlOLCM8^|+~!rB~+N9d~9*xbqtm+ON8;{e1Ln zea9a*h>=Tu;rNY=`RJV9N7yayt%1wtCe157-$m9vvVV_J_j7s$t~S{Fo_u$jm}F^y0Qz`#&UU(3)V8r*~4gOpQyOsqt8yZ3Da3)JSm-ig@@NRAEk(6gn+B2%9w<}qtfni$2{Wr!u<4wqQXXV zzno40_~^vT1BCj~ROhs>lWW9wRMf;q+SxGSl7=GNUJo0J1PO^ie|Efy&*_WlpL*UQCp)fV zqeRO1m^+0LVDI`@$&{#34Dtr6`>*4~9Fy%&Df-V!SGL1O-~56;=l!c=_Pv4Ar(}12 z%Z1Q9qpjY2{|!z5>Ms1OeJoFDCz^;Qg~xs69pbEixm+PmW09%16&>dp$W4akISaL& z(2~gCE{B`TJh_q2zCtaBm(?mnxc6E8nNNhgwYfu1i6lorTJ!z@u=wegoHWv)G@WR%dYrDUlfzj-gfdE=h#iqt2U zDbpUdX`LhsV}Qu#as*Wu8~14bR%jDHMs?Qcd!JWj3oegFWVTjH$ABk$L`Y&o@($q? zuzN*ku)$SYFNU_6(!_p}VvYQWSxDRS=+?HXEJp{hlE}wnrL&#%lL)pD{IGl@QpG2S zrCnxKcqKmSC{k^nR1V%0bn!2*PD)2iL`&U^%dyP*v03-kVM)hmyR95BatPQAx{>e0 z=3k&VahCKx4xpKS8Ona}3BOe^)N}O?I4Xyu4!c|MG75kLbG?$R>Shz&$#`_3NO_d{$2YtSNnpFynEeS%$H5?M_{@h6S3F9$$CMsi!!3$ z#=6^N^Xy-(A3-0VpLuSg(5cBs$$Uw>sCPj#MFUN>cP zs;*h1*|!Na)SQ{4c%Vp`Y3r=Z>Xm);Hf7t*U)?FNzXZMxL@#mvWZKi3Zp$D+}z z;-1P%W?v-k>Dv$_OYC{s8H@Vs!9Jx!yCXIwT*%XZ zJ73uvncXP(;@$P@lv0O^gRmHw&*%AWjt$7EOFb-9xzjHlEHawWd})gOmfI3$D-C2K zAVMTtHFxME?MHgv>$Rn>oqGjsS_rj2>pcmV6aLdM%v&Iqgw`*JE&p~lw3^yhf#%?A zHXUJq1~Fkgm(JQ~es>70@d`mc^xr2PDS8b2pZc@@uFpUKop#WLu&IqOB0 znI#c~UyYV`J%6*p`sZO-aY!g}t$Amdh}+v)D9%d6qFk(sPUnMyEd#w*R@+g`LH{>ekJjsc(o&4HTyEIIn(;Zy9#wk{KkFps!a zYUk~?+UoDOvsD)!w7CZ{*#MWKrc->jVWJn*^8ZT&s1&>f(6UvDXi!^fbgAF>TJ_SH zK2^J?Jpx_%)~@z5Cprw?=L213wCpxiFA$l!;fzI}7Lz7|XcoTQU?k!+nXAUg@?oBR z`5mhrNv^~?_UfJJ4GUgXxr|SVLXfdD#x^LJ< z(j=oM`})0J9i?3mv*E?dMt2qa0M<4LeXT88q_y2jZ{74l6)a{}2@} z?JcO3R-XlO$9c zDRyErW235g@U4E@cS_5{fq&!>nr2cjuRO~h#)T-~t4PeHc&pJ%aWGt=Jf0S5X7iFd zcZ`ERjp8lj^OF3lwzKorq@bw^-bCDYw)P8K8N>HSh4h1kaz_{D zKpo;Od!b07((Q;)2Z;glV>kXueHBWikCL$3Qr4K&P&~whjQ4;m?CLe)wz5qzM|m|x z=ucehn`cI)(l;75+`bu^7Tvp}SLcph@@ax95$6#no#@^Un-bm*cXbyMwJ(DH5kLzp zewCP`1HIyw={_~MX)cS6{qNPW_9q|=3dlgo=5IMXiQp3wA zy*0)wV};X-vE9`kNRemxmBIws(S>kk)BKs>v)epN>T8Z$R(y#ZtrJ7&4**xDKgXD+ zLQFN^P#X#;+RsrCL;b6SN7%gn#^0^lc!8{PiUAE2oYSq3c8mIX5o%8gkaSa|O|k~L#YJ5|J$vLklXP{DwzQ4CI_{piix{p(+{W0A;9hx8kkj?;+bth^dfAE5dOKIcEIA<(SU*q6qw~ zyxKHrY_rC&l~Uf;H)t(deCvkyM5V40E7_#yo6zG~zw)3}QE}6(_0k`%Cl#7Zi5Z#Q zauKE*<8U#wxy;9S_ktj>DE#P0XOUtDsg^r$X;bs#gI$dS;!TbDszjwo3xjzyOEt(~ z>v)x|*P~|m;DVBVA&xG%dT^?UwLg;;^Y1Nt%W4Lpv z(q(N`^cB4=B+VU3M<_LsH}`_~WW-cDue(jr4$^OPGCtTpIv8)7iQL%a4Eq%Ph2CP^ z1>rhcNiWK&{npZPZqQs9t{tWpX5cQQCUR6vw(wAKxQ_-EliEcRTcgx;8$^@auP6dP+&1|ogvL){XjG{{-MNe} zeRZPFwhZ4xqcuLz5;Oeb(%P9B+#W>s7KbU_qz3Kx)!-&JBZgQAUc<(lqHXOCRp{@yB$wRXeq^2f9pohMr#=U zMYms~d?Fs$VJ4A{k4OPbxf{M(hl8)twjJb4?Pt3qH}y}>Agg$1D<%s$)`D4(`VG1T{Zs1_ZNi54k@&NX6L_%|h~hxt5)=2b-S-#v&I z;$@;cxTkjAd+}X5>-eFkQGHl~m*+IgQOdrMPQN*B(Qr+c4CBWc5na{SoFy~%Kp%`(n*AS%r?j;bFzuF9^% zWaIDfGAQzjbb1>-iO`+$JNm3hs_#{sldN+rRW4(_CmUt{0RJLT{KZqh?Q?2jF))Wr zTDXyeA}_Ov0@14fLanc2WhnTduVRbeOqpw*D#rI1QP|Sau{$)?tYhr#+n0Nu!2>9O zngEq?xbW*DiUY%BpSV>y{4>EierDv2ma|De%R^BYv&H2vC~sp7TOuiSW{+87`;guO zCbHckRa@J4jG?o(w7!`76dY=&F-+S0r|_noo#>)dlYzj_^djD7x#V&&Wy-p2!(dT9hg6-Bj(q7Mg^GZ_Fn;`59AAswc!|zTq&5 z$l$kRhx@bBvIH*!MJ=qn++G5~Y7vh^CHg3p8@W`j1M&=$f$t7~LfImkL=OW& zz8SC+g}&l_EdLmunr|L|=GY}#BTBOy-0D@ooN`)%PcK0T-409aZL+$NaH&`MI z6anE-P&Id;-~k^mS@!Mqm%fAEL{7tlr#YlemsdU6@4tvQe>Hx4u{PiL38eZwbZCsm zz|(yEB#$ij`9&v1Lyz``9u%wE$T=nzE%EJX8`w`C6esLEU$sm-xRZoj+MBJ+vSbDd zR4s5ef*JN*)VS6CLSWmWuP(Rc?1J4V3UE^_GY@*0RvjxDE$sb8tkM!fb;%_bJUVOtSE=vxQfA`X#BKH?rn!l*(A_=K9V z)l*ZmE|a2S3Xp3C+bkTjc+Y}3slUzmS-m)=g0)lf|cV&O7>W7|bQ+EV8a zdP`dygka57{nxF?@HN%yNM=l6gye;(_VOv!6z75MnQNZgihXn+#fdA&{bhq`)3WlJ z(tGGz-X2%U-fycg5#NP>nyP@=f7w6gkoS7t1PpI+3G$%mc1XaDeW!SRFWg7)Kl_596r=Vegb^xgvJwBc3e zohO?w!{aPXs?;cM_Jr~NUQDhx|B3v<-P`HINvn<4Z{pPa$tO?&VC5_mh*2|oXpK z73ZeqiABj-8#;HqXkjnA7}UKtgG~R6O8esN4vs3dbrQz1^)CWO4$$ZOd``z6ib&6L z2HMDQscJkj;6UAHvV86(yJx}Mc(wweAP#jLsvWeM5_kI)QL;^ zJAzMc%4g6?)uNuXJ8Q?juCo&?=>G^2Y%Av3{4ysw zhB@*Bb%M%KP)0;I{a8eoj(DzrrBTs|R6?K^zF}eamx6-oWT8|72}!?cW_q80GPl}7 zP_m|F;7%+N{7?CU;jsL6nS+n_hN973L1oi6I@EI4{>uV3LF4H@^daV`MJ1g6Gc5A6 zW4cEjs#Yg^k=kPcYX1ok&8(--x1W_BPeQ z==PZL?!0rci6zhMvyl)#fhsnBp^vWvLFNjfGV&cQl5ur6o4M|9c?#TATAoIS+vLOF z6ByhegT+^KC18%@)tO(Q+xxmT))K5<#k_v`L;g>k;DyT0{z|{9f#oaJ9K`dY{(C*v zq7j{~fz+;0i@~CUBNjN|(i2f;Or=$CLtK(^76iV%pR==li+Ff(KX|vw&-iGvoCxu! zYhmrfB}ci#U8lp^VZjU)QN-rS(82!M)F|$_Wn{2BK}oCd1*y_V~l% zfMWi*79mYp>_!3d_PBECbsB61cT*-5QX(;jmAN!!U13;`d{}?|VrNVhE_B6>mg&4* z6`Ic?&a~QDNRe7p5;C>?MSHG%`b(S-5}lmV=EOna#AfF$5?icmcclwrA;Z`Z)#Nh~ zPOc5I3PqF+oiId^fKEm5B~{g)MOknb6km~GDsr-&6<2mv%#_k{Op3-I75RiOz-WmG zNEfeWvQr8lTN)l_#RvhFxW zFKXEZmC62T$#Xks@AubygexS$dY|?NarOoXCId~F+3UYz*T+=Pc&`@P%aoXSOqy25#gW*_RrlHxhiaa8CpFZlvcVHihMv_ z&yNoF8}#-oN(-SCI2|F3qR-V{{N-aI^G~5)=KdKMv#f(&G zlpb5g!K$r$Mj@K2@K>`9@K=~h_|ebEJ|-Cx60TeOBSrfaJY ztpO__l3Jg6(NG%1`e9!(gio(aQ|wJM-l9<=E@0g+CJm6M2b6^lEAD2{?KX>eEc`i` zdpHnQ3~yB5*B__%l>iGmDY%{+1C6*TI1*GT)Dqk#fI!bH?;jo(>n&94b+o9mgxOoN zc`fO)u?tYvA@diULW-))k`Y1r8e%=2B z=O_D#{0lV8_*sGu%l2NB5xr*L{l^9|?UOv{r^vlav(nP%Iv)=9W1 zr9JF47;z?Bo33i7Iwx(*o4#cmbXvmVgOAX**~mubLbo|3-&SUz@B1ue1EzriV3u$` zvs$o3{fJcm8*KjU)@J$ftV-Y)lb`XvCE1}uqIa;HdcjVC`+n~xXO9JQvGg0me$dZ- z#%F2FhcN3>xfcyOGnF1#n!uBnWE-UsMB_VR=^uhm4{+aA_L@ek3RGC6v7?JdsuQli zpBn8UY&U%G?>XPoB@BUVv390DIuRoGQy0X9tN?Bw9e)Z~>-tUXuX}8o?bc#2@JDRr z&om4d%)XrpzI;hG{0D&<32$at(X`lwt^Aydh!dfShs|K`1nTWh_&$;65*?{CKQ>6n zL|~$OXok`#YEH!~>fL=a^PILo z{z&4G<&uTs&JopKOY*@5V?qkQrO5ZlADQV@fET~DbO)MMiQS2%zaOSOYt7)>m-ha# zD@UU+^eCUDiEfb2J49fTi`{jpa17G800O@pQ=Z6$Cb zC4NiJ+~oaJzFS_d8v=`?JH8xe)q;fz0KRBu4!Ww`C%}bXBnG$G@2Mj*|H!RvTLLx5 zHSXvpR+TVcLBUIR#}ph zr%PguYqe^4vFp%nU_25V(`i9Qyy~0BZfN^}Ll{yybhKwOEn%U5aP5ytX@l8}a+M>Y zo#1**mngpluG(L~_@7lUofQ2L>1er|D9fq(qt{;VIQNZ=$)3Qg1B<#K^Q-`s%7fx2 zrmv|k%{P`z6-OSbSTjxJ#X7{YE z@`Bp;CjIi76dTuPVqa9{m(eLMUrJ4&?!-8;XvJ^JOzZh-oA8>->VgD#1&X)8;S zCjz#U{J0;&Ejxj#$|G>m{irjB?O~*FE^@9a@x^vI+wqEwkmYf?R6b-TVl&{6TZbCp zp((|mN#6&BL5-kx*AT(g5PRe2DQ8uc3JuQSk9blrP{8crX}RZ4>)6re@AFkg*HCe+ zVE?G z=j&+achTPo@XGcF=if&Z>>6~AC;@ELz^gXb#Z#(sOVZ#nPlJN1DYJGwXF1;X8^d%f zzjQ2t#&-5w7x#G}-$A4$6O4hlPYUH=u97I@7NQOA+^j;AjVA@&Pe~Yyizk=fsz49W zC4EG0VIfJ2;UQ^>p3B$wG9OVHA>rh(;W32)mIInCYEeVW@-z_+)s9W1YJAX0)5aorohRwM_2mq$@4G(h+QJqloZ4qfDiyR_fYKZ|IYikSq;#IHFy6~^8!w$sRk#>ib~qU zE-pv8U_>rqzr;CB;1zu{CRZIkNVQ*kKC+(Rxd9XOI_W#(1bE_1cJ}p&8wCZ=XKse| zhX1S>oKfw0EPnX75AvW%Em;pGWk3EPWYj0{(m>&$vt8=#gKG-6zZB?@Z z_P@+Y<~Xx&b*v0`96d`|9<+SOx^AXtFG_#|0@a#&c`Q2PbKE6Q zv>5JIhyXVt7vrGv0s{KNY&{QQ;)=XDxf)I(@6jIdLx^bC%$((KIp?244i*-Fo_g+N zauL4E;EKld#4KQscgr)i+O3UdV#?4SR_UgkgH2V)_Q{tS5tBg?kvPEVdTu3g!n3@y zUu)a(0;gU*(L0bD`ooW8*{753MQqM22I8v5AG=KLrQ92lNE^cZkejWZ^;1;|6wYZB zR63*wTyOV@ZSLocbBLzte7f&HSgXS}Y^N|x)j7-Re|S3V$bSY57OHe*@&b|t zF5nP~ksi8DoFg>^KWqvY?sth(5bS5s8Dv5mtjH^{!Ks^GZ|K0Bo?8GLE;t%G5QlR2 zLxnXodY)u2)pcET4o*&0y__N!hTGjoxH*NI>VSiGnF(dZKU19LS!FcN3Qn z#AW+@52H1RR z+?rLSDS|jGC*$k}Ir%`@2Hw_{_}-or1br>=y{E(|9`0A|G(=m=!?_rluZBA zK5#Owvbd=#N#HQYbQO0iWByetU~x*UGm7KqTJuA0l|CL<$2tV>J`$pUR0wf5Kbq zrC`4sGS3lygVmg}U1e%ADqn_BP>8$s*26cE81G%KCr;^?mB{}SovAeRc}Z@o_@l!) zm<_+Zj}R@&Jh#4d?Qk~z_GMJ2>kBts_Q9Q0euxf6vMIqL;wAFn|E&^mupYaKS~K~c zkexo>nmX`i4^X<^&IDk(bF5nglwTV~jW~`{AW#~n&2b`u2cf zh0&KQtK38cz)pJF{%LZI_0iYc}&RJCW`Mt4__vIRwwu*HRDa;t|o2#bBw zTSg*+Dl8i+l0HCwAcOmFf?9vis@#<{ybmniILcA0d8}LL*EE!xo=96`f)!&DZ6;H# z{4@F>-*c(|OhN@D{rrrQ#&E3M&L@dfaZbgCj&^LG<&v_u6Vm1MSSL^N!%v;7jF8X9 z2~KjUEY(ZeCC zGeV1{@2;gzchfF&BOY`9a3xsGXET2K6-?>Rs;mv#J&&PS=zX2R7X>MU(T~(O{PS0O z`vd*Uj43+9541nh^yie70?N>j5yp_61D4=O&p+cy6ArtZy*=5OjE$Q8|0)k84U`fe z$HPY4+0=_RD-0fIOSqMApza=_;~|NcwXekHEY00iC0w2X%I5WH+%i;S4k1n7G-F8o_?!9|&#(oyl*R21vw8pb8)k|F;H>BuodKeZtG%}uHpE!XX zel7kDnb|;GaW^<-OI_KmOrpg2ch@QM%ig1J}!xm650)CD18v& zq_O^XN`P!9lyQfC;4;4c13AvJacqFt?@c;S%}h&VY5!PDYxoOYgIMsN{jj8Fb;8rwGd@NtkK&ZwV=y?VJY-g+n`Umxs@S zV1kX*vkAIe`ao;AT3ijv&JU-z3W;Xe?{3L7}oWE)90d`D;L39|NE zN5dRaRmBMRY5wltBi>|jH|zF4Tr8#hN!qZtYdzuKOP)^b=wQa1|3O3RE=?MB}NgXM%54EpPrN6gF0bx+#0RC755MT~!~EJs#@O-Hk6b48???+Vu} zDGFa%^!%VsKmHW)QGD?%h?U>jzd$$6vKjiNQOij){%Fe3B;d^r4}&Bn=aME~0pM<7 zpdV%8`A?9z>aEq{sJ}g~XNgOOuWz~|IOUbj1fcWl+%>n?ZZUp$$^)_WfiVN=9Et{h z#bk`gte@tcb{;y89~aoi?;pI{kxQS+P=7b7R=IF!AxSnBn9;R)*d~L6cm8DF6yxq@ zFvW@e!N^Y#1iM5!aVfbHD-!Ox(D{83*B9cH69>dEYtP=dG|nA4j8g927J9e z#qH^)LmwT_keJh<{U&)?@O}|Bix;Eaavy5%n6y)*tAPnfH* zcAB~F^yL^(q4&oZJv+(Wx`5M?sI$lgq57$9y2!@Yv9Iyc(yg%u3Fij0(mRm4l~Foj zcaOpsmekt~l+NCMtD#TSobgSO8EG|fiz@d-162n+{}N!JO}NqE1{c!Z6uOnHJV4qf z7DdPGmyQfzyec+KO^<7eQBYO#EQn;}0{E6E{p!l~4tDW1dn4dX|*^WtYALM@1 zV7U6-DwEAw)#745n)0Q28uxf@S{+VsjxsE+Uu7KQZ>0KJnr+(<<20BcogS;?W#v=D zXu+CvoBgK;t5@&JDD}JYrT6yS{J_q7`oZ=iM?^Zt-9@>y_sVR+fkss0iN8SQT`y+x zybWN5{~0XG{HH%*HDzm=LBQHAlu$7W4H19Z6XU* zOxrRXg&O1(&lzRVWVFHevyrUEA%l>La!9!A@2n60L zMX+I=(c}3eGornU0!S`2znOo`VUd)XZ`5$|;WH${&GWmeZvHdnQ;#z8$BW4K;6}E2 z7XAnEYKv5^#R`fe_w#&$D_A{#lGCy|aUR8fJ`!Qj?)M=kVnXE3&Uhtj#3tN_?yXD_ zR&8{(!LMF@jzEF%K{@jwN7v;O0@fl|!lil}KLYTdwHq-Uszu{9dkn7>QbR9%3UfN^ z7&@j?%7)Dg({mz~NkT~0lCFEnnhW+ymVm+x4Pm_YIodzoy6wPaE=={PFzZjOvd7FQ z6D~%k8YzTz;vn2#_I^mno3v))+7+zng_UCaeRUasICW8#-gv|rz*eiWY9U#g!)C+N zvg&^-FlGegX~l^ORr`kOV}92y(Tdtk-*Ess{Yuh1XkUf=VXME$4vP+A!-kVTq{%6{ zVc-@##(( zk?&rB?t}lLjO9@ZSHFq&%e27e4^RlW!jdbIfVpp4nKFGs&xm9P{=RjyM+R^;(J4q` zCpeeSB7cHK_50<+E2y=qwnT5&!g=oHo;{U#XPu-t^0B_vj3(ZJwo2YF$>9=6D?8dc zdGHN*xyyfgZsf}6uD-t>bZOa;w&r!S;1$t=$%XAEdg8Zz{D!ghVZEt9b;^}24_|*u zSz;nuOm%H;`$Y9W;If3s=|NvPQ+Ll;wWi*fp-KG1&?Dv)#S zjfw5&8HowPD0<&9*f=om{SU(nlARARTL(|#5&`x;`*s#*ap!G5bON8ut7dd~MW$L+ zA0yK6Q^iLb{hq-5kxRo76kQ-7@AfOh*A8=&`JI7F z#k^!6FDU!>QkWm$Ne`~GMZKGw|2L~20zpUxmb_nnrH6mO#Ve*k*y~sBi)AHft99Ci z@LkyuU@ttlN@Hf|dVYV!4W$t7R$ghf!))m?$klb@y3|wuu_>h-cZwtX(Kwi_a%MUR zJ*zpPD@#T0DejMH;vKDhDD=AX&~s(#A0pU&=NF+xWWgK~vUO@9e%pywlVxV_!;I$X zW!ZTHgw&IK`4-Jw@7ohOF8x!=?eeUWwrAR;6_|?8)ncm(nOJ|F(sV>t755u7vx*Vj z-Taex$Lomc2iIL;jyB~w#|ckus%gf@K720&Z=d>{S%ER_FU94Ht7C~OQb10|H&X{5 z*Mt#-W-b0$Yil3_abbF5wa($;`+U^bM=Btgl0ME!C1EHy3!P*0EEIfjf3cD3PC_*d zutHl`boM5&ELEbEI_e*ic2Xz=+9;;5V8oqI*NhPwDE0u>^Y!DvWN1im+omO(fSGS0 zB`C+h_z!=xt7aqTXBWlrqcb(KJ6YY@^&yAm3rx9~p6c2g(voS1@-p zs&eywY=0WaYhM&m%=PtBo@RX&sOo(5nX8y0rI*z4qSt zfd=cvm(WegCui9tlr5o%<*kC6q0k#E2}D8$#|}iGB^_tX>m9x zP{8Zbx`ShQyzxm*n2&0llX1~B%Yk{M`N1K2Y;k2Xg!7XjId&m(n}niB zIYDymO!SoG6Pu0d<_a1?NaBgdsD|Rbv9->-DicbqQSavGvqmsQ;*&Nh^x{ZSj0w&z z>EQ~C{Eh|XwdQ8yxJh5a8itMk3Nl&%i_CWKRNg$gP*Gf-<^H}D1G88iYqmLB{)%!b zmD54b+4_qMfU*Ez$VhPTv_)}mQR4vxm?^K-kim&9-{t++4QaHM5*J|odh$ZO@pqDd z0O(sumz2`pH?0@dAxZ&o36J>#5}?7~W~uvcTX-+D`E=Uw7cLiwJp{(1<+5RI z19=*F_?{8?PnuX%1a7VoC~4r&xRPgeN$I+)VAB?U)i_rkd)_Cobg8kVAdcuT3`l{! z-Y%*Pt%;~|YGQZu{S+dy4Gk198L8^m&B(0gl`u%45}c1HP=x3dvF z^RUkET}4WEgU5CWqu=m(Mz5AELF>L&B#%@IV4zFJ#h;+rs_$P>$IR<)eeM56*vgrfN+AQ-~5rAF*W-5a<}&z{s8>SuGN>P>z3fn?jeBRyBxsf zyD*=nspD~IO+sR_yOh+(_*AT#zU}WwTBQmdPAIeHo+>kMWzQ}2Sm=X8UIch%Jx~-A z8P1KljSI{(Q$Fqpf}VKjpN)hs6Mvo^p>NmZm%FP1-}5e9pTTk{P!qRxl&ecR2_-mR zJrK^J%d+VXcB7DQEMz(?FO66MhVH+<7Zmb`#GhZIY3o@3Jy)ZGlb0I2ThyQ zBbWhvIbe=9*(Qx8H;`(RvRst~TyuC{5FWv^uQ+MJ8l6b?(wNP6b?9D4;fj~)F}3Im zT6PFp(cH&Wz)-~+r9A65qf=)&)u3{e`j;-keNkXChO{NR(3Q;J1T^_a0`YCz%RUK8xSwt`OJm2%DwCTST-U}(drIeR7g&Ur}FzY;hY8{uA?Dm9FUX^?Af%Sy@IY?eNnt$PmA*6W$$=G>jO9Rxoltf_Ax zG1HuYCrfmO9I~-})u<`U$VCj(K`y%=BeDcRCE`X)n0bo!Wp0XQGwB}8Sau;C3f$@h z&jiOxI-PRgj9Cb0-v1`0+v}6j7!=#fdem;pE9SwJLx+WVmF%01`PK(rHQs*_=(M>V zMV&5*;c;u-mXMB{pG#FRav^tEAnOlF%>2=n{N!AsdbR%wN}I2Y2=#Jw4cZMPJdx@V z9TwG&GBplY!uuu*H9c#oRLu$A+hdRxRAbe%?z=yGq~I#!)*OOsWGw`xIBLsV5MB4W zVyKwfpIXPT@dw6RmhR`y^CeaygiBtg&L_ne1vNS=iu2tG+G?v#>u!zRGMovyrVqWh zoPLKe#68qXeL44P$ zXJUTq`=v*wb zn(JBRL6=(JJbf_IN7H0QyCTClg_SZM937r@5D5su(0Q8BkbVvx`^4wa2QKXe`#s2V zy%YR*36bD=b}A^UPndA{rm;RfEg>GBG}U{QeK?7WuvR$i{N%GjJR|2U+VR2|8~g|S zwT#$tyMw5Kz#!0)j)B4P8ddbXYn;d`>#TMSzIy|a6>r6yD<}D)*RbYIuDhVtkd*e9 zb?~y+11%=6t!?xM=>KvmjI;=#cO~lclmYpWX;^A8DPEI<>yVGCTOhmlOS1$2{85@s zI=vMc>(l)ja%hbny|grj!$5FT0E0Vt_9^_k@r5Ld!L|yzLe8KzxGc(7O2uXB31Al{ ze#jFVo6bMrQ-D#VIEwAdIRylbA#a#XG$_?p{84T3yA9Fazm=cf;{gH!`tGnq#zoFf$ z?7&!?xx1<@wHS7@k_m(AJ_C( zmXYs5bTD7hvFqzwP}VBHXSEUpfAR>1wNcQ}CQZ}DyM<^@eoD0h*WYxH5d_Svk5$^h zm^-u7Arl#+wBwB*!{B9CH?n^9iE`6H@$sgLfubGY?_t!F^f#`()i;h4!C!k>BtelQ z948a{>5rS~z2{!GevdmAUNH^vlw9lLBP=EopKj@4xNhy5fX|6_%DcF}I3^;Pj4ql9 z1EezI1i`eQFpB%O;`7c+i+VdTSGG*0)z+|kW`7#VH;#AMK-&cG9C=D6d&~=gnb<0- zE@boTnrgKi%-e;+*2uU=PrK4SV^Z^QA^A3xU22j|ENV-NCm#ucS2d{?xtj)?u$=FpcDJ@+kr&lo_x~tCK2b zJ^wD#Z4^iSIe=$oJ6n>ia1f=wk_2G=;MiG=XYAlDP-Cljl6_UUD%y3QB>-blL1hrR zgHLCoO4=X6`VF(3N5RN9RrbCvH+`cO`>cBtwSL4$>r7AjmhTS-+5Va#o5EXDXSHfO zxu$FvmbF*h_F_vTu9P|6XT5vpne*TW3)VP+zT5LBt|;+=Pj)e1>vK@g6{r|7u-1oZ zc8+QdwwGyy$nO*@?(O~r5ZK&7;hl8~%m6)u<4a4YnMrP@fsGTcd_ zGwmzel-HXD-;sf-ku$n}uQD+tOfPZa31#-eOrjw5M^B}yFMm}`&R)K$I^s7))BCsO(qWI{XrnQfAB^J4 z-w?(q=)Ku^R<>=bKVH~WHF?eom;z4{el`B~6<&&dO=YwN&Ul}(kgF}Cnl@FO%GDKw zOgQeAUnS|2qO4rWP5w61D%B%(jmMdOD)+p2^3h%0tTfHjO7a;>Et4hcGT)?0&P*)B ze^3SqgnLGO;k{4bt6GVEd$&AxxZz4PSILSs$xbS}Ms5}3q!rVkxetBoS_PTXJpt3>pD{7r9D~c2|1%YON zF-XXn6q7X|jxYWjg;<|MftJ6yxo4B5E7QriGEJs@#!r)^wipU#8pq9a)vUBqwTar! z^ZS52rrms*ou8!GF^g?PL#xW&zf)BSd zi&@H+%FO;gYU9*9`y;t>FCy=spOICBZHk{ zKVuz|dHzUag42Jai+rwxkaRq}8BKKm@S4dV4xS@VIr`{5+Vk|Zukd&2gsY7lezUYU z-oLwRR7l-Ez5prsv^a0()b>cfBFGN!88J*(HeW%waHF*f`$7grqV0lf5OXkpbl4_p z9>)`ZU+lQCQw-UvU()e8i`u2>uUuGpJpNuCHlUr&SMg#TE{B3i2-vI4e`}V)J_E=G z)He6rFwJ%%tf~&EvbzqfDts3yl5NkQf)o%nR!p&_})M#Zni%1 zr$&g5AWa;o@e{9VJL_&h^$+&X3GY8# z;^Jq^oakYU7y5*W2H7eZXSp(0p;mzKLgo$r1|xZI|A# z!c_-cxH6`|OP$*)s6uG}YlXF<<;H?;AO^iEf^{NORfeym;R6%9><y7qNI_@hks<^UDd+!t8knlxG-+5Q=7ZMYgDp4(JC)mYk`=KA{0a8lV}YFxPy zJ!|~~(m~&X!Jd>)lxkc>smFS4K({73C-Z&6WRk;#{W!1%yEC>ohy43n(z-jFbyczk%vf^wk#lQjE}(X&U)~2R;Ez#mdW7pIU$>4U zwwKE6nIW6|$yxl&{v58j8_!n0+57Re>45eEGj$XG?u|%Q!ESxcp~3EF09Stds)7BW z^CpdRA_X<|$7<55g*OW>W+|obvf20h?>Z{1a;_~mJZax!K0PhN$iakDA8)wAp_F`82QeTWvMGNr^1jCkq&R?Rt=vYQOjG_h0iGI z{{=5>Uo&|W93nZ~7uf4unxWVvnFT>ZBvNIKfjWL!a=G+Kw=0{^b_h3@Dv-3|AHZ6z z>LExUzTCVH6jfoRe<1Yh$07_nnxhDf1ij^H6z2{+r7B(EFH*X|P@%@bz7-8b{70 z@<5Nwq}sL{HH*8|V|VT!zx+os|I#71|Jy5F z8xiE?K-g6<9Is~ES~(d}^({TvR-FvFsI-8*oiO_orAas42CowGv#<18hKYF#vOVfi zjRlJC!vl%_!jN_zT&fkNzx<6eF?qpb3$=rOTA$ zdoyu9gH?e@4KdeS@?CupTRNdiqvg=gLj2w2)B|&5&hDEG!m}xt*draPh6#VGnOvrU z_AP17wQn;j!TnDl3%kGh^FH+QcWs`X7P5PKfhX$F`7HDTOV9hTO0b5SC7QhB!Zy8o z7JgoKPAn&KI*fd-MixbH?bOs#TLg-3Y0{6r^k7#T1)g1w^ z;KfRp7|Em$-&-GGk5J>>79AZS0KDH2NB$2!}ibFs{}v&+jzE8K^F9 zoqikk#fZe+?%)D-Lh%>&xRB9%YpS{blviSFzs)r~(5qi@;sXd@R=}V!|MVdZ5=nwqJ47HPi-mL!UdK1qY z`S~4T4a=|LYx|S^fbOq^Ux*6d%_IS#!@2qG&CJN_`5R?7x_yU{U>o105PW8cX@|X% zP`&qCxb2EU|1UsFZd<1bgv4L|oxA_E+_T|}EWdIfK>p^EftVtcrTv{LO=*5-xd^V` zKRh_aD$#G4yE=BZ8RuKU6K3d7Lva><9^^+WFrA+u@?(;suyJGD9RB->K~uINk71l` zq6mbkGDK%PF=eU!S>8nn6!-+@@4b=5Vr89BEyM;RbDW1||Gkg_=0Wu~v6=&@z|vQQ z#k&t#KsTA6dGdceO~%#48N>IKTCMn#@>^xoK;4;lI)6Q1SWm`(dai7ErGB-Ae0Qpc zmtbmt~McOACOfO22`?}>h&y6HniWo<|0V41qEtrs1psyIz49Y*B0wj%I(qSw(r(!12Y z?h>CQ=HY3&tJQ_k;b@~5`u?hT0r>x|Few{#qL|(~?Zh8pZ+n!s=lr8Q#Te~_0#_?p z{XcH28e}UW-+ZqN?zaw*%?&J(6yLn0X3@`UU1lj++Sl95av_f^;!>m)-Ep~!yy1Si zGvV@EtrfJb*>5eLNP|r+>j|RJ{oHfzIEK#A zCCc*_@r1D$CrBBTsZlarZJ|vGxKYdF6u2pN`lwBoHl#DGU8^ETT6>nG;Oa56{mY$C zp~LhQU=f0UlRG?Q`9@Z{EQn1Iii!zbD077n?sxRtto(iTA7=?jkDe?gKm%>Du{6)n z0~b{3E{{$hS{-l&q#!LKWaoO^m^{u1Zs(^!H11H?Yk!Dn z&HOZQ?3NZe`x$;J^``a7U z9IjVi9`t7o{x$Uv8D_9g6n4HjaQpP-Az=B9;)IV2&WN1u+PBEJ)WU!aalonR5 zLW6Ekut0*UWj zak463mX4CUgjlw)$F(VXCQyvlAR6;6bt~z@FB$)Xia*f7or*gk$Lgnf&U~7wVn%09 z7+(=9o%!~Pd&aovc7lIwCpz$79!o%h@#O?;0JR@B#$@z*t?!$OdddRNU@9{Ug~|fs zj%oHdTBSnFl3T*<%wUxY80r=Vij{%~<@R<~#+HrHK3s~3Qg!AgbH$x$7`a)i6P5xD zCpH6;o3|UYf1v8>_D^h$lV{nXYYVY1d^B3`bF20*0yoSn7H|&1)2o!Xoi=_z}Qq#AD6 z5p{t&#wrN!OSx3&IJdQ{EfKAXr7eu?41*_eX4kHn5WPE3dP=;i*5g?(y*njqL`K27 zAWZsYqu41JMm)RmelZK^=U3&Cq2O<=pJBPbcS_)8^*wgdLpWc7q89txlzs=VHcwkZ zjFy};O=_2g6}|>BYV(dBYiJjV3asztyzm?_F{r-paS^ZFO)enf7&bmf3Vv?2`%K+H zD5;B+sE#0m=<2p=q+H+r8*P8d6CyF(1ch~RR^)0}rgGm&yGvU~34V^vTDjwwFoNOl zNsRjJ-_dKxnQNIxw_SMho_}pl)^garD`VFD?nZ>*9`eR0OpH;*%+evTeP3uz9lO1( zCBfKxw6c1_u^GMD(AfHpy~h5qKL{2~7+@p}&T=_rA$#HLolP?j5-l34%Pf<_9aw8Z z{Zj$8;J_XkL)?YH@E!CVl-B=DPeD$1 z8_82o!qDqopNXcbG&PJghdK$^05HcfPC${0rLQWEvMH%hf;xhsVP*~uf5;M$HmcUoVu3u)!8#y+MTjTH1m zNZmL5dp5p|H}W>LM^B~B7{*O?@+Z*$JW@E<0^rSy*H2?W+TQwk;Mh0zE}{Z871@*| zZ9cWuq>4Q^u9Z<&?1g%*5x=cX)gwC)_S*&_NKl(!#Dh=Bm^oO60Wn+ez zDQRj{1+QJ>p*Jadp>QqbnJbf&9h2|n!|?i815nMzr!dS3VEq@TH^_yyjMY%$HItld ztdqkmpfIfmzJEfNWf-dcc7(%O9CqqyT{h$EbdzwMmKGu179{Z{MJBNnfzEo#MW$xR zxw%&TmxMo5RHyY=!NPmV&_b-Xk;z<6aqZ$+ z*MpEaH#gajKSOsJSrmfJunK2ye;#ACM#LXzClq*!5{l;(gnQ=%AOFuVpDUJ#Kh=Fz zQQdiQr{F9|f(LOelrZ+?B-wXvO6*o`+VMbWE4OG4C(3*Ap=o`oqZDIBl}H#T(c1DM zl|Mgy&4haVV=|18;ofv;fA~YlttN!Hz=!IZ)r)^$zDM8(f7AS1qW@cn|4-om|A~(n z-%r{QYWyB~7a4@@P?z=F%C`xwFSs7gR77`Ix^-egp&J9csW_hVTS zu3GoGb&ZwXWc_!F>45=C6fM5k`CQiET_y45Mz0mE(;mgkf{59jcAW0UR81a}SGEE~ z268Z_?$j$FFP|&pyHOl53xyn+qucyzn7o1xQ2<^A1t3Ms|6%Vv!m=)p{}B4A+PNCcngJ^&xT_26)^M&9^mqdd8o zje=xTU?NRkdxb8`T>w}WCQYL(5b@m5SxM|4nKTK%I$GC<&)(n_6c)mm>g(ryqg-8G z$3M?lKqTZQP5sJ&(RShM8#7LAIx>zxy?H)lrI{HCJcdr>3mAvC2H5W-yAF8M@$B{oi+@GY?y+_86O?`un&JOd{1@U^AoPKCTy2PPK<>h8pef ze}E9_`ePTC!>JgZ&KfMb5Ui4t2Kz425Nlok+2v&@6(bwk+qM&-BiU-W?~(#R=(?>B z7LZAvNt3`O{(QfYkdaXqI{V~xiu6pqlb(#Dfq{YhYN8&1fts4#g+qHNY8UQrKto zVxF%_;4K#?Gn77*|e^uI;HmqGDNgU;PfJ{A8`lCZ2*-89j1q;zF7c6 ztPKFgL-b5FWE_Q1{`@gCye~=M`@AmuOPv6iyG?tArY*hz;eY>rfBw6A2w)2a>#~W9)yjkwuDjvvbN@~i$Y3gVS<}_6^HRDvJ zZgL~|-_Wv)cFhI1c1#4-p4wHJT^s_FL$z1gi~Shq*TmWd<8tVCsa5E7Mz7^_Hj1@wli<|^SJ(*wyzvvgZeM+Z^TePdh&$e z+COzeZ##<*xYUv_@W(cZ;MRmQmR(}|ZrtYRUQfU9CxrGnudc7#TUr8gr&tpI3e*o( zKU{>t7}@X^#f#>0^tl$4Y3|D4)Egsg8F_iSpS5=GiSJ@{k~ zC|~{h@QmVF_d2ynreuJj{S%764>|55R_UN_8N15gA3;&?n*7nO<@A3uD&rOF(ee%sl2a9;$m z*_!>YGN~#5&M|zQ0DXZuofQ4sMKRs=&JFJe_pkl{wO4_HueX1rdlbzWFrWaxQN^%9 z%F%r@p5dWSmwAV>QxYK>a~d%`QCO+QrO{h4DLiAdJ4cz^{e$QpA2ds#yDMN#I_5WTg{ zv6oaSuR4Pxe2cHK)P%e7z;$+x5bwjEut$v9bSjwNlouBAt+c_B&uUB@XagL|Xo2JU zTWSDSWTWoe29Eq7mELzr#gwV3+F0)9EV-m!6#0(JrUu~Q6;}aM1lnD@L0}UIkhu5) z|HH6zD#lt$G*+o5kyvknKJX`%;Z@TQuqW!#u|R_6gd8dixR7lE8;;j@Z^_}uOlUnh zfS`se1j(I|g4fQM?QU^!&dW8I1Bm-^8;Ba<`wkRA4ky(nX)gCp2e#&qL_m35%MYBt za>G@T?K6?}53V|J76+App@#L2*pzb1wEA zp^w}bTyeM!@N6PeH{ny(zEkG!WYkkhzzyWz8#eY5{%?$~<4NmKKkGKDv5A|w_Q7ek z>wM%gLr+E>xnIXs?|JB!m768uH>xFK*KqS>h=zGx;G@-VJ(l47z{;X|lGGPWV3Ts0 zjW!}YyiV$;a`FIH?zD=Zm?8DL8lUHvpPJgvTvSJ;5h%&R9kik{iiD>;3Hwii{75A_ zulcYWKlp>)GkcwI-bHIzE$8XBTfm95F6e3a{4^#CK+@AsK=I-0n3H$tR_^1OOw1=zBt&3QkI*?HTQ1)m5WEU)`k5DE0GAiH_U5Qn z7S9X^K?ks*a!?3LovONX>w9zocy+ntm7rGg$Ep&Pq?QL!|Z$Kq1E zTIhVO&j*xXxpgIQ?^x4>HF=Q}c|-p;4t|syWz3dHYTZGH5nHK?gl)LB4}*}-8VU*T zoppa4WD-IzxdaK#4UzlS1l| z^W^nR%4uRliZAax; z3o!F=QIFF~bA)+iL&Et+-n#{}%&lH2HXKVJ1W0}pT5xOR!MR{#qhyO`oO;yO`PE#^ z>q}zyz-@7cY9~myMlx1(Cf*;rFnlx@ zRpp&x?Ubgb8%+G?_~m(p%lRp(R)wSyx%o=PSw9lv`dF{4M9>8Bq$ zZyb#9A9>U!#HMU||18feydi4&C>JRG_st^~s_S(oww9~d@-(&5^ni59Q4&uYFUZ{e ziXF2X^U}6B87Cs^Cx16f_p|{K1K(`G?5winnWDHT;?@ChVIKa0n)XeB_zOlxkmf}h zsYf(tu1V9-FwcVoHi41#p&+TuCTYTVmyt4UqwHU97!hy#cX3TCU zo(gh%7=AT{fUV0l{4BNXo?fodACb$QDoteFd!PB9GKU>JmZB%PYIYt+iV3{Au!E3R zBLTA5cL15?Z+aTM!{1XfI;gqtX`Vj8hdNkB zGB}0=xo^7}fQJSvh}%*}Xi2>czwcFs17*RrMX#3ki+IC0SY_^p*Q7~MV`f0xFpsj2 zU*>rQ2l(geX4^v1_2h}ss4Y6p_U4lSLROPi9>@^GZl@($VpEMEpAqR~YAC~4@sb0a zzIDV5(!D)C)iARAGcoWilXzbS#8DmCMO@W&aME`-1^0ZBR!Ocp6%TKf^o67}yUhc= zZ!doTtan*8;wg11_qRXcm%wGlKjlc1OYhx1-PDnDcG>b#4z-7+hH$=*=5Hs1LZG zmwTy4a`>h;jvWhigVD84^bo}c z^Y7*gW7B8zpAeo`*uI-gvf2Ftt?|*81EhJtm-chFlH=D@Z=s{RHK)Cr11hkp6VII$ zd(eb0mUhhR*pW|S_pm_Q`1Sg}y?Eb&+MsfQ(8NtglXcp(Wn5;D(PkRr1~n0|H!j_# z%+mu5&3b`1-|=?#etaUTZ3F5Tqr}2CHv$JsnTmU9$IDce_uiL&$&_s|AfWXGdTgu98mTC zio{pi3X)KVs*VZR^lu;zzigeB0Gg{IAs)^Itay{^{_Sb>a-|)yHml4GvM_!BIiM@U zZUyrCexLBbd*trL-IM2}CW^ePjX%qSlXBvmSB72zcNHM`^oH7Tu`-e#Ieu5$^S|g7 z*|M3m&vBug|LwuY8NoG%Fy(8U@TuTVUW02=AlgkeX`m`N~a>W!-zmJxP5FdEtPzsjU-ae)Qo5 z?!&bkHEl%HJma|Q()<5OEBik1F1A%rmjqCJv{eB42V{hJDoonhp+VpYMip+U$Rqn>JY`5GXBG%dT;mcBOSQbW3xazS0hffpEp_dkcIR zKo_mlwYnTmeJP6T!#{`r2`nyq__*SgpTWxI2vxG2ISw&`p3VJCfbypMo5CIz;~(>{-Y^&;C<5m195JACLXpQY0XSe#-f={ z$Cen8*{%c2_D@TbX^UYQ@EYuD&(UsC*k*@_s!QqwiP%`n&`A-N-NJS->w2Uk??+Q_ z^w9XrCw_xk61E4r7p0B%8~XwV+IBr(0|`jrfxM~ljiy@{y@IRf^&!?}8UMWvTsp9Q(I6v*;P^AX7_ zJx&QloSX9^_BNeblOs;!DPKQBWzdG#TCspqRI6Urr;+=1ZS5y z%;-HSzqR3JwWG?TUc(p5PT?bjy+0C9M^WpL>{kMS+Sd3Fm5bdE+`2|347N9fQ3{^p zMdR#a?8{xH3TqTK-HKuQaFj7X4FLOFDr0VeuyoO4kvh>`bUCwYnj(l}}SWCiBQ_byEJN85o*LC}O&CtMj z^(o%@wtSn-@^$#<`p743I={nufG<1^7(-)msClLyamBgVV2No zjvs1`H#Ae$kmF3Kh8VK0E^%?x48zslz zMLawfS&tAm>#XJ4hM;2RGBqlyXhn#>=L>nzPdKa1v;~RGm852B#AGGg&f&Bu zN8S<-T)rWlGkKnwW#DYA^0t%8je1mKVmcQ!lvg7^UkIclSMx#?@Q$YHpz zBn1P3h`?t{+`hl(AJnjgvpsC7YIu3L>>fjFH5)vTCg7%E-%+S{znmuU234u=&L@fI zdy9S>zu;!WJslWZ+!j^BTxnx-mfx39zcRgBgB5w!d*IOfdxMik#$RS!PG{8A3n%f@ zUr+jwjY$-`o5amU!TO?l*utb_cSlW_94o8z+3-GS-hbA;hiYpBBxFKu031~+*}3?~ zKwI96-GsKlH_=QDw?R71Vy6)eSKatje$>UbvpImaC=M7NSo&RL0HTo%-x}d&@zpYZ zMPhd${lr7EW+cy6UahtyN#0>(xyE}CbTqtFGG3WQTVOo3Pb*P>=I0af@+h4rU=!lv zT5excsBxoWLJ~A3`Y9{LS}8qTI8tB;cOEhN8^izF-lEKw>^*u)2+;U zU2j|=r+Li*{f7e5gf?t!ZBZ*lkso4S7&cDWNPKpj2+Sx{owG@koZ8V5+`fr-7xpjd z(hQynPb;3!&J^7g`-3~Ui=<-?Ick`HzID>2J*N@hcu|tvto_I0@VepK{^6026|Mq9 zrclSWg4!*z9}uIGuQLjE0k%Yq_TECU&0^IU3^roANBN7+WxtC=d$A6}1oxCV=k}(I zY(kTJP~)}}3s0OOT$ed`y56?%JVLcH04i9Db3N_jIJb`dW;IX}qj9u#$0siL7^{?? zTyf{@aVN)GDB|hzsS73fNbKuUC3h~!Y(b0oSS=ibU{}3#Irli!G+f`uCq0kx0zU^g&1mAlt zuFf!?mPS?s$6m}x^mNT6RN2_~=i$+OSm{Rj+vfbN^6BUA?F`Rvg<&2AoDfYn%O4Xu zm!S8%Dp4asOl;=tznVXJqD%WZsRHVwS~V})N7GKVFIpW6xq|{TJkeMe#+lOSt3_P% zcM<0qP$;K!%gQozf|@U0wq5@rtwgde@ktX$T^a`(XQ(dd)pE-C7-9zfU7@`V zmf5S+UI6g&zVeOqO?dol0%2U0!>SVXP-CL$iDM|NTx?adKKNS1n`p^jiI-dQv4LnVp}`Z_#UbXIHua2ZWPQy=~%r zyZpH5bobH);crWih>n1zu1#%yaYNb0q z%v3ryalsj!|IVYAys^C}H7gB=L5*5BPp6=YRB(`h!}N1KCuE}PP2VbYVseQMFU4J= zbhoyYJH8ob5rf61=PI0b>+4LPetj~_G*p&ILmA7KzpQ9678T#-!YUahl~+9nrK%|x zHW$>&n{Dy5q#33$5M4A{J}9rMaY$`@cc+DF38J?F%s=I3h@eN?r3SHi2N(*{rgPuspO3dL!! zcaoD%F-!fd4UDFZNv(>Ab>S0%j1;n4Y?gX@eKb~M7S_{*UbV1k11na>q`pi)Vl1*q zFC3n#oF1Xi!FhkGpuqcJ6cOT&_u)XdY0}$wyRu|FnB^jO&vu`JY%E&E=P2rax9DcS zP~YY+!op!)M_BVY)lpc{e7<76z>%ZN>W>Ga_OU+>Pi|h^*G~@LJz5BvEPjO5n-zep+F9IZF{y(AdYoSTJ!wYq+rRJBGRa=n!qRIBLX2$@+T&*k5)su@^!>B z5ADy_34Pr}M-<7_C+5IE}CxDe;`mbQ(H|x<7mtlqPCG>FR?xLowsDXp^-M9`5b(F=&lFN8m}I5 zPWy5x?<*|5E!V$ZWg@ItBtClP*UQiCei3Bx6nU}C$5~#uzV~IO*qV`6k`;9Mw(A0b1Dy1M~1LThPo1w=34>!$rSUUgahJZGkjedn9N zQCnf=#FDua^5pRILRlg{fua9rCSI zy8Ln~8KZ}c{JdePRyU9{xV|2c3(b?#Jd?&W0cWB+AZcOIz!$@qbhR-f=w14AHDZ&yop>jP`W_?jF)JYO}w8E{4%?BC#>^IGylhpf9~pBwXcLcHRoGvPsmn`Ffe zf^?&smc;_tT2MX7K+&zJC{~y#0?a0boqv%67d)naA=E)r!rP=>AC!DUJL$5B?7n zeRM?(z;kkSCCX&ew4{C3miqhe^Svc*Ge|&?s<{u-mvUROFqKJA882Cx(;VLW^HZ`S^%&c zWYf?C=QP=0Y?Ub($scE>%dp!KD=RL#>@Ji#?A>tnCM-ZWt3Q$AjCs@C{z~)>dTuHH z+L{#q%4LC?(P_e{L2p&pwVL}2hxqYvb%bH+P={%Rr47$<&-e}hK{2rk#m~#Gwxdgu z&$S57xV%vQ4j5kt)F1}-U`~qv=`z*fA7g=>2gx&@YGdz_ zJOcAsy4a2sMz6}0sFjUFSNt<;HVrYxv4%iU_jL(|?TKhU)#826vdz!G!o(*s`nuC4 zo$Bly?{2;`@Pc?$<#30Th&L+{LCi&yR{x|GSxOw$ESU?hy>)WCWS0^`Uekw07t`u| zT|s=FksQ}d~pebe_K zNx~-B%de(FZ*PxCVhY^V(qFor)z`ZI0rJ!ltD9W&ETUqtJa?;?EGmdMbu_7B=N}5< zH*0pb)N#map2uAeCWS@Hm|pSvGHY{E3 zzv#gQzi!fUI?qb7niiya&DoD;xm6*GZ-`qsUaWbQO@>DW`bR$h&>MTLqfyUIV&{1C z>kvGo+d-{q_jysxDADJdoy<+r(Sg{(qE7L0;#bf$yoML|YR4r%tL|yGI~v(-7lFUe z29l0|9+_*}-c{49tiA8N<`^*TG%S3|lGn+Y$K_{~b|%(TkU-5Gg{)E8Qy!zgbt$y&2=tuOJh-9UR&+f4}v!ZkG1877>x-(hUt#F zwMzzF!+XlYN($@*KZ3+Q3=~ubj$=Ht&UE+Um@Kw^VUyHu>SkPGw#l{374})EQJ&== zKchDNc*`xlcfx=Q+;Q6SCJPxRuMY!ou}-`0d^GJ9tLERK)n@VAtxXOE`lsTX3r#1~ z5?!C7P74*Oz8D$T%-lioy=l|rvx2~dRiGs8N8!-}aPqywWrVUpm+ zwG^v1tZRSK-tVy8{o?*q)7ck|F=kv!`G|Yog)KiE?N-ss@&oDjk#t0h`^7;*iY&|r z9gm>lc26O@55ElYP{aHpiT8JI8nrgAMei;Uk2x4GdXiEm_6oK&HaYpnIr96(&o1AL z{DT#P@PJwy&TFaNKFx{T&rT3O+?)f6_c4(uT5hJ#FP~O`6eRnQ0$JI<9wPyli5_9% zVt03vp)H4X?DT&qxkXKI`<$FJ5UQ5@7QOo)E&uY6!7s#2w#EFEY@+aS=jRJ{^^z7ow_5M# z*%~YzeDT$m#~T_#beE z)zr_+S*KqtwZwE)4?b``GO?apzMUKA?MC(KOtNX#+keqslA>o2q|d-lx?^_v*f~=v zZ+)OO!&2szwg9$sVcZDMq;P4c`x0w{EqWUQ;D?mJ)8(`Z5vD*zsqU~IDX6(7qEo^V0T zzG$Abk30^DT-;X<{x*cFLzGFl{+hJrIABP6?!D7TNzV||&o~#DLjxV5>L_J@C9&3$ ztWBL{-t>S&O$>+)3r>qi3^{#C`^~N zU|(E#aqwBx$b%IMjW_$m#11zeJ?Zg^o#x)Gg99(UdZq0FpauL-b3kvKG6}ot;OX~g-E3Dq+<8X)fA4Zx zs9TT4D>KjQ?@-0(=)aJV0~eBSmGqz1#h!0Jt6gxPM@XB zJ8l8|bae@Yw9!Z?D4dI2H6q8y^PFV*e;D^_Dt|!(81iC{FZt?EI4lX6^$W?XcQv@R zcK>M-Zb$tegN6R<*@u6_gC#(-$VES6_&d5bKY+)OkNMEQFlykv@uI&P{U5yj9qhm1 zAsY1vh2nPmXYzLc|K$H-?mtt0|KSQDK0Xr{*K5!fS;#d!wD#eVV^IL#RO(eSj9*mY zFsREdfqw{KqHSEUb|a?>{G;^38jE z^p^Q0`fz=JF^q8uv)49h{|^~q#lps&%N#tXlMfKOp942XS>I26y;iDM*#*SThGDV( z7kBQ>j6f8Sp=T{P+!- zj(QY03W&g@3?U$S2?XoL9NW=Cp@FzxDW5L`aqEH69{(UxbW2Xpjsc6pt_f9aZtF1m zBW2}H+V!r1ot?jaYkgdh^-{~B;vBC8dMg9<2z<6kSY}X7z!-28rx$oJk|)3H)rQG5 zb;SUox>JVfw;HjU)E5hvLi1qulGhy*wL36;Eg|P=}y2? zAoP|Hn9-QB*U2;OqG6crvB35>Zl1NC_Q zi373Pm%Pm?q?6MHVXOp(tFa0CRc*b^S|374#>~np3xXf-&OL;PAA|$2FNBbN_1-sc zS@8ryR4vZ_ECQg`PMXU2`Zk)n`u+Zf7_PQfYgrNW*wUs0g3UqjflRSUVd=82n1|N= zLiV-hop&z!RUC@y>NPPsn0n1k_04aZo4T9znoz9(Q_e&XM_`$@Bn(@liLN+6DJ8~p zfH-w3VE*OW66(k8O2~)Xi8poHv?Z!Fk2R3WoH~Iz5_Ou#CP+U{5C7uj4kdcEt%fR1 z1XPr?e0(1kYXsabU7l5{C4`xL)!YfQlP}Zu%bTWGgPCaV#3$MzwEe6KrX`R#gAz~8 z+GJgriOx=GqFtDd-}}U*q|j4Tpcx1*akdZ=9uotgo!_eedusp&K>N|=n9G2`zL&q}-+ zKrV-wxe_UP!|(zz2Q4c}X=#xrO`ZS@D=Y76 zoKU79xJs7zuZC=!THqvkxm7~9b^29p=JdSMj@}MRsX(Rxp;Ta0fKm!jJ@zTrZaovV zF80?(+ZG&{thOa`u<4lU!i;s$h9$lW&40EOkq_-tinfwr*19lBn6GWYRwWFf3u`U) zbt;G@^T^OISyrUi)7?7LLgXZhnj&573u2u-GK@-2q-%+EVHfH<;fZ!m+D*%fwaT!7 zD$Sh~yP-1erlM&nPNXXAWK^lP6c$jcx%1TyLWQJ~PfTqbLGIL}V*5aCv-*3SxRauB zEgKkpDMj-7!{QI}nJZxQDs@ZfU*V`EWAapMzb3L&0wjJO*>#s{H|Jigk z2D<)Z)BJDy*nd$G{^zak|4U6?$B-P*uS+4S^4r5Jgl^jU(kFHV9YR4eqYHw!?2|uU z_&QjYa<3+|@ZyKee9Tc*zZ<+I%Oq&aQgv)!t0o!ilp6ApL8ExG(XO}gJzB4JlPj%@ zL_f_Le`|a@gj#JghHiZyUG>@`eku5NXCVAK@rCO@ zU4P6&$ET}Q?Ds;;#!26fjh1^~&XEWY)^%jf-VjdlBbPq~hhU?8O$tisS68OeKen<+ zcB((%HtrSsFb<~PSKQL_E`4o{qOYDzTk%awzRua=X6RVRx`S!TUY{6KBf2(Py^sCRDT{EUrWX5M#n2+qnIjG%Z z=<(v(t(K}$ZBMbJsAX3K`~l-~`W?p%&Rj|BqPd8yp$UXC;*Pqruf&sA(2gdEWEkXV zdtP(_QXL4fAS0F@jrDJ-5T_G9jA*<&d}s049jnep97j*cvf8qIu)SDGz6?z(NJeRm^9bTlRk`r2}jYd8R}58t2y z{ch=_Q~Pfs z1#RKPr1#@4%qhmz03=K&)G&UZW)X_+jp7pa?hHvNcA&4u4o}pY*rNRuu4akPT+IzMogn zN01mghb>_m^x?s5M#$m>l9s05%r7c3Pm*{yiG+uJ=A!qTVV=GxA1o zXz2?tKspFl(Xbq4H~4CNQ(zy3f*wB98vmXzD%U1nJ5WZvjT8}(wz(-9nttPBaPSsW zv&D7Y%}O-fo?^Ihl8Y`bFiE7e6dvR6#I_gYv$!E_&KpZPgXj%9L=^{FOAOD_a9Ot2 zr?&crtLj@Cn|uXVte>Qby?&UBq3)HpU&s4&p=eV+=@Vn`OxF(N8o#S6Umiw3~m&C`2aufa*^rKKF`F!Qcb!37)-*t{LqFkezXy z-(&BUdKlxL8b6^Wj4Yw;27ASk=T9wBMiXs@o~m%ZbBBo+`iJ_D9k@hltsX?Ti`IU1 zjE;-Vesuah6&pe{a4IxW+W4G?odKhLgUn2Tpbr`6lNF8-u>mVYeF`7OS;EnnZ@6mX(DMA8$lgZBLQ^(4QvVcn_?)JkijkEM?m?E(b} zm3u6n$dVZAA#yYr<=%X=4yE+VIJY7;&YV(P`(`J#;=jqBhbU{YcXU>!wxbV43=Z2=u1{o)Rr(wxt9^kjS6K9&HQO)P>*?B?fn^Bl z=Z356O&2?Z_#b|`JJbA8a8|BG@RtKZ$&AgRI)jA-W1VOH&;Y8lvQsuxC0>sfsYh#@ zi)`+DnppR+Ojtl0ci%ZBpvz{y`Yx6a=P3t@Tb6^k&spj$nd*2l%z9t^BrQv6n>}+K zIq~{AGHtvmWB+(|Oa%uG^B_v@)s>?k+p|d1VAx6-M8r~_@*>L>n%)<+CRF&hbTKv_ zNRh~7Y-j9Pa7PEePlP9b8C&*wMO2HK^X0^19AUq$&E^*DVR8 zyju~Rv|{6sE?O&+^<-bN{#>zInZ$;XBXYNH8F7!i=zImUnO<^EC)(6`em&DVt*b>MusPVK%!2vhKCdSla0s%`BFZ@=L^Hs+aF>Qa8-%wF=y0lnM0 z67idYuroU4O=@To^RAjjCsb1?Dum55a(v1e&ZFNE9r$V%tQP6*w0`@W+olZ*_lBTJ zhWqZ@3!0Jcw4~-$bNv)AQ?Mwn(#OvJyIu02ZlJC(EdAEuZ!@kj$9hoF2wU4K9&e4A z7di9*mJ%& z=nvVi{d>oDA40LOF-M;54iuk8Vt`M%GlYdzjx+;j>=V4-_p_Ln^dl(5tix#%r8Foy zi`E8LP;yLw^2H#1|=tr(e zlJjhT-6F<@2wxoE{^t8W!I*Fa9op3Krz2u1)EWK2+>E_&aH@MUSin4CR(|RO{@PSx z^NxAdzQH?OiKQ%fo=xmixHIG;pZ55fakSy`tiq{>6D8*^IzH8lP)LpUaL|d-?&0e4 zlGvsHfq|MsVfBwbVdZxW;x^F~9HWp?Jw~fMMsFitut%W*BWZr5zJcm3MvnQ3Pdlf= z$L4j6hXlpo4DQYkITx?mBHTJk-JV3w$HBNPXZY=6%6M^GshL$AcZ((=LNm~$_zus? z1J1jgyV3VtqO{X(TPMXVXwh6n*6%Xi+91`thP^#(jIJm<6Vj?5bM0{qnbsY7hC<5cO+o+kC|Doek*>FH6?d- zu*_1)Acu+7MTy5gWQWh|Fr6U}+;<2c;qjoTCrx{LFHA7m@=cP~rbX5DIKQqr-4j}z z9`8v{fq79GMX84omB0bH%jFJ5=Z^uxRi7uFWruI`I%wA!-mktrt|3b-7!CH1$2FPq zixVvOhB#H({eDCnbJ=a2$B)}h+!3ax#O{W4<V``Nu$Qr=WVNZ)(NuYXW3h6aUZP zN%v+S+e~lUC#>uHwJ_B3IAQhshY`Hn$ex#dhK~t~K_Xf08obB-U<0b~M6c4JX@kd2 z!GtAm3L2W!s$Q4O^lZ+pc+Ri7YgZ7};mWIji%)Z0qTRJ$?>&K_2Iu!So49MvUN8i@ zKGfe1ay{^Ik#YVSek}R))!yCk&$!A5GcyC6Gyh`FVE+*8XysNgYg z(%RdpKdJ1k+qv`v{0w5T4M#EtH1~#~tYnLZs*U^ok5r-6#>SXxEwf(Z*4CNyT!+f} z3c(Jkf~Rh5ew!oPT)c`t=6u#hB5&f>NsoO_*6{frd(H5}3ubi*=FHOiJV%X9c4RC| z(tHkB(tU`#fb=ItY%+pt-RQ|DbYCtj4fDZ`+aWf;^YRg>%=Wj<_oVmd^TC=flA=q$ShhMrU;VD&(1sILIS+-<__R|4B} za`+Ne`EF{>P?~ai1U5AA{@m{~k{NdFpz}A!hN5V-3Zn(hxT4NuhNoCKWu~Qq6zjX$ zL@s|kNnG4yG&fol6nBSPgRu;y$Vv?#=-Z;{E<(T6mG6!9Qql|+@}NrStjt{u0+q*l z=NsnYbP@TJuZmaP&$7;b*<^Q<(NSixF3cIuS$?pOLAt7Oz{O%jwK*`!izWt6hV#yO zr!?_h%W>HUn}}n5IMR5P^4CLW1MYo!G57Sn&ke^T z1>-0nbTa6v^to^)WuKBhb(YRpnwM;1jz32*)Lqy6f&B@AGX0Np73;X_KTja8L@(v5 zgT7NY20g{N7&2<;`M%a4K9j^Alf|sW?@VPlR=6HiSQoID-X%`Y3Lg~yAfh$V+xDDZ zIWuT>gv`ey!baoW^BtyU+}e88;9O+8X#iVewwvF@_!|}|X-lk-6zEl-5uu;g&yCRs zrcDQ{>(KkRDDxrlGc!Y+P3!5su=x3kmz|LHYCUKa z(vos_r-m$o{`}2oRY=$KB&MH*3za7Q$r2vBPi34}7H0U@sw4(RUh4#ksX|{Qol9}i zk;G7`#{Ci1p016v{JqxJs;z@os%65l%chDYa!4elsDWcDkF?BOhs=hDu;Di01Y3crht%H~F|F#qG^tH3 z*Wzzj>psp_dBs1QNDyt>dM!}bAzG>n^GXH`*J(4>XGs2Pmp@;T_A1(+u!zqTv5>J2 zBpTs+6s`hWNRRoL?WdQh0T@?-cgP9RG2`-J|4(gR&v4y897X86f_~bGG5Q)qRJSgj z)RJLj>zz@qfiBAa`M}rf=VJa(>K_xfK0nX7zuI3knpN{W9la%7ef_or^KgGz$JByO zgxX>a`DQ}Quj0h~rM@DrvduCe5f{~AL%3@HA2cr6{f0&y!uHkA^8?h&<$x%?-YUC` zyA07JU64NOw>cx+?qX}Lr$*xZ?X-MGJ2Ii7aKqMcDoYmViRJfMogP1qaxE~~ohBd4 zOMk5vk1Fxs$n_-zva|V^>a1=9P#nf38CiXiM6B(r)z`^`MLTq3ekD7T)W;`ij7q*^~}2(a*cc@ zKJNGWAVi0$X6$MIjPHGTDyQ=#ocdXV2eB377)bZSn03{=P_wXY6I8#KMPFC$HKkqb zyXLb@(?90*8HNimtF6nqDJwYbE~Wq6ag`!_!JLu$b2vN&ie7vN2IlXyU@nOW*%!nm5g-BQ~vzE`HIT%=TT8TvmcIs$_?@E zfhL*-;y~qQB5c;bzfj)c|0U)loKwuN%EpB%8sc|U%B#V2g zFDVoa46d3KmU(Vm_Id3LC68*Kgrh8mYD)J zD}IPisF}^Ec4@^Ned&;V8MasHDX$DjeJaUzdua!k6zw|KZlm&dC1;&@E}|Z$cUstIKHplk5A-|E!PLi3jUCf{rRkRww|n!iO^|I=su@- z<*PNP4h#E`XZa3??Z!_N#xm!gq%C5p3s}Q1dFlv+EfyA%6!$@QRcxeo+CGpOlX4G7&t|}B7VNT zK)=Bw=xuv3NQ)gqUz30b2R=kUfAgr{^4RkgZSia^vfp^II$9yP8@6Iu(AexqW5O9YX z=PBcD*ZGvDI(kvRaSH^RF5^_=B~ge>x^!enbo)lz(DP z*G`t&S`&)=kCT_8NFlyYpvh;Y8DVKOmkGK3Dys?*O>W-Q%;%FeCpp(|HI3T@2xy8l zz-b!a6m?JJJ&bM|DFp_R|hjKoY&hbq%c za1`~8HHZ5%C*UGN$>IkZo{ei2r7!R?&m3*d?Z7kJYL{ zck6|YT|ymisRFEF{bbQxS{css{zFQ=TaoZ1lxaXkH?G9ID6Ry5>4-T|7jo^LZ?@u5 zzRJ?VR>TtdIgEKRq1^B5#Sa)C44F*+IVU2%nrzt*BidLEAjM4aQm)U0Yk_PNykGw=}=AhD33!P-EjZ+sSYtQ=r zcG-+;3;z(IDK$H@#KF%!m#q*Hg<&oyx5CE~%TeNT%O?D+iP}TIlM}Vtdz(Iq2Sz@H z-tME=Mil?@2$p>f6Z!ekd{B^8D)5Yic_ig+p7hGDpW+cj+vgtllk#~kPrCSr=L2k~ zym!GexqeCM$>&iDaMi?-tpTx*(}|!p>CJ0D>|bZ*NS8%Goc zQRzLIa`1XzXW_Y(&l~@_KT7vBN}yAyPm>qDn^D4QSLUpzAwi>_$wInIS#o=5BelyP zI@4%z=>JvPc}6w$b?aWGMCqN-n~H)+?@g&TKuUzalpr7= zEg-!MNN)lH(wj=}y-N)cLO=+e1PC3a2M7c>;XUKN_ug~H`E1V^ZP78W9S*rOdeAlR^}GE&CVYN&;^Z!883G)#P{7c(&g5Jh2x!L?T288~M4Sre0)tcAN@w4T3Kj-<204-}d*l#b5F+2Q=Bde663$n6aLCeUe-MBPXhQzS)-Y zS5F)v_pTs&=7AtYQ~jg#?o8UNjyZ|Kw!gKe(2!bx6NW zR^<4x+RsQ(fnlF&5aI$pzWQxg0YY~HD3|>>FVJ zwGYCXeS9DEfs6FXcjYM&J7*kpr98h31tbR$=xP{yoy(4KWzZdhE(hU4+A22jhmYC$ z7(JQy-Jq<$pjyn5?l|_PN}^?N6S{P|l)$PLpjY$s2&7G{w_%4eY4Umb9&>x?(#CL42}E5dJWj zYY&+Rz!S))Gja4Ic<9awyi*CzHqj?Emb!G@fF08#y&{Mxf<8Z0()}cJrg{@KBoj}G zHW{@asCYUx32irJTTX|0yA$+Bw}?Xg@^6ShrexdFbh{VS22)NeXunN}>s@PIkY)t2 zl$|JYJ>U#FqmkoV0xUsXqR*tPbNqREOOOO56jHAQaWQUO695XaEsbI=lmEMRU*mc- ze>Q?}bD_H9ZSrTA&){9!$se|~v_!sZ`L`1?Gw>ypZ%f`!Fyi^80t!=$YTz5_uZBmF z5k-^56Y?lJ-9A14JrFZTiJU+usDq%$LEgX4gjRAO#ec6fWeAeIONdf`hmiYQ6|JPf zf80vKhdh(7CtXi+{o#{^ji|##L*eAB5_Uo@*p7&xpQ``Vk|YFDP9Y+MW4aF4l(fz< zy$2_0S3^Ee4iTUxWSt&I$eOZo?KTlU{qrh8(N%ww5RO$F9<3t@fQ1kug@}>ja55e5 zspx#v^31mH{+Y5bZuq!}Ux$5>Xrk<%tyT~W!Qj`8QY3(5*f4Ib%34)8B4ACK8B2#G zE>Vzy5VT!LxA)`+;^GMlceyl`&b7nBlg$I^-U3K?26hW16We(803#01R2)j3C-f_) z?x-G4-)-|$;DYMuxjEN!JufdmAB*={viL4@SwRydgwv}Dc(>@KgnMGP=3Xb zLlAcY;eQ;#XQaDpdO92GyEb?^ruQMYL~qPv*1M%f{skPw7RkhuhujHi46f zqWkZfX=rt|Y~%+#%U*Q3j(n19q4)7<9)GqAjHWGpg1<`bG>wama z7Psh*g=f`_@2C}ak<%QFzOiB)_URL{Ws;diMV?ss)XE{lYU@M>5laQz&v60 zO$T^qq z{~o=Y&ub@Xep;gRmBre?7_~zA@z({AAM|4!SH7+aVGFsb_76{(o1-wGU04|rsZM6h zSbO(TjXy|AIH0n$YCXu_Pobi_$0sSug#@K{-hN2dZeoVr#{-)?MRkGsQwAic%1?wJ zS1#jefE3e+X;?{?!ee4Mq?uL-n+ST=Bt z=c#DN>9!pr!+~7yomLrqEOqLnvyti%*Hi6rinsXNilGTrVNa9fEH0clv;1~tW?v@T z#3{~?jz7-{AOa}A)Ua83w=lOoK{^{S{EaIpFncy$Iy+@fD?1Vk_K)gq=sI;-DDd(r zMa2k&TMAmkJp&R-A21s4R@$M|lxug@7!fNUy{>fe9zlmLoZ-6E1zfhF>vJ2F1Fw;* zDujpatyHid;P^hak8jS-TsdyKaNn&gATGM8DADVfLOVlnUd19orVI6c>&rCI1fl@z zP3YOWnmj$M+qZS{qaA&#SrCdB-m;6&5z}^5TSzG0;3`Q?{=(^Hp$Ea;1)#G<4RzlS zXv}7*R_~RWmC;BRplmMOo-3D9p)sh7ttfX9Ij||g2^h8|#7t0zUEzsw%|;octnJnu zPxB~zY}_T!E2yiFBL~nyU#A}waQS6bIeFPtt_q}LZZq*8Juy(kp19LYDlk1~gG~k9 z^F%4UoQgS)*kq(){}#2Qm{isEo3;b{^&zl4Cw0TJknFgOmnzWbNbg1M0`U5pgKY9fjIK7pv-XcU%!OiuO)vCR>nii73T~5#_|)w0zRbN!^@s&Tjd*U(0+uo{~zw86p#+C}BDd zUpJLt-J8dj9tbI5?T#kSkE0*xjbSg%`z?EmqX+Jmey;UN5Oxr62`haLEISqybU!X3 zR)gV7rf@F9?Tw#(Af-w+mX<^2b$3cF@s909M#Do7CMstyr&WylOp`5e;8`G zn4TtI4LM{uq8j>D%a`MU7+s!@{=R)?KImS#yhjogJZ>*?R-+?g{~D|S>hBndJLIyQ zZG-y^J|tE(Lx-lGX)YHo)QX&L369-+$3w-$!C}8Iet?z2LD4-#E)Qk6bHb^$x{2MJ zQAuQE>lCWnJjTw5b3xITYBO+f`J4w|)7%9RtzP*+!(&#YZbJ!>s)Kk^F^p-W_;ekhl3NJ0Mmeabei2JR}gj2@r z{ED)-wpgE%7cKCl5zD^d;9RI^I4lq$Ld;(nS}llCiqiq|`hGz6cADZgu$c*D&rO#) zsQgn*!VRgxpB~7>N)`zB@Yj;&L0m|D2#o^DRllU|bFhc9?N2>KF9%xYe{yZDIxO;2 zl&4gcQ}_(wI;D|KU9nN#W3RY6HjUYqrGv%p7|rc(Xa#CaHkqEr4`<*ZhD#%0?L}WK zLB+Fgx}K0w6ab3sp|c$B7ajhJ`)ef6qzH9bpMGQ|-{ry#JLin@hs|&}?wGIRa;$yjfd>uOyG$3~WiN9>qflWL7&V2J-a%1Fv#_oQA zAUs_+t)$(AuxsP16!#j8@)q_sl-Dc_5Gfm8u44VAJK||z)}Wfi)>GkUj(CbUTLA|= zaKO8#2Y+urRtRRcE=L;Us-0pw=T4RU3I;7zbmD7iRGxFwLP#nQSX=R;E~EPUBc{Z%xs{K>7I6 zjXvkHZb6tZ)RLS_)xLeGkvc)*4rcSOaq5tgt zlOJoGX9=BiE?_lJKr=>`uD@FoU{Q+>v^0aTbQj*WI59n3$Y~!h@bcC(UW6jQ$$~E` z5+mttR9)a$$CxQq*5kf9Pr9W_qBmx5r~;^VA}$*xQ^7YuDSbV|HAEV@EMxe$b!`~y zTHiO*&+wS6v~T>KA`vgSx}fo5r1IFAY7aV2uanNEZ7lV^EkA}nZ@hrZ!YorXrp;iB z6tHQ7%++F0+R#JX9@t&@P~mf`?S8N0#)s^nqmgkjZon+Kl(chFl^&aL_}B*-TE7W3 zJ>OGr-=R3pGQ&4+2^aw2icq2=VE~Ax_gugHdSA0r#f9J(TZ&3^1pdx?Q73C%IkS;9 zDt?A31|Q`T8u@NDeL0!YW*3tdOmp|h3N|U@@~saT6Cj2I;Jttc8Pq-+0OVQx&A4#t7%3^`xN5L5gvp(@v;e z?UU+paM0W1O43)AXg4NVa>&6nm_|;?x7Q0By&%8R=>inTGq*{8=g=6&_2RoHeaL>E zZU!>`yYxno0g54o3Ze%=-qZ*weC!JE1<-1yoh zK{-xb@XP4^TkxG1Nod&=%bpxX(#tpLG;X^kC{1dIlq-gomOdjc@Y3#&$FE&G$0Avj zj`^KGAfGjB5o>g~lCe}$Ym6K=E|#3>MhNXsvGBX2gNf@RZArypQn_vataU2wLOX;F z26i*+i~R^kFiquB)`}VTqfc|w+SwO#SddTr4HWL%?2!L_XOrILg{F5!2R@-ZeZcWW zcHa7uJTibazg<(BQ=C##|NpECe6?u7xT^Zulay%OpzyMMyFtKt!qG2|Z1#;h|Sn04C^1WnKe7j1j=vQmstdEg7F+e^Th`%QHCk5bBdZFf`~Et%$eIXKdU zeQkNt%B`_**UpB_>7*sP>OYD9)WY4I!gs%kjIqqQuj^VYIhC|ygDg+p6pbi!WOYZq zZ(XwW1}sC$n%ED)Ir8RvLC{5KEoEg|S18~_Nkwl) zh@HD(W>rfc+Uo`BAA~Qwj?dqJ3`1^mvnC4HwjLk=OFk!;Nh-{FlehKgdadMN(5~1l zFHA{cU?=zA9pszHj5zdDN&YhsT6@~K{XHud&Q+?7IInUnWw}}J<-kKXcgrRvwiik3 zIJ#TW>TK9)E8$Z_o9&(deW?g1bJ;}&JWR-hJ^q+H<#Nf^mdX$^=i%A?%y1<;vf1CD z^RLjU2D+@@<)+iyYVAyhlCNmc z*9VPs{qmK{zuI;c?ZpI}9hWHQo}Y>XW%fF~uIi`u(ho(Y?}W78HBZ)jy>ZV9_*2=H zNQErk-02lx-6sFxMgwProx8Hi)zN2B+r~|hA+OO||8nPWS49%o0+#9Z%BUo4#q8G% zM9T75St$WgTMd8kb>SI$5&ufe2<5Pb=@4R54BoKFH2K{5YVH=MV2$gmw=_dE>s^cS zZPj5XO(D)6mD(qw2V1wr%RRBGZUy0^8!Y1G9Wo<-RKi|3y&?7Z=WK=|O`gkTN!j9L z0u>Rl6*OnX(OeEo-e_4p`6fR+yhtA%W;u{)YW?JoObEe)lILV_V;3cDT)na?Tx~yM zbQc1NDy^VM$*~c=$0Xd zld{mCxwaJ^4LEex)-wFi-c!c!Zb$6_-ay)E5emll3iUh#W7cm6QCdrEof)A09! z`>D-S#UI2R3HG>nK#?5M_%VTwNZpnvJB}d8xNZ}NN7-Wxqsn5`ctQjv!!rZaqI+ZR z@s8MYsLj(|oOlCzgO@neLTKuh)Fl3~SpFTArxb0Q7 ztfZM6L}0wMA>o75q@vj)nJ??Jk40x&xNs5LUn@_!mCug?v_dH)WB&%L3Nv$%-iyW- zX6@RaE&a{oop%jP(Oh3C@PREeL{u_SGIOwg+obw1t8>@qyl310|Xhm;^u*C7i8N8~!AzX9dHG9#I!@`Zm3LdsqXHGbs)+QN z3dp2>>Eq|5??Mf_cKk`2emT=5l~FTLh0nQDL97j)00K*B_D%UjiVItOZxD86c%S!T zgk96z+-z2GV#%$4F|2DECTRi-;{mz}5y8@*{J-!^$Qd#fcE$qY|G%6p$o_Gq%@IlA zR>1){nLy8U9SL2=i&9>PD9S4PVqfD%x*7$h9sb5YuieA6&-76vc|Il56hv7s| zT}H;ne;r6O&KK^P$N+8_k|ZMpItl(YJ2n(WbWzGIfo*1^5<{ay6+R25Z{-(MEQ1kMOdCBn61ev@4Sd z`@s_LkQR-c^SQZ6O~Qit2oa`lZcae3zYKCN5Qs~MqZwtMkgKws$4kMOR4~%qR5GF= zVBktM3AVLp$1+^1bh3~i(4%xh@av8K+d4Xu^go$N|GU5Q-xvMQ7SR9ASDxIw4BWg& W(d-TJm$>eF@myV7twO~-_&)%dR&!zi literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate4.png b/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate4.png new file mode 100644 index 0000000000000000000000000000000000000000..3c86f1c4ad98ad3e3de0a8fa027d4882d20ad657 GIT binary patch literal 59009 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˙1)i4 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 literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate5.png b/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate5.png new file mode 100644 index 0000000000000000000000000000000000000000..dc87798ecc4d9f85b75451f54642fa400a7dd0d8 GIT binary patch literal 60143 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 z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly zK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF z5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk z1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs z0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZ zfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&U zAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C7 z2oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N z0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+ z009C72oNAZfB*pk1PBlyK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBly sK!5-N0t5&UAV7cs0RjXF5FkK+009C72oNAZfB*pk1PBlya8uyF0ninHE&u=k literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/data/custom.txt b/lib/PsychicHttp/examples/arduino/data/custom.txt new file mode 100644 index 0000000..d3db23d --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/data/custom.txt @@ -0,0 +1 @@ +Custom text file. \ No newline at end of file diff --git a/lib/PsychicHttp/examples/arduino/data/img/request_flow.png b/lib/PsychicHttp/examples/arduino/data/img/request_flow.png new file mode 100644 index 0000000000000000000000000000000000000000..1005a38895f77797f39ecd018d5fd6a746502a62 GIT binary patch literal 30509 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 + + + + + PsychicHTTP SoftAP Demo + + + +

+

SoftAP Demo

+

You are connected to the ESP in SoftAP mode.

+
+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/arduino/data/www/alien.png b/lib/PsychicHttp/examples/arduino/data/www/alien.png new file mode 100644 index 0000000000000000000000000000000000000000..a030da0761a60fbfc813fbef0716f801b7aa5ca6 GIT binary patch literal 28598 zcmYJaWmuG5*Dws@07I9c(v3)ofOHIvbW4}Clyr9^NOyN5-5@DFv~)>#H+&~v_w#_92^|Fq=bkf931@l^B)8e_|M?S$Wr;jgr@UiH3RbUqIq6nxmxyTg3pllF+C|;?J8R22|OHS|$5C&}~C$Cp7CMXc++U4Q4NgN|sM6}41E?6Tp^Y-YI z6#fhiLo&L$mU?MXaTZi`JA7SWs9of%+UM(=S3bi+!8kp6V9v*Az4tWod4Y=G#KQ2K zDcB2cxINq5-$Y_hu6%la!EBxtD%w8(hSb9e7Pwy4*Eb&|887A+KvZ>oyX1?J- zM_ibe8Z;Ta%NmvTHtCP(e8mmObB2XPqVT@qFQ_-LKpD z4T?X3%T@C>*_O^`P3Wj<7WhmK$V3NUz+mPR`cM4KCr_Q)UaR$Yx(0YN%qF?DZ&y`N zAGIOqU_mk>5Z1YkX;uX#^55%EvUo4Qj6EtfAk?lN4O`*o5JZ5poyLV8JS&{(Mbn>< zPX+E(pQQT2yBS@Z13j>QB*B5TH)n+hSOA@+1Vb@U^q_?yjMU z2~%{?Q*7L)c~U=7T$BaddgOG67^VOH%SVnbMvG+wfrm5+(-4@EWOT?a39i3J(fMud z%doaamh8Zr9~Utk%RLx+ZlaL!XTy>H=3cr z^tlDkmg$ILOCXLaEFjp1f~;drXNd6l^U4k(HtE%O+S*0|5bJ9YXdDoR6psUhR~e*p zR7Vh`eK)eTaTZ4Rx+QqIV=*g2R3HQyvbx^*=o>lZq0au<&P=SA?v8o{G0U$*5?K%? z7YZT%LRl#i{D%PHQC9gENY)

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> 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 c1aJ>H;&fJ5{Z*>gh@M|f|*Vo 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 BlhptK literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/arduino/data/www/index.html b/lib/PsychicHttp/examples/arduino/data/www/index.html new file mode 100644 index 0000000..4ee2491 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/data/www/index.html @@ -0,0 +1,236 @@ + + + + + + PsychicHTTP Demo + + + +

+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/arduino/data/www/text.txt b/lib/PsychicHttp/examples/arduino/data/www/text.txt new file mode 100644 index 0000000..5375816 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/data/www/text.txt @@ -0,0 +1 @@ +Test File. diff --git a/lib/PsychicHttp/examples/arduino/secret.h b/lib/PsychicHttp/examples/arduino/secret.h new file mode 100644 index 0000000..6d4bb15 --- /dev/null +++ b/lib/PsychicHttp/examples/arduino/secret.h @@ -0,0 +1,2 @@ +#define WIFI_SSID "Your_SSID" +#define WIFI_PASS "Your_PASS" \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/.gitignore b/lib/PsychicHttp/examples/esp-idf/.gitignore new file mode 100644 index 0000000..3413246 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/.gitignore @@ -0,0 +1,4 @@ +build/ +sdkconfig +sdkconfig.old +components/ diff --git a/lib/PsychicHttp/examples/esp-idf/CMakeLists.txt b/lib/PsychicHttp/examples/esp-idf/CMakeLists.txt new file mode 100644 index 0000000..634d58e --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/CMakeLists.txt @@ -0,0 +1,19 @@ +# The following lines of boilerplate have to be in your project's +# CMakeLists in this exact order for cmake to work correctly +cmake_minimum_required(VERSION 3.5) +include($ENV{IDF_PATH}/tools/cmake/project.cmake) + +if(DEFINED ENV{HTTP_PATH}) + set(HTTP_PATH $ENV{HTTP_PATH}) +else() + #these both work + set(HTTP_PATH "../../") + #set(HTTP_PATH ${CMAKE_CURRENT_LIST_DIR}/../../../) + + #this does not work for me... + #set(HTTP_PATH ${CMAKE_CURRENT_LIST_DIR}/../../../PsychicHttp) +endif(DEFINED ENV{HTTP_PATH}) + +set(EXTRA_COMPONENT_DIRS ${HTTP_PATH}) + +project(PsychicHttp_IDF) \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/README.md b/lib/PsychicHttp/examples/esp-idf/README.md new file mode 100644 index 0000000..ef91f3c --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/README.md @@ -0,0 +1,7 @@ +# PsychicHttp - ESP IDF Example +* Download and install [ESP IDF 4.4.7](https://github.com/espressif/esp-idf/releases/tag/v4.4.7) (or later version) +* Clone the project: ```git clone --recursive git@github.com:hoeken/PsychicHttp.git``` +* Run build command: ```cd PsychicHttp/examples/esp-idf``` and then ```idf.py build``` +* Flash the LittleFS filesystem: ```esptool.py write_flash --flash_mode dio --flash_freq 40m --flash_size 4MB 0x317000 build/littlefs.bin``` +* Flash the app firmware: ```idf.py flash monitor``` and visit the IP address shown in the console with a web browser. +* Learn more about [Arduino as ESP-IDF Component](https://docs.espressif.com/projects/arduino-esp32/en/latest/esp-idf_component.html) diff --git a/lib/PsychicHttp/examples/esp-idf/data/custom.txt b/lib/PsychicHttp/examples/esp-idf/data/custom.txt new file mode 100644 index 0000000..d3db23d --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/data/custom.txt @@ -0,0 +1 @@ +Custom text file. \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/data/img/request_flow.png b/lib/PsychicHttp/examples/esp-idf/data/img/request_flow.png new file mode 100644 index 0000000000000000000000000000000000000000..1005a38895f77797f39ecd018d5fd6a746502a62 GIT binary patch literal 30509 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 + + + + + PsychicHTTP SoftAP Demo + + + +
+

SoftAP Demo

+

You are connected to the ESP in SoftAP mode.

+
+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/data/www/alien.png b/lib/PsychicHttp/examples/esp-idf/data/www/alien.png new file mode 100644 index 0000000000000000000000000000000000000000..a030da0761a60fbfc813fbef0716f801b7aa5ca6 GIT binary patch literal 28598 zcmYJaWmuG5*Dws@07I9c(v3)ofOHIvbW4}Clyr9^NOyN5-5@DFv~)>#H+&~v_w#_92^|Fq=bkf931@l^B)8e_|M?S$Wr;jgr@UiH3RbUqIq6nxmxyTg3pllF+C|;?J8R22|OHS|$5C&}~C$Cp7CMXc++U4Q4NgN|sM6}41E?6Tp^Y-YI z6#fhiLo&L$mU?MXaTZi`JA7SWs9of%+UM(=S3bi+!8kp6V9v*Az4tWod4Y=G#KQ2K zDcB2cxINq5-$Y_hu6%la!EBxtD%w8(hSb9e7Pwy4*Eb&|887A+KvZ>oyX1?J- zM_ibe8Z;Ta%NmvTHtCP(e8mmObB2XPqVT@qFQ_-LKpD z4T?X3%T@C>*_O^`P3Wj<7WhmK$V3NUz+mPR`cM4KCr_Q)UaR$Yx(0YN%qF?DZ&y`N zAGIOqU_mk>5Z1YkX;uX#^55%EvUo4Qj6EtfAk?lN4O`*o5JZ5poyLV8JS&{(Mbn>< zPX+E(pQQT2yBS@Z13j>QB*B5TH)n+hSOA@+1Vb@U^q_?yjMU z2~%{?Q*7L)c~U=7T$BaddgOG67^VOH%SVnbMvG+wfrm5+(-4@EWOT?a39i3J(fMud z%doaamh8Zr9~Utk%RLx+ZlaL!XTy>H=3cr z^tlDkmg$ILOCXLaEFjp1f~;drXNd6l^U4k(HtE%O+S*0|5bJ9YXdDoR6psUhR~e*p zR7Vh`eK)eTaTZ4Rx+QqIV=*g2R3HQyvbx^*=o>lZq0au<&P=SA?v8o{G0U$*5?K%? z7YZT%LRl#i{D%PHQC9gENY)

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> 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 c1aJ>H;&fJ5{Z*>gh@M|f|*Vo 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 BlhptK literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/esp-idf/data/www/index.html b/lib/PsychicHttp/examples/esp-idf/data/www/index.html new file mode 100644 index 0000000..4ee2491 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/data/www/index.html @@ -0,0 +1,236 @@ + + + + + + PsychicHTTP Demo + + + +

+

Basic Request Examples

+ + +

Static Serving

+

+ + +

+

Text File

+ +

Simple POST Form

+
+ + +
+ + +
+ +
+ +

Basic File Upload

+ + + + + + + + + + + + +
+ + + +
+ + + +
+ +
+ + +

Multipart POST Form

+
+ + +
+ + + +
+ + + +
+ + +
+ +

Websocket Demo

+ + + +
+ +
+ + + +

EventSource Demo

+ +
+ +
+ + +
+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/data/www/text.txt b/lib/PsychicHttp/examples/esp-idf/data/www/text.txt new file mode 100644 index 0000000..5375816 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/data/www/text.txt @@ -0,0 +1 @@ +Test File. diff --git a/lib/PsychicHttp/examples/esp-idf/include/README b/lib/PsychicHttp/examples/esp-idf/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/esp-idf/lib/README b/lib/PsychicHttp/examples/esp-idf/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/esp-idf/main/CMakeLists.txt b/lib/PsychicHttp/examples/esp-idf/main/CMakeLists.txt new file mode 100644 index 0000000..ad22981 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/main/CMakeLists.txt @@ -0,0 +1,8 @@ +# This file was automatically generated for projects +# without default 'CMakeLists.txt' file. + +idf_component_register( + SRCS "main.cpp" + INCLUDE_DIRS ".") + +littlefs_create_partition_image(littlefs ${project_dir}/data) \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/main/main.cpp b/lib/PsychicHttp/examples/esp-idf/main/main.cpp new file mode 100644 index 0000000..21c18e4 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/main/main.cpp @@ -0,0 +1,510 @@ +/* + PsychicHTTP Server Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. +*/ + +/********************************************************************************************** +* Note: this demo relies on the following libraries (Install via Library Manager) +* ArduinoJson UrlEncode +**********************************************************************************************/ + +/********************************************************************************************** +* Note: this demo relies on various files to be uploaded on the LittleFS partition +* Follow instructions here: https://randomnerdtutorials.com/esp32-littlefs-arduino-ide/ +**********************************************************************************************/ + +#include +#include +#include +#include +#include +#include "secret.h" +#include +#ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE //set this to y in menuconfig to enable SSL +#include +#endif + +#ifndef WIFI_SSID + #error "You need to enter your wifi credentials. Rename secret.h to _secret.h and enter your credentials there." +#endif + +//Enter your WIFI credentials in secret.h +const char *ssid = WIFI_SSID; +const char *password = WIFI_PASS; + +// Set your SoftAP credentials +const char *softap_ssid = "PsychicHttp"; +const char *softap_password = ""; +IPAddress softap_ip(10, 0, 0, 1); + +//credentials for the /auth-basic and /auth-digest examples +const char *app_user = "admin"; +const char *app_pass = "admin"; +const char *app_name = "Your App"; + +//hostname for mdns (psychic.local) +const char *local_hostname = "psychic"; + +//#define CONFIG_ESP_HTTPS_SERVER_ENABLE to enable ssl +#ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE + bool app_enable_ssl = true; + String server_cert; + String server_key; +#endif + +//our main server object +#ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE + PsychicHttpsServer server; +#else + PsychicHttpServer server; +#endif +PsychicWebSocketHandler websocketHandler; +PsychicEventSource eventSource; + +bool connectToWifi() +{ + //dual client and AP mode + WiFi.mode(WIFI_AP_STA); + + // Configure SoftAP + WiFi.softAPConfig(softap_ip, softap_ip, IPAddress(255, 255, 255, 0)); // subnet FF FF FF 00 + WiFi.softAP(softap_ssid, softap_password); + IPAddress myIP = WiFi.softAPIP(); + Serial.print("SoftAP IP Address: "); + Serial.println(myIP); + + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.begin(ssid, password); + // Auto reconnect is set true as default + // To set auto connect off, use the following function + // WiFi.setAutoReconnect(false); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + + // We start by connecting to a WiFi network + // To debug, please enable Core Debug Level to Verbose + if (connectToWifi()) + { + //set up our esp32 to listen on the local_hostname.local domain + if (!MDNS.begin(local_hostname)) { + Serial.println("Error starting mDNS"); + return; + } + MDNS.addService("http", "tcp", 80); + + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + //look up our keys? + #ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE + if (app_enable_ssl) + { + File fp = LittleFS.open("/server.crt"); + if (fp) + { + server_cert = fp.readString(); + + // Serial.println("Server Cert:"); + // Serial.println(server_cert); + } + else + { + Serial.println("server.pem not found, SSL not available"); + app_enable_ssl = false; + } + fp.close(); + + File fp2 = LittleFS.open("/server.key"); + if (fp2) + { + server_key = fp2.readString(); + + // Serial.println("Server Key:"); + // Serial.println(server_key); + } + else + { + Serial.println("server.key not found, SSL not available"); + app_enable_ssl = false; + } + fp2.close(); + } + #endif + + //setup server config stuff here + server.config.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + + #ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE + server.ssl_config.httpd.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + + //do we want secure or not? + if (app_enable_ssl) + { + server.listen(443, server_cert.c_str(), server_key.c_str()); + + //this creates a 2nd server listening on port 80 and redirects all requests HTTPS + PsychicHttpServer *redirectServer = new PsychicHttpServer(); + redirectServer->config.ctrl_port = 20424; // just a random port different from the default one + redirectServer->listen(80); + redirectServer->onNotFound([](PsychicRequest *request) { + String url = "https://" + request->host() + request->url(); + return request->redirect(url.c_str()); + }); + } + else + server.listen(80); + #else + server.listen(80); + #endif + + //serve static files from LittleFS/www on / only to clients on same wifi network + //this is where our /index.html file lives + server.serveStatic("/", LittleFS, "/www/")->setFilter(ON_STA_FILTER); + + //serve static files from LittleFS/www-ap on / only to clients on SoftAP + //this is where our /index.html file lives + server.serveStatic("/", LittleFS, "/www-ap/")->setFilter(ON_AP_FILTER); + + //serve static files from LittleFS/img on /img + //it's more efficient to serve everything from a single www directory, but this is also possible. + server.serveStatic("/img", LittleFS, "/img/"); + + //you can also serve single files + server.serveStatic("/myfile.txt", LittleFS, "/custom.txt"); + + //example callback everytime a connection is opened + server.onOpen([](PsychicClient *client) { + Serial.printf("[http] connection #%u connected from %s\n", client->socket(), client->localIP().toString().c_str()); + }); + + //example callback everytime a connection is closed + server.onClose([](PsychicClient *client) { + Serial.printf("[http] connection #%u closed from %s\n", client->socket(), client->localIP().toString().c_str()); + }); + + //api - json message passed in as post body + server.on("/api", HTTP_POST, [](PsychicRequest *request) + { + //load our JSON request + JsonDocument json; + String body = request->body(); + DeserializationError err = deserializeJson(json, body); + + //create our response json + JsonDocument output; + output["msg"] = "status"; + + //did it parse? + if (err) + { + output["status"] = "failure"; + output["error"] = err.c_str(); + } + else + { + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (json.containsKey("foo")) + { + String foo = json["foo"]; + output["foo"] = foo; + } + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + return request->reply(200, "application/json", jsonBuffer.c_str()); + }); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/ip", HTTP_GET, [](PsychicRequest *request) + { + String output = "Your IP is: " + request->client()->remoteIP().toString(); + return request->reply(output.c_str()); + }); + + //api - parameters passed in via query eg. /api/endpoint?foo=bar + server.on("/api", HTTP_GET, [](PsychicRequest *request) + { + //create a response object + JsonDocument output; + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + String foo = request->getParam("foo")->name(); + output["foo"] = foo; + } + + //serialize and return + String jsonBuffer; + serializeJson(output, jsonBuffer); + return request->reply(200, "application/json", jsonBuffer.c_str()); + }); + + //how to redirect a request + server.on("/redirect", HTTP_GET, [](PsychicRequest *request) + { + return request->redirect("/alien.png"); + }); + + //how to do basic auth + server.on("/auth-basic", HTTP_GET, [](PsychicRequest *request) + { + if (!request->authenticate(app_user, app_pass)) + return request->requestAuthentication(BASIC_AUTH, app_name, "You must log in."); + return request->reply("Auth Basic Success!"); + }); + + //how to do digest auth + server.on("/auth-digest", HTTP_GET, [](PsychicRequest *request) + { + if (!request->authenticate(app_user, app_pass)) + return request->requestAuthentication(DIGEST_AUTH, app_name, "You must log in."); + return request->reply("Auth Digest Success!"); + }); + + //example of getting / setting cookies + server.on("/cookies", HTTP_GET, [](PsychicRequest *request) + { + PsychicResponse response(request); + + int counter = 0; + if (request->hasCookie("counter")) + { + counter = std::stoi(request->getCookie("counter").c_str()); + counter++; + } + + char cookie[12]; + sprintf(cookie, "%i", counter); + + response.setCookie("counter", cookie); + response.setContent(cookie); + return response.send(); + }); + + //example of getting POST variables + server.on("/post", HTTP_POST, [](PsychicRequest *request) + { + String output; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + }); + + //you can set up a custom 404 handler. + server.onNotFound([](PsychicRequest *request) + { + return request->reply(404, "text/html", "Custom 404 Handler"); + }); + + //handle a very basic upload as post body + PsychicUploadHandler *uploadHandler = new PsychicUploadHandler(); + uploadHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + Serial.printf("Writing %d/%d bytes to: %s\n", (int)index+(int)len, request->contentLength(), path.c_str()); + + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + uploadHandler->onRequest([](PsychicRequest *request) + { + String url = "/" + request->getFilename(); + String output = "" + url + ""; + + return request->reply(output.c_str()); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + server.on("/upload/*", HTTP_POST, uploadHandler); + + //a little bit more complicated multipart form + PsychicUploadHandler *multipartHandler = new PsychicUploadHandler(); + multipartHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + //some progress over serial. + Serial.printf("Writing %d bytes to: %s\n", (int)len, path.c_str()); + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + multipartHandler->onRequest([](PsychicRequest *request) + { + PsychicWebParameter *file = request->getParam("file_upload"); + + String url = "/" + file->value(); + String output; + + output += "" + url + "
\n"; + output += "Bytes: " + String(file->size()) + "
\n"; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + server.on("/multipart", HTTP_POST, multipartHandler); + + //a websocket echo server + websocketHandler.onOpen([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u connected from %s\n", client->socket(), client->localIP().toString().c_str()); + client->sendMessage("Hello!"); + }); + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) { + Serial.printf("[socket] #%d sent: %s\n", request->client()->socket(), (char *)frame->payload); + return request->reply(frame); + }); + websocketHandler.onClose([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u closed from %s\n", client->socket(), client->localIP().toString().c_str()); + }); + server.on("/ws", &websocketHandler); + + //EventSource server + eventSource.onOpen([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u connected from %s\n", client->socket(), client->localIP().toString().c_str()); + client->send("Hello user!", NULL, millis(), 1000); + }); + eventSource.onClose([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u closed from %s\n", client->socket(), client->localIP().toString().c_str()); + }); + server.on("/events", &eventSource); + } +} + +unsigned long lastUpdate = 0; +char output[60]; + +void loop() +{ + if (millis() - lastUpdate > 2000) + { + sprintf(output, "Millis: %lu\n", millis()); + websocketHandler.sendAll(output); + + sprintf(output, "%lu", millis()); + eventSource.send(output, "millis", millis(), 0); + + lastUpdate = millis(); + } + vTaskDelay(1 / portTICK_PERIOD_MS); // Feed WDT +} \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/main/secret.h b/lib/PsychicHttp/examples/esp-idf/main/secret.h new file mode 100644 index 0000000..97048cf --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/main/secret.h @@ -0,0 +1,2 @@ +#define WIFI_SSID "WIFI_SSID" +#define WIFI_PASS "WIFI_PASS" \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/partitions_custom.csv b/lib/PsychicHttp/examples/esp-idf/partitions_custom.csv new file mode 100644 index 0000000..57f4354 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/partitions_custom.csv @@ -0,0 +1,7 @@ +# Name, Type, SubType, Offset, Size, Flags +nvs, data, nvs, 0x11000, 0xC000 +otadata, data, ota, 0x1D000, 0x2000 +phy_init, data, phy, 0x1F000, 0x1000 +app0, app, ota_0, 0x20000, 0x177000 +app1, app, ota_1, 0x1A0000, 0x177000 +littlefs, data, spiffs, 0x317000, 0xE1000 \ No newline at end of file diff --git a/lib/PsychicHttp/examples/esp-idf/sdkconfig.defaults b/lib/PsychicHttp/examples/esp-idf/sdkconfig.defaults new file mode 100644 index 0000000..6b0dc83 --- /dev/null +++ b/lib/PsychicHttp/examples/esp-idf/sdkconfig.defaults @@ -0,0 +1,64 @@ +CONFIG_AUTOSTART_ARDUINO=y +# CONFIG_WS2812_LED_ENABLE is not set +CONFIG_FREERTOS_HZ=1000 + +CONFIG_BOOTLOADER_COMPILER_OPTIMIZATION_SIZE=y +CONFIG_COMPILER_OPTIMIZATION_SIZE=y + +# +# Serial flasher config +# +CONFIG_ESPTOOLPY_FLASHMODE_QIO=y +CONFIG_ESPTOOLPY_FLASHSIZE_4MB=y +CONFIG_ESPTOOLPY_FLASHSIZE="4MB" + +# +# Partition Table +# +CONFIG_PARTITION_TABLE_CUSTOM=y +CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="partitions_custom.csv" +#CONFIG_PARTITION_TABLE_FILENAME="partitions_custom.csv" +#CONFIG_PARTITION_TABLE_OFFSET=0xE000 +CONFIG_PARTITION_TABLE_MD5=y + +# +# ESP HTTPS OTA +# +CONFIG_ESP_HTTPS_OTA_DECRYPT_CB=y +CONFIG_ESP_HTTPS_OTA_ALLOW_HTTP=y +# end of ESP HTTPS OTA + + +# +# ESP HTTP client +# +CONFIG_ESP_HTTP_CLIENT_ENABLE_HTTPS=y +CONFIG_ESP_HTTP_CLIENT_ENABLE_BASIC_AUTH=y +CONFIG_ESP_HTTP_CLIENT_ENABLE_DIGEST_AUTH=y +# end of ESP HTTP client + +# +# HTTP Server +# +CONFIG_HTTPD_MAX_REQ_HDR_LEN=1024 +CONFIG_HTTPD_MAX_URI_LEN=512 +CONFIG_HTTPD_ERR_RESP_NO_DELAY=y +CONFIG_HTTPD_PURGE_BUF_LEN=32 +# CONFIG_HTTPD_LOG_PURGE_DATA is not set +CONFIG_HTTPD_WS_SUPPORT=y +# end of HTTP Server + +# +# ESP HTTPS server +# +CONFIG_ESP_HTTPS_SERVER_ENABLE=n +# end of ESP HTTPS server + + +# +# TLS Key Exchange Methods +# +# 2 option require for arduino Arduino +CONFIG_MBEDTLS_PSK_MODES=y +CONFIG_MBEDTLS_KEY_EXCHANGE_PSK=y + diff --git a/lib/PsychicHttp/examples/old/esp_ota_http_server/.gitignore b/lib/PsychicHttp/examples/old/esp_ota_http_server/.gitignore new file mode 100644 index 0000000..be2b7e8 --- /dev/null +++ b/lib/PsychicHttp/examples/old/esp_ota_http_server/.gitignore @@ -0,0 +1,39 @@ +.pioenvs +.clang_complete +.gcc-flags.json +# Compiled Object files +*.slo +*.lo +*.o +*.obj +# Precompiled Headers +*.gch +*.pch +# Compiled Dynamic libraries +*.so +*.dylib +*.dll +# Fortran module files +*.mod +# Compiled Static libraries +*.lai +*.la +*.a +*.lib +# Executables +*.exe +*.out +*.app +# Visual Studio/VisualMicro stuff +Visual\ Micro +*.sdf +*.opensdf +*.suo +.pioenvs +.piolibdeps +.pio +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/settings.json +.vscode/.browse.c_cpp.db* +.vscode/ipch \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/esp_ota_http_server/include/README b/lib/PsychicHttp/examples/old/esp_ota_http_server/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/old/esp_ota_http_server/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/old/esp_ota_http_server/lib/README b/lib/PsychicHttp/examples/old/esp_ota_http_server/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/old/esp_ota_http_server/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/old/esp_ota_http_server/platformio.ini b/lib/PsychicHttp/examples/old/esp_ota_http_server/platformio.ini new file mode 100644 index 0000000..8a0c120 --- /dev/null +++ b/lib/PsychicHttp/examples/old/esp_ota_http_server/platformio.ini @@ -0,0 +1,74 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[common] +lib_deps = ArduinoMongoose +monitor_speed = 115200 +monitor_port = /dev/ttyUSB1 +build_flags = + -DENABLE_DEBUG +# -DCS_ENABLE_STDIO + -DMG_ENABLE_HTTP_STREAMING_MULTIPART=1 + +build_flags_secure = + -DSIMPLE_SERVER_SECURE + -DMG_ENABLE_SSL=1 + +# -DMG_SSL_IF=MG_SSL_IF_OPENSSL +# -DKR_VERSION + + -DMG_SSL_MBED_DUMMY_RANDOM=1 + -DMG_SSL_IF=MG_SSL_IF_MBEDTLS + -DMG_SSL_IF_MBEDTLS_FREE_CERTS=1 + -DMG_SSL_IF_MBEDTLS_MAX_FRAG_LEN=2048 + +build_flags_auth = + -DADMIN_USER='"admin"' + -DADMIN_PASS='"admin"' + -DADMIN_REALM='"esp_ota_http_server"' + +#[env:huzzah] +#platform = espressif8266 +#board = huzzah +#framework = arduino +#monitor_speed = ${common.monitor_speed} +#monitor_port = ${common.monitor_port} +#lib_deps = ${common.lib_deps} +#build_flags = ${common.build_flags} + +[env:esp-wrover-kit] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} + +[env:esp-wrover-kit-secure] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} ${common.build_flags_secure} + +[env:esp-wrover-kit-auth] +extends = env:esp-wrover-kit +build_flags = ${common.build_flags} ${common.build_flags_auth} -ggdb + +#[env:linux_x86_64] +#platform = linux_x86_64 +#framework = arduino +#board = generic +#lib_deps = ${common.lib_deps} +#build_flags = ${common.build_flags} +#build_flags = -DSERIAL_TO_CONSOLE \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/esp_ota_http_server/src/esp_ota_http_server.cpp b/lib/PsychicHttp/examples/old/esp_ota_http_server/src/esp_ota_http_server.cpp new file mode 100644 index 0000000..9d9d35b --- /dev/null +++ b/lib/PsychicHttp/examples/old/esp_ota_http_server/src/esp_ota_http_server.cpp @@ -0,0 +1,229 @@ +// +// A simple server implementation showing how to: +// * serve static messages +// * read GET and POST parameters +// * handle missing pages / 404s +// + +#include +#include +#include +#include + +#ifdef ESP32 +#include +#define START_ESP_WIFI +#elif defined(ESP8266) +#include +#define START_ESP_WIFI +#else +#error Platform not supported +#endif + +MongooseHttpServer server; + +const char *ssid = "wifi"; +const char *password = "password"; + +const char *server_pem = +"-----BEGIN CERTIFICATE-----\r\n" +"MIIDDjCCAfagAwIBAgIBBDANBgkqhkiG9w0BAQsFADA/MRkwFwYDVQQDDBB0ZXN0\r\n" +"LmNlc2FudGEuY29tMRAwDgYDVQQKDAdDZXNhbnRhMRAwDgYDVQQLDAd0ZXN0aW5n\r\n" +"MB4XDTE2MTExMzEzMTgwMVoXDTI2MDgxMzEzMTgwMVowFDESMBAGA1UEAwwJbG9j\r\n" +"YWxob3N0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAro8CW1X0xaGm\r\n" +"GkDaMxKbXWA5Lw+seA61tioGrSIQzuqLYeJoFnwVgF0jB5PTj+3EiGMBcA/mh73V\r\n" +"AthTFmJBxj+agIp7/cvUBpgfLClmSYL2fZi6Fodz+f9mcry3XRw7O6vlamtWfTX8\r\n" +"TAmMSR6PXVBHLgjs5pDOFFmrNAsM5sLYU1/1MFvE2Z9InTI5G437IE1WchRSbpYd\r\n" +"HchC39XzpDGoInZB1a3OhcHm+xUtLpMJ0G0oE5VFEynZreZoEIY4JxspQ7LPsay9\r\n" +"fx3Tlk09gEMQgVCeCNiQwUxZdtLau2x61LNcdZCKN7FbFLJszv1U2uguELsTmi7E\r\n" +"6pHrTziosQIDAQABo0AwPjAJBgNVHRMEAjAAMAsGA1UdDwQEAwIDqDATBgNVHSUE\r\n" +"DDAKBggrBgEFBQcDATAPBgNVHREECDAGhwR/AAABMA0GCSqGSIb3DQEBCwUAA4IB\r\n" +"AQBUw0hbTcT6crzODO4QAXU7z4Xxn0LkxbXEsoThG1QCVgMc4Bhpx8gyz5CLyHYz\r\n" +"AiJOBFEeV0XEqoGTNMMFelR3Q5Tg9y1TYO3qwwAWxe6/brVzpts6NiG1uEMBnBFg\r\n" +"oN1x3I9x4NpOxU5MU1dlIxvKs5HQCoNJ8D0SqOX9BV/pZqwEgiCbuWDWQAlxkFpn\r\n" +"iLonlkVI5hTuybCSBsa9FEI9M6JJn9LZmlH90FYHeS4t6P8eOJCeekHL0jUG4Iae\r\n" +"DMP12h8Sd0yxIKmmZ+Q/p/D/BkuHf5Idv3hgyLkZ4mNznjK49wHaYM+BgBoL3Zeg\r\n" +"gJ2sWjUlokrbHswSBLLbUJIF\r\n" +"-----END CERTIFICATE-----\r\n"; + +const char *server_key = +"-----BEGIN PRIVATE KEY-----\r\n" +"MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCujwJbVfTFoaYa\r\n" +"QNozEptdYDkvD6x4DrW2KgatIhDO6oth4mgWfBWAXSMHk9OP7cSIYwFwD+aHvdUC\r\n" +"2FMWYkHGP5qAinv9y9QGmB8sKWZJgvZ9mLoWh3P5/2ZyvLddHDs7q+Vqa1Z9NfxM\r\n" +"CYxJHo9dUEcuCOzmkM4UWas0CwzmwthTX/UwW8TZn0idMjkbjfsgTVZyFFJulh0d\r\n" +"yELf1fOkMagidkHVrc6Fweb7FS0ukwnQbSgTlUUTKdmt5mgQhjgnGylDss+xrL1/\r\n" +"HdOWTT2AQxCBUJ4I2JDBTFl20tq7bHrUs1x1kIo3sVsUsmzO/VTa6C4QuxOaLsTq\r\n" +"ketPOKixAgMBAAECggEAI+uNwpnHirue4Jwjyoqzqd1ZJxQEm5f7UIcJZKsz5kBh\r\n" +"ej0KykWybv27bZ2/1UhKPv6QlyzOdXRc1v8I6fxCKLeB5Z2Zsjo1YT4AfCfwwoPO\r\n" +"kT3SXTx2YyVpQYcP/HsIvVi8FtALtixbxJHaall9iugwHYr8pN17arihAE6d0wZC\r\n" +"JXtXRjUWwjKzXP8FoH4KhyadhHbDwIbbJe3cyLfdvp54Gr0YHha0JcOxYgDYNya4\r\n" +"OKxlCluI+hPF31iNzOmFLQVrdYynyPcR6vY5XOiANKE2iNbqCzRb54CvW9WMqObX\r\n" +"RD9t3DMOxGsbVNIwyzZndWy13HoQMGnrHfnGak9ueQKBgQDiVtOqYfLnUnTxvJ/b\r\n" +"qlQZr2ZmsYPZztxlP+DSqZGPD+WtGSo9+rozWfzjTv3KGIDLvf+GFVmjVHwlLQfd\r\n" +"u7eTemWHFc4HK68wruzPO/FdyVpQ4w9v3Usg+ll4a/PDEId0fDMjAr6kk4LC6t8y\r\n" +"9fJR0HjOz57jVnlrDt3v50G8BwKBgQDFbw+jRiUxXnBbDyXZLi+I4iGBGdC+CbaJ\r\n" +"CmsM6/TsOFc+GRsPwQF1gCGqdaURw76noIVKZJOSc8I+yiwU6izyh/xaju5JiWQd\r\n" +"kwbU1j4DE6GnxmT3ARmB7VvCxjaEZEAtICWs1QTKRz7PcTV8yr7Ng1A3VIy+NSpo\r\n" +"LFMMmk83hwKBgQDVCEwpLg/mUeHoNVVw95w4oLKNLb+gHeerFLiTDy8FrDzM88ai\r\n" +"l37yHly7xflxYia3nZkHpsi7xiUjCINC3BApKyasQoWskh1OgRY653yCfaYYQ96f\r\n" +"t3WjEH9trI2+p6wWo1+uMEMnu/9zXoW9/WeaQdGzNg+igh29+jxCNTPVuQKBgGV4\r\n" +"CN9vI5pV4QTLqjYOSJvfLDz/mYqxz0BrPE1tz3jAFAZ0PLZCCY/sBGFpCScyJQBd\r\n" +"vWNYgYeZOtGuci1llSgov4eDQfBFTlDsyWwFl+VY55IkoqtXw1ZFOQ3HdSlhpKIM\r\n" +"jZBgApA7QYq3sjeqs5lHzahCKftvs5XKgfxOKjxtAoGBALdnYe6xkDvGLvI51Yr+\r\n" +"Dy0TNcB5W84SxUKvM7DVEomy1QPB57ZpyQaoBq7adOz0pWJXfp7qo4950ZOhBGH1\r\n" +"hKbZ6c4ggwVJy2j49EgMok5NGCKvPAtabbR6H8Mz8DW9aXURxhWJvij+Qw1fWK4b\r\n" +"7G/qUI9iE5iUU7MkIcLIbTf/\r\n" +"-----END PRIVATE KEY-----\r\n"; + +const char* server_index = +"" +"
" + "" + "" +"
" +"
progress: 0%
" +""; + +#include + +bool updateCompleted = false; + +static void updateError(MongooseHttpServerRequest *request) +{ + MongooseHttpServerResponseStream *resp = request->beginResponseStream(); + resp->setCode(500); + resp->setContentType("text/plain"); + resp->printf("Error: %d", Update.getError()); + request->send(resp); + + // Anoyingly this uses Stream rather than Print... + Update.printError(Serial); +} + +void setup() +{ + Serial.begin(115200); + +#ifdef START_ESP_WIFI + WiFi.mode(WIFI_STA); + WiFi.begin(ssid, password); + if (WiFi.waitForConnectResult() != WL_CONNECTED) + { + Serial.printf("WiFi Failed!\n"); + return; + } + + Serial.print("IP Address: "); + Serial.println(WiFi.localIP()); + Serial.print("Hostname: "); +#ifdef ESP32 + Serial.println(WiFi.getHostname()); +#elif defined(ESP8266) + Serial.println(WiFi.hostname()); +#endif +#endif + + Mongoose.begin(); + +#ifdef SIMPLE_SERVER_SECURE + if(false == server.begin(443, server_pem, server_key)) { + Serial.print("Failed to start server"); + return; + } +#else + server.begin(80); +#endif + + server.on("/$", HTTP_GET, [](MongooseHttpServerRequest *request) { +#if defined(ADMIN_USER) && defined(ADMIN_PASS) && defined(ADMIN_REALM) + if(false == request->authenticate(ADMIN_USER, ADMIN_PASS)) { + request->requestAuthentication(ADMIN_REALM); + return; + } +#endif + + request->send(200, "text/html", server_index); + }); + + server.on("/update$", HTTP_POST)-> + onRequest([](MongooseHttpServerRequest *request) { +#if defined(ADMIN_USER) && defined(ADMIN_PASS) && defined(ADMIN_REALM) + if(false == request->authenticate(ADMIN_USER, ADMIN_PASS)) { + request->requestAuthentication(ADMIN_REALM); + return; + } +#endif + updateCompleted = false; + })-> + onUpload([](MongooseHttpServerRequest *request, int ev, MongooseString filename, uint64_t index, uint8_t *data, size_t len) + { + if(MG_EV_HTTP_PART_BEGIN == ev) { + Serial.printf("Update Start: %s\n", filename.c_str()); + + if (!Update.begin()) { //start with max available size + updateError(request); + } + } + + if(!Update.hasError()) + { + Serial.printf("Update Writing %llu\n", index); + if(Update.write(data, len) != len) { + updateError(request); + } + } + + if(MG_EV_HTTP_PART_END == ev) { + Serial.println("Data finished"); + if(Update.end(true)) { + Serial.printf("Update Success: %lluB\n", index+len); + request->send(200, "text/plain", "OK"); + updateCompleted = true; + } else { + updateError(request); + } + } + + return len; + })-> + onClose([](MongooseHttpServerRequest *request) + { + if(updateCompleted) { + ESP.restart(); + } + }); +} + +void loop() +{ + Mongoose.poll(1000); +} diff --git a/lib/PsychicHttp/examples/old/esp_ota_http_server/test/README b/lib/PsychicHttp/examples/old/esp_ota_http_server/test/README new file mode 100644 index 0000000..df5066e --- /dev/null +++ b/lib/PsychicHttp/examples/old/esp_ota_http_server/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PIO Unit Testing and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PIO Unit Testing: +- https://docs.platformio.org/page/plus/unit-testing.html diff --git a/lib/PsychicHttp/examples/old/simple_http_server/.gitignore b/lib/PsychicHttp/examples/old/simple_http_server/.gitignore new file mode 100644 index 0000000..be2b7e8 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/.gitignore @@ -0,0 +1,39 @@ +.pioenvs +.clang_complete +.gcc-flags.json +# Compiled Object files +*.slo +*.lo +*.o +*.obj +# Precompiled Headers +*.gch +*.pch +# Compiled Dynamic libraries +*.so +*.dylib +*.dll +# Fortran module files +*.mod +# Compiled Static libraries +*.lai +*.la +*.a +*.lib +# Executables +*.exe +*.out +*.app +# Visual Studio/VisualMicro stuff +Visual\ Micro +*.sdf +*.opensdf +*.suo +.pioenvs +.piolibdeps +.pio +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/settings.json +.vscode/.browse.c_cpp.db* +.vscode/ipch \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/simple_http_server/include/README b/lib/PsychicHttp/examples/old/simple_http_server/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/old/simple_http_server/lib/README b/lib/PsychicHttp/examples/old/simple_http_server/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/old/simple_http_server/platformio.ini b/lib/PsychicHttp/examples/old/simple_http_server/platformio.ini new file mode 100644 index 0000000..5da8a5a --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/platformio.ini @@ -0,0 +1,64 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[common] +lib_deps = ArduinoMongoose +monitor_speed = 115200 +monitor_port = /dev/ttyUSB1 +build_flags = + -DENABLE_DEBUG +# -DCS_ENABLE_STDIO + +build_flags_secure = + -DSIMPLE_SERVER_SECURE + -DMG_ENABLE_SSL=1 + +# -DMG_SSL_IF=MG_SSL_IF_OPENSSL +# -DKR_VERSION + + -DMG_SSL_MBED_DUMMY_RANDOM=1 + -DMG_SSL_IF=MG_SSL_IF_MBEDTLS + -DMG_SSL_IF_MBEDTLS_FREE_CERTS=1 + -DMG_SSL_IF_MBEDTLS_MAX_FRAG_LEN=2048 + +[env:huzzah] +platform = espressif8266 +board = huzzah +framework = arduino +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} + +[env:esp-wrover-kit] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} + +[env:esp-wrover-kit-secure] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} ${common.build_flags_secure} + +#[env:linux_x86_64] +#platform = linux_x86_64 +#framework = arduino +#board = generic +#lib_deps = ${common.lib_deps} +#build_flags = ${common.build_flags} +#build_flags = -DSERIAL_TO_CONSOLE \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/simple_http_server/src/simple_http_server.cpp b/lib/PsychicHttp/examples/old/simple_http_server/src/simple_http_server.cpp new file mode 100644 index 0000000..ffa1e4d --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/src/simple_http_server.cpp @@ -0,0 +1,211 @@ +// +// A simple server implementation showing how to: +// * serve static messages +// * read GET and POST parameters +// * handle missing pages / 404s +// + +#include +#include +#include + +#ifdef ESP32 +#include +#define START_ESP_WIFI +#elif defined(ESP8266) +#include +#define START_ESP_WIFI +#else +#error Platform not supported +#endif + +MongooseHttpServer server; + +const char *ssid = "wifi"; +const char *password = "password"; + +const char *PARAM_MESSAGE = "message"; + +const char *server_pem = +"-----BEGIN CERTIFICATE-----\r\n" +"MIIDDjCCAfagAwIBAgIBBDANBgkqhkiG9w0BAQsFADA/MRkwFwYDVQQDDBB0ZXN0\r\n" +"LmNlc2FudGEuY29tMRAwDgYDVQQKDAdDZXNhbnRhMRAwDgYDVQQLDAd0ZXN0aW5n\r\n" +"MB4XDTE2MTExMzEzMTgwMVoXDTI2MDgxMzEzMTgwMVowFDESMBAGA1UEAwwJbG9j\r\n" +"YWxob3N0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAro8CW1X0xaGm\r\n" +"GkDaMxKbXWA5Lw+seA61tioGrSIQzuqLYeJoFnwVgF0jB5PTj+3EiGMBcA/mh73V\r\n" +"AthTFmJBxj+agIp7/cvUBpgfLClmSYL2fZi6Fodz+f9mcry3XRw7O6vlamtWfTX8\r\n" +"TAmMSR6PXVBHLgjs5pDOFFmrNAsM5sLYU1/1MFvE2Z9InTI5G437IE1WchRSbpYd\r\n" +"HchC39XzpDGoInZB1a3OhcHm+xUtLpMJ0G0oE5VFEynZreZoEIY4JxspQ7LPsay9\r\n" +"fx3Tlk09gEMQgVCeCNiQwUxZdtLau2x61LNcdZCKN7FbFLJszv1U2uguELsTmi7E\r\n" +"6pHrTziosQIDAQABo0AwPjAJBgNVHRMEAjAAMAsGA1UdDwQEAwIDqDATBgNVHSUE\r\n" +"DDAKBggrBgEFBQcDATAPBgNVHREECDAGhwR/AAABMA0GCSqGSIb3DQEBCwUAA4IB\r\n" +"AQBUw0hbTcT6crzODO4QAXU7z4Xxn0LkxbXEsoThG1QCVgMc4Bhpx8gyz5CLyHYz\r\n" +"AiJOBFEeV0XEqoGTNMMFelR3Q5Tg9y1TYO3qwwAWxe6/brVzpts6NiG1uEMBnBFg\r\n" +"oN1x3I9x4NpOxU5MU1dlIxvKs5HQCoNJ8D0SqOX9BV/pZqwEgiCbuWDWQAlxkFpn\r\n" +"iLonlkVI5hTuybCSBsa9FEI9M6JJn9LZmlH90FYHeS4t6P8eOJCeekHL0jUG4Iae\r\n" +"DMP12h8Sd0yxIKmmZ+Q/p/D/BkuHf5Idv3hgyLkZ4mNznjK49wHaYM+BgBoL3Zeg\r\n" +"gJ2sWjUlokrbHswSBLLbUJIF\r\n" +"-----END CERTIFICATE-----\r\n"; + +const char *server_key = +"-----BEGIN PRIVATE KEY-----\r\n" +"MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCujwJbVfTFoaYa\r\n" +"QNozEptdYDkvD6x4DrW2KgatIhDO6oth4mgWfBWAXSMHk9OP7cSIYwFwD+aHvdUC\r\n" +"2FMWYkHGP5qAinv9y9QGmB8sKWZJgvZ9mLoWh3P5/2ZyvLddHDs7q+Vqa1Z9NfxM\r\n" +"CYxJHo9dUEcuCOzmkM4UWas0CwzmwthTX/UwW8TZn0idMjkbjfsgTVZyFFJulh0d\r\n" +"yELf1fOkMagidkHVrc6Fweb7FS0ukwnQbSgTlUUTKdmt5mgQhjgnGylDss+xrL1/\r\n" +"HdOWTT2AQxCBUJ4I2JDBTFl20tq7bHrUs1x1kIo3sVsUsmzO/VTa6C4QuxOaLsTq\r\n" +"ketPOKixAgMBAAECggEAI+uNwpnHirue4Jwjyoqzqd1ZJxQEm5f7UIcJZKsz5kBh\r\n" +"ej0KykWybv27bZ2/1UhKPv6QlyzOdXRc1v8I6fxCKLeB5Z2Zsjo1YT4AfCfwwoPO\r\n" +"kT3SXTx2YyVpQYcP/HsIvVi8FtALtixbxJHaall9iugwHYr8pN17arihAE6d0wZC\r\n" +"JXtXRjUWwjKzXP8FoH4KhyadhHbDwIbbJe3cyLfdvp54Gr0YHha0JcOxYgDYNya4\r\n" +"OKxlCluI+hPF31iNzOmFLQVrdYynyPcR6vY5XOiANKE2iNbqCzRb54CvW9WMqObX\r\n" +"RD9t3DMOxGsbVNIwyzZndWy13HoQMGnrHfnGak9ueQKBgQDiVtOqYfLnUnTxvJ/b\r\n" +"qlQZr2ZmsYPZztxlP+DSqZGPD+WtGSo9+rozWfzjTv3KGIDLvf+GFVmjVHwlLQfd\r\n" +"u7eTemWHFc4HK68wruzPO/FdyVpQ4w9v3Usg+ll4a/PDEId0fDMjAr6kk4LC6t8y\r\n" +"9fJR0HjOz57jVnlrDt3v50G8BwKBgQDFbw+jRiUxXnBbDyXZLi+I4iGBGdC+CbaJ\r\n" +"CmsM6/TsOFc+GRsPwQF1gCGqdaURw76noIVKZJOSc8I+yiwU6izyh/xaju5JiWQd\r\n" +"kwbU1j4DE6GnxmT3ARmB7VvCxjaEZEAtICWs1QTKRz7PcTV8yr7Ng1A3VIy+NSpo\r\n" +"LFMMmk83hwKBgQDVCEwpLg/mUeHoNVVw95w4oLKNLb+gHeerFLiTDy8FrDzM88ai\r\n" +"l37yHly7xflxYia3nZkHpsi7xiUjCINC3BApKyasQoWskh1OgRY653yCfaYYQ96f\r\n" +"t3WjEH9trI2+p6wWo1+uMEMnu/9zXoW9/WeaQdGzNg+igh29+jxCNTPVuQKBgGV4\r\n" +"CN9vI5pV4QTLqjYOSJvfLDz/mYqxz0BrPE1tz3jAFAZ0PLZCCY/sBGFpCScyJQBd\r\n" +"vWNYgYeZOtGuci1llSgov4eDQfBFTlDsyWwFl+VY55IkoqtXw1ZFOQ3HdSlhpKIM\r\n" +"jZBgApA7QYq3sjeqs5lHzahCKftvs5XKgfxOKjxtAoGBALdnYe6xkDvGLvI51Yr+\r\n" +"Dy0TNcB5W84SxUKvM7DVEomy1QPB57ZpyQaoBq7adOz0pWJXfp7qo4950ZOhBGH1\r\n" +"hKbZ6c4ggwVJy2j49EgMok5NGCKvPAtabbR6H8Mz8DW9aXURxhWJvij+Qw1fWK4b\r\n" +"7G/qUI9iE5iUU7MkIcLIbTf/\r\n" +"-----END PRIVATE KEY-----\r\n"; + +static void notFound(MongooseHttpServerRequest *request); + +#include + +void setup() +{ + Serial.begin(115200); + +#ifdef START_ESP_WIFI + WiFi.mode(WIFI_STA); + WiFi.begin(ssid, password); + if (WiFi.waitForConnectResult() != WL_CONNECTED) + { + Serial.printf("WiFi Failed!\n"); + return; + } + + Serial.print("IP Address: "); + Serial.println(WiFi.localIP()); + Serial.print("Hostname: "); +#ifdef ESP32 + Serial.println(WiFi.getHostname()); +#elif defined(ESP8266) + Serial.println(WiFi.hostname()); +#endif +#endif + + Mongoose.begin(); + +#ifdef SIMPLE_SERVER_SECURE + if(false == server.begin(443, server_pem, server_key)) { + Serial.print("Failed to start server"); + return; + } +#else + server.begin(80); +#endif + + server.on("/$", HTTP_GET, [](MongooseHttpServerRequest *request) { + request->send(200, "text/plain", "Hello world"); + }); + + // Send a GET request to /get?message= + server.on("/get$", HTTP_GET, [](MongooseHttpServerRequest *request) { + String message; + if (request->hasParam(PARAM_MESSAGE)) + { + message = request->getParam(PARAM_MESSAGE); + } + else + { + message = "No message sent"; + } + request->send(200, "text/plain", "Hello, GET: " + message); + }); + + // Send a POST request to /post with a form field message set to + server.on("/post$", HTTP_POST, [](MongooseHttpServerRequest *request) { + String message; + if (request->hasParam(PARAM_MESSAGE)) + { + message = request->getParam(PARAM_MESSAGE); + } + else + { + message = "No message sent"; + } + request->send(200, "text/plain", "Hello, POST: " + message); + }); + + // Test the basic response class + server.on("/basic$", HTTP_GET, [](MongooseHttpServerRequest *request) { + MongooseHttpServerResponseBasic *resp = request->beginResponse(); + resp->setCode(200); + resp->setContentType("text/html"); + resp->addHeader("Cache-Control", "max-age=300"); + resp->addHeader("X-hello", "world"); + resp->setContent( + "\n" + "\n" + "Basic Page\n" + "\n" + "\n" + "

Basic Page

\n" + "

\n" + "This page has been sent using the MongooseHttpServerResponseBasic class\n" + "

\n" + "\n" + "\n"); + request->send(resp); + }); + + // Test the stream response class + server.on("/stream$", HTTP_GET, [](MongooseHttpServerRequest *request) { + MongooseHttpServerResponseStream *resp = request->beginResponseStream(); + resp->setCode(200); + resp->setContentType("text/html"); + resp->addHeader("Cache-Control", "max-age=300"); + resp->addHeader("X-hello", "world"); + + resp->println(""); + resp->println(""); + resp->println("Stream Page"); + resp->println(""); + resp->println(""); + resp->println("

Stream Page

"); + resp->println("

"); + resp->println("This page has been sent using the MongooseHttpServerResponseStream class"); + resp->println("

"); + resp->println("

"); + resp->printf("micros = %lu
", micros()); + resp->printf("free = %u
", ESP.getFreeHeap()); + resp->println("

"); + resp->println(""); + resp->println(""); + + request->send(resp); + }); + + server.onNotFound(notFound); +} + +void loop() +{ + Mongoose.poll(1000); + Serial.printf("Free memory %u\n", ESP.getFreeHeap()); +} + +static void notFound(MongooseHttpServerRequest *request) +{ + request->send(404, "text/plain", "Not found"); +} diff --git a/lib/PsychicHttp/examples/old/simple_http_server/test/README b/lib/PsychicHttp/examples/old/simple_http_server/test/README new file mode 100644 index 0000000..df5066e --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PIO Unit Testing and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PIO Unit Testing: +- https://docs.platformio.org/page/plus/unit-testing.html diff --git a/lib/PsychicHttp/examples/old/simple_http_server/test/tests.rest b/lib/PsychicHttp/examples/old/simple_http_server/test/tests.rest new file mode 100644 index 0000000..4072428 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simple_http_server/test/tests.rest @@ -0,0 +1,35 @@ +# Name: REST Client +# Id: humao.rest-client +# Description: REST Client for Visual Studio Code +# Version: 0.21.3 +# Publisher: Huachao Mao +# VS Marketplace Link: https://marketplace.visualstudio.com/items?itemName=humao.rest-client + +@baseUrl = http://172.16.0.87 + +### + +GET {{baseUrl}}/ HTTP/1.1 + +### + +GET {{baseUrl}}/get?message=Hello+World HTTP/1.1 + +### + +POST {{baseUrl}}/post HTTP/1.1 +Content-Type: application/x-www-form-urlencoded;charset=UTF-8 + +message=Hello+World + +### + +GET {{baseUrl}}/someRandomFile HTTP/1.1 + +### + +GET {{baseUrl}}/basic HTTP/1.1 + +### + +GET {{baseUrl}}/stream HTTP/1.1 diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/.gitignore b/lib/PsychicHttp/examples/old/simplest_web_server_esp/.gitignore new file mode 100644 index 0000000..be2b7e8 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/.gitignore @@ -0,0 +1,39 @@ +.pioenvs +.clang_complete +.gcc-flags.json +# Compiled Object files +*.slo +*.lo +*.o +*.obj +# Precompiled Headers +*.gch +*.pch +# Compiled Dynamic libraries +*.so +*.dylib +*.dll +# Fortran module files +*.mod +# Compiled Static libraries +*.lai +*.la +*.a +*.lib +# Executables +*.exe +*.out +*.app +# Visual Studio/VisualMicro stuff +Visual\ Micro +*.sdf +*.opensdf +*.suo +.pioenvs +.piolibdeps +.pio +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/settings.json +.vscode/.browse.c_cpp.db* +.vscode/ipch \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/.travis.yml b/lib/PsychicHttp/examples/old/simplest_web_server_esp/.travis.yml new file mode 100644 index 0000000..7c486f1 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/.travis.yml @@ -0,0 +1,67 @@ +# Continuous Integration (CI) is the practice, in software +# engineering, of merging all developer working copies with a shared mainline +# several times a day < https://docs.platformio.org/page/ci/index.html > +# +# Documentation: +# +# * Travis CI Embedded Builds with PlatformIO +# < https://docs.travis-ci.com/user/integration/platformio/ > +# +# * PlatformIO integration with Travis CI +# < https://docs.platformio.org/page/ci/travis.html > +# +# * User Guide for `platformio ci` command +# < https://docs.platformio.org/page/userguide/cmd_ci.html > +# +# +# Please choose one of the following templates (proposed below) and uncomment +# it (remove "# " before each line) or use own configuration according to the +# Travis CI documentation (see above). +# + + +# +# Template #1: General project. Test it using existing `platformio.ini`. +# + +# language: python +# python: +# - "2.7" +# +# sudo: false +# cache: +# directories: +# - "~/.platformio" +# +# install: +# - pip install -U platformio +# - platformio update +# +# script: +# - platformio run + + +# +# Template #2: The project is intended to be used as a library with examples. +# + +# language: python +# python: +# - "2.7" +# +# sudo: false +# cache: +# directories: +# - "~/.platformio" +# +# env: +# - PLATFORMIO_CI_SRC=path/to/test/file.c +# - PLATFORMIO_CI_SRC=examples/file.ino +# - PLATFORMIO_CI_SRC=path/to/test/directory +# +# install: +# - pip install -U platformio +# - platformio update +# +# script: +# - platformio ci --lib="." --board=ID_1 --board=ID_2 --board=ID_N diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/include/README b/lib/PsychicHttp/examples/old/simplest_web_server_esp/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/lib/README b/lib/PsychicHttp/examples/old/simplest_web_server_esp/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/platformio.ini b/lib/PsychicHttp/examples/old/simplest_web_server_esp/platformio.ini new file mode 100644 index 0000000..d02c3bc --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/platformio.ini @@ -0,0 +1,40 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[common] +lib_deps = ArduinoMongoose +monitor_speed = 115200 +build_flags = + +[espressif8266] +build_flags = -DMG_ESP8266 + +[espressif32] +build_flags = + +[env:huzzah] +platform = espressif8266 +framework = arduino +board = huzzah +monitor_speed = ${common.monitor_speed} +lib_deps = ${common.lib_deps} +build_flags = + ${espressif8266.build_flags} + ${common.build_flags} + +[env:espwroverkit] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +lib_deps = ${common.lib_deps} +build_flags = + ${espressif32.build_flags} + ${common.build_flags} diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/src/simplest_web_server.cpp b/lib/PsychicHttp/examples/old/simplest_web_server_esp/src/simplest_web_server.cpp new file mode 100644 index 0000000..cedb9c2 --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/src/simplest_web_server.cpp @@ -0,0 +1,97 @@ +// Copyright (c) 2015 Cesanta Software Limited +// All rights reserved + +#include + +#ifdef ESP32 +#include +#elif defined(ESP8266) +#include +#else +#error Platform not supported +#endif + +#include "mongoose.h" + +const char* ssid = "my-ssid"; +const char* password = "my-password"; + +static const char *s_http_port = "80"; +//static struct mg_serve_http_opts s_http_server_opts; + +static void ev_handler(struct mg_connection *nc, int ev, void *p, void *d) { + static const char *reply_fmt = + "HTTP/1.0 200 OK\r\n" + "Connection: close\r\n" + "Content-Type: text/plain\r\n" + "\r\n" + "Hello %s\n"; + + switch (ev) { + case MG_EV_ACCEPT: { + char addr[32]; + mg_sock_addr_to_str(&nc->sa, addr, sizeof(addr), + MG_SOCK_STRINGIFY_IP | MG_SOCK_STRINGIFY_PORT); + Serial.printf("Connection %p from %s\n", nc, addr); + break; + } + case MG_EV_HTTP_REQUEST: { + char addr[32]; + struct http_message *hm = (struct http_message *) p; + mg_sock_addr_to_str(&nc->sa, addr, sizeof(addr), + MG_SOCK_STRINGIFY_IP | MG_SOCK_STRINGIFY_PORT); + Serial.printf("HTTP request from %s: %.*s %.*s\n", addr, (int) hm->method.len, + hm->method.p, (int) hm->uri.len, hm->uri.p); + mg_printf(nc, reply_fmt, addr); + nc->flags |= MG_F_SEND_AND_CLOSE; + break; + } + case MG_EV_CLOSE: { + Serial.printf("Connection %p closed\n", nc); + break; + } + } +} + +struct mg_mgr mgr; +struct mg_connection *nc; + +void setup() +{ + Serial.begin(115200); + + Serial.print("Connecting to "); + Serial.println(ssid); + + WiFi.begin(ssid, password); + + while (WiFi.status() != WL_CONNECTED) { + delay(500); + Serial.print("."); + } + + Serial.println(""); + Serial.println("WiFi connected"); + Serial.println("IP address: "); + Serial.println(WiFi.localIP()); + + mg_mgr_init(&mgr, NULL); + Serial.printf("Starting web server on port %s\n", s_http_port); + nc = mg_bind(&mgr, s_http_port, ev_handler, NULL); + if (nc == NULL) { + Serial.printf("Failed to create listener\n"); + return; + } + + // Set up HTTP server parameters + mg_set_protocol_http_websocket(nc); +// s_http_server_opts.document_root = "."; // Serve current directory +// s_http_server_opts.enable_directory_listing = "yes"; +} + +static uint32_t count = 0; +void loop() +{ + mg_mgr_poll(&mgr, 1000); + //Serial.println(count++); +} diff --git a/lib/PsychicHttp/examples/old/simplest_web_server_esp/test/README b/lib/PsychicHttp/examples/old/simplest_web_server_esp/test/README new file mode 100644 index 0000000..df5066e --- /dev/null +++ b/lib/PsychicHttp/examples/old/simplest_web_server_esp/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PIO Unit Testing and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PIO Unit Testing: +- https://docs.platformio.org/page/plus/unit-testing.html diff --git a/lib/PsychicHttp/examples/old/websocket_chat/.gitignore b/lib/PsychicHttp/examples/old/websocket_chat/.gitignore new file mode 100644 index 0000000..be2b7e8 --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/.gitignore @@ -0,0 +1,39 @@ +.pioenvs +.clang_complete +.gcc-flags.json +# Compiled Object files +*.slo +*.lo +*.o +*.obj +# Precompiled Headers +*.gch +*.pch +# Compiled Dynamic libraries +*.so +*.dylib +*.dll +# Fortran module files +*.mod +# Compiled Static libraries +*.lai +*.la +*.a +*.lib +# Executables +*.exe +*.out +*.app +# Visual Studio/VisualMicro stuff +Visual\ Micro +*.sdf +*.opensdf +*.suo +.pioenvs +.piolibdeps +.pio +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/settings.json +.vscode/.browse.c_cpp.db* +.vscode/ipch \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/websocket_chat/include/README b/lib/PsychicHttp/examples/old/websocket_chat/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/old/websocket_chat/lib/README b/lib/PsychicHttp/examples/old/websocket_chat/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/old/websocket_chat/platformio.ini b/lib/PsychicHttp/examples/old/websocket_chat/platformio.ini new file mode 100644 index 0000000..165b7ac --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/platformio.ini @@ -0,0 +1,64 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[common] +lib_deps = ArduinoMongoose +monitor_speed = 115200 +monitor_port = /dev/ttyUSB2 +build_flags = + -DENABLE_DEBUG +# -DCS_ENABLE_STDIO + +build_flags_secure = + -DSIMPLE_SERVER_SECURE + -DMG_ENABLE_SSL=1 + +# -DMG_SSL_IF=MG_SSL_IF_OPENSSL +# -DKR_VERSION + + -DMG_SSL_MBED_DUMMY_RANDOM=1 + -DMG_SSL_IF=MG_SSL_IF_MBEDTLS + -DMG_SSL_IF_MBEDTLS_FREE_CERTS=1 + -DMG_SSL_IF_MBEDTLS_MAX_FRAG_LEN=2048 + +[env:huzzah] +platform = espressif8266 +board = huzzah +framework = arduino +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} + +[env:esp-wrover-kit] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} + +[env:esp-wrover-kit-secure] +platform = espressif32 +framework = arduino +board = esp-wrover-kit +monitor_speed = ${common.monitor_speed} +monitor_port = ${common.monitor_port} +lib_deps = ${common.lib_deps} +build_flags = ${common.build_flags} ${common.build_flags_secure} + +#[env:linux_x86_64] +#platform = linux_x86_64 +#framework = arduino +#board = generic +#lib_deps = ${common.lib_deps} +#build_flags = ${common.build_flags} +#build_flags = -DSERIAL_TO_CONSOLE \ No newline at end of file diff --git a/lib/PsychicHttp/examples/old/websocket_chat/src/websocket_chat.cpp b/lib/PsychicHttp/examples/old/websocket_chat/src/websocket_chat.cpp new file mode 100644 index 0000000..47a04cf --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/src/websocket_chat.cpp @@ -0,0 +1,235 @@ +// +// A simple server implementation showing how to: +// * serve static messages +// * read GET and POST parameters +// * handle missing pages / 404s +// + +#include +#include +#include + +#ifdef ESP32 +#include +#define START_ESP_WIFI +#elif defined(ESP8266) +#include +#define START_ESP_WIFI +#else +#error Platform not supported +#endif + +MongooseHttpServer server; + +const char *ssid = "wifi"; +const char *password = "password"; + +const char *server_pem = +"-----BEGIN CERTIFICATE-----\r\n" +"MIIDDjCCAfagAwIBAgIBBDANBgkqhkiG9w0BAQsFADA/MRkwFwYDVQQDDBB0ZXN0\r\n" +"LmNlc2FudGEuY29tMRAwDgYDVQQKDAdDZXNhbnRhMRAwDgYDVQQLDAd0ZXN0aW5n\r\n" +"MB4XDTE2MTExMzEzMTgwMVoXDTI2MDgxMzEzMTgwMVowFDESMBAGA1UEAwwJbG9j\r\n" +"YWxob3N0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAro8CW1X0xaGm\r\n" +"GkDaMxKbXWA5Lw+seA61tioGrSIQzuqLYeJoFnwVgF0jB5PTj+3EiGMBcA/mh73V\r\n" +"AthTFmJBxj+agIp7/cvUBpgfLClmSYL2fZi6Fodz+f9mcry3XRw7O6vlamtWfTX8\r\n" +"TAmMSR6PXVBHLgjs5pDOFFmrNAsM5sLYU1/1MFvE2Z9InTI5G437IE1WchRSbpYd\r\n" +"HchC39XzpDGoInZB1a3OhcHm+xUtLpMJ0G0oE5VFEynZreZoEIY4JxspQ7LPsay9\r\n" +"fx3Tlk09gEMQgVCeCNiQwUxZdtLau2x61LNcdZCKN7FbFLJszv1U2uguELsTmi7E\r\n" +"6pHrTziosQIDAQABo0AwPjAJBgNVHRMEAjAAMAsGA1UdDwQEAwIDqDATBgNVHSUE\r\n" +"DDAKBggrBgEFBQcDATAPBgNVHREECDAGhwR/AAABMA0GCSqGSIb3DQEBCwUAA4IB\r\n" +"AQBUw0hbTcT6crzODO4QAXU7z4Xxn0LkxbXEsoThG1QCVgMc4Bhpx8gyz5CLyHYz\r\n" +"AiJOBFEeV0XEqoGTNMMFelR3Q5Tg9y1TYO3qwwAWxe6/brVzpts6NiG1uEMBnBFg\r\n" +"oN1x3I9x4NpOxU5MU1dlIxvKs5HQCoNJ8D0SqOX9BV/pZqwEgiCbuWDWQAlxkFpn\r\n" +"iLonlkVI5hTuybCSBsa9FEI9M6JJn9LZmlH90FYHeS4t6P8eOJCeekHL0jUG4Iae\r\n" +"DMP12h8Sd0yxIKmmZ+Q/p/D/BkuHf5Idv3hgyLkZ4mNznjK49wHaYM+BgBoL3Zeg\r\n" +"gJ2sWjUlokrbHswSBLLbUJIF\r\n" +"-----END CERTIFICATE-----\r\n"; + +const char *server_key = +"-----BEGIN PRIVATE KEY-----\r\n" +"MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCujwJbVfTFoaYa\r\n" +"QNozEptdYDkvD6x4DrW2KgatIhDO6oth4mgWfBWAXSMHk9OP7cSIYwFwD+aHvdUC\r\n" +"2FMWYkHGP5qAinv9y9QGmB8sKWZJgvZ9mLoWh3P5/2ZyvLddHDs7q+Vqa1Z9NfxM\r\n" +"CYxJHo9dUEcuCOzmkM4UWas0CwzmwthTX/UwW8TZn0idMjkbjfsgTVZyFFJulh0d\r\n" +"yELf1fOkMagidkHVrc6Fweb7FS0ukwnQbSgTlUUTKdmt5mgQhjgnGylDss+xrL1/\r\n" +"HdOWTT2AQxCBUJ4I2JDBTFl20tq7bHrUs1x1kIo3sVsUsmzO/VTa6C4QuxOaLsTq\r\n" +"ketPOKixAgMBAAECggEAI+uNwpnHirue4Jwjyoqzqd1ZJxQEm5f7UIcJZKsz5kBh\r\n" +"ej0KykWybv27bZ2/1UhKPv6QlyzOdXRc1v8I6fxCKLeB5Z2Zsjo1YT4AfCfwwoPO\r\n" +"kT3SXTx2YyVpQYcP/HsIvVi8FtALtixbxJHaall9iugwHYr8pN17arihAE6d0wZC\r\n" +"JXtXRjUWwjKzXP8FoH4KhyadhHbDwIbbJe3cyLfdvp54Gr0YHha0JcOxYgDYNya4\r\n" +"OKxlCluI+hPF31iNzOmFLQVrdYynyPcR6vY5XOiANKE2iNbqCzRb54CvW9WMqObX\r\n" +"RD9t3DMOxGsbVNIwyzZndWy13HoQMGnrHfnGak9ueQKBgQDiVtOqYfLnUnTxvJ/b\r\n" +"qlQZr2ZmsYPZztxlP+DSqZGPD+WtGSo9+rozWfzjTv3KGIDLvf+GFVmjVHwlLQfd\r\n" +"u7eTemWHFc4HK68wruzPO/FdyVpQ4w9v3Usg+ll4a/PDEId0fDMjAr6kk4LC6t8y\r\n" +"9fJR0HjOz57jVnlrDt3v50G8BwKBgQDFbw+jRiUxXnBbDyXZLi+I4iGBGdC+CbaJ\r\n" +"CmsM6/TsOFc+GRsPwQF1gCGqdaURw76noIVKZJOSc8I+yiwU6izyh/xaju5JiWQd\r\n" +"kwbU1j4DE6GnxmT3ARmB7VvCxjaEZEAtICWs1QTKRz7PcTV8yr7Ng1A3VIy+NSpo\r\n" +"LFMMmk83hwKBgQDVCEwpLg/mUeHoNVVw95w4oLKNLb+gHeerFLiTDy8FrDzM88ai\r\n" +"l37yHly7xflxYia3nZkHpsi7xiUjCINC3BApKyasQoWskh1OgRY653yCfaYYQ96f\r\n" +"t3WjEH9trI2+p6wWo1+uMEMnu/9zXoW9/WeaQdGzNg+igh29+jxCNTPVuQKBgGV4\r\n" +"CN9vI5pV4QTLqjYOSJvfLDz/mYqxz0BrPE1tz3jAFAZ0PLZCCY/sBGFpCScyJQBd\r\n" +"vWNYgYeZOtGuci1llSgov4eDQfBFTlDsyWwFl+VY55IkoqtXw1ZFOQ3HdSlhpKIM\r\n" +"jZBgApA7QYq3sjeqs5lHzahCKftvs5XKgfxOKjxtAoGBALdnYe6xkDvGLvI51Yr+\r\n" +"Dy0TNcB5W84SxUKvM7DVEomy1QPB57ZpyQaoBq7adOz0pWJXfp7qo4950ZOhBGH1\r\n" +"hKbZ6c4ggwVJy2j49EgMok5NGCKvPAtabbR6H8Mz8DW9aXURxhWJvij+Qw1fWK4b\r\n" +"7G/qUI9iE5iUU7MkIcLIbTf/\r\n" +"-----END PRIVATE KEY-----\r\n"; + +const char *index_page = +"\n" +"\n" +"\n" +" \n" +" WebSocket Test\n" +" \n" +" \n" +"\n" +"\n" +"\n" +"\n" +"
\n" +"

Websocket PubSub Demonstration

\n" +"\n" +"

\n" +" This page demonstrates how Mongoose could be used to implement\n" +" \n" +" publish–subscribe pattern. Open this page in several browser\n" +" windows. Each window initiates persistent\n" +" WebSocket\n" +" connection with the server, making each browser window a websocket client.\n" +" Send messages, and see messages sent by other clients.\n" +"

\n" +"\n" +"
\n" +"
\n" +"\n" +"

\n" +" \n" +" \n" +"

\n" +"
\n" +"\n" +"\n"; + +#include + +void broadcast(MongooseHttpWebSocketConnection *from, MongooseString msg) +{ + char buf[500]; + char addr[32]; + mg_sock_addr_to_str(from->getRemoteAddress(), addr, sizeof(addr), + MG_SOCK_STRINGIFY_IP | MG_SOCK_STRINGIFY_PORT); + + snprintf(buf, sizeof(buf), "%s %.*s", addr, (int) msg.length(), msg.c_str()); + printf("%s\n", buf); + server.sendAll(from, buf); +} + +void setup() +{ + Serial.begin(115200); + +#ifdef START_ESP_WIFI + WiFi.mode(WIFI_STA); + WiFi.begin(ssid, password); + if (WiFi.waitForConnectResult() != WL_CONNECTED) + { + Serial.printf("WiFi Failed!\n"); + return; + } + + Serial.print("IP Address: "); + Serial.println(WiFi.localIP()); + Serial.print("Hostname: "); +#ifdef ESP32 + Serial.println(WiFi.getHostname()); +#elif defined(ESP8266) + Serial.println(WiFi.hostname()); +#endif +#endif + + Mongoose.begin(); + +#ifdef SIMPLE_SERVER_SECURE + if(false == server.begin(443, server_pem, server_key)) { + Serial.print("Failed to start server"); + return; + } +#else + server.begin(80); +#endif + + server.on("/$", HTTP_GET, [](MongooseHttpServerRequest *request) { + request->send(200, "text/html", index_page); + }); + + // Test the stream response class + server.on("/ws$")-> + onConnect([](MongooseHttpWebSocketConnection *connection) { + broadcast(connection, MongooseString("++ joined")); + })-> + onClose([](MongooseHttpServerRequest *c) { + MongooseHttpWebSocketConnection *connection = static_cast(c); + broadcast(connection, MongooseString("++ left")); + })-> + onFrame([](MongooseHttpWebSocketConnection *connection, int flags, uint8_t *data, size_t len) { + broadcast(connection, MongooseString((const char *)data, len)); + }); +} + +void loop() +{ + Mongoose.poll(1000); + Serial.printf("Free memory %u\n", ESP.getFreeHeap()); +} diff --git a/lib/PsychicHttp/examples/old/websocket_chat/test/README b/lib/PsychicHttp/examples/old/websocket_chat/test/README new file mode 100644 index 0000000..df5066e --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PIO Unit Testing and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PIO Unit Testing: +- https://docs.platformio.org/page/plus/unit-testing.html diff --git a/lib/PsychicHttp/examples/old/websocket_chat/test/tests.rest b/lib/PsychicHttp/examples/old/websocket_chat/test/tests.rest new file mode 100644 index 0000000..4072428 --- /dev/null +++ b/lib/PsychicHttp/examples/old/websocket_chat/test/tests.rest @@ -0,0 +1,35 @@ +# Name: REST Client +# Id: humao.rest-client +# Description: REST Client for Visual Studio Code +# Version: 0.21.3 +# Publisher: Huachao Mao +# VS Marketplace Link: https://marketplace.visualstudio.com/items?itemName=humao.rest-client + +@baseUrl = http://172.16.0.87 + +### + +GET {{baseUrl}}/ HTTP/1.1 + +### + +GET {{baseUrl}}/get?message=Hello+World HTTP/1.1 + +### + +POST {{baseUrl}}/post HTTP/1.1 +Content-Type: application/x-www-form-urlencoded;charset=UTF-8 + +message=Hello+World + +### + +GET {{baseUrl}}/someRandomFile HTTP/1.1 + +### + +GET {{baseUrl}}/basic HTTP/1.1 + +### + +GET {{baseUrl}}/stream HTTP/1.1 diff --git a/lib/PsychicHttp/examples/platformio/.gitignore b/lib/PsychicHttp/examples/platformio/.gitignore new file mode 100644 index 0000000..9e5f911 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/.gitignore @@ -0,0 +1,6 @@ +.pio +.vscode/ +.vscode/.browse.c_cpp.db* +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/ipch diff --git a/lib/PsychicHttp/examples/platformio/data/custom.txt b/lib/PsychicHttp/examples/platformio/data/custom.txt new file mode 100644 index 0000000..d3db23d --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/data/custom.txt @@ -0,0 +1 @@ +Custom text file. \ No newline at end of file diff --git a/lib/PsychicHttp/examples/platformio/data/img/request_flow.png b/lib/PsychicHttp/examples/platformio/data/img/request_flow.png new file mode 100644 index 0000000000000000000000000000000000000000..1005a38895f77797f39ecd018d5fd6a746502a62 GIT binary patch literal 30509 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 + + + + + PsychicHTTP SoftAP Demo + + + +
+

SoftAP Demo

+

You are connected to the ESP in SoftAP mode.

+
+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/platformio/data/www/alien.png b/lib/PsychicHttp/examples/platformio/data/www/alien.png new file mode 100644 index 0000000000000000000000000000000000000000..a030da0761a60fbfc813fbef0716f801b7aa5ca6 GIT binary patch literal 28598 zcmYJaWmuG5*Dws@07I9c(v3)ofOHIvbW4}Clyr9^NOyN5-5@DFv~)>#H+&~v_w#_92^|Fq=bkf931@l^B)8e_|M?S$Wr;jgr@UiH3RbUqIq6nxmxyTg3pllF+C|;?J8R22|OHS|$5C&}~C$Cp7CMXc++U4Q4NgN|sM6}41E?6Tp^Y-YI z6#fhiLo&L$mU?MXaTZi`JA7SWs9of%+UM(=S3bi+!8kp6V9v*Az4tWod4Y=G#KQ2K zDcB2cxINq5-$Y_hu6%la!EBxtD%w8(hSb9e7Pwy4*Eb&|887A+KvZ>oyX1?J- zM_ibe8Z;Ta%NmvTHtCP(e8mmObB2XPqVT@qFQ_-LKpD z4T?X3%T@C>*_O^`P3Wj<7WhmK$V3NUz+mPR`cM4KCr_Q)UaR$Yx(0YN%qF?DZ&y`N zAGIOqU_mk>5Z1YkX;uX#^55%EvUo4Qj6EtfAk?lN4O`*o5JZ5poyLV8JS&{(Mbn>< zPX+E(pQQT2yBS@Z13j>QB*B5TH)n+hSOA@+1Vb@U^q_?yjMU z2~%{?Q*7L)c~U=7T$BaddgOG67^VOH%SVnbMvG+wfrm5+(-4@EWOT?a39i3J(fMud z%doaamh8Zr9~Utk%RLx+ZlaL!XTy>H=3cr z^tlDkmg$ILOCXLaEFjp1f~;drXNd6l^U4k(HtE%O+S*0|5bJ9YXdDoR6psUhR~e*p zR7Vh`eK)eTaTZ4Rx+QqIV=*g2R3HQyvbx^*=o>lZq0au<&P=SA?v8o{G0U$*5?K%? z7YZT%LRl#i{D%PHQC9gENY)

&213^-9%ncHPP24Z3H*pr~$xg!|8Chf_Iiynyz> z93O8Fh#>5MH6dc;OP*6JkA%_g{8f+py++>$wFK~7>jzUfTpXl5QQU`mA#0HpkGuWh zBSnx#V~>LaFDl>LkTCfS9Ie*0)6TFR^@wUUWd%z$fXANv!H;hps}l$3hF&?8v>us_ z|0N6d@n!&%ZC4G&`mHlCFqBr+OYiij%(+A z$0sLim`8U12+#&Na==|3y%pER5kz;>v*_pRdXisPax9~DiX6v#KVW?*f;wg7@<~o( z|7Jaqn+>b-B|uYN{)=CQDsvbLJ2FBFhbuu!Wl<4`pm>Uo5|Q?|LcF@)i(8_i#=aKh z`3k>}pn-!rou6yc-Ync_qxwQsx_hRya?3&;D1@oVYQ7WL#C#^HX*;YB_FiVS$bVnc>D6rh8$)M%jb$G~E7uE~ zvJh9pziwW$)asoT9-^f^ezHDDGV7PJMc?la$qI4=*faOjKMxnH@a5_KT8Wnvz=OMWX~tBJ z*}BFqTuXVuw4w+8Gq&Z#k)i1TY}avz%7eIo0Cf6+xL+@oZ|$h-U7t~gW=6v;@7Kpz zU#IMZ;>tNm$Sh(okY%z1Bu-F<_Qi*8*qYYFRHkN}#5fFcOGHg}@sr%$x>hf*}y_8mNgJKZlB^4Ixc z*u~6)h?#iFS963yC>Tn1EC7CI?V%Lw!f=So`=-AggbDGNg7YO|VhOq$J&8;Gq|6c+ z&_Zg(ZFk+}eSSgS!O>>Bv;NAN?olDKdBgga(?^8|Fw=QkRfpen1$uTb-U+aUE)O6b z3oFSWy?T!fBC~l3zr^blY|%TK`^UdOy@sa!1qLKF91i^O#h>VLSq%Z?Fo3DXn+Y}} zYmb_-;lu#^dM_@Pfxr_5A7!1!5bgmkt`i|C9PfY-oG;U$^c$iAjaf$8_681wp7nd} zilSeKs~BLxmDiwq*2Z6=<@&@6A=WvkL?n@36mZZ!yAux3?9y6<7TmhoBW9X65?HX~ z8(8%%)5gfqw4{J0(+BVufIm$|*JT^-G74jK;t_ASnB4)nZk&eM6;oT#{ND=VE$xA&h}V%qzuC2>AD zncpW`NC*s(Y8B7Z^L%*$BI}6T#5kUrwEZjVK9}>>h-?jrANE^A>_%=V=YUc4JG_G{*g%Imb%ZlBGnC@Fi6s3N^296%OMwx+-;%%vKT=`+ z&A2n6)8YLqDZBLI-6de~^;h?b5u;vjNUdEI6bgS1D~Y-SfwYhII0dU5Uj0o7DO|J% z;Cd{%>n%_?J~GnNr}gY;TTQ%-!iRVZ{sDIj;S7*1Y~p|9q(c;hyU4%yMdepg_F6nZVthiRLUG zwyR-GHZm+IP!5FVOWEqPu#s#O*D$YjtNd1n&j7b8Dd8_VUx|hs^k0=%)EIio4kG(9 z-GrZEevyu-aAwG$+o~#iN$J83AqDir6eJWICH1C1p|w!z*d3iGx%Aohju7=}H=Z0w z>}WDorieIwh&&mKx#O}Q%J^~?WCIlhflBw*kg54@ zps^8gdUX*f*uG?A?hne!lhSl5ORE$t#MCH+S-x-(2}wbQtye)hoYhRDf1xnyq>{L{ zH9LBL=Zv0~bSiR6X)HMSe&pknTZ|sj85fNLhA3VyZEh@kRJo#==CWS$xhoVex~GJIE)i2e#2929)_bVt zP3FsEO%7ci7!qm&FUhy@)9SRW6+-1><+xgu!vcdV0nbGw=Dj?Py7scEO5636J1CDy zvEuoM*=s~z>##gKX0X={M*H?6l=_P7PS zw4+{>2neK7N^3G`FUp~CK<4HO5+cG5Eg_xp@nUo}ti(cwf7Xv|qOO$XSS{U?oR)6> zcb}AAV}Jn4;wi{po_tny9q@}s86f{92t!ZbCjI!e5Wiim^;EfWKyStd>G>QYHdckA z>o)PHv? z6x!Qc8LX@j8KTnUBq60isj?CcMupDkXOnGm3kFC6;N7sWY6kI2>;nod1k$kVzb6&v zY5DyMl{+>rXZf7?0x(ESc$Gzf>p=nn$8kfuPp!`M5L(sb?P6`}4A zbW20*9mu!<09lHT?D8Lb<3r)O)@iYIB#lC_oZRFCMzad}8xE|qw@?F4fEYXE%EA~N zxAeZnZ+Uj)A{ks@K9s=XL|hg3{;i=sQGG<=XEo_K0bfhZ%Zi3HzRo7O$$^7L{vht= z6|#Aa_$==}a(TMlpXJrOW+6A;FZlrtx*n2fH4S*zjp@u92}ct6EW?fvWpLja=%?yG^Hy}Y|_@~Q0+mL(woQ9FF z8R?&K(%x)^2WAFw&d_`GFuwEu9Kmsh<&#DDEO`-0K`aEIG(o_+fC&o0gjZfdz{Q80 zFSUMYk3zC|nx2t>gP4l1Y~4<2rQzV>Vp^Dtr^l0R(McEfhOqxXYltB0VBYp%olx53rkI69`)86OX_Pa=)PqrKb1k&MS}fpa z;spgQ0FQ3V-e||V7&2J<(GtlG>)b1`=byt0KH5p$~NQwVC>~O9w56! zwPgzJqiKkF2wrLT1HSg=1*f)2j{NkEkg++v|3RVnj07af+mEB4OA+=HndvVnx;+qn z;out~oX#<+>tGL=)!uv~qaZZ{+*B=roM8NC775X;z+}Ef;G7RM51)m;vKxODaIcq1 z`Fy>%cQ_dT%%Nn_2#t3ye?MZw2=hqAd!DI}qq7ko-gU`D=V*EODus z(f&CwtRG<=8pTRw)di9Mc>{B@~pMG^fo*`AD!WX2<)wgDDZQfL@_Pft8 zVbYxby8#Q5;Z2sO8PBs5b}T-?+BxmpR@cy=utOfzm#4iqz)Btb@;`);K@Mj5VR77dJ?DKOfChoqe(X>8H21DCAEA zTPY&~-*aVQaM***9(E5$j`j~XG0C^j_osyLPL5(MDQ?n{A)2)?o zmst7J3|;Od2Pq@Pf7DjKgNGW3`xcJBqs*C=E$Mx2rB#P>PNa+dRF}6vzyv=3kDWFY z@GOxDOLu>$?dBn_<@MJ@S;5x(A6S0>3(mnG|RS14sq?ji{7WhB_NSz#6{g# zo}|}aylu^_I7OUOk?%oC<(j$t<<0&~oDBxNTdGWg1}p%pJeAiA04a=|7t= zl@old-cdy59!a%$lIWs%)<4cTI8vi#^1-wZy3_Z0c=i=en%{*7mf%R0EXe5HyMciA zEH849uV`8(O<~N}-XL#Q*tV!Ii(@eCLIJO1Y(BSH9er z=l?}xtuE^=mC~S>*#FtvZz;i8#C5t_!%qWiR z@mvV^n!8uwUPTqrp=xylMIJyq88bY8LYrKOq{L}1`;B%WLoT+x*7tW^>;A9*MK>LA z!^j;``Pq_gU}-MaIr|NDh`29a0MXZQGKjpS=k}CI#`7%VAAa5! z%j1lU+l@CpCSX4U>bA7OlLpF9&)-$j!@pU2{!VMnfjq&vb)Xy*ateBeg!Ll`j?_@I zW2WS?&b&Jw&;H^-3yh%K;rlNL19Zldks0`x2;YTwPsImsCXzAGKcl#|?wj}z#Z@qa zyKNXX0|yj+ zA@k1HNR&vKotN+V!sk2HLB1Hhy}kA33DaL=R19ijGq-@C`eq1H(g7v<-ys_iNQw9G zZ;gk<~dbAeCC3FNryZlp@%L}v8s^!^XLx9VbmDn33k zY*v@TA+Y@Kn4kn0jDGxuY80cWVkC_LuuDn~8rq6KgTHcjQkjRIW5lx$cLe+YKKqi} zP|Nzdky;AkT31n6FEpSTRp1l#e~9D5+p;eww80pTyl!g!GtZ10Hi+bDtMxks{(%5; z5J5cz>xey~Uz{>QiA>v#ZGtAyU!?5AD80`Tc-9j^5K3dymnPh)1f_}O9p90`gEN=L z)&w)~%Ikjz;K12bdI2RWGS6l#-0G*?q@ob}=dJp4vi1+rL~+63DipOTC7wKvMSWGQ zd=%I6QGw4`GOYA2*Z*>VKt^Sd%1n%Yds?}f0i6a%X*_!!tEYg3dDc#Jf`|VZI?!nV zm#wny91MjHvOz~jP*W>{S8%Fvf^?r{418e8-bpFz(zt-X9MftezfdjH?1ov+)}JSHl{+)_#eA6QQ@ITg;upnyfVo|lRb~f;mH)+h4WVD zY+a=Pv0NW4U3_E}pINb4e^wXxD}eHUSHBPSmP}bkdv&g|B-o5X-7xUB{P@K`-GKv% z;Ra)uUmmdHs1feW*g!`wZ%yb?7LC3{A0zzl1R`$YuZu+_!kr0us4j)b*YCVfvixp3 z6ThieQUAx|a4IserNV;bFkh&majdQ|0w0HfO$Y>0fb|{M_5YL@z8dnDNiA|{IwXT| zV_6>Rv^IOzm6vCK+~LVx`6RfJafeyx^>{LxHQx1-^p%`SiAr9vN{K?P`MsPFXsSp% zWp}b@@X3okC;i1gkUl>kMBL6l9FLYn-7XKQFP1ThxkZ97&jf-nCZeh+mCHV}7b=v<33!C2RwxcCOuZUta&_s60>_kJ%%v-M322 zJezlsD@VI(LyN(Z4R^b#pWM%gpV(EQ-$|&oC~6r>9HlN`w-hroD=V_RyZk$1+GTyM z(uGXu@vL(z?O+TNP6_@a4UJY;JiHR2wpBIZ?d}sPDMI{+ucEC`kn<8nFq_ObJmd+uQ`QJ=EZnILTG@Z;nT>=|B$noDb3gQ zRF`_}6p|8|D;i9)Kj~R~%eZJ6;#`B=*y zTAVo-+=;(!|-X&MVVB>vmBS ziM6q^MJob+1Gb{AKh)-K*H!V{uDvBCnOnD@Gz0{%Nmh79%Y=l430x(bs01g!Y;3hW z3&|OsnXoyh-(U=YP+Vj%{kv`PrLxCIw8Z8i~J|d|iBLkd=y{5g!cWEun(nc zgeI+w>=r@Fq9=LhUtY{agCS)rjAo_Ub0;fmTjJo@}*^r%})HC6A(xOsSW=YLo zgNJDsp(-3ecKF<6{~7XPW;jSy{?kpB54La+EP}Y*!f1TjagyT#0LiNR+Ag{5OynDx z9-@!?Qv2ETUWLL>zmFSYUFu~;Cx63DvRU;1e#R!mT`twuU{xVxw{8ltw9-)^C685O zi~Nk_XU&`_M|w(wTLVLWd(XI0T0NS#=e8{2u(#Tvx&0T03w})M$d^emeN3qs+l{05 zc`FTi+MP-%-*u5m%o*A#f17P>>^h*u*Rn^mU8Ni}-)2dOPHbO6@|D=|tct!oJALMH z(8r0G$2c^qFamseG%tSESbAPXt-H6~vy?xzcqk|9CKj52$`@I&L$S>z)UBX%;^^tm z;H71`SuHmasilp~$PIGXo64ELU8Hkx>D`9tu|fRB1^J}f&i5)zf2CN%eEg6)3B#AX zC}9_!s5eKM&0olJ=1mfXJe^y1GzSd(R6rxp$q+I_SUG}?cu84zFM|T7OOBTNtaJEZl~(e`KldJVaBxmZ{iT!I7tZ7 za+OKOcT70`F2dY?-GZO5w@y1&9rk~_0ATRsJ6XPp#(1XoUGvbm!fad`Ja7$#%{44* zU@zh4jtqS^ZJpinN|sigMt#mwGSx3q7fklT&EkZ_MCZ@AeqID)S}>yny*vGlkPDlq zbu)Ngx!Fr6X8HSrlONXTbEgL??UhVpY5CL_t@G6N|3=J`0Xy%OR4Q#Jc-xJX9v+*n z@nKvUc5|H&9kaDOa+RTZJ2ZaJp<5uwe=9E)QHcldv&69^lAvvC1f~Q!N2TI|i@zRw z_bSHKbQ$V&Y%s#MmpPV&60}?!d#dr zr13b7XS&^La*6cyI&P|)OdL2Zh@PkvbH>BtBm{Zie!t%_n=oDE9@eS+E2-lvq3gCM zfFnY;>9RoQQG=pv2)#cgH0 z2k!xSSx%p6CdVs#cWr>jW`UDb@oudtU4_(R?P(Ofc)4772Xc7J18ZjqOfD|krTK{WL9=bo7`|@+rxRyY6Z%x zotCD*_{8=(OPMQA$#sHQgA*nVvvU`1dC+mu4a+>Q$(okeIo?chZSuDK4$+!DGjA%N zK_^i6dxI4m(GfMS=<0cCS7UHP9=1k;v;F`eF9pl1QJF9A@>3OKdJ?DLr z!1;31wTQap8pH9^w3Dfct9$zgB-K-FexUxsT#EsO4j!VYw4DFw8f~HWb*ZJl6l;Y; z8suT!?gyk5YwyLAVA@?E)?{R$_A%wp5I8adMO12yxNT71emlvo?9Hrh1OuEC5e|yX zrIC?k<-l@wqVlN~c#<9+at@tDO@sXM+2Q9OqE?9iiSGlWjd>8t6&}GK0?fo7RtNq4Uk}1NyKUE^l=v&vq>s zM@0v}+a^P9F$q5^hb=pO5s0ZiN4MA=8gaceyIs9IVi4$u93O#SmLquWm3i!RTE&+$ zgcnuA!#i}%15O~{I)Skk`f)^hb=RUI$Kuf;4Xq!kNVYaPokk{G2Q)4Mv-9v7@%0rL z5VX1++PX&fNJ7h^=v~L++-f;1T26bAY~4pd2iMTp=skHRKTawSj1ErBvF*Q+5RB)r z$CC`VskP3CYT(x3orAanVU1~>si!HnN$O(W2$+DA5>@xr%gPmGb&2U!r_SQ)vp#9o zf6eNT8fG!?^_{9fu40)k~iOu*6k<7VAKsCE-LP~+Ak12I%^Zg_Mw@M2Xkzvzk&+Qs*Nut zAnJ)idOfG4^j9;PB+Yc!4z|Thm|33bG1xo(n??l^F?;1uV`|M7 zIqq-izmu>Gu|3(83iyOwr{0!%SkEkD^GZmr9ItkrcmM4x%!Hds|HS1(j>y<|Q6x@H z`LE~g7`*dfSYL>c=F}i(GU%6$-1++_5++e@^X&!8IJJ9{;7Y08NM1AIf-s8pq2LRj zc1WQCzsnl<^ezmprx#4XW-2(5o7Mj*W>dUfC!$@~aR?xVU}ct!(?25b-f1C`eWd+yIFdPL*w-JIhediUdsW!>%A9Qb zaVl3{GwCwtiee;uT>j(py12bVTeTXGVSbJh@)u&^g$NbwG;iwBu3;(WP) zCj)03u6;U{aDEy#nzBm3FGKOe_IAf!AVVcGER2;7)WGfs*S&zYyLspSW&Dfz?1%n) z!On29xg3iz>X*4PjyXsI>R5V+ljNCmGCq-H_kK{4Z&#lYBIoIkR z$s|QLyZ?h!R9N_4(dsoV3ouLUj(H`tjdg}aHrpU|CFKf}ssB_*emHug2PKK#kyVZK z6`#z;v7ZHgDg&V=rF7N#$|`|(ft}N*=Qp9+@&UfI+95eomnRlyX7`PB#9t#Yh zG@JpC5;TOLGPuV2GA+M3Z~svuN^`gZVl^G1f&El6X>x*LDaXd#vp^92*dF?eYRrww z|0a>$n?l$ur&DS8m`=hpVokUO*1>S$y$!vCv)L`fwi={r)cG4nl-_5&yN&Xwo@qUq=n{(E_Ug9}FoPQeY zeO)Rcvl5tMl_ka8thGy&N^l>9x?E8Is%2yHJnBjTEN0uN#*yF=S9>CA613Niu$P;k zA1@Xy-0jOW&$s;qE}+87{F!4*!WWIy7h!nV7RfP@N_SvPz$4o)X?N>53q;a7`vjX* zHfDQBhG4Bf*!3~5aTT-XPjIG9+8hg|trV5MD8n`vg3q)vc5ItLm&c34?8W9hddFA& zT82ZCkiv^4Qg>6{ygG9PRUE8qqk~bc@e2i<7TFL)(C&z%Ls0WMV{hD{q*VBJRa7uA z0Rfh!-d^YIAIr~ZU%r|A_~^eoWp+;)sj#jjH#Pmf)a;YqS-#9U%#V^jvM9^P`_syj zk8q(<0@HYx{J%=Efj3%&0^eS}q?;JE|87tt`F@)+sBiB7*%6It2+HRUD7hgOaIV9c?uDa3@@QX+<32hlrjsqG1Kkg;bv}9J&Ln- zF4669U)=5LpjP8^aGwZ>5jSQ#D~MK}2xT;p6V=PfBXRjRtxa4XI-zH+vKFLQ3#3lW zGtogVJd7?xc@#=*-&KuOdv_{O!9i ze9i8u_$ta7D{V`m+cvaP-o^o9(~2PwSMNl$qI0p4d< ze+ex`>00MJDvC2g2o~lnDcH!4Q=m#@_mp{OI$u|&iiXaTB(3+ma&?k?!tmS65yz)> z%;m8mlXS+V5Wv+gWdTfjCt5XK~h$S+^r?L^rcO156UMh8bwzqjfX`6O98rZDk#w^96= ztfsQI7;TaY?PkaEj%Lc+yx&ZaAAQJ>$r7~;k|eeO^QmG4Swx&ajfO~koaUSd%k`sz z6*knUKE2=N@`@&mf8$sc+Lo_SUyWor@;B-J^*xNcGKgRIQH-o8>iYu|T*-h?(NIr( zcGz;$B7%D(DA+1!w&0gzdbTNp=!)md8rBj?+eD?TQ_kb`QQ@q1W}Dye^wHHIr-QJ2>f&G!So&m$x*QQivTGwqdud zGw*f4M6FurFQZH<2O#xrG3y60QrMbLu^1T{v0b+{n;oU|siI@ss(W|T&Rk`utLa+! zNbD1K?o|xuh-P>iEQ6!eC&5528&lGS9x)ezfL^*qeH9Ky^lAzv$G>N`<5~{8_7qURxWRo@#}@`%`2L9gtTRt zQ}xxHt8{GA$E%}dxhwPrTpsh`R4}sp4A36Sm-YxPo+%`U)|~n`xLsMf>irf}Y|qH? z0Y(ZnoAipLe@he({$w}e@~v^$H={J&dbgaep`HWHus7~~gml@la7-zsn=7Zf0_*iR^B$|2oF zQ++@`?0X=38|KUh4UcRFEZueT#Tx zL`%Dl7WD3o=rs?@f>Aq6Kc(Mo11**)wp&=|CdYYj4OceQM=*0YLim?(RsfAjh3-s6 z0g^aBnaOeRoIHq8gJ%3XBvL_IIy}qsU`_f#hu`)3p~mCRu{qbD*PbHtP&?^lpJD!~ z^v%2N5|9r!UXX8Hd-&@BWBc2pnygvCW`$=ib}hSx&gFIjW?6SqjHE7{z?kE>4UKZT zyVI>f=Ps!XKEOuC6tI!ewe*HyjIc=w%s0A~*GKZk>%-;s5t+QC9-3N|lvG$DiN7K8 z=6#K?v9#Ox&l}1U81iJXN=m-K8BtG9Ul6~%stlSKy~#xQ?N%@n2ijZ51xVpcsR z@?`n2_168tf|yf!h7Acio_zsB9CLv4cT%85!i8C$Q{kIc}Y%!Sxj8A>^KwI1>SFCo^PcqC1KbWr{d+?Lz z8~G@}f=G4R@q5f(Y~B&kIl8ZBO*CW7!cI4eR!_wIoew^v#&~ysWD0@bn-O%rphFR; znw{rGT*6LRPeuw$`!OB4Pt(Qj816)RzB3Y0HL{Vb$g0%6AF1dE+)jSY5Xiv%SupFb|Jkgt z=lw^^1+3}U_Kr+Gn~WN;oR|V`eD9`g_OIJ|bJg>gQ`y8keHyf$2M#kzqZW^Owd!2^ z$QtYY5)r0nG9m#+%I{j}WLrZ^V~G4~zAG{YX5se$*}pt8=K;~dnAVc>gUaoFOr)@A zfF}m6e1*=#K>b-m1E)zemO&IP%NpGGBWnc!f#& zCJucT>FlV@uIfYdop`i(w{Lok8e5$I2L_x1$2Vtq2^Fbfr*V!+vcjj%_5;f1ODzH9 zZ9|S#1~=ba9eb6GgW#W{u?jo;cu2Pl(=VF4b)$I5=E5t}ZS@nPi$r&L zS3uSg8}y|qra)YX-2e&%lckowkE&F%2W-Y&fx2cxzgJ(PAs)oye;bSPZptlWVw`LA zxIGa+pC+uB<=n9sUKo@`*D;@oJ^(4>>@yq}tG2 zf9t<`Q-Mzu-!benOl<=}Lp7LeI{8T?qIySPz%7Errce9D_QF~7T(pmdvm|4OKO!g# zt6_DSV7yFZ%_<4weR>;8wt`vpjM}vRUO__`*vWh6q^U9T{wMPdJ1!}VjQ#$K#9%jWYMgwvbcD}Y46gFpN9)X9pXI}zZ%x8*( zCo+=g9_r7RZ(431+-u)QSZk~nRXL)un@{KVWh9CL1FkB^OkLUg~K~0f4F+yeha%t zYuaT4is23Pni6^6lI-B6I^iqQKXQ~oi;?t{mONc^)T+(0+OCfAE%e;ij^&HhdQMV{ zZdzg-i@p^#eJNY7SIw9CDQz8cN1@8TZ7r3Rs$Y{VP5xzh11s;SMKrRPbgS*XJZB%W9{YPw@eR`tV6(W#4k{;mez|SqY6? z_&**CNT|y>PWVIhZppuyKY@0MVG|i?bc-$veC~(tD|`@cWW8BsLR2k@= zW-Tgx=M-oo%=2b8G9&)!W16t=gk^7{o8$W7dKZByhDJ7%H{jb4j+~Sd*Iu)A!dPn3sJ;+%r2!nRq_~rH z68U3r1C$qoC9hRZl2nE(5Q(Tf>H8SN0sE5&_6nnc6ofyVhV`%=ZM;g0W;zY`7Q7-! zIAvPl#|~%n{C)j12WSWUcJ4cVi{QiUuy^cqMq7wKk`lzG`+ph64{p)|rAgoNx#7#( z`eXLG@7c)RbcQDUtbU&Nt8N9kVZ2>b@?{$Au2v&qxzmkx-{u?iUwkLyKb`AUNm z90EKry74@V50Ru1BagB88A9JJ>cJdJ4CcAS0OXu~I1-j|syB;c#Rtb(!uHlrJcZ}Ku}cDj8>Fd#fmqmf zou^asYajn|_CHt!#$_RyCR+$2Y9d(mAN)^<@X9pB*ZaOB8-km-Lpow<3lw5#3e-Pr zprZz$)wzc1um#goDNadhwX_9`ppjrV|L)8|$y>`V?y!4dmd ze)=IU@^pN&B`32(RxVNu=()Ewci%1AM5M@Zf?5FYl@4kk+C0#!o2eH?P8Qg)6JMp% z?q5H&(5$)M%XV!fy7zt0kf1BmP=B`^$^Tj6Dd{Oc&p_z?CaydxMNvQ$tdq8bTDQQi ze};TD^8OBjjzFwdB*slH{z+=*r#S78_R9B)xUWrwL5odSnJIVYwaUghL6|xJDs}1S zO5JIh185ex)B!9z;A^5+ij;lE=FUQi?!aI@c{bKHq7zMrF@x)5HOO>bjK~BPH_ftn zX4OI^<0q`Pc)s2`C+o#gEu%FRKEDrt{Z$Ss^Dh3QVEA>I_uEL+>7CT%CN)&5pW-tcVV`!pPMurer;_hUeq9hC;C*CfMT#JcSS!fkEh zn#RS8<@AQ<{Q2|w%k{BIHG&)|gH<{r+Y{{b+`oz*Bn&I)OqMduDXorXY2*`1d zTgR1T)+g; zp50vi(+G~*uRAm6YeX_$Np`$S>Tre2W4ft#1U-FyDLAKc_d8o}+;3R|T4!Z(ad1rc zyCUT$jE9FXdaNGV`N}U}5dl;4`8}`1CydTG9s&X1U5<;b^mJL@QSMBxu>XsliP1H; z{o)Vjewz#+TU%Q;;{|6$IgLy+X~CR5MRXToU6qy5;=;@fHZeFmX|fp1>8Wf)Vxcxqj|vJ4wbg$jDG zwtHPm06SDotT-PzrF3)|R|Y?8?5(QGLB*#y`Hc7FQbYsxOb2qscL0yc?doGzg2kDq zVCeeob|NsS+O`XkfSpKG1P#eLx~tfoN~V>Ik$Os_{yxcHn7Ll*`u;|OFC18RC~5I= z#QS6uM*{8IBn5kFw*xaRBDuS(9O+Wr^pFHy55LKJTFUuTQm?{=dLLsi5WD$gAp=29 zda>X{q~L#(tHME#*(T(sP)eW=WP)UNo8_}HoWe0?7%5G5VTzsHiY%SV7NAkXc9|XT z^jPi9@BF0g<|pc?oML_HX0tDBZyqxtC@c`$jwjWm9$i6Nyzt6 zpUBFL)w?!{>F^COv~=Q{fK7+675(2X09N`&{TbeUe1x$s2%Yd_?ieQU#M&7xxeZ*? z7QXSv)B*4OtF@$?Xwl~)W{S^h$oq4RVKf5V=^w3^(8xYg!|r-hwt*cFHa4D%O@Ve& zo(1#(tIX=>R6Gjkou@T9pr7w*sj-NZ%{9lMUQlF~0N#B)!oD^C@W}D%U|!87E6i1s z5ST4#IV*7N+PMh`<2K)w&zmhTc?912vl>EbOvj?dz7va2m8fy_W=*t0G`jM1=66D% zPXG4a&zxQ?ywBcZAThdoo(uh*?2kPK@OW0A{VNNgX;VKwS@$>-O&fkxG4 z>tX~q9r9iGzoH(2=EfFpQ_d6Iw??g79>1U`TC#2=cNKHF)~MH%+ieuGA}+c|U-X`i z!2h*-PqqXNUw|%lrwZPTzHwr;U2Os-zqcwy|4oh%=iQX0xcE857!lsKwlA$p-g-0; za!YEx^O$yz4X;Uekv`^CS%Cs9yKP3Vd`LGv#VORup&9mErS8Ic?ys|L{0w;>AbLOw z>n|>vs|C{BJk>miI(C5<_H#WctGjP}`Z=HD>@b{PxC9FSqpaY=pnB^hLY~2f2lwRS z?`mE5o=Wg^sg9_ebkdhZ0nYJsL688eUl70Gj#d3-uRe=1h_zvIZ$+L*d}8!Huu_Uw zs~~Zc9`lq=&t&Jefw~A;3z$M$)&R1T$JHuR<7?-u8|}qCzEFI3^cxj z?mNNQZ=^oOuD}9Qi`UbgP?c2(x{`0OGB&HsIIepMX|g+b($MS$(y|=#6z*TtB{6JNoWZIEx-G)E z=rP}=6od!HoM^v{bzEoL5eAJqdt@w0kxb7AM7D?7q(ITst+P`;_;vI%B=I?{hK6}+ zd!VkWVL_x^PJiOiarpm=I_tQozNe4FvfzRWODnl_ zhje#$2uLGHcXx__w4{J^cQ;6hw6vg%$QoS2#SXQjvguu{ub zRxJ6|Ms9pPBM0h2OOl_?PREMGPbvYivKLyp1BS09Fk*g`Vyp-6YS@@1S=6yX&4`5c#t$y;-#@`yd%V1c`h{D*wo*ZfXvkOe=6A54V3 z{A$AZ2J=yNE%hwD-;btAEr2@tVA`07@`)OKomxdHly^;8@Z%%{j?9kyOExyuD?Z*p z(x#FxH@5mr#1UqKAVKE#AiK6}GjXKdrAiiJ9*0hqOb0vyMAwh^i=yH(OzYuhOrW;; zuK^wDmt1`GK=|^%tk3vB_tF4r(NNiBrdJTxshU7)J!IZXSGXl?>3gJ&iBwe9IaO2p zsLV$8l~u}T;3)DeAB86l4~@C!mUe9i$PDV))tRV+^%dFrHnrmS-??-jxjTVO+ot&J z4~FV&24-juBS}IqUyNw!7XX!gr-gi}=X;ZR74uozp^x_uwL|}~gtzY1{MSLxmJJ>rK(`@#_@oE&sNB{Nt92iEkEvj_~;c%XJ$a$Wr@c z+dZF-2mp)0X)og_f%~f=!<34R6*lFZrbth0c;V(+!fWPbzQ~=aUe^}|%HL6uplR1w zNt46j<9ec_r!kbGw0O2Z_d=K5Ne+YHK;a3iR90yc_=mu*4S~a<2$N#SJ8O90Jx3O4 zctS8(zEDX^Z#ur>&^K4<=UYv65L(nq?Pfuu7Kg^zBfn3NjuPScG_4>e!S4Ii;M>|v z?<64hn4O04;=vr`Ui;bottxl!e|hozpeVDYt10#Eiq^w?96x^P_yB~Z61@07a#oq2 zo94O|uJ3bz6 zN!4`hg_m9(ocI%NV|~q`Vg10}6BW6ru!g6Af0lUN!Bq@N!gYjAlPe=pL{VpbEf)sr z!tCtW5qxgZQ#j5LPyIF*fLze?7WV+el8VF+3u`14d0YWf!9 zwFJn@m8V|rON#AEu;c64 zWOFk}!=>-^^vqaC1$P_X$Ngr4Pgzh78U~8y4$QAgYdu&&8R}QoY{@hXY=kIx(o#l~ z-=Cii4zaAT-1Q%&JG>sz;k4ZNlI&7Nlp$NsSmhOrspt*LC}V6{F3{adP*(}n_ijPa zj*O5$&f~fyT-$H51K0~I7oT8TX41E<(>AapQrj6)e+`0D`YWvRK>|u2l1640TAqLI)ffGjxYM7_b>+%>}wyMai$^jNx z0jx6GwE%~n0Njj7h>1$+uQ|Lh6H@<690sZ5HEPRHkVf6Ez80r7Bl? zH!cq*u^I?u=(doezWGI;dro>(9BY%Y4b1}r2aI&z1J9&kr>Ud2c@H@uZcd<=g_)w< z^B&ms7Qar`(#OTQKtAP#e(vV z6fZsXw0ABwD}S$0i7ousizBDF=v~p1ug0=yml(blw99?;XF_C zT)b8=P;lL`Ya?A<{ZfZXT^_9kjqV9|wf4UDIA?~bd`E$@@J%dm_ADzUWgsLKbRz=l zsmq8~mWA}tEE;zBQIZDWoindUMg}U=Sadm>+bHRZ;fe^ z^Vn{$PTa(+wv-oH5NHgOAE+1}A?uPqRkGOebgpl+o^#vJS8xXch+bwl>Uw+C3WHZY z&-s!z<=cN;#E~Sc)^3dS5Jx{?VgJd$D0f|X&!ncVE?@pR#1vWoL*ni!#zrpUWElkg z)waCR%nyCWz03)<2TgCFe9bpK#X?^&iOXqNJRu>$#u#V3^#UJvd^Mi>_f4eN{mt{O zoP&iT>zSv`vlu@9{{~z9h2Jb|;2>*ZXrH69!750ARNS(3|D387ezu8DsdA} z;y3-8C@XW^h>D-4{SDfx{gTp{J*hKwx|EjYmS*t5^22NS6Z3RuyY=feATUSpblAw= zYTK|rb_`7@gH~QWd1|`RQMoW0NHkh&cT0Ww4!sJB=znAI9^eG$U8%OaPQvS(ntDIe zXmPQ8*hQo76-?%y(5^R%(y>_E5b`Ca!4X$Xlj{0Me`ofO z*#I4zAniE_Ps?U_JEdG_BZXvG78ENs#*n-SKy__=p2^dJ|pfhH>y~gahafqU~K@T`D*x6t$Inhqry;m zN3ANOTxo&Nhq{@f-g*Xcy88jqWgDo#Yuzx{sr52lFByFBy*>Ma&O9+0yj#?m1?=mC z{TAXtsq@q{Y2;i4fHv`R=52;LGO#;^NXTz_gr;?_!gVAgf9xRbaXC*bWxEC(q4wT zesc;tpBfPif9F0-W z)5m(cL=k|RtaMS#XbQge+Aq|s+outmn3ynB#+U2V6Tr1`&AUc2Xwz;t?KhD#&M3Jv zB|a5&CjvoqA>rn0N&K*^lf;oss=U8q05BtR#QzG=IbQ`=>C4k>S%vs;`3kXoI78#t zefAH%LkNt=f}RQ-BnZ*$n^mK$q1~i*M=8c65MNXm<*vN%C7})ei^H*Dt8jNCCzgB! z6f|~P-)laRQA6`upWxqV+dbmxq+0Ph4Ko$uMjs60V)x31iYV1-$uA zgYoJwAKwc(n!Bb~_NtLCh;opoNYEUcrgZY5A_i;R1*19P-4=`RJQ97dmx%S`dSwot zzs)Htk{Hk6Aq@3daIzggSIc*?W!M2t|G+{@!gHI^YeF+t^nx0uG<1=7woo;vY`;S{evs}6+~1emWIy~ zn%OoTT=p8UTsW(3GW}oDxK`*>Lp=XA+7b~NbI*ueb9Sk+NtK;L1&DFl4;>%Nx+hvK zM{$V$+O!@OQk}W7I_IgDc3Vzt;W7S8X>9sT6_2Ye6rueub1Vyf$9(9O<5`oRrN!Lt zeJ@OhX3D!wCRy>XXEfBEgv&KRjV%A~Pw}?MzKVXb#@dp-I*XKA3(?r2U;g#1n-aDq z5;-(o;Ok{9`ZH z;wxuF^cRTioB&@@*CT5mBrGPOvkm^SVfnvW4xtSftAsMvf6YY1Kz9p1@-{&X?Y_n< zcBnlVyzl0oK3?T}@fj%bLKTqzqsaHfU|U#I<>FE&T5hsi9-cg6W7BJnBP9!@rfYxQ z04^hPW34KluC)nifjTB=-7&r2#-S%V`->k#W0MhB>fw1!@jotTxvEJw zAU{5YNI8II6OGojr2d%0(rL_+m56R@hq99X$Xp{K;_ynd!J|--@8mCgtBVEA8OF{1 z@+;fbDVph&Usf#|*Cp|(ovHH*Ma&mqF!tm+D;kSF@EJzqx!_`DD*MO4oA_QEZT+`8 zh=TqmTedB``ky^T4LZ1-DNxfH`KC)CMI8Na$m=Lo#59W1X?Q(jlB7&)*F8kFXr3)i zntIz{vOId$oowgw(nyRSI&8~-qVv+_?))!xjfDl}=#2j)pxfQgiSaVX4`;$A6V8d^ z6u*)1_AeePBJu?EL%`loAQsU6=)e2N^yWAFBrxfR(qK^kn@4rzFj}}w`4zf3m$jP= zLwwC#U=}I+`@iLqB=1xU!M|wmkN-M=BI+I{bH2LfZXPIY17B4K5Hsma+C7Ks(w=!q zNW6mlop&NyAid`YHH_{jg)Mxa#(2Q@JnAsR1>F#A(Cth?Jv0uB|{{$ zP|}ogfLPsK>>rrcCG8X;&nJRC$d55RuQ$2WlJMB9oT&NIJZ{N`_x7NDO0+ERD&|Hh@-m{)LL zaSA}qL;wr=n8ArZrD;t`L)H^%6^v;Aj!I`H7);k_)*Nqu9NP~l=TNL(EUC7g-oIU> z#Pex?;v`PJjht*M0 zJtWIIfE@~XeSfdgJJTjx5rMMtUn>a_#--#8AN1%#N#S+q+15)m`*{mtW2yA?U#ZjxEG+N}9(&s92EOV} zB=%XB!`ExdS(p+Vt2fcMr0XNxqD=UMg`%ryGRgYaXB%LhTG=GgQQ6LOg;eHqWj556kN&el$4CK@qyMHX`aUc97D^s2Xp~G`#(*``wn%frwvpjvz`u00Zy_I@A44X;@p4{Xye`AAbF6 zqXGwW%CP+!i=c4m#ojMs%;-~=rdYcUq-0_#@F?GVGav={z8pKcojfpWS0Iyd=de1W z)YT2?lmJ^r()@S4`hek^7xnATqla?7H;YP+$H%I3anqd)EMG+o{m&(*mK)cV36P#( z35@4bx@ETCF?$Ek|I@vUUzbP!PGqSKiO{w7`&3^j1;UgE!+|s0* zfI0Zer#D7;>?wdFP4t9vVqArndTIJ;N!JP?GH<7*i*T~^_w$%`oaZL;i$PjMPdCr) ziriJ`?n6okOkb>F*^$GJ*6|}O7l&A+SlQ0V07kiGb5Znlq20pR6WJ-}$pS?Vc+`vq zXC}&6ZIq7#qiG$lzA}ClF%_ba^?@Q(CMM zRGcQ)TWNk!CxZf#FEcimPIiHDnszmJx|Gw~7O@cK z24JBao;&eUO+hgb2!t#gm+HdiQFRmZSzj#V(cc5`Mq)KQ1CwxbR`?$Z{B$_nST(&t zJL7dgw!5f(8T(C{T0Omfuk?J2;e_~3ltD>Y2mFA)&VNZr{QA6OQ|J*pe0Gj%o(+Yj z87F+ModZHK!4rhObz}&lGa)8#G&Q|uS{V}9T(8^x-XM)@Yk?>ZNXxdRnjC`4b;=1` zccxN)EE69CS_C~Wt#p=ha>#Gowy|`oSER)?IUnf8xy-+aQbL| zVR}XC6G??2%AIuS-(Eg^=}jLb)}CEnAWPP{uL^eCyGln{@@}O1%whfWON*fwovEp7 zLGaE`ooHc~BiN%H)(n4 zr{MF%BrgdE6{Yc@`nPBTOxtbUdAL@7gWT##Val3ayy(EdhThudC4Sr?zP;(dTo7ot z-6d*eHNcMhA~p3vo${NXn(^qW{l?8f2#28RE(-9@o^}t=^FNycm>P=cz2gVM*IVML z@QvLhvn;y|>t0Z0hNb-=VRtIWvTzzFg=@1xL<1md@Vmy8-F8ENhmhM2R=;NZc9~C& z`>9Uzg7Xq=$7e%Z6Mg)mx;VMKDR_d3o#LZ?ngn|UpbN}+B7J>-%9eb|1PwP4_qd<- ztlO$p&KvG9D^GQ?TAjQyjweV=PJ3NxkPajq2Zqk4ua~fk_~71pHhccgs~tX;_=X&{ zw!3)0yFVB<*v;wCEo$N)tSbHhaHA8;KoYed>H0yMI5Si!+aDwL;$q4?MaG!eoSQuZ z4@5Eb!nj?Xsn>+eAjXWr3eVLe@kZTAXh% z9am{_g6ZLMvO3i!DSr)0<}(g!#x2AMvg^_gEFu)9dveXA2?SI=mg>GdBqE`pR(XGz zk$K)dgc;M<34t8hxngcMKO{;cilU;_s%?_yF!uB_dnWkx&^A` zG&6dnYJ~z7l<}T_g(L1hv3d`=HqV`34{s(iw%Z>F&eHYvqt8{B)TdoxdeBM+FUt|H zj0#s~7srz%@;xa83w!RU13Y+vlI%>KfW|ADF+^tmpF^ukNwp+3 zKRn8;NP_I9Q+P%7et8C-CK?_2J_MFhyuDKU@Fg>|57|5;>;Cpa7PoOBs9e90`8kP` za6W)RHBOZ!$7C(Ms-7zM)p2S#4-%K40aSdG&#wC)6NbSjxDhvWaRo5NS$_9D04Wx- zOS$dHM=Vs$qAM=90FaZ{rJ77pjNQYIK;H5@p##gK%o|AV1T!FOh}#?<#q%hZhMP7e zkEtW`B?Kq?QD$QIbOQjpnUly3TEU(`P!ZUV?O<98k@{*iP9z_~p~+^zkxiRd=9}B2 za_B&2G{9u@9*XG?W2aDi(yIk`+=U))=i_H4UzDiQ!JK1v606)7T`_>@sc2HHX-w@H zF1|qNqq^QNY)7X%s0-onLuyWrdUOJP1kQ)wzhJ~eg;nOG8G|Oa)|!-#s(@{@LH`RR_eFd3EaEei-U{p5WY71VW=`Zbf->4x>G z#pL&>@4WTZh2OqWwyZbI(NR%Nf7jL-L399qFaSgQ@izjP>obed(su#zUX$j2sLCvG zig`;>dk`R}D*XERqu5}|&!`E%PrmgYnCicoCyBIuErDkK>|&d z^7EdUY>f`=*PDp&=@Q&=%}*~K-|dZwFa0i`DCtpO2T6qn&Gz_Oju* z>TsmJ8?z&!Y<(&be^dmM5hL+d?m#YNdOvQV z9+-0%k}So|;ws_#BX3sy^f^NB*hYbHRAVaCS;rRUtKZ zeQ$p|TZ17ppZnp4j|vM_dUGdXt;R=)58#X~FZP`2;{E$fi4kR;$}3^^7gOEcf6p#_H?qKjvc8oYV>Q-edO<{wSDK;!g*%_Id>I znHUP1*s*7N=+~Q1-sg<&jD;l|fLPDYPU`C~9ZcqW+H&W~b>qi4u7Go;tr+ zc6>TNN4`VW-tmVI!1iXt=eR+aFj5dbGq!-C6BYP~_l(jkYvZ8eXBK-NgKw z^0zWU(+TDBxM~0THDgil6vekQVk=I%ZpX#+-8&W6kz<$N+vX~!rYbbsN>g6A_UkR( zA3u`OI72$eMwYj>4B}|&Wi185*r)fICNFH~w$dACCVqEx$PO%Ne3cs-+{#NaEPTnX z^!rkYm-!ZQBus`)A{$ZiKCo|Z2=u8Oh9KS;RD)z3oMvo(vbtRRWzgbDUal`%Iib$Q zOK)F&CaS_sjV82+aJtv(;sclc5fL$(qH(*NM=Oo`26P**k&)g^E#Fv?7$7{mKZ;Cf z&b90Lj>gM+greNFI{8ynW1-Cx+qcS3uzi$p+Q!1N05Q2NPMO*6DN0QKYJpO&M}EGc7CCm6-J&M~lifbQNc#xm3@VW7wh zxmkqEFgyorZyB(2#ta`{%!qGpJ(OjBAS&DpzYDwZ@-B{7^c_lK{ykA|x^y_#V4F|O z?>5G~7}8MKI)|g+DNQ7rD;-mC7X%^@u82j8Kr0R_9Pf)FRhIlL#{Hq1DqZHxwqr7f4>xj^D{E=^a(*i!gxI+w z+eDMvMKZ7B9ITT@BBxmg9>HQkfor$1TC4SSI1u_V9MTmuoL3sC^&{2I-K-h!lt<<2 zS?T~0#j4bRy+o2xAA`GwiJktiO-8`l=F>e5HamnS?9b^8S2tb0Xj|&yLSKMG6#rmj ze6-ilxLG1_ljl&0MtG**92c#p;_J-u?!`BTKgAYn?O9Yn06`MW$DZf-z3$IinB+0^ z`!Zl>be7oZ?RNZ+_+An#o*90^T|2X3z;%!HHOMKQtbLP|lyR59>gjx;5aNrL8%~mj z?y7{8DIDJbMc?Hr!dyf^K0Fn*U%H6Aijq>oKNTt4I~g+|yS2F(pkvEnxjgyB7bEMPAJ)uiCo13-xC^)$_@NK z60lq#LW5&HVvDzU_t=6izb;#4RNX?~W{IJlyaN~+F&!e)Qrj}&j}339au4i528B`~ zhzm24&pWUNwtSy8MH#>q@My~dF40D8hz563B-OCjm>$2^GRD(a0DFbw^XQ*+kJuK< zz0bg=jF!`ScJ>rRfVD-r%`1$<=&dEbANz$I@r747f~y@#v;<9D?5GhoLAo?zU79pP zTJPsRwb2ZtEw7&o9MiMG-#HStWUN86j8eNNX_O=(c33hCtzFa{EinjNq?m{{c%r=J{2It&deizNDMJ_B>v_)kfw zxBq0p-J|1!e*E9~unR8JyO* zytb#eooUhd#4RZS3HNGYyVmqbmo3^TPVUse*t75ENNCo7nmul#L8%NXRHFimf+2ZQ zM%ZvcJr(^|#mx0~V+3Fn8U*paei;Ttg|0$e7C!gqhzixM1+STva6%4NR+_0?6}npU z)%qu0K%b4diRt+6jDfL@L?40};kKC;VfG_}tHKu$CC3<%U$mGZH|p9^P8f_)+&px8 zezA3D4#NO#Q@{+5q6Y5{w4!;$o>M*v|w~qYuUbWvOtW>1q!bXgSHFS%ETR1IeIZE(r{JA0P{+96-sWSq&;) z&v%S(k>G~00v>nvcDZ}R412Z%-{;Qkfwc{@uR2u`|6W@(0E0mpI*=I=-f2rlc2geq z@db?a1u#tCKTtrXxNYxJ$)04a#?M8&Nr=gSz#$?5_+J4P_{eJw+# zBtx@p%ZCTtJ-%h}OTJ@Sl-HhT-+=`(D;khF3}0h-QSV^&cA12Kg@PJFq<|0-{c4#9 zi#VlsD8wj=7euW_~eNt>YspsX>irih}B9M zw;EuyPjTY>@~9l&R!va6B5yr9e>8Hi23aa1JYA||?%4g-Gp4V_){b3a8*Tv0^NBUI zzl~d@%o1t`uW<=A`Zy{|8fkc~X1POIV}RK#khC>G4h&axwNuvZr2w+8kMqt0rrp$yq+aIt8psRt_UGTJvHB@;e6=!UIgG1=V#Cwqod;rD@I*_^M!|GpW{5 z3{B$KF-=bp%AtgZznR}b)NG5!wT?9fG^9eY_#9JbW=fMO-y;&2v@phsmY5#V50^<{ z;`Tn($g)Re?vD`E0SRz9!jfR3P(_$0W2r^B{&(+gcqINv6oK0li!2gES#OWUjienX zxRalFw~8_hXIlv&q~aE$qUXlIdAN~9puD*iUw*ub^&C_!jkP=-_ z)vtGj?7zo7I#r^p7~y}@IGZW3rC^K5a;#n8xv;7(1P#@k!hSO)xi@>TlL2iY2nYIt z4e`ZItm?89E^078pOfY0B4JqMu18}tBQ9r2rR+t`_f|`VgY?e^S{=Vtu6iF=GGbUK zxVtxL*Jy+PMGaGwuVm20lkh1 z6K5_61}K^mLEQbFc5FgC(98~tKUh!Sj8`Ym28g!$t#0QDO zkO8m4`IB920PbcYHlZ7LX7cxMO@KSpoU7TF>zK7AzXVRwKWfGjR`!2NNpnCQXn^U% zzZ+6!O9{1`eWX_`t4G1xMCowz68fRVr^MWyxT_5EMTqofVE8C1q3{WaB$R*$h=rd zlQ?;okqW05Zr?26w3S^T+SOmiw0Bf4D42gVi>lfon&Bw)Rlac zmwg0knsIqpT-RcB7DR`dTEkNMb;63j=ss-yF}2q9L=$ZOT)sddVG?pARTa}Bj`op5 c1aJ>H;&fJ5{Z*>gh@M|f|*Vo zjDWeiK|Xpdm+?GNp7(+8sE@S%JDBW(Yv!JPpFMmcjwdT~3|tz<;Q290XCq*au8^DX zYYr#lx~!agLh^S@50@gow&Yeib{Yca=i71&?tCpT2?&^f?)!f(g-`QW#%;ZM-b20?CYksTKy=v2 z{4bGTKb5wNfBNw|!;N9i={gXA=+G1Id1Kz{UF)^#ng1Q?cR`r5n3HaKU0$cz z!=>-vYVq1gzOMrx3ds6dW4eGQ{+KVCVlijI{GTclZoO_B;ki~_-%D_9IWiw^+HmI{ zB<7rSx-ZE|F)rVf371~CwRmkL-+gV#hnkjmgPz}^@?n$oty1oJ5trrG+&p>@I7!oI z&3fH7!t-Qxi37eFKn~`*^H}RNuAg!7^=av8Qp9y~Yi=GL12<^;;Nx{W8L#z}yRW+f zv9}4s09k=gsb}7A7inwlW&Ap@Nzfx0wMhdU(+y@*3?+DO3-hw$LCy((4 z_0D|k18K*=8DV7C4d$FY`Tm@5dSZ-7x2nFcd{}+)z7cWE z2mijF@UD4Pz`dRK0`!Id?$i9gPkC|t#dAsDs{|sVlkxkzfSdQq7`JBA?&}L-JjYu! ze8WlhE&J@o^y}}FKdf}jzvB>J)`SMd_91&to{Yt7HG6*(V$7Q5J#Oc|)(3Q3jR9Y` z_)h)J($%3~um3A#m+{Z{YOe@&J?CJ~`I9;MoREmIi+OA|?LFXI0cG>oDClm7uQvog z@rjuIiqzNkYeSjuKOBEQQ~ok3;=Xb#9gWA!1jQaHxEi-+d5_yU2HqQ>cDx0%u9Mru z`#b%{etuQz{e7L6qXXDo_?{Pc#bz6YdV@-y#`Cp=njefi2G4Bk6IL0R%bFP+~6P~YrA%#D$ z-I&W})83EI3INx`hxzCJ^tlOqD!UIb|BktO#tW{^*^{r$e-^OzwYyo)<96o%pVha= zF~79{cT66w3j2aj#h7%zj0NW?bzYE?_oq_CW9C*mmLXt1maA}=6#R;K$DB5r_L_Wu z7<{rdY5tE7zQq2xugxm^fb=J!4*uF_p8frv$bBg*$pi?PlS@yvLUD+DM+SDc%Dn z+Lz7$>GCD!JWl^^n3VgW%_1rOBR=O=>&JHY*SbgT@4>ilP}g7`ue(OLF01SP^9s3ifDVvSrx!$bFfp?638L#!` zIhOcN?8 z{znS_#=Ksx%j&t0U#hcr!_ z58hK8MF)~vedMKMNB0STPe|?e-AbFJw|DsC#cJB&dlHMBJNZgsWr>s(Od~mPe_eAE<{+r+1LJu$3*}plu z%yroZNZ%Ujy8mF#x|2Crrqm+EdtLN#s`EQjSD@E$@Bde=s$l}6?&_xbGe z81Ncfr_8^S@;*1_+i~Eyh|l23a~R@&a;x>D`M*V7F=mlpe6*h%mHv9DXO3e(WA6V@ z^^m#FeU3tY4UX6EVig=O-4Jw*&fk`Tr}s|M#`!L#k#_QLfB43TvC6LZ9^Y&Et)Xu0 zqhrAB`&9=?+~+vNM=&?;&bNKKGQhHktvT?u)b-uI*|YiiL>Sln;X}NZKM)3>KJoW` zDRt}@b-iy~qclQY?=97gbQp&K*np+u!CZV$eJUpZ_?$MBTVCyma)F0#UzL?m9 zSI5F1D~(XsarbVe?IU#^2cK6Op9XU)B|8)O=i~G-B>@tGS~& zBBmaYG7kKE|G83WBp%CcE?2&J$Is77DPtb4qhyi>5HQZ4RGXM{(vAh*=dKEUI%a~| z)X7{Osn%bT?v(D3ULr-x*0RU#QTZ9tUzZ|@`y7X6kLH4BMR@RfFGH#EJagKorZMM^0q+CrL)Wg~_(XlRQ`c>Dj9T^E-CwP7Qhsd&y!K9375Mj>_a5LFxHxp-`-a** zrjnV4fMeiBIbPfY91l;c%=ccdKhx%!{4Gbo*VG;r^V@lGAMhUVU6t`0Ba&hu$6>Y{ zy{~^%6M}!g11MexwyJDNm^5vs>KabJD6tu<^Oc>XjR=^>L)7Q@rSR@`UyOkVRd$>d zftz;h1&mKW#FY0VC2I=xsq6aozh;9}Few7Yoo}l7jt1U+{V&D<KT^ z*}1rHa7{T!dbRW(Dg8bxjjuzD$@gDRNdHNCqx4cKu`yq2@!pX31S8Ve*)i}DH6sS# z0M5M!a3&_;gERIvDf&J zfV~vq+X^@UW3Ty`lQ^I9>!mM~BE>asJ}CPQ=~tzWACEz-(GUGnW~JO|k4arL?t^;Y zlU^Y8b)x8pijvfUfMei1)%D*Qf;afbF+dv593MPGen|QvDZ*YrU%oDUSm_s}w4<*w z4vYOyX2<bJB&mUbv0J6`Z%W|-eBs(Sn;YjlJ|0q?bEOv6~#wkcSu>!NWF1DJ>tOiPf?nCZu$dful1?sw3+^6 z-@pQy?J;2PU$42s54eGY*Td(OM!di0*5pU}bsNqXNq;P*f7beRuJ?&z1HYI*buN`6 zvpELL(aoACbN2Vs=I2r6Es!E!)45gOk^Vgf-;?nU@0U`>a=el5B=tUpPw$o@Gc5+- z3ZKEg7H?krt5oMXY0OEx_*b{p@$tjstyY@nF2?gXoy5O!AP!g$>!pa}IJY|YXq@dK z{1@{mb4+hmnmK#VC+$7(Mx~K<%pD*6F8&^+<8erLnmRUj$v1vmLTat0ymb1H=J{9U z%G;$IrAvZaF^8T9-)uZ81$)nzwD;yWDviW#^PI+y9uwcV&yL3--HGZo@s%)L;~UJ5 zI@vckH@;x{xb(!}sn@*uyg>QX@p_NbTSFW37R;tk9+P`b#&L|1?qoGKePQOFM=(3$ zWRBRUo|b|qvFrH#nbL2NBE*2}->WorJ;ylxPUR!*ny>rWq(0+uNO!V&Uwlk{E|Vh0 zFSn-u=ym-uxdN8lw-{4%OAM@&T24`dI`KO6Tz4veaj4j?x!T9RFs}WwpPhX6I_eLY zIF^Gstta!tbJ`E3;AkF=sqLSu>|`l&iX?sR}e&zZLWJ0`t0 z-XCCaJhz5Q>#ZG!cdM(3_@@kxQP#Zq_WZmL45j{6Q~%P058J*t0aD8^vyPp75rEBk6M8as1s-<@APyWO_n$5hAmj^J-u92R}+B-=P$5^$Q%Yk)a=g?!=O z9-N9i^IrFvP&N_Po>#k{`84!6FSMlwUaoW$QS#2W0;lK-?&L0B*R$xna{rA zzxn)v(yx|s-yi44b97wnRGoG|^Qp^mV!X~)E);(dZmnlN z?*n|xf$-eVx0hh+IT&Zh%_mfbIIeQ5y~o(^AE|46m`O2UUmug-3#EwXlv@Yq=yg=~ z%x51RqyEi>dql?ooD(CiJ5|qoWoS6Q`c(-3jz7m^C!f8pz>)u_H8LIid(68vK6u4z z+UbjMPC~30^Ed{Wi|bxXMTz4ox2EQ3-;Y%HephW=JDGcYv!8tPK3(sD{LJCsQDV&O z-{bOcsT48Zj)4=D_Z{gkq{Q)Oq=!fm*Uhb|J37uT*AVzWQ}zJk%e%8B0iJ_}Sr~3~ zjb5(|u=5&@alA5AHs@~Z*x}4`criv?Z>rD6jPd_ditoM_k?vHrkGy9$ww{Z!rd&MM z3XN3UI~|*>>sJO(%y;YC z(qQCxjPd(xDoR{8xBmYT-=~B3*c1Esd1W$(;c)I${(YUQwZF!5n~JpK?f8Hb@kk7y z_U%-q5o4QMoq2Tp@ho+p6y80LPK*JsH`X6A9T*$4+ciEI5d+?rzNR$dI=R)^N5}L^ zxw%W~IdvNU=Kf*%c(Cu6V+PGF-|q2!{%+}$(k;^Ix+m4pEs56=`(VMhfTgJ zoeb~uPn3F(;q2>FcD#1b?r=Hx=)l7wk0!``FmtQK>91*oPMEMX{|fwdcjQ#+%=tWzVk-nXx6ae20h2}brH6C4@?=~gBf+1r_5WHZ6I zoKLTBiprUw?9nKxPHrpFfS8llCJeCKd@nNezt$0YOj>NfAgjV89^x_0`^q~7uv?* zeU%Hx+0Rybmb;t?Q~Zy!wE?V&%N1UuHVDc-GaK1f9gj_e@XQE$Ntr!3PvMy5>}yHpQe|+Ztt`7)#c|l~ zp#Ije^4$aa3x@tNd$?yb9;%rmSLk1587t1RFAj9!?x^fpyQgo|P-3Lg9h)7J{y!4( BlhptK literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/platformio/data/www/index.html b/lib/PsychicHttp/examples/platformio/data/www/index.html new file mode 100644 index 0000000..76f14a9 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/data/www/index.html @@ -0,0 +1,236 @@ + + + + + + PsychicHTTP Demo + + + +

+

Basic Request Examples

+ + +

Static Serving

+

+ + +

+

Text File

+ +

Simple POST Form

+
+ + +
+ + +
+ +
+ +

Basic File Upload

+ + + + + + + + + + + + +
+ + + +
+ + + +
+ +
+ + +

Multipart POST Form

+
+ + +
+ + + +
+ + + +
+ + +
+ +

Websocket Demo

+ + + +
+ +
+ + + +

EventSource Demo

+ +
+ +
+ + +
+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/platformio/data/www/text.txt b/lib/PsychicHttp/examples/platformio/data/www/text.txt new file mode 100644 index 0000000..5375816 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/data/www/text.txt @@ -0,0 +1 @@ +Test File. diff --git a/lib/PsychicHttp/examples/platformio/include/README b/lib/PsychicHttp/examples/platformio/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/platformio/lib/README b/lib/PsychicHttp/examples/platformio/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/platformio/platformio.ini b/lib/PsychicHttp/examples/platformio/platformio.ini new file mode 100644 index 0000000..77a33bc --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/platformio.ini @@ -0,0 +1,30 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[env] +platform = espressif32 +framework = arduino +board = esp32-s3-devkitc-1 +monitor_speed = 115200 +monitor_filters = esp32_exception_decoder +lib_deps = + ; devmode: with this disabled make a symlink from platformio/lib to the PsychicHttp directory + ;hoeken/PsychicHttp + bblanchon/ArduinoJson +board_build.filesystem = littlefs + +[env:default] +build_flags = + -D CORE_DEBUG_LEVEL=ARDUHAL_LOG_LEVEL_WARN + ;-D ENABLE_ASYNC + +; [env:arduino3] +; platform = https://github.com/platformio/platform-espressif32.git +; platform_packages = framework-arduinoespressif32 @ https://github.com/espressif/arduino-esp32#master \ No newline at end of file diff --git a/lib/PsychicHttp/examples/platformio/src/main.cpp b/lib/PsychicHttp/examples/platformio/src/main.cpp new file mode 100644 index 0000000..eb52479 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/src/main.cpp @@ -0,0 +1,583 @@ +/* + PsychicHTTP Server Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. +*/ + +/********************************************************************************************** +* Note: this demo relies on various files to be uploaded on the LittleFS partition +* PlatformIO -> Build Filesystem Image and then PlatformIO -> Upload Filesystem Image +**********************************************************************************************/ + +#include +#include +#include +#include +#include +#include +#include "_secret.h" +#include +//#include //uncomment this to enable HTTPS / SSL + +#ifndef WIFI_SSID + #error "You need to enter your wifi credentials. Rename secret.h to _secret.h and enter your credentials there." +#endif + +//Enter your WIFI credentials in secret.h +const char *ssid = WIFI_SSID; +const char *password = WIFI_PASS; + +// Set your SoftAP credentials +const char *softap_ssid = "PsychicHttp"; +const char *softap_password = ""; +IPAddress softap_ip(10, 0, 0, 1); + +//credentials for the /auth-basic and /auth-digest examples +const char *app_user = "admin"; +const char *app_pass = "admin"; +const char *app_name = "Your App"; + +//hostname for mdns (psychic.local) +const char *local_hostname = "psychic"; + +//#define PSY_ENABLE_SSL to enable ssl +#ifdef PSY_ENABLE_SSL + bool app_enable_ssl = true; + String server_cert; + String server_key; +#endif + +//our main server object +#ifdef PSY_ENABLE_SSL + PsychicHttpsServer server; +#else + PsychicHttpServer server; +#endif +PsychicWebSocketHandler websocketHandler; +PsychicEventSource eventSource; + +//NTP server stuff +const char *ntpServer1 = "pool.ntp.org"; +const char *ntpServer2 = "time.nist.gov"; +const long gmtOffset_sec = 0; +const int daylightOffset_sec = 0; +struct tm timeinfo; + +// Callback function (gets called when time adjusts via NTP) +void timeAvailable(struct timeval *t) +{ + if (!getLocalTime(&timeinfo)) { + Serial.println("Failed to obtain time"); + return; + } + + Serial.print("NTP update: "); + char buffer[40]; + strftime(buffer, 40, "%FT%T%z", &timeinfo); + Serial.println(buffer); +} + +bool connectToWifi() +{ + //dual client and AP mode + WiFi.mode(WIFI_AP_STA); + + // Configure SoftAP + WiFi.softAPConfig(softap_ip, softap_ip, IPAddress(255, 255, 255, 0)); // subnet FF FF FF 00 + WiFi.softAP(softap_ssid, softap_password); + IPAddress myIP = WiFi.softAPIP(); + Serial.print("SoftAP IP Address: "); + Serial.println(myIP); + + Serial.println(); + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + WiFi.begin(ssid, password); + // Auto reconnect is set true as default + // To set auto connect off, use the following function + // WiFi.setAutoReconnect(false); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + + // We start by connecting to a WiFi network + // To debug, please enable Core Debug Level to Verbose + if (connectToWifi()) + { + //Setup our NTP to get the current time. + sntp_set_time_sync_notification_cb(timeAvailable); + sntp_servermode_dhcp(1); // (optional) + configTime(gmtOffset_sec, daylightOffset_sec, ntpServer1, ntpServer2); + + //set up our esp32 to listen on the local_hostname.local domain + if (!MDNS.begin(local_hostname)) { + Serial.println("Error starting mDNS"); + return; + } + MDNS.addService("http", "tcp", 80); + + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + //look up our keys? + #ifdef PSY_ENABLE_SSL + if (app_enable_ssl) + { + File fp = LittleFS.open("/server.crt"); + if (fp) + { + server_cert = fp.readString(); + + // Serial.println("Server Cert:"); + // Serial.println(server_cert); + } + else + { + Serial.println("server.pem not found, SSL not available"); + app_enable_ssl = false; + } + fp.close(); + + File fp2 = LittleFS.open("/server.key"); + if (fp2) + { + server_key = fp2.readString(); + + // Serial.println("Server Key:"); + // Serial.println(server_key); + } + else + { + Serial.println("server.key not found, SSL not available"); + app_enable_ssl = false; + } + fp2.close(); + } + #endif + + //setup server config stuff here + server.config.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + + #ifdef PSY_ENABLE_SSL + server.ssl_config.httpd.max_uri_handlers = 20; //maximum number of uri handlers (.on() calls) + + //do we want secure or not? + if (app_enable_ssl) + { + server.listen(443, server_cert.c_str(), server_key.c_str()); + + //this creates a 2nd server listening on port 80 and redirects all requests HTTPS + PsychicHttpServer *redirectServer = new PsychicHttpServer(); + redirectServer->config.ctrl_port = 20424; // just a random port different from the default one + redirectServer->listen(80); + redirectServer->onNotFound([](PsychicRequest *request) { + String url = "https://" + request->host() + request->url(); + return request->redirect(url.c_str()); + }); + } + else + server.listen(80); + #else + server.listen(80); + #endif + + DefaultHeaders::Instance().addHeader("Server", "PsychicHttp"); + + //serve static files from LittleFS/www on / only to clients on same wifi network + //this is where our /index.html file lives + // curl -i http://psychic.local/ + PsychicStaticFileHandler* handler = server.serveStatic("/", LittleFS, "/www/"); + handler->setFilter(ON_STA_FILTER); + handler->setCacheControl("max-age=60"); + + //serve static files from LittleFS/www-ap on / only to clients on SoftAP + //this is where our /index.html file lives + server.serveStatic("/", LittleFS, "/www-ap/")->setFilter(ON_AP_FILTER); + + //serve static files from LittleFS/img on /img + //it's more efficient to serve everything from a single www directory, but this is also possible. + // curl -i http://psychic.local/img/request_flow.png + server.serveStatic("/img", LittleFS, "/img/"); + + //you can also serve single files + // curl -i http://psychic.local/myfile.txt + server.serveStatic("/myfile.txt", LittleFS, "/custom.txt"); + + //example callback everytime a connection is opened + server.onOpen([](PsychicClient *client) { + Serial.printf("[http] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + }); + + //example callback everytime a connection is closed + server.onClose([](PsychicClient *client) { + Serial.printf("[http] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + + //api - json message passed in as post body + // curl -i -X POST -H "Content-Type: application/json" -d '{"foo":"bar"}' http://psychic.local/api + server.on("/api", HTTP_POST, [](PsychicRequest *request, JsonVariant &json) + { + JsonObject input = json.as(); + + //create our response json + PsychicJsonResponse response = PsychicJsonResponse(request); + JsonObject output = response.getRoot(); + + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (input.containsKey("foo")) + { + String foo = input["foo"]; + output["foo"] = foo; + } + + return response.send(); + }); + + //ip - get info about the client + // curl -i http://psychic.local/ip + server.on("/ip", HTTP_GET, [](PsychicRequest *request) + { + String output = "Your IP is: " + request->client()->remoteIP().toString(); + return request->reply(output.c_str()); + }); + + //client connect/disconnect to a url + // curl -i http://psychic.local/handler + PsychicWebHandler *connectionHandler = new PsychicWebHandler(); + connectionHandler->onRequest([](PsychicRequest *request) + { + return request->reply("OK"); + }); + connectionHandler->onOpen([](PsychicClient *client) { + Serial.printf("[handler] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + }); + connectionHandler->onClose([](PsychicClient *client) { + Serial.printf("[handler] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + + //add it to our server + server.on("/handler", connectionHandler); + + //api - parameters passed in via query eg. /api?foo=bar + // curl -i 'http://psychic.local/api?foo=bar' + server.on("/api", HTTP_GET, [](PsychicRequest *request) + { + //showcase some of the variables + Serial.println(request->host()); + Serial.println(request->uri()); + Serial.println(request->path()); + Serial.println(request->queryString()); + + //create a response object + //create our response json + PsychicJsonResponse response = PsychicJsonResponse(request); + JsonObject output = response.getRoot(); + + output["msg"] = "status"; + output["status"] = "success"; + output["millis"] = millis(); + + //work with some params + if (request->hasParam("foo")) + { + String foo = request->getParam("foo")->value(); + output["foo"] = foo; + } + + return response.send(); + }); + + //JsonResponse example + // curl -i http://psychic.local/json + server.on("/json", HTTP_GET, [](PsychicRequest *request) + { + PsychicJsonResponse response = PsychicJsonResponse(request); + + char key[16]; + char value[32]; + JsonObject root = response.getRoot(); + for (int i=0; i<100; i++) + { + sprintf(key, "key%d", i); + sprintf(value, "value is %d", i); + root[key] = value; + } + + return response.send(); + }); + + //how to redirect a request + // curl -i http://psychic.local/redirect + server.on("/redirect", HTTP_GET, [](PsychicRequest *request) + { + return request->redirect("/alien.png"); + }); + + //how to do basic auth + // curl -i --user admin:admin http://psychic.local/auth-basic + server.on("/auth-basic", HTTP_GET, [](PsychicRequest *request) + { + if (!request->authenticate(app_user, app_pass)) + return request->requestAuthentication(BASIC_AUTH, app_name, "You must log in."); + return request->reply("Auth Basic Success!"); + }); + + //how to do digest auth + // curl -i --user admin:admin http://psychic.local/auth-digest + server.on("/auth-digest", HTTP_GET, [](PsychicRequest *request) + { + if (!request->authenticate(app_user, app_pass)) + return request->requestAuthentication(DIGEST_AUTH, app_name, "You must log in."); + return request->reply("Auth Digest Success!"); + }); + + //example of getting / setting cookies + // curl -i -b cookie.txt -c cookie.txt http://psychic.local/cookies + server.on("/cookies", HTTP_GET, [](PsychicRequest *request) + { + PsychicResponse response(request); + + int counter = 0; + if (request->hasCookie("counter")) + { + counter = std::stoi(request->getCookie("counter").c_str()); + counter++; + } + + char cookie[10]; + sprintf(cookie, "%i", counter); + + response.setCookie("counter", cookie); + response.setContent(cookie); + return response.send(); + }); + + //example of getting POST variables + // curl -i -d "param1=value1¶m2=value2" -X POST http://psychic.local/post + server.on("/post", HTTP_POST, [](PsychicRequest *request) + { + String output; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + }); + + //you can set up a custom 404 handler. + // curl -i http://psychic.local/404 + server.onNotFound([](PsychicRequest *request) + { + return request->reply(404, "text/html", "Custom 404 Handler"); + }); + + //handle a very basic upload as post body + PsychicUploadHandler *uploadHandler = new PsychicUploadHandler(); + uploadHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + Serial.printf("Writing %d/%d bytes to: %s\n", (int)index+(int)len, request->contentLength(), path.c_str()); + + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + uploadHandler->onRequest([](PsychicRequest *request) + { + String url = "/" + request->getFilename(); + String output = "" + url + ""; + + return request->reply(output.c_str()); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + // use http://psychic.local/ to test + server.on("/upload/*", HTTP_POST, uploadHandler); + + //a little bit more complicated multipart form + PsychicUploadHandler *multipartHandler = new PsychicUploadHandler(); + multipartHandler->onUpload([](PsychicRequest *request, const String& filename, uint64_t index, uint8_t *data, size_t len, bool last) { + File file; + String path = "/www/" + filename; + + //some progress over serial. + Serial.printf("Writing %d bytes to: %s\n", (int)len, path.c_str()); + if (last) + Serial.printf("%s is finished. Total bytes: %d\n", path.c_str(), (int)index+(int)len); + + //our first call? + if (!index) + file = LittleFS.open(path, FILE_WRITE); + else + file = LittleFS.open(path, FILE_APPEND); + + if(!file) { + Serial.println("Failed to open file"); + return ESP_FAIL; + } + + if(!file.write(data, len)) { + Serial.println("Write failed"); + return ESP_FAIL; + } + + return ESP_OK; + }); + + //gets called after upload has been handled + multipartHandler->onRequest([](PsychicRequest *request) + { + if (request->hasParam("file_upload")) + { + PsychicWebParameter *file = request->getParam("file_upload"); + + String url = "/" + file->value(); + String output; + + output += "" + url + "
\n"; + output += "Bytes: " + String(file->size()) + "
\n"; + output += "Param 1: " + request->getParam("param1")->value() + "
\n"; + output += "Param 2: " + request->getParam("param2")->value() + "
\n"; + + return request->reply(output.c_str()); + } + else + return request->reply("No upload."); + }); + + //wildcard basic file upload - POST to /upload/filename.ext + // use http://psychic.local/ to test + server.on("/multipart", HTTP_POST, multipartHandler); + + //a websocket echo server + // npm install -g wscat + // wscat -c ws://psychic.local/ws + websocketHandler.onOpen([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + client->sendMessage("Hello!"); + }); + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) { + Serial.printf("[socket] #%d sent: %s\n", request->client()->socket(), (char *)frame->payload); + return request->reply(frame); + }); + websocketHandler.onClose([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + server.on("/ws", &websocketHandler); + + //EventSource server + // curl -i -N http://psychic.local/events + eventSource.onOpen([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + client->send("Hello user!", NULL, millis(), 1000); + }); + eventSource.onClose([](PsychicEventSourceClient *client) { + Serial.printf("[eventsource] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + server.on("/events", &eventSource); + } +} + +unsigned long lastUpdate = 0; +char output[60]; + +void loop() +{ + if (millis() - lastUpdate > 2000) + { + sprintf(output, "Millis: %d\n", millis()); + websocketHandler.sendAll(output); + + sprintf(output, "%d", millis()); + eventSource.send(output, "millis", millis(), 0); + + lastUpdate = millis(); + } +} \ No newline at end of file diff --git a/lib/PsychicHttp/examples/platformio/src/secret.h b/lib/PsychicHttp/examples/platformio/src/secret.h new file mode 100644 index 0000000..6d4bb15 --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/src/secret.h @@ -0,0 +1,2 @@ +#define WIFI_SSID "Your_SSID" +#define WIFI_PASS "Your_PASS" \ No newline at end of file diff --git a/lib/PsychicHttp/examples/platformio/test/README b/lib/PsychicHttp/examples/platformio/test/README new file mode 100644 index 0000000..9b1e87b --- /dev/null +++ b/lib/PsychicHttp/examples/platformio/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PlatformIO Test Runner and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PlatformIO Unit Testing: +- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html diff --git a/lib/PsychicHttp/examples/websockets/.gitignore b/lib/PsychicHttp/examples/websockets/.gitignore new file mode 100644 index 0000000..e37ccaa --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/.gitignore @@ -0,0 +1,8 @@ +.pio +.vscode/ +.vscode/.browse.c_cpp.db* +.vscode/c_cpp_properties.json +.vscode/launch.json +.vscode/ipch +src/_secret.h +lib/PsychicHttp/ \ No newline at end of file diff --git a/lib/PsychicHttp/examples/websockets/data/www/favicon.ico b/lib/PsychicHttp/examples/websockets/data/www/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..bdf785c1d706e64c1fa5cc305893a54d16c87fc7 GIT binary patch literal 67646 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 BlhptK literal 0 HcmV?d00001 diff --git a/lib/PsychicHttp/examples/websockets/data/www/index.html b/lib/PsychicHttp/examples/websockets/data/www/index.html new file mode 100644 index 0000000..c4ba4d9 --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/data/www/index.html @@ -0,0 +1,76 @@ + + + + + + PsychicHTTP Websocket Demo + + + +
+

Websocket Demo

+ + + +
+ +
+ + +
+ + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/websockets/include/README b/lib/PsychicHttp/examples/websockets/include/README new file mode 100644 index 0000000..194dcd4 --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/include/README @@ -0,0 +1,39 @@ + +This directory is intended for project header files. + +A header file is a file containing C declarations and macro definitions +to be shared between several project source files. You request the use of a +header file in your project source file (C, C++, etc) located in `src` folder +by including it, with the C preprocessing directive `#include'. + +```src/main.c + +#include "header.h" + +int main (void) +{ + ... +} +``` + +Including a header file produces the same results as copying the header file +into each source file that needs it. Such copying would be time-consuming +and error-prone. With a header file, the related declarations appear +in only one place. If they need to be changed, they can be changed in one +place, and programs that include the header file will automatically use the +new version when next recompiled. The header file eliminates the labor of +finding and changing all the copies as well as the risk that a failure to +find one copy will result in inconsistencies within a program. + +In C, the usual convention is to give header files names that end with `.h'. +It is most portable to use only letters, digits, dashes, and underscores in +header file names, and at most one dot. + +Read more about using header files in official GCC documentation: + +* Include Syntax +* Include Operation +* Once-Only Headers +* Computed Includes + +https://gcc.gnu.org/onlinedocs/cpp/Header-Files.html diff --git a/lib/PsychicHttp/examples/websockets/lib/README b/lib/PsychicHttp/examples/websockets/lib/README new file mode 100644 index 0000000..6debab1 --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/lib/README @@ -0,0 +1,46 @@ + +This directory is intended for project specific (private) libraries. +PlatformIO will compile them to static libraries and link into executable file. + +The source code of each library should be placed in a an own separate directory +("lib/your_library_name/[here are source files]"). + +For example, see a structure of the following two libraries `Foo` and `Bar`: + +|--lib +| | +| |--Bar +| | |--docs +| | |--examples +| | |--src +| | |- Bar.c +| | |- Bar.h +| | |- library.json (optional, custom build options, etc) https://docs.platformio.org/page/librarymanager/config.html +| | +| |--Foo +| | |- Foo.c +| | |- Foo.h +| | +| |- README --> THIS FILE +| +|- platformio.ini +|--src + |- main.c + +and a contents of `src/main.c`: +``` +#include +#include + +int main (void) +{ + ... +} + +``` + +PlatformIO Library Dependency Finder will find automatically dependent +libraries scanning project source files. + +More information about PlatformIO Library Dependency Finder +- https://docs.platformio.org/page/librarymanager/ldf.html diff --git a/lib/PsychicHttp/examples/websockets/platformio.ini b/lib/PsychicHttp/examples/websockets/platformio.ini new file mode 100644 index 0000000..4849f9e --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/platformio.ini @@ -0,0 +1,25 @@ +; PlatformIO Project Configuration File +; +; Build options: build flags, source filter +; Upload options: custom upload port, speed and extra flags +; Library options: dependencies, extra library storages +; Advanced options: extra scripting +; +; Please visit documentation for the other options and examples +; https://docs.platformio.org/page/projectconf.html + +[env] +platform = espressif32 +framework = arduino +board = esp32dev +monitor_speed = 115200 +monitor_filters = esp32_exception_decoder +lib_deps = + ; devmode: with this disabled make a symlink from platformio/lib to the PsychicHttp directory + ;hoeken/PsychicHttp + bblanchon/ArduinoJson +board_build.filesystem = littlefs + +[env:default] +build_flags = + -D CORE_DEBUG_LEVEL=ARDUHAL_LOG_LEVEL_WARN \ No newline at end of file diff --git a/lib/PsychicHttp/examples/websockets/src/main.cpp b/lib/PsychicHttp/examples/websockets/src/main.cpp new file mode 100644 index 0000000..a7c79b4 --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/src/main.cpp @@ -0,0 +1,225 @@ +/* + PsychicHTTP Server Example + + This example code is in the Public Domain (or CC0 licensed, at your option.) + + Unless required by applicable law or agreed to in writing, this + software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR + CONDITIONS OF ANY KIND, either express or implied. +*/ + +/********************************************************************************************** +* Note: this demo relies on various files to be uploaded on the LittleFS partition +* PlatformIO -> Build Filesystem Image and then PlatformIO -> Upload Filesystem Image +**********************************************************************************************/ + +#include +#include +#include +#include +#include +#include +#include "_secret.h" +#include +#include + +#ifndef WIFI_SSID + #error "You need to enter your wifi credentials. Rename secret.h to _secret.h and enter your credentials there." +#endif + +//Enter your WIFI credentials in secret.h +const char *ssid = WIFI_SSID; +const char *password = WIFI_PASS; + +//hostname for mdns (psychic.local) +const char *local_hostname = "psychic"; + +PsychicHttpServer server; +PsychicWebSocketHandler websocketHandler; + +typedef struct { + int socket; + char *buffer; + size_t len; +} WebsocketMessage; + +QueueHandle_t wsMessages; + +bool connectToWifi() +{ + Serial.print("[WiFi] Connecting to "); + Serial.println(ssid); + + //setup our wifi + WiFi.mode(WIFI_STA); + WiFi.begin(ssid, password); + + // Will try for about 10 seconds (20x 500ms) + int tryDelay = 500; + int numberOfTries = 20; + + // Wait for the WiFi event + while (true) + { + switch (WiFi.status()) + { + case WL_NO_SSID_AVAIL: + Serial.println("[WiFi] SSID not found"); + break; + case WL_CONNECT_FAILED: + Serial.print("[WiFi] Failed - WiFi not connected! Reason: "); + return false; + break; + case WL_CONNECTION_LOST: + Serial.println("[WiFi] Connection was lost"); + break; + case WL_SCAN_COMPLETED: + Serial.println("[WiFi] Scan is completed"); + break; + case WL_DISCONNECTED: + Serial.println("[WiFi] WiFi is disconnected"); + break; + case WL_CONNECTED: + Serial.println("[WiFi] WiFi is connected!"); + Serial.print("[WiFi] IP address: "); + Serial.println(WiFi.localIP()); + return true; + break; + default: + Serial.print("[WiFi] WiFi Status: "); + Serial.println(WiFi.status()); + break; + } + delay(tryDelay); + + if (numberOfTries <= 0) + { + Serial.print("[WiFi] Failed to connect to WiFi!"); + // Use disconnect function to force stop trying to connect + WiFi.disconnect(); + return false; + } + else + { + numberOfTries--; + } + } + + return false; +} + +void setup() +{ + Serial.begin(115200); + delay(10); + + //prepare our message queue of 10 messages + wsMessages = xQueueCreate(10, sizeof(WebsocketMessage)); + if (wsMessages == 0) + Serial.printf("Failed to create queue= %p\n", wsMessages); + + // We start by connecting to a WiFi network + // To debug, please enable Core Debug Level to Verbose + if (connectToWifi()) + { + //set up our esp32 to listen on the local_hostname.local domain + if (!MDNS.begin(local_hostname)) { + Serial.println("Error starting mDNS"); + return; + } + MDNS.addService("http", "tcp", 80); + + if(!LittleFS.begin()) + { + Serial.println("LittleFS Mount Failed. Do Platform -> Build Filesystem Image and Platform -> Upload Filesystem Image from VSCode"); + return; + } + + server.listen(80); + + //this is where our /index.html file lives + // curl -i http://psychic.local/ + PsychicStaticFileHandler* handler = server.serveStatic("/", LittleFS, "/www/"); + + //a websocket echo server + // npm install -g wscat + // wscat -c ws://psychic.local/ws + websocketHandler.onOpen([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u connected from %s\n", client->socket(), client->remoteIP().toString()); + client->sendMessage("Hello!"); + }); + websocketHandler.onFrame([](PsychicWebSocketRequest *request, httpd_ws_frame *frame) + { + Serial.printf("[socket] #%d sent: %s\n", request->client()->socket(), (char *)frame->payload); + + //we are allocating memory here, and the worker will free it + WebsocketMessage wm; + wm.socket = request->client()->socket(); + wm.len = frame->len; + wm.buffer = (char *)malloc(frame->len); + + //did we flame out? + if (wm.buffer == NULL) + { + Serial.printf("Queue message: unable to allocate %d bytes\n", frame->len); + return ESP_FAIL; + } + + //okay, copy it over + memcpy(wm.buffer, frame->payload, frame->len); + + //try to throw it in our queue + if (xQueueSend(wsMessages, &wm, 1) != pdTRUE) + { + Serial.printf("[socket] queue full #%d\n", wm.socket); + + //free the memory... no worker to do it for us. + free(wm.buffer); + } + + //send a throttle message if we're full + if (!uxQueueSpacesAvailable(wsMessages)) + return request->reply("Queue Full"); + + return ESP_OK; + }); + websocketHandler.onClose([](PsychicWebSocketClient *client) { + Serial.printf("[socket] connection #%u closed from %s\n", client->socket(), client->remoteIP().toString()); + }); + server.on("/ws", &websocketHandler); + } +} + +unsigned long lastUpdate = 0; +char output[60]; + +void loop() +{ + //process our websockets outside the callback. + WebsocketMessage message; + while (xQueueReceive(wsMessages, &message, 0) == pdTRUE) + { + //make sure our client is still good. + PsychicWebSocketClient *client = websocketHandler.getClient(message.socket); + if (client == NULL) { + Serial.printf("[socket] client #%d bad, bailing\n", message.socket); + return; + } + + //echo it back to the client. + //alternatively, this is where you would deserialize a json message, parse it, and generate a response if needed + client->sendMessage(HTTPD_WS_TYPE_TEXT, message.buffer, message.len); + + //make sure to release our memory! + free(message.buffer); + } + + //send a periodic update to all clients + if (millis() - lastUpdate > 2000) + { + sprintf(output, "Millis: %d\n", millis()); + websocketHandler.sendAll(output); + + lastUpdate = millis(); + } +} \ No newline at end of file diff --git a/lib/PsychicHttp/examples/websockets/src/secret.h b/lib/PsychicHttp/examples/websockets/src/secret.h new file mode 100644 index 0000000..6d4bb15 --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/src/secret.h @@ -0,0 +1,2 @@ +#define WIFI_SSID "Your_SSID" +#define WIFI_PASS "Your_PASS" \ No newline at end of file diff --git a/lib/PsychicHttp/examples/websockets/test/README b/lib/PsychicHttp/examples/websockets/test/README new file mode 100644 index 0000000..9b1e87b --- /dev/null +++ b/lib/PsychicHttp/examples/websockets/test/README @@ -0,0 +1,11 @@ + +This directory is intended for PlatformIO Test Runner and project tests. + +Unit Testing is a software testing method by which individual units of +source code, sets of one or more MCU program modules together with associated +control data, usage procedures, and operating procedures, are tested to +determine whether they are fit for use. Unit testing finds problems early +in the development cycle. + +More information about PlatformIO Unit Testing: +- https://docs.platformio.org/en/latest/advanced/unit-testing/index.html diff --git a/lib/PsychicHttp/library.json b/lib/PsychicHttp/library.json new file mode 100644 index 0000000..e732d31 --- /dev/null +++ b/lib/PsychicHttp/library.json @@ -0,0 +1,53 @@ +{ + "name": "PsychicHttp", + "version": "1.2.1", + "description": "Arduino style wrapper around ESP-IDF HTTP library. HTTP server with SSL + websockets. Works on esp32 and probably esp8266", + "keywords": "network,http,https,tcp,ssl,tls,websocket,espasyncwebserver", + "repository": + { + "type": "git", + "url": "https://github.com/hoeken/PsychicHttp" + }, + "authors": + [ + { + "name": "Zach Hoeken", + "email": "hoeken@gmail.com", + "maintainer": true + } + ], + "license" : "MIT", + "examples": [ + { + "name": "platformio", + "base": "examples/platformio", + "files": [ + "src/main.cpp" + ] + } + ], + "frameworks": "arduino", + "platforms": "espressif32", + "dependencies": [ + { + "owner": "bblanchon", + "name": "ArduinoJson", + "version": "^7.0.4" + }, + { + "owner": "plageoj", + "name" : "UrlEncode", + "version" : "^1.0.1" + } + ], + "export": { + "include": [ + "examples/platformio", + "src", + "library.json", + "library.properties", + "LICENSE", + "README.md" + ] + } +} diff --git a/lib/PsychicHttp/library.properties b/lib/PsychicHttp/library.properties new file mode 100644 index 0000000..885afb5 --- /dev/null +++ b/lib/PsychicHttp/library.properties @@ -0,0 +1,11 @@ +name=PsychicHttp +version=1.2.1 +author=Zach Hoeken +maintainer=Zach Hoeken +sentence=PsychicHttp is a robust webserver that supports http/https + websockets. +paragraph=This library is based on the ESP-IDF HTTP Server library which is asynchronous, does http / https+ssl and supports websockets. +category=Communication +architectures=esp32 +url=https://github.com/hoeken/PsychicHttp +includes=PsychicHttp.h +depends=ArduinoJson,UrlEncode \ No newline at end of file diff --git a/lib/PsychicHttp/request flow.drawio b/lib/PsychicHttp/request flow.drawio new file mode 100644 index 0000000..8915583 --- /dev/null +++ b/lib/PsychicHttp/request flow.drawio @@ -0,0 +1 @@ +7Vxbd5s4EP41Pmf3wTkgAcaPza3Zbq/bbNM+yiAbNhi5ICd2f/0KIxmQFIypsZ1jpw+1hBCS5pv5ZgaJHryaLt4maBZ8ID6OesDwFz143QPANIDD/stqlnnNwIJ5xSQJfd6oqPga/sLiTl47D32cVhpSQiIazqqVHolj7NFKHUoS8lxtNiZR9akzNMFKxVcPRWrtQ+jTIK91waCov8PhJBBPNp1hfmWKRGM+kzRAPnkuVcGbHrxKCKH5r+niCkfZ4ol1efhr+RC9f3TevvuS/kT/Xv59//FbP+/sdptb1lNIcExbd+0/B97S/uJ9MrxvX76P0/f9+Gff5MvwhKI5XzA+WboUK5iQeezjrBezBy+fg5DirzPkZVefGWZYXUCnEb+8XiSDFcYkphwRbL3ZRXZbGE9Y0c6uhlF0RSKSrB4Dx3b2j99Vqs//srtpQh5x6Yqz+mNXGq4PX8cnnFC8KKGDr9dbTKaYJkvWRFwVIObYN21efi6QZA95XVBCkevwSsTRO1n3XUiI/eBC0gvsevkufbie3t/Yd9blDfz0bvHQ70NzG4EZVeH8hyldcoGgOSWsiiQ0IBMSo+g9ITPeriQ3Myvj2H+TqSIrjyLiPeZVt2E29NUzWIm3d9eCEtqmoCJCIxxdIu9xshqoEGhMYpx15TP15XMpBndT1LKHsYX8nnV2YYvij/VAWOF6USktRWkR0tJtrPSDDy/7XdyUFcQ9KUUJFXPnI9wObSmZJx6uUUEuP/agCaZ1kueQyhaoFrwJjhANn6r2TwdEfutnErKJrEEPbFgBPRyCahf5jPhdZYOzoSPbkDrKp6x0tNKL9XwaqYpWAODkNaU9UrXtoIpUbTtn10BtajHrRl2Cwd39/WdW8w/+Occp/T2+KwOAzfFyEqE0XRuPWulK/Ocj7I49Lc95Lh6Nu+Q5t6qpQGhqiedMoOE5awc0p52CpQjtB3MiT0x92xLdjtXeaaj2ptlQ7znq+sYFgIZbQV7f5N53WxITTch4nOJ6foKGdVB+shWMfyQKxDej5FUrQTdQ3YhA4c8b+wObVTWxljHYK9gcBWw3sT/jY/yAqBdkELpVTWxApqN52iLwu0XTMMpme4ejJ0xDD2noEkXhJGYFj8kfJ3o0rYNGpyjdr9DLaEINI8dj4Glp1HdGjt1puDiUPGdnoNKooQsXu6JRU40WP6dLLwi9OxT7EVvxs/MjOz+2uUfnRxvpaaR2it5Pi3B9/x6TXoCamH5XLpMNoC25TPtjMcuQWAxILNY2N2ANm9EhwydalpqtGCzVTErQrmSSLRfUj0um6Wp79iMfQVturoVLSd9XjJyxHnAiBqDLEbPUzoSuoOqgaWaH41Ga/ScM+Zm7f4sFZP9sr9ytR4WauLjGYzSPMrgWztvJ87cle12udWE3ZHC7K9mp+YvTi+0KMq5QccHMOyHjjXlzoUdHGBRam4LCpnQKZTo1O4su9Wus5jLOHuur8lib5vZbeKyOpST5Duix2m1VTNJVW3Z9d+Sx2rIqH6XHqqaTPuJnVnGV7+IISax1SA/jnBwyJSS/WXEbJhdAZ26luuMjxQmb0QWJP81wnAkRRdGImcFjkZ9vY9e3dPJzwQh2ugMEwqrpAoODJ4eGivxUx7KgRS9b9dCriqbKw4K2zBJpFRS2iba69O0205bm3VQt6jfSVnlnj0as9m8y1xpWktEWsNqalVw5ISN11LHjB9QgtUQBzJREJH3hxcLJc4Fra1IMe+UCoIapQZ5OYmSwEp2af1qTxQvXBXnUef8nwx6Sb+ZCt2lqQnZTdydzNVQ7Xf4AmrCnVlOOlD9Mw2ob1khGadgwEb8rAhG7GktwvA3jMA2OxXyMXQ/rCWPk2pa9PSjbE8YQNCSMzpxPCGoIg0cPPaC8o0hn2AvHzIoAwzvTw4v0MBCm+HDyVd25kyAH7cZstyE3CKU4Fm4wq6hybPNiWP5rSRTWVt3ujja0smmA0y6Tzes3HK9ub2ibHHV7vapNIZcVq+5kROcHHuTMrt0yGJc7GkCwV6VQXSnGdRQnf/yZ0fI5Bte4VPY+87H6E3iK0DwU55s6znJ7UW4OPLTcVE+YcUnAph16iJ5FVyO6g6ucmvVK8qNAbwoJhiTOZHgc0sMmi1IGOukNnQFE+4xRtNKzzD1K70TzV03PjtYh/kgjlIHV0uFSAmi5o44dLleBYp4N4ScLzwZEY/4HB2du9QVqgtMZiVN8kTLLcZaaRmpu00MR3fnJanRzULu/r+1adfZ8o90fHrfdbxtoy9sdlY52tRdLvPYRzg//FMJL45LbD7bcuzXY8d4tvSKpkcvpKpKhKlLtEY1j1ST56HJTTbLEkQaxed6W7PeONMmxqs8RX815aVxyewjr28vnfKT2HWnSkb0tOagmNd6Of9ya5LTXJAmBg272B8uaIcqvW5PUlIw4p0zprFf6VotxGzFlkrWMebW0qldVl5m/Vin717xKOcSW+cihh6I3/MI09P3VGxed21/VXuVzZ8q30PiIre10r7nbDiTh6T7kAsUOj7I2we3ddlYsvn2XA6H4giC8+R8=7Vtbc5s4FP41ntk+tGMQAvyYOLdNp9NOvTttn3ZkkDGNQA7It/z6FUayBcK3xNhMA34I5+iCdL5P5xwJ0gH9aHGfoMn4C/Ux6Zhdf9EBNx3TNLqmzf9kmmWucSyQK4Ik9EWljWIQvmDZUminoY/TQkVGKWHhpKj0aBxjjxV0KEnovFhtREnxqRMUYE0x8BDRtT9Cn41zrWs6G/0DDoOxfLJh9/KSCMnKYibpGPl0rqjAbQf0E0pZfhct+phkxpN2ue69/J493t0Yzy/92Xf/3v3nKviYd3Z3TJP1FBIcs9N2beZdzxCZCnuJubKlNGBCp7GPs06MDriej0OGBxPkZaVzThmuG7OIiOK1jbpcGNGYCUJwc/NC3iyMAy7CrDQkpE8JTVaPASOY/UQrRZ9fWWuW0CeslNiri5dEdIaGq+FmQ0hwGr6oMmWIKTInOFZl7IeqKHioaA60vkBphhOGFwr3BBr3mEaYJUteRZTyueVNxMoCUBBtvuEpsIVurHDUcoQSibURrPve4M9vBAWOoENPo8MPPHxAsU9w8jZiKFwwuE2uA4LSVPAkR1auTp1GRaL4CLsjr5IQnouHozoRc7sFxCwANcQMswqxugCTA1AQE3Clq2HxUZndPiJkiLynVIOQz5uVFnDBqDGNcQkBoUIkDGIuetzEnBvgOrNiyN3ulSiIQt/PHlNJjA11yn4CVjoRMWKrNmANWFyKbsVS7Dk6sOAEwBqfH8jEnz7+9yv4m4HH5+gruhe+XMWVxt/x8xSn7K8PjVmKELu+VbUUXXMIVr65LsQsGcDlUrQOXIpmXYgZGmIaTDj2r7KUJls3mdFDr4hMcVlwiyXLn6rwKxM+QSneLNTCm6WUFiH7KYMbv1dacWnTKBNkm+NgSuk08fD+OMJQEmC2w2YCC+wXcjgddAVUWIGp1CWYIBbOiplfFdDiCd9oyKercKrk3iEsdpHPW7RSU61yR3axI2Bbn3rqVew2N5PW7YqFayO8nph6jseD+oB6T5i1oX1baLfNM4b2SthARQT4OsFx6/4r3L/dvbT7tyrguktQhFu8qvA6NHOuDS89caZxn9C0xasSL/vSeNnvM73aFdH3pldWs9IroxhiofHa9Ao4uzuqOaFymkLF42i1ly6gWXTpljIy60R0sctp/Ra6cADRUqk2ySqkh/NbDnjruMr1jUJ9fpOP4KTcdf9Q7sJ3wl2zodx1zsBd/XT63wmhyG93sdt2sevIeLFdrORJe5B5YKYNL3+Q+U5PMnf5nL3xR/K8KQGodJQJwYmOMi3rNUeZbw1HcviHhiMIzxCODLPCteURqfVsVZ7t4md0hn5IdyHPdpzN93sfs1nep3sq71Pe6dvnSX+P9jfn2LoZ+pHl7YzzZ5DHsKY4nOZkv845P8+ohkw/tWxf4mwNEM6h79zqCxD68Uj7VmAHYBd/K2Dq28s/JKLbjY7ozqs/jQBbKFRzRHfgcRHdAWeI6GZjdtqnZq/7TthbTmybwt63HcdycfNZe159888B4PZ/ \ No newline at end of file diff --git a/lib/PsychicHttp/src/ChunkPrinter.cpp b/lib/PsychicHttp/src/ChunkPrinter.cpp new file mode 100644 index 0000000..b3f8713 --- /dev/null +++ b/lib/PsychicHttp/src/ChunkPrinter.cpp @@ -0,0 +1,85 @@ + +#include "ChunkPrinter.h" + +ChunkPrinter::ChunkPrinter(PsychicResponse *response, uint8_t *buffer, size_t len) : + _response(response), + _buffer(buffer), + _length(len), + _pos(0) +{} + +ChunkPrinter::~ChunkPrinter() +{ + flush(); +} + +size_t ChunkPrinter::write(uint8_t c) +{ + esp_err_t err; + + //if we're full, send a chunk + if (_pos == _length) + { + _pos = 0; + err = _response->sendChunk(_buffer, _length); + + if (err != ESP_OK) + return 0; + } + + _buffer[_pos] = c; + _pos++; + return 1; +} + +size_t ChunkPrinter::write(const uint8_t *buffer, size_t size) +{ + size_t written = 0; + + while (written < size) + { + size_t space = _length - _pos; + size_t blockSize = std::min(space, size - written); + + memcpy(_buffer + _pos, buffer + written, blockSize); + _pos += blockSize; + + if (_pos == _length) + { + _pos = 0; + + if (_response->sendChunk(_buffer, _length) != ESP_OK) + return written; + } + written += blockSize; //Update if sent correctly. + } + return written; +} + +void ChunkPrinter::flush() +{ + if (_pos) + { + _response->sendChunk(_buffer, _pos); + _pos = 0; + } +} + +size_t ChunkPrinter::copyFrom(Stream &stream) +{ + size_t count = 0; + + while (stream.available()){ + + if (_pos == _length) + { + _response->sendChunk(_buffer, _length); + _pos = 0; + } + + size_t readBytes = stream.readBytes(_buffer + _pos, _length - _pos); + _pos += readBytes; + count += readBytes; + } + return count; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/ChunkPrinter.h b/lib/PsychicHttp/src/ChunkPrinter.h new file mode 100644 index 0000000..f63fac0 --- /dev/null +++ b/lib/PsychicHttp/src/ChunkPrinter.h @@ -0,0 +1,27 @@ +#ifndef ChunkPrinter_h +#define ChunkPrinter_h + +#include "PsychicResponse.h" +#include + +class ChunkPrinter : public Print +{ + private: + PsychicResponse *_response; + uint8_t *_buffer; + size_t _length; + size_t _pos; + + public: + ChunkPrinter(PsychicResponse *response, uint8_t *buffer, size_t len); + ~ChunkPrinter(); + + size_t write(uint8_t c) override; + size_t write(const uint8_t *buffer, size_t size) override; + + size_t copyFrom(Stream &stream); + + void flush() override; +}; + +#endif \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicClient.cpp b/lib/PsychicHttp/src/PsychicClient.cpp new file mode 100644 index 0000000..fd7820d --- /dev/null +++ b/lib/PsychicHttp/src/PsychicClient.cpp @@ -0,0 +1,72 @@ +#include "PsychicClient.h" +#include "PsychicHttpServer.h" +#include + +PsychicClient::PsychicClient(httpd_handle_t server, int socket) : + _server(server), + _socket(socket), + _friend(NULL), + isNew(false) +{} + +PsychicClient::~PsychicClient() { +} + +httpd_handle_t PsychicClient::server() { + return _server; +} + +int PsychicClient::socket() { + return _socket; +} + +// I'm not sure this is entirely safe to call. I was having issues with race conditions when highly loaded using this. +esp_err_t PsychicClient::close() +{ + esp_err_t err = httpd_sess_trigger_close(_server, _socket); + //PsychicHttpServer::closeCallback(_server, _socket); // call this immediately so the client is taken off the list. + + return err; +} + +IPAddress PsychicClient::localIP() +{ + IPAddress address(0,0,0,0); + + char ipstr[INET6_ADDRSTRLEN]; + struct sockaddr_in6 addr; // esp_http_server uses IPv6 addressing + socklen_t addr_size = sizeof(addr); + + if (getsockname(_socket, (struct sockaddr *)&addr, &addr_size) < 0) { + ESP_LOGE(PH_TAG, "Error getting client IP"); + return address; + } + + // Convert to IPv4 string + inet_ntop(AF_INET, &addr.sin6_addr.un.u32_addr[3], ipstr, sizeof(ipstr)); + //ESP_LOGD(PH_TAG, "Client Local IP => %s", ipstr); + address.fromString(ipstr); + + return address; +} + +IPAddress PsychicClient::remoteIP() +{ + IPAddress address(0,0,0,0); + + char ipstr[INET6_ADDRSTRLEN]; + struct sockaddr_in6 addr; // esp_http_server uses IPv6 addressing + socklen_t addr_size = sizeof(addr); + + if (getpeername(_socket, (struct sockaddr *)&addr, &addr_size) < 0) { + ESP_LOGE(PH_TAG, "Error getting client IP"); + return address; + } + + // Convert to IPv4 string + inet_ntop(AF_INET, &addr.sin6_addr.un.u32_addr[3], ipstr, sizeof(ipstr)); + //ESP_LOGD(PH_TAG, "Client Remote IP => %s", ipstr); + address.fromString(ipstr); + + return address; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicClient.h b/lib/PsychicHttp/src/PsychicClient.h new file mode 100644 index 0000000..b823df7 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicClient.h @@ -0,0 +1,35 @@ +#ifndef PsychicClient_h +#define PsychicClient_h + +#include "PsychicCore.h" + +/* +* PsychicClient :: Generic wrapper around the ESP-IDF socket +*/ + +class PsychicClient { + protected: + httpd_handle_t _server; + int _socket; + + public: + PsychicClient(httpd_handle_t server, int socket); + ~PsychicClient(); + + //no idea if this is the right way to do it or not, but lets see. + //pointer to our derived class (eg. PsychicWebSocketConnection) + void *_friend; + + bool isNew = false; + + bool operator==(PsychicClient& rhs) const { return _socket == rhs.socket(); } + + httpd_handle_t server(); + int socket(); + esp_err_t close(); + + IPAddress localIP(); + IPAddress remoteIP(); +}; + +#endif \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicCore.h b/lib/PsychicHttp/src/PsychicCore.h new file mode 100644 index 0000000..fe88b38 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicCore.h @@ -0,0 +1,107 @@ +#ifndef PsychicCore_h +#define PsychicCore_h + +#define PH_TAG "psychic" + +//version numbers +#define PSYCHIC_HTTP_VERSION_MAJOR 1 +#define PSYCHIC_HTTP_VERSION_MINOR 1 +#define PSYCHIC_HTTP_VERSION_PATCH 0 + +#ifndef MAX_COOKIE_SIZE + #define MAX_COOKIE_SIZE 512 +#endif + +#ifndef FILE_CHUNK_SIZE + #define FILE_CHUNK_SIZE 8*1024 +#endif + +#ifndef STREAM_CHUNK_SIZE + #define STREAM_CHUNK_SIZE 1024 +#endif + +#ifndef MAX_UPLOAD_SIZE + #define MAX_UPLOAD_SIZE (2048*1024) // 2MB +#endif + +#ifndef MAX_REQUEST_BODY_SIZE + #define MAX_REQUEST_BODY_SIZE (16*1024) //16K +#endif + +#ifdef ARDUINO + #include +#endif + +#include +#include +#include +#include +#include "esp_random.h" +#include "MD5Builder.h" +#include +#include "FS.h" +#include + +enum HTTPAuthMethod { BASIC_AUTH, DIGEST_AUTH }; + +String urlDecode(const char* encoded); + +class PsychicHttpServer; +class PsychicRequest; +class PsychicWebSocketRequest; +class PsychicClient; + +//filter function definition +typedef std::function PsychicRequestFilterFunction; + +//client connect callback +typedef std::function PsychicClientCallback; + +//callback definitions +typedef std::function PsychicHttpRequestCallback; +typedef std::function PsychicJsonRequestCallback; + +struct HTTPHeader { + char * field; + char * value; +}; + +class DefaultHeaders { + std::list _headers; + +public: + DefaultHeaders() {} + + void addHeader(const String& field, const String& value) + { + addHeader(field.c_str(), value.c_str()); + } + + void addHeader(const char * field, const char * value) + { + HTTPHeader header; + + //these are just going to stick around forever. + header.field =(char *)malloc(strlen(field)+1); + header.value = (char *)malloc(strlen(value)+1); + + strlcpy(header.field, field, strlen(field)+1); + strlcpy(header.value, value, strlen(value)+1); + + _headers.push_back(header); + } + + const std::list& getHeaders() { return _headers; } + + //delete the copy constructor, singleton class + DefaultHeaders(DefaultHeaders const &) = delete; + DefaultHeaders &operator=(DefaultHeaders const &) = delete; + + //single static class interface + static DefaultHeaders &Instance() { + static DefaultHeaders instance; + return instance; + } +}; + +#endif //PsychicCore_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicEndpoint.cpp b/lib/PsychicHttp/src/PsychicEndpoint.cpp new file mode 100644 index 0000000..e692658 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicEndpoint.cpp @@ -0,0 +1,90 @@ +#include "PsychicEndpoint.h" +#include "PsychicHttpServer.h" + +PsychicEndpoint::PsychicEndpoint() : + _server(NULL), + _uri(""), + _method(HTTP_GET), + _handler(NULL) +{ +} + +PsychicEndpoint::PsychicEndpoint(PsychicHttpServer *server, http_method method, const char * uri) : + _server(server), + _uri(uri), + _method(method), + _handler(NULL) +{ +} + +PsychicEndpoint * PsychicEndpoint::setHandler(PsychicHandler *handler) +{ + //clean up old / default handler + if (_handler != NULL) + delete _handler; + + //get our new pointer + _handler = handler; + + //keep a pointer to the server + _handler->_server = _server; + + return this; +} + +PsychicHandler * PsychicEndpoint::handler() +{ + return _handler; +} + +String PsychicEndpoint::uri() { + return _uri; +} + +esp_err_t PsychicEndpoint::requestCallback(httpd_req_t *req) +{ + #ifdef ENABLE_ASYNC + if (is_on_async_worker_thread() == false) { + if (submit_async_req(req, PsychicEndpoint::requestCallback) == ESP_OK) { + return ESP_OK; + } else { + httpd_resp_set_status(req, "503 Busy"); + httpd_resp_sendstr(req, "No workers available. Server busy."); + return ESP_OK; + } + } + #endif + + PsychicEndpoint *self = (PsychicEndpoint *)req->user_ctx; + PsychicHandler *handler = self->handler(); + PsychicRequest request(self->_server, req); + + //make sure we have a handler + if (handler != NULL) + { + if (handler->filter(&request) && handler->canHandle(&request)) + { + //check our credentials + if (handler->needsAuthentication(&request)) + return handler->authenticate(&request); + + //pass it to our handler + return handler->handleRequest(&request); + } + //pass it to our generic handlers + else + return PsychicHttpServer::notFoundHandler(req, HTTPD_500_INTERNAL_SERVER_ERROR); + } + else + return request.reply(500, "text/html", "No handler registered."); +} + +PsychicEndpoint* PsychicEndpoint::setFilter(PsychicRequestFilterFunction fn) { + _handler->setFilter(fn); + return this; +} + +PsychicEndpoint* PsychicEndpoint::setAuthentication(const char *username, const char *password, HTTPAuthMethod method, const char *realm, const char *authFailMsg) { + _handler->setAuthentication(username, password, method, realm, authFailMsg); + return this; +}; \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicEndpoint.h b/lib/PsychicHttp/src/PsychicEndpoint.h new file mode 100644 index 0000000..540b294 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicEndpoint.h @@ -0,0 +1,37 @@ +#ifndef PsychicEndpoint_h +#define PsychicEndpoint_h + +#include "PsychicCore.h" + +class PsychicHandler; + +#ifdef ENABLE_ASYNC + #include "async_worker.h" +#endif + +class PsychicEndpoint +{ + friend PsychicHttpServer; + + private: + PsychicHttpServer *_server; + String _uri; + http_method _method; + PsychicHandler *_handler; + + public: + PsychicEndpoint(); + PsychicEndpoint(PsychicHttpServer *server, http_method method, const char * uri); + + PsychicEndpoint *setHandler(PsychicHandler *handler); + PsychicHandler *handler(); + + PsychicEndpoint* setFilter(PsychicRequestFilterFunction fn); + PsychicEndpoint* setAuthentication(const char *username, const char *password, HTTPAuthMethod method = BASIC_AUTH, const char *realm = "", const char *authFailMsg = ""); + + String uri(); + + static esp_err_t requestCallback(httpd_req_t *req); +}; + +#endif // PsychicEndpoint_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicEventSource.cpp b/lib/PsychicHttp/src/PsychicEventSource.cpp new file mode 100644 index 0000000..25f947d --- /dev/null +++ b/lib/PsychicHttp/src/PsychicEventSource.cpp @@ -0,0 +1,225 @@ +/* + Asynchronous WebServer library for Espressif MCUs + + Copyright (c) 2016 Hristo Gochkov. All rights reserved. + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +*/ + +#include "PsychicEventSource.h" + +/*****************************************/ +// PsychicEventSource - Handler +/*****************************************/ + +PsychicEventSource::PsychicEventSource() : + PsychicHandler(), + _onOpen(NULL), + _onClose(NULL) +{} + +PsychicEventSource::~PsychicEventSource() { +} + +PsychicEventSourceClient * PsychicEventSource::getClient(int socket) +{ + PsychicClient *client = PsychicHandler::getClient(socket); + + if (client == NULL) + return NULL; + + return (PsychicEventSourceClient *)client->_friend; +} + +PsychicEventSourceClient * PsychicEventSource::getClient(PsychicClient *client) { + return getClient(client->socket()); +} + +esp_err_t PsychicEventSource::handleRequest(PsychicRequest *request) +{ + //start our open ended HTTP response + PsychicEventSourceResponse response(request); + esp_err_t err = response.send(); + + //lookup our client + PsychicClient *client = checkForNewClient(request->client()); + if (client->isNew) + { + //did we get our last id? + if(request->hasHeader("Last-Event-ID")) + { + PsychicEventSourceClient *buddy = getClient(client); + buddy->_lastId = atoi(request->header("Last-Event-ID").c_str()); + } + + //let our handler know. + openCallback(client); + } + + return err; +} + +PsychicEventSource * PsychicEventSource::onOpen(PsychicEventSourceClientCallback fn) { + _onOpen = fn; + return this; +} + +PsychicEventSource * PsychicEventSource::onClose(PsychicEventSourceClientCallback fn) { + _onClose = fn; + return this; +} + +void PsychicEventSource::addClient(PsychicClient *client) { + client->_friend = new PsychicEventSourceClient(client); + PsychicHandler::addClient(client); +} + +void PsychicEventSource::removeClient(PsychicClient *client) { + PsychicHandler::removeClient(client); + delete (PsychicEventSourceClient*)client->_friend; + client->_friend = NULL; +} + +void PsychicEventSource::openCallback(PsychicClient *client) { + PsychicEventSourceClient *buddy = getClient(client); + if (buddy == NULL) + { + return; + } + + if (_onOpen != NULL) + _onOpen(buddy); +} + +void PsychicEventSource::closeCallback(PsychicClient *client) { + PsychicEventSourceClient *buddy = getClient(client); + if (buddy == NULL) + { + return; + } + + if (_onClose != NULL) + _onClose(getClient(buddy)); +} + +void PsychicEventSource::send(const char *message, const char *event, uint32_t id, uint32_t reconnect) +{ + String ev = generateEventMessage(message, event, id, reconnect); + for(PsychicClient *c : _clients) { + ((PsychicEventSourceClient*)c->_friend)->sendEvent(ev.c_str()); + } +} + +/*****************************************/ +// PsychicEventSourceClient +/*****************************************/ + +PsychicEventSourceClient::PsychicEventSourceClient(PsychicClient *client) : + PsychicClient(client->server(), client->socket()), + _lastId(0) +{ +} + +PsychicEventSourceClient::~PsychicEventSourceClient(){ +} + +void PsychicEventSourceClient::send(const char *message, const char *event, uint32_t id, uint32_t reconnect){ + String ev = generateEventMessage(message, event, id, reconnect); + sendEvent(ev.c_str()); +} + +void PsychicEventSourceClient::sendEvent(const char *event) { + int result; + do { + result = httpd_socket_send(this->server(), this->socket(), event, strlen(event), 0); + } while (result == HTTPD_SOCK_ERR_TIMEOUT); + + //if (result < 0) + //error log here +} + +/*****************************************/ +// PsychicEventSourceResponse +/*****************************************/ + +PsychicEventSourceResponse::PsychicEventSourceResponse(PsychicRequest *request) + : PsychicResponse(request) +{ +} + +esp_err_t PsychicEventSourceResponse::send() { + + //build our main header + String out = String(); + out.concat("HTTP/1.1 200 OK\r\n"); + out.concat("Content-Type: text/event-stream\r\n"); + out.concat("Cache-Control: no-cache\r\n"); + out.concat("Connection: keep-alive\r\n"); + + //get our global headers out of the way first + for (HTTPHeader header : DefaultHeaders::Instance().getHeaders()) + out.concat(String(header.field) + ": " + String(header.value) + "\r\n"); + + //separator + out.concat("\r\n"); + + int result; + do { + result = httpd_send(_request->request(), out.c_str(), out.length()); + } while (result == HTTPD_SOCK_ERR_TIMEOUT); + + if (result < 0) + ESP_LOGE(PH_TAG, "EventSource send failed with %s", esp_err_to_name(result)); + + if (result > 0) + return ESP_OK; + else + return ESP_ERR_HTTPD_RESP_SEND; +} + +/*****************************************/ +// Event Message Generator +/*****************************************/ + +String generateEventMessage(const char *message, const char *event, uint32_t id, uint32_t reconnect) { + String ev = ""; + + if(reconnect){ + ev += "retry: "; + ev += String(reconnect); + ev += "\r\n"; + } + + if(id){ + ev += "id: "; + ev += String(id); + ev += "\r\n"; + } + + if(event != NULL){ + ev += "event: "; + ev += String(event); + ev += "\r\n"; + } + + if(message != NULL){ + ev += "data: "; + ev += String(message); + ev += "\r\n"; + } + ev += "\r\n"; + + return ev; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicEventSource.h b/lib/PsychicHttp/src/PsychicEventSource.h new file mode 100644 index 0000000..ab31980 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicEventSource.h @@ -0,0 +1,82 @@ +/* + Asynchronous WebServer library for Espressif MCUs + + Copyright (c) 2016 Hristo Gochkov. All rights reserved. + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +*/ +#ifndef PsychicEventSource_H_ +#define PsychicEventSource_H_ + +#include "PsychicCore.h" +#include "PsychicHandler.h" +#include "PsychicClient.h" +#include "PsychicResponse.h" + +class PsychicEventSource; +class PsychicEventSourceResponse; +class PsychicEventSourceClient; +class PsychicResponse; + +typedef std::function PsychicEventSourceClientCallback; + +class PsychicEventSourceClient : public PsychicClient { + friend PsychicEventSource; + + protected: + uint32_t _lastId; + + public: + PsychicEventSourceClient(PsychicClient *client); + ~PsychicEventSourceClient(); + + uint32_t lastId() const { return _lastId; } + void send(const char *message, const char *event=NULL, uint32_t id=0, uint32_t reconnect=0); + void sendEvent(const char *event); +}; + +class PsychicEventSource : public PsychicHandler { + private: + PsychicEventSourceClientCallback _onOpen; + PsychicEventSourceClientCallback _onClose; + + public: + PsychicEventSource(); + ~PsychicEventSource(); + + PsychicEventSourceClient * getClient(int socket) override; + PsychicEventSourceClient * getClient(PsychicClient *client) override; + void addClient(PsychicClient *client) override; + void removeClient(PsychicClient *client) override; + void openCallback(PsychicClient *client) override; + void closeCallback(PsychicClient *client) override; + + PsychicEventSource *onOpen(PsychicEventSourceClientCallback fn); + PsychicEventSource *onClose(PsychicEventSourceClientCallback fn); + + esp_err_t handleRequest(PsychicRequest *request) override final; + + void send(const char *message, const char *event=NULL, uint32_t id=0, uint32_t reconnect=0); +}; + +class PsychicEventSourceResponse: public PsychicResponse { + public: + PsychicEventSourceResponse(PsychicRequest *request); + virtual esp_err_t send() override; +}; + +String generateEventMessage(const char *message, const char *event, uint32_t id, uint32_t reconnect); + +#endif /* PsychicEventSource_H_ */ \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicFileResponse.cpp b/lib/PsychicHttp/src/PsychicFileResponse.cpp new file mode 100644 index 0000000..5fc9822 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicFileResponse.cpp @@ -0,0 +1,159 @@ +#include "PsychicFileResponse.h" +#include "PsychicResponse.h" +#include "PsychicRequest.h" + + +PsychicFileResponse::PsychicFileResponse(PsychicRequest *request, FS &fs, const String& path, const String& contentType, bool download) + : PsychicResponse(request) { + //_code = 200; + String _path(path); + + if(!download && !fs.exists(_path) && fs.exists(_path+".gz")){ + _path = _path+".gz"; + addHeader("Content-Encoding", "gzip"); + } + + _content = fs.open(_path, "r"); + _contentLength = _content.size(); + + if(contentType == "") + _setContentType(path); + else + setContentType(contentType.c_str()); + + int filenameStart = path.lastIndexOf('/') + 1; + char buf[26+path.length()-filenameStart]; + char* filename = (char*)path.c_str() + filenameStart; + + if(download) { + // set filename and force download + snprintf(buf, sizeof (buf), "attachment; filename=\"%s\"", filename); + } else { + // set filename and force rendering + snprintf(buf, sizeof (buf), "inline; filename=\"%s\"", filename); + } + addHeader("Content-Disposition", buf); +} + +PsychicFileResponse::PsychicFileResponse(PsychicRequest *request, File content, const String& path, const String& contentType, bool download) + : PsychicResponse(request) { + String _path(path); + + if(!download && String(content.name()).endsWith(".gz") && !path.endsWith(".gz")){ + addHeader("Content-Encoding", "gzip"); + } + + _content = content; + _contentLength = _content.size(); + + if(contentType == "") + _setContentType(path); + else + setContentType(contentType.c_str()); + + int filenameStart = path.lastIndexOf('/') + 1; + char buf[26+path.length()-filenameStart]; + char* filename = (char*)path.c_str() + filenameStart; + + if(download) { + snprintf(buf, sizeof (buf), "attachment; filename=\"%s\"", filename); + } else { + snprintf(buf, sizeof (buf), "inline; filename=\"%s\"", filename); + } + addHeader("Content-Disposition", buf); +} + +PsychicFileResponse::~PsychicFileResponse() +{ + if(_content) + _content.close(); +} + +void PsychicFileResponse::_setContentType(const String& path){ + const char *_contentType; + + if (path.endsWith(".html")) _contentType = "text/html"; + else if (path.endsWith(".htm")) _contentType = "text/html"; + else if (path.endsWith(".css")) _contentType = "text/css"; + else if (path.endsWith(".json")) _contentType = "application/json"; + else if (path.endsWith(".js")) _contentType = "application/javascript"; + else if (path.endsWith(".png")) _contentType = "image/png"; + else if (path.endsWith(".gif")) _contentType = "image/gif"; + else if (path.endsWith(".jpg")) _contentType = "image/jpeg"; + else if (path.endsWith(".ico")) _contentType = "image/x-icon"; + else if (path.endsWith(".svg")) _contentType = "image/svg+xml"; + else if (path.endsWith(".eot")) _contentType = "font/eot"; + else if (path.endsWith(".woff")) _contentType = "font/woff"; + else if (path.endsWith(".woff2")) _contentType = "font/woff2"; + else if (path.endsWith(".ttf")) _contentType = "font/ttf"; + else if (path.endsWith(".xml")) _contentType = "text/xml"; + else if (path.endsWith(".pdf")) _contentType = "application/pdf"; + else if (path.endsWith(".zip")) _contentType = "application/zip"; + else if(path.endsWith(".gz")) _contentType = "application/x-gzip"; + else _contentType = "text/plain"; + + setContentType(_contentType); +} + +esp_err_t PsychicFileResponse::send() +{ + esp_err_t err = ESP_OK; + + //just send small files directly + size_t size = getContentLength(); + if (size < FILE_CHUNK_SIZE) + { + uint8_t *buffer = (uint8_t *)malloc(size); + if (buffer == NULL) + { + /* Respond with 500 Internal Server Error */ + httpd_resp_send_err(this->_request->request(), HTTPD_500_INTERNAL_SERVER_ERROR, "Unable to allocate memory."); + return ESP_FAIL; + } + + size_t readSize = _content.readBytes((char *)buffer, size); + + this->setContent(buffer, readSize); + err = PsychicResponse::send(); + + free(buffer); + } + else + { + /* Retrieve the pointer to scratch buffer for temporary storage */ + char *chunk = (char *)malloc(FILE_CHUNK_SIZE); + if (chunk == NULL) + { + /* Respond with 500 Internal Server Error */ + httpd_resp_send_err(this->_request->request(), HTTPD_500_INTERNAL_SERVER_ERROR, "Unable to allocate memory."); + return ESP_FAIL; + } + + this->sendHeaders(); + + size_t chunksize; + do { + /* Read file in chunks into the scratch buffer */ + chunksize = _content.readBytes(chunk, FILE_CHUNK_SIZE); + if (chunksize > 0) + { + err = this->sendChunk((uint8_t *)chunk, chunksize); + if (err != ESP_OK) + break; + } + + /* Keep looping till the whole file is sent */ + } while (chunksize != 0); + + //keep track of our memory + free(chunk); + + if (err == ESP_OK) + { + ESP_LOGD(PH_TAG, "File sending complete"); + this->finishChunking(); + } + } + + return err; +} diff --git a/lib/PsychicHttp/src/PsychicFileResponse.h b/lib/PsychicHttp/src/PsychicFileResponse.h new file mode 100644 index 0000000..8eb75fc --- /dev/null +++ b/lib/PsychicHttp/src/PsychicFileResponse.h @@ -0,0 +1,23 @@ +#ifndef PsychicFileResponse_h +#define PsychicFileResponse_h + +#include "PsychicCore.h" +#include "PsychicResponse.h" + +class PsychicRequest; + +class PsychicFileResponse: public PsychicResponse +{ + using File = fs::File; + using FS = fs::FS; + private: + File _content; + void _setContentType(const String& path); + public: + PsychicFileResponse(PsychicRequest *request, FS &fs, const String& path, const String& contentType=String(), bool download=false); + PsychicFileResponse(PsychicRequest *request, File content, const String& path, const String& contentType=String(), bool download=false); + ~PsychicFileResponse(); + esp_err_t send(); +}; + +#endif // PsychicFileResponse_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHandler.cpp b/lib/PsychicHttp/src/PsychicHandler.cpp new file mode 100644 index 0000000..097b30e --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHandler.cpp @@ -0,0 +1,111 @@ +#include "PsychicHandler.h" + +PsychicHandler::PsychicHandler() : + _filter(NULL), + _server(NULL), + _username(""), + _password(""), + _method(DIGEST_AUTH), + _realm(""), + _authFailMsg(""), + _subprotocol("") + {} + +PsychicHandler::~PsychicHandler() { + // actual PsychicClient deletion handled by PsychicServer + // for (PsychicClient *client : _clients) + // delete(client); + _clients.clear(); +} + +PsychicHandler* PsychicHandler::setFilter(PsychicRequestFilterFunction fn) { + _filter = fn; + return this; +} + +bool PsychicHandler::filter(PsychicRequest *request){ + return _filter == NULL || _filter(request); +} + +void PsychicHandler::setSubprotocol(const String& subprotocol) { + this->_subprotocol = subprotocol; +} +const char* PsychicHandler::getSubprotocol() const { + return _subprotocol.c_str(); +} + +PsychicHandler* PsychicHandler::setAuthentication(const char *username, const char *password, HTTPAuthMethod method, const char *realm, const char *authFailMsg) { + _username = String(username); + _password = String(password); + _method = method; + _realm = String(realm); + _authFailMsg = String(authFailMsg); + return this; +}; + +bool PsychicHandler::needsAuthentication(PsychicRequest *request) { + return (_username != "" && _password != "") && !request->authenticate(_username.c_str(), _password.c_str()); +} + +esp_err_t PsychicHandler::authenticate(PsychicRequest *request) { + return request->requestAuthentication(_method, _realm.c_str(), _authFailMsg.c_str()); +} + +PsychicClient * PsychicHandler::checkForNewClient(PsychicClient *client) +{ + PsychicClient *c = PsychicHandler::getClient(client); + if (c == NULL) + { + c = client; + addClient(c); + c->isNew = true; + } + else + c->isNew = false; + + return c; +} + +void PsychicHandler::checkForClosedClient(PsychicClient *client) +{ + if (hasClient(client)) + { + closeCallback(client); + removeClient(client); + } +} + +void PsychicHandler::addClient(PsychicClient *client) { + _clients.push_back(client); +} + +void PsychicHandler::removeClient(PsychicClient *client) { + _clients.remove(client); +} + +PsychicClient * PsychicHandler::getClient(int socket) +{ + //make sure the server has it too. + if (!_server->hasClient(socket)) + return NULL; + + //what about us? + for (PsychicClient *client : _clients) + if (client->socket() == socket) + return client; + + //nothing found. + return NULL; +} + +PsychicClient * PsychicHandler::getClient(PsychicClient *client) { + return PsychicHandler::getClient(client->socket()); +} + +bool PsychicHandler::hasClient(PsychicClient *socket) { + return PsychicHandler::getClient(socket) != NULL; +} + +const std::list& PsychicHandler::getClientList() { + return _clients; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHandler.h b/lib/PsychicHttp/src/PsychicHandler.h new file mode 100644 index 0000000..bad62bf --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHandler.h @@ -0,0 +1,66 @@ +#ifndef PsychicHandler_h +#define PsychicHandler_h + +#include "PsychicCore.h" +#include "PsychicRequest.h" + +class PsychicEndpoint; +class PsychicHttpServer; + +/* +* HANDLER :: Can be attached to any endpoint or as a generic request handler. +*/ + +class PsychicHandler { + friend PsychicEndpoint; + + protected: + PsychicRequestFilterFunction _filter; + PsychicHttpServer *_server; + + String _username; + String _password; + HTTPAuthMethod _method; + String _realm; + String _authFailMsg; + + String _subprotocol; + + std::list _clients; + + public: + PsychicHandler(); + virtual ~PsychicHandler(); + + PsychicHandler* setFilter(PsychicRequestFilterFunction fn); + bool filter(PsychicRequest *request); + + PsychicHandler* setAuthentication(const char *username, const char *password, HTTPAuthMethod method = BASIC_AUTH, const char *realm = "", const char *authFailMsg = ""); + bool needsAuthentication(PsychicRequest *request); + esp_err_t authenticate(PsychicRequest *request); + + virtual bool isWebSocket() { return false; }; + + void setSubprotocol(const String& subprotocol); + const char* getSubprotocol() const; + + PsychicClient * checkForNewClient(PsychicClient *client); + void checkForClosedClient(PsychicClient *client); + + virtual void addClient(PsychicClient *client); + virtual void removeClient(PsychicClient *client); + virtual PsychicClient * getClient(int socket); + virtual PsychicClient * getClient(PsychicClient *client); + virtual void openCallback(PsychicClient *client) {}; + virtual void closeCallback(PsychicClient *client) {}; + + bool hasClient(PsychicClient *client); + int count() { return _clients.size(); }; + const std::list& getClientList(); + + //derived classes must implement these functions + virtual bool canHandle(PsychicRequest *request) { return true; }; + virtual esp_err_t handleRequest(PsychicRequest *request) = 0; +}; + +#endif \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHttp.h b/lib/PsychicHttp/src/PsychicHttp.h new file mode 100644 index 0000000..3e9da55 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHttp.h @@ -0,0 +1,24 @@ +#ifndef PsychicHttp_h +#define PsychicHttp_h + +//#define ENABLE_ASYNC // This is something added in ESP-IDF 5.1.x where each request can be handled in its own thread + +#include +#include "PsychicHttpServer.h" +#include "PsychicRequest.h" +#include "PsychicResponse.h" +#include "PsychicEndpoint.h" +#include "PsychicHandler.h" +#include "PsychicStaticFileHandler.h" +#include "PsychicFileResponse.h" +#include "PsychicStreamResponse.h" +#include "PsychicUploadHandler.h" +#include "PsychicWebSocket.h" +#include "PsychicEventSource.h" +#include "PsychicJson.h" + +#ifdef ENABLE_ASYNC + #include "async_worker.h" +#endif + +#endif /* PsychicHttp_h */ \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHttpServer.cpp b/lib/PsychicHttp/src/PsychicHttpServer.cpp new file mode 100644 index 0000000..628f38b --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHttpServer.cpp @@ -0,0 +1,366 @@ +#include "PsychicHttpServer.h" +#include "PsychicEndpoint.h" +#include "PsychicHandler.h" +#include "PsychicWebHandler.h" +#include "PsychicStaticFileHandler.h" +#include "PsychicWebSocket.h" +#include "PsychicJson.h" +#include "WiFi.h" + +PsychicHttpServer::PsychicHttpServer() : + _onOpen(NULL), + _onClose(NULL) +{ + maxRequestBodySize = MAX_REQUEST_BODY_SIZE; + maxUploadSize = MAX_UPLOAD_SIZE; + + defaultEndpoint = new PsychicEndpoint(this, HTTP_GET, ""); + onNotFound(PsychicHttpServer::defaultNotFoundHandler); + + //for a regular server + config = HTTPD_DEFAULT_CONFIG(); + config.open_fn = PsychicHttpServer::openCallback; + config.close_fn = PsychicHttpServer::closeCallback; + config.uri_match_fn = httpd_uri_match_wildcard; + config.global_user_ctx = this; + config.global_user_ctx_free_fn = destroy; + config.max_uri_handlers = 20; + + #ifdef ENABLE_ASYNC + // It is advisable that httpd_config_t->max_open_sockets > MAX_ASYNC_REQUESTS + // Why? This leaves at least one socket still available to handle + // quick synchronous requests. Otherwise, all the sockets will + // get taken by the long async handlers, and your server will no + // longer be responsive. + config.max_open_sockets = ASYNC_WORKER_COUNT + 1; + config.lru_purge_enable = true; + #endif +} + +PsychicHttpServer::~PsychicHttpServer() +{ + for (auto *client : _clients) + delete(client); + _clients.clear(); + + for (auto *endpoint : _endpoints) + delete(endpoint); + _endpoints.clear(); + + for (auto *handler : _handlers) + delete(handler); + _handlers.clear(); + + delete defaultEndpoint; +} + +void PsychicHttpServer::destroy(void *ctx) +{ + // do not release any resource for PsychicHttpServer in order to be able to restart it after stopping +} + +esp_err_t PsychicHttpServer::listen(uint16_t port) +{ + this->_use_ssl = false; + this->config.server_port = port; + + return this->_start(); +} + +esp_err_t PsychicHttpServer::_start() +{ + esp_err_t ret; + + #ifdef ENABLE_ASYNC + // start workers + start_async_req_workers(); + #endif + + //fire it up. + ret = _startServer(); + if (ret != ESP_OK) + { + ESP_LOGE(PH_TAG, "Server start failed (%s)", esp_err_to_name(ret)); + return ret; + } + + // Register handler + ret = httpd_register_err_handler(server, HTTPD_404_NOT_FOUND, PsychicHttpServer::notFoundHandler); + if (ret != ESP_OK) + ESP_LOGE(PH_TAG, "Add 404 handler failed (%s)", esp_err_to_name(ret)); + + return ret; +} + +esp_err_t PsychicHttpServer::_startServer() { + return httpd_start(&this->server, &this->config); +} + +void PsychicHttpServer::stop() +{ + httpd_stop(this->server); +} + +PsychicHandler& PsychicHttpServer::addHandler(PsychicHandler* handler){ + _handlers.push_back(handler); + return *handler; +} + +void PsychicHttpServer::removeHandler(PsychicHandler *handler){ + _handlers.remove(handler); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri) { + return on(uri, HTTP_GET); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, http_method method) +{ + PsychicWebHandler *handler = new PsychicWebHandler(); + + return on(uri, method, handler); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, PsychicHandler *handler) +{ + return on(uri, HTTP_GET, handler); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, http_method method, PsychicHandler *handler) +{ + //make our endpoint + PsychicEndpoint *endpoint = new PsychicEndpoint(this, method, uri); + + //set our handler + endpoint->setHandler(handler); + + // URI handler structure + httpd_uri_t my_uri { + .uri = uri, + .method = method, + .handler = PsychicEndpoint::requestCallback, + .user_ctx = endpoint, + .is_websocket = handler->isWebSocket(), + .supported_subprotocol = handler->getSubprotocol() + }; + + // Register endpoint with ESP-IDF server + esp_err_t ret = httpd_register_uri_handler(this->server, &my_uri); + if (ret != ESP_OK) + ESP_LOGE(PH_TAG, "Add endpoint failed (%s)", esp_err_to_name(ret)); + + //save it for later + _endpoints.push_back(endpoint); + + return endpoint; +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, PsychicHttpRequestCallback fn) +{ + return on(uri, HTTP_GET, fn); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, http_method method, PsychicHttpRequestCallback fn) +{ + //these basic requests need a basic web handler + PsychicWebHandler *handler = new PsychicWebHandler(); + handler->onRequest(fn); + + return on(uri, method, handler); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, PsychicJsonRequestCallback fn) +{ + return on(uri, HTTP_GET, fn); +} + +PsychicEndpoint* PsychicHttpServer::on(const char* uri, http_method method, PsychicJsonRequestCallback fn) +{ + //these basic requests need a basic web handler + PsychicJsonHandler *handler = new PsychicJsonHandler(); + handler->onRequest(fn); + + return on(uri, method, handler); +} + +void PsychicHttpServer::onNotFound(PsychicHttpRequestCallback fn) +{ + PsychicWebHandler *handler = new PsychicWebHandler(); + handler->onRequest(fn == nullptr ? PsychicHttpServer::defaultNotFoundHandler : fn); + + this->defaultEndpoint->setHandler(handler); +} + +esp_err_t PsychicHttpServer::notFoundHandler(httpd_req_t *req, httpd_err_code_t err) +{ + PsychicHttpServer *server = (PsychicHttpServer*)httpd_get_global_user_ctx(req->handle); + PsychicRequest request(server, req); + + //loop through our global handlers and see if anyone wants it + for(auto *handler: server->_handlers) + { + //are we capable of handling this? + if (handler->filter(&request) && handler->canHandle(&request)) + { + //check our credentials + if (handler->needsAuthentication(&request)) + return handler->authenticate(&request); + else + return handler->handleRequest(&request); + } + } + + //nothing found, give it to our defaultEndpoint + PsychicHandler *handler = server->defaultEndpoint->handler(); + if (handler->filter(&request) && handler->canHandle(&request)) + return handler->handleRequest(&request); + + //not sure how we got this far. + return ESP_ERR_HTTPD_INVALID_REQ; +} + +esp_err_t PsychicHttpServer::defaultNotFoundHandler(PsychicRequest *request) +{ + request->reply(404, "text/html", "That URI does not exist."); + + return ESP_OK; +} + +void PsychicHttpServer::onOpen(PsychicClientCallback handler) { + this->_onOpen = handler; +} + +esp_err_t PsychicHttpServer::openCallback(httpd_handle_t hd, int sockfd) +{ + ESP_LOGD(PH_TAG, "New client connected %d", sockfd); + + //get our global server reference + PsychicHttpServer *server = (PsychicHttpServer*)httpd_get_global_user_ctx(hd); + + //lookup our client + PsychicClient *client = server->getClient(sockfd); + if (client == NULL) + { + client = new PsychicClient(hd, sockfd); + server->addClient(client); + } + + //user callback + if (server->_onOpen != NULL) + server->_onOpen(client); + + return ESP_OK; +} + +void PsychicHttpServer::onClose(PsychicClientCallback handler) { + this->_onClose = handler; +} + +void PsychicHttpServer::closeCallback(httpd_handle_t hd, int sockfd) +{ + ESP_LOGD(PH_TAG, "Client disconnected %d", sockfd); + + PsychicHttpServer *server = (PsychicHttpServer*)httpd_get_global_user_ctx(hd); + + //lookup our client + PsychicClient *client = server->getClient(sockfd); + if (client != NULL) + { + //give our handlers a chance to handle a disconnect first + for (PsychicEndpoint * endpoint : server->_endpoints) + { + PsychicHandler *handler = endpoint->handler(); + handler->checkForClosedClient(client); + } + + //do we have a callback attached? + if (server->_onClose != NULL) + server->_onClose(client); + + //remove it from our list + server->removeClient(client); + } + else + ESP_LOGE(PH_TAG, "No client record %d", sockfd); + + //finally close it out. + close(sockfd); +} + +PsychicStaticFileHandler* PsychicHttpServer::serveStatic(const char* uri, fs::FS& fs, const char* path, const char* cache_control) +{ + PsychicStaticFileHandler* handler = new PsychicStaticFileHandler(uri, fs, path, cache_control); + this->addHandler(handler); + + return handler; +} + +void PsychicHttpServer::addClient(PsychicClient *client) { + _clients.push_back(client); +} + +void PsychicHttpServer::removeClient(PsychicClient *client) { + _clients.remove(client); + delete client; +} + +PsychicClient * PsychicHttpServer::getClient(int socket) { + for (PsychicClient * client : _clients) + if (client->socket() == socket) + return client; + + return NULL; +} + +PsychicClient * PsychicHttpServer::getClient(httpd_req_t *req) { + return getClient(httpd_req_to_sockfd(req)); +} + +bool PsychicHttpServer::hasClient(int socket) { + return getClient(socket) != NULL; +} + +const std::list& PsychicHttpServer::getClientList() { + return _clients; +} + +bool ON_STA_FILTER(PsychicRequest *request) { + return WiFi.localIP() == request->client()->localIP(); +} + +bool ON_AP_FILTER(PsychicRequest *request) { + return WiFi.softAPIP() == request->client()->localIP(); +} + +String urlDecode(const char* encoded) +{ + size_t length = strlen(encoded); + char* decoded = (char*)malloc(length + 1); + if (!decoded) { + return ""; + } + + size_t i, j = 0; + for (i = 0; i < length; ++i) { + if (encoded[i] == '%' && isxdigit(encoded[i + 1]) && isxdigit(encoded[i + 2])) { + // Valid percent-encoded sequence + int hex; + sscanf(encoded + i + 1, "%2x", &hex); + decoded[j++] = (char)hex; + i += 2; // Skip the two hexadecimal characters + } else if (encoded[i] == '+') { + // Convert '+' to space + decoded[j++] = ' '; + } else { + // Copy other characters as they are + decoded[j++] = encoded[i]; + } + } + + decoded[j] = '\0'; // Null-terminate the decoded string + + String output(decoded); + free(decoded); + + return output; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHttpServer.h b/lib/PsychicHttp/src/PsychicHttpServer.h new file mode 100644 index 0000000..40e5442 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHttpServer.h @@ -0,0 +1,81 @@ +#ifndef PsychicHttpServer_h +#define PsychicHttpServer_h + +#include "PsychicCore.h" +#include "PsychicClient.h" +#include "PsychicHandler.h" + +class PsychicEndpoint; +class PsychicHandler; +class PsychicStaticFileHandler; + +class PsychicHttpServer +{ + protected: + bool _use_ssl = false; + std::list _endpoints; + std::list _handlers; + std::list _clients; + + PsychicClientCallback _onOpen; + PsychicClientCallback _onClose; + + esp_err_t _start(); + virtual esp_err_t _startServer(); + + public: + PsychicHttpServer(); + virtual ~PsychicHttpServer(); + + //esp-idf specific stuff + httpd_handle_t server; + httpd_config_t config; + + //some limits on what we will accept + unsigned long maxUploadSize; + unsigned long maxRequestBodySize; + + PsychicEndpoint *defaultEndpoint; + + static void destroy(void *ctx); + + esp_err_t listen(uint16_t port); + + virtual void stop(); + + PsychicHandler& addHandler(PsychicHandler* handler); + void removeHandler(PsychicHandler* handler); + + void addClient(PsychicClient *client); + void removeClient(PsychicClient *client); + PsychicClient* getClient(int socket); + PsychicClient* getClient(httpd_req_t *req); + bool hasClient(int socket); + int count() { return _clients.size(); }; + const std::list& getClientList(); + + PsychicEndpoint* on(const char* uri); + PsychicEndpoint* on(const char* uri, http_method method); + PsychicEndpoint* on(const char* uri, PsychicHandler *handler); + PsychicEndpoint* on(const char* uri, http_method method, PsychicHandler *handler); + PsychicEndpoint* on(const char* uri, PsychicHttpRequestCallback onRequest); + PsychicEndpoint* on(const char* uri, http_method method, PsychicHttpRequestCallback onRequest); + PsychicEndpoint* on(const char* uri, PsychicJsonRequestCallback onRequest); + PsychicEndpoint* on(const char* uri, http_method method, PsychicJsonRequestCallback onRequest); + + static esp_err_t notFoundHandler(httpd_req_t *req, httpd_err_code_t err); + static esp_err_t defaultNotFoundHandler(PsychicRequest *request); + void onNotFound(PsychicHttpRequestCallback fn); + + void onOpen(PsychicClientCallback handler); + void onClose(PsychicClientCallback handler); + static esp_err_t openCallback(httpd_handle_t hd, int sockfd); + static void closeCallback(httpd_handle_t hd, int sockfd); + + PsychicStaticFileHandler* serveStatic(const char* uri, fs::FS& fs, const char* path, const char* cache_control = NULL); +}; + +bool ON_STA_FILTER(PsychicRequest *request); +bool ON_AP_FILTER(PsychicRequest *request); + +#endif // PsychicHttpServer_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHttpsServer.cpp b/lib/PsychicHttp/src/PsychicHttpsServer.cpp new file mode 100644 index 0000000..5df225e --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHttpsServer.cpp @@ -0,0 +1,61 @@ +#include "PsychicHttpsServer.h" + +#ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE + +PsychicHttpsServer::PsychicHttpsServer() : PsychicHttpServer() +{ + //for a SSL server + ssl_config = HTTPD_SSL_CONFIG_DEFAULT(); + ssl_config.httpd.open_fn = PsychicHttpServer::openCallback; + ssl_config.httpd.close_fn = PsychicHttpServer::closeCallback; + ssl_config.httpd.uri_match_fn = httpd_uri_match_wildcard; + ssl_config.httpd.global_user_ctx = this; + ssl_config.httpd.global_user_ctx_free_fn = destroy; + ssl_config.httpd.max_uri_handlers = 20; + + // each SSL connection takes about 45kb of heap + // a barebones sketch with PsychicHttp has ~150kb of heap available + // if we set it higher than 2 and use all the connections, we get lots of memory errors. + // not to mention there is no heap left over for the program itself. + ssl_config.httpd.max_open_sockets = 2; +} + +PsychicHttpsServer::~PsychicHttpsServer() {} + +esp_err_t PsychicHttpsServer::listen(uint16_t port, const char *cert, const char *private_key) +{ + this->_use_ssl = true; + + this->ssl_config.port_secure = port; + +#if ESP_IDF_VERSION >= ESP_IDF_VERSION_VAL(5, 0, 2) + this->ssl_config.servercert = (uint8_t *)cert; + this->ssl_config.servercert_len = strlen(cert)+1; +#else + this->ssl_config.cacert_pem = (uint8_t *)cert; + this->ssl_config.cacert_len = strlen(cert)+1; +#endif + + this->ssl_config.prvtkey_pem = (uint8_t *)private_key; + this->ssl_config.prvtkey_len = strlen(private_key)+1; + + return this->_start(); +} + +esp_err_t PsychicHttpsServer::_startServer() +{ + if (this->_use_ssl) + return httpd_ssl_start(&this->server, &this->ssl_config); + else + return httpd_start(&this->server, &this->config); +} + +void PsychicHttpsServer::stop() +{ + if (this->_use_ssl) + httpd_ssl_stop(this->server); + else + httpd_stop(this->server); +} + +#endif // CONFIG_ESP_HTTPS_SERVER_ENABLE \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicHttpsServer.h b/lib/PsychicHttp/src/PsychicHttpsServer.h new file mode 100644 index 0000000..51f8210 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicHttpsServer.h @@ -0,0 +1,39 @@ +#ifndef PsychicHttpsServer_h +#define PsychicHttpsServer_h + +#include + +#ifdef CONFIG_ESP_HTTPS_SERVER_ENABLE + +#include "PsychicCore.h" +#include "PsychicHttpServer.h" +#include +#if !CONFIG_HTTPD_WS_SUPPORT + #error PsychicHttpsServer cannot be used unless HTTPD_WS_SUPPORT is enabled in esp-http-server component configuration +#endif + +#define PSY_ENABLE_SSL //you can use this define in your code to enable/disable these features + +class PsychicHttpsServer : public PsychicHttpServer +{ + protected: + bool _use_ssl = false; + + public: + PsychicHttpsServer(); + ~PsychicHttpsServer(); + + httpd_ssl_config_t ssl_config; + + using PsychicHttpServer::listen; //keep the regular version + esp_err_t listen(uint16_t port, const char *cert, const char *private_key); + + virtual esp_err_t _startServer() override final; + virtual void stop() override final; +}; + +#endif // PsychicHttpsServer_h + +#else + #warning ESP-IDF https server support not enabled. +#endif // CONFIG_ESP_HTTPS_SERVER_ENABLE \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicJson.cpp b/lib/PsychicHttp/src/PsychicJson.cpp new file mode 100644 index 0000000..ca0f0a5 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicJson.cpp @@ -0,0 +1,133 @@ +#include "PsychicJson.h" + +#ifdef ARDUINOJSON_6_COMPATIBILITY + PsychicJsonResponse::PsychicJsonResponse(PsychicRequest *request, bool isArray, size_t maxJsonBufferSize) : + PsychicResponse(request), + _jsonBuffer(maxJsonBufferSize) + { + setContentType(JSON_MIMETYPE); + if (isArray) + _root = _jsonBuffer.createNestedArray(); + else + _root = _jsonBuffer.createNestedObject(); + } +#else + PsychicJsonResponse::PsychicJsonResponse(PsychicRequest *request, bool isArray) : PsychicResponse(request) + { + setContentType(JSON_MIMETYPE); + if (isArray) + _root = _jsonBuffer.add(); + else + _root = _jsonBuffer.add(); + } +#endif + +JsonVariant &PsychicJsonResponse::getRoot() { return _root; } + +size_t PsychicJsonResponse::getLength() +{ + return measureJson(_root); +} + +esp_err_t PsychicJsonResponse::send() +{ + esp_err_t err = ESP_OK; + size_t length = getLength(); + size_t buffer_size; + char *buffer; + + //how big of a buffer do we want? + if (length < JSON_BUFFER_SIZE) + buffer_size = length+1; + else + buffer_size = JSON_BUFFER_SIZE; + + buffer = (char *)malloc(buffer_size); + if (buffer == NULL) { + httpd_resp_send_err(this->_request->request(), HTTPD_500_INTERNAL_SERVER_ERROR, "Unable to allocate memory."); + return ESP_FAIL; + } + + //send it in one shot or no? + if (length < JSON_BUFFER_SIZE) + { + serializeJson(_root, buffer, buffer_size); + + this->setContent((uint8_t *)buffer, length); + this->setContentType(JSON_MIMETYPE); + + err = PsychicResponse::send(); + } + else + { + //helper class that acts as a stream to print chunked responses + ChunkPrinter dest(this, (uint8_t *)buffer, buffer_size); + + //keep our headers + this->sendHeaders(); + + serializeJson(_root, dest); + + //send the last bits + dest.flush(); + + //done with our chunked response too + err = this->finishChunking(); + } + + //let the buffer go + free(buffer); + + return err; +} + +#ifdef ARDUINOJSON_6_COMPATIBILITY + PsychicJsonHandler::PsychicJsonHandler(size_t maxJsonBufferSize) : + _onRequest(NULL), + _maxJsonBufferSize(maxJsonBufferSize) + {}; + + PsychicJsonHandler::PsychicJsonHandler(PsychicJsonRequestCallback onRequest, size_t maxJsonBufferSize) : + _onRequest(onRequest), + _maxJsonBufferSize(maxJsonBufferSize) + {} +#else + PsychicJsonHandler::PsychicJsonHandler() : + _onRequest(NULL) + {}; + + PsychicJsonHandler::PsychicJsonHandler(PsychicJsonRequestCallback onRequest) : + _onRequest(onRequest) + {} +#endif + +void PsychicJsonHandler::onRequest(PsychicJsonRequestCallback fn) { _onRequest = fn; } + +esp_err_t PsychicJsonHandler::handleRequest(PsychicRequest *request) +{ + //process basic stuff + PsychicWebHandler::handleRequest(request); + + if (_onRequest) + { + #ifdef ARDUINOJSON_6_COMPATIBILITY + DynamicJsonDocument jsonBuffer(this->_maxJsonBufferSize); + DeserializationError error = deserializeJson(jsonBuffer, request->body()); + if (error) + return request->reply(400); + + JsonVariant json = jsonBuffer.as(); + #else + JsonDocument jsonBuffer; + DeserializationError error = deserializeJson(jsonBuffer, request->body()); + if (error) + return request->reply(400); + + JsonVariant json = jsonBuffer.as(); + #endif + + return _onRequest(request, json); + } + else + return request->reply(500); +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicJson.h b/lib/PsychicHttp/src/PsychicJson.h new file mode 100644 index 0000000..95ca894 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicJson.h @@ -0,0 +1,89 @@ +// PsychicJson.h +/* + Async Response to use with ArduinoJson and AsyncWebServer + Written by Andrew Melvin (SticilFace) with help from me-no-dev and BBlanchon. + Ported to PsychicHttp by Zach Hoeken + +*/ +#ifndef PSYCHIC_JSON_H_ +#define PSYCHIC_JSON_H_ + +#include "PsychicRequest.h" +#include "PsychicWebHandler.h" +#include "ChunkPrinter.h" +#include + +#if ARDUINOJSON_VERSION_MAJOR == 6 + #define ARDUINOJSON_6_COMPATIBILITY + #ifndef DYNAMIC_JSON_DOCUMENT_SIZE + #define DYNAMIC_JSON_DOCUMENT_SIZE 4096 + #endif +#endif + + +#ifndef JSON_BUFFER_SIZE + #define JSON_BUFFER_SIZE 4*1024 +#endif + +constexpr const char *JSON_MIMETYPE = "application/json"; + +/* + * Json Response + * */ + +class PsychicJsonResponse : public PsychicResponse +{ + protected: + #ifdef ARDUINOJSON_5_COMPATIBILITY + DynamicJsonBuffer _jsonBuffer; + #elif ARDUINOJSON_VERSION_MAJOR == 6 + DynamicJsonDocument _jsonBuffer; + #else + JsonDocument _jsonBuffer; + #endif + + JsonVariant _root; + size_t _contentLength; + + public: + #ifdef ARDUINOJSON_5_COMPATIBILITY + PsychicJsonResponse(PsychicRequest *request, bool isArray = false); + #elif ARDUINOJSON_VERSION_MAJOR == 6 + PsychicJsonResponse(PsychicRequest *request, bool isArray = false, size_t maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE); + #else + PsychicJsonResponse(PsychicRequest *request, bool isArray = false); + #endif + + ~PsychicJsonResponse() {} + + JsonVariant &getRoot(); + size_t getLength(); + + virtual esp_err_t send() override; +}; + +class PsychicJsonHandler : public PsychicWebHandler +{ + protected: + PsychicJsonRequestCallback _onRequest; + #if ARDUINOJSON_VERSION_MAJOR == 6 + const size_t _maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE; + #endif + + public: + #ifdef ARDUINOJSON_5_COMPATIBILITY + PsychicJsonHandler(); + PsychicJsonHandler(PsychicJsonRequestCallback onRequest); + #elif ARDUINOJSON_VERSION_MAJOR == 6 + PsychicJsonHandler(size_t maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE); + PsychicJsonHandler(PsychicJsonRequestCallback onRequest, size_t maxJsonBufferSize = DYNAMIC_JSON_DOCUMENT_SIZE); + #else + PsychicJsonHandler(); + PsychicJsonHandler(PsychicJsonRequestCallback onRequest); + #endif + + void onRequest(PsychicJsonRequestCallback fn); + virtual esp_err_t handleRequest(PsychicRequest *request) override; +}; + +#endif \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicRequest.cpp b/lib/PsychicHttp/src/PsychicRequest.cpp new file mode 100644 index 0000000..4244358 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicRequest.cpp @@ -0,0 +1,542 @@ +#include "PsychicRequest.h" +#include "http_status.h" +#include "PsychicHttpServer.h" + + +PsychicRequest::PsychicRequest(PsychicHttpServer *server, httpd_req_t *req) : + _server(server), + _req(req), + _method(HTTP_GET), + _query(""), + _body(""), + _tempObject(NULL) +{ + //load up our client. + this->_client = server->getClient(req); + + //handle our session data + if (req->sess_ctx != NULL) + this->_session = (SessionData *)req->sess_ctx; + else + { + this->_session = new SessionData(); + req->sess_ctx = this->_session; + } + + //callback for freeing the session later + req->free_ctx = this->freeSession; + + //load up some data + this->_uri = String(this->_req->uri); +} + +PsychicRequest::~PsychicRequest() +{ + //temorary user object + if (_tempObject != NULL) + free(_tempObject); + + //our web parameters + for (auto *param : _params) + delete(param); + _params.clear(); +} + +void PsychicRequest::freeSession(void *ctx) +{ + if (ctx != NULL) + { + SessionData *session = (SessionData*)ctx; + delete session; + } +} + +PsychicHttpServer * PsychicRequest::server() { + return _server; +} + +httpd_req_t * PsychicRequest::request() { + return _req; +} + +PsychicClient * PsychicRequest::client() { + return _client; +} + +const String PsychicRequest::getFilename() +{ + //parse the content-disposition header + if (this->hasHeader("Content-Disposition")) + { + ContentDisposition cd = this->getContentDisposition(); + if (cd.filename != "") + return cd.filename; + } + + //fall back to passed in query string + PsychicWebParameter *param = getParam("_filename"); + if (param != NULL) + return param->name(); + + //fall back to parsing it from url (useful for wildcard uploads) + String uri = this->uri(); + int filenameStart = uri.lastIndexOf('/') + 1; + String filename = uri.substring(filenameStart); + if (filename != "") + return filename; + + //finally, unknown. + ESP_LOGE(PH_TAG, "Did not get a valid filename from the upload."); + return "unknown.txt"; +} + +const ContentDisposition PsychicRequest::getContentDisposition() +{ + ContentDisposition cd; + String header = this->header("Content-Disposition"); + int start; + int end; + + if (header.indexOf("form-data") == 0) + cd.disposition = FORM_DATA; + else if (header.indexOf("attachment") == 0) + cd.disposition = ATTACHMENT; + else if (header.indexOf("inline") == 0) + cd.disposition = INLINE; + else + cd.disposition = NONE; + + start = header.indexOf("filename="); + if (start) + { + end = header.indexOf('"', start+10); + cd.filename = header.substring(start+10, end-1); + } + + start = header.indexOf("name="); + if (start) + { + end = header.indexOf('"', start+6); + cd.name = header.substring(start+6, end-1); + } + + return cd; +} + +esp_err_t PsychicRequest::loadBody() +{ + esp_err_t err = ESP_OK; + + this->_body = String(); + + size_t remaining = this->_req->content_len; + size_t actuallyReceived = 0; + char *buf = (char *)malloc(remaining + 1); + if (buf == NULL) { + ESP_LOGE(PH_TAG, "Failed to allocate memory for body"); + return ESP_FAIL; + } + + while (remaining > 0) { + int received = httpd_req_recv(this->_req, buf + actuallyReceived, remaining); + + if (received == HTTPD_SOCK_ERR_TIMEOUT) { + continue; + } + else if (received == HTTPD_SOCK_ERR_FAIL) { + ESP_LOGE(PH_TAG, "Failed to receive data."); + err = ESP_FAIL; + break; + } + + remaining -= received; + actuallyReceived += received; + } + + buf[actuallyReceived] = '\0'; + this->_body = String(buf); + free(buf); + return err; +} + +http_method PsychicRequest::method() { + return (http_method)this->_req->method; +} + +const String PsychicRequest::methodStr() { + return String(http_method_str((http_method)this->_req->method)); +} + +const String PsychicRequest::path() { + int index = _uri.indexOf("?"); + if(index == -1) + return _uri; + else + return _uri.substring(0, index); +} + +const String& PsychicRequest::uri() { + return this->_uri; +} + +const String& PsychicRequest::query() { + return this->_query; +} + +// no way to get list of headers yet.... +// int PsychicRequest::headers() +// { +// } + +const String PsychicRequest::header(const char *name) +{ + size_t header_len = httpd_req_get_hdr_value_len(this->_req, name); + + //if we've got one, allocated it and load it + if (header_len) + { + char header[header_len+1]; + httpd_req_get_hdr_value_str(this->_req, name, header, sizeof(header)); + return String(header); + } + else + return ""; +} + +bool PsychicRequest::hasHeader(const char *name) +{ + return httpd_req_get_hdr_value_len(this->_req, name) > 0; +} + +const String PsychicRequest::host() { + return this->header("Host"); +} + +const String PsychicRequest::contentType() { + return header("Content-Type"); +} + +size_t PsychicRequest::contentLength() { + return this->_req->content_len; +} + +const String& PsychicRequest::body() +{ + return this->_body; +} + +bool PsychicRequest::isMultipart() +{ + const String& type = this->contentType(); + + return (this->contentType().indexOf("multipart/form-data") >= 0); +} + +esp_err_t PsychicRequest::redirect(const char *url) +{ + PsychicResponse response(this); + response.setCode(301); + response.addHeader("Location", url); + + return response.send(); +} + +bool PsychicRequest::hasCookie(const char *key) +{ + char cookie[MAX_COOKIE_SIZE]; + size_t cookieSize = MAX_COOKIE_SIZE; + esp_err_t err = httpd_req_get_cookie_val(this->_req, key, cookie, &cookieSize); + + //did we get anything? + if (err == ESP_OK) + return true; + else if (err == ESP_ERR_HTTPD_RESULT_TRUNC) + ESP_LOGE(PH_TAG, "cookie too large (%d bytes).\n", cookieSize); + + return false; +} + +const String PsychicRequest::getCookie(const char *key) +{ + char cookie[MAX_COOKIE_SIZE]; + size_t cookieSize = MAX_COOKIE_SIZE; + esp_err_t err = httpd_req_get_cookie_val(this->_req, key, cookie, &cookieSize); + + //did we get anything? + if (err == ESP_OK) + return String(cookie); + else + return ""; +} + +void PsychicRequest::loadParams() +{ + //did we get a query string? + size_t query_len = httpd_req_get_url_query_len(_req); + if (query_len) + { + char query[query_len+1]; + httpd_req_get_url_query_str(_req, query, sizeof(query)); + _query.concat(query); + + //parse them. + _addParams(_query, false); + } + + //did we get form data as body? + if (this->method() == HTTP_POST && this->contentType().startsWith("application/x-www-form-urlencoded")) + { + _addParams(_body, true); + } +} + +void PsychicRequest::_addParams(const String& params, bool post){ + size_t start = 0; + while (start < params.length()){ + int end = params.indexOf('&', start); + if (end < 0) end = params.length(); + int equal = params.indexOf('=', start); + if (equal < 0 || equal > end) equal = end; + String name = params.substring(start, equal); + String value = equal + 1 < end ? params.substring(equal + 1, end) : String(); + addParam(name, value, true, post); + start = end + 1; + } +} + +PsychicWebParameter * PsychicRequest::addParam(const String &name, const String &value, bool decode, bool post) +{ + if (decode) + return addParam(new PsychicWebParameter(urlDecode(name.c_str()), urlDecode(value.c_str()), post)); + else + return addParam(new PsychicWebParameter(name, value, post)); +} + +PsychicWebParameter * PsychicRequest::addParam(PsychicWebParameter *param) { + // ESP_LOGD(PH_TAG, "Adding param: '%s' = '%s'", param->name().c_str(), param->value().c_str()); + _params.push_back(param); + return param; +} + +bool PsychicRequest::hasParam(const char *key) +{ + return getParam(key) != NULL; +} + +PsychicWebParameter * PsychicRequest::getParam(const char *key) +{ + for (auto *param : _params) + if (param->name().equals(key)) + return param; + + return NULL; +} + +bool PsychicRequest::hasSessionKey(const String& key) +{ + return this->_session->find(key) != this->_session->end(); +} + +const String PsychicRequest::getSessionKey(const String& key) +{ + auto it = this->_session->find(key); + if (it != this->_session->end()) + return it->second; + else + return ""; +} + +void PsychicRequest::setSessionKey(const String& key, const String& value) +{ + this->_session->insert(std::pair(key, value)); +} + +static const String md5str(const String &in){ + MD5Builder md5 = MD5Builder(); + md5.begin(); + md5.add(in); + md5.calculate(); + return md5.toString(); +} + +bool PsychicRequest::authenticate(const char * username, const char * password) +{ + if(hasHeader("Authorization")) + { + String authReq = header("Authorization"); + if(authReq.startsWith("Basic")){ + authReq = authReq.substring(6); + authReq.trim(); + char toencodeLen = strlen(username)+strlen(password)+1; + char *toencode = new char[toencodeLen + 1]; + if(toencode == NULL){ + authReq = ""; + return false; + } + char *encoded = new char[base64_encode_expected_len(toencodeLen)+1]; + if(encoded == NULL){ + authReq = ""; + delete[] toencode; + return false; + } + sprintf(toencode, "%s:%s", username, password); + if(base64_encode_chars(toencode, toencodeLen, encoded) > 0 && authReq.equalsConstantTime(encoded)) { + authReq = ""; + delete[] toencode; + delete[] encoded; + return true; + } + delete[] toencode; + delete[] encoded; + } + else if(authReq.startsWith(F("Digest"))) + { + authReq = authReq.substring(7); + String _username = _extractParam(authReq,F("username=\""),'\"'); + if(!_username.length() || _username != String(username)) { + authReq = ""; + return false; + } + // extracting required parameters for RFC 2069 simpler Digest + String _realm = _extractParam(authReq, F("realm=\""),'\"'); + String _nonce = _extractParam(authReq, F("nonce=\""),'\"'); + String _uri = _extractParam(authReq, F("uri=\""),'\"'); + String _resp = _extractParam(authReq, F("response=\""),'\"'); + String _opaque = _extractParam(authReq, F("opaque=\""),'\"'); + + if((!_realm.length()) || (!_nonce.length()) || (!_uri.length()) || (!_resp.length()) || (!_opaque.length())) { + authReq = ""; + return false; + } + if((_opaque != this->getSessionKey("opaque")) || (_nonce != this->getSessionKey("nonce")) || (_realm != this->getSessionKey("realm"))) + { + authReq = ""; + return false; + } + // parameters for the RFC 2617 newer Digest + String _nc,_cnonce; + if(authReq.indexOf("qop=auth") != -1 || authReq.indexOf("qop=\"auth\"") != -1) { + _nc = _extractParam(authReq, F("nc="), ','); + _cnonce = _extractParam(authReq, F("cnonce=\""),'\"'); + } + + String _H1 = md5str(String(username) + ':' + _realm + ':' + String(password)); + //ESP_LOGD(PH_TAG, "Hash of user:realm:pass=%s", _H1.c_str()); + + String _H2 = ""; + if(_method == HTTP_GET){ + _H2 = md5str(String(F("GET:")) + _uri); + }else if(_method == HTTP_POST){ + _H2 = md5str(String(F("POST:")) + _uri); + }else if(_method == HTTP_PUT){ + _H2 = md5str(String(F("PUT:")) + _uri); + }else if(_method == HTTP_DELETE){ + _H2 = md5str(String(F("DELETE:")) + _uri); + }else{ + _H2 = md5str(String(F("GET:")) + _uri); + } + //ESP_LOGD(PH_TAG, "Hash of GET:uri=%s", _H2.c_str()); + + String _responsecheck = ""; + if(authReq.indexOf("qop=auth") != -1 || authReq.indexOf("qop=\"auth\"") != -1) { + _responsecheck = md5str(_H1 + ':' + _nonce + ':' + _nc + ':' + _cnonce + F(":auth:") + _H2); + } else { + _responsecheck = md5str(_H1 + ':' + _nonce + ':' + _H2); + } + + //ESP_LOGD(PH_TAG, "The Proper response=%s", _responsecheck.c_str()); + if(_resp == _responsecheck){ + authReq = ""; + return true; + } + } + authReq = ""; + } + return false; +} + +const String PsychicRequest::_extractParam(const String& authReq, const String& param, const char delimit) +{ + int _begin = authReq.indexOf(param); + if (_begin == -1) + return ""; + return authReq.substring(_begin+param.length(),authReq.indexOf(delimit,_begin+param.length())); +} + +const String PsychicRequest::_getRandomHexString() +{ + char buffer[33]; // buffer to hold 32 Hex Digit + /0 + int i; + for(i = 0; i < 4; i++) { + sprintf (buffer + (i*8), "%08lx", (unsigned long int)esp_random()); + } + return String(buffer); +} + +esp_err_t PsychicRequest::requestAuthentication(HTTPAuthMethod mode, const char* realm, const char* authFailMsg) +{ + //what is thy realm, sire? + if(!strcmp(realm, "")) + this->setSessionKey("realm", "Login Required"); + else + this->setSessionKey("realm", realm); + + PsychicResponse response(this); + String authStr; + + //what kind of auth? + if(mode == BASIC_AUTH) + { + authStr = "Basic realm=\"" + this->getSessionKey("realm") + "\""; + response.addHeader("WWW-Authenticate", authStr.c_str()); + } + else + { + //only make new ones if we havent sent them yet + if (this->getSessionKey("nonce").isEmpty()) + this->setSessionKey("nonce", _getRandomHexString()); + if (this->getSessionKey("opaque").isEmpty()) + this->setSessionKey("opaque", _getRandomHexString()); + + authStr = "Digest realm=\"" + this->getSessionKey("realm") + "\", qop=\"auth\", nonce=\"" + this->getSessionKey("nonce") + "\", opaque=\"" + this->getSessionKey("opaque") + "\""; + response.addHeader("WWW-Authenticate", authStr.c_str()); + } + + response.setCode(401); + response.setContentType("text/html"); + response.setContent(authStr.c_str()); + return response.send(); +} + +esp_err_t PsychicRequest::reply(int code) +{ + PsychicResponse response(this); + + response.setCode(code); + response.setContentType("text/plain"); + response.setContent(http_status_reason(code)); + + return response.send(); +} + +esp_err_t PsychicRequest::reply(const char *content) +{ + PsychicResponse response(this); + + response.setCode(200); + response.setContentType("text/html"); + response.setContent(content); + + return response.send(); +} + +esp_err_t PsychicRequest::reply(int code, const char *contentType, const char *content) +{ + PsychicResponse response(this); + + response.setCode(code); + response.setContentType(contentType); + response.setContent(content); + + return response.send(); +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicRequest.h b/lib/PsychicHttp/src/PsychicRequest.h new file mode 100644 index 0000000..fe48a1b --- /dev/null +++ b/lib/PsychicHttp/src/PsychicRequest.h @@ -0,0 +1,98 @@ +#ifndef PsychicRequest_h +#define PsychicRequest_h + +#include "PsychicCore.h" +#include "PsychicHttpServer.h" +#include "PsychicClient.h" +#include "PsychicWebParameter.h" +#include "PsychicResponse.h" + +typedef std::map SessionData; + +enum Disposition { NONE, INLINE, ATTACHMENT, FORM_DATA}; + +struct ContentDisposition { + Disposition disposition; + String filename; + String name; +}; + +class PsychicRequest { + friend PsychicHttpServer; + + protected: + PsychicHttpServer *_server; + httpd_req_t *_req; + SessionData *_session; + PsychicClient *_client; + + http_method _method; + String _uri; + String _query; + String _body; + + std::list _params; + + void _addParams(const String& params, bool post); + void _parseGETParams(); + void _parsePOSTParams(); + + const String _extractParam(const String& authReq, const String& param, const char delimit); + const String _getRandomHexString(); + + public: + PsychicRequest(PsychicHttpServer *server, httpd_req_t *req); + virtual ~PsychicRequest(); + + void *_tempObject; + + PsychicHttpServer * server(); + httpd_req_t * request(); + virtual PsychicClient * client(); + + bool isMultipart(); + esp_err_t loadBody(); + + const String header(const char *name); + bool hasHeader(const char *name); + + static void freeSession(void *ctx); + bool hasSessionKey(const String& key); + const String getSessionKey(const String& key); + void setSessionKey(const String& key, const String& value); + + bool hasCookie(const char * key); + const String getCookie(const char * key); + + http_method method(); // returns the HTTP method used as enum value (eg. HTTP_GET) + const String methodStr(); // returns the HTTP method used as a string (eg. "GET") + const String path(); // returns the request path (eg /page?foo=bar returns "/page") + const String& uri(); // returns the full request uri (eg /page?foo=bar) + const String& query(); // returns the request query data (eg /page?foo=bar returns "foo=bar") + const String host(); // returns the requested host (request to http://psychic.local/foo will return "psychic.local") + const String contentType(); // returns the Content-Type header value + size_t contentLength(); // returns the Content-Length header value + const String& body(); // returns the body of the request + const ContentDisposition getContentDisposition(); + + const String& queryString() { return query(); } //compatability function. same as query() + const String& url() { return uri(); } //compatability function. same as uri() + + void loadParams(); + PsychicWebParameter * addParam(PsychicWebParameter *param); + PsychicWebParameter * addParam(const String &name, const String &value, bool decode = true, bool post = false); + bool hasParam(const char *key); + PsychicWebParameter * getParam(const char *name); + + const String getFilename(); + + bool authenticate(const char * username, const char * password); + esp_err_t requestAuthentication(HTTPAuthMethod mode, const char* realm, const char* authFailMsg); + + esp_err_t redirect(const char *url); + esp_err_t reply(int code); + esp_err_t reply(const char *content); + esp_err_t reply(int code, const char *contentType, const char *content); +}; + +#endif // PsychicRequest_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicResponse.cpp b/lib/PsychicHttp/src/PsychicResponse.cpp new file mode 100644 index 0000000..5046441 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicResponse.cpp @@ -0,0 +1,162 @@ +#include "PsychicResponse.h" +#include "PsychicRequest.h" +#include + +PsychicResponse::PsychicResponse(PsychicRequest *request) : + _request(request), + _code(200), + _status(""), + _contentLength(0), + _body("") +{ +} + +PsychicResponse::~PsychicResponse() +{ + //clean up our header variables. we have to do this on desctruct since httpd_resp_send doesn't store copies + for (HTTPHeader header : _headers) + { + free(header.field); + free(header.value); + } + _headers.clear(); +} + +void PsychicResponse::addHeader(const char *field, const char *value) +{ + //these get freed after send by the destructor + HTTPHeader header; + header.field =(char *)malloc(strlen(field)+1); + header.value = (char *)malloc(strlen(value)+1); + + strlcpy(header.field, field, strlen(field)+1); + strlcpy(header.value, value, strlen(value)+1); + + _headers.push_back(header); +} + +void PsychicResponse::setCookie(const char *name, const char *value, unsigned long secondsFromNow, const char *extras) +{ + time_t now = time(nullptr); + + String output; + output = urlEncode(name) + "=" + urlEncode(value); + + //if current time isn't modern, default to using max age + if (now < 1700000000) + output += "; Max-Age=" + String(secondsFromNow); + //otherwise, set an expiration date + else + { + time_t expirationTimestamp = now + secondsFromNow; + + // Convert the expiration timestamp to a formatted string for the "expires" attribute + struct tm* tmInfo = gmtime(&expirationTimestamp); + char expires[30]; + strftime(expires, sizeof(expires), "%a, %d %b %Y %H:%M:%S GMT", tmInfo); + output += "; Expires=" + String(expires); + } + + //did we get any extras? + if (strlen(extras)) + output += "; " + String(extras); + + //okay, add it in. + addHeader("Set-Cookie", output.c_str()); +} + +void PsychicResponse::setCode(int code) +{ + _code = code; +} + +void PsychicResponse::setContentType(const char *contentType) +{ + httpd_resp_set_type(_request->request(), contentType); +} + +void PsychicResponse::setContent(const char *content) +{ + _body = content; + setContentLength(strlen(content)); +} + +void PsychicResponse::setContent(const uint8_t *content, size_t len) +{ + _body = (char *)content; + setContentLength(len); +} + +const char * PsychicResponse::getContent() +{ + return _body; +} + +size_t PsychicResponse::getContentLength() +{ + return _contentLength; +} + +esp_err_t PsychicResponse::send() +{ + //esp-idf makes you set the whole status. + sprintf(_status, "%u %s", _code, http_status_reason(_code)); + httpd_resp_set_status(_request->request(), _status); + + //our headers too + this->sendHeaders(); + + //now send it off + esp_err_t err = httpd_resp_send(_request->request(), getContent(), getContentLength()); + + //did something happen? + if (err != ESP_OK) + ESP_LOGE(PH_TAG, "Send response failed (%s)", esp_err_to_name(err)); + + return err; +} + +void PsychicResponse::sendHeaders() +{ + //get our global headers out of the way first + for (HTTPHeader header : DefaultHeaders::Instance().getHeaders()) + httpd_resp_set_hdr(_request->request(), header.field, header.value); + + //now do our individual headers + for (HTTPHeader header : _headers) + httpd_resp_set_hdr(this->_request->request(), header.field, header.value); + + // DO NOT RELEASE HEADERS HERE... released in the PsychicResponse destructor after they have been sent. + // httpd_resp_set_hdr just passes on the pointer, but its needed after this call. + // clean up our header variables after send + // for (HTTPHeader header : _headers) + // { + // free(header.field); + // free(header.value); + // } + // _headers.clear(); +} + +esp_err_t PsychicResponse::sendChunk(uint8_t *chunk, size_t chunksize) +{ + /* Send the buffer contents as HTTP response chunk */ + esp_err_t err = httpd_resp_send_chunk(this->_request->request(), (char *)chunk, chunksize); + if (err != ESP_OK) + { + ESP_LOGE(PH_TAG, "File sending failed (%s)", esp_err_to_name(err)); + + /* Abort sending file */ + httpd_resp_sendstr_chunk(this->_request->request(), NULL); + + /* Respond with 500 Internal Server Error */ + httpd_resp_send_err(this->_request->request(), HTTPD_500_INTERNAL_SERVER_ERROR, "Failed to send file"); + } + + return err; +} + +esp_err_t PsychicResponse::finishChunking() +{ + /* Respond with an empty chunk to signal HTTP response completion */ + return httpd_resp_send_chunk(this->_request->request(), NULL, 0); +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicResponse.h b/lib/PsychicHttp/src/PsychicResponse.h new file mode 100644 index 0000000..a36de65 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicResponse.h @@ -0,0 +1,46 @@ +#ifndef PsychicResponse_h +#define PsychicResponse_h + +#include "PsychicCore.h" +#include "time.h" + +class PsychicRequest; + +class PsychicResponse +{ + protected: + PsychicRequest *_request; + + int _code; + char _status[60]; + std::list _headers; + int64_t _contentLength; + const char * _body; + + public: + PsychicResponse(PsychicRequest *request); + virtual ~PsychicResponse(); + + void setCode(int code); + + void setContentType(const char *contentType); + void setContentLength(int64_t contentLength) { _contentLength = contentLength; } + int64_t getContentLength(int64_t contentLength) { return _contentLength; } + + void addHeader(const char *field, const char *value); + + void setCookie(const char *key, const char *value, unsigned long max_age = 60*60*24*30, const char *extras = ""); + + void setContent(const char *content); + void setContent(const uint8_t *content, size_t len); + + const char * getContent(); + size_t getContentLength(); + + virtual esp_err_t send(); + void sendHeaders(); + esp_err_t sendChunk(uint8_t *chunk, size_t chunksize); + esp_err_t finishChunking(); +}; + +#endif // PsychicResponse_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicStaticFileHander.cpp b/lib/PsychicHttp/src/PsychicStaticFileHander.cpp new file mode 100644 index 0000000..54fafc4 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicStaticFileHander.cpp @@ -0,0 +1,181 @@ +#include "PsychicStaticFileHandler.h" + +/*************************************/ +/* PsychicStaticFileHandler */ +/*************************************/ + +PsychicStaticFileHandler::PsychicStaticFileHandler(const char* uri, FS& fs, const char* path, const char* cache_control) + : _fs(fs), _uri(uri), _path(path), _default_file("index.html"), _cache_control(cache_control), _last_modified("") +{ + // Ensure leading '/' + if (_uri.length() == 0 || _uri[0] != '/') _uri = "/" + _uri; + if (_path.length() == 0 || _path[0] != '/') _path = "/" + _path; + + // If path ends with '/' we assume a hint that this is a directory to improve performance. + // However - if it does not end with '/' we, can't assume a file, path can still be a directory. + _isDir = _path[_path.length()-1] == '/'; + + // Remove the trailing '/' so we can handle default file + // Notice that root will be "" not "/" + if (_uri[_uri.length()-1] == '/') _uri = _uri.substring(0, _uri.length()-1); + if (_path[_path.length()-1] == '/') _path = _path.substring(0, _path.length()-1); + + // Reset stats + _gzipFirst = false; + _gzipStats = 0xF8; +} + +PsychicStaticFileHandler& PsychicStaticFileHandler::setIsDir(bool isDir){ + _isDir = isDir; + return *this; +} + +PsychicStaticFileHandler& PsychicStaticFileHandler::setDefaultFile(const char* filename){ + _default_file = String(filename); + return *this; +} + +PsychicStaticFileHandler& PsychicStaticFileHandler::setCacheControl(const char* cache_control){ + _cache_control = String(cache_control); + return *this; +} + +PsychicStaticFileHandler& PsychicStaticFileHandler::setLastModified(const char* last_modified){ + _last_modified = String(last_modified); + return *this; +} + +PsychicStaticFileHandler& PsychicStaticFileHandler::setLastModified(struct tm* last_modified){ + char result[30]; + strftime (result,30,"%a, %d %b %Y %H:%M:%S %Z", last_modified); + return setLastModified((const char *)result); +} + +bool PsychicStaticFileHandler::canHandle(PsychicRequest *request) +{ + if(request->method() != HTTP_GET || !request->uri().startsWith(_uri) ) + return false; + + if (_getFile(request)) + return true; + + return false; +} + +bool PsychicStaticFileHandler::_getFile(PsychicRequest *request) +{ + // Remove the found uri + String path = request->uri().substring(_uri.length()); + + // We can skip the file check and look for default if request is to the root of a directory or that request path ends with '/' + bool canSkipFileCheck = (_isDir && path.length() == 0) || (path.length() && path[path.length()-1] == '/'); + + path = _path + path; + + // Do we have a file or .gz file + if (!canSkipFileCheck && _fileExists(path)) + return true; + + // Can't handle if not default file + if (_default_file.length() == 0) + return false; + + // Try to add default file, ensure there is a trailing '/' ot the path. + if (path.length() == 0 || path[path.length()-1] != '/') + path += "/"; + path += _default_file; + + return _fileExists(path); +} + +#define FILE_IS_REAL(f) (f == true && !f.isDirectory()) + +bool PsychicStaticFileHandler::_fileExists(const String& path) +{ + bool fileFound = false; + bool gzipFound = false; + + String gzip = path + ".gz"; + + if (_gzipFirst) { + _file = _fs.open(gzip, "r"); + gzipFound = FILE_IS_REAL(_file); + if (!gzipFound){ + _file = _fs.open(path, "r"); + fileFound = FILE_IS_REAL(_file); + } + } else { + _file = _fs.open(path, "r"); + fileFound = FILE_IS_REAL(_file); + if (!fileFound){ + _file = _fs.open(gzip, "r"); + gzipFound = FILE_IS_REAL(_file); + } + } + + bool found = fileFound || gzipFound; + + if (found) + { + _filename = path; + + // Calculate gzip statistic + _gzipStats = (_gzipStats << 1) + (gzipFound ? 1 : 0); + if (_gzipStats == 0x00) _gzipFirst = false; // All files are not gzip + else if (_gzipStats == 0xFF) _gzipFirst = true; // All files are gzip + else _gzipFirst = _countBits(_gzipStats) > 4; // IF we have more gzip files - try gzip first + } + + return found; +} + +uint8_t PsychicStaticFileHandler::_countBits(const uint8_t value) const +{ + uint8_t w = value; + uint8_t n; + for (n=0; w!=0; n++) w&=w-1; + return n; +} + +esp_err_t PsychicStaticFileHandler::handleRequest(PsychicRequest *request) +{ + if (_file == true) + { + //is it not modified? + String etag = String(_file.size()); + if (_last_modified.length() && _last_modified == request->header("If-Modified-Since")) + { + _file.close(); + request->reply(304); // Not modified + } + //does our Etag match? + else if (_cache_control.length() && request->hasHeader("If-None-Match") && request->header("If-None-Match").equals(etag)) + { + _file.close(); + + PsychicResponse response(request); + response.addHeader("Cache-Control", _cache_control.c_str()); + response.addHeader("ETag", etag.c_str()); + response.setCode(304); + response.send(); + } + //nope, send them the full file. + else + { + PsychicFileResponse response(request, _fs, _filename); + + if (_last_modified.length()) + response.addHeader("Last-Modified", _last_modified.c_str()); + if (_cache_control.length()) { + response.addHeader("Cache-Control", _cache_control.c_str()); + response.addHeader("ETag", etag.c_str()); + } + + return response.send(); + } + } else { + return request->reply(404); + } + + return ESP_OK; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicStaticFileHandler.h b/lib/PsychicHttp/src/PsychicStaticFileHandler.h new file mode 100644 index 0000000..f757111 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicStaticFileHandler.h @@ -0,0 +1,41 @@ +#ifndef PsychicStaticFileHandler_h +#define PsychicStaticFileHandler_h + +#include "PsychicCore.h" +#include "PsychicWebHandler.h" +#include "PsychicRequest.h" +#include "PsychicResponse.h" +#include "PsychicFileResponse.h" + +class PsychicStaticFileHandler : public PsychicWebHandler { + using File = fs::File; + using FS = fs::FS; + private: + bool _getFile(PsychicRequest *request); + bool _fileExists(const String& path); + uint8_t _countBits(const uint8_t value) const; + protected: + FS _fs; + File _file; + String _filename; + String _uri; + String _path; + String _default_file; + String _cache_control; + String _last_modified; + bool _isDir; + bool _gzipFirst; + uint8_t _gzipStats; + public: + PsychicStaticFileHandler(const char* uri, FS& fs, const char* path, const char* cache_control); + bool canHandle(PsychicRequest *request) override; + esp_err_t handleRequest(PsychicRequest *request) override; + PsychicStaticFileHandler& setIsDir(bool isDir); + PsychicStaticFileHandler& setDefaultFile(const char* filename); + PsychicStaticFileHandler& setCacheControl(const char* cache_control); + PsychicStaticFileHandler& setLastModified(const char* last_modified); + PsychicStaticFileHandler& setLastModified(struct tm* last_modified); + //PsychicStaticFileHandler& setTemplateProcessor(AwsTemplateProcessor newCallback) {_callback = newCallback; return *this;} +}; + +#endif /* PsychicHttp_h */ \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicStreamResponse.cpp b/lib/PsychicHttp/src/PsychicStreamResponse.cpp new file mode 100644 index 0000000..5132104 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicStreamResponse.cpp @@ -0,0 +1,94 @@ +#include "PsychicStreamResponse.h" +#include "PsychicResponse.h" +#include "PsychicRequest.h" + +PsychicStreamResponse::PsychicStreamResponse(PsychicRequest *request, const String& contentType) + : PsychicResponse(request), _buffer(NULL) { + + setContentType(contentType.c_str()); + addHeader("Content-Disposition", "inline"); +} + + +PsychicStreamResponse::PsychicStreamResponse(PsychicRequest *request, const String& contentType, const String& name) + : PsychicResponse(request), _buffer(NULL) { + + setContentType(contentType.c_str()); + + char buf[26+name.length()]; + snprintf(buf, sizeof (buf), "attachment; filename=\"%s\"", name.c_str()); + addHeader("Content-Disposition", buf); +} + + +PsychicStreamResponse::~PsychicStreamResponse() +{ + endSend(); +} + + +esp_err_t PsychicStreamResponse::beginSend() +{ + if(_buffer) + return ESP_OK; + + //Buffer to hold ChunkPrinter and stream buffer. Using placement new will keep us at a single allocation. + _buffer = (uint8_t*)malloc(STREAM_CHUNK_SIZE + sizeof(ChunkPrinter)); + + if(!_buffer) + { + /* Respond with 500 Internal Server Error */ + httpd_resp_send_err(_request->request(), HTTPD_500_INTERNAL_SERVER_ERROR, "Unable to allocate memory."); + return ESP_FAIL; + } + + _printer = new (_buffer) ChunkPrinter(this, _buffer + sizeof(ChunkPrinter), STREAM_CHUNK_SIZE); + + sendHeaders(); + return ESP_OK; +} + + +esp_err_t PsychicStreamResponse::endSend() +{ + esp_err_t err = ESP_OK; + + if(!_buffer) + err = ESP_FAIL; + else + { + _printer->~ChunkPrinter(); //flushed on destruct + err = finishChunking(); + free(_buffer); + _buffer = NULL; + } + return err; +} + + +void PsychicStreamResponse::flush() +{ + if(_buffer) + _printer->flush(); +} + + +size_t PsychicStreamResponse::write(uint8_t data) +{ + return _buffer ? _printer->write(data) : 0; +} + + +size_t PsychicStreamResponse::write(const uint8_t *buffer, size_t size) +{ + return _buffer ? _printer->write(buffer, size) : 0; +} + + +size_t PsychicStreamResponse::copyFrom(Stream &stream) +{ + if(_buffer) + return _printer->copyFrom(stream); + + return 0; +} diff --git a/lib/PsychicHttp/src/PsychicStreamResponse.h b/lib/PsychicHttp/src/PsychicStreamResponse.h new file mode 100644 index 0000000..888ec9c --- /dev/null +++ b/lib/PsychicHttp/src/PsychicStreamResponse.h @@ -0,0 +1,35 @@ +#ifndef PsychicStreamResponse_h +#define PsychicStreamResponse_h + +#include "PsychicCore.h" +#include "PsychicResponse.h" +#include "ChunkPrinter.h" + +class PsychicRequest; + +class PsychicStreamResponse : public PsychicResponse, public Print +{ + private: + ChunkPrinter *_printer; + uint8_t *_buffer; + public: + + PsychicStreamResponse(PsychicRequest *request, const String& contentType); + PsychicStreamResponse(PsychicRequest *request, const String& contentType, const String& name); //Download + + ~PsychicStreamResponse(); + + esp_err_t beginSend(); + esp_err_t endSend(); + + void flush() override; + + size_t write(uint8_t data) override; + size_t write(const uint8_t *buffer, size_t size) override; + + size_t copyFrom(Stream &stream); + + using Print::write; +}; + +#endif // PsychicStreamResponse_h diff --git a/lib/PsychicHttp/src/PsychicUploadHandler.cpp b/lib/PsychicHttp/src/PsychicUploadHandler.cpp new file mode 100644 index 0000000..d8a55e3 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicUploadHandler.cpp @@ -0,0 +1,395 @@ +#include "PsychicUploadHandler.h" + +PsychicUploadHandler::PsychicUploadHandler() : + PsychicWebHandler() + , _temp() + , _parsedLength(0) + , _multiParseState(EXPECT_BOUNDARY) + , _boundaryPosition(0) + , _itemStartIndex(0) + , _itemSize(0) + , _itemName() + , _itemFilename() + , _itemType() + , _itemValue() + , _itemBuffer(0) + , _itemBufferIndex(0) + , _itemIsFile(false) + {} +PsychicUploadHandler::~PsychicUploadHandler() {} + +bool PsychicUploadHandler::canHandle(PsychicRequest *request) { + return true; +} + +esp_err_t PsychicUploadHandler::handleRequest(PsychicRequest *request) +{ + esp_err_t err = ESP_OK; + + //save it for later (multipart) + _request = request; + _parsedLength = 0; + /* File cannot be larger than a limit */ + if (request->contentLength() > request->server()->maxUploadSize) + { + ESP_LOGE(PH_TAG, "File too large : %d bytes", request->contentLength()); + + /* Respond with 400 Bad Request */ + char error[50]; + sprintf(error, "File size must be less than %lu bytes!", request->server()->maxUploadSize); + httpd_resp_send_err(request->request(), HTTPD_400_BAD_REQUEST, error); + + /* Return failure to close underlying connection else the incoming file content will keep the socket busy */ + return ESP_FAIL; + } + + //we might want to access some of these params + request->loadParams(); + + //TODO: support for the 100 header. not sure if we can do it. + // if (request->header("Expect").equals("100-continue")) + // { + // char response[] = "100 Continue"; + // httpd_socket_send(self->server, httpd_req_to_sockfd(req), response, strlen(response), 0); + // } + + //2 types of upload requests + if (request->isMultipart()) + err = _multipartUploadHandler(request); + else + err = _basicUploadHandler(request); + + //we can also call onRequest for some final processing and response + if (err == ESP_OK) + { + if (_requestCallback != NULL) + err = _requestCallback(request); + else + err = request->reply("Upload Successful."); + } + else + request->reply(500, "text/html", "Error processing upload."); + + return err; +} + +esp_err_t PsychicUploadHandler::_basicUploadHandler(PsychicRequest *request) +{ + esp_err_t err = ESP_OK; + + String filename = request->getFilename(); + + /* Retrieve the pointer to scratch buffer for temporary storage */ + char *buf = (char *)malloc(FILE_CHUNK_SIZE); + int received; + unsigned long index = 0; + + /* Content length of the request gives the size of the file being uploaded */ + int remaining = request->contentLength(); + + while (remaining > 0) + { + #ifdef ENABLE_ASYNC + httpd_sess_update_lru_counter(request->server()->server, request->client()->socket()); + #endif + + //ESP_LOGD(PH_TAG, "Remaining size : %d", remaining); + + /* Receive the file part by part into a buffer */ + if ((received = httpd_req_recv(request->request(), buf, min(remaining, FILE_CHUNK_SIZE))) <= 0) + { + /* Retry if timeout occurred */ + if (received == HTTPD_SOCK_ERR_TIMEOUT) + continue; + //bail if we got an error + else if (received == HTTPD_SOCK_ERR_FAIL) + { + ESP_LOGE(PH_TAG, "Socket error"); + err = ESP_FAIL; + break; + } + } + + //call our upload callback here. + if (_uploadCallback != NULL) + { + err = _uploadCallback(request, filename, index, (uint8_t *)buf, received, (remaining - received == 0)); + if (err != ESP_OK) + break; + } + else + { + ESP_LOGE(PH_TAG, "No upload callback specified!"); + err = ESP_FAIL; + break; + } + + /* Keep track of remaining size of the file left to be uploaded */ + remaining -= received; + index += received; + } + + //dont forget to free our buffer + free(buf); + + return err; +} + +esp_err_t PsychicUploadHandler::_multipartUploadHandler(PsychicRequest *request) +{ + esp_err_t err = ESP_OK; + + String value = request->header("Content-Type"); + if (value.startsWith("multipart/")){ + _boundary = value.substring(value.indexOf('=')+1); + _boundary.replace("\"",""); + } else { + ESP_LOGE(PH_TAG, "No multipart boundary found."); + return request->reply(400, "text/html", "No multipart boundary found."); + } + + char *buf = (char *)malloc(FILE_CHUNK_SIZE); + int received; + unsigned long index = 0; + + /* Content length of the request gives the size of the file being uploaded */ + int remaining = request->contentLength(); + + while (remaining > 0) + { + #ifdef ENABLE_ASYNC + httpd_sess_update_lru_counter(request->server()->server, request->client()->socket()); + #endif + + //ESP_LOGD(PH_TAG, "Remaining size : %d", remaining); + + /* Receive the file part by part into a buffer */ + if ((received = httpd_req_recv(request->request(), buf, min(remaining, FILE_CHUNK_SIZE))) <= 0) + { + /* Retry if timeout occurred */ + if (received == HTTPD_SOCK_ERR_TIMEOUT) + continue; + //bail if we got an error + else if (received == HTTPD_SOCK_ERR_FAIL) + { + ESP_LOGE(PH_TAG, "Socket error"); + err = ESP_FAIL; + break; + } + } + + //parse it 1 byte at a time. + for (int i=0; i 12 && _temp.substring(0, 12).equalsIgnoreCase("Content-Type")){ + _itemType = _temp.substring(14); + _itemIsFile = true; + } else if(_temp.length() > 19 && _temp.substring(0, 19).equalsIgnoreCase("Content-Disposition")){ + _temp = _temp.substring(_temp.indexOf(';') + 2); + while(_temp.indexOf(';') > 0){ + String name = _temp.substring(0, _temp.indexOf('=')); + String nameVal = _temp.substring(_temp.indexOf('=') + 2, _temp.indexOf(';') - 1); + if(name == "name"){ + _itemName = nameVal; + } else if(name == "filename"){ + _itemFilename = nameVal; + _itemIsFile = true; + } + _temp = _temp.substring(_temp.indexOf(';') + 2); + } + String name = _temp.substring(0, _temp.indexOf('=')); + String nameVal = _temp.substring(_temp.indexOf('=') + 2, _temp.length() - 1); + if(name == "name"){ + _itemName = nameVal; + } else if(name == "filename"){ + _itemFilename = nameVal; + _itemIsFile = true; + } + } + _temp = String(); + } else { + _multiParseState = WAIT_FOR_RETURN1; + //value starts from here + _itemSize = 0; + _itemStartIndex = _parsedLength; + _itemValue = String(); + if(_itemIsFile){ + if(_itemBuffer) + free(_itemBuffer); + _itemBuffer = (uint8_t*)malloc(FILE_CHUNK_SIZE); + if(_itemBuffer == NULL){ + ESP_LOGE(PH_TAG, "Multipart: Failed to allocate buffer"); + _multiParseState = PARSE_ERROR; + return; + } + _itemBufferIndex = 0; + } + } + } + } else if(_multiParseState == EXPECT_FEED1){ + if(data != '\n'){ + _multiParseState = WAIT_FOR_RETURN1; + itemWriteByte('\r'); _parseMultipartPostByte(data, last); + } else { + _multiParseState = EXPECT_DASH1; + } + } else if(_multiParseState == EXPECT_DASH1){ + if(data != '-'){ + _multiParseState = WAIT_FOR_RETURN1; + itemWriteByte('\r'); itemWriteByte('\n'); _parseMultipartPostByte(data, last); + } else { + _multiParseState = EXPECT_DASH2; + } + } else if(_multiParseState == EXPECT_DASH2){ + if(data != '-'){ + _multiParseState = WAIT_FOR_RETURN1; + itemWriteByte('\r'); itemWriteByte('\n'); itemWriteByte('-'); _parseMultipartPostByte(data, last); + } else { + _multiParseState = BOUNDARY_OR_DATA; + _boundaryPosition = 0; + } + } else if(_multiParseState == BOUNDARY_OR_DATA){ + if(_boundaryPosition < _boundary.length() && _boundary.c_str()[_boundaryPosition] != data){ + _multiParseState = WAIT_FOR_RETURN1; + itemWriteByte('\r'); itemWriteByte('\n'); itemWriteByte('-'); itemWriteByte('-'); + uint8_t i; + for(i=0; i<_boundaryPosition; i++) + itemWriteByte(_boundary.c_str()[i]); + _parseMultipartPostByte(data, last); + } else if(_boundaryPosition == _boundary.length() - 1){ + _multiParseState = DASH3_OR_RETURN2; + if(!_itemIsFile){ + _request->addParam(_itemName, _itemValue); + //_addParam(new AsyncWebParameter(_itemName, _itemValue, true)); + } else { + if(_itemSize){ + if(_uploadCallback) + _uploadCallback(_request, _itemFilename, _itemSize - _itemBufferIndex, _itemBuffer, _itemBufferIndex, true); + _itemBufferIndex = 0; + _request->addParam(new PsychicWebParameter(_itemName, _itemFilename, true, true, _itemSize)); + } + free(_itemBuffer); + _itemBuffer = NULL; + } + + } else { + _boundaryPosition++; + } + } else if(_multiParseState == DASH3_OR_RETURN2){ + if(data == '-' && (_request->contentLength() - _parsedLength - 4) != 0){ + ESP_LOGE(PH_TAG, "ERROR: The parser got to the end of the POST but is expecting more bytes!"); + _multiParseState = PARSE_ERROR; + return; + } + if(data == '\r'){ + _multiParseState = EXPECT_FEED2; + } else if(data == '-' && _request->contentLength() == (_parsedLength + 4)){ + _multiParseState = PARSING_FINISHED; + } else { + _multiParseState = WAIT_FOR_RETURN1; + itemWriteByte('\r'); itemWriteByte('\n'); itemWriteByte('-'); itemWriteByte('-'); + uint8_t i; for(i=0; i<_boundary.length(); i++) itemWriteByte(_boundary.c_str()[i]); + _parseMultipartPostByte(data, last); + } + } else if(_multiParseState == EXPECT_FEED2){ + if(data == '\n'){ + _multiParseState = PARSE_HEADERS; + _itemIsFile = false; + } else { + _multiParseState = WAIT_FOR_RETURN1; + itemWriteByte('\r'); itemWriteByte('\n'); itemWriteByte('-'); itemWriteByte('-'); + uint8_t i; for(i=0; i<_boundary.length(); i++) itemWriteByte(_boundary.c_str()[i]); + itemWriteByte('\r'); _parseMultipartPostByte(data, last); + } + } +} diff --git a/lib/PsychicHttp/src/PsychicUploadHandler.h b/lib/PsychicHttp/src/PsychicUploadHandler.h new file mode 100644 index 0000000..59e62b6 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicUploadHandler.h @@ -0,0 +1,68 @@ +#ifndef PsychicUploadHandler_h +#define PsychicUploadHandler_h + +#include "PsychicCore.h" +#include "PsychicHttpServer.h" +#include "PsychicRequest.h" +#include "PsychicWebHandler.h" +#include "PsychicWebParameter.h" + +//callback definitions +typedef std::function PsychicUploadCallback; + +/* +* HANDLER :: Can be attached to any endpoint or as a generic request handler. +*/ + +class PsychicUploadHandler : public PsychicWebHandler { + protected: + PsychicUploadCallback _uploadCallback; + + PsychicRequest *_request; + + String _temp; + size_t _parsedLength; + uint8_t _multiParseState; + String _boundary; + uint8_t _boundaryPosition; + size_t _itemStartIndex; + size_t _itemSize; + String _itemName; + String _itemFilename; + String _itemType; + String _itemValue; + uint8_t *_itemBuffer; + size_t _itemBufferIndex; + bool _itemIsFile; + + esp_err_t _basicUploadHandler(PsychicRequest *request); + esp_err_t _multipartUploadHandler(PsychicRequest *request); + + void _handleUploadByte(uint8_t data, bool last); + void _parseMultipartPostByte(uint8_t data, bool last); + + public: + PsychicUploadHandler(); + ~PsychicUploadHandler(); + + bool canHandle(PsychicRequest *request) override; + esp_err_t handleRequest(PsychicRequest *request) override; + + PsychicUploadHandler * onUpload(PsychicUploadCallback fn); +}; + +enum { + EXPECT_BOUNDARY, + PARSE_HEADERS, + WAIT_FOR_RETURN1, + EXPECT_FEED1, + EXPECT_DASH1, + EXPECT_DASH2, + BOUNDARY_OR_DATA, + DASH3_OR_RETURN2, + EXPECT_FEED2, + PARSING_FINISHED, + PARSE_ERROR +}; + +#endif // PsychicUploadHandler_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicWebHandler.cpp b/lib/PsychicHttp/src/PsychicWebHandler.cpp new file mode 100644 index 0000000..1e4997e --- /dev/null +++ b/lib/PsychicHttp/src/PsychicWebHandler.cpp @@ -0,0 +1,74 @@ +#include "PsychicWebHandler.h" + +PsychicWebHandler::PsychicWebHandler() : + PsychicHandler(), + _requestCallback(NULL), + _onOpen(NULL), + _onClose(NULL) + {} +PsychicWebHandler::~PsychicWebHandler() {} + +bool PsychicWebHandler::canHandle(PsychicRequest *request) { + return true; +} + +esp_err_t PsychicWebHandler::handleRequest(PsychicRequest *request) +{ + //lookup our client + PsychicClient *client = checkForNewClient(request->client()); + if (client->isNew) + openCallback(client); + + /* Request body cannot be larger than a limit */ + if (request->contentLength() > request->server()->maxRequestBodySize) + { + ESP_LOGE(PH_TAG, "Request body too large : %d bytes", request->contentLength()); + + /* Respond with 400 Bad Request */ + char error[60]; + sprintf(error, "Request body must be less than %lu bytes!", request->server()->maxRequestBodySize); + httpd_resp_send_err(request->request(), HTTPD_400_BAD_REQUEST, error); + + /* Return failure to close underlying connection else the incoming file content will keep the socket busy */ + return ESP_FAIL; + } + + //get our body loaded up. + esp_err_t err = request->loadBody(); + if (err != ESP_OK) + return err; + + //load our params in. + request->loadParams(); + + //okay, pass on to our callback. + if (this->_requestCallback != NULL) + err = this->_requestCallback(request); + + return err; +} + +PsychicWebHandler * PsychicWebHandler::onRequest(PsychicHttpRequestCallback fn) { + _requestCallback = fn; + return this; +} + +void PsychicWebHandler::openCallback(PsychicClient *client) { + if (_onOpen != NULL) + _onOpen(client); +} + +void PsychicWebHandler::closeCallback(PsychicClient *client) { + if (_onClose != NULL) + _onClose(getClient(client)); +} + +PsychicWebHandler * PsychicWebHandler::onOpen(PsychicClientCallback fn) { + _onOpen = fn; + return this; +} + +PsychicWebHandler * PsychicWebHandler::onClose(PsychicClientCallback fn) { + _onClose = fn; + return this; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicWebHandler.h b/lib/PsychicHttp/src/PsychicWebHandler.h new file mode 100644 index 0000000..07a6780 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicWebHandler.h @@ -0,0 +1,34 @@ +#ifndef PsychicWebHandler_h +#define PsychicWebHandler_h + +// #include "PsychicCore.h" +// #include "PsychicHttpServer.h" +// #include "PsychicRequest.h" +#include "PsychicHandler.h" + +/* +* HANDLER :: Can be attached to any endpoint or as a generic request handler. +*/ + +class PsychicWebHandler : public PsychicHandler { + protected: + PsychicHttpRequestCallback _requestCallback; + PsychicClientCallback _onOpen; + PsychicClientCallback _onClose; + + public: + PsychicWebHandler(); + ~PsychicWebHandler(); + + virtual bool canHandle(PsychicRequest *request) override; + virtual esp_err_t handleRequest(PsychicRequest *request) override; + PsychicWebHandler * onRequest(PsychicHttpRequestCallback fn); + + virtual void openCallback(PsychicClient *client); + virtual void closeCallback(PsychicClient *client); + + PsychicWebHandler *onOpen(PsychicClientCallback fn); + PsychicWebHandler *onClose(PsychicClientCallback fn); +}; + +#endif \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicWebParameter.h b/lib/PsychicHttp/src/PsychicWebParameter.h new file mode 100644 index 0000000..e09136b --- /dev/null +++ b/lib/PsychicHttp/src/PsychicWebParameter.h @@ -0,0 +1,25 @@ +#ifndef PsychicWebParameter_h +#define PsychicWebParameter_h + +/* + * PARAMETER :: Chainable object to hold GET/POST and FILE parameters + * */ + +class PsychicWebParameter { + private: + String _name; + String _value; + size_t _size; + bool _isForm; + bool _isFile; + + public: + PsychicWebParameter(const String& name, const String& value, bool form=false, bool file=false, size_t size=0): _name(name), _value(value), _size(size), _isForm(form), _isFile(file){} + const String& name() const { return _name; } + const String& value() const { return _value; } + size_t size() const { return _size; } + bool isPost() const { return _isForm; } + bool isFile() const { return _isFile; } +}; + +#endif //PsychicWebParameter_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/PsychicWebSocket.cpp b/lib/PsychicHttp/src/PsychicWebSocket.cpp new file mode 100644 index 0000000..7a3c6b1 --- /dev/null +++ b/lib/PsychicHttp/src/PsychicWebSocket.cpp @@ -0,0 +1,258 @@ +#include "PsychicWebSocket.h" + +/*************************************/ +/* PsychicWebSocketRequest */ +/*************************************/ + +PsychicWebSocketRequest::PsychicWebSocketRequest(PsychicRequest *req) : + PsychicRequest(req->server(), req->request()), + _client(req->client()) +{ +} + +PsychicWebSocketRequest::~PsychicWebSocketRequest() +{ +} + +PsychicWebSocketClient * PsychicWebSocketRequest::client() { + return &_client; +} + +esp_err_t PsychicWebSocketRequest::reply(httpd_ws_frame_t * ws_pkt) +{ + return httpd_ws_send_frame(this->_req, ws_pkt); +} + +esp_err_t PsychicWebSocketRequest::reply(httpd_ws_type_t op, const void *data, size_t len) +{ + httpd_ws_frame_t ws_pkt; + memset(&ws_pkt, 0, sizeof(httpd_ws_frame_t)); + + ws_pkt.payload = (uint8_t*)data; + ws_pkt.len = len; + ws_pkt.type = op; + + return this->reply(&ws_pkt); +} + +esp_err_t PsychicWebSocketRequest::reply(const char *buf) +{ + return this->reply(HTTPD_WS_TYPE_TEXT, buf, strlen(buf)); +} + +/*************************************/ +/* PsychicWebSocketClient */ +/*************************************/ + +PsychicWebSocketClient::PsychicWebSocketClient(PsychicClient *client) + : PsychicClient(client->server(), client->socket()) +{ +} + +PsychicWebSocketClient::~PsychicWebSocketClient() { +} + +esp_err_t PsychicWebSocketClient::sendMessage(httpd_ws_frame_t * ws_pkt) +{ + return httpd_ws_send_frame_async(this->server(), this->socket(), ws_pkt); +} + +esp_err_t PsychicWebSocketClient::sendMessage(httpd_ws_type_t op, const void *data, size_t len) +{ + httpd_ws_frame_t ws_pkt; + memset(&ws_pkt, 0, sizeof(httpd_ws_frame_t)); + + ws_pkt.payload = (uint8_t*)data; + ws_pkt.len = len; + ws_pkt.type = op; + + return this->sendMessage(&ws_pkt); +} + +esp_err_t PsychicWebSocketClient::sendMessage(const char *buf) +{ + return this->sendMessage(HTTPD_WS_TYPE_TEXT, buf, strlen(buf)); +} + +PsychicWebSocketHandler::PsychicWebSocketHandler() : + PsychicHandler(), + _onOpen(NULL), + _onFrame(NULL), + _onClose(NULL) + { + } + +PsychicWebSocketHandler::~PsychicWebSocketHandler() { +} + +PsychicWebSocketClient * PsychicWebSocketHandler::getClient(int socket) +{ + PsychicClient *client = PsychicHandler::getClient(socket); + if (client == NULL) + return NULL; + + if (client->_friend == NULL) + { + return NULL; + } + + return (PsychicWebSocketClient *)client->_friend; +} + +PsychicWebSocketClient * PsychicWebSocketHandler::getClient(PsychicClient *client) { + return getClient(client->socket()); +} + +void PsychicWebSocketHandler::addClient(PsychicClient *client) { + client->_friend = new PsychicWebSocketClient(client); + PsychicHandler::addClient(client); +} + +void PsychicWebSocketHandler::removeClient(PsychicClient *client) { + PsychicHandler::removeClient(client); + delete (PsychicWebSocketClient*)client->_friend; + client->_friend = NULL; +} + +void PsychicWebSocketHandler::openCallback(PsychicClient *client) { + PsychicWebSocketClient *buddy = getClient(client); + if (buddy == NULL) + { + return; + } + + if (_onOpen != NULL) + _onOpen(getClient(buddy)); +} + +void PsychicWebSocketHandler::closeCallback(PsychicClient *client) { + PsychicWebSocketClient *buddy = getClient(client); + if (buddy == NULL) + { + return; + } + + if (_onClose != NULL) + _onClose(getClient(buddy)); +} + +bool PsychicWebSocketHandler::isWebSocket() { return true; } + +esp_err_t PsychicWebSocketHandler::handleRequest(PsychicRequest *request) +{ + //lookup our client + PsychicClient *client = checkForNewClient(request->client()); + + // beginning of the ws URI handler and our onConnect hook + if (request->method() == HTTP_GET) + { + if (client->isNew) + openCallback(client); + + return ESP_OK; + } + + //prep our request + PsychicWebSocketRequest wsRequest(request); + + //init our memory for storing the packet + httpd_ws_frame_t ws_pkt; + memset(&ws_pkt, 0, sizeof(httpd_ws_frame_t)); + ws_pkt.type = HTTPD_WS_TYPE_TEXT; + uint8_t *buf = NULL; + + /* Set max_len = 0 to get the frame len */ + esp_err_t ret = httpd_ws_recv_frame(wsRequest.request(), &ws_pkt, 0); + if (ret != ESP_OK) { + ESP_LOGE(PH_TAG, "httpd_ws_recv_frame failed to get frame len with %s", esp_err_to_name(ret)); + return ret; + } + + //okay, now try to load the packet + //ESP_LOGD(PH_TAG, "frame len is %d", ws_pkt.len); + if (ws_pkt.len) { + /* ws_pkt.len + 1 is for NULL termination as we are expecting a string */ + buf = (uint8_t*) calloc(1, ws_pkt.len + 1); + if (buf == NULL) { + ESP_LOGE(PH_TAG, "Failed to calloc memory for buf"); + return ESP_ERR_NO_MEM; + } + ws_pkt.payload = buf; + /* Set max_len = ws_pkt.len to get the frame payload */ + ret = httpd_ws_recv_frame(wsRequest.request(), &ws_pkt, ws_pkt.len); + if (ret != ESP_OK) { + ESP_LOGE(PH_TAG, "httpd_ws_recv_frame failed with %s", esp_err_to_name(ret)); + free(buf); + return ret; + } + //ESP_LOGD(PH_TAG, "Got packet with message: %s", ws_pkt.payload); + } + + // Text messages are our payload. + if (ws_pkt.type == HTTPD_WS_TYPE_TEXT || ws_pkt.type == HTTPD_WS_TYPE_BINARY) + { + if (this->_onFrame != NULL) + ret = this->_onFrame(&wsRequest, &ws_pkt); + } + + //logging housekeeping + if (ret != ESP_OK) + ESP_LOGE(PH_TAG, "httpd_ws_send_frame failed with %s", esp_err_to_name(ret)); + // ESP_LOGD(PH_TAG, "ws_handler: httpd_handle_t=%p, sockfd=%d, client_info:%d", + // request->server(), + // httpd_req_to_sockfd(request->request()), + // httpd_ws_get_fd_info(request->server()->server, httpd_req_to_sockfd(request->request()))); + + //dont forget to release our buffer memory + free(buf); + + return ret; +} + +PsychicWebSocketHandler * PsychicWebSocketHandler::onOpen(PsychicWebSocketClientCallback fn) { + _onOpen = fn; + return this; +} + +PsychicWebSocketHandler * PsychicWebSocketHandler::onFrame(PsychicWebSocketFrameCallback fn) { + _onFrame = fn; + return this; +} + +PsychicWebSocketHandler * PsychicWebSocketHandler::onClose(PsychicWebSocketClientCallback fn) { + _onClose = fn; + return this; +} + +void PsychicWebSocketHandler::sendAll(httpd_ws_frame_t * ws_pkt) +{ + for (PsychicClient *client : _clients) + { + //ESP_LOGD(PH_TAG, "Active client (fd=%d) -> sending async message", client->socket()); + + if (client->_friend == NULL) + { + return; + } + + if (((PsychicWebSocketClient*)client->_friend)->sendMessage(ws_pkt) != ESP_OK) + break; + } +} + +void PsychicWebSocketHandler::sendAll(httpd_ws_type_t op, const void *data, size_t len) +{ + httpd_ws_frame_t ws_pkt; + memset(&ws_pkt, 0, sizeof(httpd_ws_frame_t)); + + ws_pkt.payload = (uint8_t*)data; + ws_pkt.len = len; + ws_pkt.type = op; + + this->sendAll(&ws_pkt); +} + +void PsychicWebSocketHandler::sendAll(const char *buf) +{ + this->sendAll(HTTPD_WS_TYPE_TEXT, buf, strlen(buf)); +} diff --git a/lib/PsychicHttp/src/PsychicWebSocket.h b/lib/PsychicHttp/src/PsychicWebSocket.h new file mode 100644 index 0000000..01917de --- /dev/null +++ b/lib/PsychicHttp/src/PsychicWebSocket.h @@ -0,0 +1,70 @@ +#ifndef PsychicWebSocket_h +#define PsychicWebSocket_h + +#include "PsychicCore.h" +#include "PsychicRequest.h" + +class PsychicWebSocketRequest; +class PsychicWebSocketClient; + +//callback function definitions +typedef std::function PsychicWebSocketClientCallback; +typedef std::function PsychicWebSocketFrameCallback; + +class PsychicWebSocketClient : public PsychicClient +{ + public: + PsychicWebSocketClient(PsychicClient *client); + ~PsychicWebSocketClient(); + + esp_err_t sendMessage(httpd_ws_frame_t * ws_pkt); + esp_err_t sendMessage(httpd_ws_type_t op, const void *data, size_t len); + esp_err_t sendMessage(const char *buf); +}; + +class PsychicWebSocketRequest : public PsychicRequest +{ + private: + PsychicWebSocketClient _client; + + public: + PsychicWebSocketRequest(PsychicRequest *req); + virtual ~PsychicWebSocketRequest(); + + PsychicWebSocketClient * client() override; + + esp_err_t reply(httpd_ws_frame_t * ws_pkt); + esp_err_t reply(httpd_ws_type_t op, const void *data, size_t len); + esp_err_t reply(const char *buf); +}; + +class PsychicWebSocketHandler : public PsychicHandler { + protected: + PsychicWebSocketClientCallback _onOpen; + PsychicWebSocketFrameCallback _onFrame; + PsychicWebSocketClientCallback _onClose; + + public: + PsychicWebSocketHandler(); + ~PsychicWebSocketHandler(); + + PsychicWebSocketClient * getClient(int socket) override; + PsychicWebSocketClient * getClient(PsychicClient *client) override; + void addClient(PsychicClient *client) override; + void removeClient(PsychicClient *client) override; + void openCallback(PsychicClient *client) override; + void closeCallback(PsychicClient *client) override; + + bool isWebSocket() override final; + esp_err_t handleRequest(PsychicRequest *request) override; + + PsychicWebSocketHandler *onOpen(PsychicWebSocketClientCallback fn); + PsychicWebSocketHandler *onFrame(PsychicWebSocketFrameCallback fn); + PsychicWebSocketHandler *onClose(PsychicWebSocketClientCallback fn); + + void sendAll(httpd_ws_frame_t * ws_pkt); + void sendAll(httpd_ws_type_t op, const void *data, size_t len); + void sendAll(const char *buf); +}; + +#endif // PsychicWebSocket_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/TemplatePrinter.cpp b/lib/PsychicHttp/src/TemplatePrinter.cpp new file mode 100644 index 0000000..5c05904 --- /dev/null +++ b/lib/PsychicHttp/src/TemplatePrinter.cpp @@ -0,0 +1,90 @@ + /************************************************************ + + TemplatePrinter Class + + A basic templating engine for a stream of text. + This wraps the Arduino Print interface and writes to any + Print interface. + + Written by Christopher Andrews (https://github.com/Chris--A) + + ************************************************************/ + +#include "TemplatePrinter.h" + +void TemplatePrinter::resetParam(bool flush){ + if(flush && _inParam){ + _stream.write(_delimiter); + + if(_paramPos) + _stream.print(_paramBuffer); + } + + memset(_paramBuffer, 0, sizeof(_paramBuffer)); + _paramPos = 0; + _inParam = false; +} + + +void TemplatePrinter::flush(){ + resetParam(true); + _stream.flush(); +} + +size_t TemplatePrinter::write(uint8_t data){ + + if(data == _delimiter){ + + // End of parameter, send to callback + if(_inParam){ + + // On false, return the parameter place holder as is: not a parameter + // Bug fix: ignore parameters that are zero length. + if(!_paramPos || !_cb(_stream, _paramBuffer)){ + resetParam(true); + _stream.write(data); + }else{ + resetParam(false); + } + + // Start collecting parameter + }else{ + _inParam = true; + } + }else{ + + // Are we collecting + if(_inParam){ + + // Is param still valid + if(isalnum(data) || data == '_'){ + + // Total param len must be 63, 1 for null. + if(_paramPos < sizeof(_paramBuffer) - 1){ + _paramBuffer[_paramPos++] = data; + + // Not a valid param + }else{ + resetParam(true); + } + }else{ + resetParam(true); + _stream.write(data); + } + + // Just output + }else{ + _stream.write(data); + } + } + return 1; +} + +size_t TemplatePrinter::copyFrom(Stream &stream){ + size_t count = 0; + + while(stream.available()) + count += this->write(stream.read()); + + return count; +} diff --git a/lib/PsychicHttp/src/TemplatePrinter.h b/lib/PsychicHttp/src/TemplatePrinter.h new file mode 100644 index 0000000..6adf14a --- /dev/null +++ b/lib/PsychicHttp/src/TemplatePrinter.h @@ -0,0 +1,51 @@ +#ifndef TemplatePrinter_h + #define TemplatePrinter_h + + #include "PsychicCore.h" + #include + + /************************************************************ + + TemplatePrinter Class + + A basic templating engine for a stream of text. + This wraps the Arduino Print interface and writes to any + Print interface. + + Written by Christopher Andrews (https://github.com/Chris--A) + + ************************************************************/ + + class TemplatePrinter; + + typedef std::function TemplateCallback; + typedef std::function TemplateSourceCallback; + + class TemplatePrinter : public Print{ + private: + bool _inParam; + char _paramBuffer[64]; + uint8_t _paramPos; + Print &_stream; + TemplateCallback _cb; + char _delimiter; + + void resetParam(bool flush); + + public: + using Print::write; + + static void start(Print &stream, TemplateCallback cb, TemplateSourceCallback entry){ + TemplatePrinter printer(stream, cb); + entry(printer); + } + + TemplatePrinter(Print &stream, TemplateCallback cb, const char delimeter = '%') : _stream(stream), _cb(cb), _delimiter(delimeter) { resetParam(false); } + ~TemplatePrinter(){ flush(); } + + void flush() override; + size_t write(uint8_t data) override; + size_t copyFrom(Stream &stream); + }; + +#endif diff --git a/lib/PsychicHttp/src/async_worker.cpp b/lib/PsychicHttp/src/async_worker.cpp new file mode 100644 index 0000000..d7310cb --- /dev/null +++ b/lib/PsychicHttp/src/async_worker.cpp @@ -0,0 +1,203 @@ +#include "async_worker.h" + +bool is_on_async_worker_thread(void) +{ + // is our handle one of the known async handles? + TaskHandle_t handle = xTaskGetCurrentTaskHandle(); + for (int i = 0; i < ASYNC_WORKER_COUNT; i++) { + if (worker_handles[i] == handle) { + return true; + } + } + return false; +} + +// Submit an HTTP req to the async worker queue +esp_err_t submit_async_req(httpd_req_t *req, httpd_req_handler_t handler) +{ + // must create a copy of the request that we own + httpd_req_t* copy = NULL; + esp_err_t err = httpd_req_async_handler_begin(req, ©); + if (err != ESP_OK) { + return err; + } + + httpd_async_req_t async_req = { + .req = copy, + .handler = handler, + }; + + // How should we handle resource exhaustion? + // In this example, we immediately respond with an + // http error if no workers are available. + int ticks = 0; + + // counting semaphore: if success, we know 1 or + // more asyncReqTaskWorkers are available. + if (xSemaphoreTake(worker_ready_count, ticks) == false) { + ESP_LOGE(PH_TAG, "No workers are available"); + httpd_req_async_handler_complete(copy); // cleanup + return ESP_FAIL; + } + + // Since worker_ready_count > 0 the queue should already have space. + // But lets wait up to 100ms just to be safe. + if (xQueueSend(async_req_queue, &async_req, pdMS_TO_TICKS(100)) == false) { + ESP_LOGE(PH_TAG, "worker queue is full"); + httpd_req_async_handler_complete(copy); // cleanup + return ESP_FAIL; + } + + return ESP_OK; +} + +void async_req_worker_task(void *p) +{ + ESP_LOGI(PH_TAG, "starting async req task worker"); + + while (true) { + + // counting semaphore - this signals that a worker + // is ready to accept work + xSemaphoreGive(worker_ready_count); + + // wait for a request + httpd_async_req_t async_req; + if (xQueueReceive(async_req_queue, &async_req, portMAX_DELAY)) { + + ESP_LOGI(PH_TAG, "invoking %s", async_req.req->uri); + + // call the handler + async_req.handler(async_req.req); + + // Inform the server that it can purge the socket used for + // this request, if needed. + if (httpd_req_async_handler_complete(async_req.req) != ESP_OK) { + ESP_LOGE(PH_TAG, "failed to complete async req"); + } + } + } + + ESP_LOGW(PH_TAG, "worker stopped"); + vTaskDelete(NULL); +} + +void start_async_req_workers(void) +{ + + // counting semaphore keeps track of available workers + worker_ready_count = xSemaphoreCreateCounting( + ASYNC_WORKER_COUNT, // Max Count + 0); // Initial Count + if (worker_ready_count == NULL) { + ESP_LOGE(PH_TAG, "Failed to create workers counting Semaphore"); + return; + } + + // create queue + async_req_queue = xQueueCreate(1, sizeof(httpd_async_req_t)); + if (async_req_queue == NULL){ + ESP_LOGE(PH_TAG, "Failed to create async_req_queue"); + vSemaphoreDelete(worker_ready_count); + return; + } + + // start worker tasks + for (int i = 0; i < ASYNC_WORKER_COUNT; i++) { + + bool success = xTaskCreate(async_req_worker_task, "async_req_worker", + ASYNC_WORKER_TASK_STACK_SIZE, // stack size + (void *)0, // argument + ASYNC_WORKER_TASK_PRIORITY, // priority + &worker_handles[i]); + + if (!success) { + ESP_LOGE(PH_TAG, "Failed to start asyncReqWorker"); + continue; + } + } +} + +/**** + * + * This code is backported from the 5.1.x branch + * +****/ + +#define MAX(a, b) (((a) > (b)) ? (a) : (b)) + +/* Calculate the maximum size needed for the scratch buffer */ +#define HTTPD_SCRATCH_BUF MAX(HTTPD_MAX_REQ_HDR_LEN, HTTPD_MAX_URI_LEN) + +/** + * @brief Auxiliary data structure for use during reception and processing + * of requests and temporarily keeping responses + */ +struct httpd_req_aux { + struct sock_db *sd; /*!< Pointer to socket database */ + char scratch[HTTPD_SCRATCH_BUF + 1]; /*!< Temporary buffer for our operations (1 byte extra for null termination) */ + size_t remaining_len; /*!< Amount of data remaining to be fetched */ + char *status; /*!< HTTP response's status code */ + char *content_type; /*!< HTTP response's content type */ + bool first_chunk_sent; /*!< Used to indicate if first chunk sent */ + unsigned req_hdrs_count; /*!< Count of total headers in request packet */ + unsigned resp_hdrs_count; /*!< Count of additional headers in response packet */ + struct resp_hdr { + const char *field; + const char *value; + } *resp_hdrs; /*!< Additional headers in response packet */ + struct http_parser_url url_parse_res; /*!< URL parsing result, used for retrieving URL elements */ +#ifdef CONFIG_HTTPD_WS_SUPPORT + bool ws_handshake_detect; /*!< WebSocket handshake detection flag */ + httpd_ws_type_t ws_type; /*!< WebSocket frame type */ + bool ws_final; /*!< WebSocket FIN bit (final frame or not) */ + uint8_t mask_key[4]; /*!< WebSocket mask key for this payload */ +#endif +}; + +esp_err_t httpd_req_async_handler_begin(httpd_req_t *r, httpd_req_t **out) +{ + if (r == NULL || out == NULL) { + return ESP_ERR_INVALID_ARG; + } + + // alloc async req + httpd_req_t *async = (httpd_req_t *)malloc(sizeof(httpd_req_t)); + if (async == NULL) { + return ESP_ERR_NO_MEM; + } + memcpy((void *)async, (void *)r, sizeof(httpd_req_t)); + + // alloc async aux + async->aux = (httpd_req_aux *)malloc(sizeof(struct httpd_req_aux)); + if (async->aux == NULL) { + free(async); + return ESP_ERR_NO_MEM; + } + memcpy(async->aux, r->aux, sizeof(struct httpd_req_aux)); + + // not available in 4.4.x + // mark socket as "in use" + // struct httpd_req_aux *ra = r->aux; + //ra->sd->for_async_req = true; + + *out = async; + + return ESP_OK; +} + +esp_err_t httpd_req_async_handler_complete(httpd_req_t *r) +{ + if (r == NULL) { + return ESP_ERR_INVALID_ARG; + } + + // not available in 4.4.x + // struct httpd_req_aux *ra = (httpd_req_aux *)r->aux; + // ra->sd->for_async_req = false; + + free(r->aux); + free(r); + + return ESP_OK; +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/async_worker.h b/lib/PsychicHttp/src/async_worker.h new file mode 100644 index 0000000..e77c4a6 --- /dev/null +++ b/lib/PsychicHttp/src/async_worker.h @@ -0,0 +1,36 @@ +#ifndef async_worker_h +#define async_worker_h + +#include "PsychicCore.h" +#include "freertos/FreeRTOS.h" +#include "freertos/semphr.h" + +#define ASYNC_WORKER_TASK_PRIORITY 5 +#define ASYNC_WORKER_TASK_STACK_SIZE (4*1024) +#define ASYNC_WORKER_COUNT 8 + +// Async requests are queued here while they wait to be processed by the workers +static QueueHandle_t async_req_queue; + +// Track the number of free workers at any given time +static SemaphoreHandle_t worker_ready_count; + +// Each worker has its own thread +static TaskHandle_t worker_handles[ASYNC_WORKER_COUNT]; + +typedef esp_err_t (*httpd_req_handler_t)(httpd_req_t *req); + +typedef struct { + httpd_req_t* req; + httpd_req_handler_t handler; +} httpd_async_req_t; + +bool is_on_async_worker_thread(void); +esp_err_t submit_async_req(httpd_req_t *req, httpd_req_handler_t handler); +void async_req_worker_task(void *p); +void start_async_req_workers(void); + +esp_err_t httpd_req_async_handler_begin(httpd_req_t *r, httpd_req_t **out); +esp_err_t httpd_req_async_handler_complete(httpd_req_t *r); + +#endif //async_worker_h \ No newline at end of file diff --git a/lib/PsychicHttp/src/http_status.cpp b/lib/PsychicHttp/src/http_status.cpp new file mode 100644 index 0000000..64e0c07 --- /dev/null +++ b/lib/PsychicHttp/src/http_status.cpp @@ -0,0 +1,194 @@ +#include "http_status.h" + +bool http_informational(int code) +{ + return code >= 100 && code < 200; +} + +bool http_success(int code) +{ + return code >= 200 && code < 300; +} + +bool http_redirection(int code) +{ + return code >= 300 && code < 400; +} + +bool http_client_error(int code) +{ + return code >= 400 && code < 500; +} + +bool http_server_error(int code) +{ + return code >= 500 && code < 600; +} + +bool http_failure(int code) +{ + return code >= 400 && code < 600; +} + +const char *http_status_group(int code) +{ + if (http_informational(code)) + return "Informational"; + + if (http_success(code)) + return "Success"; + + if (http_redirection(code)) + return "Redirection"; + + if (http_client_error(code)) + return "Client Error"; + + if (http_server_error(code)) + return "Server Error"; + + return "Unknown"; +} + +const char *http_status_reason(int code) +{ + switch (code) + { + /*####### 1xx - Informational #######*/ + case 100: + return "Continue"; + case 101: + return "Switching Protocols"; + case 102: + return "Processing"; + case 103: + return "Early Hints"; + + /*####### 2xx - Successful #######*/ + case 200: + return "OK"; + case 201: + return "Created"; + case 202: + return "Accepted"; + case 203: + return "Non-Authoritative Information"; + case 204: + return "No Content"; + case 205: + return "Reset Content"; + case 206: + return "Partial Content"; + case 207: + return "Multi-Status"; + case 208: + return "Already Reported"; + case 226: + return "IM Used"; + + /*####### 3xx - Redirection #######*/ + case 300: + return "Multiple Choices"; + case 301: + return "Moved Permanently"; + case 302: + return "Found"; + case 303: + return "See Other"; + case 304: + return "Not Modified"; + case 305: + return "Use Proxy"; + case 307: + return "Temporary Redirect"; + case 308: + return "Permanent Redirect"; + + /*####### 4xx - Client Error #######*/ + case 400: + return "Bad Request"; + case 401: + return "Unauthorized"; + case 402: + return "Payment Required"; + case 403: + return "Forbidden"; + case 404: + return "Not Found"; + case 405: + return "Method Not Allowed"; + case 406: + return "Not Acceptable"; + case 407: + return "Proxy Authentication Required"; + case 408: + return "Request Timeout"; + case 409: + return "Conflict"; + case 410: + return "Gone"; + case 411: + return "Length Required"; + case 412: + return "Precondition Failed"; + case 413: + return "Content Too Large"; + case 414: + return "URI Too Long"; + case 415: + return "Unsupported Media Type"; + case 416: + return "Range Not Satisfiable"; + case 417: + return "Expectation Failed"; + case 418: + return "I'm a teapot"; + case 421: + return "Misdirected Request"; + case 422: + return "Unprocessable Content"; + case 423: + return "Locked"; + case 424: + return "Failed Dependency"; + case 425: + return "Too Early"; + case 426: + return "Upgrade Required"; + case 428: + return "Precondition Required"; + case 429: + return "Too Many Requests"; + case 431: + return "Request Header Fields Too Large"; + case 451: + return "Unavailable For Legal Reasons"; + + /*####### 5xx - Server Error #######*/ + case 500: + return "Internal Server Error"; + case 501: + return "Not Implemented"; + case 502: + return "Bad Gateway"; + case 503: + return "Service Unavailable"; + case 504: + return "Gateway Timeout"; + case 505: + return "HTTP Version Not Supported"; + case 506: + return "Variant Also Negotiates"; + case 507: + return "Insufficient Storage"; + case 508: + return "Loop Detected"; + case 510: + return "Not Extended"; + case 511: + return "Network Authentication Required"; + + default: + return "Unknown"; + } +} \ No newline at end of file diff --git a/lib/PsychicHttp/src/http_status.h b/lib/PsychicHttp/src/http_status.h new file mode 100644 index 0000000..e03b735 --- /dev/null +++ b/lib/PsychicHttp/src/http_status.h @@ -0,0 +1,15 @@ +#ifndef MICRO_HTTP_STATUS_H +#define MICRO_HTTP_STATUS_H + +#include + +bool http_informational(int code); +bool http_success(int code); +bool http_redirection(int code); +bool http_client_error(int code); +bool http_server_error(int code); +bool http_failure(int code); +const char *http_status_group(int code); +const char *http_status_reason(int code); + +#endif // MICRO_HTTP_STATUS_H \ No newline at end of file
+

Basic Request Examples

+ + +

Static Serving

+

+ + +

+

Text File

+ +

Simple POST Form

+
+ + +
+ + +
+ +
+ +

Basic File Upload

+ + + + + + + + + + + + +
+ + + +
+ + + +
+ +
+ + +

Multipart POST Form

+
+ + +
+ + + +
+ + + +
+ + +
+ +

Websocket Demo

+ + + +
+ +
+ + + +

EventSource Demo

+ +
+ +
+ + +
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 + + PSYCHICHTTP + + + + + + + + + +

+

PsychicHttp OTA Update

+
+ +

This page allows to test OTA update with PsychicHttp, and file naming convention below : +

    +
  • "*code.bin" for code (firmware) update, eg "v1_code.bin"
    • +
  • "*littlefs.bin" for data (littlefs) update, eg "v1_littlefs.bin"
    • +
+
+ +
+
+ +
+
+ +
+

Update must be done for each of the files provided (code, littlefs). Once updates are made, the ESP32 can be restarted. + +

+
+ + + + \ No newline at end of file diff --git a/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate1.png b/lib/PsychicHttp/examples/arduino/arduino_ota/images/otaupdate1.png new file mode 100644 index 0000000000000000000000000000000000000000..c47e4e94d33d763192220a239951a1161d17bae8 GIT binary patch literal 60478 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