Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD
Small FTP server for ESP8266/ESP32/PYBD on the MicroPython platform
https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD
Last synced: 3 months ago
JSON representation
Small FTP server for ESP8266/ESP32/PYBD on the MicroPython platform
- Host: GitHub
- URL: https://github.com/robert-hh/FTP-Server-for-ESP8266-ESP32-and-PYBD
- Owner: robert-hh
- License: mit
- Created: 2016-10-13T09:34:23.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2022-11-03T21:00:03.000Z (about 2 years ago)
- Last Synced: 2024-04-29T11:33:04.723Z (6 months ago)
- Language: Python
- Homepage:
- Size: 113 KB
- Stars: 146
- Watchers: 14
- Forks: 38
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-micropython - FTP-Server-for-ESP8266-ESP32-and-PYBD - Small FTP server for ESP8266/ESP32/Pyboard on the MicroPython platform. (Libraries / Communications)
README
# uftpd: small FTP server for ESP8266, ESP32 and Pyboard D
**Intro**
Based on the work of chrisgp - Christopher Popp and pfalcon - Paul Sokolovsky
Christopher made a first uftp server script, which runs in foreground.
Paul made webrepl with the framework for background operations, which then was used
also by Christopher to implement his utelnetsever code.
My task was to put all these pieces together and assemble this uftpd.py script,
which runs in background and acts as ftp server.
Due to its size, for ESP8266 it either has to be integrated into the flash image as frozen
bytecode, by placing it into the esp8266/modules folder and performing a rebuild,
or it must be compiled into bytecode using mpy-cross and loaded as an .mpy file.
The frozen bytecode variant is preferred.## Limitations
The server has some limitations:
- Binary mode only
- Limited multi-session support. The server accepts multiple sessions, but only
one session command at a time is served while the other sessions receive a 'busy'
response, which still allows interleaved actions.
- No user authentication. Any user may log in without a password. User
authentication may be added easily, if required.
- Not all ftp commands are implemented.
- ESP8266 is **NOT** a multitasking platform and the system calls are NOT re-entrant.
Even when the ftp server sits in background and can serve requests, **no
foreground tasks should run at that time**, especially if they execute system calls.
The effects is hardly to predict, although most of the time the device simply
crashes. Also in turn, when using the SITE command, the code in the payload MUST NOT
be blocking, because that will block the device.
- ESP32 The server is supported from version='v1.9.3-575 on. That is the version
which introduced webrepl.## Start-up
You'll start the server with:
`import uftpd`
The service will immediately be started at port 21 in silent mode. You may
stop the service then with:`uftpd.stop()`
When stopped or not started yet, start it manually with:
`uftpd.start([port = 21][, verbose = level])`
or
`uftpd.restart([port = 21][, verbose = level])`port is the port number (default 21)
verbose controls the level of printed activity messages, values 0 .. 2You may use
`uftd.restart([port = 21][, verbose = level])`
as a shortcut for uftp.stop() and uftpd.start().## Coverage
The server works well with most dedicated ftp clients, and most browsers and file
managers. These are test results with an arbitrary selected set:**Linux**
- ftp: works for file & directory operations including support for the m* commands
- filezilla, fireftp: work fine, including loading into the editor & saving back.
Take care to limit the number of data session to 1.
- Nautilus: works mostly, including loading into the editor & saving back.
Copying multiple files at once to the esp8266 fails, because nautilus tries
to open multiple sessions for that purpose.
Configure Nautilus with dconf-editor to show directory count for local dirs only.
Once mounted, you can even open a terminal at that spot.
The path is something like: /run/user/1000/gvfs/ftp:host=x.y.y.z.
- Thunar: works fine, including loading & saving of files.
directly into e.g. an editor & saving back.
- Dolphin, Konqueror: work fine most of the time, including loading
directly into e.g. an editor & saving back. But no obvious disconnect.
- Chrome, Firefox: view/navigate directories & and view files**Mac OS X, various Versions**
- ftp: works like on Linux
- Chrome, Firefox: view/navigate directories & and view files
- FileZilla, FireFtp, Cyberduck: Full operation, once proper configured (see above).
Configure Cyberduck to transfer data in the command session.
- Finder: Fails. It connects, but then locks in the attempt to display the
top level directory repeating attempts to open new sessions. Finder needs
full multi-session support, and never closes sessions properly.
- Mountainduck: Works well, including proper disconnect when closing.**Windows 10** (and Windows XP)
- ftp: supported. Be aware that the Windows variant of ftp differs slightly
from the Linux variant, but the most used commands are the same.
- File explorer: view/navigate directories & and copy files. For editing files you
have to copy them to your PC and back. Windows explorer does not always release the
connection when it is closed, which just results in a silent connection, which
is closed latest when Windows is shut down.
- FileZilla, FireFtp, Cyberduck: Full operation, once proper configured (see above).
Configure Cyberduck to transfer data in the command session.
- WinSCP: works fine
- NppFTP - FTP extension to Notepad++: Works fine and is very convenient.
- Mountainduck: Works to some extent, but sometimes stumbles and takes a long
time to open a file.**Android**
- ftp inside the terminal emulator termux: full operation.
- ftp-express
- Chrome: view/navigate directories & and view files**IOS 9.1**
- FTP Client lite: works flawless
**Windows 10 mobile**
- Metro file manager: Works with file/directory view & navigate, file download,
file upload, file delete, file rename. Slow and chaotic sequence of FTP commands.
Many unneeded re-login attempts.**Conclusion**: All dedicated ftp clients work fine, and most
of the file managers too.## Trouble shooting
The only trouble observed so far was clients not releasing the connections. You may tell
by the value of `uftp.client_list`, which should be empty if no client is connected, or by issuing the command rstat in ftp, which shows the number of connected clients.
In that case you may restart the server with uftpd.restart(). If `uftd.client_busy`
is `True` when no client is connected, then restart the server with with
`uftpd.restart()`. If you want to see what happens at the server, you may set verbose to 2.
Just restart it with `uftpd.restart(verbose = 1)`, or set `uftpd.verbose_l = 1`, and
`uftpd.verbose_l = 0` to stop control messages again.## Files
- uftpd.py: Server source file for ESP8266 and ESP32 from version='v1.9.3-575 on
- ftp.py: Simple version of the ftp server, which works in foreground. This
can be used with all Micorpython versions. It terminates when the client closes the
session. Only a single session is supported by this variant.
- README.md: This one