From 5e1b8a0b1018da41fb5befbdc6fc2faba1a8508f Mon Sep 17 00:00:00 2001
From: Dong Heng <dongheng@espressif.com>
Date: Thu, 18 Oct 2018 19:37:20 +0800
Subject: [PATCH] feat(ota): Add command to generate OTA bin and add ota
 example for 1MB flash

"$(PROJECT_NAME).app1.bin", "$(PROJECT_NAME).app2.bin" and "$(PROJECT_NAME).ota.bin" at "build" directory.

Only upload "$(PROJECT_NAME).ota.bin" to the server.

Select the target flash and input "make ota flash" or "make ota flash monitor".

Update the OTA README.md for 1 MB flash.
---
 components/app_update/esp_ota_ops.c           |   2 +-
 components/app_update/include/esp_ota_ops.h   |   3 +
 components/esp8266/Makefile.projbuild         |  48 ++
 components/esp8266/component.mk               |   6 +-
 components/esp8266/ld/esp8266.ld              |   2 +-
 components/esp8266/source/startup.c           |   3 +-
 components/esptool_py/Kconfig.projbuild       |   4 +-
 components/partition_table/Kconfig.projbuild  |   3 +-
 .../partitions_two_ota.1MB.csv                |   7 +
 examples/system/universal_ota/Makefile        |   9 +
 .../system/universal_ota/OTA_workflow.png     | Bin 0 -> 57443 bytes
 examples/system/universal_ota/README.md       | 126 +++++
 .../universal_ota/main/Kconfig.projbuild      |  40 ++
 .../system/universal_ota/main/component.mk    |   4 +
 .../universal_ota/main/ota_example_main.c     | 462 ++++++++++++++++++
 .../system/universal_ota/sdkconfig.defaults   |   4 +
 16 files changed, 717 insertions(+), 6 deletions(-)
 create mode 100644 components/partition_table/partitions_two_ota.1MB.csv
 create mode 100644 examples/system/universal_ota/Makefile
 create mode 100644 examples/system/universal_ota/OTA_workflow.png
 create mode 100644 examples/system/universal_ota/README.md
 create mode 100644 examples/system/universal_ota/main/Kconfig.projbuild
 create mode 100644 examples/system/universal_ota/main/component.mk
 create mode 100644 examples/system/universal_ota/main/ota_example_main.c
 create mode 100644 examples/system/universal_ota/sdkconfig.defaults

diff --git a/components/app_update/esp_ota_ops.c b/components/app_update/esp_ota_ops.c
index 9210e76f..7dfc4c06 100644
--- a/components/app_update/esp_ota_ops.c
+++ b/components/app_update/esp_ota_ops.c
@@ -286,7 +286,7 @@ static esp_err_t rewrite_ota_seq(uint32_t seq, uint8_t sec_id, const esp_partiti
     }
 }
 
-static uint8_t get_ota_partition_count(void)
+uint8_t get_ota_partition_count(void)
 {
     uint16_t ota_app_count = 0;
     while (esp_partition_find_first(ESP_PARTITION_TYPE_APP, ESP_PARTITION_SUBTYPE_APP_OTA_MIN + ota_app_count, NULL) != NULL) {
diff --git a/components/app_update/include/esp_ota_ops.h b/components/app_update/include/esp_ota_ops.h
index a089a92b..3d1155c3 100755
--- a/components/app_update/include/esp_ota_ops.h
+++ b/components/app_update/include/esp_ota_ops.h
@@ -69,6 +69,9 @@ typedef uint32_t esp_ota_handle_t;
  */
 esp_err_t esp_ota_begin(const esp_partition_t* partition, size_t image_size, esp_ota_handle_t* out_handle);
 
+
+uint8_t get_ota_partition_count(void);
+
 /**
  * @brief   Write OTA update data to partition
  *
diff --git a/components/esp8266/Makefile.projbuild b/components/esp8266/Makefile.projbuild
index 221482c4..073bed18 100644
--- a/components/esp8266/Makefile.projbuild
+++ b/components/esp8266/Makefile.projbuild
@@ -81,3 +81,51 @@ ifdef CONFIG_ESP_FILENAME_MACRO_NULL
 CFLAGS += -D__ESP_FILE__='"null"'
 CXXFLAGS += -D__ESP_FILE__='"null"'
 endif
+
+.PHONY: ota ota-clean
+
+ifeq ($(CONFIG_ESPTOOLPY_FLASHSIZE), "1MB")
+APP1_OFFSET ?= 0x10000
+APP1_SIZE ?= 0x70000
+APP2_OFFSET ?= 0x80000
+APP2_SIZE ?= 0x70000
+else
+APP1_OFFSET ?= CONFIG_APP_OFFSET
+APP1_SIZE ?= 0x100000
+endif
+
+RAW_BIN := ./build/$(PROJECT_NAME).bin
+OTA_BIN := ./build/$(PROJECT_NAME).ota.bin
+OTA1_BIN := ./build/$(PROJECT_NAME).app1.bin
+OTA2_BIN := ./build/$(PROJECT_NAME).app2.bin
+
+$(OTA2_BIN): all_binaries
+ifeq ($(CONFIG_ESPTOOLPY_FLASHSIZE), "1MB")
+	@rm -f ./build/esp8266/esp8266_out.ld
+	@make APP_OFFSET=$(APP2_OFFSET) APP_SIZE=$(APP2_SIZE) CFLAGS= CXXFLAGS=
+endif
+	@cp $(RAW_BIN) $(OTA2_BIN)
+	@echo [GEN] $(OTA2_BIN)
+
+$(OTA1_BIN): all_binaries
+ifeq ($(CONFIG_ESPTOOLPY_FLASHSIZE), "1MB")
+	@rm -f ./build/esp8266/esp8266_out.ld
+endif
+	@make APP_OFFSET=$(APP1_OFFSET) APP_SIZE=$(APP1_SIZE) CFLAGS= CXXFLAGS=
+	@cp $(RAW_BIN) $(OTA1_BIN)
+	@echo [GEN] $(OTA1_BIN)
+
+$(OTA_BIN): $(OTA1_BIN) $(OTA2_BIN)
+	@cp $(OTA1_BIN) $(OTA_BIN)
+ifeq ($(CONFIG_ESPTOOLPY_FLASHSIZE), "1MB")
+	@cat $(OTA2_BIN) >> $(OTA_BIN)
+endif
+	@cp $(OTA1_BIN) $(RAW_BIN)
+	@echo [GEN] $(OTA_BIN)
+
+ota: $(OTA_BIN)
+
+ota-clean:
+	@rm -f $(OTA_BIN) $(OTA1_BIN) $(OTA2_BIN)
+
+clean: ota-clean
diff --git a/components/esp8266/component.mk b/components/esp8266/component.mk
index 1d7a4008..926161db 100644
--- a/components/esp8266/component.mk
+++ b/components/esp8266/component.mk
@@ -41,8 +41,12 @@ COMPONENT_ADD_LINKER_DEPS := $(ALL_LIB_FILES) $(addprefix ld/,$(LINKER_SCRIPTS))
 # saves us from having to add the target to a Makefile.projbuild
 $(COMPONENT_LIBRARY): esp8266_out.ld esp8266_common_out.ld
 
+APP_OFFSET ?= $(CONFIG_APP_OFFSET)
+APP_SIZE ?= 0x100000
+OUTLD_CFLAGS := -DAPP_OFFSET=$(APP_OFFSET) -DAPP_SIZE=$(APP_SIZE)
+
 esp8266_out.ld: $(COMPONENT_PATH)/ld/esp8266.ld ../include/sdkconfig.h
-	$(CC) -I ../include -C -P -x c -E $< -o $@
+	$(CC) $(OUTLD_CFLAGS) -I ../include -C -P -x c -E $< -o $@
 
 esp8266_common_out.ld: $(COMPONENT_PATH)/ld/esp8266.common.ld ../include/sdkconfig.h
 	$(CC) -I ../include -C -P -x c -E $< -o $@
diff --git a/components/esp8266/ld/esp8266.ld b/components/esp8266/ld/esp8266.ld
index cfa0d01b..cd950b98 100644
--- a/components/esp8266/ld/esp8266.ld
+++ b/components/esp8266/ld/esp8266.ld
@@ -27,7 +27,7 @@ MEMORY
   iram1_0_seg  :    org = 0x40100000, len = CONFIG_SOC_IRAM_SIZE
 
   /* It is actually mapped to flash. */
-  irom0_0_seg  :    org = 0x40200010 + CONFIG_PARTITION_TABLE_CUSTOM_APP_BIN_OFFSET, len = 0x100000 - 0x10 - CONFIG_PARTITION_TABLE_CUSTOM_APP_BIN_OFFSET
+  irom0_0_seg  :    org = 0x40200010 + APP_OFFSET, len = APP_SIZE - 0x10 - APP_OFFSET
 
   /* RTC memory, persists over deep sleep. */
   rtc_seg      :    org = 0x60001200, len = 0x200
diff --git a/components/esp8266/source/startup.c b/components/esp8266/source/startup.c
index 9b48122e..a9be9235 100644
--- a/components/esp8266/source/startup.c
+++ b/components/esp8266/source/startup.c
@@ -31,6 +31,7 @@
 #include "internal/esp_wifi_internal.h"
 
 #define FLASH_MAP_ADDR 0x40200000
+#define FLASH_MAP_SIZE 0x00100000
 
 extern void chip_boot(size_t start_addr);
 extern int rtc_init(void);
@@ -84,7 +85,7 @@ void call_user_start(size_t start_addr)
 
     extern int _bss_start, _bss_end;
 
-    esp_image_header_t *head = (esp_image_header_t *)(FLASH_MAP_ADDR + CONFIG_PARTITION_TABLE_CUSTOM_APP_BIN_OFFSET);
+    esp_image_header_t *head = (esp_image_header_t *)(FLASH_MAP_ADDR + (start_addr & (FLASH_MAP_SIZE - 1)));
     esp_image_segment_header_t *segment = (esp_image_segment_header_t *)((uintptr_t)head + sizeof(esp_image_header_t));
 
     for (i = 0; i < 3; i++) {
diff --git a/components/esptool_py/Kconfig.projbuild b/components/esptool_py/Kconfig.projbuild
index b735b469..7b29f4e3 100644
--- a/components/esptool_py/Kconfig.projbuild
+++ b/components/esptool_py/Kconfig.projbuild
@@ -102,7 +102,8 @@ choice ESPTOOLPY_FLASHSIZE
 	default ESPTOOLPY_FLASHSIZE_2MB
 	help
 		SPI flash size, in megabytes
-
+config ESPTOOLPY_FLASHSIZE_1MB
+	bool "1 MB"
 config ESPTOOLPY_FLASHSIZE_2MB
 	bool "2 MB"
 config ESPTOOLPY_FLASHSIZE_4MB
@@ -115,6 +116,7 @@ endchoice
 
 config ESPTOOLPY_FLASHSIZE
 	string
+	default "1MB" if ESPTOOLPY_FLASHSIZE_1MB
 	default "2MB" if ESPTOOLPY_FLASHSIZE_2MB
 	default "4MB" if ESPTOOLPY_FLASHSIZE_4MB
 	default "8MB" if ESPTOOLPY_FLASHSIZE_8MB
diff --git a/components/partition_table/Kconfig.projbuild b/components/partition_table/Kconfig.projbuild
index 61c2b238..cbebe40b 100644
--- a/components/partition_table/Kconfig.projbuild
+++ b/components/partition_table/Kconfig.projbuild
@@ -53,7 +53,8 @@ config PARTITION_TABLE_FILENAME
        string
        default partitions_singleapp.csv if PARTITION_TABLE_SINGLE_APP && !ESP32_ENABLE_COREDUMP_TO_FLASH
        default partitions_singleapp_coredump.csv if PARTITION_TABLE_SINGLE_APP && ESP32_ENABLE_COREDUMP_TO_FLASH
-       default partitions_two_ota.csv if PARTITION_TABLE_TWO_OTA && !ESP32_ENABLE_COREDUMP_TO_FLASH
+       default partitions_two_ota.csv if PARTITION_TABLE_TWO_OTA && !ESP32_ENABLE_COREDUMP_TO_FLASH && !ESPTOOLPY_FLASHSIZE_1MB
+       default partitions_two_ota.1MB.csv if PARTITION_TABLE_TWO_OTA && !ESP32_ENABLE_COREDUMP_TO_FLASH && ESPTOOLPY_FLASHSIZE_1MB
        default partitions_two_ota_coredump.csv if PARTITION_TABLE_TWO_OTA && ESP32_ENABLE_COREDUMP_TO_FLASH
        default PARTITION_TABLE_CUSTOM_FILENAME if PARTITION_TABLE_CUSTOM
 
diff --git a/components/partition_table/partitions_two_ota.1MB.csv b/components/partition_table/partitions_two_ota.1MB.csv
new file mode 100644
index 00000000..d62d5464
--- /dev/null
+++ b/components/partition_table/partitions_two_ota.1MB.csv
@@ -0,0 +1,7 @@
+# Name,   Type, SubType, Offset,   Size, Flags
+# Note: if you change the phy_init or app partition offset, make sure to change the offset in Kconfig.projbuild
+nvs,      data, nvs,     0x9000,  0x4000
+otadata,  data, ota,     0xd000,  0x2000
+phy_init, data, phy,     0xf000,  0x1000
+ota_0,    0,    ota_0,   0x10000, 0x70000
+ota_1,    0,    ota_1,   0x80000, 0x70000
diff --git a/examples/system/universal_ota/Makefile b/examples/system/universal_ota/Makefile
new file mode 100644
index 00000000..7ffb1023
--- /dev/null
+++ b/examples/system/universal_ota/Makefile
@@ -0,0 +1,9 @@
+#
+# This is a project Makefile. It is assumed the directory this Makefile resides in is a
+# project subdirectory.
+#
+
+PROJECT_NAME := ota
+
+include $(IDF_PATH)/make/project.mk
+
diff --git a/examples/system/universal_ota/OTA_workflow.png b/examples/system/universal_ota/OTA_workflow.png
new file mode 100644
index 0000000000000000000000000000000000000000..5fd4c3e91d728c707c29b9c42a62be3926f7bdf5
GIT binary patch
literal 57443
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

literal 0
HcmV?d00001

diff --git a/examples/system/universal_ota/README.md b/examples/system/universal_ota/README.md
new file mode 100644
index 00000000..759c7f38
--- /dev/null
+++ b/examples/system/universal_ota/README.md
@@ -0,0 +1,126 @@
+
+# Simple OTA Demo
+
+This example demonstrates a working OTA (over the air) firmware update workflow.
+
+This example is a *simplified demonstration*, for production firmware updates you should use a secure protocol such as HTTPS.
+
+---
+
+# Aim
+
+An app running on ESP8266 can upgrade itself by downloading a new app "image" binary file, and storing it in flash.
+
+In this example, the ESP8266 has 2 images in flash: OTA_0, OTA_1. Each of these is a self-contained partition. The number of OTA image partition is determined by the partition table layout.
+
+Flashing the example over serial with "make flash" updates the OTA_0 app image. On first boot, the bootloader loads this OTA_0 app image which then performs an OTA update (triggered in the example code). The update downloads a new image from an http server and saves it into the OTA_1 partition. At this point the example code updates the ota_data partition to indicate the new app partition, and reboots. The bootloader reads ota_data, determines the new OTA image has been selected, and runs it.
+
+
+# Workflow
+
+The OTA_workflow.png diagram demonstrates the overall workflow:
+
+![OTA Workflow diagram](OTA_workflow.png)
+
+## Step 1: Connect to AP
+
+Connect your host PC to the same AP that you will use for the ESP8266.
+
+## Step 2: Run HTTP Server
+
+Python has a built-in HTTP server that can be used for example purposes.
+
+For our upgrade example OTA file, we're going to use the `get-started/project_template` example.
+
+Open a new terminal to run the HTTP server, then run these commands to build the example and start the server, if your board's flash size is "1 MB", you should firstly configure flash size to be "1 MB"(default is "2 MB") at "menuconfig" and then build project:
+
+Configure 1MB flash if need:
+
+```
+Serial flasher config  --->
+    Flash size (2 MB)  --->
+        (X) 1 MB
+```
+
+Build project:
+
+```
+cd $IDF_PATH/examples/get-started/project_template
+make ota
+```
+
+Start http server at the directory of "build":
+
+```
+cd build
+python -m SimpleHTTPServer 8070
+```
+
+While the server is running, the contents of the build directory can be browsed at http://localhost:8070/
+
+NB: On some systems, the command may be `python2 -m SimpleHTTPServer`.
+
+NB: Command "make ota" will generate 3 binaries: "xxx(project name).app1.bin", "xxx(project name).app2.bin" and "xxx(project name).ota.bin". You should only upload the "xxx(project name).ota.bin" to your OTA server and let the app download it by the example.
+
+NB: "xxx.app1.bin" is for downloading to OTA_0 partition, and "xxx.app2.bin" is for downloading to OTA_1 partition. If your board's flash size is larger than "1 MB", then "xxx.app1.bin" = "xxx.app2.bin" = "xxx.ota.bin". Otherwise "xxx.ota.bin" = "xxx.app1.bin" + "xxx.app2.bin". So the flash size configuration is very important. The example will select the binary it needs and store it to flash.
+
+If you have any firewall software running that will block incoming access to port 8070, configure it to allow access while running the example.
+
+## Step 3: Build OTA Example
+
+Change back to the OTA example directory, and type `make menuconfig` to configure the OTA example. Under the "Example Configuration" submenu, fill in the following details:
+
+* WiFi SSID & Password
+* IP address of your host PC as "HTTP Server"
+* HTTP Port number (if using the Python HTTP server above, the default is correct)
+
+If serving the "project_template" example, you can leave the default filename as-is.
+
+Configure 1MB flash if need:
+
+```
+Serial flasher config  --->
+    Flash size (2 MB)  --->
+        (X) 1 MB
+```
+
+Save your changes, and type `make` to build the example.
+
+## Step 4: Flash OTA Example
+
+When flashing, use the `erase_flash` target first to erase the entire flash (this deletes any leftover data in the ota_data partition). Then flash the factory image over serial:
+
+```
+make erase_flash flash
+```
+
+(The `make erase_flash flash` means "erase everything, then flash". `make flash` only erases the parts of flash which are being rewritten.)
+
+## Step 5: Run the OTA Example
+
+When the example starts up, it will print "ota: Starting OTA example..." then:
+
+1. Connect to the AP with configured SSID and password.
+2. Connect to the HTTP server and download the new image.
+3. Write the image to flash, and configure the next boot from this image.
+4. Reboot
+
+# Troubleshooting
+
+* Check your PC can ping the ESP8266 at its IP, and that the IP, AP and other configuration settings are correct in menuconfig.
+* Check if any firewall software is preventing incoming connections on the PC.
+* Check you can see the configured file (default project_template.ota.bin) if you browse the file listing at http://127.0.0.1/
+* If you have another PC or a phone, try viewing the file listing from the separate host.
+
+## Error "ota_begin error err=0x104"
+
+If you see this error then check that the configured (and actual) flash size is large enough for the partitions in the partition table. The default "two OTA slots" partition table only works with 4MB flash size. To use OTA with smaller flash sizes, create a custom partition table CSV (look in components/partition_table) and configure it in menuconfig.
+
+If changing partition layout, it is usually wise to run "make erase_flash" between steps.
+
+## Production Implementation
+
+If scaling this example for production use, please consider:
+
+* Using an encrypted communications channel such as HTTPS.
+* Dealing with timeouts or WiFi disconnections while flashing.
diff --git a/examples/system/universal_ota/main/Kconfig.projbuild b/examples/system/universal_ota/main/Kconfig.projbuild
new file mode 100644
index 00000000..c5a0b69f
--- /dev/null
+++ b/examples/system/universal_ota/main/Kconfig.projbuild
@@ -0,0 +1,40 @@
+menu "Example Configuration"
+
+config WIFI_SSID
+    string "WiFi SSID"
+	default "myssid"
+	help
+		SSID (network name) for the example to connect to.
+
+config WIFI_PASSWORD
+    string "WiFi Password"
+	default "myssid"
+	help
+		WiFi password (WPA or WPA2) for the example to use.
+
+		Can be left blank if the network has no security set.
+
+config SERVER_IP
+    string "HTTP Server IP"
+	default "192.168.0.3"
+	help
+		HTTP Server IP to download the image file from.
+
+		See example README.md for details.
+
+config SERVER_PORT
+	string "HTTP Server Port"
+	default "8070"
+	help
+		HTTP Server port to connect to.
+		Should be chosen not to conflict with any other port used
+		on the system.
+
+config EXAMPLE_FILENAME
+	string "HTTP GET Filename"
+	default "/project_template.ota.bin"
+	help
+		Filename of the app image file to download for
+		the OTA update.
+
+endmenu
diff --git a/examples/system/universal_ota/main/component.mk b/examples/system/universal_ota/main/component.mk
new file mode 100644
index 00000000..a98f634e
--- /dev/null
+++ b/examples/system/universal_ota/main/component.mk
@@ -0,0 +1,4 @@
+#
+# "main" pseudo-component makefile.
+#
+# (Uses default behaviour of compiling all source files in directory, adding 'include' to include path.)
diff --git a/examples/system/universal_ota/main/ota_example_main.c b/examples/system/universal_ota/main/ota_example_main.c
new file mode 100644
index 00000000..b5137287
--- /dev/null
+++ b/examples/system/universal_ota/main/ota_example_main.c
@@ -0,0 +1,462 @@
+/* OTA example
+
+   This example code is in the Public Domain (or CC0 licensed, at your option.)
+
+   Unless required by applicable law or agreed to in writing, this
+   software is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+   CONDITIONS OF ANY KIND, either express or implied.
+*/
+#include <stdlib.h>
+#include <string.h>
+#include <sys/socket.h>
+#include <netdb.h>
+
+#include "freertos/FreeRTOS.h"
+#include "freertos/task.h"
+#include "freertos/event_groups.h"
+
+#include "esp_system.h"
+#include "esp_wifi.h"
+#include "esp_event_loop.h"
+#include "esp_log.h"
+#include "esp_ota_ops.h"
+
+#include "nvs.h"
+#include "nvs_flash.h"
+
+#define EXAMPLE_WIFI_SSID CONFIG_WIFI_SSID
+#define EXAMPLE_WIFI_PASS CONFIG_WIFI_PASSWORD
+#define EXAMPLE_SERVER_IP   CONFIG_SERVER_IP
+#define EXAMPLE_SERVER_PORT CONFIG_SERVER_PORT
+#define EXAMPLE_FILENAME CONFIG_EXAMPLE_FILENAME
+#define BUFFSIZE 1500
+#define TEXT_BUFFSIZE 1024
+
+typedef enum esp_ota_firm_state {
+    ESP_OTA_INIT = 0,
+    ESP_OTA_PREPARE,
+    ESP_OTA_START,
+    ESP_OTA_RECVED,
+    ESP_OTA_FINISH,
+} esp_ota_firm_state_t;
+
+typedef struct esp_ota_firm {
+    uint8_t             ota_num;
+    uint8_t             update_ota_num;
+
+    esp_ota_firm_state_t    state;
+
+    size_t              content_len;
+
+    size_t              read_bytes;
+    size_t              write_bytes;
+
+    size_t              ota_size;
+    size_t              ota_offset;
+
+    const char          *buf;
+    size_t              bytes;
+} esp_ota_firm_t;
+
+static const char *TAG = "ota";
+/*an ota data write buffer ready to write to the flash*/
+static char ota_write_data[BUFFSIZE + 1] = { 0 };
+/*an packet receive buffer*/
+static char text[BUFFSIZE + 1] = { 0 };
+/* an image total length*/
+static int binary_file_length = 0;
+/*socket id*/
+static int socket_id = -1;
+
+/* FreeRTOS event group to signal when we are connected & ready to make a request */
+static EventGroupHandle_t wifi_event_group;
+
+/* The event group allows multiple bits for each event,
+   but we only care about one event - are we connected
+   to the AP with an IP? */
+const int CONNECTED_BIT = BIT0;
+
+static esp_err_t event_handler(void *ctx, system_event_t *event)
+{
+    switch (event->event_id) {
+    case SYSTEM_EVENT_STA_START:
+        esp_wifi_connect();
+        break;
+    case SYSTEM_EVENT_STA_GOT_IP:
+        xEventGroupSetBits(wifi_event_group, CONNECTED_BIT);
+        break;
+    case SYSTEM_EVENT_STA_DISCONNECTED:
+        /* This is a workaround as ESP32 WiFi libs don't currently
+           auto-reassociate. */
+        esp_wifi_connect();
+        xEventGroupClearBits(wifi_event_group, CONNECTED_BIT);
+        break;
+    default:
+        break;
+    }
+    return ESP_OK;
+}
+
+static void initialise_wifi(void)
+{
+    tcpip_adapter_init();
+    wifi_event_group = xEventGroupCreate();
+    ESP_ERROR_CHECK( esp_event_loop_init(event_handler, NULL) );
+    wifi_init_config_t cfg = WIFI_INIT_CONFIG_DEFAULT();
+    ESP_ERROR_CHECK( esp_wifi_init(&cfg) );
+    ESP_ERROR_CHECK( esp_wifi_set_storage(WIFI_STORAGE_RAM) );
+    wifi_config_t wifi_config = {
+        .sta = {
+            .ssid = EXAMPLE_WIFI_SSID,
+            .password = EXAMPLE_WIFI_PASS,
+        },
+    };
+    ESP_LOGI(TAG, "Setting WiFi configuration SSID %s...", wifi_config.sta.ssid);
+    ESP_ERROR_CHECK( esp_wifi_set_mode(WIFI_MODE_STA) );
+    ESP_ERROR_CHECK( esp_wifi_set_config(ESP_IF_WIFI_STA, &wifi_config) );
+    ESP_ERROR_CHECK( esp_wifi_start() );
+}
+
+/*read buffer by byte still delim ,return read bytes counts*/
+static int read_until(const char *buffer, char delim, int len)
+{
+//  /*TODO: delim check,buffer check,further: do an buffer length limited*/
+    int i = 0;
+    while (buffer[i] != delim && i < len) {
+        ++i;
+    }
+    return i + 1;
+}
+
+static bool connect_to_http_server()
+{
+    ESP_LOGI(TAG, "Server IP: %s Server Port:%s", EXAMPLE_SERVER_IP, EXAMPLE_SERVER_PORT);
+
+    int  http_connect_flag = -1;
+    struct sockaddr_in sock_info;
+
+    socket_id = socket(AF_INET, SOCK_STREAM, 0);
+    if (socket_id == -1) {
+        ESP_LOGE(TAG, "Create socket failed!");
+        return false;
+    }
+
+    // set connect info
+    memset(&sock_info, 0, sizeof(struct sockaddr_in));
+    sock_info.sin_family = AF_INET;
+    sock_info.sin_addr.s_addr = inet_addr(EXAMPLE_SERVER_IP);
+    sock_info.sin_port = htons(atoi(EXAMPLE_SERVER_PORT));
+
+    // connect to http server
+    http_connect_flag = connect(socket_id, (struct sockaddr *)&sock_info, sizeof(sock_info));
+    if (http_connect_flag == -1) {
+        ESP_LOGE(TAG, "Connect to server failed! errno=%d", errno);
+        close(socket_id);
+        return false;
+    } else {
+        ESP_LOGI(TAG, "Connected to server");
+        return true;
+    }
+    return false;
+}
+
+static void __attribute__((noreturn)) task_fatal_error()
+{
+    ESP_LOGE(TAG, "Exiting task due to fatal error...");
+    close(socket_id);
+    (void)vTaskDelete(NULL);
+
+    while (1) {
+        ;
+    }
+}
+
+bool _esp_ota_firm_parse_http(esp_ota_firm_t *ota_firm, const char *text, size_t total_len, size_t *parse_len)
+{
+    /* i means current position */
+    int i = 0, i_read_len = 0;
+    char *ptr = NULL, *ptr2 = NULL;
+    char length_str[32];
+
+    while (text[i] != 0 && i < total_len) {
+        if (ota_firm->content_len == 0 && (ptr = (char *)strstr(text, "Content-Length")) != NULL) {
+            ptr += 16;
+            ptr2 = (char *)strstr(ptr, "\r\n");
+            memset(length_str, 0, sizeof(length_str));
+            memcpy(length_str, ptr, ptr2 - ptr);
+            ota_firm->content_len = atoi(length_str);
+#ifdef CONFIG_ESPTOOLPY_FLASHSIZE_1MB
+            ota_firm->ota_size = ota_firm->content_len / ota_firm->ota_num;
+            ota_firm->ota_offset = ota_firm->ota_size * ota_firm->update_ota_num;
+#else
+            ota_firm->ota_size = ota_firm->content_len;
+            ota_firm->ota_offset = 0;
+#endif
+            ESP_LOGI(TAG, "parse Content-Length:%d, ota_size %d", ota_firm->content_len, ota_firm->ota_size);
+        }
+
+        i_read_len = read_until(&text[i], '\n', total_len - i);
+
+        if (i_read_len > total_len - i) {
+            ESP_LOGE(TAG, "recv malformed http header");
+            task_fatal_error();
+        }
+
+        // if resolve \r\n line, http header is finished
+        if (i_read_len == 2) {
+            if (ota_firm->content_len == 0) {
+                ESP_LOGE(TAG, "did not parse Content-Length item");
+                task_fatal_error();
+            }
+
+            *parse_len = i + 2;
+
+            return true;
+        }
+
+        i += i_read_len;
+    }
+
+    return false;
+}
+
+static size_t esp_ota_firm_do_parse_msg(esp_ota_firm_t *ota_firm, const char *in_buf, size_t in_len)
+{
+    size_t tmp;
+    size_t parsed_bytes = in_len; 
+
+    switch (ota_firm->state) {
+        case ESP_OTA_INIT:
+            if (_esp_ota_firm_parse_http(ota_firm, in_buf, in_len, &tmp)) {
+                ota_firm->state = ESP_OTA_PREPARE;
+                ESP_LOGD(TAG, "Http parse %d bytes", tmp);
+                parsed_bytes = tmp;
+            }
+            break;
+        case ESP_OTA_PREPARE:
+            ota_firm->read_bytes += in_len;
+
+            if (ota_firm->read_bytes >= ota_firm->ota_offset) {
+                ota_firm->buf = &in_buf[in_len - (ota_firm->read_bytes - ota_firm->ota_offset)];
+                ota_firm->bytes = ota_firm->read_bytes - ota_firm->ota_offset;
+                ota_firm->write_bytes += ota_firm->read_bytes - ota_firm->ota_offset;
+                ota_firm->state = ESP_OTA_START;
+                ESP_LOGD(TAG, "Receive %d bytes and start to update", ota_firm->read_bytes);
+                ESP_LOGD(TAG, "Write %d total %d", ota_firm->bytes, ota_firm->write_bytes);
+            }
+
+            break;
+        case ESP_OTA_START:
+            if (ota_firm->write_bytes + in_len > ota_firm->ota_size) {
+                ota_firm->bytes = ota_firm->ota_size - ota_firm->write_bytes;
+                ota_firm->state = ESP_OTA_RECVED;
+            } else
+                ota_firm->bytes = in_len;
+
+            ota_firm->buf = in_buf;
+
+            ota_firm->write_bytes += ota_firm->bytes;
+
+            ESP_LOGD(TAG, "Write %d total %d", ota_firm->bytes, ota_firm->write_bytes);
+
+            break;
+        case ESP_OTA_RECVED:
+            parsed_bytes = 0;
+            ota_firm->state = ESP_OTA_FINISH;
+            break;
+        default:
+            parsed_bytes = 0;
+            ESP_LOGD(TAG, "State is %d", ota_firm->state);
+            break;
+    }
+
+    return parsed_bytes;
+}
+
+static void esp_ota_firm_parse_msg(esp_ota_firm_t *ota_firm, const char *in_buf, size_t in_len)
+{
+    size_t parse_bytes = 0;
+
+    ESP_LOGD(TAG, "Input %d bytes", in_len);
+
+    do {
+        size_t bytes = esp_ota_firm_do_parse_msg(ota_firm, in_buf + parse_bytes, in_len - parse_bytes);
+        ESP_LOGD(TAG, "Parse %d bytes", bytes);
+        if (bytes)
+            parse_bytes += bytes;
+    } while (parse_bytes != in_len);
+}
+
+static inline int esp_ota_firm_is_finished(esp_ota_firm_t *ota_firm)
+{
+    return (ota_firm->state == ESP_OTA_FINISH || ota_firm->state == ESP_OTA_RECVED);
+}
+
+static inline int esp_ota_firm_can_write(esp_ota_firm_t *ota_firm)
+{
+    return (ota_firm->state == ESP_OTA_START || ota_firm->state == ESP_OTA_RECVED);
+}
+
+static inline const char* esp_ota_firm_get_write_buf(esp_ota_firm_t *ota_firm)
+{
+    return ota_firm->buf;
+}
+
+static inline size_t esp_ota_firm_get_write_bytes(esp_ota_firm_t *ota_firm)
+{
+    return ota_firm->bytes;
+}
+
+static void esp_ota_firm_init(esp_ota_firm_t *ota_firm, const esp_partition_t *update_partition)
+{
+    memset(ota_firm, 0, sizeof(esp_ota_firm_t));
+    ota_firm->state = ESP_OTA_INIT;
+    ota_firm->ota_num = get_ota_partition_count();
+    ota_firm->update_ota_num = update_partition->subtype - ESP_PARTITION_SUBTYPE_APP_OTA_0;
+
+    ESP_LOGI(TAG, "Totoal OTA number %d update to %d part", ota_firm->ota_num, ota_firm->update_ota_num);
+
+}
+
+static void ota_example_task(void *pvParameter)
+{
+    esp_err_t err;
+    /* update handle : set by esp_ota_begin(), must be freed via esp_ota_end() */
+    esp_ota_handle_t update_handle = 0 ;
+    const esp_partition_t *update_partition = NULL;
+
+    ESP_LOGI(TAG, "Starting OTA example... @ %p flash %s", ota_example_task, CONFIG_ESPTOOLPY_FLASHSIZE);
+
+    const esp_partition_t *configured = esp_ota_get_boot_partition();
+    const esp_partition_t *running = esp_ota_get_running_partition();
+
+    if (configured != running) {
+        ESP_LOGW(TAG, "Configured OTA boot partition at offset 0x%08x, but running from offset 0x%08x",
+                 configured->address, running->address);
+        ESP_LOGW(TAG, "(This can happen if either the OTA boot data or preferred boot image become corrupted somehow.)");
+    }
+    ESP_LOGI(TAG, "Running partition type %d subtype %d (offset 0x%08x)",
+             running->type, running->subtype, running->address);
+
+    /* Wait for the callback to set the CONNECTED_BIT in the
+       event group.
+    */
+    xEventGroupWaitBits(wifi_event_group, CONNECTED_BIT,
+                        false, true, portMAX_DELAY);
+    ESP_LOGI(TAG, "Connect to Wifi ! Start to Connect to Server....");
+
+    /*connect to http server*/
+    if (connect_to_http_server()) {
+        ESP_LOGI(TAG, "Connected to http server");
+    } else {
+        ESP_LOGE(TAG, "Connect to http server failed!");
+        task_fatal_error();
+    }
+
+    /*send GET request to http server*/
+    const char *GET_FORMAT =
+        "GET %s HTTP/1.0\r\n"
+        "Host: %s:%s\r\n"
+        "User-Agent: esp-idf/1.0 esp32\r\n\r\n";
+
+    char *http_request = NULL;
+    int get_len = asprintf(&http_request, GET_FORMAT, EXAMPLE_FILENAME, EXAMPLE_SERVER_IP, EXAMPLE_SERVER_PORT);
+    if (get_len < 0) {
+        ESP_LOGE(TAG, "Failed to allocate memory for GET request buffer");
+        task_fatal_error();
+    }
+    int res = send(socket_id, http_request, get_len, 0);
+    free(http_request);
+
+    if (res < 0) {
+        ESP_LOGE(TAG, "Send GET request to server failed");
+        task_fatal_error();
+    } else {
+        ESP_LOGI(TAG, "Send GET request to server succeeded");
+    }
+
+    update_partition = esp_ota_get_next_update_partition(NULL);
+    ESP_LOGI(TAG, "Writing to partition subtype %d at offset 0x%x",
+             update_partition->subtype, update_partition->address);
+    assert(update_partition != NULL);
+
+    err = esp_ota_begin(update_partition, OTA_SIZE_UNKNOWN, &update_handle);
+    if (err != ESP_OK) {
+        ESP_LOGE(TAG, "esp_ota_begin failed, error=%d", err);
+        task_fatal_error();
+    }
+    ESP_LOGI(TAG, "esp_ota_begin succeeded");
+
+    bool flag = true;
+    esp_ota_firm_t ota_firm;
+
+    esp_ota_firm_init(&ota_firm, update_partition);
+
+    /*deal with all receive packet*/
+    while (flag) {
+        memset(text, 0, TEXT_BUFFSIZE);
+        memset(ota_write_data, 0, BUFFSIZE);
+        int buff_len = recv(socket_id, text, TEXT_BUFFSIZE, 0);
+        if (buff_len < 0) { /*receive error*/
+            ESP_LOGE(TAG, "Error: receive data error! errno=%d", errno);
+            task_fatal_error();
+        } else if (buff_len > 0) { /*deal with response body*/
+            esp_ota_firm_parse_msg(&ota_firm, text, buff_len);
+
+            if (!esp_ota_firm_can_write(&ota_firm))
+                continue;
+
+            memcpy(ota_write_data, esp_ota_firm_get_write_buf(&ota_firm), esp_ota_firm_get_write_bytes(&ota_firm));
+            buff_len = esp_ota_firm_get_write_bytes(&ota_firm);
+
+            err = esp_ota_write( update_handle, (const void *)ota_write_data, buff_len);
+            if (err != ESP_OK) {
+                ESP_LOGE(TAG, "Error: esp_ota_write failed! err=0x%x", err);
+                task_fatal_error();
+            }
+            binary_file_length += buff_len;
+            ESP_LOGI(TAG, "Have written image length %d", binary_file_length);
+        } else if (buff_len == 0) {  /*packet over*/
+            flag = false;
+            ESP_LOGI(TAG, "Connection closed, all packets received");
+            close(socket_id);
+        } else {
+            ESP_LOGE(TAG, "Unexpected recv result");
+        }
+
+        if (esp_ota_firm_is_finished(&ota_firm))
+            break;
+    }
+
+    ESP_LOGI(TAG, "Total Write binary data length : %d", binary_file_length);
+
+    if (esp_ota_end(update_handle) != ESP_OK) {
+        ESP_LOGE(TAG, "esp_ota_end failed!");
+        task_fatal_error();
+    }
+    err = esp_ota_set_boot_partition(update_partition);
+    if (err != ESP_OK) {
+        ESP_LOGE(TAG, "esp_ota_set_boot_partition failed! err=0x%x", err);
+        task_fatal_error();
+    }
+    ESP_LOGI(TAG, "Prepare to restart system!");
+    esp_restart();
+    return ;
+}
+
+void app_main()
+{
+    // Initialize NVS.
+    esp_err_t err = nvs_flash_init();
+    if (err == ESP_ERR_NVS_NO_FREE_PAGES) {
+        // OTA app partition table has a smaller NVS partition size than the non-OTA
+        // partition table. This size mismatch may cause NVS initialization to fail.
+        // If this happens, we erase NVS partition and initialize NVS again.
+        ESP_ERROR_CHECK(nvs_flash_erase());
+        err = nvs_flash_init();
+    }
+    ESP_ERROR_CHECK( err );
+
+    initialise_wifi();
+    xTaskCreate(&ota_example_task, "ota_example_task", 8192, NULL, 5, NULL);
+}
diff --git a/examples/system/universal_ota/sdkconfig.defaults b/examples/system/universal_ota/sdkconfig.defaults
new file mode 100644
index 00000000..50f320c6
--- /dev/null
+++ b/examples/system/universal_ota/sdkconfig.defaults
@@ -0,0 +1,4 @@
+# Default sdkconfig parameters to use the ESP8266 OTA
+CONFIG_ESPTOOLPY_FLASHSIZE_2MB=y
+CONFIG_PARTITION_TABLE_TWO_OTA=y
+CONFIG_LWIP_SOCKET_MULTITHREAD=