diff --git a/docs/sbs/en/QuecPythonPlatform/FOTA_binary_upgrade.md b/docs/sbs/en/QuecPythonPlatform/FOTA_ASR.md similarity index 89% rename from docs/sbs/en/QuecPythonPlatform/FOTA_binary_upgrade.md rename to docs/sbs/en/QuecPythonPlatform/FOTA_ASR.md index c4df5777fae2ff19aa72d35ed4471dce03da5162..d33ff524b632296cefaf44a0c19a7d6d5adaf954 100644 --- a/docs/sbs/en/QuecPythonPlatform/FOTA_binary_upgrade.md +++ b/docs/sbs/en/QuecPythonPlatform/FOTA_ASR.md @@ -20,7 +20,7 @@ In this document, it mainly introduces how to upgrade FW based on EC600S-CNLA mo Copy the *system.img* from the new and old zips separately, the rename them as *system_old.img* and *system_new.img* individually. Please check the next figure: -![image-20210929155209368](media\image-20210929155209368.png) +![FOTA_ASR_01](media\FOTA_ASR_01.png) @@ -48,11 +48,11 @@ Number_of_Images = 1 Duplicate the *system_old .img* and *system_new.img* into the root directory of FOTA tool, then execute commands as described below: *adiff.exe -l fp system_old.img system_new.img FotaFile.bin*. -![image-20210929155313692](media\image-20210929155313692.png) +![FOTA_ASR_02](media\FOTA_ASR_02.png) Result after executing -![image-20210929155327009](media\image-20210929155327009.png) +![FOTA_ASR_04](media\FOTA_ASR_04.png) The *FoteFile.bin* file will be generated for the module to download and upgrade. @@ -92,7 +92,7 @@ run() Download the ***.py*** file and run on module -![image-20210929155530265](media\image-20210929155530265.png) +![FOTA_ASR_03](media\FOTA_ASR_03.png) diff --git a/docs/sbs/en/QuecPythonPlatform/FOTA_RDA.md b/docs/sbs/en/QuecPythonPlatform/FOTA_RDA.md new file mode 100644 index 0000000000000000000000000000000000000000..f25893d844b5db2f8e3fb246ed01cade43ec4d94 --- /dev/null +++ b/docs/sbs/en/QuecPythonPlatform/FOTA_RDA.md @@ -0,0 +1,92 @@ +## About document + +**Revision history** + +| Version | Date | Author | Description | +| ------- | ---------- | ------- | --------------- | +| 1.0 | 2021-11-25 | Chic.Ye | Initial version | + +## RDA FW Upgrade + +In this document, it mainly introduces how to upgrade FW via FOTA based on EC600U. + +Applicable modules: EC600U_CNLB、CNLC and EUAB + +## Operation procedure on EC600U_CNLB, CNLC and EUAB + +1. Extract upgrade file + +Duplicate the **.pac** file from the "old" and "new" FW packages, then rename them as **aa.pac** and **bb.pac** separately. + +![FOTA_RDA_01](media\FOTA_RDA_01.png) + + + +2. Make **.bin** file + +Duplicate **aa.pac** and **bb.pac** into the root directory of FOTA, after that, execute AT commands as described below. + +`dtools.exe fotacreate2 --pac aa.pac,bb.pac,setting\fota8910.xml output.pack -d v` + +![FOTA_RDA_02](media\FOTA_RDA_02.png) + +3. Please check the result as described below. + +![FOTA_RDA_04](media\FOTA_RDA_04.png) + +Generate **FotaFile.bin** file for downloading and upgrading module. + +4. Place the upgrade file into http server + +In this test, the address for downloading is shown as + +[http://120.197.216.227:6000/FotaFile.bin](http://120.197.216.227:6000/FotaFile.bin) + + + +## SW design + +```Python +import fota +import utime + +DEF_URL1 = 'http://120.197.216.227:6000/FotaFile.bin' + +def result(args): + print('download status:', args[0], 'download process:', args[1]) + +def run(): + fota_obj = fota() # Create FOTA object + print("Enter Upgrade Status......") + res = fota_obj.httpDownload(url1=DEF_URL1, callback=result) + if res != 0: + return + utime.sleep(2) + +run() +``` + + + +## Download and verify + +#### SW code + +Download **.py** file and run on module + +![FOTA_RDA_03](media\FOTA_RDA_03.png) + + + +After that, run the script manually. + +The upgrade will be accomplished about 5 minutes later, as a result, you can query more details. + +Input in interaction surface + +```python +>>> uos.uname2() +(sysname='EC600U-EUAB', nodename='EC600U', release='1.13.0', version='v1.12 on Tue_Oct_19_2021_5:26:44_PM', machine='EC600U with QUECTEL', qpyver='V0002') +``` + +By verifying, the upgrade is a success. \ No newline at end of file diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_01.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_01.png new file mode 100644 index 0000000000000000000000000000000000000000..e8b7490ba3a19f57ea8486fb4374f04621c36f9f Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_01.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_02.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_02.png new file mode 100644 index 0000000000000000000000000000000000000000..3e4a947a6a7358a84d6e75072f9c6f603561640c Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_02.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_03.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_03.png new file mode 100644 index 0000000000000000000000000000000000000000..12bfaf9a0c8ab13a631b5db9ec3f99c6a60d34cd Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_03.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_04.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_04.png new file mode 100644 index 0000000000000000000000000000000000000000..ddf9e892e90f2fe0b5d1c730e6612b6b63c7bc60 Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_ASR_04.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_01.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_01.png new file mode 100644 index 0000000000000000000000000000000000000000..ecb28fb0d705273a7910d88b63fe806b1a04cea6 Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_01.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_02.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_02.png new file mode 100644 index 0000000000000000000000000000000000000000..8a9d8d1cbbeef08d7853914d033a6e8e7551d2a0 Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_02.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_03.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_03.png new file mode 100644 index 0000000000000000000000000000000000000000..e59618b2ec1dcae8f26d4cfbb78cfa2e843ab61b Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_03.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_04.png b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_04.png new file mode 100644 index 0000000000000000000000000000000000000000..4017795f7eca309400c683a6df813ceaf5bd16fe Binary files /dev/null and b/docs/sbs/en/QuecPythonPlatform/media/FOTA_RDA_04.png differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155209368.png b/docs/sbs/en/QuecPythonPlatform/media/image-20210929155209368.png deleted file mode 100644 index 13434ed3d06a90ef7405ebd256c901fa8ab8340a..0000000000000000000000000000000000000000 Binary files a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155209368.png and /dev/null differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155313692.png b/docs/sbs/en/QuecPythonPlatform/media/image-20210929155313692.png deleted file mode 100644 index f893be002f939f85a1d3a7426e50250567333d60..0000000000000000000000000000000000000000 Binary files a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155313692.png and /dev/null differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155327009.png b/docs/sbs/en/QuecPythonPlatform/media/image-20210929155327009.png deleted file mode 100644 index 3a53693417f9d7a7d9efa0dcf78329e8a184830e..0000000000000000000000000000000000000000 Binary files a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155327009.png and /dev/null differ diff --git a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155530265.png b/docs/sbs/en/QuecPythonPlatform/media/image-20210929155530265.png deleted file mode 100644 index 07df8594bab443643a38ef76e78460d376345dbc..0000000000000000000000000000000000000000 Binary files a/docs/sbs/en/QuecPythonPlatform/media/image-20210929155530265.png and /dev/null differ diff --git a/docs/sbs/en/sidebar.yaml b/docs/sbs/en/sidebar.yaml index 0462f46e1226958dd581877be055b0df639a22e8..7e91e3c843c09a91bffd347eb83dabce8e974bc3 100644 --- a/docs/sbs/en/sidebar.yaml +++ b/docs/sbs/en/sidebar.yaml @@ -30,8 +30,10 @@ items: items: - label: modem instruction file: QuecPythonPlatform/modem_get_dev_info.md - - label: FOTA firmware upgrade User Guide - file: QuecPythonPlatform/FOTA_binary_upgrade.md + - label: ASR_Firmware_Upgrade + file: QuecPythonPlatform/FOTA_ASR.md + - label: RDA_Firmware_Upgrade + file: QuecPythonPlatform/FOTA_RDA.md - label: Audio Development file: QuecPythonPlatform/Audio.md - label: multithreading & message queue