diff --git a/fs_data/README.md b/fs_data/README.md new file mode 100644 index 0000000000..c9d5133872 --- /dev/null +++ b/fs_data/README.md @@ -0,0 +1,20 @@ +# fs_data (PlatformIO data_dir) + +This folder is used as a minimal PlatformIO filesystem payload (`data_dir`) for builds that use `buildfs/uploadfs`. + +## Why it exists +In some setups (e.g. ESP32 4MB flash with smaller FS partitions), building a filesystem image from the default `wled00/data` content can exceed the available FS size and fail with errors like: +- `SPIFFS_write error: File system is full` + +To avoid that, `fs_data` contains only small config placeholders (e.g. `cfg.json`, `presets.json`) so filesystem builds remain reproducible on limited partitions. + +## What to put here +- `cfg.json` (optional, can be `{}`) +- `presets.json` (optional, can be `{}`) +- `wsec.json` (optional) — **do not commit secrets** (WiFi credentials). Keep it empty (`{}`) or manage locally. + +## How it is used +Typically enabled via `platformio_override.ini`, e.g.: +- `data_dir = ${PROJECT_DIR}/fs_data` + +This keeps upstream files untouched while allowing local/CI builds to succeed. \ No newline at end of file diff --git a/fs_data/cfg.json b/fs_data/cfg.json new file mode 100644 index 0000000000..0967ef424b --- /dev/null +++ b/fs_data/cfg.json @@ -0,0 +1 @@ +{} diff --git a/fs_data/presets.json b/fs_data/presets.json new file mode 100644 index 0000000000..0967ef424b --- /dev/null +++ b/fs_data/presets.json @@ -0,0 +1 @@ +{} diff --git a/fs_data/wsec.json b/fs_data/wsec.json new file mode 100644 index 0000000000..0967ef424b --- /dev/null +++ b/fs_data/wsec.json @@ -0,0 +1 @@ +{} diff --git a/platformio_override.ini.olaf.example b/platformio_override.ini.olaf.example new file mode 100644 index 0000000000..93d6d5146f --- /dev/null +++ b/platformio_override.ini.olaf.example @@ -0,0 +1,8 @@ +; copy to platformio_override.ini (local override, ignored by git) + +[platformio] +default_envs = esp32_4MB_V4_M + +[env] +build_flags = + -D WLED_RELEASE_NAME=\"WLEDMM-OLAF\" \ No newline at end of file