softAPConfig fails with "DHCPS Set Netmask Failed! 0x5001"

[TD-er]

Board

ESP32-S2

Device Description

Hardware Configuration

Version

latest master (checkout manually)

IDE Name

PlatformIO

Operating System

Windows 11

Flash frequency

40MHz

PSRAM enabled

yes

Upload speed

115200

Description

I call WiFi.softAPConfig with 192.168.4.1 for both IP and gateway and 255.255.255.0 as subnet mask.

This is during the setup process, so there is no STA interface active, only the AP interface.

The error is ESP_ERR_ESP_NETIF_INVALID_PARAMS

As far as I can see it is generated here (???)
https://github.com/espressif/esp-idf/blob/5524b692ee5d04d7a1000eb0c41640746fc67f3c/components/esp_netif/lwip/esp_netif_lwip.c#L2260-L2279

The comment suggests you need to set the IP of the interface first, but it is set in the same function. (set_esp_interface_ip)

I found this PR which might be related?
https://github.com/espressif/arduino-esp32/pull/6731/files

Apparently this has been an issue which went unnoticed for quite a while but a user reported it was not working anymore when I switched to ESP32 SDK 4.4.4.20230310

Using ESP32 SDK 4.4.4.20230208 was apparently still working.

Might be broken in this commit in esp-idf???
espressif/esp-idf@a71fa82

Sketch

-

Debug Message

[ 11104][D][WiFiGeneric.cpp:1043] _eventCallback(): Arduino Event: 0 - WIFI_READY
[ 11108][V][WiFiGeneric.cpp:395] _arduino_event_cb(): AP Started
[ 11109][D][WiFiGeneric.cpp:1043] _eventCallback(): Arduino Event: 10 - AP_START
[ 11216][V][WiFiGeneric.cpp:97] set_esp_interface_ip(): Configuring SoftAP static IP: 192.168.4.1, MASK: 255.255.255.0, GW: 192.168.4.1
[ 11218][V][WiFiGeneric.cpp:146] set_esp_interface_ip(): SoftAP: 192.168.4.1 | Gateway: 192.168.4.1 | DHCP Start: 0.0.0.0 | Netmask: 255.255.255.0
[ 11230][V][WiFiGeneric.cpp:193] set_esp_interface_ip(): DHCP Server Range: 192.168.4.2 to 192.168.4.12
[ 11239][E][WiFiGeneric.cpp:201] set_esp_interface_ip(): DHCPS Set Netmask Failed! 0x5001

Other Steps to Reproduce

No response

I have checked existing issues, online documentation and the Troubleshooting Guide

• I confirm I have checked existing issues, online documentation and Troubleshooting guide.

[lbernstone]

Provide code pls

[TD-er]

I got a very minimal piece of code here:

#include <Arduino.h>

#include <IPAddress.h>
#include <WiFiGeneric.h>
#include <WiFi.h>

void setup() {
  Serial.begin(115200);
  Serial.setDebugOutput(true);


  IPAddress apIP(192,168,4,1);
  IPAddress gwIP(192,168,4,1);
  IPAddress subnet(255,255,255,0);

  WiFi.softAPConfig(apIP, gwIP, subnet);
}

void loop() {
  delay(1000);
}

With output:

SHA-256 comparison failed:
Calculated: d8cd69debb03de2830a5005cce52ebafc161b0c89fecb61aaf893684e90318e6
Expected: ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff
Attempting to boot anyway...
entry 0x4004b108
=> 0x4004b108: ?? ??:0
[   857][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RX (2) successfully set to 0x40083c70
=> 0x40083c70: _uartDetachBus_RX at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:139
[   869][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_TX (3) successfully set to 0x40083c8c
=> 0x40083c8c: _uartDetachBus_TX at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:147
[   882][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_CTS (4) successfully set to 0x40083ca8
=> 0x40083ca8: _uartDetachBus_CTS at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:156
[   896][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RTS (5) successfully set to 0x40083cc4
=> 0x40083cc4: _uartDetachBus_RTS at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:164
[   909][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RX (2) successfully set to 0x40083c70
=> 0x40083c70: _uartDetachBus_RX at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:139
[   923][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_TX (3) successfully set to 0x40083c8c
=> 0x40083c8c: _uartDetachBus_TX at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:147
[   936][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_CTS (4) successfully set to 0x40083ca8
=> 0x40083ca8: _uartDetachBus_CTS at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:156
[   950][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RTS (5) successfully set to 0x40083cc4
=> 0x40083cc4: _uartDetachBus_RTS at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-uart.c:164
[   963][D][esp32-hal-tinyusb.c:711] tinyusb_enable_interface2(): Interface CDC enabled
[   974][D][esp32-hal-tinyusb.c:589] tinyusb_load_enabled_interfaces(): Load Done: if_num: 2, descr_len: 75, if_mask: 0x10
[   986][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type USB_DM (42) successfully set to 0x40081e30
=> 0x40081e30: usb_otg_deinit at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-tinyusb.c:62
[   999][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type USB_DP (43) successfully set to 0x40081e30
=> 0x40081e30: usb_otg_deinit at C:/Users/gijsn/.platformio/packages/framework-arduinoespressif32/cores/esp32/esp32-hal-tinyusb.c:62
[  1013][V][esp32-hal-periman.c:154] perimanSetPinBus(): Pin 19 successfully set to type USB_DM (42) with bus 0x3ffcd060
[  1026][V][esp32-hal-periman.c:154] perimanSetPinBus(): Pin 20 successfully set to type USB_DP (43) with bus 0x3ffcd060
[  1249][I][esp32-hal-psram.c:92] psramInit(): PSRAM enabled
[  1261][V][esp32-hal-periman.c:154] perimanSetPinBus(): Pin 44 successfully set to type UART_RX (2) with bus 0x3ffbf540
[  1272][V][esp32-hal-periman.c:154] perimanSetPinBus(): Pin 43 successfully set to type UART_TX (3) with bus 0x3ffbf540
=========== Before Setup Start ===========
Chip Info:
------------------------------------------
  Model             : ESP32-S2
  Package           : 0
  Revision          : 100
  Cores             : 1
  Frequency         : 240 MHz
  Embedded Flash    : No
  Embedded PSRAM    : No
  2.4GHz WiFi       : Yes
  Classic BT        : No
  BT Low Energy     : No
  IEEE 802.15.4     : No
------------------------------------------
INTERNAL Memory Info:
------------------------------------------
  Total Size        :   230488 B ( 225.1 KB)
  Free Bytes        :   200376 B ( 195.7 KB)
  Allocated Bytes   :    27076 B (  26.4 KB)
  Minimum Free Bytes:   195768 B ( 191.2 KB)
  Largest Free Block:   180212 B ( 176.0 KB)
------------------------------------------
SPIRAM Memory Info:
------------------------------------------
  Total Size        :  2097152 B (2048.0 KB)
  Free Bytes        :  2095104 B (2046.0 KB)
  Allocated Bytes   :        0 B (   0.0 KB)
  Minimum Free Bytes:  2095104 B (2046.0 KB)
  Largest Free Block:  2064372 B (2016.0 KB)
  Bus Mode          : QSPI
------------------------------------------
Flash Info:
------------------------------------------
  Chip Size         :  8388608 B (8 MB)
  Block Size        :    65536 B (  64.0 KB)
  Sector Size       :     4096 B (   4.0 KB)
  Page Size         :      256 B (   0.2 KB)
  Bus Speed         : 80 MHz
  Bus Mode          : DIO
------------------------------------------
Partitions Info:
------------------------------------------
                nvs : addr: 0x00009000, size:    20.0 KB, type: DATA, subtype: NVS
            otadata : addr: 0x0000E000, size:     8.0 KB, type: DATA, subtype: OTA
               app0 : addr: 0x00010000, size:  1856.0 KB, type:  APP, subtype: OTA_0
               app1 : addr: 0x001E0000, size:  1856.0 KB, type:  APP, subtype: OTA_1
             eeprom : addr: 0x003B0000, size:     4.0 KB, type: DATA, subtype: 0x99
             spiffs : addr: 0x003B1000, size:   316.0 KB, type: DATA, subtype: SPIFFS
------------------------------------------
Software Info:
------------------------------------------
  Compile Date/Time : Jan  5 2024 23:58:10
  ESP-IDF Version   : 5.1.2.231216
  Arduino Version   : 3.0.0
------------------------------------------
Board Info:
------------------------------------------
  Arduino Board     : Espressif Generic ESP32-S2 USB CDC 4M Flash ESPEasy 1810k Code/OTA 316k FS
  Arduino Variant   : esp32s2
  Core Debug Level  : 5
  Arduino Runs Core : 0
  Arduino Events on : 0
  CDC On Boot       : 1
============ Before Setup End ============
[  3609][D][WiFiGeneric.cpp:1043] _eventCallback(): Arduino Event: 0 - WIFI_READY
[  3647][V][WiFiGeneric.cpp:395] _arduino_event_cb(): AP Started
[  3648][D][WiFiGeneric.cpp:1043] _eventCallback(): Arduino Event: 10 - AP_START
[  3651][V][WiFiGeneric.cpp:97] set_esp_interface_ip(): Configuring SoftAP static IP: 192.168.4.1, MASK: 255.255.255.0, GW: 192.168.4.1
[  3661][V][WiFiGeneric.cpp:146] set_esp_interface_ip(): SoftAP: 192.168.4.1 | Gateway: 192.168.4.1 | DHCP Start: 0.0.0.0 | Netmask: 255.255.255.0
[  3674][V][WiFiGeneric.cpp:193] set_esp_interface_ip(): DHCP Server Range: 192.168.4.2 to 192.168.4.12
[  3683][E][WiFiGeneric.cpp:201] set_esp_interface_ip(): DHCPS Set Netmask Failed! 0x5001
=========== After Setup Start ============
INTERNAL Memory Info:
------------------------------------------
  Total Size        :   230488 B ( 225.1 KB)
  Free Bytes        :   170820 B ( 166.8 KB)
  Allocated Bytes   :    54656 B (  53.4 KB)
  Minimum Free Bytes:   170520 B ( 166.5 KB)
  Largest Free Block:   155636 B ( 152.0 KB)
------------------------------------------
SPIRAM Memory Info:
------------------------------------------
  Total Size        :  2097152 B (2048.0 KB)
  Free Bytes        :  2079840 B (2031.1 KB)
  Allocated Bytes   :    14928 B (  14.6 KB)
  Minimum Free Bytes:  2079604 B (2030.9 KB)
  Largest Free Block:  2064372 B (2016.0 KB)
------------------------------------------
GPIO Info:
------------------------------------------
  GPIO : BUS_TYPE[bus/unit][chan]
  --------------------------------------
    19 : USB_DM
    20 : USB_DP
    43 : UART_TX[0]
    44 : UART_RX[0]
============ After Setup End =============

Including a complete PlatformIO build env:
https://github.com/TD-er/MCVE_ESPxx/tree/bug/ESP32_softAP_subnetmask

[TD-er]

OK, added PIO envs for C2/C3/C6/S2/S3 to the MCVE repo.
Just tested with C2/C3/C6 and all of these show the same result.

[SuGlider]

@TD-er - What happens when the AP IP address is different from the GW IP address, but still both are in the same subnetwork?

  IPAddress gwIP(192,168,4,1);
  IPAddress apIP(192,168,4,2);   // DHCP range will be 192.168.4.3 to 192.168.4.12
  IPAddress subnet(255,255,255,0);

[SuGlider]

I've just run the example code with the C3. It works fine:
Extra Note: I used the Arduino Core 2.0.14 + Arduino IDE (not PlatformIO)

ESP-ROM:esp32c3-api1-20210207
Build:Feb  7 2021
rst:0x1 (POWERON),boot:0xc (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fcd5810,len:0x438
load:0x403cc710,len:0x90c
load:0x403ce710,len:0x25f4
entry 0x403cc710
[   156][D][WiFiGeneric.cpp:1039] _eventCallback(): Arduino Event: 0 - WIFI_READY
[   189][V][WiFiGeneric.cpp:392] _arduino_event_cb(): AP Started
[   190][D][WiFiGeneric.cpp:1039] _eventCallback(): Arduino Event: 10 - AP_START
[   192][V][WiFiGeneric.cpp:97] set_esp_interface_ip(): Configuring SoftAP static IP: 192.168.4.1, MASK: 255.255.255.0, GW: 192.168.4.1
[   203][V][WiFiGeneric.cpp:143] set_esp_interface_ip(): SoftAP: 192.168.4.1 | Gateway: 192.168.4.1 | DHCP Start: 0.0.0.0 | Netmask: 255.255.255.0
[   216][V][WiFiGeneric.cpp:190] set_esp_interface_ip(): DHCP Server Range: 192.168.4.2 to 192.168.4.12

[SuGlider]

I change it to use Arduino Core 3.0.0-Alpha3 with the Arduino IDE. No errors, using the same AP_IP and GW_IP (192.168.4.1)

ESP-ROM:esp32c3-api1-20210207
Build:Feb  7 2021
rst:0x1 (POWERON),boot:0xc (SPI_FAST_FLASH_BOOT)
SPIWP:0xee
mode:DIO, clock div:1
load:0x3fcd5820,len:0x458
load:0x403cc710,len:0x814
load:0x403ce710,len:0x2880
entry 0x403cc710
[   165][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RX (2) successfully set to 0x42005b9e
[   177][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_TX (3) successfully set to 0x42005b62
[   188][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_CTS (4) successfully set to 0x42005b26
[   199][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RTS (5) successfully set to 0x42005aea
[   211][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RX (2) successfully set to 0x42005b9e
[   222][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_TX (3) successfully set to 0x42005b62
[   233][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_CTS (4) successfully set to 0x42005b26
[   245][V][esp32-hal-periman.c:229] perimanSetBusDeinit(): Deinit function for type UART_RTS (5) successfully set to 0x42005aea
[   263][V][esp32-hal-periman.c:154] perimanSetPinBus(): Pin 20 successfully set to type UART_RX (2) with bus 0x3fc8df10
[   273][V][esp32-hal-periman.c:154] perimanSetPinBus(): Pin 21 successfully set to type UART_TX (3) with bus 0x3fc8df10
=========== Before Setup Start ===========
Chip Info:
------------------------------------------
  Model             : ESP32-C3
  Package           : 0
  Revision          : 3
  Cores             : 1
  Frequency         : 160 MHz
  Embedded Flash    : No
  Embedded PSRAM    : No
  2.4GHz WiFi       : Yes
  Classic BT        : No
  BT Low Energy     : Yes
  IEEE 802.15.4     : No
------------------------------------------
INTERNAL Memory Info:
------------------------------------------
  Total Size        :   306872 B ( 299.7 KB)
  Free Bytes        :   275028 B ( 268.6 KB)
  Allocated Bytes   :    28036 B (  27.4 KB)
  Minimum Free Bytes:   274888 B ( 268.4 KB)
  Largest Free Block:   139252 B ( 136.0 KB)
------------------------------------------
Flash Info:
------------------------------------------
  Chip Size         :  4194304 B (4 MB)
  Block Size        :    65536 B (  64.0 KB)
  Sector Size       :     4096 B (   4.0 KB)
  Page Size         :      256 B (   0.2 KB)
  Bus Speed         : 80 MHz
  Bus Mode          : QIO
------------------------------------------
Partitions Info:
------------------------------------------
                nvs : addr: 0x00009000, size:    20.0 KB, type: DATA, subtype: NVS
            otadata : addr: 0x0000E000, size:     8.0 KB, type: DATA, subtype: OTA
               app0 : addr: 0x00010000, size:  1280.0 KB, type:  APP, subtype: OTA_0
               app1 : addr: 0x00150000, size:  1280.0 KB, type:  APP, subtype: OTA_1
             spiffs : addr: 0x00290000, size:  1408.0 KB, type: DATA, subtype: SPIFFS
           coredump : addr: 0x003F0000, size:    64.0 KB, type: DATA, subtype: COREDUMP
------------------------------------------
Software Info:
------------------------------------------
  Compile Date/Time : Jan  5 2024 22:58:46
  Compile Host OS   : windows
  ESP-IDF Version   : v5.1.2-185-g3662303f31-dirty
  Arduino Version   : 3.0.0
------------------------------------------
Board Info:
------------------------------------------
  Arduino Board     : ESP32C3_DEV
  Arduino Variant   : esp32c3
  Arduino FQBN      : esp32:esp32:esp32c3:JTAGAdapter=default,CDCOnBoot=default,PartitionScheme=default,CPUFreq=160,FlashMode=qio,FlashFreq=80,FlashSize=4M,UploadSpeed=921600,DebugLevel=verbose,EraseFlash=none,ZigbeeMode=default
============ Before Setup End ============
[   595][V][esp32-hal-uart.c:409] uartBegin(): UART0 baud(115200) Mode(800001c) rxPin(20) txPin(21)
[   612][D][WiFiGeneric.cpp:1042] _eventCallback(): Arduino Event: 0 - WIFI_READY
[   662][V][WiFiGeneric.cpp:394] _arduino_event_cb(): AP Started
[   669][D][WiFiGeneric.cpp:1042] _eventCallback(): Arduino Event: 10 - AP_START
[   677][V][WiFiGeneric.cpp:96] set_esp_interface_ip(): Configuring SoftAP static IP: 192.168.4.1, MASK: 255.255.255.0, GW: 192.168.4.1
[   689][V][WiFiGeneric.cpp:145] set_esp_interface_ip(): SoftAP: 192.168.4.1 | Gateway: 192.168.4.1 | DHCP Start: 0.0.0.0 | Netmask: 255.255.255.0
[   702][V][WiFiGeneric.cpp:192] set_esp_interface_ip(): DHCP Server Range: 192.168.4.2 to 192.168.4.12
=========== After Setup Start ============
INTERNAL Memory Info:
------------------------------------------
  Total Size        :   306872 B ( 299.7 KB)
  Free Bytes        :   230616 B ( 225.2 KB)
  Allocated Bytes   :    69920 B (  68.3 KB)
  Minimum Free Bytes:   230272 B ( 224.9 KB)
  Largest Free Block:   114676 B ( 112.0 KB)
------------------------------------------
GPIO Info:
------------------------------------------
  GPIO : BUS_TYPE[bus/unit][chan]
  --------------------------------------  
    20 : UART_RX[0]
    21 : UART_TX[0]
============ After Setup End =============

[SuGlider]

@TD-er - I can't reproduce the error. Could you please also try it using the Arduino IDE? Thanks.