Board Presets and Art-Net-In updates and readPin checks and doc updates

Docs
====
- Add ESPConnect in installation
- Add board presets in IO
- Add Art-Net In in drivers

Back-end
========
- IO: add maxPower for DigOcta and Dig2Go
- readPins, only assign if valid(gpio)
- Art-Net In: add universe Min/Max

Author: ewowi

docs/develop/development.md

@@ -110,9 +110,11 @@ Firmware binaries come in 2 flavours: including boot and partition (merged) and
 !!! tip "flash firmware using esptool"
      * [>_] in the statusbar of vscode
      ```
-     esptool --port /dev/cu.usbmodem11201 write-flash 0x0 ./build/merged/MoonLight_esp32-s3-devkitc-1-n16r8v_0-6-0_webflash.bin
+     esptool --port /dev/cu.usbserial-1130 write-flash -b 2000000 0x0 ./build/merged/MoonLight_esp32-s3-devkitc-1-n16r8v_0-6-1_webflash.bin
      ```
+     * replace port and file to match your setup
      * optionally add erase-flash before write-flash
+     * -b 2000000: Baud rate: lower if too high for your device
      * use ./build/release/MoonLight_esp32-s3-devkitc-1-n16r8v_0-6-0.bin and address 0x10000 to flash only the MoonLight partition
 
 ### Adding an ESP32 device Definition

docs/gettingstarted/installation.md

@@ -165,3 +165,18 @@ Keep this page visible until installation complete.
 
 * 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/)
+
+## Update firmware using ESPConnect
+
+ESPConnect is a browser-based control center for ESP32- and ESP8266-class boards. It runs entirely inside a modern Chromium browser so you can inspect hardware details, manage SPIFFS files, back up flash, and deploy firmware without installing desktop software. It is based on [Jason2866](https://github.com/Jason2866)'s [WebSerial ESPTool](https://github.com/Jason2866/WebSerial_ESPTool/tree/development).
+
+[ESPConnect on GitHub](https://github.com/thelastoutpostworkshop/ESPConnect)
+
+[ESPConnect](https://thelastoutpostworkshop.github.io/microcontroller_devkit/espconnect/)
+
+* Click Connect and choose your device when the browser asks for permission.
+* Select Flash Tools, go to Flash Firmware
+* Open a firmware.bin file. 
+    * Files ending with _webflash.bin (e.g. MoonLight_esp32-d0_0-6-1_webflash.bin) also formats the partition: choose Flash offset 0x0 or recommended offsets Bootloader. webflash files can be found [here](https://github.com/MoonModules/MoonLight/tree/main/firmware/installer) and are used by the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) as well.
+    * Files ending with .bin, without _webflash (e.g. MoonLight_esp32-d0_0-6-1.bin). Choose recommended offsets App0 (Or App1?). Only use if you previously had MoonLight installed on the device, so the partitions has already been set. These files can be found in [published releases](https://github.com/MoonModules/MoonLight/releases).
+    * Nightly builds if shared on [discord](https://discord.gg/MTn9mVUG5n).

docs/moonbase/inputoutput.md

@@ -11,7 +11,7 @@ Currently the following boards are defined. Not all are supported yet 🚧
 For each board the following presets are defined:
 
 * Modded: if any change to the default preset is made.
-* Max Power: adjust the brightness to approach this max power, depending on the number of LEDs used.
+* Max Power in Watts: adjust the brightness to approach this max power, depending on the number of LEDs used. Default 10: 5V * 2A = 10W (so it runs fine on USB).
 * Jumper1: If the board contains a jumper, it can define pin behaviour. Eg. select between Infrared and Ethernet.
 * Pins: This module is the central place to assign functionality to gpio pins. Other modules and nodes use the pin assignments made here.
 
@@ -36,9 +36,10 @@ For each board the following presets are defined:
     * Current
     * Infrared
     * Button LightsOn: sets on/off in [Light Control](https://moonmodules.org/MoonLight/moonlight/lightscontrol/)
+    * Relay LightsOn: sets on/off in [Light Control](https://moonmodules.org/MoonLight/moonlight/lightscontrol/)
+    * SPI_SCK, SPI_MISO, SPI_MOSI, PHY_CS, PHY_IRQ: S3 Ethernet
   * Planned soon
     * Battery
-    * Relay brightness
     * DMX (in)
   * Planned later
     * I2S for microphone and line in
@@ -55,14 +56,22 @@ For each board the following presets are defined:
 
 ### QuinLed boards
 
-* Choose the esp32-d0 (4MB) board in the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) 
-* On first install, erase flash first as MoonLight uses a partition scheme with 3MB of flash (no ota at the moment).
+![Dig2Go](https://shop.allnetchina.cn/cdn/shop/products/Led_4.jpg?v=1680836018&width=1600){: style="width:100px"} 
+![Dig Uno](https://quinled.info/wp-content/uploads/2020/02/QuinLED-Dig-Uno-v3_front.png){: style="width:100px"} 
+![Dig Quad](https://quinled.info/wp-content/uploads/2021/11/QuinLED-Dig-Quad-AB_v3r1-2048x1154.png){: style="width:100px"}
+![Dig Octa](https://quinled.info/wp-content/uploads/2024/10/20240924_141857-2048x1444.png){: style="width:100px"}
+
+* Dig 2Go, Dig Uno, Dig Quad: Choose the esp32-d0 (4MB) board in the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) 
+* Dig Octa: Choose the esp32-d0-16mb board in the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) 
+* On first install, erase flash first (Especially when other firmware like WLED was on it) as MoonLight uses a partition scheme with 3MB of flash (no ota at the moment).
 * You might need to reset your router if you first run WLED on the same MCU and no new IP is assigned.
 
-!!! Tip
-  Dig Uno: Remove fuse to connect USB cable to flash the board.
+!!! Tip "Dig Uno USB"
+    Remove fuse to connect USB cable to flash the board.
 
 ### SE16 v1
 
+![SE-16p](../firmware/installer/images/esp32-s3-stephanelec-16p.jpg){: style="width:100px"}
+
 * Choose the esp32-s3-devkitc-1-n8r8v board in the [MoonLight Installer](https://moonmodules.org/MoonLight/gettingstarted/installer/) 
 * Set jumper1 the same as you set it on the board: on: Infrared, off: Ethernet

docs/moonlight/drivers.md

@@ -30,20 +30,21 @@ Want to add a Driver to MoonLight, see [develop](https://moonmodules.org/MoonLig
 
 | Name | Preview | Controls | Remarks
 | ---- | ----- | ---- | ---- |
-| Parallel LED Driver | <img width="100" src="https://github.com/user-attachments/assets/9cbe487e-f330-40a5-8b40-6663c83e5d90"/> | <img width="320" alt="Parallel" src="https://github.com/user-attachments/assets/0c6f1543-623a-45bf-98d7-f5ddd072a1c6" /> | Drive multiple LED types, all devices including ESP32-P4(-nano) supported<br>Max Power and Light preset: See below<br>DMA buffer: set higher when LEDs flicker<br>Virtual LED Driver will be part of the Parallel LED driver.|
-| FastLED Driver | <img width="100" src="https://avatars.githubusercontent.com/u/5899270?s=48&v=4"/> | <img width="320" alt="FastLed" src="https://github.com/user-attachments/assets/d5ea1510-9766-4687-895a-b68c82575b8f" /> | Most used LED driver. Drive most common LEDs (WS2812).<br>Max Power: See below |
-| Art-Net | <img width="100" src="https://github.com/user-attachments/assets/9c65921c-64e9-4558-b6ef-aed2a163fd88"> | <img width="320" alt="Art-Net" src="https://github.com/user-attachments/assets/1428e990-daf7-43ba-9e50-667d51b456eb" /> | Drive LEDS and DMX lights over the network. See below |
+| Parallel LED Driver | <img width="100" src="https://github.com/user-attachments/assets/9cbe487e-f330-40a5-8b40-6663c83e5d90"/> | <img width="320" alt="Parallel" src="https://github.com/user-attachments/assets/0c6f1543-623a-45bf-98d7-f5ddd072a1c6" /> | Drive multiple LED types, all devices including ESP32-P4(-nano) supported<br>Light preset: See below<br>DMA buffer: set higher when LEDs flicker<br>Virtual LED Driver will be part of the Parallel LED driver.|
+| FastLED Driver | <img width="100" src="https://avatars.githubusercontent.com/u/5899270?s=48&v=4"/> | <img width="320" alt="FastLed" src="https://github.com/user-attachments/assets/d5ea1510-9766-4687-895a-b68c82575b8f" /> | Most used LED driver. Drive most common LEDs (WS2812). |
+| Art-Net In 🆕 | <img width="100" src="https://avatars.githubusercontent.com/u/1458252?s=200&v=4"> | DDP: Yes/No<br>Port<br>Universe Min-Max<br>View: Layers | Receive Art-Net (or DDP) packages e.g. from Touch Designer. See [below](#art-net-in) |
+| Art-Net Out| <img width="100" src="https://github.com/user-attachments/assets/9c65921c-64e9-4558-b6ef-aed2a163fd88"> | <img width="320" alt="Art-Net" src="https://github.com/user-attachments/assets/1428e990-daf7-43ba-9e50-667d51b456eb" /> | Send Art-Net to Drive LEDS and DMX lights over the network. See [below](#art-net-out) |
 | Audio Sync | <img width="100" src="https://github.com/user-attachments/assets/bfedf80b-6596-41e7-a563-ba7dd58cc476"/> | No controls | Listens to audio sent over the local network by WLED-AC or WLED-MM and allows audio reactive effects (♪ & ♫) to use audio data (volume and bands (FFT)) |
 | HUB75 Driver | <img width="100" src="https://github.com/user-attachments/assets/620f7c41-8078-4024-b2a0-39a7424f9678"/> | <img width="100" src="https://github.com/user-attachments/assets/4d386045-9526-4a5a-aa31-638058b31f32"/> | Drive HUB75 panels<br>Not implemented yet |
-| IR Driver 🆕🚧 | <img width="100" src="../../media/moonlight/IRDriver.jpeg"/> |  | Receive IR commands and [Lights Control](https://moonmodules.org/MoonLight/moonlight/lightscontrol/) |
+| IR Driver | <img width="100" src="../../media/moonlight/IRDriver.jpeg"/> |  | Receive IR commands and [Lights Control](https://moonmodules.org/MoonLight/moonlight/lightscontrol/) |
 
 * The Parallel LED driver uses different hardware peripherals depending on the MCU type: ESP32-D0: I2S, ESP32-S3: LCD_CAM, ESP32-P4: Parallel IO (ParLIO).
 * Virtual LED Driver: Driving max 120! outputs (E.g. 48 panels of 256 LEDs each run at 50-100 FPS) using shift registers. Integrated within the Parallel LED Driver architecture. Not implemented yet
 <img width="100" src="https://github.com/user-attachments/assets/98fb5010-7192-44db-a5c9-09602681ee15"/><img width="100" src="https://github.com/user-attachments/assets/c81d2f56-00d1-4424-a716-8e3c30e76636"/>
 
 ### Max Power and Light Preset
 
-* **Max Power**: max amount of power in watts to send to LEDs. Default 10: 5V * 2A = 10W (so it runs fine on USB). 🆕: Moved to board presets in [Module IO](https://moonmodules.org/MoonLight/moonbase/inputoutput/).
+* **Max Power**: 🆕 moved to [IO Module](https://moonmodules.org/MoonLight/moonbase/inputoutput/) board presets.
 
 * **Light preset**: Defines the channels per light and color order
 
@@ -65,7 +66,21 @@ Want to add a Driver to MoonLight, see [develop](https://moonmodules.org/MoonLig
 !!! info "Custom setup"
     These are predefined presets. In a future release custom presets will be possible.
 
-### Art-Net ☸️
+### Art-Net In ☸️
+
+Receives Art-Net data from the network.
+
+* DDP: If unchecked, processes data in Art-Net format, if checked, process data in DDP format
+* Port: The port listening to for Art-Net
+* Universe Min-Max: Filters Universes (Art-Net only).
+* View: 
+    * Select physical layer to directly store the received channels into the physical layer
+    * Select one of the (virtual layers) to take mapping into account (using layout specification and modifiers specified , see [Modifiers](https://moonmodules.org/MoonLight/moonlight/modifiers/), part of the [Effects Module](https://moonmodules.org/MoonLight/moonlight/effects/))
+
+!!! tip "Running effects and Art-Net In"
+    Effects can run at the same time, disable or delete them if you only want to run Art-Net In.
+
+### Art-Net Out ☸️
 
 Sends Lights in Art-Net compatible packages to an Art-Net controller specified by the IP address provided.
 

src/MoonBase/Modules/ModuleIO.h

@@ -323,12 +323,14 @@ class ModuleIO : public Module {
       // pinAssigner.assignPin(32, pin_Exposed;
     } else if (boardID == board_QuinLEDDigOctaV2) {
       // Dig-Octa-32-8L
+      object["maxPower"] = 400;                         // 10A Fuse * 8 ... 400 W
       uint8_t ledPins[8] = {0, 1, 2, 3, 4, 5, 12, 13};  // LED_PINS
       for (int i = 0; i < sizeof(ledPins); i++) pinAssigner.assignPin(ledPins[i], pin_LED);
       pinAssigner.assignPin(33, pin_Relay);
       pinAssigner.assignPin(34, pin_ButtonPush);
     } else if (boardID == board_QuinLEDDig2Go) {
       // dig2go
+      object["maxPower"] = 10;  // USB powered: 2A / 10W
       pinAssigner.assignPin(0, pin_Button_LightsOn);
       pinAssigner.assignPin(5, pin_Infrared);
       pinAssigner.assignPin(16, pin_LED);

src/MoonLight/Modules/ModuleDrivers.h

@@ -44,8 +44,9 @@ class ModuleDrivers : public NodeManager {
       for (JsonObject pinObject : state.data["pins"].as<JsonArray>()) {
         uint8_t usage = pinObject["usage"];
         uint8_t index = pinObject["index"];
-        if (usage == pin_LED && index >=1 && index <= 20 && GPIO_IS_VALID_OUTPUT_GPIO(pinObject["GPIO"].as<uint8_t>())) {
-          layerP.ledPins[index-1] = pinObject["GPIO"];
+        uint8_t gpio = pinObject["GPIO"];
+        if (usage == pin_LED && index >=1 && index <= 20 && GPIO_IS_VALID_OUTPUT_GPIO(gpio)) {
+          layerP.ledPins[index-1] = gpio;
         }
       }
 

src/MoonLight/Modules/ModuleLightsControl.h

@@ -75,18 +75,20 @@ class ModuleLightsControl : public Module {
       pinButtonLightsOn = UINT8_MAX;
       for (JsonObject pinObject : state.data["pins"].as<JsonArray>()) {
         uint8_t usage = pinObject["usage"];
+        uint8_t gpio = pinObject["GPIO"];
+
         if (usage == pin_Relay_LightsOn) {
-          pinRelayLightsOn = pinObject["GPIO"];
-          if (GPIO_IS_VALID_OUTPUT_GPIO(pinRelayLightsOn)) {
+          if (GPIO_IS_VALID_OUTPUT_GPIO(gpio)) {
+            pinRelayLightsOn = gpio;
             pinMode(pinRelayLightsOn, OUTPUT);
             uint8_t newBri = _state.data["lightsOn"] ? _state.data["brightness"] : 0;
             digitalWrite(pinRelayLightsOn, newBri > 0 ? HIGH : LOW);
             EXT_LOGD(ML_TAG, "pinRelayLightsOn found %d", pinRelayLightsOn);
           } else
             EXT_LOGE(MB_TAG, "gpio %d not valid", pinRelayLightsOn);
         } else if (usage == pin_Button_LightsOn) {
-          pinButtonLightsOn = pinObject["GPIO"];
-          if (GPIO_IS_VALID_GPIO(pinButtonLightsOn)) {
+          if (GPIO_IS_VALID_GPIO(gpio)) {
+            pinButtonLightsOn = gpio;
             pinMode(pinButtonLightsOn, INPUT_PULLUP);
             EXT_LOGD(ML_TAG, "pinButtonLightsOn found %d", pinButtonLightsOn);
           } else

src/MoonLight/Nodes/Drivers/D_ArtnetIn.h

@@ -28,10 +28,14 @@ class ArtNetInDriver : public Node {
   bool ddp = false;
   uint8_t view = 0;  // physical layer
   uint16_t port = 6454;
+  uint8_t universeMin = 0;
+  uint8_t universeMax = 255;
 
   void setup() override {
     addControl(ddp, "DDP", "checkbox");
     addControl(port, "port", "number", 0, 65538);
+    addControl(universeMin, "universeMin", "number", 0, 65538);
+    addControl(universeMax, "universeMax", "number", 0, 65538);
     addControl(view, "view", "select");
     addControlValue("Physical layer");
     uint8_t i = 1;  // start with one
@@ -71,18 +75,16 @@ class ArtNetInDriver : public Node {
 
     while (int packetSize = artnetUdp.parsePacket()) {
       if (packetSize < sizeof(ArtNetHeader) || packetSize > sizeof(packetBuffer)) {
-        artnetUdp.clear();
+        artnetUdp.clear();  // drains all available packets
         continue;
       }
 
-      if (packetSize >= sizeof(ArtNetHeader)) {
-        artnetUdp.read(packetBuffer, min(packetSize, (int)sizeof(packetBuffer)));
+      artnetUdp.read(packetBuffer, min(packetSize, (int)sizeof(packetBuffer)));
 
-        if (ddp)
-          handleDDP();
-        else
-          handleArtNet();
-      }
+      if (ddp)
+        handleDDP();
+      else
+        handleArtNet();
     }
   }
 
@@ -121,20 +123,22 @@ class ArtNetInDriver : public Node {
       // Check if it's a DMX packet (opcode 0x5000)
       if (opcode == 0x5000) {
         uint16_t universe = header->universe;
-        uint16_t dataLength = (header->length >> 8) | (header->length << 8);
-
-        uint8_t* dmxData = packetBuffer + sizeof(ArtNetHeader);
-
-        int startPixel = universe * (512 / layerP.lights.header.channelsPerLight);
-        int numPixels = min((uint16_t)(dataLength / layerP.lights.header.channelsPerLight), (uint16_t)(layerP.lights.header.nrOfLights - startPixel));
-
-        for (int i = 0; i < numPixels; i++) {
-          int ledIndex = startPixel + i;
-          if (ledIndex < layerP.lights.header.nrOfLights) {
-            if (view == 0) {
-              memcpy(&layerP.lights.channels[ledIndex * layerP.lights.header.channelsPerLight], &dmxData[i * layerP.lights.header.channelsPerLight], layerP.lights.header.channelsPerLight);
-            } else {
-              layerP.layers[view - 1]->setLight(ledIndex, &dmxData[i * layerP.lights.header.channelsPerLight], 0, layerP.lights.header.channelsPerLight);
+        if (universe >= universeMin && universe <= universeMax) {
+          uint16_t dataLength = (header->length >> 8) | (header->length << 8);
+
+          uint8_t* dmxData = packetBuffer + sizeof(ArtNetHeader);
+
+          int startPixel = (universe-universeMin) * (512 / layerP.lights.header.channelsPerLight);
+          int numPixels = min((uint16_t)(dataLength / layerP.lights.header.channelsPerLight), (uint16_t)(layerP.lights.header.nrOfLights - startPixel));
+
+          for (int i = 0; i < numPixels; i++) {
+            int ledIndex = startPixel + i;
+            if (ledIndex < layerP.lights.header.nrOfLights) {
+              if (view == 0) {
+                memcpy(&layerP.lights.channels[ledIndex * layerP.lights.header.channelsPerLight], &dmxData[i * layerP.lights.header.channelsPerLight], layerP.lights.header.channelsPerLight);
+              } else {
+                layerP.layers[view - 1]->setLight(ledIndex, &dmxData[i * layerP.lights.header.channelsPerLight], 0, layerP.lights.header.channelsPerLight);
+              }
             }
           }
         }

src/MoonLight/Nodes/Drivers/D_Infrared.h

@@ -42,14 +42,17 @@ class IRDriver : public Node {
       pinInfrared = UINT8_MAX;
       for (JsonObject pinObject : state.data["pins"].as<JsonArray>()) {
         uint8_t usage = pinObject["usage"];
+        uint8_t gpio = pinObject["GPIO"];
         if (usage == pin_Infrared) {
-          pinInfrared = pinObject["GPIO"];
-          if (GPIO_IS_VALID_GPIO(pinInfrared)) {
+          if (GPIO_IS_VALID_GPIO(gpio)) {
+            pinInfrared = gpio;
             EXT_LOGD(ML_TAG, "pin_Infrared found %d", pinInfrared);
-          } else
+          } else {
             EXT_LOGE(MB_TAG, "gpio %d not valid", pinInfrared);
+          }
         }
       }
+      
       if (pinInfrared != UINT8_MAX) {
         EXT_LOGI(IR_DRIVER_TAG, "Changing to pin #%d", pinInfrared);