- Important Notes
- Why do we need this ESPAsyncTCP library
- Changelog
- Async TCP Library for ESP8266 Arduino
- Documentation
- Examples
- Libraries and projects that use ESPAsyncTCP
- Contributions and Thanks
- Contributing
- License
- Copyright
The new ESP8266 cores v3.0.2+ introduces many new breaking features, such as replacing axtls with bearssl, as well as good ones such as LwIP Ethernet W5500lwIP, W5100lwIP and ENC28J60lwIP libraries.
Because the original ESPAsyncTCP library is not well maintained to cope with dynamic environment of new cores, features, etc., this forked ESPAsyncTCP library is created as an effort to try the best to keep up with the fast changes and avoid compile errors in future cores or dependent libraries.
Hopefully the bearssl feature of new ESP8266 cores will be added to this library in the near future to support SSL.
Why do we need this ESPAsyncTCP library
This library is based on, modified from:
to apply the better and faster asynchronous feature of the powerful ESPAsyncTCP Library with SSL, and will be the base for other more advanced Async libraries for ESP8266, such as ESPAsyncWebServer, AsyncHTTPRequest, AsyncHTTPSRequest, etc.
- Using asynchronous network means that you can handle more than one connection at the same time
- You are called once the request is ready and parsed
- When you send the response, you are immediately ready to handle other connections while the server is taking care of sending the response in the background
- Speed is OMG
- Easy to use API, HTTP Basic and Digest MD5 Authentication (default), ChunkedResponse
- Easily extensible to handle any type of content
- Supports Continue 100
- Async WebSocket plugin offering different locations without extra servers or ports
- Async EventSource (Server-Sent Events) plugin to send events to the browser
- URL Rewrite plugin for conditional and permanent url rewrites
- ServeStatic plugin that supports cache, Last-Modified, default index and more
- Simple template processing engine to handle templates
ESP8266boards
For ESP32, check AsyncTCP or AsyncTCP_SSL
This is a fully asynchronous TCP library, aimed at enabling trouble-free, multi-connection network environment for Espressif's ESP8266 MCUs, using WiFi or LwIP Ethernet (W5500lwIP, W5100lwIP and ENC28J60lwIP libraries)
This library is the base for ESPAsyncWebServer
The base classes on which everything else is built. They expose all possible scenarios, but are really raw and require more skills to use.
This class can be used to send data like any other Print interface (Serial for example).
The object then can be used outside of the Async callbacks (the loop) and receive asynchronously data using onData. The object can be checked if the underlying AsyncClient is connected, or hook to the onDisconnect callback.
This class is really similar to the AsyncPrinter, but it differs in the fact that it can buffer some of the incoming data.
It is exactly what it sounds like. This is a standard, blocking TCP Client, similar to the one included in ESP8266WiFi
- AsyncMQTT_Generic
- ESPAsync_WiFiManager
- AsyncHTTPRequest_Generic
- AsyncHTTPSRequest_Generic
- ESPAsync_WiFiManager_Lite
- AsyncWebServer_Ethernet
and many more to come.
Submit issues to: ESPAsyncTCP issues
- Search for bug and improvement.
- Add
bearsslAsync features for new cores - Remove
hard-codeif possible
- Try to convert to use with new ESP8266 cores v3.0.2+ without
axtlssupport - Add Table of Contents
- Modify examples\
- Add astyle using
allmanstyle. Restyle the library
Many thanks for everyone for bug reporting, new feature suggesting, testing and contributing to the development of this library.
- Based on and modified from Hristo Gochkov's ESPAsyncTCP. Many thanks to Hristo Gochkov for great ESPAsyncTCP Library
 ⭐️⭐️ Hristo Gochkov |
If you want to contribute to this project:
- Report bugs and errors
- Ask for enhancements
- Create issues and pull requests
- Tell other people about this library
- The library is licensed under LGPLv3
- Copyright (c) 2016- Hristo Gochkov
- Copyright (c) 2022- Khoi Hoang