This is a custom firmware for the BTT TF Cloud V1.0 devices.
More information about these devices can be found at the official repro https://github.com/bigtreetech/BTT-SD-TF-Cloud-V1.0.
DISCLAIMER: This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
- FTP server (tested with FileZilla; for the FileZilla settings read the section FTP, please)
- WebDAV server
- WiFi config mode via an access point
- SD card is in use only when a connection (WebDAV or FTP) is established
- Over-the-Air (OTA) firmware update via a web interface
- Info page
- FAT16 and FAT32 support
- Supports up to 32 GB microSD/TF cards
The latest release can be found here: https://github.com/AlbrechtL/BTT_TF_Cloud_AFW/releases
esptool.py is needed for the flashing AFW initially. Please visit https://github.com/espressif/esptool for details.
A backup of the original firmware is always recommended. Read the section "Backup of original firmware", please.
This options is only available if you already have an installed AFW.
- Download the latest release
- Open a web browser
- Browse to
http://<your IP>/webota - Select the AFW firmware e.g.
BTT-SD-TF-Cloud_AFW_0.1.bin - Click update
TBD
- Download the latest release
- Disconnect the BTT TF Cloud device from the SD card slot. WARNING: If you don't do this you can damage your device with the SD or miroSD slot.
- Connect it via USB
- Discover which serial interface is used
- Start
esptool.py -p <your serial port> write_flash 0x0000 <your download firmware.bin>Example:
# esptool.py -p /dev/ttyUSB0 write_flash 0x0000 BTT-SD-TF-Cloud_AFW_0.1.bin
- Wait until
esptool.pyreportsConnecting..
esptool.py v3.0
Serial port /dev/ttyUSB0
Connecting........_____.....___
- First, press and hold the BOOT push button and second press the RST push button
- Release both buttons at the same time
- The flash process should run now
# esptool.py -p /dev/ttyUSB0 write_flash 0x0000 BTT-SD-TF-Cloud_AFW_0.1.bin
esptool.py v3.0
Serial port /dev/ttyUSB0
Connecting........_
Detecting chip type... ESP8266
Chip is ESP8266EX
Features: WiFi
Crystal is 26MHz
MAC: XX:XX:XX:XX:XX:XX
Uploading stub...
Running stub...
Stub running...
Configuring flash size...
Compressed 387296 bytes to 276107...
Wrote 387296 bytes (276107 compressed) at 0x00000000 in 24.4 seconds (effective 126.8 kbit/s)...
Hash of data verified.
Leaving...
Hard resetting via RTS pin...
- Press the RST button to restart the device
- To verify the new firmware you can use a serial terminal e.g. minicom
# minicom -D /dev/ttyUSB0 -b 115200
��$s�`��'�
**********************************************
BTT TF Cloud AFW Version 0.1
**********************************************
--------------------------------
Connect to WiFi
--------------------------------
*WM:
*WM: AutoConnect
*WM: Connecting as wifi client...
*WM: Status:
*WM: 6
*WM: Using last saved values, should be faster
*WM: Connection result:
*WM: 3
*WM: IP Address:
*WM: 10.1.40.249
connected...yeey :)
--------------------------------
Start firmware update server
--------------------------------
Connected to 'XXXXXXXXX'
IP address : 10.1.40.249
MAC address : XX:XX:XX:XX:XX:XX
mDNS started : BTT_TF_CLOUD_AFW.local
WebOTA url : http://BTT_TF_CLOUD_AFW.local:80/webota
--------------------------------
Start WebDAV server
--------------------------------
WebDAV server started
--------------------------------
Start FTP server
--------------------------------
FTP server started
Ftp server waiting for connection on port 21
- Now you can setup your WiFi, see section "WiFi Config"
- Put the BTT TF Cloud back into your SD or microSD card slot
Top
Bottom
If no WiFi settings are stored the device opens a new access point with the SSID BTT_TF_CLOUD_AFW.
How to set up
- Connect via to the WiFi
BTT_TF_CLOUD_AFW - Browse to
http://192.168.4.1 - Configure your requested WiFi
- Save
How to reset your config
- Power on the device
- Press the
BOOTbutton up to 5 seconds until the LED is starting to blink - Release the button
- When the LED is off the device reboots
- Proceed like above
This project is a WiFi WebDAV server using ESP8266 SoC. It maintains the filesystem on an SD card.
Supports the basic WebDav operations - PROPFIND, GET, PUT, DELETE, MKCOL, MOVE etc.
Once the WebDAV server is running on the ESP8266, a WebDAV client like Windows can access the filesystem on the SD card just like a cloud drive. The drive can also be mounted like a networked drive, and allows copying/pasting/deleting files on SD card remotely.
To access the drive from Windows use the Map Network Drive menu in Windows Explorer with the address http://<BTT_IP>:8080.
Runs at port 8080
The FTP server is tested with FileZilla. If you would like to use another FTP client read the limiations, please.
Runs at port 21
Limitations
- The LIST command is not supported so the most FTP clients will not work
- Only supports passive FTP mode
- No encryption
- Accepts only 1 connection at the same time
FileZilla Settings
Please apply the following settings to FileZilla.
-
Set maximum simultaneous transfers to 1
-
Disable treat files without extensions as ASCII file. This options is enabled by default and can results in broken binary files.
PlatformIO (https://platformio.org/) is required and it should install the dependencies automatically.
-
Open PlatformIO
-
Open the folder with this repository
-
Build it
-
Connect your PC to the device
WARNING: Don't insert the BTT device the same time in a SD slot because of back feeding the voltage or remove the LM1117 voltage regulator (see below)! -
Upload it to the device
-
When PlatformIO (esptool) is trying to connect to the BTT device press and hold the BOOT switch and hit the RST switch a shot of time.
Uploading .pio/build/esp12e/firmware.bin
esptool.py v2.8
Serial port /dev/ttyUSB0
Connecting........_____..
-
Wait until the flash process is done
-
Reset the device again with the RST switch.
- Backup the original firmware by using the command
esptool.py -p <your serial port> read_flash 0x0000 0x400000 BTT_Original_Firmware.bin
# esptool.py -p /dev/ttyUSB0 read_flash 0x00000 0x400000 BTT_Original_Firmware.bin
- Wait until
esptool.pyreportsConnecting..
esptool.py v3.0
Serial port /dev/ttyUSB0
Connecting........_____.....___
- First, press and hold the BOOT push button and second press the RST push button
- Release both buttons at the same time
- The reading process should run now
HINT: Your can find the original firmware also inside the folder "original_firmware" in this repo.
BTT TF Cloud hardware uses the following SD card connections:
| ESP Module | SD Card |
|---|---|
| GPIO13 | MOSI |
| GPIO12 | MISO |
| GPIO14 | SCK |
| GPIO4 | CS |
| GPIO5 | CS Sense |
The real BTT TF Cloud schematic is fully documented and may different from the following schematics. At the official GitHub repo (https://github.com/bigtreetech/BTT-SD-TF-Cloud-V1.0) only a few information can be found.
It looks like that the BTT TF Cloud is using a schematic like this one: https://3dtoday.ru/blogs/massaraksh7/sd-karta-s-wifi-na-esp8266-dlya-3d-printera-plug-and-play?fbclid=IwAR3Re1DvyVIkiezvatVK9iViC1FurmdtnGOtBKMQJc4QwWB763S28cFTv2s
Here is another sample schematic which is similar to the BTT TF Cloud devices.
To connect the ESP8266 to USB and let the device connected via SD it is necessary to remove the LM1117 voltage regulator. In all other cases it is not necessary to remove it!
NOTE: It seems that the ESP8266 is not booting with removed LM1117 and unconnected USB +5V power.
- ardyesp for ESPWebDAV https://github.com/ardyesp/ESPWebDAV
- Jean-Michel Gallego, David Paiva and others for ESP8266FTPServer https://github.com/nailbuster/esp8266FTPServer
- Scott Baker for ESP-WebOTA: https://github.com/scottchiefbaker/ESP-WebOTA
- tzapu for https://github.com/tzapu/WiFiManager