diff --git a/docs/Quick_start/zh/QuecPythonHelloWord/media/Click_Run.jpg b/docs/Quick_start/zh/QuecPythonHelloWord/media/Click_Run.jpg deleted file mode 100755 index d9d66d78435637e2c5ea699a398fd2be8cacc735..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/QuecPythonHelloWord/media/Click_Run.jpg and /dev/null differ diff --git a/docs/Quick_start/zh/QuecPythonHelloWord/media/helloworld_print.png b/docs/Quick_start/zh/QuecPythonHelloWord/media/helloworld_print.png deleted file mode 100755 index c553aeb877cfd7e73c2a78069d0cd59851f62cfd..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/QuecPythonHelloWord/media/helloworld_print.png and /dev/null differ diff --git a/docs/Quick_start/zh/Quick_start.md b/docs/Quick_start/zh/Quick_start.md deleted file mode 100644 index c2016059c5fcc6efd7e3f13ea42e268ee6a3cbae..0000000000000000000000000000000000000000 --- a/docs/Quick_start/zh/Quick_start.md +++ /dev/null @@ -1,64 +0,0 @@ -## 修订历史 - -| 版本 | 日期 | 作者 | 变更表述 | -| ---- | --------- | ----- | -------------------------- | -| 1.0 | 2021-4-17 | David | 首次编写，指导客户快速开发 | - -## 前言 - -本篇可能比较枯燥，但是仔细看完，相信你可以顺利玩转QuecPython开发板 - -## QuecPython 开发常用网址 - -**官网首页地址： [https://python.quectel.com/](https://python.quectel.com/)** - -**官网wiki地址：[https://python.quectel.com/wiki/#/](https://python.quectel.com/wiki/#/)**，对于模组支持的API都可以在此查找。 - -**文档中心地址：[https://python.quectel.com/doc/](https://python.quectel.com/doc/)**，主要包括快速入门，常用接口开发，开发进阶，小实验等。 - -**开发资源下载地址：[https://python.quectel.com/download](https://python.quectel.com/download)**，主要包括开发工具、驱动、固件、硬件参考设计等的下载。 - -## QuecPython 开发环境搭建 - -对于每一款开发板，都有对应的开发板使用说明，例如：[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)文档的第五章节“准备工作”（熟悉驱动安装、固件烧录、脚本下载等基本开发技能），尤其是此章节中的注意事项**。为了防止大家入坑，这里简单做个总结。 - -### 如何开机 - -| 开发板 | 开机操作 | -| -------------------------- | -------------------------------------------------------- | -| EC600S_QuecPython_EVB_V1.0 | 插电即开机 | -| EC600S_QuecPython_EVB_V1.1 | 长按开发板侧边的POWKY两秒松开，模组便会开机 | -| EC600S_QuecPython_EVB_V1.2 | 开发板上的PWK_ON跳帽短接，则无需长按PWK，反之需要长按PWK | - -### 驱动安装注意事项 - -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等，并不代表实际的平台。** - - **第二、基于PC的系统分类：Windows7系统请下载Windows7对应的驱动；Windows10系统请下载Windows10对应的驱动。** - -2. **对于EC600SCNLA和EC600SCNLB，必须下载最新版本的驱动，驱动版本至少在V1.0.8以上** - -### 固件烧录注意事项 - -1. **不同模组对应不同的固件，不支持交叉烧录，如果误烧，一定要纠正烧录成对应固件，否则无法正常使用。例如：EC600S分为EC600SCNAA、EC600SCNLA、EC600SCNLB等等，这些模组之间都不支持交叉烧录。** -2. **关于固件包的说明，由于官网下载的固件压缩文件包含固件包与change log，所以官网下载的固件压缩文件需要解压一层，才可以得到可烧录的固件包，后面会评估更改固件包的后缀为.bin（计划中，如果后面更新完成，记得烧录时选择后缀为.bin的压缩文件）。** -3. **下载固件前，建议优先需要确认固件版本，以免降级或者下错版本。 下载固件后，所有用户区的内容都将被清空。** -4. **下载固件时，无需选择串口，工具将自动选择并开始下载** -5. **请勿同时插入两个或两个以上的开发板，以免工具无法识别，导致下载出错** -6. **QPYcom工具支持烧录pythonn固件，不支持烧C固件或者AT标准固件** -7. **下载固件过程中，请勿退出工具，或者拔掉串口，可能致使模块变砖。 如果模块确已变砖，可见“[QuecPython救砖处理](https://python.quectel.com/doc/doc/FAQ/zh/QP_recovery/QP_recovery.html)”章节** - -## QuecPython代码编写资料地址 - -对于QuecPython代码编写资料主要分为三个部分 - -1. [demo例程](https://python.quectel.com/download)：在左侧超链接中，找到如下的文件，demo里面中的每个例子都可以单独运行。 - - ![image-20210417151635408](media/demo.png) - -2. [wiki_API库](https://python.quectel.com/wiki/#/)：此网站会详细介绍模组支持的API接口，以及API接口的使用说明，如果你开始不熟悉某个API接口的使用方法，可以在此连接找到对应的说明，例如：不熟悉UART的使用，可以点击[UART](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=uart)。 - -3. [文档中心](https://python.quectel.com/doc/)：文档中心的内容比较丰富，主要分为：产品介绍、快速开始、手把手教学、小实验、开发进阶、产品案例、产品量产、常见问题。建议花点时间了解每个部分主要包括哪些，保证会有意想不到的效果。 - diff --git a/docs/Quick_start/zh/QuecPythonHelloWord/README.md b/docs/Quick_start/zh/Start_to_abandon.md old mode 100755 new mode 100644 similarity index 85% rename from docs/Quick_start/zh/QuecPythonHelloWord/README.md rename to docs/Quick_start/zh/Start_to_abandon.md index 043a8c80a35311e2e138fcb01407fbfa10d6e16a..f1d1d68fbe50b4bbc8931ce8b4dcc43ced4ee455 --- a/docs/Quick_start/zh/QuecPythonHelloWord/README.md +++ b/docs/Quick_start/zh/Start_to_abandon.md @@ -2,11 +2,6 @@ 本文档主要说明 QuecPython快速入门，主要包括三个方面：打印Hello World；点亮LED灯；HTTP获取网页源代码。 -适用模块： - -- EC100Y-CN -- EC600S-CN - ## Hello World打印 1.开发板接入电脑，需要安装驱动和烧录模块固件，具体的操作方法参照《Quectel QuecPython_QPYcom工具使用说明》 @@ -16,7 +11,7 @@ （1）交互窗口打印 -如下图所示，使用QPYcom工具，端口连接”USB串行设备”，选择“交互”界面，进行如下交互打印。 +如下图所示，使用QPYcom工具，端口连接“QuecPython的交互端口”，选择“交互”界面，进行如下交互打印。 ```python >>> print('hello world') @@ -38,10 +33,6 @@ while print_num: utime.sleep(2) # 延迟2秒 ``` -运行结果如下: - -![helloworld_print](media/helloworld_print.png) - ## 点亮LED灯与HTTP获取网页源代码 @@ -57,7 +48,7 @@ while print_num: 实物连接如下所示。 -![LED_connect](media/LED_connect.jpg) +LED_connect @@ -91,14 +82,14 @@ while account: 1.打开QPYcom运行*led_net.py*，如下图所示。 -![Click_Run](media/Click_Run.jpg) +![Start_to_abandon_02](media/Start_to_abandon_02.png) 2.运行中，看到request获取成功后，拔掉SIM卡（模拟无法注网的状态），部分LOG如下： -![Operation_effect](media/Operation_effect.jpg) +![Operation_effect](media/Start_to_abandon_03.jpg) 说明： （1）在拔出SIM卡后，仍有几次获取到GPIO状态是1的，这是正常的，因为request获取会有存在一定的缓存； -（2）对于运行中出现的"113"等，是HTTP的错误码，具体可参考HTTP的错误码表（可自行百度）。 \ No newline at end of file +（2）对于运行中出现的"113"等，是HTTP的错误码，具体可参考[HTTP的错误码表](https://python.quectel.com/wiki/#/zh-cn/faq/?id=quecpython%e9%94%99%e8%af%af%e7%a0%81%e6%b1%87%e6%80%bb)，或者google。 \ No newline at end of file diff --git a/docs/Quick_start/zh/QuecPythonHelloWord/media/LED_connect.jpg b/docs/Quick_start/zh/media/Start_to_abandon_01.jpg old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/QuecPythonHelloWord/media/LED_connect.jpg rename to docs/Quick_start/zh/media/Start_to_abandon_01.jpg diff --git a/docs/Quick_start/zh/media/Start_to_abandon_02.png b/docs/Quick_start/zh/media/Start_to_abandon_02.png new file mode 100644 index 0000000000000000000000000000000000000000..ae469d27a43852dca13558065c52fd2766f2ea39 Binary files /dev/null and b/docs/Quick_start/zh/media/Start_to_abandon_02.png differ diff --git a/docs/Quick_start/zh/QuecPythonHelloWord/media/Operation_effect.jpg b/docs/Quick_start/zh/media/Start_to_abandon_03.jpg old mode 100755 new mode 100644 similarity index 100% rename from docs/Quick_start/zh/QuecPythonHelloWord/media/Operation_effect.jpg rename to docs/Quick_start/zh/media/Start_to_abandon_03.jpg diff --git a/docs/Quick_start/zh/media/demo.png b/docs/Quick_start/zh/media/demo.png deleted file mode 100644 index dd94d41a3218a9d4053bb5408c54e272998bca1e..0000000000000000000000000000000000000000 Binary files a/docs/Quick_start/zh/media/demo.png and /dev/null differ diff --git a/docs/Quick_start/zh/sidebar.yaml b/docs/Quick_start/zh/sidebar.yaml index 461d2c187bdbd2264256c20f9597a8a7cd44826b..8fe45001eb01b793ea6bc60c00668966a612f2e7 100755 --- a/docs/Quick_start/zh/sidebar.yaml +++ b/docs/Quick_start/zh/sidebar.yaml @@ -1,13 +1,9 @@ # Quecpython 快速开始 items: - - label: 环境搭建 - items: - - label: QuecPython开发环境搭建 - file: README.md - - label: QuecPython快速开始 - file: Quick_start.md - - label: QuecPython快速入门 - file: QuecPythonHelloWord/README.md + - label: QuecPython开发环境搭建 + file: README.md + - label: QuecPython快速入门 + file: Start_to_abandon.md - label: repl&串口介绍 file: repl.md - label: GPIO操作说明