mirror of
https://git.mirrors.martin98.com/https://github.com/luc-github/ESP3D.git
synced 2025-08-04 20:00:38 +08:00
39e06975f2
### Maintenance page
* Add add tab color for mobile view
* Add spellcheck off / autocorect off in input
* Add disconnect button when authenticate enabled
* Add Invalid user or password message when authentication failed
### Board support
* Add ESP32 S2 support
* Add ESP32 S3 support
* Add ESP32 C3 support
### ESP commands
* Add command 701 to control GCODE streaming
* Remove command 901 as duplicate
* Update command 420 to add more details
* Use text as default output
* All json on all commands for formated output
### Core
* Add benchmak function to check transfer speed (for test only-not production)
* Merge code for ESP3DLib support
* Add better printer display support (M117 / Serial TFT)
* Use ESP32 analogWrite instead of emulated one
### Modules
* Display
* Refactor code
* Remove SPI ILI 9341 / 9488 support as not suitable
* Add ST7789 support (135x240 / 240x240)
* Filesystem
* Bug fixes due to esp core updates
* Better SD sharing mecanism
* Better global FS management
* FTP
* Add SD sharing support
* Better global FS management
* GCODE Host
* Add basic support for macro files
* Add ESP command support
* Use not blocking method to stream commands / handle response
* Notifications
* Add IFTTT notification service
* Add WebUI notification
* Add ESP3D display notification
* WebDav
* Add SD sharing support
* Add bug fix from https://github.com/d-a-v/ESPWebDAV
* Better global FS management
* Websocket
* Add function to handle zombies connections
* WiFi
* Fix connection to AP sometime fail
* Fix low signal not diplayed in ESP420 even connected
* Add AP Setup mode
### Libraries
* Update SDFat-2.0.6 to 2.1.2
* Update ESP32SSDP 1.1.1 to 1.2.0
* Update TFT_eSPI-1.4.11 to 2.4.61
* Update arduinoWebSockets-2.3.5 to 2.3.6
* Update esp8266-oled-ssd1306-4.0.0 to 4.3.0
* Remove lvgl support
### Tools
* Add I2C scanner script
* Add python script to simulate/stress printer serial communication
### PlatformIO
* Use latest 4.4.0 Espressif32 release (ESP32-arduino core 2.0.3)
* Add fix for Flash more than 4MB
* Add Esp32 S2/S3/C3 env
* Add ESP32-ST7789 / esp32-TTGO_T_Display env
103 lines
3.8 KiB
Markdown
103 lines
3.8 KiB
Markdown
WebSocket Server and Client for Arduino [](https://github.com/Links2004/arduinoWebSockets/actions?query=workflow%3ACI+branch%3Amaster)
|
|
===========================================
|
|
|
|
a WebSocket Server and Client for Arduino based on RFC6455.
|
|
|
|
|
|
##### Supported features of RFC6455 #####
|
|
- text frame
|
|
- binary frame
|
|
- connection close
|
|
- ping
|
|
- pong
|
|
- continuation frame
|
|
|
|
##### Limitations #####
|
|
- max input length is limited to the ram size and the ```WEBSOCKETS_MAX_DATA_SIZE``` define
|
|
- max output length has no limit (the hardware is the limit)
|
|
- Client send big frames with mask 0x00000000 (on AVR all frames)
|
|
- continuation frame reassembly need to be handled in the application code
|
|
|
|
##### Limitations for Async #####
|
|
- Functions called from within the context of the websocket event might not honor `yield()` and/or `delay()`. See [this issue](https://github.com/Links2004/arduinoWebSockets/issues/58#issuecomment-192376395) for more info and a potential workaround.
|
|
- wss / SSL is not possible.
|
|
|
|
##### Supported Hardware #####
|
|
- ESP8266 [Arduino for ESP8266](https://github.com/esp8266/Arduino/)
|
|
- ESP32 [Arduino for ESP32](https://github.com/espressif/arduino-esp32)
|
|
- ESP31B
|
|
- Particle with STM32 ARM Cortex M3
|
|
- ATmega328 with Ethernet Shield (ATmega branch)
|
|
- ATmega328 with enc28j60 (ATmega branch)
|
|
- ATmega2560 with Ethernet Shield (ATmega branch)
|
|
- ATmega2560 with enc28j60 (ATmega branch)
|
|
|
|
###### Note: ######
|
|
|
|
version 2.0.0 and up is not compatible with AVR/ATmega, check ATmega branch.
|
|
|
|
version 2.3.0 has API changes for the ESP8266 BareSSL (may brakes existing code)
|
|
|
|
Arduino for AVR not supports std namespace of c++.
|
|
|
|
### wss / SSL ###
|
|
supported for:
|
|
- wss client on the ESP8266
|
|
- wss / SSL is not natively supported in WebSocketsServer however it is possible to achieve secure websockets
|
|
by running the device behind an SSL proxy. See [Nginx](examples/Nginx/esp8266.ssl.reverse.proxy.conf) for a
|
|
sample Nginx server configuration file to enable this.
|
|
|
|
### ESP Async TCP ###
|
|
|
|
This libary can run in Async TCP mode on the ESP.
|
|
|
|
The mode can be activated in the ```WebSockets.h``` (see WEBSOCKETS_NETWORK_TYPE define).
|
|
|
|
[ESPAsyncTCP](https://github.com/me-no-dev/ESPAsyncTCP) libary is required.
|
|
|
|
|
|
### High Level Client API ###
|
|
|
|
- `begin` : Initiate connection sequence to the websocket host.
|
|
```c++
|
|
void begin(const char *host, uint16_t port, const char * url = "/", const char * protocol = "arduino");
|
|
void begin(String host, uint16_t port, String url = "/", String protocol = "arduino");
|
|
```
|
|
- `onEvent`: Callback to handle for websocket events
|
|
|
|
```c++
|
|
void onEvent(WebSocketClientEvent cbEvent);
|
|
```
|
|
|
|
- `WebSocketClientEvent`: Handler for websocket events
|
|
```c++
|
|
void (*WebSocketClientEvent)(WStype_t type, uint8_t * payload, size_t length)
|
|
```
|
|
Where `WStype_t type` is defined as:
|
|
```c++
|
|
typedef enum {
|
|
WStype_ERROR,
|
|
WStype_DISCONNECTED,
|
|
WStype_CONNECTED,
|
|
WStype_TEXT,
|
|
WStype_BIN,
|
|
WStype_FRAGMENT_TEXT_START,
|
|
WStype_FRAGMENT_BIN_START,
|
|
WStype_FRAGMENT,
|
|
WStype_FRAGMENT_FIN,
|
|
WStype_PING,
|
|
WStype_PONG,
|
|
} WStype_t;
|
|
```
|
|
|
|
### Issues ###
|
|
Submit issues to: https://github.com/Links2004/arduinoWebSockets/issues
|
|
|
|
[](https://gitter.im/Links2004/arduinoWebSockets?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|
|
|
|
### License and credits ###
|
|
|
|
The library is licensed under [LGPLv2.1](https://github.com/Links2004/arduinoWebSockets/blob/master/LICENSE)
|
|
|
|
[libb64](http://libb64.sourceforge.net/) written by Chris Venter. It is distributed under Public Domain see [LICENSE](https://github.com/Links2004/arduinoWebSockets/blob/master/src/libb64/LICENSE).
|