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