Merge branch 'main' into dev

Author: ewowi

.gitignore

@@ -22,4 +22,5 @@ ssl_certs/cacert.pem
 .DS_Store
 .aid
 /scripts/__pycache__
-/site
+/site
+.DS_Store

README.md

@@ -57,7 +57,7 @@
 ## 🚀 Quick Start
 
 ### 1️⃣ Flash & Go
-Use our [web installer](https://moonmodules.org/MoonLight/gettingstarted/installation/) to flash MoonLight directly via a USB cable to your ESP32, connect LEDs to it and you are ready to go.
+Use our [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installation/) to flash MoonLight directly via a USB cable to your ESP32, connect LEDs to it and you are ready to go.
 
 ### 2️⃣ Connect & Configure
 Built-in access point makes WiFi setup effortless. Configure through the intuitive web interface.
@@ -126,17 +126,10 @@ Start creating stunning effects immediately on both mobile and desktop.
 ### Version 0.6.0 - November 2025
 **The user-friendly baseline release**
 
-✨ **Coming Features:**
-
-- Plug & Play Experience
-- Preset Controller for quick effect management
-- Enhanced Web Installer with one-click flashing
-- Large Display Drivers for massive installations
-- WLED Audio Sync for music synchronization
-- Refined Interface with polished UX
-
 **From 0.6.0 Forward:** Community-driven development focused on ease of use, more effects, and expanded hardware support.
 
+See [v0.7.0 Kanban board](https://github.com/users/MoonModules/projects/4) or log an [Issue](https://github.com/MoonModules/MoonLight/issues/new/choose) to report issues or request enhancements.
+
 ---
 
 ## 🏗️ Architecture & Flexibility

docs/buildprocess.md

@@ -40,6 +40,7 @@ Customize the settings as you see fit. A value of 0 will disable the specified f
   -D FT_DOWNLOAD_FIRMWARE=1
   -D FT_SLEEP=1
   -D FT_BATTERY=1
+  -D FT_ETHERNET=1
 ```
 
 | Flag                 | Description                                                                                                                                                                                                              |
@@ -51,6 +52,7 @@ Customize the settings as you see fit. A value of 0 will disable the specified f
 | FT_DOWNLOAD_FIRMWARE | Controls whether the firmware download feature is enabled. Disable this if you won't firmware pulled from a server.                                                                                                      |
 | FT_SLEEP             | Controls whether the deep sleep feature is enabled. Disable this if your device is not battery operated or you don't need to place it in deep sleep to save energy.                                                      |
 | FT_BATTERY           | Controls whether the battery state of charge shall be reported to the clients. Disable this if your device is not battery operated.                                                                                      |
+| FT_ETHERNET          | Controls whether an ethernet interface will be used. Disable this if your device has no ethernet interface connected.                                                                                      |
 
 In addition custom features might be added or removed at runtime. See [Custom Features](statefulservice.md#custom-features) on how to use this in your application.
 

docs/develop/development.md

@@ -102,7 +102,7 @@ After configuring the development server, a local webserver starts on [localhost
 
 Firmware binaries come in 2 flavours: including boot and partition (merged) and MoonLight code only (release). They are stored in the build folder of the MoonLight repo and updated each time a build or upload (☑️ or ➡️) is done. Subfolder merged contains the first type, release the second type.
 
-* Merged bins are used by the web installer, release bins by the [System update](https://moonmodules.org/MoonLight/system/update/) module (OTA). System update uses the bins stored in [GitHub releases](https://github.com/MoonModules/MoonLight/releases).
+* Merged bins are used by the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/), release bins by the [System update](https://moonmodules.org/MoonLight/system/update/) module (OTA). System update uses the bins stored in [GitHub releases](https://github.com/MoonModules/MoonLight/releases).
 * Merged bins starts flashing on address 0x0, release bins on address 0x10000.
 * All MoonLight partition schemes have a firmware size of 3MB. Smaller devices (e.g. ESP32-D0) have no OTA partition. System update is possible in this situation, but there is no fallback if update fails (need to flash using USB in that case) 🚧
 

docs/develop/installation.md

@@ -87,7 +87,7 @@ The development environment consists of
 
 !!! info "USB-to-serial chip drivers"
 
-    In some cases, ESP32-devices won't show connected. See USB-to-serial chip drivers at [MoonLight Web Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) 
+    In some cases, ESP32-devices won't show connected. See USB-to-serial chip drivers at [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) 
 
 * Erase the device if it is a new device or the device has not been used for MoonModules before: go to 👽 in the left menu and select Erase Flash
 

docs/gettingstarted/hardware.md

@@ -8,7 +8,7 @@ To get started the minimal you need is an esp32-device connected via USB to your
 
 ## Minimal hardware
 
-* One of the ESP32-devices shown in [MoonLight Web Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/). [ESP32-S3 N16R8](https://s.click.aliexpress.com/e/_DBAtJ2H) recommended. Optional [Expansion board 44pin](https://s.click.aliexpress.com/e/_EJhmlIE)
+* One of the ESP32-devices shown in [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/). [ESP32-S3 N16R8](https://s.click.aliexpress.com/e/_DBAtJ2H) recommended. Optional [Expansion board 44pin](https://s.click.aliexpress.com/e/_EJhmlIE)
 * Any WS2812 LED strip or panel. [256 LED panel](https://s.click.aliexpress.com/e/_EIKoYrg) recommended.
 * Connect the ESP32-device with USB to your computer, connect the LED strip or panel
 

docs/gettingstarted/installation.md

@@ -6,20 +6,25 @@
 
 **[▶️ Watch the install tutorial](https://www.youtube.com/watch?v=7DQOEWa-Kwg)**
 
+## MoonLight Installer
 
-## MoonLight Web installer
-
-Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installer
+Install Moonlight onto an ESP32 microcontroller using the MoonLight Installer
 
 **Step 1**: Get an **ESP32** and a **WS2812 LED-strip** or **LED-panel**. See [Hardware](https://moonmodules.org/MoonLight/gettingstarted/hardware/).
 
 **Step 2**: Connect the ESP32 via USB, use an USB cable which supports data transfer
 
-**Step 3**: Go to the [MoonLight Web Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/). Select your ESP32-device, or if not listed, press others.
+!!! info "Bootloader mode"
+    Some boards: Place the board in bootloader mode by press and holding the `Boot` button on the ESP32, press the `Reset` button on the ESP32 and then release the `Boot` button.
+
+**Step 3**: Go to the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/). Select your ESP32-device, or if not listed, press others.
 
 !!! info "Browser support"
+    The installer works on Google Chrome or Microsoft Edge or similar browsers, not on Safari.
+
+!!! tip "ESP32-P4-Nano"
 
-    The Web Installer works on Google Chrome or Microsoft Edge or similar browsers, not on Safari.
+    On each esp32-p4-nano board, install [C6 firmware update](https://esp32-c6-firmware-update.github.io/) first, choose Via ESP32-P4 USB/UART port ("OTA update"), then press connect for MoonLight install.
 
 **Step 4**: Connect to the ESP32-device
 
@@ -43,6 +48,8 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
    <img width="200" src="https://github.com/user-attachments/assets/b2391752-51c4-400e-b95c-4fa865e93595" />
    <img width="200" src="https://github.com/user-attachments/assets/5e2ceefd-4c31-4b72-a228-f29373b677ac" />
 
+Keep this page visible until installation complete.
+
 **Step 8**: Optionally Press **Logs and Console**
 
    <img width="350" alt="Screenshot 2025-06-07 at 20 57 54" src="https://github.com/user-attachments/assets/9ac753dc-93b7-4f79-9419-0c81d1a4bc26" />
@@ -56,6 +63,9 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
 
    <img width="200" src="https://github.com/user-attachments/assets/9a146e3c-1a53-4906-ad2a-d70215efcf4b" />
 
+!!! tip "Reset"
+    Some boards need a reset to show up. Press the reset button on the ESP32 or press Reset in Step 8 above
+
 **Step 2**: After connecting, MoonLight will show up in a **web browser** (all browsers supported). You will see this screen, select WiFi Station.
 
    <img width="400" src="https://github.com/user-attachments/assets/f480356d-bf56-4a6b-b6f2-0be49fa27db3" />
@@ -97,6 +107,7 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
 !!! info "Using hostname"
     * Restart the device to make the hostname known to your network (go to system status, scroll down and press restart)
     * Enter the hostname in your browser e.g. [http://ml-home.local](http://ml-home.local)
+    * ESP32-P4-Nano: November 16, 2025: hostname is not working correctly, use IP address instead
 
 !!! warning "reload UI"
     See step 2 ⚠️ if UI is not showing up, use [http://ml-home.local](http://ml-home.local) (replace ml-home with the hostname) or the IP address.
@@ -111,7 +122,7 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
 
    <img width="350" src="https://github.com/user-attachments/assets/8d8b9c2d-bed3-439e-a145-2bb204639c6c" />
 
-* Add a layout Node by pressing the blue + button and select on off the 🚥 options (Panel 🚥 is a safe bet to start with). Scroll down to the Pin Control field and enter the pin number(s) you connected the strip or panel to. 
+* Add a layout Node by pressing the blue + button and select on off the 🚥 options (Panel 🚥 is a safe bet to start with). Scroll down to the Pin Control field and enter the pin number(s) you connected the strip or panel to, make sure the pin exists, otherwise the device can crash and will restart in save mode. Correct the pin(s) in the Layout node and restart. 
 
 !!! info "Monitor"
     The Monitor should now show the effect
@@ -126,9 +137,16 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
     The LEDs on your strip or panel should now show the effect
 
 !!! tip "Choose driver"
-    FastLED driver is best to start with if you have a normal (ws2812) LED strip or panel. Choose the Physical driver if you have more then 4 LED strips or panels or non standard LEDS (e.g. RGBW lights, curtains...). Other drivers (Virtual, Hub,) not supported yet.
+    FastLED driver is best to start with if you have a normal (ws2812) LED strip or panel. 
+
+    Choose the Physical driver if you have more then 4 LED strips or panels or non standard LEDS (e.g. RGBW lights, curtains...). Other drivers (Virtual, Hub,) not supported yet.
+
     In some cases restart the device to make layout changes effective is needed.
+    
+    For ESP32-P4-Nano, choose Physical driver, using the Parallel IO driver by @Troyhacks. Easy quick start: choose Pin 37 and connect a LED strip or panel as follows (Note: the pins on the board the jst connector is plugged in are in order +, Ground, Data !!! - Ignore the wire colors!):
 
+    <img width="200" src="../../media/moonlight/esp32-p4-nano-quickstart.jpeg"/>
+
 **Step 4**: Press save (💾). Saves your setup to the file system, so if a device is restarted, your settings are still there.
 
 !!! info "Next steps"
@@ -145,5 +163,5 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
     * Download from GitHub
     * Upload from file. From a [GitHub release](https://github.com/MoonModules/MoonLight/releases), or created by VSCode, see [Develop / Installation](https://moonmodules.org/MoonLight/develop/installation/)
 
-* To install the latest release, you can also use the [MoonLight Web Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) (no need to erase the device if updating)
+* To install the latest release, you can also use the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) (no need to erase the device if updating)
 * Upload directly from VSCode, see [Develop / Installation](https://moonmodules.org/MoonLight/develop/installation/)