Skip to content

Commit 7d282c3

Browse files
committed
ESP32-P4-Nano WiFi fix: install c6 firmware updated in instructions
1 parent aaf5b2e commit 7d282c3

File tree

3 files changed

+15
-3
lines changed

3 files changed

+15
-3
lines changed

docs/gettingstarted/installation.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,10 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
2121

2222
The Web Installer works on Google Chrome or Microsoft Edge or similar browsers, not on Safari.
2323

24+
!!! tip "ESP32-P4-Nano"
25+
26+
On each esp32-p4-nano board, install [C6 firmware]([esp32-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.
27+
2428
**Step 4**: Connect to the ESP32-device
2529

2630
<img width="350" src="https://github.com/user-attachments/assets/f092743f-a362-40da-b932-d31b203d966d" />
@@ -43,6 +47,8 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
4347
<img width="200" src="https://github.com/user-attachments/assets/b2391752-51c4-400e-b95c-4fa865e93595" />
4448
<img width="200" src="https://github.com/user-attachments/assets/5e2ceefd-4c31-4b72-a228-f29373b677ac" />
4549

50+
Keep this page visible until installation complete.
51+
4652
**Step 8**: Optionally Press **Logs and Console**
4753

4854
<img width="350" alt="Screenshot 2025-06-07 at 20 57 54" src="https://github.com/user-attachments/assets/9ac753dc-93b7-4f79-9419-0c81d1a4bc26" />
@@ -97,6 +103,7 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
97103
!!! info "Using hostname"
98104
* Restart the device to make the hostname known to your network (go to system status, scroll down and press restart)
99105
* Enter the hostname in your browser e.g. [http://ml-home.local](http://ml-home.local)
106+
* ESP32-P4-Nano: November 16, 2025: hostname is not working correctly, use IP address instead
100107

101108
!!! warning "reload UI"
102109
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 +118,7 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
111118

112119
<img width="350" src="https://github.com/user-attachments/assets/8d8b9c2d-bed3-439e-a145-2bb204639c6c" />
113120

114-
* 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.
121+
* 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.
115122

116123
!!! info "Monitor"
117124
The Monitor should now show the effect
@@ -126,9 +133,13 @@ Install Moonlight onto an ESP32 microcontroller using the MoonLight Web installe
126133
The LEDs on your strip or panel should now show the effect
127134

128135
!!! tip "Choose driver"
129-
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.
136+
FastLED driver is best to start with if you have a normal (ws2812) LED strip or panel.
137+
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.
130138
In some cases restart the device to make layout changes effective is needed.
139+
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:
131140

141+
<img width="200" src="../../media/moonlight/esp32-p4-nano-quickstart.jpeg"/>
142+
132143
**Step 4**: Press save (💾). Saves your setup to the file system, so if a device is restarted, your settings are still there.
133144

134145
!!! info "Next steps"

docs/gettingstarted/installer.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,13 +33,14 @@ For a step-by-step instruction, go to <a href="https://moonmodules.org/MoonLight
3333
| esp32-d0-16mb | ![esp32-d0-16mb](../firmware/installer/images/esp32-d0-16mb.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-d0-16mb.json"></esp-web-install-button> | [Serg74](https://www.tindie.com/products/serg74/esp32-wroom-usb-c-d1-mini32-form-factor-board/){:target="_blank"} | |
3434
| esp32-d0 | ![esp32-d0](../firmware/installer/images/esp32-d0.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-d0.json"></esp-web-install-button> | | |
3535
| esp32-d0-moonbase | ![esp32-d0](../firmware/installer/images/esp32-d0.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-d0-moonbase.json"></esp-web-install-button> | | |
36-
| esp32-p4-nano | ![esp32-p4-nano](../firmware/installer/images/esp32-p4-nano.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-p4-nano.json"></esp-web-install-button> | [Waveshare](https://www.waveshare.com/esp32-p4-nano.htm){:target="_blank"} | |
36+
| esp32-p4-nano | ![esp32-p4-nano](../firmware/installer/images/esp32-p4-nano.jpg){: style="width:100px"} | [esp32-c6-firmware-update](https://esp32-c6-firmware-update.github.io/), see below + <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-p4-nano.json"></esp-web-install-button> | [Waveshare](https://www.waveshare.com/esp32-p4-nano.htm){:target="_blank"} | |
3737
| esp32-p4-olimex 🚧 | ![esp32-p4-olimex](../firmware/installer/images/esp32-p4-olimex.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-p4-olimex.json"></esp-web-install-button> | [Olimex](https://www.olimex.com/Products/IoT/ESP32-P4/ESP32-P4-DevKit/open-source-hardware){:target="_blank"} | |
3838
| esp32-c3-devkitm-1 | ![esp32-c3-devkitm-1](../firmware/installer/images/esp32-c3-devkitm-1.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-c3-devkitm-1.json"></esp-web-install-button> | [Ali*](https://s.click.aliexpress.com/e/_EIl7NKw){:target="_blank"} | |
3939
| esp32-c3-supermini | ![esp32-c3-supermini](../firmware/installer/images/esp32-c3-supermini.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest_esp32-c3-supermini.json"></esp-web-install-button> | [Ali*](https://s.click.aliexpress.com/e/_EIl7NKw){:target="_blank"} | |
4040
| others | ![others](../firmware/installer/images/others.jpg){: style="width:100px"} | <esp-web-install-button manifest="https://moonmodules.org/MoonLight/firmware/installer/manifest.json"></esp-web-install-button> | | |
4141

4242
* MoonBase firmware is MoonBase only, no MoonLight included (basis for other IOT projects)
43+
* On each esp32-p4-nano board, install [C6 firmware]([esp32-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.
4344

4445
## USB-to-serial chip drivers
4546

135 KB
Loading

0 commit comments

Comments
 (0)