![\"ESP8266](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/ESP8266-LittleFS-VSCode-PlatformIO.jpg?resize=1200%2C675&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nIf you’re using Arduino IDE follow this tutorial instead: Install ESP8266 Filesystem Uploader in Arduino IDE<\/a>.<\/p>\n\n\n\n There are two filesystems you can use for the onboard ESP8266 flash: SPIFFS and LittleFS.<\/p>\n\n\n\n SPIFFS and LittleFS let you access the flash memory like you would do in a normal filesystem in your computer, but simpler and more limited. You can read, write, close, and delete files.<\/p>\n\n\n\n SPIFFS:<\/strong><\/p>\n\n\n\n LittleFS:<\/strong><\/p>\n\n\n\n For more information about SPIFFS and LittleFS, refer to the ESP8266 Arduino Core documentation<\/a>.<\/p>\n\n\n\n SPIFFS is currently deprecated and may be removed in future releases of the ESP8266 LittleFS is under active development, supports directories, and is many times faster for most operations. The methods used for SPIFFS are compatible with LittleFS, so, we can simply use the expression LittleFS<\/span> instead of SPIFFS<\/span> when converting a code from SPIFFS to LittleFS. <\/p>\n\n\n\n For example, converting most applications from SPIFFS to LittleFS simply requires changing the SPIFFS.begin()<\/span> to LittleFS.begin()<\/span> and SPIFFS.open()<\/span> to LittleFS.open()<\/span>.<\/p>\n\n\n\n Using the filesystem with the ESP8266 board<\/a> is specially useful to:<\/p>\n\n\n\n The files you want to upload to the ESP8266 filesystem should be placed in a folder called data<\/em> under the project folder. For you to understand how everything works, we’ll upload a .txt<\/span> file with some random text. You can upload any other file type.<\/p>\n\n\n\n If you’re not familiar with VS Code + PlatformIO IDE, follow the next tutorial first:<\/p>\n\n\n\n SPIFFS is currently deprecated and may be removed in future releases of the ESP8266 core. It is recommended to use LittleFS instead. LittleFS is under active development, supports directories, and is many times faster for most operations. So, we’ll use LittleFS in this tutorial.<\/p>\n\n\n\n In VS Code + PlatformIO, when uploading files, we must specify that we want to use LittleFS filesystem instead of SPIFFS (default), so you need to add the following line to the ESP826 platformio.ini<\/span> configuration file.<\/p>\n\n\n\n Create a folder called data <\/em>inside your project folder. This can be done on VS Code. This new folder must be called data<\/em>, otherwise, it won\u2019t work.<\/p>\n\n\n\n Then, select the newly created data <\/em>folder and create the files you want to upload by clicking on the New File<\/strong> icon. In this example, we’ll create a file called text.txt<\/span>. You can create and upload any other file types like .html<\/em>, .css<\/em> or .js<\/em> files, for example.<\/p>\n\n\n\n Write some random text inside that .txt<\/span> file.<\/p>\n\n\n\n The data <\/em>folder should be under the project folder and the files you want to upload should be inside the data <\/em>folder. Otherwise, it won’t work.<\/p>\n\n\n\n After creating and saving the file or files you want to upload under the data<\/em> folder, follow the next steps:<\/p>\n\n\n\n Important: <\/strong> to upload the filesystem image successfully you must close all serial After a while, you should get a success message.<\/p>\n\n\n\n Here’s a common mistake:<\/p>\n\n\n\n This error means that you have a serial connection opened with your board in VS Code or in any other program. Close any program that might be using the board serial port, and make sure you close all serial connections in VS Code (click on the recycle bin icon on the terminal console).<\/p>\n\n\n\n Now, let\u2019s just check if the file was actually saved into the ESP8266 filesystem. Copy the following code to the main.cpp<\/span> file and upload it to your board.<\/p>\n\n\n View raw code<\/a><\/p>\n\n\n\n You may need to change the following line depending on the name of your file.<\/p>\n\n\n\n Open the Serial Monitor and it should print the content of your file.<\/p>\n\n\n\n You’ve successfully uploaded files to the ESP8266 filesystem (LittleFS) using VS Code + PlatformIO.<\/p>\n\n\n\n With this tutorial you’ve learned how to upload files to the ESP8266 filesystem (LittleFS) using VS Code + PlatformIO. It is quick and easy.<\/p>\n\n\n\n This can be specially useful to upload HTML, CSS and JavaScript files to build web server projects with the ESP8266 NodeMCU boards.<\/p>\n\n\n\n We have a similar tutorial for the ESP32:\u00a0ESP32 with VS Code and PlatformIO: Upload Files to Filesystem (SPIFFS)<\/a><\/p>\n\n\n\n Learn more about the ESP8266 NodeMCU with our resources:<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" Learn how to upload files to the ESP8266 NodeMCU board filesystem (LittleFS) using VS Code with the PlatformIO IDE extension (quick and easy). Using the filesystem with the ESP8266 can … <\/p>\nIntroducing SPIFFS\/LittleFS<\/h2>\n\n\n\n
core. It is recommended to use LittleFS instead. <\/p>\n\n\n\nUpload Files to ESP8266 NodeMCU LittleFS<\/h2>\n\n\n\n
Using LittleFS as Default Filesystem<\/h3>\n\n\n\n
board_build.filesystem = littlefs<\/code><\/pre>\n\n\n\n![\"Use](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Use-littlefs-VS-Code-PlatformIO-ESP8266-NodeMCU.jpg?resize=844%2C365&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nCreating a data Folder<\/h3>\n\n\n\n
With your mouse, select the project folder you\u2019re working on. Click on the New Folder<\/strong> icon to create a new folder.<\/p>\n\n\n\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Create-data-folder-VS-Code-PIO-ESP8266-LittleFS.png?resize=708%2C308&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Create-files-under-data-folder-VS-Code-PIO-ESP8266-LittleFS.png?resize=676%2C332&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"Create](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Create-Text-File-VS-Code-PlatformIO-ESP8266.jpg?resize=860%2C293&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nUploading Filesystem Image<\/h3>\n\n\n\n
![\"Upload](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Upload-filesystem-image-ESP8266-VS-Code-PlatformIO-LittleFS.jpg?resize=696%2C427&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n
connections (Serial Monitor) with your board.<\/p>\n\n\n\n![\"Upload](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Upload-filesystem-image-ESP8266-VS-Code-PlatformIO-success-message.jpg?resize=608%2C160&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nTroubleshooting<\/h3>\n\n\n\n
Could not open port “COMX” Access is denied.<\/h4>\n\n\n\n
![\"Upload](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Upload-filesystem-image-permission-error-ESP8266.jpg?resize=590%2C162&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\n![\"VS](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/VS-Code-PlatformIO-Close-Terminal-Window.jpg?resize=698%2C40&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nTesting<\/h2>\n\n\n\n
\/*********\n Rui Santos\n Complete project details at https:\/\/RandomNerdTutorials.com\/esp8266-nodemcu-vs-code-platformio-littlefs\/ \n*********\/\n\n#include <Arduino.h>\n#include "LittleFS.h"\n \nvoid setup() {\n Serial.begin(9600);\n \n if(!LittleFS.begin()){\n Serial.println("An Error has occurred while mounting LittleFS");\n return;\n }\n \n File file = LittleFS.open("\/text.txt", "r");\n if(!file){\n Serial.println("Failed to open file for reading");\n return;\n }\n \n Serial.println("File Content:");\n while(file.available()){\n Serial.write(file.read());\n }\n file.close();\n}\n \nvoid loop() {\n\n}\n<\/code><\/pre>\n\tFile file = LittleFS.open(\"\/text.txt\");<\/code><\/pre>\n\n\n\n![\"Reading](\"https:\/\/i0.wp.com\/randomnerdtutorials.com\/wp-content\/uploads\/2020\/12\/Reading-Content-of-File-ESP8266-VSCode-PlatformIO.jpg?resize=610%2C233&quality=100&strip=all&ssl=1\")
<\/figure><\/div>\n\n\n\nWrapping Up<\/h2>\n\n\n\n