Skip to content

Commit d518779

Browse files
Mention OTA Update class blocks flash mode changes (#7321)
Add mention that OTA Update class will block changes to flash mode bits if the image is uncompressed, and link to the recent discussion on this. Co-authored-by: Earle F. Philhower, III <[email protected]>
1 parent a679869 commit d518779

File tree

1 file changed

+2
-0
lines changed

1 file changed

+2
-0
lines changed

doc/ota_updates/readme.rst

+2
Original file line numberDiff line numberDiff line change
@@ -669,6 +669,8 @@ Updater is in the Core and deals with writing the firmware to the flash, checkin
669669

670670
**Note:** The bootloader command will be stored into the first 128 bytes of user RTC memory, then it will be retrieved by eboot on boot. That means that user data present there will be lost `(per discussion in #5330) <https://github.com/esp8266/Arduino/pull/5330#issuecomment-437803456>`__.
671671

672+
**Note:** For uncompressed firmware images, the Updater will change the flash mode bits if they differ from the flash mode the device is currently running at. This ensures that the flash mode is not changed to an incompatible mode when the device is in a remote or hard to access area. Compressed images are not modified, thus changing the flash mode in this instance could result in damage to the ESP8266 and/or flash memory chip or your device no longer be accessible via OTA, and requiring re-flashing via a serial connection `(per discussion in #7307) <https://github.com/esp8266/Arduino/issues/7307#issuecomment-631523053>`__.
673+
672674
Update process - memory view
673675
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
674676

0 commit comments

Comments
 (0)