new board generator option to enable WPS / disable extra 4k in heap

Author: d-a-v

cores/esp8266/core_esp8266_main.cpp

@@ -156,20 +156,24 @@ void init_done() {
  * Peripherals (except for SPI0 and UART0) are not initialized.
  * This function does not return.
  */
-#define EXTRA_4K_HEAP 1
 
-#if !EXTRA_4K_HEAP
+/* provided or not by boards.txt */
+/* #define NO_EXTRA_4K_HEAP */
+
+
+#ifdef NO_EXTRA_4K_HEAP
+/* this is the default NONOS-SDK user's heap location */
 cont_t g_cont __attribute__ ((aligned (16)));
 #endif
 
 extern "C" void ICACHE_RAM_ATTR app_entry(void)
 {
+#ifdef NO_EXTRA_4K_HEAP
+    g_pcont = &g_cont;
+#else
     /* Allocate continuation context on this stack, and save pointer to it. */
-#if EXTRA_4K_HEAP
     cont_t s_cont __attribute__((aligned(16)));
     g_pcont = &s_cont;
-#else
-    g_pcont = &g_cont;
 #endif
     /* Call the entry point of the SDK code. */
     call_user_start();

doc/faq/readme.rst

@@ -40,6 +40,26 @@ entering an issue report, please perform initial troubleshooting.
 
 `Read more <a02-my-esp-crashes.rst>`__.
 
+How can I get some extra KBs in flash ?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Using `*printf()` with floats is enabled by default.  Some KBs of flash can
+be saved by using the option `--nofloat` with the boards generator:
+
+```
+./tools/boards.txt.py --nofloat --allgen
+```
+
+Why can't I use WPS ?
+~~~~~~~~~~~~~~~~~~~~~
+
+WPS is disabled by default, this offers an extra 4KB in ram/heap.  To enable
+WPS, use this boards generator option:
+
+```
+./tools/boards.txt.py --noextra4kheap --allgen
+```
+
 This Arduino library doesn't work on ESP. How do I make it work?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 

libraries/ESP8266WiFi/src/ESP8266WiFiSTA.cpp

@@ -571,6 +571,8 @@ int32_t ESP8266WiFiSTAClass::RSSI(void) {
 // -------------------------------------------------- STA remote configure -----------------------------------------------
 // -----------------------------------------------------------------------------------------------------------------------
 
+#ifdef NO_EXTRA_4K_HEAP
+
 void wifi_wps_status_cb(wps_cb_status status);
 
 /**
@@ -650,7 +652,7 @@ void wifi_wps_status_cb(wps_cb_status status) {
     esp_schedule(); // resume the beginWPSConfig function
 }
 
-
+#endif // NO_EXTRA_4K_HEAP
 
 bool ESP8266WiFiSTAClass::_smartConfigStarted = false;
 bool ESP8266WiFiSTAClass::_smartConfigDone = false;

libraries/ESP8266WiFi/src/ESP8266WiFiSTA.h

@@ -26,6 +26,7 @@
 
 #include "ESP8266WiFiType.h"
 #include "ESP8266WiFiGeneric.h"
+#include "user_interface.h"
 
 
 class ESP8266WiFiSTAClass {
@@ -92,7 +93,13 @@ class ESP8266WiFiSTAClass {
 
     public:
 
+#ifdef NO_EXTRA_4K_HEAP
         bool beginWPSConfig(void);
+#else
+        inline bool beginWPSConfig(void) __attribute__((always_inline)) {
+            return WPS_is_unavailable_in_this_configuration__Please_check_FAQ_or_board_generator_tool();
+        }
+#endif
 
         bool beginSmartConfig();
         bool stopSmartConfig();

platform.txt

@@ -25,14 +25,15 @@ build.vtable_flags=-DVTABLES_IN_FLASH
 
 build.float=-u _printf_float -u _scanf_float
 build.led=
+build.noextra4kheap=
 
 compiler.path={runtime.tools.xtensa-lx106-elf-gcc.path}/bin/
 compiler.sdk.path={runtime.platform.path}/tools/sdk
 compiler.libc.path={runtime.platform.path}/tools/sdk/libc/xtensa-lx106-elf
 compiler.cpreprocessor.flags=-D__ets__ -DICACHE_FLASH -U__STRICT_ANSI__ "-I{compiler.sdk.path}/include" "-I{compiler.sdk.path}/{build.lwip_include}" "-I{compiler.libc.path}/include" "-I{build.path}/core"
 
 compiler.c.cmd=xtensa-lx106-elf-gcc
-compiler.c.flags=-c {compiler.warning_flags} -Os -g -Wpointer-arith -Wno-implicit-function-declaration -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -mtext-section-literals -falign-functions=4 -MMD -std=gnu99 -ffunction-sections -fdata-sections
+compiler.c.flags=-c {compiler.warning_flags} {build.noextra4kheap} -Os -g -Wpointer-arith -Wno-implicit-function-declaration -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -mtext-section-literals -falign-functions=4 -MMD -std=gnu99 -ffunction-sections -fdata-sections
 
 compiler.S.cmd=xtensa-lx106-elf-gcc
 compiler.S.flags=-c -g -x assembler-with-cpp -MMD -mlongcalls
@@ -43,7 +44,7 @@ compiler.c.elf.cmd=xtensa-lx106-elf-gcc
 compiler.c.elf.libs=-lhal -lphy -lpp -lnet80211 {build.lwip_lib} -lwpa -lcrypto -lmain -lwps -lbearssl -laxtls -lespnow -lsmartconfig -lairkiss -lwpa2 -lstdc++ -lm -lc -lgcc
 
 compiler.cpp.cmd=xtensa-lx106-elf-g++
-compiler.cpp.flags=-c {compiler.warning_flags} -Os -g -mlongcalls -mtext-section-literals -fno-exceptions -fno-rtti -falign-functions=4 -std=c++11 -MMD -ffunction-sections -fdata-sections
+compiler.cpp.flags=-c {compiler.warning_flags} {build.noextra4kheap} -Os -g -mlongcalls -mtext-section-literals -fno-exceptions -fno-rtti -falign-functions=4 -std=c++11 -MMD -ffunction-sections -fdata-sections
 
 compiler.as.cmd=xtensa-lx106-elf-as
 

tools/boards.txt.py

@@ -1236,6 +1236,9 @@ def all_boards ():
         if nofloat:
             print id + '.build.float='
 
+        if noextra4kheap:
+            print id + '.build.noextra4kheap=-DNO_EXTRA_4K_HEAP'
+
         print ''
 
     if boardsgen:
@@ -1253,11 +1256,8 @@ def package ():
 
     if packagegen:
         pkgfname_read = pkgfname + '.orig'
-        # check if backup already exists
         if os.path.isfile(pkgfname_read):
-            print "package file is in the way, please move it"
-            print "    %s" % pkgfname_read
-            sys.exit(1)
+            os.remove(pkgfname_read)
         os.rename(pkgfname, pkgfname_read)
 
     # read package file
@@ -1333,6 +1333,7 @@ def usage (name,ret):
     print " --speed s       - change default serial speed"
     print " --customspeed s - new serial speed for all boards"
     print " --nofloat       - disable float support in printf/scanf"
+    print " --noextra4kheap - disable extra 4k heap (will enable WPS)"
     print ""
     print " mandatory option (at least one):"
     print ""
@@ -1376,6 +1377,7 @@ def usage (name,ret):
 led_default = 2
 led_max = 16
 nofloat = False
+noextra4kheap = False
 ldgen = False
 ldshow = False
 boardsgen = False
@@ -1391,6 +1393,7 @@ def usage (name,ret):
 try:
     opts, args = getopt.getopt(sys.argv[1:], "h",
         [ "help", "lwip=", "led=", "speed=", "board=", "customspeed=", "nofloat",
+          "noextra4kheap",
           "ld", "ldgen", "boards", "boardsgen", "package", "packagegen", "doc", "docgen",
           "allgen"] )
 except getopt.GetoptError as err:
@@ -1434,6 +1437,9 @@ def usage (name,ret):
     elif o in ("--nofloat"):
         nofloat=True
 
+    elif o in ("--noextra4kheap"):
+        noextra4kheap=True
+
     elif o in ("--ldshow"):
         ldshow = True
 

tools/sdk/include/user_interface.h

@@ -575,9 +575,16 @@ enum wps_cb_status {
     WPS_CB_ST_UNK,
 };
 
+#ifdef NO_EXTRA_4K_HEAP
 bool wifi_wps_enable(WPS_TYPE_t wps_type);
 bool wifi_wps_disable(void);
 bool wifi_wps_start(void);
+#else
+bool WPS_is_unavailable_in_this_configuration__Please_check_FAQ_or_board_generator_tool ();
+#define wifi_wps_enable(...) WPS_is_unavailable_in_this_configuration__Please_check_FAQ_or_board_generator_tool()
+#define wifi_wps_disable() WPS_is_unavailable_in_this_configuration__Please_check_FAQ_or_board_generator_tool()
+#define wifi_wps_start() WPS_is_unavailable_in_this_configuration__Please_check_FAQ_or_board_generator_tool()
+#endif
 
 typedef void (*wps_st_cb_t)(int status);
 bool wifi_set_wps_cb(wps_st_cb_t cb);