This version is the production version, features are frozen, only bugfixes are accepted.
It is already part of Marlin distribution, check how to enable it
This is NOT for esp8266, esp8285, esp32 boards as daughters boards connected to your main board.
The library must be used with ESP3D-WEBUI 2.X
The V1.X features are :
In Marlin configuration files :
Select an ESP32 based board.
Uncomment the second serial port to allow esp3d to get all printer feedback
/**
* Select a secondary serial port on the board to use for communication with the host.
* :[-1, 0, 1, 2, 3, 4, 5, 6, 7]
*/
#define SERIAL_PORT_2 -1
Enable ESP3DLib support using :
#define ESP3D_WIFISUPPORT // ESP3D Library WiFi management (https://github.com/luc-github/ESP3DLib)
You can optionnaly define to which access point your board need to connect to:
#define WIFI_SSID "Wifi SSID"
#define WIFI_PWD "Wifi Password"
if not defined or you left like this the board will act as an Access Point instead. and you can do further configuration using command line or web interface.
Please be sure these setting are enabled they are mandatory for ESP3DLib
#define WEBSUPPORT // Start a webserver (which may include auto-discovery)
#define WIFI_CUSTOM_COMMAND // Accept feature config commands (e.g., WiFi ESP3D) from the host|
Web Update is supported by ESP3DLib but you can also use:
#define OTASUPPORT // Support over-the-air firmware updates
To enable the authentication feature which is disabled by default:
//AUTHENTICATION_FEATURE: protect pages by login password.
#define AUTHENTICATION_FEATURE
to disable any of these features which are enabled by default:
//MDNS_FEATURE: this feature allow type the name defined
//in web browser by default: http:\\marlinesp.local and connect
#define DISABLE_MDNS_FEATURE
//SSDD_FEATURE: this feature is a discovery protocol, supported on Windows out of the box
//Rely on Configuration_adv.h
#define DISABLE_SSDP_FEATURE
//CAPTIVE_PORTAL_FEATURE: In SoftAP redirect all unknow call to main page
#define DISABLE_CAPTIVE_PORTAL_FEATURE
The documentation section will help you on:
Syntax and parameters
Add space to separate parameters
[ESP]
[ESP100]
[ESP101]
[ESP102]
[ESP103]IP= MSK= GW=
[ESP105]
[ESP106]
[ESP107]
[ESP108]
[ESP110]
[ESP111]
[ESP112]
[ESP120]
[ESP121]
[ESP200]
Note: it does not give any passwords
[ESP400]
Using position in EEPROM, type: B(byte), I(integer/long), S(string), A(IP address / mask)
[ESP401]P= T= V=
Description: Positions:
HOSTNAME_ENTRY "ESP_HOSTNAME"
STA_SSID_ENTRY "STA_SSID"
STA_PWD_ENTRY "STA_PWD"
STA_IP_ENTRY "STA_IP"
STA_GW_ENTRY "STA_GW"
STA_MK_ENTRY "STA_MK"
ESP_RADIO_MODE "WIFI_MODE"
AP_SSID_ENTRY "AP_SSID"
AP_PWD_ENTRY "AP_PWD"
AP_IP_ENTRY "AP_IP"
AP_CHANNEL_ENTRY "AP_CHANNEL"
HTTP_ENABLE_ENTRY "HTTP_ON"
HTTP_PORT_ENTRY "HTTP_PORT"
TELNET_ENABLE_ENTRY "TELNET_ON"
TELNET_PORT_ENTRY "TELNET_PORT"
STA_IP_MODE_ENTRY "STA_IP_MODE"
Output is JSON or plain text according parameter
[ESP410]
Output is plain text
[ESP420]
cmd is RESTART / RESET
[ESP444]
[ESP550]
[ESP555]
[ESP710]FORMAT
[ESP800]
ESP32 R1 controller from Simon Jouet
FYSETC-E4
MKS Tinybee V1
MRR-ESPA
MRR-ESPE
Panda Zhu/M4
From Simon Jouet, a generic ESP32 controller with 4MB flash memory, no IO expander.
From FYSETC, an ESP32 controller with 16MB flash memory, no IO expander.
From Maker Base, an ESP32 controller with 8MB flash memory, with IO expander.
From Maple Rain, an ESP32 controller with 4MB flash memory, no IO expander.
From Maple Rain, an ESP32 controller with 4MB flash memory, with IO expander.
From Mark Niu, two ESP32 controllers with 4MB flash memory, with IO expander.
