From ea0e310116a05223f79acc5c23bfb27598565cf8 Mon Sep 17 00:00:00 2001 From: mattbox03 <26332097+mattbox03@users.noreply.github.com> Date: Fri, 20 Nov 2026 00:04:18 +0100 Subject: [PATCH 1/3] docs/site: one charger on the Y-cable powers board and stick (tested) Owner, 2026-11-20: a single charger on the OTG Y-cable's power input runs both the ESP32-S3 board and the TCL LinkKey IK41 stick, nothing on the COM port. --- README.md | 10 +++++++--- docs/USB-DEVICES.md | 3 +++ website/pages/25-usb-devices.html | 1 + 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index abf09f4..d0f08d9 100644 --- a/README.md +++ b/README.md @@ -182,13 +182,17 @@ you. As an Amazon Associate I earn from qualifying purchases.* - **The board does not supply 5 V on its USB port.** Use a powered USB-C OTG Y-cable with a 5 V charger (at least 2.5 A for a modem or stick), or the - device's own 5 V supply with grounds connected. LTE modems draw **up to 2 A** + device's own 5 V supply with grounds connected. **Tested:** a single charger + on the Y-cable's power input runs both the board and a TCL LinkKey IK41 + stick (cable plug in the board's USB port, stick in the cable's socket), + with nothing on the COM port. LTE modems draw **up to 2 A** in bursts: a computer's USB port is not enough (modem resets, reset reason BROWNOUT). - Never connect two 5 V sources together: if you bridge the board's USB-OTG pad, never plug that port into a computer or charger. -- After the restart the USB port is a USB host: flash, logs and power go - through the COM port. One device, no hubs, about 10 Mbit/s at most. +- After the restart the USB port is a USB host: flash and logs go through the + COM port; power can come from the Y-cable alone. One device, no hubs, about + 10 Mbit/s at most. - **While a USB connection is on, the Wi-Fi keeps 16 receive buffers instead of 24** to leave internal RAM for the device. Bursts of Wi-Fi traffic, such as a speed test from a phone on the gateway's access point, can be slower or diff --git a/docs/USB-DEVICES.md b/docs/USB-DEVICES.md index 923e460..a66c9fc 100644 --- a/docs/USB-DEVICES.md +++ b/docs/USB-DEVICES.md @@ -86,6 +86,9 @@ socket for the device, and one power input for a USB charger. ``` - The charger powers the device and, through the cable, usually the board too. + **Tested** on an ESP32-S3-DevKitC-1 N16R8 with a TCL LinkKey IK41 stick: one + charger on the power input runs both the board and the stick, with nothing + connected to the COM port. - Check the cable's description: it must pass **data** to the USB-C plug and **power** to the USB-A socket. Charge-only splitters do not work. - Keep the COM port free or connected to a computer only for logs; both can be diff --git a/website/pages/25-usb-devices.html b/website/pages/25-usb-devices.html index e8bd36c..f5dea1c 100644 --- a/website/pages/25-usb-devices.html +++ b/website/pages/25-usb-devices.html @@ -47,6 +47,7 @@
-
+
{p["body"]}
' + f'A 4G/LTE USB stick with a SIM as the main or backup Internet uplink, with failover and an optional monthly data limit. Tested: TCL LinkKey IK41, Tailscale over mobile data and name lookups over the SIM, even when the stick uses the same 192.168.1.x range as the home router. The same port also takes a USB modem, a USB Ethernet adapter or phone tethering (not yet tested with real devices).
One 5 V charger, at least 2.5 A with a 4G stick, on the Y-cable's power input. Tested: it powers both the board and the TCL stick, with nothing on the COM port. Keep it independent of the NAS or PC the gateway should wake.
Its USB-C plug goes into the board's USB port (data and 5 V), the stick into its USB-A socket, the charger into its power input. It must pass data: charge-only splitters do not work. The board does not supply 5 V on its USB port by itself.
An ESP32-S3 with 8 MB octal PSRAM and at least 8 MB of quad flash: N16R8 (tested on an ESP32-S3-DevKitC-1 N16R8) or N8R8. It has two USB-C ports: COM (through a USB-to-serial chip) and USB (the chip's own USB).
Use the COM port to flash the firmware (browser installer, Easy Install) and to read the logs. Day to day it is not needed: updates arrive over the air from System → Updates. While a USB device is active, flash and read logs through COM, not through USB.
The built-in 2.4 GHz Wi-Fi connects to your router and, if you want, also runs the gateway's own access point for IoT devices. Both share one radio and one channel.
An optional microSD card (SDMMC 1-bit on GPIO38/39/40) keeps a flight recorder of the logs. The firmware runs without it.
A W5500 SPI module, or an ESP32-S3 board with built-in Ethernet and PoE. The driver is in the standard image, off until configured, Wi-Fi-first or Ethernet-first. Experimental: not yet validated on real hardware.
A 4G/LTE modem wired to UART pins (for example SIM7600 or A7670 modules) with its own 5 V supply for 2 A peaks, as the main or backup uplink. Not yet tested with a real modem.
The firmware runs on an ESP32-S3 with 8 MB octal PSRAM and at least 8 MB of quad flash: N8R8 and N16R8 modules. One image serves both; a 16 MB board uses the first 8 MB.
Tested with: {model} ' + f'(affiliate link).
') href, text = p['link'] items.append(f'{p["body"]}
' + f'{p["body"]}
{tested}' f'A 4G/LTE USB stick with a SIM as the main or backup Internet uplink, with failover and an optional monthly data limit. Tested: TCL LinkKey IK41, Tailscale over mobile data and name lookups over the SIM, even when the stick uses the same 192.168.1.x range as the home router. The same port also takes a USB modem, a USB Ethernet adapter or phone tethering (not yet tested with real devices).
One 5 V charger, at least 2.5 A with a 4G stick, on the Y-cable's power input. Tested: it powers both the board and the TCL stick, with nothing on the COM port. Keep it independent of the NAS or PC the gateway should wake.
Its USB-C plug goes into the board's USB port (data and 5 V), the stick into its USB-A socket, the charger into its power input. It must pass data: charge-only splitters do not work. The board does not supply 5 V on its USB port by itself.
An ESP32-S3 with 8 MB octal PSRAM and at least 8 MB of quad flash: N16R8 (tested on an ESP32-S3-DevKitC-1 N16R8) or N8R8. It has two USB-C ports: COM (through a USB-to-serial chip) and USB (the chip's own USB).
Use the COM port to flash the firmware (browser installer, Easy Install) and to read the logs. Day to day it is not needed: updates arrive over the air from System → Updates. While a USB device is active, flash and read logs through COM, not through USB.
Any ESP32-S3 board with 8 MB octal PSRAM and at least 8 MB of quad flash (N16R8 or N8R8 modules). It has two USB-C ports: COM, through a USB-to-serial chip, and USB, the chip's own USB. Either port powers the board and can flash it; while a USB device is active, flash and read logs through COM.
Tested with: ESP32-S3-DevKitC-1 N16R8 (affiliate link).
The board always needs a 5 V supply. Without a USB device, plug the charger straight into either port, COM or USB. With a USB device, put the charger on the Y-cable's power input instead: one charger of at least 2.5 A powers both the board and the device, with nothing on the COM port. Keep it independent of the NAS or PC the gateway should wake.
The built-in 2.4 GHz Wi-Fi connects to your router and, if you want, also runs the gateway's own access point for IoT devices. Both share one radio and one channel.
Use the COM port to flash the firmware (browser installer, Easy Install) and to read the logs. Day to day it is not needed: updates arrive over the air from System → Updates. While a USB device is active, flash and read logs through COM, not through USB.
An optional microSD card (SDMMC 1-bit on GPIO38/39/40) keeps a flight recorder of the logs. The firmware runs without it.
A W5500 SPI module, or an ESP32-S3 board with built-in Ethernet and PoE. The driver is in the standard image, off until configured, Wi-Fi-first or Ethernet-first. Experimental: not yet validated on real hardware.
A 4G/LTE modem wired to UART pins (for example SIM7600 or A7670 modules) with its own 5 V supply for 2 A peaks, as the main or backup uplink. Not yet tested with a real modem.
A W5500 SPI module, or an ESP32-S3 board with built-in Ethernet and PoE. The driver is in the standard image, off until configured, Wi-Fi-first or Ethernet-first. Ethernet can also use a USB adapter on the USB port. Experimental: not yet validated on real hardware.
A 4G/LTE modem module wired to UART pins, with its own 5 V supply for 2 A peaks, as the main or backup uplink. A SIM can also use a USB stick or modem on the USB port. Not yet tested with a real modem.
Needed only for a USB device (4G stick, USB modem, USB Ethernet or a phone). Its USB-C plug goes into the board's USB port (data and 5 V), the device into its USB-A socket, the charger into its power input. It must pass data: charge-only splitters do not work. The board does not supply 5 V on its USB port by itself.
A 4G/LTE USB stick or USB modem with a SIM on the USB port, as the main or backup Internet uplink, with failover and an optional monthly data limit: Tailscale runs over mobile data and name lookups go over the SIM. A modem can also be wired to the pins instead (UART).
Tested with: TCL LinkKey IK41 (affiliate link).
A USB Ethernet adapter (Realtek RTL8152/8153/8156, CDC-ECM/NCM) or Android USB tethering on the USB port, as the main or backup uplink. Ethernet can also use a W5500 module on the pins (SPI). Not yet tested with real devices.