diff --git a/docs/Application_guide/zh/dev-tools/DTU-Tool/README.md b/docs/Application_guide/zh/dev-tools/DTU-Tool/README.md index 4e7fb22d68dda01ed61c3856b2bcf777b49a96b7..3d968ab61a0eacd57764d557f1837c6cdb41e16e 100644 --- a/docs/Application_guide/zh/dev-tools/DTU-Tool/README.md +++ b/docs/Application_guide/zh/dev-tools/DTU-Tool/README.md @@ -110,9 +110,9 @@ DTU工具的功能有两大类： DTU工具是基于图形框架wxPython开发，现阶段已编译成`dtu_tool.exe`仅支持Windows系统。用户可在Linux或macOS配置Python环境并安装wxPython后可直接运行`dtu_tool.py`或自行编译对应版本的二进制程序即可（编译脚本：`dtu_tool/build.sh`）。 -> DTU Tool源代码仓库链接：https://github.com/QuecPython/DTU-tool.git +> DTU Tool源代码仓库链接： > -> wxPython官方网站：https://www.wxpython.org +> wxPython官方网站： ### 安装依赖 diff --git a/docs/Application_guide/zh/dev-tools/Thonny/README.md b/docs/Application_guide/zh/dev-tools/Thonny/README.md index 24b5dd5b1899273d2d5667e2e0f28a4aed441c3a..35fbe68e5d28bda1ce0fb8288956e5534cdf7120 100644 --- a/docs/Application_guide/zh/dev-tools/Thonny/README.md +++ b/docs/Application_guide/zh/dev-tools/Thonny/README.md @@ -14,11 +14,11 @@ Thonny是一款非常适合初学者的Python IDE，具备易于上手、语法 Thonny支持三种主流操作系统：windows、macos、linux。 -访问Thonny官方网站(https://thonny.org/)。 +访问Thonny官方网站（）。 ![](../../media/dev-tools/thonny/thonny_web.png) -根据屏幕右上角对应操作系统可以看到有如下安装方式（以windows为例)。 +根据屏幕右上角对应操作系统可以看到有如下安装方式（以windows为例）。 ![](../../media/dev-tools/thonny/win_installer.png) @@ -52,7 +52,7 @@ Thonny应用程序安装支持两种安装方式： > 注意事项： > -> 1、这种方式面向开发者，若采用该方式安装Thonny，需具备python环境。移步python官方下载(https://www.python.org/downloads/)安装python开发环境。 +> 1、这种方式面向开发者，若采用该方式安装Thonny，需具备python环境。移步python官方下载（）安装python开发环境。 > > 2、`pip`是python的包管理器，通过该程序可以在shell环境下安装python应用包。 @@ -104,7 +104,7 @@ Thonny应用程序安装支持两种安装方式： ![](../../media/dev-tools/thonny/thonny-quecpython.png) -点击`Install`下载按钮即可下载安装插件。 +点击`Install`下载按钮即可下载安装插件（注意：下载完成后需重启Thonny生效）。 #### 使用PIP安装 @@ -169,7 +169,7 @@ Thonny可以将脚本文件保存本地，亦可保存至设备模组中。 ![](../../media/dev-tools/thonny/save.png) -输入文件名&选择设备保存文件系统路径(`/usr`)： +输入文件名&选择设备保存文件系统路径（`/usr`）： ![](../../media/dev-tools/thonny/save_file.png) @@ -179,6 +179,6 @@ Thonny可以将脚本文件保存本地，亦可保存至设备模组中。 ## QuecPython-Kits插件开源代码下载 -`QuecPython-Kits`开源项目命名为`thonny-quecpython`，github仓库链接：https://github.com/QuecPython/thonny-quecpython。 +`QuecPython-Kits`开源项目命名为`thonny-quecpython`，github仓库链接：。 -`thonny`开源项目仓库链接： https://github.com/thonny/thonny。 \ No newline at end of file +`thonny`开源项目仓库链接：。 \ No newline at end of file diff --git a/docs/Application_guide/zh/solutions/DTU/README.md b/docs/Application_guide/zh/solutions/DTU/README.md index 7fdba961463ea3aac64bbb500306f71db8913407..130615a265215cee0aa69880de6e9487f7d073f2 100644 --- a/docs/Application_guide/zh/solutions/DTU/README.md +++ b/docs/Application_guide/zh/solutions/DTU/README.md @@ -13,7 +13,6 @@ DTU主要功能就是把设备的数据通过无线的方式传送回云端（ ![](../../media/solutions/DTU/DTU.png)
图1 DTU简介
- > 传感器(温度、湿度等传感器)采集数据发送给设备端MCU，设备端MCU通过串口将采集到的数据通过DTU发送到云端中心服务器，服务器接收到数据可以进行分析、处理、显示、保存等操作。 ### 应用领域 @@ -21,7 +20,6 @@ DTU主要功能就是把设备的数据通过无线的方式传送回云端（ ![](../../media/solutions/DTU/DTU应用领域.jpg)
图2 DTU应用领域
- ## 硬件选型 本方案支持多款QuecPython硬件设备，下面介绍`QuecPython EVB开发板`和`DP-DTU-Q600`。 @@ -35,14 +33,13 @@ DTU主要功能就是把设备的数据通过无线的方式传送回云端（ ![](../../media/solutions/DTU/quecpython_evb.png)
图3 QuecPython_EC2X_EVB_V2.0使用UART与TTL转USB连接电脑
- | 开发板上的PIN脚 | TTL转USB模块 | 图中线的颜色 | | --------------- | ------------ | ------------ | | J7的13脚(TX) | RX | 红线 | | J7的14脚(RX) | TX | 橙线 | | J7的3脚(GND) | GND | 黄线 | -更多开发板请参阅：https://python.quectel.com/doc/Quick_start/zh/index.html +更多开发板请参阅： #### DP-DTU-Q600产品介绍 @@ -51,7 +48,6 @@ DP-DTU-Q600 是一款 LTE CAT1 网络的 DTU，方便集成到工控机、工业 ![](../../media/solutions/DTU/DP-DTU-Q600.png)
图4 DP-DTU-Q600
- 产品规格： | 规格 | 参数 | @@ -84,7 +80,6 @@ DP-DTU-Q600 是一款 LTE CAT1 网络的 DTU，方便集成到工控机、工业 ![](../../media/solutions/DTU/DP-DTU-Q600硬件接口图示2.png)
图5 DP-DTU-Q600硬件接口
- 连接设备至开发机（本文采用`CP2102 USB to TTL模块`进行连接和调试）。 使用2根杜邦线分别连接`485A`、`485B`针脚，将`CP2102`连接至开发机的`USB`口（如图6所示）。 @@ -92,12 +87,11 @@ DP-DTU-Q600 是一款 LTE CAT1 网络的 DTU，方便集成到工控机、工业 ![](../../media/solutions/DTU/DTU_BOARD_003.jpg)
图6 DP600R连接开发机
- > 连接成功后，设备上电以及连接网络后`power`和`net`指示灯亮起。 #### 使用QPYcom调试 -安装QPYCom以及搭建QuecPython开发环境参考文档：https://python.quectel.com/doc/Quick_start/zh/index.html。 +安装QPYCom以及搭建QuecPython开发环境参考文档：。 ##### 打开repl串口 @@ -106,7 +100,6 @@ DP-DTU-Q600 是一款 LTE CAT1 网络的 DTU，方便集成到工控机、工业 ![](../../media/solutions/DTU/qpycom_select_port2.png)
图7 QPYCom打开repl串口
- ##### 下载脚本 创建下载项目 —— 切换到下载选项卡，点击创建项目，并输入任意项目名称。 @@ -116,13 +109,11 @@ DP-DTU-Q600 是一款 LTE CAT1 网络的 DTU，方便集成到工控机、工业 ![](../../media/solutions/DTU/qpycom_proj2.png)
图8 QPYCom新建项目
- 选择导入文件 —— 右击`usr`目录，在弹出的选择框中点击**一键导入**，继而选择我们DTU代码仓库中的**code**文件夹 —— 即将code中的所有代码一键导入至模组。如下图所示： ![](../../media/solutions/DTU/qpycom_add_file2.png)
图9 QPYCom一键导入脚本
- 导入脚本 —— 点击右下角`下载脚本`按钮，即可开始导入脚本。 ##### 运行DTU应用 @@ -132,7 +123,6 @@ DP-DTU-Q600 是一款 LTE CAT1 网络的 DTU，方便集成到工控机、工业 ![](../../media/solutions/DTU/qpycom_run2.png)
图10 QPYCom执行脚本
- DTU运行成功，在QPYcom的"交互"窗口中，可观察到打印如下。 > 应用程序运行依赖具体用户参数配置，比如配置MQTT连接参数等。参考后续DTU方案介绍章节。 @@ -140,7 +130,6 @@ DTU运行成功，在QPYcom的"交互"窗口中，可观察到打印如下。 ![](../../media/solutions/DTU/dtu_init2.png)
图11 QPYCom脚本输出日志
- ## 方案软件设计 ### 系统框图 @@ -148,7 +137,6 @@ DTU运行成功，在QPYcom的"交互"窗口中，可观察到打印如下。 ![](../../media/solutions/DTU/DTU组件图示4.png)
图12 DTU方案系统图示
- 组件说明： - 各类云对象：继承`modules.CloudObservable`并重写相应方法，主要实现云端初始化、连接以及数据收发等功能。