diff --git a/docs/Application_guide/en/dev-tools/QPYcom/qpycom-gui.md b/docs/Application_guide/en/dev-tools/QPYcom/qpycom-gui.md index 8b135a5700ce74e477875843938287164e6cbcdf..1b501b013c8d6bf7482edb1c1c09bfb6964fd845 100644 --- a/docs/Application_guide/en/dev-tools/QPYcom/qpycom-gui.md +++ b/docs/Application_guide/en/dev-tools/QPYcom/qpycom-gui.md @@ -77,6 +77,8 @@ The buttons on the REPL page are explained as follows: - ![FOTA Package Creation](../../media/dev-tools/qpycom/image38.png) Make FOTA upgrade packages. +- ![Function Box](../../media/dev-tools/qpycom/image38_1.png) + Function box, currently only has the function of modifying partitions. ## "File" Tab in Toolbar diff --git a/docs/Application_guide/en/dev-tools/QPYcom/qpycom-merge.md b/docs/Application_guide/en/dev-tools/QPYcom/qpycom-merge.md index fe54192fd98293d55e1408451357ea5c57639d04..d9d33a3eef4e4cd630d7cd9c22e8ce1312a95b5a 100644 --- a/docs/Application_guide/en/dev-tools/QPYcom/qpycom-merge.md +++ b/docs/Application_guide/en/dev-tools/QPYcom/qpycom-merge.md @@ -22,10 +22,6 @@ On the ''**Download**" page, you can combine local Python script files with firm ![](../../media/dev-tools/qpycom/suffix.png) -- For the RDA firmware combination, you need to select a file in .pac format and you are allowed to set the size of *usr* and *bak* partitions (The feature is only available for new firmware versions; If the feature is not supported and has already been selected, the partition size will only be displayed and cannot be modified. This feature is supported in QPYcom 2.9 and above). - -![](../../media/dev-tools/qpycom/size_conf.png) - - Note: 1. If "**Backup**" is not selected, both the *usr* partition and the non-usr part of *bak* partition will be combined with the firmware and neither will be backed up. @@ -53,12 +49,13 @@ For example, after being encrypted, *user.py* will become *user.mpy*. We can dir ### Adjust User and Backup Partition Sizes -1. Following the steps of "Combine Firmware and Script", after selecting the firmware and scripts to be combined, select "**size self-provisioning(pac fw)**" to enable the feature of adjusting image partition size. This feature dynamically adjusts the sizes of the *user* file system and *backup* file system. - -2. After selecting "**size self-provisioning(pac fw)**", click "**Combine**" to start the combination process. During the combination, a window of partition size configuration will pop up. After adjusting the image partition sizes, click "**OK**" to generate the new firmware. +1. Click the **Function Box** button and select asr or unisoc. +![](../../media/dev-tools/qpycom/modify_partition.png) ![](../../media/dev-tools/qpycom/set_size.png) +![](../../media/dev-tools/qpycom/size_conf.png) + ### Combine External Partitions 1. If you need to add an external partition image when combining firmware and creating a file system, you can combine external partitions. diff --git a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692598668142.jpg b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692598668142.jpg index cc289ecb5e784ef8585f3868042d560a2e134dcd..f4afc8c074ff127f2a148a72d0576f0120052410 100644 Binary files a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692598668142.jpg and b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692598668142.jpg differ diff --git a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599729648.jpg b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599729648.jpg index e0d874f65f94735cd2cbb6ae03eb42a4b8e97ad8..6aacd0a25d10cd0baa732fc6bf7d7214b30d3a43 100644 Binary files a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599729648.jpg and b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599729648.jpg differ diff --git a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599801694.jpg b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599801694.jpg index 4a9b2dfb5d6aaea9249d5ac33203d5428fe18c01..16c82493446014e9261496394ade405854a50ca3 100644 Binary files a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599801694.jpg and b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599801694.jpg differ diff --git a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599919725.jpg b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599919725.jpg index 25615de126b58114a7b64c8b26991130dd8d9287..818f8bc97fdb80b040d4ba19dc267f97b88775d3 100644 Binary files a/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599919725.jpg and b/docs/Application_guide/en/media/dev-tools/FactoryTool/1692599919725.jpg differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_ext.png b/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_ext.png index beecfbeea4a4bfdb8c815d3daf3f4f28764acde7..d10d294526c7c0b757790d90cf80e0d6bd99832a 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_ext.png and b/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_ext.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_sc_1.jpg b/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_sc_1.jpg index 76d02573f99e75df90c4bde5c95301a9c42fd0f0..152b96e024fd0e7239b7629852064a1094fcc683 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_sc_1.jpg and b/docs/Application_guide/en/media/dev-tools/qpycom/QPYcom_sc_1.jpg differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/fota_1.png b/docs/Application_guide/en/media/dev-tools/qpycom/fota_1.png index 990d4fec648f5e5a782adbda1839430df7cdee23..294d7576b21df320183f9605c090e0e8b157bae9 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/fota_1.png and b/docs/Application_guide/en/media/dev-tools/qpycom/fota_1.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image10.png b/docs/Application_guide/en/media/dev-tools/qpycom/image10.png index fc97ee875d061e7692826116c5e80d99bb80a2ad..aa0c6781bedfa187ea80f152bd537b6b559552e4 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image10.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image10.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image11.png b/docs/Application_guide/en/media/dev-tools/qpycom/image11.png index e7ee4ba9398e6c3f5f0bf81c789d99027730ebd4..eb31f04e30e5c986200abd3ee475e8e7051db7dc 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image11.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image11.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image13.png b/docs/Application_guide/en/media/dev-tools/qpycom/image13.png index 2221350ea639e588d7421d85d4c8bd561a696ad4..10c3f7d2838d07c65857a271d874797fbdc321d0 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image13.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image13.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image18.png b/docs/Application_guide/en/media/dev-tools/qpycom/image18.png index 02f6d59f2a7ae6e818fed44be32755816a93a879..90789a4a365102efa40f44216af5b115b00c4579 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image18.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image18.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image24.png b/docs/Application_guide/en/media/dev-tools/qpycom/image24.png index 73761f23c0f530baaf3e35fb2b54260fa25bc87e..bc58fe6bfc282399487f88d537e60ed4422ad7b2 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image24.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image24.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image38_1.png b/docs/Application_guide/en/media/dev-tools/qpycom/image38_1.png new file mode 100644 index 0000000000000000000000000000000000000000..2f9626fb2c4457c2f84e296eeeaed7ca9f7f5e4d Binary files /dev/null and b/docs/Application_guide/en/media/dev-tools/qpycom/image38_1.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image40.png b/docs/Application_guide/en/media/dev-tools/qpycom/image40.png index ce687238ff1aab98519b9419335842daba0d2b52..2d81da0bc19a42daf22269983d5f3bd277bd564d 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image40.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image40.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image41.png b/docs/Application_guide/en/media/dev-tools/qpycom/image41.png index f13ada9d394646281a7d055adf07b64e5af08250..f927258fda84fac3c4168942cbe1c14e4660539f 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image41.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image41.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image42.png b/docs/Application_guide/en/media/dev-tools/qpycom/image42.png index 39ed05fdefe6556788357731307e5784adf0cb39..c776f1f19fa97e3d262c99c9dd570ca538458d54 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image42.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image42.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image43.png b/docs/Application_guide/en/media/dev-tools/qpycom/image43.png index 9df85508d11d6bd51a7b710a9c892387777900c5..20ad57e099d3fe65b0e5b1728fac539b71057878 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image43.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image43.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image46.png b/docs/Application_guide/en/media/dev-tools/qpycom/image46.png index 1f5afcbe3de627733b1c7aba65f5cbc0815ab24c..fa991cb5a65c595fdd428b128f444d36c40c8bd0 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image46.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image46.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/image9.png b/docs/Application_guide/en/media/dev-tools/qpycom/image9.png index c99bfc1c7bf11b1cc141c94615e005a22b4bd60f..428cc183a1765c14d7f7a2a23f3f268f6a7a3e04 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/image9.png and b/docs/Application_guide/en/media/dev-tools/qpycom/image9.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/modify_partition.png b/docs/Application_guide/en/media/dev-tools/qpycom/modify_partition.png new file mode 100644 index 0000000000000000000000000000000000000000..40746bfcb28009edb5733927d58d93f0766e145c Binary files /dev/null and b/docs/Application_guide/en/media/dev-tools/qpycom/modify_partition.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/repl_qpycom.png b/docs/Application_guide/en/media/dev-tools/qpycom/repl_qpycom.png index 6a21fa2b523e8b3ee6d717f00e4d299d9297a174..bd6a6a3166eb8a40ec11194555c0b1f5f742526e 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/repl_qpycom.png and b/docs/Application_guide/en/media/dev-tools/qpycom/repl_qpycom.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/set_size.png b/docs/Application_guide/en/media/dev-tools/qpycom/set_size.png index aba7977d0528ceb76dfc69734736e2f1b79d9721..af45fe72dc4795fe1c5b9143a2955e65cb890bfc 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/set_size.png and b/docs/Application_guide/en/media/dev-tools/qpycom/set_size.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/size_conf.png b/docs/Application_guide/en/media/dev-tools/qpycom/size_conf.png index 803f65ad196da553395cebe9d92bd3ef74cfc89a..db5b8b8cfe8a7e789e04412ab4f0d26363ee9507 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/size_conf.png and b/docs/Application_guide/en/media/dev-tools/qpycom/size_conf.png differ diff --git a/docs/Application_guide/en/media/dev-tools/qpycom/suffix.png b/docs/Application_guide/en/media/dev-tools/qpycom/suffix.png index f535a876de421199bed10e20e44fb3541b0bc4cb..419d82faebff95d2880c08b644eddf7bff7329e6 100644 Binary files a/docs/Application_guide/en/media/dev-tools/qpycom/suffix.png and b/docs/Application_guide/en/media/dev-tools/qpycom/suffix.png differ diff --git a/docs/Application_guide/en/media/firmware-upgrade/firmware-burning/firmware-burning.gif b/docs/Application_guide/en/media/firmware-upgrade/firmware-burning/firmware-burning.gif index 38b25f7d97d52e8b5a280750b0806e84d6631aa4..3a6306a385586d9a59d85ec7990699fb1006d969 100644 Binary files a/docs/Application_guide/en/media/firmware-upgrade/firmware-burning/firmware-burning.gif and b/docs/Application_guide/en/media/firmware-upgrade/firmware-burning/firmware-burning.gif differ diff --git a/docs/Application_guide/zh/dev-tools/QPYcom/qpycom-merge.md b/docs/Application_guide/zh/dev-tools/QPYcom/qpycom-merge.md index 5d4874d46cea88c68ad61518bc22e7de82467cb7..94f370cbe25f9df5c6475dca14ce53889565881b 100644 --- a/docs/Application_guide/zh/dev-tools/QPYcom/qpycom-merge.md +++ b/docs/Application_guide/zh/dev-tools/QPYcom/qpycom-merge.md @@ -8,33 +8,16 @@ - 点击选择固件从本地选择固件 -- 通过图示位置选择要合并的脚本，可以通过点击脚本文件进行指定删除，可以一键导入整个目录结构来实现合并具有复杂目录结构的项目,用户选择加密和备份按钮来实现备份和加密功能 +- 通过图示位置选择要合并的脚本，可以通过点击脚本文件进行指定删除，可以一键导入整个目录结构来实现合并具有复杂目录结构的项目,用户选择加密和备份复选框来实现备份和加密功能 ![](../../media/dev-tools/qpycom/image46.png) -- 点选备份后（bak/usr区要为空或者不存在），usr自动导入到bak/usr下，如下图所示： - -![](../../media/dev-tools/qpycom/image47.png) - -- 在此之后再在usr下添加文件，文件只会存在usr区，不会从bak/usr目录下恢复到usr；再在bak下添加文件，文件只会存在bak区，不会从bak/usr目录下恢复到usr，如图所示： - -![](../../media/dev-tools/qpycom/image48.png) - - ASR固件合并，可选择 .zip 和 .bin 后缀（QPYcom工具2.9版本添加） ![](../../media/dev-tools/qpycom/suffix.png) -- RDA固件合并，后缀为pac的固件可选择设置 usr和bak分区大小（新固件才可，若不支持并且有勾选则会仅显示大小，不支持修改； 工具2.9版本添加） - -![](../../media/dev-tools/qpycom/size_conf.png) - - -- 注： - - 1. 备份按钮未勾选，usr区和 bak下非usr部分会合并到固件，且均不备份 - 2. 文件只有同时在 usr 和 bak/usr 并勾选了备份才会备份 - ## 代码加密 +## 代码加密 ### Python脚本加密概述 @@ -48,20 +31,35 @@ ### 加密操作步骤 -1. 按照上文固件脚本合并的过程，在选择好要合并的固件和脚本之后，通过勾选加密按钮开开启加密功能 +1. 按照上文固件脚本合并的过程，在选择好要合并的固件和脚本之后，通过勾选加密复选框开启加密功能 2. 勾选加密之后点击合并按钮，在合并前会对已选择的脚本进行加密操作，最后合并到固件中的脚本文件均为mpy文件,此外，在合并完成后可以在工具目录下的mpy文件夹中找到本次合并过程中生成的mpy文件 +![](../../media/dev-tools/qpycom/image47.png) ## 调整镜像分区 -### 调整用户区备份区大小 +点击 **工具箱** - **修改分区** 可对分区进行调整(3.2.0版本支持ASR和Unisoc平台) + +![](../../media/dev-tools/qpycom/Adjust_partition.jpg) + +### Unisoc平台 + +![](../../media/dev-tools/qpycom/set_size.png) + +### ASR平台 + +1. 内置分区调整 + +![](../../media/dev-tools/qpycom/ASR_Built-in.jpg) + +2. 外挂分区调整 -1. 按照上文固件脚本合并的过程，在选择好要合并的固件和脚本之后，通过勾选size自配按钮开开启调整镜像分区功能，可以动态调配用户文件系统和备份文件系统的大小 +![](../../media/dev-tools/qpycom/ASR_external.jpg) -2. 勾选之后点击合并按钮开始合并，合并过程中工具会弹窗用于配置分区大小，在弹窗中调整好镜像分区大小之后，点击ok按钮生成新固件 +3. bin文件替换 - ![](../../media/dev-tools/qpycom/set_size.png) +![](../../media/dev-tools/qpycom/ASR_replace.jpg) ### 合并外置分区 diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_Built-in.jpg b/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_Built-in.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d5fb31d0d53de999a5b0b969e53543d6bc44176e Binary files /dev/null and b/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_Built-in.jpg differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_external.jpg b/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_external.jpg new file mode 100644 index 0000000000000000000000000000000000000000..efda57247ba98b8d1fdf42adc9b7bbf17b5d6b14 Binary files /dev/null and b/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_external.jpg differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_replace.jpg b/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_replace.jpg new file mode 100644 index 0000000000000000000000000000000000000000..9d80f55bb90517641cbf530cd04329b7490222b9 Binary files /dev/null and b/docs/Application_guide/zh/media/dev-tools/qpycom/ASR_replace.jpg differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/Adjust_partition.jpg b/docs/Application_guide/zh/media/dev-tools/qpycom/Adjust_partition.jpg new file mode 100644 index 0000000000000000000000000000000000000000..4b5ad35da0c2475fd58eff8432718843322102ec Binary files /dev/null and b/docs/Application_guide/zh/media/dev-tools/qpycom/Adjust_partition.jpg differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/image46.png b/docs/Application_guide/zh/media/dev-tools/qpycom/image46.png index c26ce2c4d46b31e0bca7eed8e749d75ed16c9a5e..de9cacbb7d366f705a74d41d6016ed49ae9a8644 100644 Binary files a/docs/Application_guide/zh/media/dev-tools/qpycom/image46.png and b/docs/Application_guide/zh/media/dev-tools/qpycom/image46.png differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/image47.png b/docs/Application_guide/zh/media/dev-tools/qpycom/image47.png index c5a524d1a5564b9dd1027108520fff9729dcbf79..363208a8e95e1e832233a6cde78fa0f2f87d8858 100644 Binary files a/docs/Application_guide/zh/media/dev-tools/qpycom/image47.png and b/docs/Application_guide/zh/media/dev-tools/qpycom/image47.png differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/set_size.png b/docs/Application_guide/zh/media/dev-tools/qpycom/set_size.png index b34b1f4fa6e934508f6ff781265fe32aa0028d11..0be4b83b5e663b2d77ddb8af582d37876933f5c5 100644 Binary files a/docs/Application_guide/zh/media/dev-tools/qpycom/set_size.png and b/docs/Application_guide/zh/media/dev-tools/qpycom/set_size.png differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/size_conf.png b/docs/Application_guide/zh/media/dev-tools/qpycom/size_conf.png deleted file mode 100644 index 63a7fbab6b1b4505b147d35535fe587cf4f61b8c..0000000000000000000000000000000000000000 Binary files a/docs/Application_guide/zh/media/dev-tools/qpycom/size_conf.png and /dev/null differ diff --git a/docs/Application_guide/zh/media/dev-tools/qpycom/suffix.png b/docs/Application_guide/zh/media/dev-tools/qpycom/suffix.png index 70189f0d20c79b8ef884a2d87bea38788d0a681d..2332b004212997bd42878f4a558afa12ad29727e 100644 Binary files a/docs/Application_guide/zh/media/dev-tools/qpycom/suffix.png and b/docs/Application_guide/zh/media/dev-tools/qpycom/suffix.png differ