Skip to content

Add compile-time WiFi hard-off mode (WLED_FORCE_WIFI_OFF) #5394

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Stargazer2026 wants to merge 10 commits into
base: main
Choose a base branch
from
+95 −9
Open

Add compile-time WiFi hard-off mode (WLED_FORCE_WIFI_OFF) #5394

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
f8eb607
Add compile-time WiFi hard-off mode
Stargazer2026 Feb 23, 2026
e3af1ad
Fix position of WLED_FORE_OFF switch.
Stargazer2026 Feb 23, 2026
83f45cd
Merge pull request #1 from Stargazer2026/codex/check-wled-firmware-wl…
Stargazer2026 Feb 23, 2026
f2e7d79
WIFI_OFF: set last ReconnectAttempt in initConnection.
Stargazer2026 Feb 23, 2026
8913e53
Support AP-recovery mode for FORCE_WIFI_OFF.
Stargazer2026 Feb 24, 2026
1ad958f
Harden WLED_FORCE_WIFI_OFF feature
Stargazer2026 Feb 24, 2026
700849b
Fix corner-cases that activate WIFI anyway.
Stargazer2026 Feb 24, 2026
4382e41
Log correctly in WLED_FORCE_WIFI_OFF mode.
Stargazer2026 Feb 25, 2026
d14643b
Refactor WLED_FORCE_WIFI_OFF implementation.
Stargazer2026 Feb 26, 2026
ef88e49
Restart WIFI scan on failed scan.
Stargazer2026 Feb 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions wled00/my_config_sample.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,6 @@
#define CLIENT_PASS "Your_Password"
*/

//#define WLED_FORCE_WIFI_OFF // Hard disable WiFi radio (WIFI_OFF): no STA and no AP.
Copy link
Copy Markdown
Member

@softhack007 softhack007 Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please remove the flag here, too (see my comment on wled.h)

//#define MAX_LEDS 1500 // Maximum total LEDs. More than 1500 might create a low memory situation on ESP8266.
//#define MDNS_NAME "wled" // mDNS hostname, ie: *.local
16 changes: 16 additions & 0 deletions wled00/wled.cpp
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -511,8 +511,13 @@ void WLED::setup()
WiFi.persistent(false); // on ES8266 using NVM for wifi config has no benefit of faster connection
#endif
WiFi.onEvent(WiFiEvent);
#ifdef WLED_FORCE_WIFI_OFF
DEBUG_PRINTLN(F("WLED_FORCE_WIFI_OFF: forcing WiFi OFF."));
WiFi.mode(WIFI_OFF);
#else
WiFi.mode(WIFI_STA); // enable scanning
findWiFi(true); // start scanning for available WiFi-s
#endif

// all GPIOs are allocated at this point
serialCanRX = !PinManager::isPinAllocated(hardwareRX); // Serial RX pin (GPIO 3 on ESP32 and ESP8266)
Expand Down Expand Up @@ -633,6 +638,10 @@ void WLED::beginStrip()

void WLED::initAP(bool resetAP)
{
#ifdef WLED_FORCE_WIFI_OFF
return;
#endif

if (apBehavior == AP_BEHAVIOR_BUTTON_ONLY && !resetAP)
return;

Expand Down Expand Up @@ -673,6 +682,13 @@ void WLED::initAP(bool resetAP)
void WLED::initConnection()
{
DEBUG_PRINTF_P(PSTR("initConnection() called @ %lus.\n"), millis()/1000);
#ifdef WLED_FORCE_WIFI_OFF
DEBUG_PRINTLN(F("WLED_FORCE_WIFI_OFF active. Skipping WiFi/AP init."));
WiFi.disconnect(true);
WiFi.mode(WIFI_OFF);
return;
#endif

#ifdef WLED_ENABLE_WEBSOCKETS
ws.onEvent(wsEvent);
#endif
Expand Down
1 change: 1 addition & 0 deletions wled00/wled.h
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@
#endif

// You can choose some of these features to disable:
//#define WLED_FORCE_WIFI_OFF // saves 5kb, hard-disable WiFi radio entirely (WIFI_OFF). AP/STA will not start.
Copy link
Copy Markdown
Member

@softhack007 softhack007 Feb 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Its better to not add the flag here. It will be too tempting for "cool lets try this" users to brick their boards.

For documentation, i'd prefer a PR in WLED-Docs and describe the new flag as an expert option.

//#define WLED_DISABLE_ALEXA // saves 11kb
//#define WLED_DISABLE_HUESYNC // saves 4kb
//#define WLED_DISABLE_INFRARED // saves 12kb, there is no pin left for this on ESP8266-01
Expand Down