Skip to content

File Transfer

File Transfer

ESP3D-X supports several methods for transferring files to and from the device.

HTTP Multipart Upload

Upload to flash filesystem

POST /files
Content-Type: multipart/form-data

Form fields:

path — Target directory path
myfiles — File(s) to upload
<path><name>S — Size field for each file

Upload to SD card

POST /sdfiles

Same multipart format as flash upload.

Firmware update

POST /updatefw

Upload a .bin firmware file for OTA update.

WebDAV

WebDAV provides standard file operations via HTTP methods:

Method	Action
GET	Read file / list directory
PUT	Write file
DELETE	Delete file/directory
MKCOL	Create directory
PROPFIND	List properties

Base URL: http://<esp-ip>/webdav/

Enable with: [ESP190]STATE=ON

WebSocket V1 Binary Transfer

The /wsdata endpoint (subprotocol esp3d-v1) supports high-speed binary file transfer using the ESP3D WebSocket Protocol V1.

Upload sequence

Probe — Send SR, receive RS with idle state
Start — Send SU with path + filename + total size → receive US (ack)
Packets — Send UP with packet ID + data → receive PU ack
End — Send EU → receive UE

Download sequence

Probe — Send SR, receive RS with idle state
Start — Send SD with path + filename → receive DS (ack)
Packets — Server sends DP with packet ID + data → client sends PD ack
End — Server sends ED → client sends DE

See WebSockets API for the complete V1 frame format.

SD Tools

SD card files can also be managed via ESP commands:

ESP720 — List flash filesystem
ESP740 — List SD filesystem
ESP750 — SD file operations (remove, mkdir, etc.)