From fdbf4d0133ee72d0bd802f15d79ffcf8fa64904d Mon Sep 17 00:00:00 2001 From: "Rich.wu" Date: Thu, 18 May 2023 13:59:58 +0800 Subject: [PATCH] =?UTF-8?q?fix=20(=E7=BD=91=E7=BB=9C=E4=B8=8E=E9=80=9A?= =?UTF-8?q?=E4=BF=A1):=20=E6=96=87=E6=A1=A3=E4=B8=AD=E5=BC=95=E5=85=A5wiki?= =?UTF-8?q?=20api=E6=8E=A5=E5=8F=A3=E4=BC=98=E5=8C=96=EF=BC=8C=E7=9B=AE?= =?UTF-8?q?=E5=BD=95=E4=BC=98=E5=8C=96=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 固件版本: N/A 是否需要文案翻译: 否 ######################################################################################## # # # 示例： # # # # fix (network): 重复创建并关闭socket一定次数后，无法再次创建socket。 # # # # 1. 调用select接口并在其它线程调用socket.close()时，socket引用计数没有自减， # # 由于socket总数（即引用计数）有上限，导致创建一定数量的socket无法再次创建socket。 # # # # 2. 调用socket.close()释放资源时，将引用计数自减，及时释放出被占用的资源，修复该问题。# # # # 固件版本：EC600MCNLAR02_QPY # # # # 是否需要文案翻译: 是 # # # ######################################################################################## # # # 说明： # # # # <提交类型> 用于说明提交的类型，一般有以下几种： # # - feat: 新增feature。 # # - fix: 修复bug。 # # - docs: 仅仅修改了文档，如readme.md。 # # - style: 仅仅是对格式进行修改，如逗号、缩进、空格等。不改变代码逻辑。 # # - refactor: 代码重构，没有新增功能或修复bug。 # # - perf: 优化相关，如提升性能、用户体验等。 # # - test: 测试用例，包括单元测试、集成测试。 # # - chore: 改变构建流程、或者增加依赖库、工具等。 # # - revert: 版本回滚。 # # # # <功能范围> 用于说明提交影响的功能范围。 # # # # <修改点简述> 提交目的的简短描述。 # # # # <修改点详述> 用于详细描述修改点，可选。不填写，请删除该行；若填写，请描述以下内容： # # - 为何进行修改 # # - 如何解决问题的 # # - 是否有副作用（必要时） # # # ######################################################################################## --- docs/Getting_started/zh/network-comm/README.md | 8 ++------ .../zh/network-comm/apn-and-datacall.md | 12 ++++++------ docs/Getting_started/zh/network-comm/preparation.md | 10 +++++----- docs/Getting_started/zh/network-comm/sms.md | 13 +------------ 4 files changed, 14 insertions(+), 29 deletions(-) diff --git a/docs/Getting_started/zh/network-comm/README.md b/docs/Getting_started/zh/network-comm/README.md index 1f2cbca2..2889ced2 100644 --- a/docs/Getting_started/zh/network-comm/README.md +++ b/docs/Getting_started/zh/network-comm/README.md @@ -1,10 +1,8 @@ # 6: QuecPython 物联网基础功能 -本章主要介绍 QuecPython 的一些网络与通信，并使用系统自带的一些常用功能，如: 网络注册、数据拨号、通信等，具体可展开目录查看。 - -
- 6 QuecPython 网络与通信 +本章主要介绍 QuecPython 的一些网络与通信，并使用系统自带的一些常用功能，如: 网络注册、数据拨号、电话，短信以及常见通信等。 +QuecPython 物联网基础网络与通信主要包括以下功能： - [6.1 天线、SIM 卡和网络注册](./preparation.md) @@ -25,5 +23,3 @@ - [6.9 短信](./sms.md) - [6.10 通信异常处理](./exceptions.md) - -
\ No newline at end of file diff --git a/docs/Getting_started/zh/network-comm/apn-and-datacall.md b/docs/Getting_started/zh/network-comm/apn-and-datacall.md index 20a2db8a..bc11fd33 100644 --- a/docs/Getting_started/zh/network-comm/apn-and-datacall.md +++ b/docs/Getting_started/zh/network-comm/apn-and-datacall.md @@ -63,7 +63,7 @@ APN接入点名称由两部分组成： ### 设备检查 -本章介绍的内容是基于Python SDK中包含的API来实现的，请参考QuecPython官网的Wiki文档中相关部分的说明。 +本章介绍的内容是基于Python SDK中包含的API来实现的，请参考[QuecPython官网的Wiki文档中dataCAll](../../../API_reference/zh/QuecPython_classlib/dataCall.md)相关部分的说明。 拨号之前需做一系列基本检查，判断模块是否处于基本的正常工作状态，具体步骤如下： @@ -249,7 +249,7 @@ if __name__ == "__main__": 1. 拨号成功--能够查询到拨号信息 - 对于大部分公网卡和可以连上公网的专网卡而言，一般利用核心网下发的APN，进行拨号，并保存在文件系统里面，可以通过dataCall.getPDPContext(1)查询PDP Context相关信息。 + 对于大部分公网卡和可以连上公网的专网卡而言，一般利用核心网下发的APN，进行拨号，可以通过dataCall.getPDPContext(1)查询当前PDP Context(APN)相关信息。 ```python import dataCall @@ -321,7 +321,7 @@ else: 1. 拨号成功--能够查询到正确的拨号信息 -正常情况下使用正确的APN进行拨号，都能够拨号成功，并保存在文件系统里面，可以通过dataCall.getPDPContext(1)查询PDP Context相关信息。 +正常情况下使用正确的APN进行拨号，都能够拨号成功，可以通过dataCall.getPDPContext(1)查询PDP Context相关信息。 ```python import dataCall @@ -333,9 +333,9 @@ dataCall.getPDPContext(1) 2. 拨号失败--查询不到拨号信息 -部分为APN配置错误造成的，如没有配置对应运营商的APN，配置错专网卡特有的APN。需要先确认APN的正确性。 +部分为APN配置错误造成的，如没有配置对应运营商的APN，配置错专网卡特有的APN，需要先确认APN的正确性。 -部分为网络、SIM卡或模块自身问题造成的，如SIM卡欠费、限制，网络断开，信号质量差等其它原因，需要和运营商或研发人员确认。 +部分为网络、SIM卡或模块自身问题造成的，如SIM卡欠费、限制，网络断开，信号质量差等其它原因，需要和FAE或运营商确认。 ### 场景三：中途换卡 @@ -343,7 +343,7 @@ dataCall.getPDPContext(1) 如删除过文件系统的PDP Context相关信息，拨号场景见场景一。 -开机后，默认会自动执行第一路拨号，使用文件系统中配置的APN进行拨号。可以直接查询拨号信息。 +开机后，默认会自动执行第一路拨号，使用文件系统中配置的APN进行拨号，可以直接查询拨号信息。 1. 拨号成功--能够查询到拨号信息 diff --git a/docs/Getting_started/zh/network-comm/preparation.md b/docs/Getting_started/zh/network-comm/preparation.md index 165637d4..126fe948 100644 --- a/docs/Getting_started/zh/network-comm/preparation.md +++ b/docs/Getting_started/zh/network-comm/preparation.md @@ -66,7 +66,7 @@ ICCID全称为Integrated Circuit Card Identifier，即集成电路卡识别码 ### 功能实现 -QuecPython模块支持SIM卡相关功能实现，具体见[`SIM`模块](..../API_reference/zh/QuecPython_classlib/sms.md)接口的详细说明，请参考QuecPython官网的Wiki文档中相关部分的说明。下面是简单介绍如何使用`SIM`模块的相关功能。 +QuecPython模块支持SIM卡相关功能实现，具体请参考[QuecPython官网的Wiki文档中`sim`模块](../../../API_reference/zh/QuecPython_classlib/sim.md)相关部分的说明。下面是简单介绍如何使用`SIM`模块的相关功能。 #### 交互实验 @@ -108,11 +108,11 @@ QuecPython模块支持SIM卡相关功能实现，具体见[`SIM`模块](..../API #### 注网确认 -我们可以通过QuecPython官网中[`net`模块](..../API_reference/zh/QuecPython_classlib/net.md)接口查看网络注册状态，请参考QuecPython官网的Wiki文档中相关部分的说明。下面是简单介绍网络注册相关功能。 +我们可以通过QuecPython官网中`net`接口查看网络注册状态，请参考[QuecPython官网的Wiki文档中`net`模块](../../../API_reference/zh/QuecPython_classlib/net.md)相关部分的说明。下面是简单介绍网络注册相关功能。 ```python >>> import net ->>> net.getState() # 查看网络注册状态，具体结果含义间QuecPython官网的Wiki文档 +>>> net.getState() # 查看网络注册状态，具体结果含义见QuecPython官网的Wiki文档 ([0, 0, 0, 0, 0, 0], [1, 21771, 254626386, 7, 0, 0]) # 第一个列表代表电话注册状态，0 代表电话注网失败 # 第二个列表代表网络注册状态，1 代表网络注册成功 @@ -128,9 +128,9 @@ QuecPython模块支持SIM卡相关功能实现，具体见[`SIM`模块](..../API （1）首先确认天线是否正常的，是否和模块匹配； -（2）如果天线正常，确认SIM卡状态是正常的，通过 sim 模块的sim.getState()接口获取，为1说明正常； +（2）如果天线正常，确认SIM卡状态是正常的，通过 [sim 模块的sim.getState()接口](../../../API_reference/zh/QuecPython_classlib/sim.md)获取，为1说明正常； -（3）如果SIM卡状态正常，确认当前信号强度，通过net模块的net.csqQueryPoll()接口获取，如果信号强度比较弱，那么可能是因为当前信号强度较弱导致短时间内注网不成功，可以增加超时时间或者换个信号比较好的位置再尝试； +（3）如果SIM卡状态正常，确认当前信号强度，通过[net模块的net.csqQueryPoll()接口](../../../API_reference/zh/QuecPython_classlib/net.md)获取，如果信号强度比较弱，那么可能是因为当前信号强度较弱导致短时间内注网不成功，可以增加超时时间或者换个信号比较好的位置再尝试； （4）如果SIM卡状态正常，信号强度也较好，请确认使用的SIM卡是否已经欠费或流量不足； diff --git a/docs/Getting_started/zh/network-comm/sms.md b/docs/Getting_started/zh/network-comm/sms.md index 3ef02bbb..31757b35 100644 --- a/docs/Getting_started/zh/network-comm/sms.md +++ b/docs/Getting_started/zh/network-comm/sms.md @@ -24,7 +24,7 @@ QuecPython 短信功能支持PDU短信的生成和解析。 短信功能是移动通信网络中的一种基本服务，它可以实现文字、图片、音频等多种信息的快速传输和交流。 -在QuecPython中短信功能的接口主要在[sms](/../../../API_reference/zh/QuecPython类库/sms.html)中。 +在QuecPython中短信功能的接口主要在[QuecPython官网的Wiki文档中`sms`模块](../../../API_reference/zh/QuecPython_classlib/sms.md)中。 下面是QuecPython短信功能的应用说明： @@ -40,13 +40,7 @@ QuecPython 短信功能支持PDU短信的生成和解析。 # 发送TEXT短信 >>> sms.sendTextMsg('18158626517', '这是一条中文测试短信！', 'UCS2') 0 ->>> sms.sendTextMsg('18158626517', 'Hello, world.', 'GSM') -0 ->>> sms.sendTextMsg('18158626517', '这是一条夹杂中文与英文的测试短信,hello world!', 'UCS2') -0 # 发送PDU短信 ->>> sms.sendPduMsg('18158626517', 'send pdu msg by GSM mode.', 'GSM') -0 >>> sms.sendPduMsg('18158626517', 'send pdu msg by UCS2 mode.', 'UCS2') 0 >>> sms.sendPduMsg('18158626517', '这是一条中文测试短信！通过PDU-UCS2模式', 'UCS2') @@ -54,17 +48,12 @@ QuecPython 短信功能支持PDU短信的生成和解析。 # 删除短信 >>> sms.deleteMsg(2) #删除索引号为2的那一条短信 0 ->>> sms.deleteMsg(1,4) #删除所有短信 -0 # 获取短信数量 >>> sms.getMsgNums() # 执行本行前，先发送一条短信到模块 1 # 查询短信存储位置 >>> sms.getSaveLoc() (['SM', 2, 50], ['SM', 2, 50], ['SM', 2, 50]) -# 设置短信存储位置 ->>> sms.setSaveLoc('SM','ME','MT') -0 >>> sms.getSaveLoc() (['SM', 2, 50], ['ME', 14, 180], ['MT', 2, 50]) >>> sms.sendPduMsg('+8618226172342', '123456789aa', 'GSM') # 自己给自己发送一条短信 -- Gitee