diff --git a/docs/Quick_start/zh/README.md b/docs/Quick_start/zh/README.md index 19f0c420c1835b236aa5289db5b53a0b14cf6080..6dca56a04af55b522d15c174eeed5c390b7e7184 100755 --- a/docs/Quick_start/zh/README.md +++ b/docs/Quick_start/zh/README.md @@ -1,26 +1,27 @@ -## QuecPython 开发准备 +## 修订历史 -### 官网介绍 +| 版本 | 日期 | 作者 | 变更表述 | +| ---- | ---------- | ------ | -------------------------- | +| 1.0 | 2021-09-02 | Kayden | 首次编写，指导客户快速开发 | +| 1.1 | 2021-09-10 | David | 增加环境搭建的注意事项 | -**官网地址： https://python.quectel.com/** +## 前言 -![](media/1.png) +本篇可能比较枯燥，但是仔细看完，相信你可以顺利玩转QuecPython开发板 -**官网wiki地址：https://python.quectel.com/wiki/#/** +## 官网介绍 -![](media/2.png) +**官网首页地址： [https://python.quectel.com/](https://python.quectel.com/)** -### 开发资源下载 +**官网wiki地址：[https://python.quectel.com/wiki/#/](https://python.quectel.com/wiki/#/)**，对于模组支持的API都可以在此查找。 -获取开发资源下载地址：https://python.quectel.com/download +**文档中心地址：[https://python.quectel.com/doc/](https://python.quectel.com/doc/)**，主要包括快速入门，常用接口开发，开发进阶，小实验等。 -![](media/SDK.png) +**开发资源下载地址：[https://python.quectel.com/download](https://python.quectel.com/download)**，主要包括开发工具、驱动、固件、硬件参考设计等的下载。 -### QuecPython社区 +**Quecpython社区链接：[https://forumschinese.quectel.com/c/function-subjects/quectpython/43](https://forumschinese.quectel.com/c/function-subjects/quectpython/43)** -Quecpython社区链接：https://forumschinese.quectel.com/c/function-subjects/quectpython/43 - -![](media/forums_1.png) + 可以在右上角的放大镜快速搜索您想要的问题和答案，如没有想要的问题和答案欢迎提问。 @@ -30,97 +31,85 @@ Quecpython社区链接：https://forumschinese.quectel.com/c/function-subjects/q 拿到板子不知道怎么开始，看到这篇文章就对了。 -本部分内容详细操作可以结合EC600X开发板介绍进行学习，链接：https://python.quectel.com/doc/doc/Quecpython_intro/zh/Qp_Hw_EC600X/Hardware_Support_EC600X.html +本部分内容详细操作可以结合EC600X开发板介绍进行学习，链接：[https://python.quectel.com/doc/doc/Quecpython_intro/zh/Qp_Hw_EC600X/Hardware_Support_EC600X.html](https://python.quectel.com/doc/doc/Quecpython_intro/zh/Qp_Hw_EC600X/Hardware_Support_EC600X.html ) 本文以EC600S_QuecPython_EVB_V1.1为例，V1.2、V1.3类同，具体差异可查看上文EC600X开发板介绍链接。 -![](media/C01.png) - -期待已久的板子，终于拿到手了，在开发板侧边插上USB口供电，另一端接电脑USB口。 - -功能强大的开发板像手机一样支持开关机，所以供电后，我们首先开机(有USB和DC电源选择开关的需要拨到USB处)。 + -长按侧边的POWKY或PWK两秒松开，模组便会自动开机。 - -![](media/C02.png) - -开始玩转QuecPython啦。 +期待已久的板子，终于拿到手了，在开发板侧边插上USB口供电，另一端接电脑USB口。功能强大的开发板像手机一样支持开关机，**所以供电后，我们考虑如何开机**。 +### 如何开机 +| 开发板 | 开机操作 | +| ----------------------------------------------------------- | ------------------------------------------------------------ | +| EC600S_QuecPython_EVB_V1.0 | 插电即开机 | +| EC600S_QuecPython_EVB_V1.1 | （1）USB和DC的电源选择开关拨到USB处
（2）长按开发板侧边的POWKY两秒松开，模组便会开机 | +| EC600S_QuecPython_EVB_V1.2/V1.3
BC25_QuecPython_EVB_V1.0 | （1）USB和DC的电源选择开关拨到USB处
（2）开发板上的PWK_ON跳帽短接，则无需长按PWK，反之需要长按PWK | ### 驱动下载安装 驱动程序（device driver）全称为“设备驱动程序”，是一种可以使计算机和设备通信的特殊程序，可以说相当于硬件的接口，操作系统只能通过这个接口，才能控制硬件设备的工作，假如某设备的驱动程序未能正确安装，便不能正常工作。 - +打开[驱动下载链接](https://python.quectel.com/download)，如图选择自己电脑匹配的驱动，向右拖动箭头位置会出现下载按钮，点击下载即可。 -为了能让EC600S开发板和电脑正常通信，我们去官网下载一个EC600S的驱动程序（ASR USB驱动），安装在电脑上。 +驱动安装注意事项 -驱动下载链接：https://python.quectel.com/download +1. **驱动的分类主要分为两大类：** -打开链接，如图选择自己电脑匹配的驱动，向右拖动箭头位置会出现下载按钮，点击下载即可。 + **第一、基于模组支持的平台分类：ASR平台（EC600SCNAA、EC600SCNLA、EC600SCNLB、EC600N、EC100Y）和RDA平台（EC600U）更多模组的平台信息可见：[硬件支持](https://python.quectel.com/doc/doc/Quecpython_intro/zh/Qp_Product_intro/Hardware_Support.html),相信大家也有一个疑问EC600X是什么平台，实际上EC600X中“X”是一个未知数，可指EC600S、EC600U等，并不代表实际的平台。** -注意：RDA USB驱动下载后压缩包里包含Windows7和Windows10的驱动。 + **第二、基于PC的系统分类：Windows7系统请下载Windows7对应的驱动；Windows10系统请下载Windows10对应的驱动。** -![](media/C03.png) +2. **对于EC600SCNLA和EC600SCNLB，必须下载最新版本的驱动，驱动版本至少在V1.0.8以上** + +3. **RDA USB驱动下载后压缩包里包含Windows7和Windows10的驱动。** + + 打开【我的电脑】——【管理】——【设备管理器】 安装驱动前： -![](media/C04.png) + 安装驱动后： -![](media/C05.png) +![](media/readme_5.png) 下载后打开压缩包，双击运行“setup.exe”，一直“下一步”直到安装完成，安装完之后就可以看到【设备管理器】中端口的感叹号消失了，说明安装成功，能够正常通信。**上图中可见仍然有个端口有感叹号，不用在意，用不上。** -![](media/C06.png) - -![](media/C07.png) - -![](media/C08.png) - - +![](media/readme_6.png) -### QPYcom.exe使用 - -官方提供一个Windows的界面工具给用户开发调试模组的代码。 - -下载链接：https://python.quectel.com/download - -找到QPYcom图形化工具，向右拖动箭头位置，找到下载按钮点击下载。 - -![](media/C09.png) - -绿色版QPYcom软件无需安装，直接下载解压后，打开QPYcom.exe应用程序使用，为了方便日后使用，可以发送一个快捷方式到桌面。其中的config.ini文件是配置工具箱中快捷命令生成的文件，修改和删除快捷命令都可以编辑此文件实现。 +![](media/readme_7.png) -![](media/C10.png) +![](media/readme_8.png) -![](media/C11.png) -下面介绍一下QPYcom工具的主要内容包括但不限于：交互界面、文件操作、下载功能。 -交互界面：用于在电脑端与设备端通信，下发命令让设备按照用户的想法去工作，同时设备可以返回信息给电脑，用户在交互界面可以看到设备内部的运作情况。 +### 固件烧录注意事项 -![](media/C12.png) +1. **不同模组对应不同的固件，不支持交叉烧录，如果误烧，一定要纠正烧录成对应固件，否则无法正常使用。例如：EC600S分为EC600SCNAA、EC600SCNLA、EC600SCNLB等等，这些模组之间都不支持交叉烧录。** +2. **关于固件包的说明，由于官网下载的固件压缩文件包含固件包与change log，所以官网下载的固件压缩文件需要解压一层，才可以得到可烧录的固件包，后面会评估更改固件包的后缀为.bin（计划中，如果后面更新完成，记得烧录时选择后缀为.bin的压缩文件）。** +3. **下载固件前，建议优先需要确认固件版本，以免降级或者下错版本。 下载固件后，所有用户区的内容都将被清空。** +4. **下载固件时，无需选择串口，工具将自动选择并开始下载** +5. **请勿同时插入两个或两个以上的开发板，以免工具无法识别，导致下载出错** +6. **QPYcom工具支持烧录python固件，不支持烧C固件或者AT标准固件** +7. **下载固件过程中，请勿退出工具，或者拔掉串口，可能致使模块变砖。 如果模块确已变砖，可见“[QuecPython救砖处理](https://python.quectel.com/doc/doc/FAQ/zh/QP_recovery/QP_recovery.html)”章节** -文件操作：用于在电脑端给设备传输文件，用户自己写的代码文件，在这个界面送入到设备，这样设备就能运行用户代码啦。 - -![](media/C13.png) +### QPYcom.exe使用 -下载功能：用于用户烧录固件，用户的.py文件执行于固件之上，要让设备执行QuecPython代码，就先烧录PY固件。 +官方提供一个Windows的界面工具给用户开发调试模组的代码。下载链接：https://python.quectel.com/download -![](media/C14.png) +关于QPYcom工具见“工具同目录下的docs文件夹”，里面有对应的工具说明。 ### 工作原理 这里先了解一下整个过程是如何执行的。 -![](media/C15.png) +![](media/readme_9.png) -![](media/C16.png) +![](media/readme_10.png) 模组内置一个QuecPython语法解释器，对QuecPython语句解释后，返回执行结果。 @@ -134,11 +123,9 @@ print()可以打印字符串、变量等等信息。 在QuecPython里字符串用一对单引号表示。如‘Hello world! QuecPython’。 - - ### 实战操作 -![](media/C17.png) +![](media/readme_11.png) 打开QPYcom软件后，我们看到“选择串口”中有三个端口是模组相关的，其中： @@ -164,7 +151,7 @@ Hello World! QuecPython >>> ``` -![](media/C18.png) +![image-20210910111634969](media/readme_12.png) 看到模组返回值了，成功输出Hello world! QuecPython @@ -174,9 +161,7 @@ Hello World! QuecPython 相关工具、例程、驱动、文档可以在官方网站下载：https://python.quectel.com/download - - -了解更多，敬请留意本公众号的精彩内容。 + 了解更多，敬请留意本公众号的精彩内容。 diff --git a/docs/Quick_start/zh/media/1.png b/docs/Quick_start/zh/media/1.png deleted file mode 100755 index 8929259368124e35bfd9d62a1055409eb318bac1..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/1.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/2.png b/docs/Quick_start/zh/media/2.png deleted file mode 100755 index 08fc132a11dea13468c401289f8cf6a637fcb924..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/2.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C02.png b/docs/Quick_start/zh/media/C02.png deleted file mode 100755 index b28449a5167374a083e43c23287803b17ffbb117..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C02.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C03.png b/docs/Quick_start/zh/media/C03.png deleted file mode 100755 index 34066442035ea4b5e711d33bb77a2de002c4b389..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C03.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C07.png b/docs/Quick_start/zh/media/C07.png deleted file mode 100755 index 4de21736bf241a356709b1d892d63a65bf6ebb9a..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C07.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C09.png b/docs/Quick_start/zh/media/C09.png deleted file mode 100755 index 37e2c726ddaf7ab5163e394124f0eef54666407e..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C09.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C10.png b/docs/Quick_start/zh/media/C10.png deleted file mode 100755 index 6fbc223bccc2e2988e683d2bd006b803e5974bfb..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C10.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C11.png b/docs/Quick_start/zh/media/C11.png deleted file mode 100755 index 71002087eed950fa95db0c587aa9391b4a4274f2..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C11.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C12.png b/docs/Quick_start/zh/media/C12.png deleted file mode 100755 index 3706f774adfa06d921f69c35db3d353b783797ba..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C12.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C13.png b/docs/Quick_start/zh/media/C13.png deleted file mode 100755 index e257fcb14d00597884b1d93582d32fd1241f2266..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C13.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C14.png b/docs/Quick_start/zh/media/C14.png deleted file mode 100755 index 67b062a228ca7add0c5106e496e9a2ecae8038dd..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C14.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/C18.png b/docs/Quick_start/zh/media/C18.png deleted file mode 100755 index 78cb958f9c8533ce0c93a4e37e4f30b32c900b3a..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/C18.png and /dev/null differ diff --git a/docs/Quick_start/zh/media/forums_1.png b/docs/Quick_start/zh/media/readme_1.png similarity index 100% rename from docs/Quick_start/zh/media/forums_1.png rename to docs/Quick_start/zh/media/readme_1.png diff --git a/docs/Quick_start/zh/media/C16.png b/docs/Quick_start/zh/media/readme_10.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C16.png rename to docs/Quick_start/zh/media/readme_10.png diff --git a/docs/Quick_start/zh/media/C17.png b/docs/Quick_start/zh/media/readme_11.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C17.png rename to docs/Quick_start/zh/media/readme_11.png diff --git a/docs/Quick_start/zh/media/readme_12.png b/docs/Quick_start/zh/media/readme_12.png new file mode 100644 index 0000000000000000000000000000000000000000..54c80c139e92f1ac825c2d06603eaa162eb92a87 Binary files /dev/null and b/docs/Quick_start/zh/media/readme_12.png differ diff --git a/docs/Quick_start/zh/media/C01.png b/docs/Quick_start/zh/media/readme_2.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C01.png rename to docs/Quick_start/zh/media/readme_2.png diff --git a/docs/Quick_start/zh/media/readme_3.png b/docs/Quick_start/zh/media/readme_3.png new file mode 100644 index 0000000000000000000000000000000000000000..07aecf4bad2c1dc03cc4ce0566cb1610158e027a Binary files /dev/null and b/docs/Quick_start/zh/media/readme_3.png differ diff --git a/docs/Quick_start/zh/media/C04.png b/docs/Quick_start/zh/media/readme_4.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C04.png rename to docs/Quick_start/zh/media/readme_4.png diff --git a/docs/Quick_start/zh/media/C05.png b/docs/Quick_start/zh/media/readme_5.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C05.png rename to docs/Quick_start/zh/media/readme_5.png diff --git a/docs/Quick_start/zh/media/C06.png b/docs/Quick_start/zh/media/readme_6.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C06.png rename to docs/Quick_start/zh/media/readme_6.png diff --git a/docs/Quick_start/zh/media/readme_7.png b/docs/Quick_start/zh/media/readme_7.png new file mode 100644 index 0000000000000000000000000000000000000000..a9994c317042f818fd1167f82f7444b3f765f35e Binary files /dev/null and b/docs/Quick_start/zh/media/readme_7.png differ diff --git a/docs/Quick_start/zh/media/C08.png b/docs/Quick_start/zh/media/readme_8.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C08.png rename to docs/Quick_start/zh/media/readme_8.png diff --git a/docs/Quick_start/zh/media/C15.png b/docs/Quick_start/zh/media/readme_9.png old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/media/C15.png rename to docs/Quick_start/zh/media/readme_9.png