docs(ota): add note how to load old SDK's target AP information

This commit is contained in:
dongheng
2019-07-15 14:32:56 +08:00
parent 78cf0dda69
commit c71358cd20
3 changed files with 33 additions and 1 deletions

View File

@ -68,7 +68,7 @@ Connect your host PC and the ESP8266 to the same AP.
Step 2: Configure and Build
-----------------------------
Here, we use the `SP8266_RTOS_SDK/examples/system/ota <https://github.com/espressif/ESP8266_RTOS_SDK/tree/master/examples/system/ota>`_ example.
Here, we use the :example:`system/ota/native_ota/1MB_flash/new_to_new_with_old` if flash is 1MB or :example:`system/ota/native_ota/2+MB_flash/new_to_new_with_old` if flash is 2MB or larger.
Open a new terminal on your PC, set the following configurations, and then compile the example:
@ -119,6 +119,17 @@ Configure the flash size according to your actual development board's flash.
- HTTP Server Port: HTTP server port
- HTTP GET Filename: Using "ota.ota.bin" which is the target firmware of the example
5. Select connecting to the original AP
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If users want to connect to the original AP of old SDK, then configurate as following:
::
Example Configuration --->
[*] Connect to the original AP
5. Build the project
^^^^^^^^^^^^^^^^^^^^
@ -150,3 +161,10 @@ Note
- This "unpacking workflow" will only be executed when it is an old SDK firmware that upgrade to the new SDK firmware, for example, V2.0 upgrade to V3.1. After that, the FOTA in later versions (for example, V3.1 upgrade to later) will be the `normal FOTA workflow <https://github.com/espressif/ESP8266_RTOS_SDK/blob/master/examples/system/ota/README.md>`_.
Inheritance Data
================
Users can perfer to the source code :example_file:`system/ota/native_ota/2+MB_flash/new_to_new_with_old/main/ota_example_main.c` to check
how to load original AP's information.
See structure **old_sysconf** in the file of :component_file:`esp8266/include/internal/esp_system_internal.h` for the organization of this information.

View File

@ -101,6 +101,13 @@ Configurate the flash size:
(X) 1 MB
```
If you want to connect to the original AP of old SDK, then configurate as following:
```
Example Configuration --->
[*] Connect to the original AP
```
Save your changes, and type `make ota` to build the example to generate the real OTA binary firmware.
The name of final generated binary firmware is `ota.v2_to_v3.ota.bin` and the binary firmware locates at directory of `build`.

View File

@ -93,6 +93,13 @@ If you old SDK storing RF parameters is customized and want the new firmware to
[*] Load old RF Parameters
```
If you want to connect to the original AP of old SDK, then configurate as following:
```
Example Configuration --->
[*] Connect to the original AP
```
Save your changes, and type `make ota` to build the example to generate the real OTA binary firmware.
The name of final generated binary firmware is `ota.v2_to_v3.ota.bin` and the binary firmware locates at directory of `build`.