meshcore-dev · ndrpri · Mar 30, 2026 · Mar 30, 2026 · Mar 30, 2026 · Mar 30, 2026
diff --git a/.vscode/extensions.json b/.vscode/extensions.json
@@ -1,7 +1,6 @@
 {
-    // See http://go.microsoft.com/fwlink/?LinkId=827846
-    // for the documentation about the extensions.json format
     "recommendations": [
+        "pioarduino.pioarduino-ide",
         "platformio.platformio-ide"
     ],
     "unwantedRecommendations": [

diff --git a/boards/t_eth_elite.json b/boards/t_eth_elite.json
@@ -0,0 +1,51 @@
+{
+    "build": {
+      "arduino":{
+        "ldscript": "esp32s3_out.ld",
+        "partitions": "default.csv",
+        "memory_type": "qio_qspi"
+      },
+      "core": "esp32",
+      "extra_flags": [
+        "-DARDUINO_USB_MODE=1",
+        "-DARDUINO_USB_CDC_ON_BOOT=1",
+        "-DARDUINO_RUNNING_CORE=1",
+        "-DARDUINO_EVENT_RUNNING_CORE=1"
+      ],
+      "f_cpu": "240000000L",
+      "f_flash": "80000000L",
+      "flash_mode": "qio",
+      "hwids": [
+        [
+          "0x303A",
+          "0x1001"
+        ]
+      ],
+      "mcu": "esp32s3",
+      "variant": "esp32s3"
+    },
+    "connectivity": [
+      "wifi"
+    ],
+    "debug": {
+      "default_tool": "esp-builtin",
+      "onboard_tools": [
+        "esp-builtin"
+      ],
+      "openocd_target": "esp32s3.cfg"
+    },
+    "frameworks": [
+      "arduino",
+      "espidf"
+    ],
+    "name": "LilyGo T-ETH-ELite (16MB Flash 8MB PSRAM)",
+    "upload": {
+      "flash_size": "16MB",
+      "maximum_ram_size": 8388608,
+      "maximum_size": 16777216,
+      "require_upload_port": true,
+      "speed": 460800
+    },
+    "url": "https://lilygo.cc/products/t-eth-elite-1",
+    "vendor": "LilyGo"
+  }
diff --git a/docs/cli_commands.md b/docs/cli_commands.md
@@ -19,6 +19,7 @@ This document provides an overview of CLI commands that can be sent to MeshCore
   - [GPS](#gps-when-gps-support-is-compiled-in)
   - [Sensors](#sensors-when-sensor-support-is-compiled-in)
   - [Bridge](#bridge-when-bridge-support-is-compiled-in)
+  - [Ethernet](#ethernet-when-use_ethernet-is-compiled-in)
 
 ---
 
@@ -816,6 +817,19 @@ region save
 
 ---
 
+#### View the bridge type
+**Usage:**
+- `get bridge.type`
+
+**Returns:**
+- `none`: No bridge available/compiled
+- `rs232`: RS-232 serial bridge
+- `espnow`: ESP-NOW wireless bridge
+
+**Note:** This is read-only; bridge type is determined at compile time
+
+---
+
 #### View the bridge source
 **Usage:**
 - `get bridge.source`
@@ -881,3 +895,69 @@ region save
 **Default:** Varies by board
 
 ---
+
+### Ethernet (When USE_ETHERNET is compiled in)
+
+#### View or change this node's Ethernet IP address
+**Usage:**
+- `get ip`
+- `set ip <address>`
+
+**Parameters:**
+- `address`: IPv4 address (e.g., `192.168.254.21`)
+
+**Set by build flag:** `ETH_STATIC_IP`
+
+**Default:** `0.0.0.0` (uses DHCP if not configured)
+
+**Note:** Requires reboot to apply. If no valid IP is set, device will use DHCP at boot.
+
+---
+
+#### View or change this node's Ethernet gateway
+**Usage:**
+- `get gw`
+- `set gw <address>`
+
+**Parameters:**
+- `address`: IPv4 gateway address (e.g., `192.168.254.254`)
+
+**Set by build flag:** `ETH_GATEWAY`
+
+**Default:** `0.0.0.0`
+
+**Note:** Requires reboot to apply
+
+---
+
+#### View or change this node's Ethernet subnet mask
+**Usage:**
+- `get subnet`
+- `set subnet <address>`
+
+**Parameters:**
+- `address`: Subnet mask in dotted decimal notation (e.g., `255.255.255.0`)
+
+**Set by build flag:** `ETH_SUBNET`
+
+**Default:** `0.0.0.0`
+
+**Note:** Requires reboot to apply
+
+---
+
+#### View or change this node's Ethernet DNS server
+**Usage:**
+- `get dns`
+- `set dns <address>`
+
+**Parameters:**
+- `address`: IPv4 DNS address (e.g., `8.8.8.8`)
+
+**Set by build flag:** `ETH_DNS`
+
+**Default:** `0.0.0.0`
+
+**Note:** Requires reboot to apply. Configures DNS1 (primary DNS server).
+
+---
diff --git a/examples/companion_radio/main.cpp b/examples/companion_radio/main.cpp
@@ -2,6 +2,11 @@
 #include <Mesh.h>
 #include "MyMesh.h"
 
+#if defined(ESP32) && defined(TCP_CONSOLE_PORT) && defined(ADMIN_PASSWORD)
+  #include <helpers/esp32/TCPConsole.h>
+  TCPConsole tcp_console(nullptr);  // prefs set in setup()
+#endif
+
 // Believe it or not, this std C function is busted on some platforms!
 static uint32_t _atoi(const char* sp) {
   uint32_t n = 0;
@@ -35,7 +40,7 @@ static uint32_t _atoi(const char* sp) {
 #endif
 
 #ifdef ESP32
-  #ifdef WIFI_SSID
+  #if defined(WIFI_SSID) || defined(USE_ETHERNET)
     #include <helpers/esp32/SerialWifiInterface.h>
     SerialWifiInterface serial_interface;
     #ifndef TCP_PORT
@@ -109,6 +114,10 @@ void setup() {
   Serial.begin(115200);
 
   board.begin();
+
+  #if defined(ESP32) && defined(TCP_CONSOLE_PORT) && defined(ADMIN_PASSWORD)
+    tcp_console.begin();
+  #endif
 
 #ifdef DISPLAY_CLASS
   DisplayDriver* disp = NULL;
@@ -122,7 +131,7 @@ void setup() {
     disp->endFrame();
   }
 #endif
-
+  
   if (!radio_init()) { halt(); }
 
   fast_rng.begin(radio_get_rng_seed());
@@ -143,6 +152,9 @@ void setup() {
   #endif
   store.begin();
   the_mesh.begin(
+
+    tcp_console.setPrefs(the_mesh.getNodePrefs());
+
     #ifdef DISPLAY_CLASS
         disp != NULL
     #else
@@ -194,9 +206,12 @@ void setup() {
   );
 
 #ifdef WIFI_SSID
-  board.setInhibitSleep(true);   // prevent sleep when WiFi is active
+  board.setInhibitSleep(true);
   WiFi.begin(WIFI_SSID, WIFI_PWD);
   serial_interface.begin(TCP_PORT);
+#elif defined(USE_ETHERNET)
+  serial_interface.begin(TCP_PORT);
+  Serial.printf("TCP server started on port %d\n", TCP_PORT);
 #elif defined(BLE_PIN_CODE)
   serial_interface.begin(BLE_NAME_PREFIX, the_mesh.getNodePrefs()->node_name, the_mesh.getBLEPin());
 #elif defined(SERIAL_RX)
@@ -220,9 +235,14 @@ void setup() {
 
 void loop() {
   the_mesh.loop();
+  #if defined(ESP32) && defined(TCP_CONSOLE_PORT) && defined(ADMIN_PASSWORD)
+    tcp_console.loop(the_mesh);
+  #endif
+
   sensors.loop();
-#ifdef DISPLAY_CLASS
-  ui_task.loop();
-#endif
+  #ifdef DISPLAY_CLASS
+    ui_task.loop();
+  #endif
+
   rtc_clock.tick();
 }
diff --git a/examples/companion_radio/ui-new/UITask.cpp b/examples/companion_radio/ui-new/UITask.cpp
@@ -752,8 +752,8 @@ void UITask::loop() {
   }
 #endif
 #if defined(PIN_USER_BTN_ANA)
-  if (abs(millis() - _analogue_pin_read_millis) > 10) {
-    ev = analog_btn.check();
+  if ((long)(millis() - _analogue_pin_read_millis) > 10) {
+    int ev = analog_btn.check();
     if (ev == BUTTON_EVENT_CLICK) {
       c = checkDisplayOn(KEY_NEXT);
     } else if (ev == BUTTON_EVENT_LONG_PRESS) {

diff --git a/examples/simple_repeater/main.cpp b/examples/simple_repeater/main.cpp
@@ -3,6 +3,11 @@
 
 #include "MyMesh.h"
 
+#if defined(TCP_CONSOLE_PORT)
+  #include <helpers/esp32/TCPConsole.h>
+  TCPConsole tcp_console(nullptr);  // prefs set in setup()
+#endif
+
 #ifdef DISPLAY_CLASS
   #include "UITask.h"
   static UITask ui_task(display);
@@ -29,6 +34,10 @@ void setup() {
 
   board.begin();
 
+  #if defined(TCP_CONSOLE_PORT)
+    tcp_console.begin();
+  #endif
+
 #if defined(MESH_DEBUG) && defined(NRF52_PLATFORM)
   // give some extra time for serial to settle so
   // boot debug messages can be seen on terminal
@@ -90,6 +99,19 @@ void setup() {
 
   the_mesh.begin(fs);
 
+the_mesh.begin(fs);
+
+#ifdef USE_ETHERNET
+    NodePrefs* prefs = the_mesh.getNodePrefs();
+    if (prefs->eth_ip != 0) {
+      board.reconfigureEthernet(prefs->eth_ip, prefs->eth_gateway, prefs->eth_subnet);
+   }
+#endif
+
+#if defined(TCP_CONSOLE_PORT)
+   tcp_console.setPrefs(the_mesh.getNodePrefs());
+#endif
+
 #ifdef DISPLAY_CLASS
   ui_task.begin(the_mesh.getNodePrefs(), FIRMWARE_BUILD_DATE, FIRMWARE_VERSION);
 #endif
@@ -128,6 +150,10 @@ void loop() {
   }
 
   the_mesh.loop();
+  #if defined(ESP32) && defined(TCP_CONSOLE_PORT)
+    tcp_console.loop(the_mesh);
+  #endif
+
   sensors.loop();
 #ifdef DISPLAY_CLASS
   ui_task.loop();

diff --git a/examples/simple_room_server/main.cpp b/examples/simple_room_server/main.cpp
@@ -3,6 +3,11 @@
 
 #include "MyMesh.h"
 
+#if defined(TCP_CONSOLE_PORT)
+  #include <helpers/esp32/TCPConsole.h>
+  TCPConsole tcp_console(nullptr);  // prefs set in setup()
+#endif
+
 #ifdef DISPLAY_CLASS
   #include "UITask.h"
   static UITask ui_task(display);
@@ -24,6 +29,10 @@ void setup() {
 
   board.begin();
 
+  #if defined(ESP32) && defined(TCP_CONSOLE_PORT)
+    tcp_console.begin();
+  #endif
+
 #ifdef DISPLAY_CLASS
   if (display.begin()) {
     display.startFrame();
@@ -72,6 +81,17 @@ void setup() {
 
   the_mesh.begin(fs);
 
+#ifdef USE_ETHERNET
+    NodePrefs* prefs = the_mesh.getNodePrefs();
+    if (prefs->eth_ip != 0) {
+      board.reconfigureEthernet(prefs->eth_ip, prefs->eth_gateway, prefs->eth_subnet);
+    }
+#endif
+
+ #if defined(TCP_CONSOLE_PORT)
+  tcp_console.setPrefs(the_mesh.getNodePrefs());
+#endif
+
 #ifdef DISPLAY_CLASS
   ui_task.begin(the_mesh.getNodePrefs(), FIRMWARE_BUILD_DATE, FIRMWARE_VERSION);
 #endif
@@ -108,9 +128,13 @@ void loop() {
   }
 
   the_mesh.loop();
+  #if defined(ESP32) && defined(TCP_CONSOLE_PORT)
+    tcp_console.loop(the_mesh);
+  #endif
+
   sensors.loop();
-#ifdef DISPLAY_CLASS
-  ui_task.loop();
-#endif
+    #ifdef DISPLAY_CLASS
+      ui_task.loop();
+    #endif
   rtc_clock.tick();
 }
diff --git a/lib/ETHClass2/library.properties b/lib/ETHClass2/library.properties
@@ -0,0 +1,9 @@
+name=ETHClass2
+version=1.0.0
+author=Lewis He
+maintainer=Lewis He <lewishe@outlook.com>
+sentence=Enables network connection (local and Internet) using the ESP32/ESP32S3 Ethernet.
+paragraph=With this library you can instantiate Servers, Clients and send/receive UDP packets through Ethernet. The IP address can be assigned statically or through a DHCP. The library can also manage DNS.
+category=Communication
+url=
+architectures=esp32