1
0
mirror of https://github.com/esp8266/Arduino.git synced 2025-04-19 23:22:16 +03:00

Update documentation and arduino debug options (#8837)

* Update documentation

Describe how to improve Exception Decoder results.

Updated build option details.

* Added d-a-v's code. And updated description and debug macro.

* Update doc

Updated platform.txt - positioned -Os such that it can be overridden by `build.opt`.

Add suggestion of using `-Og` which may improve the Decoder's line number correlation
with the problem in the source code.

Untested adjustments to platformio-build.py

* Fixed code formatting

* Fixed example

Previously `-O3` in the example had no effect. It was overridden by later flags.
Reording the `-Os` allowed changing optimization to  work. Somehow this triggered
a new warning "Stream.h:50:7: warning: 'f.Stream::_startMillis' may be used
uninitialized in this function". Replaced `-O3` with `-Og`.

* Proposed "Debug port" menu change
Preserves a pathway for `build.opt` override.

* Update boards.txt.py and docs - WIP

* Improve organization of optimization content.
Use "Debug Optimization" for menu name.
The menu item defines the initial optimization.
platform.txt - optimization parameter can be overridden by build.opt.

* Add fallback value for build.debug_optim to platform.txt

* update text and undo changes to platformio-build.py

* tweak text

* Added ':orphan:' mark to a06-global-build-options.rst

* Update doc. Added link in page index to 'Improving Exception Decoder Results'

* Update text to reference PR#8868 improvements for leaf function.
This commit is contained in:
M Hightower 2023-03-29 02:16:33 -07:00 committed by GitHub
parent ce9e72014b
commit d3c102e717
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
9 changed files with 433 additions and 64 deletions

View File

@ -17,6 +17,7 @@ menu.FlashFreq=Flash Frequency
menu.ResetMethod=Reset Method
menu.dbg=Debug port
menu.lvl=Debug Level
menu.optim=Debug Optimization
menu.ip=lwIP Variant
menu.vt=VTables
menu.exception=C++ Exceptions
@ -40,6 +41,7 @@ generic.build.mcu=esp8266
generic.build.core=esp8266
generic.build.variant=generic
generic.build.spiffs_pagesize=256
generic.build.debug_optim=
generic.build.debug_port=
generic.build.debug_level=
generic.menu.xtal.80=80 MHz
@ -397,6 +399,12 @@ generic.menu.dbg.Serial1=Serial1
generic.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
generic.menu.lvl.None____=None
generic.menu.lvl.None____.build.debug_level=
generic.menu.optim.Smallest=None
generic.menu.optim.Smallest.build.debug_optim=-Os
generic.menu.optim.Lite=Lite
generic.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
generic.menu.optim.Full=Optimum
generic.menu.optim.Full.build.debug_optim=-Og
generic.menu.lvl.SSL=SSL
generic.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
generic.menu.lvl.TLS_MEM=TLS_MEM
@ -502,6 +510,7 @@ esp8285.serial.disableRTS=true
esp8285.build.mcu=esp8266
esp8285.build.core=esp8266
esp8285.build.spiffs_pagesize=256
esp8285.build.debug_optim=
esp8285.build.debug_port=
esp8285.build.debug_level=
esp8285.menu.xtal.80=80 MHz
@ -742,6 +751,12 @@ esp8285.menu.dbg.Serial1=Serial1
esp8285.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
esp8285.menu.lvl.None____=None
esp8285.menu.lvl.None____.build.debug_level=
esp8285.menu.optim.Smallest=None
esp8285.menu.optim.Smallest.build.debug_optim=-Os
esp8285.menu.optim.Lite=Lite
esp8285.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
esp8285.menu.optim.Full=Optimum
esp8285.menu.optim.Full.build.debug_optim=-Og
esp8285.menu.lvl.SSL=SSL
esp8285.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
esp8285.menu.lvl.TLS_MEM=TLS_MEM
@ -848,6 +863,7 @@ gen4iod.serial.disableRTS=true
gen4iod.build.mcu=esp8266
gen4iod.build.core=esp8266
gen4iod.build.spiffs_pagesize=256
gen4iod.build.debug_optim=
gen4iod.build.debug_port=
gen4iod.build.debug_level=
gen4iod.menu.xtal.80=80 MHz
@ -1010,6 +1026,12 @@ gen4iod.menu.dbg.Serial1=Serial1
gen4iod.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
gen4iod.menu.lvl.None____=None
gen4iod.menu.lvl.None____.build.debug_level=
gen4iod.menu.optim.Smallest=None
gen4iod.menu.optim.Smallest.build.debug_optim=-Os
gen4iod.menu.optim.Lite=Lite
gen4iod.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
gen4iod.menu.optim.Full=Optimum
gen4iod.menu.optim.Full.build.debug_optim=-Og
gen4iod.menu.lvl.SSL=SSL
gen4iod.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
gen4iod.menu.lvl.TLS_MEM=TLS_MEM
@ -1115,6 +1137,7 @@ huzzah.serial.disableRTS=true
huzzah.build.mcu=esp8266
huzzah.build.core=esp8266
huzzah.build.spiffs_pagesize=256
huzzah.build.debug_optim=
huzzah.build.debug_port=
huzzah.build.debug_level=
huzzah.menu.xtal.80=80 MHz
@ -1222,6 +1245,12 @@ huzzah.menu.dbg.Serial1=Serial1
huzzah.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
huzzah.menu.lvl.None____=None
huzzah.menu.lvl.None____.build.debug_level=
huzzah.menu.optim.Smallest=None
huzzah.menu.optim.Smallest.build.debug_optim=-Os
huzzah.menu.optim.Lite=Lite
huzzah.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
huzzah.menu.optim.Full=Optimum
huzzah.menu.optim.Full.build.debug_optim=-Og
huzzah.menu.lvl.SSL=SSL
huzzah.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
huzzah.menu.lvl.TLS_MEM=TLS_MEM
@ -1327,6 +1356,7 @@ wifi_slot.serial.disableRTS=true
wifi_slot.build.mcu=esp8266
wifi_slot.build.core=esp8266
wifi_slot.build.spiffs_pagesize=256
wifi_slot.build.debug_optim=
wifi_slot.build.debug_port=
wifi_slot.build.debug_level=
wifi_slot.menu.xtal.80=80 MHz
@ -1528,6 +1558,12 @@ wifi_slot.menu.dbg.Serial1=Serial1
wifi_slot.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
wifi_slot.menu.lvl.None____=None
wifi_slot.menu.lvl.None____.build.debug_level=
wifi_slot.menu.optim.Smallest=None
wifi_slot.menu.optim.Smallest.build.debug_optim=-Os
wifi_slot.menu.optim.Lite=Lite
wifi_slot.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
wifi_slot.menu.optim.Full=Optimum
wifi_slot.menu.optim.Full.build.debug_optim=-Og
wifi_slot.menu.lvl.SSL=SSL
wifi_slot.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
wifi_slot.menu.lvl.TLS_MEM=TLS_MEM
@ -1645,6 +1681,7 @@ arduino-esp8266.build.mcu=esp8266
arduino-esp8266.build.core=esp8266
arduino-esp8266.build.variant=generic
arduino-esp8266.build.spiffs_pagesize=256
arduino-esp8266.build.debug_optim=
arduino-esp8266.build.debug_port=
arduino-esp8266.build.debug_level=
arduino-esp8266.menu.xtal.80=80 MHz
@ -1752,6 +1789,12 @@ arduino-esp8266.menu.dbg.Serial1=Serial1
arduino-esp8266.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
arduino-esp8266.menu.lvl.None____=None
arduino-esp8266.menu.lvl.None____.build.debug_level=
arduino-esp8266.menu.optim.Smallest=None
arduino-esp8266.menu.optim.Smallest.build.debug_optim=-Os
arduino-esp8266.menu.optim.Lite=Lite
arduino-esp8266.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
arduino-esp8266.menu.optim.Full=Optimum
arduino-esp8266.menu.optim.Full.build.debug_optim=-Og
arduino-esp8266.menu.lvl.SSL=SSL
arduino-esp8266.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
arduino-esp8266.menu.lvl.TLS_MEM=TLS_MEM
@ -1858,6 +1901,7 @@ espmxdevkit.serial.disableRTS=true
espmxdevkit.build.mcu=esp8266
espmxdevkit.build.core=esp8266
espmxdevkit.build.spiffs_pagesize=256
espmxdevkit.build.debug_optim=
espmxdevkit.build.debug_port=
espmxdevkit.build.debug_level=
espmxdevkit.menu.xtal.80=80 MHz
@ -1997,6 +2041,12 @@ espmxdevkit.menu.dbg.Serial1=Serial1
espmxdevkit.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espmxdevkit.menu.lvl.None____=None
espmxdevkit.menu.lvl.None____.build.debug_level=
espmxdevkit.menu.optim.Smallest=None
espmxdevkit.menu.optim.Smallest.build.debug_optim=-Os
espmxdevkit.menu.optim.Lite=Lite
espmxdevkit.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espmxdevkit.menu.optim.Full=Optimum
espmxdevkit.menu.optim.Full.build.debug_optim=-Og
espmxdevkit.menu.lvl.SSL=SSL
espmxdevkit.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espmxdevkit.menu.lvl.TLS_MEM=TLS_MEM
@ -2103,6 +2153,7 @@ oak.serial.disableRTS=true
oak.build.mcu=esp8266
oak.build.core=esp8266
oak.build.spiffs_pagesize=256
oak.build.debug_optim=
oak.build.debug_port=
oak.build.debug_level=
oak.menu.xtal.80=80 MHz
@ -2210,6 +2261,12 @@ oak.menu.dbg.Serial1=Serial1
oak.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
oak.menu.lvl.None____=None
oak.menu.lvl.None____.build.debug_level=
oak.menu.optim.Smallest=None
oak.menu.optim.Smallest.build.debug_optim=-Os
oak.menu.optim.Lite=Lite
oak.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
oak.menu.optim.Full=Optimum
oak.menu.optim.Full.build.debug_optim=-Og
oak.menu.lvl.SSL=SSL
oak.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
oak.menu.lvl.TLS_MEM=TLS_MEM
@ -2324,6 +2381,7 @@ espduino.serial.disableRTS=true
espduino.build.mcu=esp8266
espduino.build.core=esp8266
espduino.build.spiffs_pagesize=256
espduino.build.debug_optim=
espduino.build.debug_port=
espduino.build.debug_level=
espduino.menu.xtal.80=80 MHz
@ -2430,6 +2488,12 @@ espduino.menu.dbg.Serial1=Serial1
espduino.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espduino.menu.lvl.None____=None
espduino.menu.lvl.None____.build.debug_level=
espduino.menu.optim.Smallest=None
espduino.menu.optim.Smallest.build.debug_optim=-Os
espduino.menu.optim.Lite=Lite
espduino.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espduino.menu.optim.Full=Optimum
espduino.menu.optim.Full.build.debug_optim=-Og
espduino.menu.lvl.SSL=SSL
espduino.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espduino.menu.lvl.TLS_MEM=TLS_MEM
@ -2535,6 +2599,7 @@ espectro.serial.disableRTS=true
espectro.build.mcu=esp8266
espectro.build.core=esp8266
espectro.build.spiffs_pagesize=256
espectro.build.debug_optim=
espectro.build.debug_port=
espectro.build.debug_level=
espectro.menu.xtal.80=80 MHz
@ -2642,6 +2707,12 @@ espectro.menu.dbg.Serial1=Serial1
espectro.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espectro.menu.lvl.None____=None
espectro.menu.lvl.None____.build.debug_level=
espectro.menu.optim.Smallest=None
espectro.menu.optim.Smallest.build.debug_optim=-Os
espectro.menu.optim.Lite=Lite
espectro.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espectro.menu.optim.Full=Optimum
espectro.menu.optim.Full.build.debug_optim=-Og
espectro.menu.lvl.SSL=SSL
espectro.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espectro.menu.lvl.TLS_MEM=TLS_MEM
@ -2747,6 +2818,7 @@ espino.serial.disableRTS=true
espino.build.mcu=esp8266
espino.build.core=esp8266
espino.build.spiffs_pagesize=256
espino.build.debug_optim=
espino.build.debug_port=
espino.build.debug_level=
espino.menu.xtal.80=80 MHz
@ -2857,6 +2929,12 @@ espino.menu.dbg.Serial1=Serial1
espino.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espino.menu.lvl.None____=None
espino.menu.lvl.None____.build.debug_level=
espino.menu.optim.Smallest=None
espino.menu.optim.Smallest.build.debug_optim=-Os
espino.menu.optim.Lite=Lite
espino.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espino.menu.optim.Full=Optimum
espino.menu.optim.Full.build.debug_optim=-Og
espino.menu.lvl.SSL=SSL
espino.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espino.menu.lvl.TLS_MEM=TLS_MEM
@ -2962,6 +3040,7 @@ espresso_lite_v1.serial.disableRTS=true
espresso_lite_v1.build.mcu=esp8266
espresso_lite_v1.build.core=esp8266
espresso_lite_v1.build.spiffs_pagesize=256
espresso_lite_v1.build.debug_optim=
espresso_lite_v1.build.debug_port=
espresso_lite_v1.build.debug_level=
espresso_lite_v1.menu.xtal.80=80 MHz
@ -3072,6 +3151,12 @@ espresso_lite_v1.menu.dbg.Serial1=Serial1
espresso_lite_v1.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espresso_lite_v1.menu.lvl.None____=None
espresso_lite_v1.menu.lvl.None____.build.debug_level=
espresso_lite_v1.menu.optim.Smallest=None
espresso_lite_v1.menu.optim.Smallest.build.debug_optim=-Os
espresso_lite_v1.menu.optim.Lite=Lite
espresso_lite_v1.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espresso_lite_v1.menu.optim.Full=Optimum
espresso_lite_v1.menu.optim.Full.build.debug_optim=-Og
espresso_lite_v1.menu.lvl.SSL=SSL
espresso_lite_v1.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espresso_lite_v1.menu.lvl.TLS_MEM=TLS_MEM
@ -3177,6 +3262,7 @@ espresso_lite_v2.serial.disableRTS=true
espresso_lite_v2.build.mcu=esp8266
espresso_lite_v2.build.core=esp8266
espresso_lite_v2.build.spiffs_pagesize=256
espresso_lite_v2.build.debug_optim=
espresso_lite_v2.build.debug_port=
espresso_lite_v2.build.debug_level=
espresso_lite_v2.menu.xtal.80=80 MHz
@ -3287,6 +3373,12 @@ espresso_lite_v2.menu.dbg.Serial1=Serial1
espresso_lite_v2.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espresso_lite_v2.menu.lvl.None____=None
espresso_lite_v2.menu.lvl.None____.build.debug_level=
espresso_lite_v2.menu.optim.Smallest=None
espresso_lite_v2.menu.optim.Smallest.build.debug_optim=-Os
espresso_lite_v2.menu.optim.Lite=Lite
espresso_lite_v2.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espresso_lite_v2.menu.optim.Full=Optimum
espresso_lite_v2.menu.optim.Full.build.debug_optim=-Og
espresso_lite_v2.menu.lvl.SSL=SSL
espresso_lite_v2.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espresso_lite_v2.menu.lvl.TLS_MEM=TLS_MEM
@ -3401,6 +3493,7 @@ sonoff.serial.disableRTS=true
sonoff.build.mcu=esp8266
sonoff.build.core=esp8266
sonoff.build.spiffs_pagesize=256
sonoff.build.debug_optim=
sonoff.build.debug_port=
sonoff.build.debug_level=
sonoff.menu.xtal.80=80 MHz
@ -3540,6 +3633,12 @@ sonoff.menu.dbg.Serial1=Serial1
sonoff.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
sonoff.menu.lvl.None____=None
sonoff.menu.lvl.None____.build.debug_level=
sonoff.menu.optim.Smallest=None
sonoff.menu.optim.Smallest.build.debug_optim=-Os
sonoff.menu.optim.Lite=Lite
sonoff.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
sonoff.menu.optim.Full=Optimum
sonoff.menu.optim.Full.build.debug_optim=-Og
sonoff.menu.lvl.SSL=SSL
sonoff.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
sonoff.menu.lvl.TLS_MEM=TLS_MEM
@ -3645,6 +3744,7 @@ inventone.serial.disableRTS=true
inventone.build.mcu=esp8266
inventone.build.core=esp8266
inventone.build.spiffs_pagesize=256
inventone.build.debug_optim=
inventone.build.debug_port=
inventone.build.debug_level=
inventone.menu.xtal.80=80 MHz
@ -3752,6 +3852,12 @@ inventone.menu.dbg.Serial1=Serial1
inventone.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
inventone.menu.lvl.None____=None
inventone.menu.lvl.None____.build.debug_level=
inventone.menu.optim.Smallest=None
inventone.menu.optim.Smallest.build.debug_optim=-Os
inventone.menu.optim.Lite=Lite
inventone.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
inventone.menu.optim.Full=Optimum
inventone.menu.optim.Full.build.debug_optim=-Og
inventone.menu.lvl.SSL=SSL
inventone.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
inventone.menu.lvl.TLS_MEM=TLS_MEM
@ -3857,6 +3963,7 @@ d1_wroom_02.serial.disableRTS=true
d1_wroom_02.build.mcu=esp8266
d1_wroom_02.build.core=esp8266
d1_wroom_02.build.spiffs_pagesize=256
d1_wroom_02.build.debug_optim=
d1_wroom_02.build.debug_port=
d1_wroom_02.build.debug_level=
d1_wroom_02.menu.xtal.80=80 MHz
@ -3980,6 +4087,12 @@ d1_wroom_02.menu.dbg.Serial1=Serial1
d1_wroom_02.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
d1_wroom_02.menu.lvl.None____=None
d1_wroom_02.menu.lvl.None____.build.debug_level=
d1_wroom_02.menu.optim.Smallest=None
d1_wroom_02.menu.optim.Smallest.build.debug_optim=-Os
d1_wroom_02.menu.optim.Lite=Lite
d1_wroom_02.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
d1_wroom_02.menu.optim.Full=Optimum
d1_wroom_02.menu.optim.Full.build.debug_optim=-Og
d1_wroom_02.menu.lvl.SSL=SSL
d1_wroom_02.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
d1_wroom_02.menu.lvl.TLS_MEM=TLS_MEM
@ -4085,6 +4198,7 @@ d1_mini.serial.disableRTS=true
d1_mini.build.mcu=esp8266
d1_mini.build.core=esp8266
d1_mini.build.spiffs_pagesize=256
d1_mini.build.debug_optim=
d1_mini.build.debug_port=
d1_mini.build.debug_level=
d1_mini.menu.xtal.80=80 MHz
@ -4192,6 +4306,12 @@ d1_mini.menu.dbg.Serial1=Serial1
d1_mini.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
d1_mini.menu.lvl.None____=None
d1_mini.menu.lvl.None____.build.debug_level=
d1_mini.menu.optim.Smallest=None
d1_mini.menu.optim.Smallest.build.debug_optim=-Os
d1_mini.menu.optim.Lite=Lite
d1_mini.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
d1_mini.menu.optim.Full=Optimum
d1_mini.menu.optim.Full.build.debug_optim=-Og
d1_mini.menu.lvl.SSL=SSL
d1_mini.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
d1_mini.menu.lvl.TLS_MEM=TLS_MEM
@ -4297,6 +4417,7 @@ d1_mini_clone.serial.disableRTS=true
d1_mini_clone.build.mcu=esp8266
d1_mini_clone.build.core=esp8266
d1_mini_clone.build.spiffs_pagesize=256
d1_mini_clone.build.debug_optim=
d1_mini_clone.build.debug_port=
d1_mini_clone.build.debug_level=
d1_mini_clone.menu.xtal.80=80 MHz
@ -4421,6 +4542,12 @@ d1_mini_clone.menu.dbg.Serial1=Serial1
d1_mini_clone.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
d1_mini_clone.menu.lvl.None____=None
d1_mini_clone.menu.lvl.None____.build.debug_level=
d1_mini_clone.menu.optim.Smallest=None
d1_mini_clone.menu.optim.Smallest.build.debug_optim=-Os
d1_mini_clone.menu.optim.Lite=Lite
d1_mini_clone.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
d1_mini_clone.menu.optim.Full=Optimum
d1_mini_clone.menu.optim.Full.build.debug_optim=-Og
d1_mini_clone.menu.lvl.SSL=SSL
d1_mini_clone.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
d1_mini_clone.menu.lvl.TLS_MEM=TLS_MEM
@ -4526,6 +4653,7 @@ d1_mini_lite.serial.disableRTS=true
d1_mini_lite.build.mcu=esp8266
d1_mini_lite.build.core=esp8266
d1_mini_lite.build.spiffs_pagesize=256
d1_mini_lite.build.debug_optim=
d1_mini_lite.build.debug_port=
d1_mini_lite.build.debug_level=
d1_mini_lite.menu.xtal.80=80 MHz
@ -4665,6 +4793,12 @@ d1_mini_lite.menu.dbg.Serial1=Serial1
d1_mini_lite.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
d1_mini_lite.menu.lvl.None____=None
d1_mini_lite.menu.lvl.None____.build.debug_level=
d1_mini_lite.menu.optim.Smallest=None
d1_mini_lite.menu.optim.Smallest.build.debug_optim=-Os
d1_mini_lite.menu.optim.Lite=Lite
d1_mini_lite.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
d1_mini_lite.menu.optim.Full=Optimum
d1_mini_lite.menu.optim.Full.build.debug_optim=-Og
d1_mini_lite.menu.lvl.SSL=SSL
d1_mini_lite.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
d1_mini_lite.menu.lvl.TLS_MEM=TLS_MEM
@ -4770,6 +4904,7 @@ d1_mini_pro.serial.disableRTS=true
d1_mini_pro.build.mcu=esp8266
d1_mini_pro.build.core=esp8266
d1_mini_pro.build.spiffs_pagesize=256
d1_mini_pro.build.debug_optim=
d1_mini_pro.build.debug_port=
d1_mini_pro.build.debug_level=
d1_mini_pro.menu.xtal.80=80 MHz
@ -4869,6 +5004,12 @@ d1_mini_pro.menu.dbg.Serial1=Serial1
d1_mini_pro.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
d1_mini_pro.menu.lvl.None____=None
d1_mini_pro.menu.lvl.None____.build.debug_level=
d1_mini_pro.menu.optim.Smallest=None
d1_mini_pro.menu.optim.Smallest.build.debug_optim=-Os
d1_mini_pro.menu.optim.Lite=Lite
d1_mini_pro.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
d1_mini_pro.menu.optim.Full=Optimum
d1_mini_pro.menu.optim.Full.build.debug_optim=-Og
d1_mini_pro.menu.lvl.SSL=SSL
d1_mini_pro.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
d1_mini_pro.menu.lvl.TLS_MEM=TLS_MEM
@ -4974,6 +5115,7 @@ d1.serial.disableRTS=true
d1.build.mcu=esp8266
d1.build.core=esp8266
d1.build.spiffs_pagesize=256
d1.build.debug_optim=
d1.build.debug_port=
d1.build.debug_level=
d1.menu.xtal.80=80 MHz
@ -5081,6 +5223,12 @@ d1.menu.dbg.Serial1=Serial1
d1.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
d1.menu.lvl.None____=None
d1.menu.lvl.None____.build.debug_level=
d1.menu.optim.Smallest=None
d1.menu.optim.Smallest.build.debug_optim=-Os
d1.menu.optim.Lite=Lite
d1.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
d1.menu.optim.Full=Optimum
d1.menu.optim.Full.build.debug_optim=-Og
d1.menu.lvl.SSL=SSL
d1.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
d1.menu.lvl.TLS_MEM=TLS_MEM
@ -5186,6 +5334,7 @@ agruminolemon.serial.disableRTS=true
agruminolemon.build.mcu=esp8266
agruminolemon.build.core=esp8266
agruminolemon.build.spiffs_pagesize=256
agruminolemon.build.debug_optim=
agruminolemon.build.debug_port=
agruminolemon.build.debug_level=
agruminolemon.menu.xtal.80=80 MHz
@ -5309,6 +5458,12 @@ agruminolemon.menu.dbg.Serial1=Serial1
agruminolemon.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
agruminolemon.menu.lvl.None____=None
agruminolemon.menu.lvl.None____.build.debug_level=
agruminolemon.menu.optim.Smallest=None
agruminolemon.menu.optim.Smallest.build.debug_optim=-Os
agruminolemon.menu.optim.Lite=Lite
agruminolemon.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
agruminolemon.menu.optim.Full=Optimum
agruminolemon.menu.optim.Full.build.debug_optim=-Og
agruminolemon.menu.lvl.SSL=SSL
agruminolemon.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
agruminolemon.menu.lvl.TLS_MEM=TLS_MEM
@ -5414,6 +5569,7 @@ nodemcu.serial.disableRTS=true
nodemcu.build.mcu=esp8266
nodemcu.build.core=esp8266
nodemcu.build.spiffs_pagesize=256
nodemcu.build.debug_optim=
nodemcu.build.debug_port=
nodemcu.build.debug_level=
nodemcu.menu.xtal.80=80 MHz
@ -5521,6 +5677,12 @@ nodemcu.menu.dbg.Serial1=Serial1
nodemcu.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
nodemcu.menu.lvl.None____=None
nodemcu.menu.lvl.None____.build.debug_level=
nodemcu.menu.optim.Smallest=None
nodemcu.menu.optim.Smallest.build.debug_optim=-Os
nodemcu.menu.optim.Lite=Lite
nodemcu.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
nodemcu.menu.optim.Full=Optimum
nodemcu.menu.optim.Full.build.debug_optim=-Og
nodemcu.menu.lvl.SSL=SSL
nodemcu.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
nodemcu.menu.lvl.TLS_MEM=TLS_MEM
@ -5626,6 +5788,7 @@ nodemcuv2.serial.disableRTS=true
nodemcuv2.build.mcu=esp8266
nodemcuv2.build.core=esp8266
nodemcuv2.build.spiffs_pagesize=256
nodemcuv2.build.debug_optim=
nodemcuv2.build.debug_port=
nodemcuv2.build.debug_level=
nodemcuv2.menu.xtal.80=80 MHz
@ -5737,6 +5900,12 @@ nodemcuv2.menu.dbg.Serial1=Serial1
nodemcuv2.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
nodemcuv2.menu.lvl.None____=None
nodemcuv2.menu.lvl.None____.build.debug_level=
nodemcuv2.menu.optim.Smallest=None
nodemcuv2.menu.optim.Smallest.build.debug_optim=-Os
nodemcuv2.menu.optim.Lite=Lite
nodemcuv2.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
nodemcuv2.menu.optim.Full=Optimum
nodemcuv2.menu.optim.Full.build.debug_optim=-Og
nodemcuv2.menu.lvl.SSL=SSL
nodemcuv2.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
nodemcuv2.menu.lvl.TLS_MEM=TLS_MEM
@ -5842,6 +6011,7 @@ modwifi.serial.disableRTS=true
modwifi.build.mcu=esp8266
modwifi.build.core=esp8266
modwifi.build.spiffs_pagesize=256
modwifi.build.debug_optim=
modwifi.build.debug_port=
modwifi.build.debug_level=
modwifi.menu.xtal.80=80 MHz
@ -5980,6 +6150,12 @@ modwifi.menu.dbg.Serial1=Serial1
modwifi.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
modwifi.menu.lvl.None____=None
modwifi.menu.lvl.None____.build.debug_level=
modwifi.menu.optim.Smallest=None
modwifi.menu.optim.Smallest.build.debug_optim=-Os
modwifi.menu.optim.Lite=Lite
modwifi.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
modwifi.menu.optim.Full=Optimum
modwifi.menu.optim.Full.build.debug_optim=-Og
modwifi.menu.lvl.SSL=SSL
modwifi.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
modwifi.menu.lvl.TLS_MEM=TLS_MEM
@ -6085,6 +6261,7 @@ phoenix_v1.serial.disableRTS=true
phoenix_v1.build.mcu=esp8266
phoenix_v1.build.core=esp8266
phoenix_v1.build.spiffs_pagesize=256
phoenix_v1.build.debug_optim=
phoenix_v1.build.debug_port=
phoenix_v1.build.debug_level=
phoenix_v1.menu.xtal.80=80 MHz
@ -6195,6 +6372,12 @@ phoenix_v1.menu.dbg.Serial1=Serial1
phoenix_v1.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
phoenix_v1.menu.lvl.None____=None
phoenix_v1.menu.lvl.None____.build.debug_level=
phoenix_v1.menu.optim.Smallest=None
phoenix_v1.menu.optim.Smallest.build.debug_optim=-Os
phoenix_v1.menu.optim.Lite=Lite
phoenix_v1.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
phoenix_v1.menu.optim.Full=Optimum
phoenix_v1.menu.optim.Full.build.debug_optim=-Og
phoenix_v1.menu.lvl.SSL=SSL
phoenix_v1.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
phoenix_v1.menu.lvl.TLS_MEM=TLS_MEM
@ -6300,6 +6483,7 @@ phoenix_v2.serial.disableRTS=true
phoenix_v2.build.mcu=esp8266
phoenix_v2.build.core=esp8266
phoenix_v2.build.spiffs_pagesize=256
phoenix_v2.build.debug_optim=
phoenix_v2.build.debug_port=
phoenix_v2.build.debug_level=
phoenix_v2.menu.xtal.80=80 MHz
@ -6410,6 +6594,12 @@ phoenix_v2.menu.dbg.Serial1=Serial1
phoenix_v2.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
phoenix_v2.menu.lvl.None____=None
phoenix_v2.menu.lvl.None____.build.debug_level=
phoenix_v2.menu.optim.Smallest=None
phoenix_v2.menu.optim.Smallest.build.debug_optim=-Os
phoenix_v2.menu.optim.Lite=Lite
phoenix_v2.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
phoenix_v2.menu.optim.Full=Optimum
phoenix_v2.menu.optim.Full.build.debug_optim=-Og
phoenix_v2.menu.lvl.SSL=SSL
phoenix_v2.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
phoenix_v2.menu.lvl.TLS_MEM=TLS_MEM
@ -6515,6 +6705,7 @@ eduinowifi.serial.disableRTS=true
eduinowifi.build.mcu=esp8266
eduinowifi.build.core=esp8266
eduinowifi.build.spiffs_pagesize=256
eduinowifi.build.debug_optim=
eduinowifi.build.debug_port=
eduinowifi.build.debug_level=
eduinowifi.menu.xtal.80=80 MHz
@ -6622,6 +6813,12 @@ eduinowifi.menu.dbg.Serial1=Serial1
eduinowifi.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
eduinowifi.menu.lvl.None____=None
eduinowifi.menu.lvl.None____.build.debug_level=
eduinowifi.menu.optim.Smallest=None
eduinowifi.menu.optim.Smallest.build.debug_optim=-Os
eduinowifi.menu.optim.Lite=Lite
eduinowifi.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
eduinowifi.menu.optim.Full=Optimum
eduinowifi.menu.optim.Full.build.debug_optim=-Og
eduinowifi.menu.lvl.SSL=SSL
eduinowifi.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
eduinowifi.menu.lvl.TLS_MEM=TLS_MEM
@ -6727,6 +6924,7 @@ wiolink.serial.disableRTS=true
wiolink.build.mcu=esp8266
wiolink.build.core=esp8266
wiolink.build.spiffs_pagesize=256
wiolink.build.debug_optim=
wiolink.build.debug_port=
wiolink.build.debug_level=
wiolink.menu.xtal.80=80 MHz
@ -6834,6 +7032,12 @@ wiolink.menu.dbg.Serial1=Serial1
wiolink.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
wiolink.menu.lvl.None____=None
wiolink.menu.lvl.None____.build.debug_level=
wiolink.menu.optim.Smallest=None
wiolink.menu.optim.Smallest.build.debug_optim=-Os
wiolink.menu.optim.Lite=Lite
wiolink.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
wiolink.menu.optim.Full=Optimum
wiolink.menu.optim.Full.build.debug_optim=-Og
wiolink.menu.lvl.SSL=SSL
wiolink.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
wiolink.menu.lvl.TLS_MEM=TLS_MEM
@ -6939,6 +7143,7 @@ blynk.serial.disableRTS=true
blynk.build.mcu=esp8266
blynk.build.core=esp8266
blynk.build.spiffs_pagesize=256
blynk.build.debug_optim=
blynk.build.debug_port=
blynk.build.debug_level=
blynk.menu.xtal.80=80 MHz
@ -7046,6 +7251,12 @@ blynk.menu.dbg.Serial1=Serial1
blynk.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
blynk.menu.lvl.None____=None
blynk.menu.lvl.None____.build.debug_level=
blynk.menu.optim.Smallest=None
blynk.menu.optim.Smallest.build.debug_optim=-Os
blynk.menu.optim.Lite=Lite
blynk.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
blynk.menu.optim.Full=Optimum
blynk.menu.optim.Full.build.debug_optim=-Og
blynk.menu.lvl.SSL=SSL
blynk.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
blynk.menu.lvl.TLS_MEM=TLS_MEM
@ -7151,6 +7362,7 @@ thing.serial.disableRTS=true
thing.build.mcu=esp8266
thing.build.core=esp8266
thing.build.spiffs_pagesize=256
thing.build.debug_optim=
thing.build.debug_port=
thing.build.debug_level=
thing.menu.xtal.80=80 MHz
@ -7258,6 +7470,12 @@ thing.menu.dbg.Serial1=Serial1
thing.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
thing.menu.lvl.None____=None
thing.menu.lvl.None____.build.debug_level=
thing.menu.optim.Smallest=None
thing.menu.optim.Smallest.build.debug_optim=-Os
thing.menu.optim.Lite=Lite
thing.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
thing.menu.optim.Full=Optimum
thing.menu.optim.Full.build.debug_optim=-Og
thing.menu.lvl.SSL=SSL
thing.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
thing.menu.lvl.TLS_MEM=TLS_MEM
@ -7363,6 +7581,7 @@ thingdev.serial.disableRTS=true
thingdev.build.mcu=esp8266
thingdev.build.core=esp8266
thingdev.build.spiffs_pagesize=256
thingdev.build.debug_optim=
thingdev.build.debug_port=
thingdev.build.debug_level=
thingdev.menu.xtal.80=80 MHz
@ -7470,6 +7689,12 @@ thingdev.menu.dbg.Serial1=Serial1
thingdev.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
thingdev.menu.lvl.None____=None
thingdev.menu.lvl.None____.build.debug_level=
thingdev.menu.optim.Smallest=None
thingdev.menu.optim.Smallest.build.debug_optim=-Os
thingdev.menu.optim.Lite=Lite
thingdev.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
thingdev.menu.optim.Full=Optimum
thingdev.menu.optim.Full.build.debug_optim=-Og
thingdev.menu.lvl.SSL=SSL
thingdev.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
thingdev.menu.lvl.TLS_MEM=TLS_MEM
@ -7575,6 +7800,7 @@ esp210.build.mcu=esp8266
esp210.build.core=esp8266
esp210.build.variant=generic
esp210.build.spiffs_pagesize=256
esp210.build.debug_optim=
esp210.build.debug_port=
esp210.build.debug_level=
esp210.menu.xtal.80=80 MHz
@ -7682,6 +7908,12 @@ esp210.menu.dbg.Serial1=Serial1
esp210.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
esp210.menu.lvl.None____=None
esp210.menu.lvl.None____.build.debug_level=
esp210.menu.optim.Smallest=None
esp210.menu.optim.Smallest.build.debug_optim=-Os
esp210.menu.optim.Lite=Lite
esp210.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
esp210.menu.optim.Full=Optimum
esp210.menu.optim.Full.build.debug_optim=-Og
esp210.menu.lvl.SSL=SSL
esp210.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
esp210.menu.lvl.TLS_MEM=TLS_MEM
@ -7787,6 +8019,7 @@ espinotee.serial.disableRTS=true
espinotee.build.mcu=esp8266
espinotee.build.core=esp8266
espinotee.build.spiffs_pagesize=256
espinotee.build.debug_optim=
espinotee.build.debug_port=
espinotee.build.debug_level=
espinotee.menu.xtal.80=80 MHz
@ -7894,6 +8127,12 @@ espinotee.menu.dbg.Serial1=Serial1
espinotee.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
espinotee.menu.lvl.None____=None
espinotee.menu.lvl.None____.build.debug_level=
espinotee.menu.optim.Smallest=None
espinotee.menu.optim.Smallest.build.debug_optim=-Os
espinotee.menu.optim.Lite=Lite
espinotee.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
espinotee.menu.optim.Full=Optimum
espinotee.menu.optim.Full.build.debug_optim=-Og
espinotee.menu.lvl.SSL=SSL
espinotee.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
espinotee.menu.lvl.TLS_MEM=TLS_MEM
@ -7999,6 +8238,7 @@ wifi_kit_8.serial.disableRTS=true
wifi_kit_8.build.mcu=esp8266
wifi_kit_8.build.core=esp8266
wifi_kit_8.build.spiffs_pagesize=256
wifi_kit_8.build.debug_optim=
wifi_kit_8.build.debug_port=
wifi_kit_8.build.debug_level=
wifi_kit_8.menu.xtal.80=80 MHz
@ -8106,6 +8346,12 @@ wifi_kit_8.menu.dbg.Serial1=Serial1
wifi_kit_8.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
wifi_kit_8.menu.lvl.None____=None
wifi_kit_8.menu.lvl.None____.build.debug_level=
wifi_kit_8.menu.optim.Smallest=None
wifi_kit_8.menu.optim.Smallest.build.debug_optim=-Os
wifi_kit_8.menu.optim.Lite=Lite
wifi_kit_8.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
wifi_kit_8.menu.optim.Full=Optimum
wifi_kit_8.menu.optim.Full.build.debug_optim=-Og
wifi_kit_8.menu.lvl.SSL=SSL
wifi_kit_8.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
wifi_kit_8.menu.lvl.TLS_MEM=TLS_MEM
@ -8211,6 +8457,7 @@ wifiduino.serial.disableRTS=true
wifiduino.build.mcu=esp8266
wifiduino.build.core=esp8266
wifiduino.build.spiffs_pagesize=256
wifiduino.build.debug_optim=
wifiduino.build.debug_port=
wifiduino.build.debug_level=
wifiduino.menu.xtal.80=80 MHz
@ -8318,6 +8565,12 @@ wifiduino.menu.dbg.Serial1=Serial1
wifiduino.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
wifiduino.menu.lvl.None____=None
wifiduino.menu.lvl.None____.build.debug_level=
wifiduino.menu.optim.Smallest=None
wifiduino.menu.optim.Smallest.build.debug_optim=-Os
wifiduino.menu.optim.Lite=Lite
wifiduino.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
wifiduino.menu.optim.Full=Optimum
wifiduino.menu.optim.Full.build.debug_optim=-Og
wifiduino.menu.lvl.SSL=SSL
wifiduino.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
wifiduino.menu.lvl.TLS_MEM=TLS_MEM
@ -8440,6 +8693,7 @@ wifinfo.serial.disableRTS=true
wifinfo.build.mcu=esp8266
wifinfo.build.core=esp8266
wifinfo.build.spiffs_pagesize=256
wifinfo.build.debug_optim=
wifinfo.build.debug_port=
wifinfo.build.debug_level=
wifinfo.menu.xtal.80=80 MHz
@ -8586,6 +8840,12 @@ wifinfo.menu.dbg.Serial1=Serial1
wifinfo.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
wifinfo.menu.lvl.None____=None
wifinfo.menu.lvl.None____.build.debug_level=
wifinfo.menu.optim.Smallest=None
wifinfo.menu.optim.Smallest.build.debug_optim=-Os
wifinfo.menu.optim.Lite=Lite
wifinfo.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
wifinfo.menu.optim.Full=Optimum
wifinfo.menu.optim.Full.build.debug_optim=-Og
wifinfo.menu.lvl.SSL=SSL
wifinfo.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
wifinfo.menu.lvl.TLS_MEM=TLS_MEM
@ -8691,6 +8951,7 @@ cw01.serial.disableRTS=true
cw01.build.mcu=esp8266
cw01.build.core=esp8266
cw01.build.spiffs_pagesize=256
cw01.build.debug_optim=
cw01.build.debug_port=
cw01.build.debug_level=
cw01.menu.xtal.80=80 MHz
@ -8801,6 +9062,12 @@ cw01.menu.dbg.Serial1=Serial1
cw01.menu.dbg.Serial1.build.debug_port=-DDEBUG_ESP_PORT=Serial1
cw01.menu.lvl.None____=None
cw01.menu.lvl.None____.build.debug_level=
cw01.menu.optim.Smallest=None
cw01.menu.optim.Smallest.build.debug_optim=-Os
cw01.menu.optim.Lite=Lite
cw01.menu.optim.Lite.build.debug_optim=-Os -fno-optimize-sibling-calls
cw01.menu.optim.Full=Optimum
cw01.menu.optim.Full.build.debug_optim=-Og
cw01.menu.lvl.SSL=SSL
cw01.menu.lvl.SSL.build.debug_level= -DDEBUG_ESP_SSL
cw01.menu.lvl.TLS_MEM=TLS_MEM

View File

@ -4,8 +4,13 @@
#include <stddef.h>
#include <stdint.h>
#define _DEBUG_LEAF_FUNCTION(...) __asm__ __volatile__("" ::: "a0", "memory")
#ifdef DEBUG_ESP_CORE
#define DEBUGV(fmt, ...) ::printf((PGM_P)PSTR(fmt), ##__VA_ARGS__)
#define DEBUG_LEAF_FUNCTION _DEBUG_LEAF_FUNCTION
#else
#define DEBUG_LEAF_FUNCTION(...)
#endif
#ifndef DEBUGV

View File

@ -57,7 +57,10 @@ the hex after are the stack dump.
Decode
~~~~~~
It's possible to decode the Stack to readable information. For more info see the `Esp Exception Decoder <https://github.com/me-no-dev/EspExceptionDecoder>`__ tool.
It's possible to decode the Stack to readable information.
You can get a copy and read about the `Esp Exception Decoder <https://github.com/me-no-dev/EspExceptionDecoder>`__ tool.
For a troubleshooting example using the Exception Decoder Tool, read `FAQ: My ESP Crashes <../faq/a02-my-esp-crashes.rst#exception-decoder>`__.
.. figure:: ESP_Exception_Decoderp.png
:alt: ESP Exception Decoder

View File

@ -11,6 +11,7 @@ My ESP crashes running some code. How to troubleshoot it?
- `Exception <#exception>`__
- `Watchdog <#watchdog>`__
- `Exception Decoder <#exception-decoder>`__
- `Improving Exception Decoder Results <#improving-exception-decoder-results>`__
- `Other Common Causes for Crashes <#other-causes-for-crashes>`__
- `If at the Wall, Enter an Issue
Report <#if-at-the-wall-enter-an-issue-report>`__
@ -236,6 +237,7 @@ If you don't have any code for troubleshooting, use the example below:
void loop(){}
Enable the Out-Of-Memory (*OOM*) debug option (in the *Tools > Debug Level*
menu), compile/flash/upload this code to your ESP (Ctrl+U) and start Serial
Monitor (Ctrl+Shift+M). You should shortly see ESP restarting every couple
@ -270,13 +272,74 @@ Decoder <https://github.com/me-no-dev/EspExceptionDecoder>`__ you can
track down where the module is crashing whenever you see the stack trace
dropped. The same procedure applies to crashes caused by exceptions.
Note: To decode the exact line of code where the application
Note, to decode the exact line of code where the application
crashed, you need to use ESP Exception Decoder in context of sketch
you have just loaded to the module for diagnosis. Decoder is not
able to correctly decode the stack trace dropped by some other
application not compiled and loaded from your Arduino IDE.
Improving Exception Decoder Results
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Due to the limited resources on the device, our default compiler optimizations
focus on creating the smallest code size (``.bin`` file). The GCC compiler's
option ``-Os`` contains the base set of optimizations used. This set is fine for
release but not ideal for debugging.
Our view of a crash is often the `Stack Dump <../Troubleshooting/stack_dump.rst>`__
which gets copy/pasted into an Exception Decoder.
For some situations, the optimizer doesn't write caller return addresses to the
stack. When we crash, the list of functions called is missing. And when the
crash occurs in a leaf function, there is seldom if ever any evidence of who
called.
With the ``-Os`` option, functions called once are inlined into the calling
function. A chain of these functions can optimize down to the calling function.
When the crash occurs in one of these chain functions, the actual location in
the source code is no longer available.
When you select ``Debug Optimization: Lite`` on the Arduino IDE Tools menu, it
turns off ``optimize-sibling-calls``. Turning off this optimization allows more
caller addresses to be written to the stack, improving the results from the
Exception Decoder. Without this option, the callers involved in the crash may be
missing from the Decoder results. Because of the limited stack space, there is
the remote possibility that removing this optimization could lead to more
frequent stack overflows. You only want to do this in a debug setting. This
option does not help the chained function issue.
When you select ``Debug Optimization: Optimum``, you get an even more complete
stack trace. For example, chained function calls may show up. This selection
uses the compiler option ``-Og``. GCC considers this the ideal optimization for
the "edit-compile-debug cycle" ... "producing debuggable code." You can read the
specifics at `GCC's Optimize Options <https://gcc.gnu.org/onlinedocs/gcc/Optimize-Options.html>`__
When global optimization creates build size issues or stack overflow issues,
select ``Debug Optimization: None``, and use a targeted approach with
``#pragma GCC optimize("Og")`` at the module level. Or, if you want to use a
different set of optimizations, you can set optimizations through build options.
Read more at `Global Build Options <a06-global-build-options.rst>`__.
For non-Arduino IDE build platforms, you may need to research how to add build
options. Some build platforms already use ``-Og`` for debug builds.
A crash in a leaf function may not leave the caller's address on the stack.
The return address can stay in a register for the duration of the call.
Resulting in a crash report identifying the crashing function without a
trace of who called. You can encourage the compiler to save the caller's
return address by adding an inline assembly trick
``__asm__ __volatile__("" ::: "a0", "memory");`` at the beginning of the
function's body. Or instead, for a debug build conditional option, use the
macro ``DEBUG_LEAF_FUNCTION()`` from ``#include <debug.h>``. For compiler
toolchain 3.2.0 and above, the ``-Og`` option is an alternative solution.
In some cases, adding ``#pragma GCC optimize("Og,no-ipa-pure-const")`` to a
module as well as using ``DEBUG_LEAF_FUNCTION()`` in a leaf function were
needed to display a complete call chain. Or use
``#pragma GCC optimize("Os,no-inline,no-optimize-sibling-calls,no-ipa-pure-const")``
if you require optimization ``-Os``.
Other Causes for Crashes
~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -181,10 +181,10 @@ their builds.
There are two solutions to this issue:
1. Turn off the “Aggressively Cache Compiled core” feature, by setting
1. Do nothing, and rely on aggressive cache workaround built into the
script.
2. Turn off the “Aggressively Cache Compiled core” feature, by setting
``compiler.cache_core=false``.
2. Rely on the not ideal fail-safe, aggressive cache workaround built
into the script.
Using “compiler.cache_core=false”
---------------------------------
@ -253,14 +253,10 @@ problem would be cleared after a reboot. Or you can manually cleanup the
**Arduino command-line option overrides**
The script needs to know the working value of ``compiler.cache_core``
that the Arduino IDE uses when building. This script can learn the state
through documented locations; however, the Arduino IDE has two
command-line options that can alter the results the Arduino IDE uses
internally. And, the Arduino IDE does not provide a means for a script
to learn the override value.
If you are building with ``compiler.cache_core=true`` no action is
needed. If ``false`` the script would benefit by knowing that.
These two command-line options are the problem:
When using either of these two command-line options:
::

View File

@ -127,7 +127,31 @@ There are a number of options.
- The last (``NoAssert - NDEBUG``) is even quieter than the first (some
internal guards are skipped to save more flash).
- The other ones may be used when asked by a maintainer or if you are a
developper trying to debug some issues.
developer trying to debug some issues.
Debug Optimization
~~~~~~~~~~~~~~~~~~
Due to the limited resources on the device, our default compiler optimizations
focus on creating the smallest code size (``.bin`` file). That is fine for
release but not ideal for debugging.
``Debug Optimization`` use to improve Exception Decoder results.
- ``Lite`` impact on code size uses ``-fno-optimize-sibling-calls`` to alter
the ``-Os`` compiler option to place more caller addresses on the Stack.
- ``Optimum`` offers better quality stack content for the Exception Decoder at
the expense of a larger code size. It uses the ``-Og`` compiler option, which
turns off optimizations that can make debugging difficult while keeping
others.
- ``None`` no changes for debugging continue using ``-Os``.
Take note some sketches may start working after changing the optimization. Or
fail less often. And it is also possible (not likely) that source code that
was working with ``-Os`` may break with ``-Og``.
For more topic depth, read `Improving Exception Decoder Results <faq/a02-my-esp-crashes.rst#improving-exception-decoder-results>`__
lwIP variant
~~~~~~~~~~~~

View File

@ -8,7 +8,7 @@
* this line is ignored
*@create-file:build.opt@
# this line is ignored
-O3
-Og
// -fanalyzer
-DUMM_STATS_FULL=1
*/

View File

@ -44,6 +44,9 @@ build.stdcpp_level=-std=gnu++17
build.stacksmash_flags=
# Default - never leave undefined
build.debug_optim=-Os
build.float=-u _printf_float -u _scanf_float
build.led=
@ -70,24 +73,24 @@ 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__ -D_GNU_SOURCE -DESP8266 {build.opt.flags} "-I{compiler.sdk.path}/include" "-I{compiler.sdk.path}/{build.lwip_include}" "-I{compiler.libc.path}/include" "-I{build.path}/core"
compiler.cpreprocessor.flags=-D__ets__ -DICACHE_FLASH -U__STRICT_ANSI__ -D_GNU_SOURCE -DESP8266 {build.debug_optim} {build.opt.flags} "-I{compiler.sdk.path}/include" "-I{compiler.sdk.path}/{build.lwip_include}" "-I{compiler.libc.path}/include" "-I{build.path}/core"
# support precompiled libraries in IDE v1.8.6+
compiler.libraries.ldflags=
compiler.c.cmd=xtensa-lx106-elf-gcc
compiler.c.flags=-c "{compiler.warning_flags}-cflags" -std=gnu17 {build.stacksmash_flags} -Os -g -free -fipa-pta -Werror=return-type -Wpointer-arith -Wno-implicit-function-declaration -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -mtext-section-literals -falign-functions=4 -MMD -ffunction-sections -fdata-sections {build.exception_flags} {build.sslflags} {build.mmuflags} {build.non32xferflags}
compiler.c.flags=-c "{compiler.warning_flags}-cflags" -std=gnu17 {build.stacksmash_flags} -g -free -fipa-pta -Werror=return-type -Wpointer-arith -Wno-implicit-function-declaration -Wl,-EL -fno-inline-functions -nostdlib -mlongcalls -mtext-section-literals -falign-functions=4 -MMD -ffunction-sections -fdata-sections {build.exception_flags} {build.sslflags} {build.mmuflags} {build.non32xferflags}
compiler.S.cmd=xtensa-lx106-elf-gcc
compiler.S.flags=-c -g -x assembler-with-cpp -MMD -mlongcalls "-I{runtime.tools.xtensa-lx106-elf-gcc.path}/include/"
compiler.c.elf.flags=-g "{compiler.warning_flags}-cflags" -Os -nostdlib -Wl,--no-check-sections -u app_entry {build.float} -Wl,-static "-L{compiler.sdk.path}/lib" "-L{compiler.sdk.path}/lib/{build.sdk}" "-L{build.path}" "-L{compiler.libc.path}/lib" "-Tlocal.eagle.flash.ld" -Wl,--gc-sections -Wl,-wrap,system_restart_local -Wl,-wrap,spi_flash_read
compiler.c.elf.flags=-g "{compiler.warning_flags}-cflags" -nostdlib -Wl,--no-check-sections -u app_entry {build.float} -Wl,-static "-L{compiler.sdk.path}/lib" "-L{compiler.sdk.path}/lib/{build.sdk}" "-L{build.path}" "-L{compiler.libc.path}/lib" "-Tlocal.eagle.flash.ld" -Wl,--gc-sections -Wl,-wrap,system_restart_local -Wl,-wrap,spi_flash_read
compiler.c.elf.cmd=xtensa-lx106-elf-gcc
compiler.c.elf.libs=-lhal -lphy -lpp -lnet80211 {build.lwip_lib} -lwpa -lcrypto -lmain -lwps -lbearssl -lespnow -lsmartconfig -lairkiss -lwpa2 {build.stdcpp_lib} -lm -lc -lgcc
compiler.cpp.cmd=xtensa-lx106-elf-g++
compiler.cpp.flags=-c "{compiler.warning_flags}-cppflags" {build.stacksmash_flags} -Os -g -free -fipa-pta -Werror=return-type -mlongcalls -mtext-section-literals -fno-rtti -falign-functions=4 {build.stdcpp_level} -MMD -ffunction-sections -fdata-sections {build.exception_flags} {build.sslflags} {build.mmuflags} {build.non32xferflags}
compiler.cpp.flags=-c "{compiler.warning_flags}-cppflags" {build.stacksmash_flags} -g -free -fipa-pta -Werror=return-type -mlongcalls -mtext-section-literals -fno-rtti -falign-functions=4 {build.stdcpp_level} -MMD -ffunction-sections -fdata-sections {build.exception_flags} {build.sslflags} {build.mmuflags} {build.non32xferflags}
compiler.as.cmd=xtensa-lx106-elf-as

View File

@ -1045,6 +1045,7 @@ macros = {
( '.build.core', 'esp8266' ),
( '.build.variant', 'generic' ),
( '.build.spiffs_pagesize', '256' ),
( '.build.debug_optim', '' ),
( '.build.debug_port', '' ),
( '.build.debug_level', '' ),
]),
@ -1360,6 +1361,12 @@ def all_debug ():
( '.menu.dbg.Serial1.build.debug_port', '-DDEBUG_ESP_PORT=Serial1' ),
( '.menu.lvl.None____', 'None' ),
( '.menu.lvl.None____.build.debug_level', '' ),
( '.menu.optim.Smallest', 'None' ),
( '.menu.optim.Smallest.build.debug_optim', '-Os' ),
( '.menu.optim.Lite', 'Lite' ),
( '.menu.optim.Lite.build.debug_optim', '-Os -fno-optimize-sibling-calls' ),
( '.menu.optim.Full', 'Optimum' ),
( '.menu.optim.Full.build.debug_optim', '-Og' ),
])
for optlist in options:
@ -1740,6 +1747,7 @@ def all_boards ():
print('menu.ResetMethod=Reset Method')
print('menu.dbg=Debug port')
print('menu.lvl=Debug Level')
print('menu.optim=Debug Optimization')
print('menu.ip=lwIP Variant')
print('menu.vt=VTables')
print('menu.exception=C++ Exceptions')