ESP8266 · LittleFS · Trema IDE
Файлы на ESP8266: папка data и LittleFS
У NodeMCU и Wemos D1 mini 4 МБ памяти, и программе из них нужен примерно один. Остальное можно отдать под файлы: страницу сайта, картинки, настройки. Кладёте их в папку data рядом со скетчем и нажимаете «Файлы». Ниже — весь путь в Trema IDE по шагам, два готовых скетча и что делать, если не выходит.
Короче некуда. «Параметры платы» → «Flash Size» — любой вариант, кроме FS:none, например «4MB (FS:2MB OTA:~1019KB)» → подключить плату кабелем и выбрать её порт → залить скетч кнопкой «Загрузить» → «Файлы» → «Создать папку data» → положить в неё файлы → «Файлы» → «Залить». Кнопка «Файлы» есть в Trema IDE начиная с версии 1.10.13.
Зачем плате файлы
Файлы в памяти платы — как маленькая флешка внутри неё. Скетч открывает их по имени, читает и даже может дописывать. Что туда кладут:
- Страницы сайта —
index.html, стили, скрипты, значок. Плата раздаёт их в браузер, а вы правите страницу в обычном редакторе, а не строчками внутри скетча. - Картинки для страницы или для экрана.
- Настройки — например
config.jsonс именем устройства и интервалом опроса датчика. Поменяли файл — поменялось поведение, программу перезаливать не нужно. - Звуки и тексты — короткие записи, словари, таблицы.
Файлы и программа живут отдельно: переделали оформление — залили только файлы, исправили программу — залили только скетч, файлы на месте (если «Erase Flash» в «Параметрах платы» не стоит на «All Flash Contents»; по умолчанию там «Only Sketch»).
LittleFS и SPIFFS: что это
Файловая система — порядок, в котором файлы разложены по памяти. Прежняя SPIFFS в ядре ESP8266 объявлена устаревшей, Trema IDE заливает файлы в LittleFS, поэтому в скетче — #include <LittleFS.h> и LittleFS.begin().
Важно: в скетче LittleFS, не SPIFFS. Старые примеры со SPIFFS.begin() не подойдут: SPIFFS не узнает файлы LittleFS, сочтёт раздел испорченным и отформатирует его — всё залитое пропадёт.
Что понадобится
- Плата на ESP8266 — NodeMCU v2/v3, Wemos D1 mini или похожая — и кабель USB, который передаёт данные, а не только заряжает. Файлы заливаются только по кабелю.
- Trema IDE 1.10.13 или новее: в ранних версиях кнопки «Файлы» нет.
- Пакет плат ESP8266 — он ставится сам, когда выбираете плату. В нём же лежат программы, которые упаковывают и записывают файлы.
Шаг 1. Выберите плату
В разделе «Платы» наберите 8266 или то, что написано на самой плате. NodeMCU v2 и v3 — это «NodeMCU 1.0 (ESP-12E Module)», Wemos D1 mini — «LOLIN(WEMOS) D1 R2 & mini». Нажмите «Выбрать».

Шаг 2. Выделите место под файлы: Flash Size
Память платы поделена на разделы: один под программу, другой под файлы. У ESP8266 нет отдельного пункта со схемами памяти: как поделена память, задаёт Flash Size в «Параметрах платы» (кнопка с ползунками рядом с названием платы). Flash Size — это и есть разметка памяти у ESP8266: так её называют окна Trema IDE. В скобках — сколько отдано файлам (FS) и какой скетч можно заливать по Wi-Fi (OTA). «FS» осталось от старых названий: это раздел под файлы, какой бы файловой системой он ни был занят.

| Flash Size | Файлам | Когда брать |
|---|---|---|
| 4MB (FS:2MB OTA:~1019KB) | 2,0 МБ | Выбран сразу у NodeMCU и D1 mini. Скетч до мегабайта, можно и по Wi-Fi |
| 4MB (FS:3MB OTA:~512KB) | 3,0 МБ | Больше места под файлы, но скетч по Wi-Fi — только до 512 КБ |
| 4MB (FS:1MB OTA:~1019KB) | 1000 КБ | Хватит на сайт из нескольких страниц |
| 4MB (FS:none OTA:~1019KB) | нет | Кнопка «Файлы» откажется: места под файлы нет |
| 1MB (FS:64KB … FS:512KB) — D1 mini Lite, ESP-01 | 64–512 КБ | Модули с 1 МБ: чем больше файлам, тем меньше скетчу |
Размеры — из описания плат в пакете ESP8266 3.1.2. Не знаете, что выбрать, — оставьте первый вариант, «4MB (FS:2MB OTA:~1019KB)»: двух мегабайт хватит на сайт с картинками. Под «Файлам» — весь раздел, самим файлам достаётся чуть меньше: часть уходит на служебные записи файловой системы.
Шаг 3. Залейте скетч с этим Flash Size
Подключите плату кабелем, выберите её порт вверху окна и нажмите «Загрузить». Подойдёт любой скетч, даже пустой из нового проекта: сейчас важен только Flash Size. Можно сразу залить пример 1 ниже.
Скетч запоминает, где в памяти лежат файлы, в момент сборки — по тому самому Flash Size. Кнопка «Файлы» пишет туда, где раздел в выбранном сейчас варианте. Если они разошлись, скетч будет искать файлы не там.
У ESP8266 программа не может это проверить: таблицы разделов, как у ESP32, на плате нет, сверять не с чем. Поэтому правило держите сами: сменили Flash Size — сначала «Загрузить», потом «Файлы». Об этом напоминает и строка в окне подтверждения.
Шаг 4. Нажмите «Файлы» и создайте папку data
У проектов на ESP8266 и ESP32 на панели сразу за «Загрузить» есть кнопка «Файлы». Пока папки data нет, она открывает окно «Файлы на плате»: в нём три строки о том, что к чему, и кнопки «Закрыть», «Как это работает» (ведёт на эту страницу) и «Создать папку data».

Нажмите «Создать папку data». Папка появится рядом со скетчем и в списке файлов проекта и сразу откроется в файловом менеджере (в Windows — в Проводнике): перетащите файлы туда. В консоли — «Папка data создана рядом со скетчем. Положите в неё файлы для платы и нажмите «Файлы»». Если папка уже есть, но пустая, кнопка будет называться «Открыть папку data» и откроет её в файловом менеджере.
Шаг 5. Положите файлы в data
Для примеров ниже нужны три файла:
папка проекта/
├── скетч.ino ← в плату не попадает как файл
└── data/
├── config.json → на плате /config.json
├── index.html → на плате /index.html
└── style.css → на плате /style.cssСама папка data в имя не входит: data/img/cat.png на плате — это /img/cat.png. Вложенные папки можно. Скрытые файлы (имя с точки), Thumbs.db и desktop.ini в плату не идут. Имена — только латиницей, без пробелов, и у ESP8266 есть свой предел: имя каждого файла и каждой папки — не длиннее 31 символа.
Содержимое файлов для примеров:
// data/config.json
{
"name": "teplitsa",
"interval": 10,
"led": true
}<!-- data/index.html -->
<!doctype html>
<html lang="ru">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Моя плата</title>
<link rel="stylesheet" href="/style.css">
</head>
<body>
<h1>Привет от платы!</h1>
<p>Эта страница лежит в памяти платы, в файле index.html.</p>
</body>
</html>/* data/style.css */
body {
font-family: sans-serif;
max-width: 32rem;
margin: 2rem auto;
padding: 0 1rem;
}
h1 {
color: #ff6a00;
}Шаг 6. «Файлы» → «Залить»
Плата подключена кабелем с шага 3, выбран её COM-порт — нажмите «Файлы» ещё раз. Программа спросит подтверждение и скажет, сколько файлов и какого объёма уйдёт в плату.

- «Файлы в памяти платы заменятся содержимым папки data» — раздел для файлов перезаписывается целиком. Файлы, которые записал сам скетч (журнал, сохранённые настройки), тоже исчезнут.
- «Скетч на плате не тронется.» — программа лежит в другом месте памяти.
- «Разметка памяти должна быть та же, с которой залит скетч.» — правило из шага 3.
Нажмите «Залить». Над консолью появится полоса «Заливка файлов» с часами и кнопкой «Остановить», под ней — что сейчас происходит: «Готовлю файлы…», «Упаковываю папку data…», «Записываю файлы в плату…». Упаковывает программа mklittlefs из пакета плат ESP8266, пишет — тот же upload.py, что заливает скетч.

Полоса быстро добегает до 99 % и стоит там около 10 секунд: программа записи в это время стирает раздел и проверяет записанное. Это нормально, не останавливайте заливку.
Когда запись закончится, в консоли будет итог (для трёх файлов из примера и «4MB (FS:2MB OTA:~1019KB)»; время и порт у вас свои):

Мы проверили это на настоящей ESP8266 (NodeMCU 1.0 с CH340) при Upload Speed 115200: три файла из примера записались за 19–21 секунду. Стирается и пишется весь раздел 2 МБ, поэтому для мелких файлов время почти не зависит от их размера; 600 КБ несжимаемых данных (фото, архивы) пишутся около 70 секунд.
Последняя строка — самое важное: сколько файлов ушло, сколько места под них и где оно в памяти. У варианта FS:2MB раздел начинается с 0x200000, у FS:3MB — с 0x100000, у FS:1MB — с 0x300000. Ниже — вывод программы записи, если понадобится разбираться.
После записи плата перезапустится сама. Если вы входили в режим прошивки кнопкой FLASH, нажмите RST.
Пример 1. Прочитать файл и вывести в монитор
Первый скетч без Wi-Fi: открывает файловую систему, перечисляет файлы и печатает содержимое config.json. С него удобно начинать — сразу видно, дошли ли файлы.
// Читаем файлы из памяти ESP8266 и печатаем их в монитор порта.
// Файлы лежат в папке data рядом со скетчем и заливаются в плату
// кнопкой «Файлы» в Trema IDE.
#include <LittleFS.h>
void setup() {
Serial.begin(115200);
delay(1000); // даём монитору порта время открыться
Serial.println();
// У ESP8266 begin() сам форматирует раздел, который не смог прочитать.
// Выключаем это: пусть лучше скажет, чем молча сотрёт файлы.
LittleFSConfig config;
config.setAutoFormat(false);
LittleFS.setConfig(config);
if (!LittleFS.begin()) {
Serial.println("Память с файлами не открылась: залейте папку data кнопкой «Файлы»");
return;
}
FSInfo info;
LittleFS.info(info);
Serial.printf("Занято %u из %u байт\n", (unsigned)info.usedBytes, (unsigned)info.totalBytes);
// Список файлов в корне
Serial.println("Файлы на плате:");
Dir dir = LittleFS.openDir("/");
while (dir.next()) {
Serial.printf(" %s, %u байт\n", dir.fileName().c_str(), (unsigned)dir.fileSize());
}
// Содержимое одного файла целиком
File file = LittleFS.open("/config.json", "r");
if (!file) {
Serial.println("Нет файла /config.json");
return;
}
Serial.println("Содержимое /config.json:");
while (file.available()) {
Serial.write(file.read());
}
file.close();
Serial.println();
}
void loop() {
}Если вы уже залили его в шаге 3, просто откройте монитор порта. Если нет — залейте кнопкой «Загрузить»: файлы при этом не трогаются, если «Erase Flash» в «Параметрах платы» не стоит на «All Flash Contents». Этот вариант стирает всю память, файлы тоже, и после такой заливки их надо залить заново.
В мониторе порта на 115200 непонятные символы в первых строках после перезапуска — это загрузчик ESP8266 говорит на своей скорости 74 880, не пугайтесь. Дальше — сколько занято, список из трёх файлов с размерами и текст config.json.

В мониторе пусто — нажмите на плате RST: скетч печатает всё один раз при запуске и мог закончить раньше, чем открылся монитор.
Обратите внимание на setAutoFormat(false). Без этой строки LittleFS.begin() у ESP8266 сам форматирует раздел, который не смог прочитать. Если вы ошиблись с Flash Size, файлы исчезли бы молча; с ней скетч честно скажет, что память не открылась.
Пример 2. Сайт из файлов
Второй скетч подключается к Wi-Fi и раздаёт index.html и style.css из памяти платы. Впишите имя и пароль своей сети на 2,4 ГГц (на 5 ГГц ESP8266 не подключается).
// Сайт на ESP8266: страница index.html и оформление style.css лежат
// в памяти платы (папка data, кнопка «Файлы» в Trema IDE).
#include <ESP8266WiFi.h>
#include <ESP8266WebServer.h>
#include <LittleFS.h>
const char WIFI_SSID[] = "имя вашей сети";
const char WIFI_PASS[] = "пароль от сети";
ESP8266WebServer server(80);
// Главная страница — файл /index.html
void sendIndex() {
File page = LittleFS.open("/index.html", "r");
if (!page) {
server.send(500, "text/plain; charset=utf-8",
"На плате нет index.html: залейте папку data кнопкой «Файлы»");
return;
}
server.streamFile(page, "text/html");
page.close();
}
void setup() {
Serial.begin(115200);
delay(1000);
Serial.println();
LittleFSConfig config;
config.setAutoFormat(false); // не стирать раздел, если он не читается
LittleFS.setConfig(config);
if (!LittleFS.begin()) {
Serial.println("Память с файлами не открылась: залейте папку data кнопкой «Файлы»");
}
WiFi.mode(WIFI_STA);
WiFi.begin(WIFI_SSID, WIFI_PASS);
Serial.print("Подключаюсь к Wi-Fi");
while (WiFi.status() != WL_CONNECTED) {
delay(500);
Serial.print('.');
}
Serial.println();
Serial.print("Откройте в браузере: http://");
Serial.println(WiFi.localIP());
server.on("/", HTTP_GET, sendIndex); // адрес платы без файла — главная
server.serveStatic("/", LittleFS, "/"); // остальное — файлы как есть: /style.css, картинки
server.onNotFound([]() {
server.send(404, "text/plain; charset=utf-8", "Такого файла на плате нет");
});
server.begin();
}
void loop() {
server.handleClient();
}server.on("/", …)— когда браузер просит адрес платы без имени файла, отдаёмindex.html.streamFileшлёт файл кусками и не держит его целиком в оперативной памяти, которой у ESP8266 всего 80 КБ.server.serveStatic("/", LittleFS, "/")— остальное отдаётся из памяти платы по имени:/style.css, картинки, скрипты.onNotFound— ответ на адрес, которого нет.
Залейте скетч, откройте монитор порта и перейдите по адресу, который напишет плата. Чтобы поменять страницу, правьте index.html, нажимайте «Файлы» и обновляйте страницу в браузере — скетч перезаливать не нужно. Как устроен такой сервер и где ещё можно держать страницу — в статье про веб-сервер на плате.
Что может пойти не так
Когда кнопка «Файлы» не может залить, над консолью появляется карточка: что случилось и что сделать. Кнопка «Подробнее на trema.ru» в ней ведёт сюда (у карточек про связь с платой — на страницу ошибок загрузки). Карточки с их заголовками:
| Что пишет программа | Что на самом деле | Что сделать |
|---|---|---|
| «Файлы заливаются только по кабелю» | В меню порта выбран адрес платы по Wi-Fi. По воздуху заливается только скетч | Подключите плату кабелем, выберите её COM-порт вверху окна и нажмите «Файлы» ещё раз |
| «Не выбран порт платы» | Плата не подключена или порт не выбран | Подключите кабелем, выберите порт. Порта нет вовсе — нужен драйвер CH340 или CP2102 либо кабель «с данными» |
| «В выбранной разметке памяти нет места под файлы» | В «Параметрах платы» → «Flash Size» стоит вариант FS:none | Выберите размер с местом под файлы, например «4MB (FS:2MB OTA:~1019KB)». Залейте скетч кнопкой «Загрузить», потом нажмите «Файлы» |
| «Файлы не помещаются в память платы» | Файлы с запасом на служебные записи файловой системы не входят в раздел, а каждый файл занимает целое число блоков по 8 КБ. Карточка скажет, сколько займут файлы и сколько есть места | Уберите что-нибудь из папки data (большие картинки, видео), объедините мелкие файлы или выберите в «Параметрах платы» Flash Size, где под файлы больше места |
| «Переименуйте файлы латиницей» | В имени файла или папки русские буквы или значки — скетч такой файл не откроет | Переименуйте латиницей, без пробелов: «кот.png» → «cat.png». Программа перечислит, какие именно |
| «Слишком длинные имена файлов» | Имя файла или одной из папок длиннее 31 символа | Сократите имена: «photo-from-the-summer-trip-2026.jpg» → «summer.jpg» |
| «Разметка памяти платы не читается» | Границы раздела для файлов в описании платы не сходятся | Проверьте пункт «Flash Size» в «Параметрах платы» или переустановите пакет плат ESP8266 |
| «Не удалось подготовить пакет платы ESP8266» | Пакет плат ещё не установлен, а интернета нет | Подключите компьютер к сети и нажмите «Файлы» ещё раз — пакет скачается сам. Не помогло — переустановите его в разделе «Платы» |
| «Не хватает программы для заливки файлов» | В пакете платы нет программы упаковки или записи (mklittlefs, upload.py, python3) | Переустановите пакет плат ESP8266 в разделе «Платы» |
| «Плата ESP не входит в режим прошивки» | Плата не ответила программе записи: не тот порт, кабель только для зарядки или автосброс не сработал | Зажмите на плате кнопку FLASH (на некоторых платах — BOOT) в момент начала записи. Проверьте кабель. ESP-01 на переходнике переводят в режим прошивки перемычкой GPIO0 на землю |
| «Связь с платой ESP обрывается во время прошивки» | Плата откликнулась, но передача рвётся: кабель, разъём или питание | Возьмите короткий кабель, воткните в порт самого компьютера, не в хаб. В «Параметрах платы» поставьте Upload Speed 115200 |
| «Файлы не записались в плату» | Запись не прошла, а причину программа не узнала | Проверьте кабель и порт, отключите от платы лишние провода и попробуйте ещё раз. Что ответила программа записи — в консоли |
| «Не удалось упаковать папку data» | Программа упаковки остановилась с ошибкой. Чаще всего файл из data открыт в другой программе | Закройте файлы из data в других программах (редактор картинок, браузер) и попробуйте ещё раз |
| «Эта плата не хранит файлы» | Вверху окна выбрана не ESP8266 и не ESP32 | Проверьте, какая плата выбрана: кнопка «Файлы» работает только с ними |
Например, так выглядит карточка, если в «Flash Size» выбран вариант FS:none: места под файлы нет, и программа ничего не пишет в плату.

Если «Загрузить» или «Файлы» обрываются с «Unable to verify flash chip connection» или связь пропадает посреди записи, проверьте в «Параметрах платы» «Upload Speed»: если там больше 115200, поставьте 115200 и попробуйте снова. Такое мы видели на плате с CH340.
А если заливка прошла, но скетч пишет «Память с файлами не открылась», почти всегда скетч собран с другим Flash Size, чем залиты файлы, или в нём SPIFFS.begin() вместо LittleFS.begin(). Выберите тот же Flash Size, залейте скетч, потом файлы. Если в скетче не было setAutoFormat(false), раздел мог уже отформатироваться — тогда файлы придётся залить заново.
Файлы пропали после заливки скетча — проверьте «Параметры платы»: если «Erase Flash» стоит на «All Flash Contents», заливка скетча стирает всю память. Верните «Only Sketch» и залейте файлы заново. Сама кнопка «Файлы» этот пункт не выполняет и скетч не стирает — в консоли будет строка «Из команды загрузки ядра не взято (пишется только раздел для файлов): erase_flash». Мы проверили это на плате: после такой заливки файлов скетч работал как прежде.
В меню порта (кнопка с COM-портом вверху окна) у плат ESP8266 и ESP32 есть строка «Файлы на плате (папка data)» — она тоже открывает эту инструкцию.
Частые вопросы
Можно ли называть файлы в data по-русски?
Нет. Имя с русскими буквами попадает в память платы в другой кодировке, и скетч такой файл не откроет, поэтому Trema IDE откажется заливать и назовёт эти файлы. Пишите латиницей, без пробелов. У ESP8266 есть и предел длины: каждое имя файла или папки — не длиннее 31 символа.
Сколько файлов поместится в память ESP8266?
Сколько выбрано в пункте Flash Size: у NodeMCU и Wemos D1 mini это 1, 2 или 3 МБ из четырёх. Считать надо блоками: на этих платах блок 8 КБ, и каждый файл больше 256 байт занимает целые блоки. Двадцать мелких файлов по килобайту съедят не 20 КБ, а около 160. Если не входит, Trema IDE скажет, сколько нужно и сколько есть.
Сотрёт ли заливка файлов мой скетч?
Нет. Кнопка «Файлы» пишет только раздел для файлов, программа лежит в другом месте памяти и остаётся как была. И наоборот: заливка скетча кнопкой «Загрузить» файлы не трогает, если в «Параметрах платы» «Erase Flash» не стоит на «All Flash Contents» (по умолчанию там «Only Sketch»). Этот вариант стирает всю память, файлы тоже, и после такой заливки их надо залить заново.
Пропадут ли файлы, которые записал сам скетч?
Да. Раздел для файлов заменяется целиком содержимым папки data: журнал, настройки и всё, что программа сохранила на плату сама, исчезнет. Нужные файлы сначала выведите в монитор порта или отдайте на страницу и сохраните на компьютере.
Можно ли залить файлы по Wi-Fi?
В Trema IDE — нет, только по кабелю. По Wi-Fi заливается скетч, а для файлов выберите COM-порт платы. Если выбран адрес по Wi-Fi, программа скажет «Файлы заливаются только по кабелю» и ничего не тронет.
Работает ли SPIFFS.begin() на ESP8266?
В ядре ESP8266 SPIFFS объявлена устаревшей, и Trema IDE заливает файлы только в LittleFS. Пишите в скетче #include <LittleFS.h> и LittleFS.begin(). Со SPIFFS.begin() плата не узнает файлы в разделе и, скорее всего, отформатирует его.
Как это делается в Arduino IDE?
В Arduino IDE 1.8 был отдельный Java-плагин ESP8266 LittleFS Data Upload: его скачивали, клали в папку tools и перезапускали программу. В Arduino IDE 2 старые плагины не работают, встроенной команды нет: ставят плагин arduino-littlefs-upload и вызывают команду «Upload LittleFS to Pico/ESP8266/ESP32» в палитре Ctrl+Shift+P. В Trema IDE начиная с версии 1.10.13 это кнопка «Файлы» на панели, рядом с «Загрузить», плагин не нужен. Проект из Arduino IDE с папкой data рядом со скетчем открывается в Trema IDE как есть: папка та же, файловая система та же — LittleFS.
Можно ли залить файлы в ESP-01?
Можно, если выбрать в Flash Size вариант с местом под файлы: у модулей с 1 МБ это от 64 до 512 КБ. Блок там 4 КБ (у варианта FS:512KB — 8 КБ), а программы с Wi-Fi оставляют файлам немного, так что держите в data только нужное. Плату надо перевести в режим прошивки, как для обычной заливки.
Дальше по теме
- Файлы на ESP32 — то же для ESP32: схемы памяти Partition Scheme и сверка с платой.
- Веб-сервер на Arduino — как плата отдаёт страницу и почему она подвисает.
- Заливка ESP8266 по Wi-Fi — скетч без кабеля; Flash Size решает и это.
- ESP8266 в Arduino IDE — сама плата: выводы, память, первые шаги.
Файлы на плате в Trema IDE
Папка data рядом со скетчем и кнопка «Файлы» на панели — без плагинов и ручной возни с программами записи. Размер раздела программа берёт из Flash Size сама, а ошибки объясняет по-русски.
