asio.rst 1.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142
  1. ASIO port
  2. =========
  3. Overview
  4. --------
  5. Asio is a cross-platform C++ library, see https://think-async.com. It provides a consistent asynchronous model using a modern C++ approach.
  6. ASIO documentation
  7. ^^^^^^^^^^^^^^^^^^
  8. Please refer to the original asio documentation at https://think-async.com/Asio/Documentation.
  9. Asio also comes with a number of examples which could be find under Documentation/Examples on that web site.
  10. Supported features
  11. ^^^^^^^^^^^^^^^^^^
  12. ESP platform port currently supports only network asynchronous socket operations; does not support serial port.
  13. SSL/TLS support is disabled by default and could be enabled in component configuration menu by choosing TLS library from
  14. - mbedTLS with OpenSSL translation layer (default option)
  15. - wolfSSL
  16. SSL support is very basic at this stage and it does include following features:
  17. - Verification callbacks
  18. - DH property files
  19. - Certificates/private keys file APIs
  20. Internal asio settings for ESP include
  21. - EXCEPTIONS are enabled in ASIO if enabled in menuconfig
  22. - TYPEID is enabled in ASIO if enabled in menuconfig
  23. Application Example
  24. -------------------
  25. ESP examples are based on standard asio :example:`protocols/asio`:
  26. - :example:`protocols/asio/udp_echo_server`
  27. - :example:`protocols/asio/tcp_echo_server`
  28. - :example:`protocols/asio/asio_chat`
  29. - :example:`protocols/asio/ssl_client_server`
  30. Please refer to the specific example README.md for details