diff --git a/docs/Advanced_development/zh/QuecPythonSub/TTS.md b/docs/Advanced_development/zh/QuecPythonSub/TTS.md index 17d2d71fea4144b03ed0b94f6ad5416cd97c99a0..c351977087b0ac4d3c788d73644bd45f985cfe7f 100644 --- a/docs/Advanced_development/zh/QuecPythonSub/TTS.md +++ b/docs/Advanced_development/zh/QuecPythonSub/TTS.md @@ -6,7 +6,7 @@ ## api介绍 移远通信为您提供的TTS API 支持音量设置、播放语速设置等。 -具体的API 详解请参考[QuecPython-audio - 音频播放-TTS](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=tts) +具体的API详解请参考[QuecPython-audio - 音频播放-TTS](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=tts) 本文档适用于移远通信如下模块： diff --git a/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp01.png b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp01.png new file mode 100644 index 0000000000000000000000000000000000000000..d3ff00fe6989a40b433d3c2a88feb41cdd47908f Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp01.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp02.png b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp02.png new file mode 100644 index 0000000000000000000000000000000000000000..01a07df983814ad728c799bfb93d48d33662da4a Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp02.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp03.png b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp03.png new file mode 100644 index 0000000000000000000000000000000000000000..cf01c852045c1a2b91b96c5498b7143e31ef16bc Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp03.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp04.png b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp04.png new file mode 100644 index 0000000000000000000000000000000000000000..ced3c491f839bb0aaf03315e37ba1433a7ba430d Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp04.png differ diff --git a/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp05.png b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp05.png new file mode 100644 index 0000000000000000000000000000000000000000..489fc4e8e019475afad73bbde61b4f09212d1f3f Binary files /dev/null and b/docs/sbs/zh/sbs/media/QuecPython_sbs_ntp05.png differ diff --git a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_01.jpg b/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_01.jpg deleted file mode 100644 index 5cea8816683d74c21e46ce2fef2a6284cbb3de5c..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_01.jpg and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_02.jpg b/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_02.jpg deleted file mode 100644 index d52ad53600c875b2eeed4112065048f46aca2e83..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_02.jpg and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_03.jpg b/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_03.jpg deleted file mode 100644 index 112b314a04770e39281c970cbe001e9d824b7596..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_03.jpg and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_04.jpg b/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_04.jpg deleted file mode 100644 index e3a27be745600db0d74850f9505bf6ee173f596c..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_04.jpg and /dev/null differ diff --git a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_05.jpg b/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_05.jpg deleted file mode 100644 index cee2f46c33980eed78a8e6047d137cec427b819a..0000000000000000000000000000000000000000 Binary files a/docs/sbs/zh/sbs/media/Quectel_Qp_ntp_how_to_use_05.jpg and /dev/null differ diff --git a/docs/sbs/zh/sbs/ntp.md b/docs/sbs/zh/sbs/ntp.md index ea108b0e764a95a79103c588360323cf1caa3e57..ca8e9736281d7b6e16cb607e0727f66799aff9b6 100644 --- a/docs/sbs/zh/sbs/ntp.md +++ b/docs/sbs/zh/sbs/ntp.md @@ -1,76 +1,65 @@ -### NTP 使用指导 +# NTP 使用指导 -#### 概述 +## 概述 ​ NTP又称网络时间协议，用于同步计算机时间的一种协议。该协议可以使计算机对其服务器或时钟源（如石英钟，GPS等等）进行同步，同时提供高精准度的时间校正（LAN上与标准时间差小于 1 毫秒，WAN上与标准时间差大约有几十毫秒），且可介由加密确认的方式来防止恶毒的协议攻击。NTP的目的是在无序的互联网环境中提供精确和健壮的时间服务。 -​ NTP提供准确时间，首先要有准确的时间来源，即国际标准时间UTC。NTP获得UTC的时间来源可 - -以是原子钟、天文台、卫星，也可以从互联网上获取。时间按NTP服务器的等级传播，按照离外部UTC时间源的远近将所有服务器归入不同的Stratum（层）中。Stratum- 1 在顶层，有外部UTC接入；Stratum- 2从Stratum- 1 获取时间；Stratum- 3 从Stratum- 2 获取时间，......，以此类推，但Stratum的总数限制在 15以内。所有这些服务器在逻辑上形成阶梯式的架构相互连接，而Stratum- 1 的时间服务器是整个系统的基础。计算机主机一般同多个时间服务器连接，利用统计学的算法过滤来自不同服务器的时间，以选择最佳的路径和来源来校正主机时间，即使主机在长时间无法与某一时间服务器相联系的情况下，NTP服务依然有效运转。 +​ NTP提供准确时间，首先要有准确的时间来源，即国际标准时间UTC。NTP获得UTC的时间来源可以是原子钟、天文台、卫星，也可以从互联网上获取。时间按NTP服务器的等级传播，按照离外部UTC时间源的远近将所有服务器归入不同的Stratum（层）中。Stratum- 1 在顶层，有外部UTC接入；Stratum- 2从Stratum- 1 获取时间；Stratum- 3 从Stratum- 2 获取时间，......，以此类推，但Stratum的总数限制在 15以内。所有这些服务器在逻辑上形成阶梯式的架构相互连接，而Stratum- 1 的时间服务器是整个系统的基础。计算机主机一般同多个时间服务器连接，利用统计学的算法过滤来自不同服务器的时间，以选择最佳的路径和来源来校正主机时间，即使主机在长时间无法与某一时间服务器相联系的情况下，NTP服务依然有效运转。 ​ 为防止对时间服务器的恶意破坏，NTP使用了识别(Authentication)机制，检查来对时的信息是否是真正来自所宣称的服务器并检查资料的返回路径，以提供对抗干扰的保护机制。NTP时间同步报文中包含的时间是格林威治时间，是从 1900 年开始计算的秒数。 -#### 功能实现 +## api介绍 + +具体的API详解请参考[QuecPython-ntptime-NTP对时](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonThirdlib?id=ntptime-ntp对时) -NTP对时需要从NTP服务器上获取时间，故在实现NTP对时功能之前需连接网络。本文档以通过SIM +## 功能实现 -卡进行联网为例。 +NTP对时需要从NTP服务器上获取时间，故在实现NTP对时功能之前需连接网络。本文档以通过SIM卡进行联网为例。 -1. 准备一张可用的Nano SIM卡，滑动打开开发板上SIM卡槽，放入SIM卡后合上卡槽盖子并通电， - 等待自动拨号。以EC100Y-CN为例，SIM卡槽位置如图所示： +### 操作一： + 准备一张可用的SIM卡，插入SIM卡后通电，等待自动拨号。以EC600S-CN为例，EC600S_QuecPython_EVB_V1.1开发板配备的是NANO SIM卡座，自弹式，触点向下，缺口向内。SIM卡槽位置如图所示： - ![](media/Quectel_Qp_ntp_how_to_use_01.jpg) + ![](media/QuecPython_sbs_ntp01.png) ​ 图 1 ：插入SIM卡 自动拨号后，可通过如下方法验证是否拨号成功： -![](media/Quectel_Qp_ntp_how_to_use_02.jpg) +![](media/QuecPython_sbs_ntp03.png) ​ 图 2 ：自动拨号成功验证 -1. 拨号成功后，导入ntptime模块 - - ``` - import ntptime - ntptime.host - ``` - - +### 操作二： - 返回当前的NTP服务器，默认为"ntp.aliyun.com"。 + 拨号成功后，导入ntptime模块，返回当前的NTP服务器，默认为"ntp.aliyun.com"。 - ![](media/Quectel_Qp_ntp_how_to_use_03.jpg) + ![](media/QuecPython_sbs_ntp02.png) ​ 图 3 ：当前NTP服务器 -2. 设置NTP服务器。设置成功返回 0 ，设置失败返回- 1 。 +### 操作三： - ``` - ntptime.sethost(host) - ``` + 设置NTP服务器。设置成功返回 0 ，设置失败返回- 1 。 - ![](media/Quectel_Qp_ntp_how_to_use_04.jpg) + ![](media/QuecPython_sbs_ntp04.png) ​ 图 4 ：设置NTP服务器 -3. 同步NTP时间。同步成功返回 0 ，同步失败返回- 1 。 +### 操作四： - ``` - ntptime.settime() - ``` + 使用 ntptime.settime() 同步NTP时间。同步成功返回 0 ，同步失败返回- 1 。 - ​ 对时结果可使用utime.localtime()验证。执行utime.localtime()后返回当前时间，返回值为一个元组：(year, month, mday, hour, minute, second, weekday, yearday)。详细说明请参考《QuectelQuecPython类库API说明》。 + ​对时结果可使用utime.localtime()验证。执行utime.localtime()后返回当前时间，返回值为一个元组：(year, month, mday, hour, minute, second, weekday, yearday)。具体的API详解请参考[QuecPython-utime-与时间相关功能](https://python.quectel.com/wiki/#/zh-cn/api/pythonStdlib?id=utime-与时间相关功能)。 - ​ ntptime.settime()对时后返回时间为UTC时间，北京时间领先UTC八个小时，所以对时后，对比当前时间可发现时间后退八小时。 + ​ntptime.settime()对时后返回时间为UTC时间，北京时间领先UTC八个小时，所以对时后，对比当前时间可发现时间后退八小时。 - ![](media/Quectel_Qp_ntp_how_to_use_05.jpg) + ![](media/QuecPython_sbs_ntp05.png) ​ 图 5 ：对时成功 -#### 附录术语缩写 +## 附录术语缩写 表 1 ：术语缩写