Merge pull request #7951 from Neradoc/pystack-doc-and-size

Document CIRCUITPY_PYSTACK_SIZE

Author: tannewt

docs/environment.rst

@@ -60,6 +60,12 @@ CIRCUITPY_BLE_NAME
 ~~~~~~~~~~~~~~~~~~
 Default BLE name the board advertises as, including for the BLE workflow.
 
+CIRCUITPY_PYSTACK_SIZE
+~~~~~~~~~~~~~~~~~~~~~~
+Sets the size of the python stack. Must be a multiple of 4. The default value is currently 1536.
+Increasing the stack reduces the size of the heap available to python code.
+Used to avoid "Pystack exhausted" errors when the code can't be reworked to avoid it.
+
 CIRCUITPY_RESERVED_PSRAM
 ~~~~~~~~~~~~~~~~~~~~~~~~
 On boards with Espressif microcontrollers with PSRAM (also called SPIRAM), permanently reserve a portion of PSRAM for use by esp-idf.