diff --git a/docs/Application_guide/en/media/network-comm/nic/cellular/data-stream.png b/docs/Application_guide/en/media/network-comm/nic/cellular/data-stream.png index aa5c87eb088bafd04bc7ab893ed9fc2750746851..f6540a5bfed6f10349d9f4cbec3633ec81d94a26 100644 Binary files a/docs/Application_guide/en/media/network-comm/nic/cellular/data-stream.png and b/docs/Application_guide/en/media/network-comm/nic/cellular/data-stream.png differ diff --git a/docs/Application_guide/en/network-comm/nic/cellular/api-instruction.md b/docs/Application_guide/en/network-comm/nic/cellular/api-instruction.md index ba7c1769c82131b344bf02562afd2ed83acbddb0..2b63e9b3dcb0815ed3cd05cd4c1232a631c88e2b 100644 --- a/docs/Application_guide/en/network-comm/nic/cellular/api-instruction.md +++ b/docs/Application_guide/en/network-comm/nic/cellular/api-instruction.md @@ -12,7 +12,7 @@ Device work modes refer to the functionality modes of mobile terminals, also kno net.getModemFun() ``` -Referring to the [CFUN](./common-concepts.html#CFUN) section in the introduction to cellular network basics, the module has three work modes. Only when the module is in mode 1 (full functionality), can it communicate with the cellular network. +Referring to the [CFUN](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/common-concepts.html#CFUN) section in the introduction to cellular network basics, the module has three work modes. Only when the module is in mode 1 (full functionality), can it communicate with the cellular network. ### Set the Module Work Mode @@ -64,13 +64,13 @@ You can call the above functions to get and set the parameters of the NIC in the For how to configure APN, please refer to the following sections in the *Scenario Instructions* chapter, which provide detailed APN configuration examples: -* [Automatically Activate One NIC at Startup and Configure APN](./application.html#Automatically-Activate-One-NIC-at-Startup-and-Configure-APN) +* [Automatically Activate One NIC at Startup and Configure APN](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/application.html#Automatically-Activate-One-NIC-at-Startup-and-Configure-APN) -* [Automatically Activate Multiple NICs at Startup and Configure APN](./application.html#Automatically-Activate-Multiple-NICs-at-Startup-and-Configure-APN) +* [Automatically Activate Multiple NICs at Startup and Configure APN](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/application.html#Automatically-Activate-Multiple-NICs-at-Startup-and-Configure-APN) -* [Manually Activate One NIC](./application.html#Manually-Activate-One-NIC) +* [Manually Activate One NIC](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/application.html#Manually-Activate-One-NIC) -* [Manually Activate Multiple NICs](./application.html#Manually-Activate-Multiple-NICs) +* [Manually Activate Multiple NICs](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/application.html#Manually-Activate-Multiple-NICs) @@ -98,8 +98,8 @@ If you disable the automatic activation of cellular NICs at startup and set a pr For how to manually activate NICs, please refer to the following sections in the *Scenario Instructions* chapter, which provide detailed APN configuration examples: -* [Manually Activate One NIC](./application.html#Manually-Activate-One-NIC) -* [Manually Activate Multiple NICs](./application.html#Manually-Activate-Multiple-NICs) +* [Manually Activate One NIC](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/application.html#Manually-Activate-One-NIC) +* [Manually Activate Multiple NICs](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/application.html#Manually-Activate-Multiple-NICs) @@ -210,13 +210,13 @@ In practical use, due to various reasons (such as network exception, environment For how to use network event listening to handle network exceptions, please refer to the following section in the *Handle Network Exceptions* chapter: -* [Example of Handling Network Exception Events](./exception-handling.html#Example-of-Handling-Network-Exception-Events) +* [Example of Handling Network Exception Events](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/exception-handling.html#Example-of-Handling-Network-Exception-Events) ## Get Signal Strength -QuecPython provides APIs to obtain parameters such as signal strength and signal quality. These parameters can help you determine the signal strength and signal quality of the current device's environment. The commonly used parameters include CSQ, RSSI, SINR, RSRP, and RSRQ. It is recommended to read the [Signal Quality](./common-concepts.html#Signal-Quality) section in the *Basic Concepts of Cellular Network* chapter together. Please refer to [Get Signal Strength](https://python.quectel.com/doc/API_reference/en/iotlib/net.html#Get-Signal-Strength) and [Get Detailed Signal Strength](https://python.quectel.com/doc/API_reference/en/iotlib/net.html#Get-Detailed-Signal-Strength) in the wiki on the QuecPython official website for details. +QuecPython provides APIs to obtain parameters such as signal strength and signal quality. These parameters can help you determine the signal strength and signal quality of the current device's environment. The commonly used parameters include CSQ, RSSI, SINR, RSRP, and RSRQ. It is recommended to read the [Signal Quality](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/common-concepts.html#Signal-Quality) section in the *Basic Concepts of Cellular Network* chapter together. Please refer to [Get Signal Strength](https://python.quectel.com/doc/API_reference/en/iotlib/net.html#Get-Signal-Strength) and [Get Detailed Signal Strength](https://python.quectel.com/doc/API_reference/en/iotlib/net.html#Get-Detailed-Signal-Strength) in the wiki on the QuecPython official website for details. ### Query Signal Strength and Quality diff --git a/docs/Application_guide/en/network-comm/nic/cellular/initialization.md b/docs/Application_guide/en/network-comm/nic/cellular/initialization.md index a567419d954bfd9679cf0d6206a08076150a51a6..2824fa13fe336af3cadb86e1f55045e5fdfb3e3f 100644 --- a/docs/Application_guide/en/network-comm/nic/cellular/initialization.md +++ b/docs/Application_guide/en/network-comm/nic/cellular/initialization.md @@ -64,7 +64,7 @@ When the parameter indicated by the red box in the figure in the return value of > If the module fails to register on a network, please refer to the following section in the "*Handle Network Exceptions*" chapter for troubleshooting: > -> * [Module Network Registration Failure](./exception-handling.html#Module-Network-Registration-Failure) +> * [Module Network Registration Failure](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/exception-handling.html#Module-Network-Registration-Failure) ## NIC Activation @@ -86,4 +86,4 @@ When the return value of the `dataCall.getInfo()` method indicates that the NIC > If the module fails to activate the NIC, please refer to the following section in the "*Handle Network Exceptions*" chapter for troubleshooting: > -> * [Handle Network Exceptions](./exception-handling.html#Handle-Network-Exceptions) \ No newline at end of file +> * [Handle Network Exceptions](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/exception-handling.html#Handle-Network-Exceptions) \ No newline at end of file diff --git a/docs/Application_guide/en/network-comm/nic/cellular/mechanism.md b/docs/Application_guide/en/network-comm/nic/cellular/mechanism.md index 57cea837c244d03404b4d2f9f1b3038a959b420c..fd48c8f2370c4e1bc4551e104fb84ed017478662 100644 --- a/docs/Application_guide/en/network-comm/nic/cellular/mechanism.md +++ b/docs/Application_guide/en/network-comm/nic/cellular/mechanism.md @@ -224,7 +224,7 @@ if __name__ == '__main__': main() ``` -The above example aims to give you an intuitive understanding of QuecPython's network event listening feature. If you need to use this feature in actual projects, please refer to the [*Example of Handling Network Exception Events*](./exception-handling.html#Example-of-Handling-Network-Exception-Events). +The above example aims to give you an intuitive understanding of QuecPython's network event listening feature. If you need to use this feature in actual projects, please refer to the [*Example of Handling Network Exception Events*](https://python.quectel.com/doc/Application_guide/en/network-comm/nic/cellular/exception-handling.html#Example-of-Handling-Network-Exception-Events). diff --git a/docs/Application_guide/zh/network-comm/nic/cellular/FAQ.md b/docs/Application_guide/zh/network-comm/nic/cellular/FAQ.md index c2ae2302c606f0b44085eee8307b17afe617b540..ededcf3d8e03542f66656fa41e64a639b30cf86c 100644 --- a/docs/Application_guide/zh/network-comm/nic/cellular/FAQ.md +++ b/docs/Application_guide/zh/network-comm/nic/cellular/FAQ.md @@ -28,7 +28,7 @@ APN是终端入网时必须配置的一个参数，它决定了终端通过哪 **问题4：SIM卡可以识别，但是无法注网是什么原因？** -这种情况相对比较复杂，参考前面一个章节《网络异常处理》中的[模组网络注册失败](./exception-handling.html#模组网络注册失败)部分，这里仅列出比较常见的几种原因： +这种情况相对比较复杂，参考前面一个章节《网络异常处理》中的[模组网络注册失败](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/exception-handling.html#%E6%A8%A1%E7%BB%84%E7%BD%91%E7%BB%9C%E6%B3%A8%E5%86%8C%E5%A4%B1%E8%B4%A5)部分，这里仅列出比较常见的几种原因： * 没接射频天线或者射频天线性能差。 * 该SIM卡需要配置APN才能注册到网络，但是用户没有配置APN。 diff --git a/docs/Application_guide/zh/network-comm/nic/cellular/api-instruction.md b/docs/Application_guide/zh/network-comm/nic/cellular/api-instruction.md index cf6c56e827f4218633db5d4bc1b82297162df936..45e74be68791c1a5ed55a4cbc0e16a381d8e9c6f 100644 --- a/docs/Application_guide/zh/network-comm/nic/cellular/api-instruction.md +++ b/docs/Application_guide/zh/network-comm/nic/cellular/api-instruction.md @@ -12,7 +12,7 @@ net.getModemFun() ``` -结合蜂窝网络基础概念介绍中的[CFUN](./common-concepts.html#CFUN)部分说明，模组有3种工作模式，只有处于模式1（全功能模式）时，模组才能与蜂窝网络进行通信。 +结合蜂窝网络基础概念介绍中的[CFUN](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/common-concepts.html#CFUN)部分说明，模组有3种工作模式，只有处于模式1（全功能模式）时，模组才能与蜂窝网络进行通信。 ### 设置模组工作模式 @@ -63,13 +63,13 @@ dataCall.setPDPContext(profileID, ipType, apn, username, password, authType) 关于如何配置APN，可以参考《场景使用说明》章节中的下面几个部分，这几部分都提供了详细的APN配置示例： -* [开机自动激活一路网卡且配置APN](./application.html#开机自动激活一路网卡且没有配置APN) +* [开机自动激活一路网卡且配置APN](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E5%BC%80%E6%9C%BA%E8%87%AA%E5%8A%A8%E6%BF%80%E6%B4%BB%E4%B8%80%E8%B7%AF%E7%BD%91%E5%8D%A1%E4%B8%94%E6%B2%A1%E6%9C%89%E9%85%8D%E7%BD%AEAPN) -* [开机自动激活多路网卡且配置APN](./application.html#开机自动激活多路网卡且配置APN) +* [开机自动激活多路网卡且配置APN](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E5%BC%80%E6%9C%BA%E8%87%AA%E5%8A%A8%E6%BF%80%E6%B4%BB%E5%A4%9A%E8%B7%AF%E7%BD%91%E5%8D%A1%E4%B8%94%E9%85%8D%E7%BD%AEAPN) -* [手动激活一路网卡](./application.html#手动激活一路网卡) +* [手动激活一路网卡](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E6%89%8B%E5%8A%A8%E6%BF%80%E6%B4%BB%E4%B8%80%E8%B7%AF%E7%BD%91%E5%8D%A1) -* [手动激活多路网卡](./application.html#手动激活多路网卡) +* [手动激活多路网卡](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E6%89%8B%E5%8A%A8%E6%BF%80%E6%B4%BB%E5%A4%9A%E8%B7%AF%E7%BD%91%E5%8D%A1) @@ -97,9 +97,9 @@ QuecPython的模组默认开机都会自动激活蜂窝无线网卡，因此大 关于如何手动激活无线网卡，可以参考《场景使用说明》章节中的下面几个部分，这几部分都提供了详细的APN配置示例： -* [手动激活一路网卡](./application.html#手动激活一路网卡) +* [手动激活一路网卡](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E6%89%8B%E5%8A%A8%E6%BF%80%E6%B4%BB%E4%B8%80%E8%B7%AF%E7%BD%91%E5%8D%A1) -* [手动激活多路网卡](./application.html#手动激活多路网卡) +* [手动激活多路网卡](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E6%89%8B%E5%8A%A8%E6%BF%80%E6%B4%BB%E5%A4%9A%E8%B7%AF%E7%BD%91%E5%8D%A1) @@ -210,13 +210,13 @@ dataCall.setCallback(fun) 关于网络事件监听具体如何使用，可以参考《网络异常处理》章节中的如下部分： -* [网络异常事件处理示例](./exception-handling.html#网络异常事件处理示例) +* [网络异常事件处理示例](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/exception-handling.html#%E7%BD%91%E7%BB%9C%E5%BC%82%E5%B8%B8%E4%BA%8B%E4%BB%B6%E5%A4%84%E7%90%86%E7%A4%BA%E4%BE%8B) ## 获取信号强度 -QuecPython提供了相关API用来获取信号强度和信号质量等参数。这些参数可以帮助用户确定当前设备所处环境的信号强度和信号质量。用户常用的几个参数有CSQ、RSSI、SINR、RSRP以及RSRQ。建议用户结合前面的蜂窝网络基础概念章节中的[信号质量](./common-concepts.html#信号质量)部分一起看看。下面这些方法的详细说明，请请参考QuecPython官网wiki说明的[获取CSQ信号强度](https://python.quectel.com/doc/API_reference/zh/iotlib/net.html#%E8%8E%B7%E5%8F%96CSQ%E4%BF%A1%E5%8F%B7%E5%BC%BA%E5%BA%A6)和[获取详细信号强度](https://python.quectel.com/doc/API_reference/zh/iotlib/net.html#%E8%8E%B7%E5%8F%96%E8%AF%A6%E7%BB%86%E4%BF%A1%E5%8F%B7%E5%BC%BA%E5%BA%A6)。 +QuecPython提供了相关API用来获取信号强度和信号质量等参数。这些参数可以帮助用户确定当前设备所处环境的信号强度和信号质量。用户常用的几个参数有CSQ、RSSI、SINR、RSRP以及RSRQ。建议用户结合前面的蜂窝网络基础概念章节中的[信号质量](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/common-concepts.html#%E4%BF%A1%E5%8F%B7%E8%B4%A8%E9%87%8F)部分一起看看。下面这些方法的详细说明，请请参考QuecPython官网wiki说明的[获取CSQ信号强度](https://python.quectel.com/doc/API_reference/zh/iotlib/net.html#%E8%8E%B7%E5%8F%96CSQ%E4%BF%A1%E5%8F%B7%E5%BC%BA%E5%BA%A6)和[获取详细信号强度](https://python.quectel.com/doc/API_reference/zh/iotlib/net.html#%E8%8E%B7%E5%8F%96%E8%AF%A6%E7%BB%86%E4%BF%A1%E5%8F%B7%E5%BC%BA%E5%BA%A6)。 ### 查询信号强度与质量 diff --git a/docs/Application_guide/zh/network-comm/nic/cellular/common-concepts.md b/docs/Application_guide/zh/network-comm/nic/cellular/common-concepts.md index c95797fe7ef872407fb5a8fae93c73a7b41da950..6b5b370b8e15c19a152bd536a758b935d85fed62 100644 --- a/docs/Application_guide/zh/network-comm/nic/cellular/common-concepts.md +++ b/docs/Application_guide/zh/network-comm/nic/cellular/common-concepts.md @@ -12,13 +12,13 @@ APN（Access Point Name，接入点名称）指一种网络接入技术，是终 关于APN的配置接口说明，可以参考QuecPython官方网站Wiki说明的[APN配置与获取功能](https://python.quectel.com/doc/API_reference/zh/iotlib/dataCall.html#APN%E9%85%8D%E7%BD%AE%E4%B8%8E%E8%8E%B7%E5%8F%96%E5%8A%9F%E8%83%BD)部分，具体的配置使用示例，可以参考如下几个部分： -* [开机自动激活一路网卡且配置APN](./application.html#开机自动激活一路网卡且没有配置APN) +* [开机自动激活一路网卡且配置APN](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E5%BC%80%E6%9C%BA%E8%87%AA%E5%8A%A8%E6%BF%80%E6%B4%BB%E4%B8%80%E8%B7%AF%E7%BD%91%E5%8D%A1%E4%B8%94%E6%B2%A1%E6%9C%89%E9%85%8D%E7%BD%AEAPN) -* [开机自动激活多路网卡且配置APN](./application.html#开机自动激活多路网卡且配置APN) +* [开机自动激活多路网卡且配置APN](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E5%BC%80%E6%9C%BA%E8%87%AA%E5%8A%A8%E6%BF%80%E6%B4%BB%E5%A4%9A%E8%B7%AF%E7%BD%91%E5%8D%A1%E4%B8%94%E9%85%8D%E7%BD%AEAPN) -* [手动激活一路网卡](./application.html#手动激活一路网卡) +* [手动激活一路网卡](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E6%89%8B%E5%8A%A8%E6%BF%80%E6%B4%BB%E4%B8%80%E8%B7%AF%E7%BD%91%E5%8D%A1) -* [手动激活多路网卡](./application.html#手动激活多路网卡) +* [手动激活多路网卡](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/application.html#%E6%89%8B%E5%8A%A8%E6%BF%80%E6%B4%BB%E5%A4%9A%E8%B7%AF%E7%BD%91%E5%8D%A1) ### 确认用什么APN @@ -28,7 +28,7 @@ APN（Access Point Name，接入点名称）指一种网络接入技术，是终 ## CFUN -CFUN（Cellular Functionality，蜂窝功能）指移动终端的功能模式。我们在提到CFUN时，一般都是指使用`net`模块的相关方法或者`AT+CFUN`这个AT命令，来设置或者查询移动终端的功能模式。关于如何查询和设置CFUN，请参考《蜂窝网络API说明》章节的[设备工作模式](./api-instruction.html#设备工作模式)部分。移动终端通常有如下几种功能模式： +CFUN（Cellular Functionality，蜂窝功能）指移动终端的功能模式。我们在提到CFUN时，一般都是指使用`net`模块的相关方法或者`AT+CFUN`这个AT命令，来设置或者查询移动终端的功能模式。关于如何查询和设置CFUN，请参考《蜂窝网络API说明》章节的[设备工作模式](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/api-instruction.html#%E8%AE%BE%E5%A4%87%E5%B7%A5%E4%BD%9C%E6%A8%A1%E5%BC%8F)部分。移动终端通常有如下几种功能模式： * 最小功能模式：该模式下，整个射频网络协议栈全部关闭，SIM卡模块停止供电。这种模式下，终端设备功耗是不关机情况下最低的。 diff --git a/docs/Application_guide/zh/network-comm/nic/cellular/initialization.md b/docs/Application_guide/zh/network-comm/nic/cellular/initialization.md index 3c1c62850777751add47e57d0e7465f2317ffb83..4379470b8e3edfc3534b2ed00f0e5fc45793d829 100644 --- a/docs/Application_guide/zh/network-comm/nic/cellular/initialization.md +++ b/docs/Application_guide/zh/network-comm/nic/cellular/initialization.md @@ -68,7 +68,7 @@ net.getState() > 如果模组网络注册失败，请参考《网络异常处理》章节中如下部分进行排查： > -> * [模组网络注册失败](./exception-handling.html#模组网络注册失败) +> * [模组网络注册失败](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/exception-handling.html#%E6%A8%A1%E7%BB%84%E7%BD%91%E7%BB%9C%E6%B3%A8%E5%86%8C%E5%A4%B1%E8%B4%A5) @@ -94,5 +94,5 @@ dataCall.getInfo(profileID, ipType) > 如果模组无线网卡激活失败，请先请参考《网络异常处理》章节中如下部分进行排查： > -> * [网络异常处理](./exception-handling.html#网络异常处理) +> * [网络异常处理](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/exception-handling.html#%E7%BD%91%E7%BB%9C%E5%BC%82%E5%B8%B8%E5%A4%84%E7%90%86) diff --git a/docs/Application_guide/zh/network-comm/nic/cellular/mechanism.md b/docs/Application_guide/zh/network-comm/nic/cellular/mechanism.md index 5c4c0d0cab713c2d4579347badcad7a0087627c5..e7584137186acaa1f06ebfca528a5d42748bb547 100644 --- a/docs/Application_guide/zh/network-comm/nic/cellular/mechanism.md +++ b/docs/Application_guide/zh/network-comm/nic/cellular/mechanism.md @@ -236,7 +236,7 @@ if __name__ == '__main__': main() ``` -上面的示例仅仅是为了让用户直观的感受一下QuecPython的网络事件监控功能。如果用户需要在实际项目中使用，请参考后续《网络异常处理》章节中[网络异常事件处理示例](./exception-handling.html#网络异常事件处理示例)部分。 +上面的示例仅仅是为了让用户直观的感受一下QuecPython的网络事件监控功能。如果用户需要在实际项目中使用，请参考后续《网络异常处理》章节中[网络异常事件处理示例](https://python.quectel.com/doc/Application_guide/zh/network-comm/nic/cellular/exception-handling.html#%E7%BD%91%E7%BB%9C%E5%BC%82%E5%B8%B8%E4%BA%8B%E4%BB%B6%E5%A4%84%E7%90%86%E7%A4%BA%E4%BE%8B)部分。