diff --git a/HISTORY.rst b/HISTORY.rst index e4b5fc43..8aca7b6a 100644 --- a/HISTORY.rst +++ b/HISTORY.rst @@ -7,6 +7,9 @@ PlatformIO 2.0 2.7.2 (2016-01-??) ~~~~~~~~~~~~~~~~~~ +* Explained in documentation how to `overwrite upload reset method `_ + for Espressif development platform + (`issue #444 `_) * Fixed builder for mbed framework and ST STM32 platform diff --git a/docs/platforms/espressif_extra.rst b/docs/platforms/espressif_extra.rst index 11c52dc8..6c8614c0 100644 --- a/docs/platforms/espressif_extra.rst +++ b/docs/platforms/espressif_extra.rst @@ -53,6 +53,34 @@ To override default LD script please use :ref:`projectconf_build_flags` from [env:myenv] build_flags = -Wl,-Tesp8266.flash.4m.ld +Custom Reset Method +------------------- + +To overwrite predefined reset method for uploading please use :ref:`projectconf_extra_script`. +For example, default reset method for ``esp12e`` board is ``nodemcu``. Let's +overwrite it to ``ck``: + +* :ref:`projectconf` + + .. code-block:: ini + + [env:esp12e] + platform = espressif + framework = arduino + board = esp12e + extra_script = extra_script.py + + +* ``extra_script.py`` should be located on the same level as :ref:`projectconf` + + .. code-block:: python + + from SCons.Script import DefaultEnvironment + + env = DefaultEnvironment() + env['BOARD_OPTIONS']['upload']['resetmethod'] = 'ck' + + .. _platform_espressif_uploadfs: Uploading files to file system SPIFFS