+
-- 参数
- *period*:整型。中断周期,单位:毫秒。
- *mode*:
+注意:
- 常量。定时器运行模式,如下:
+1. from machine import Timer即为让Timer模块在当前空间可见。
+2. 只有from machine import Timer模块,才能使用Timer内的函数和变量。
+3. 上述操作没有连接任何外设,仅作为熟悉指令参考。
- Timer.ONE_SHOT 单次模式,定时器只执行一次
- Timer.PERIODIC 周期模式,循环执行
- *callback*: 回调函数,定时执行的函数。
+## 下载验证
-- 返回值
+### 软件代码
- 0 定时器启动成功。 -1 定时器启动失败。
+配套demo的参考代码为文档同目录下的timer_file.py文件。下载.py文件到模组运行,代码如下:
点击下载代码
-**timer.stop**
+```python
+import log
+from machine import Timer
+log.basicConfig(level=log.INFO) # 设置日志输出级别
+Timer_Log = log.getLogger("Quectel") # 获取logger对象
+log_print_num = 5
+state = 1
+timer0 = Timer(Timer.Timer1)
+# 创建一个执行函数,并将timer实例传入
+def timer_test(t):
+ global log_print_num
+ global state
+ Timer_Log.info('log_print_num is %d' % log_print_num)
+ log_print_num -= 1
+ if log_print_num <= 0:
+ Timer_Log.info('timer exit')
+ state = 0
+ timer0.stop() # 结束该定时器实例
+timer0.start(period=1000, mode=timer0.PERIODIC, callback=timer_test) # 启动定时器
+while state:
+ pass
+
+```
-> 该函数用于关闭定时器。
-- 函数原型
- timer.stop()
+### 硬件连接:
-- 参数
+本文验证仅对timer,无需外接外设。
- 无。
+### 运行效果
-- 返回值
+1. 打开QPYcom运行timer\_file.py,如下图:
- 0 定时器关闭成功。 -1 定时器关闭失败。
+
+
+
+2. 在QPYcom交互界面查看输出结果如下:
-#### 附录
+
+
-> 表 **1**:术语缩写
-| 术语 | 英文全称 | 中文全称 |
-| ---- | --------------------------------- | ---------------- |
-| API | Application Programming Interface | 应用程序编程接口 |
diff --git a/docs/Advanced_development/zh/QuecPythonSub/ADC.md b/docs/sbs/zh/BSP/ADC.md
similarity index 77%
rename from docs/Advanced_development/zh/QuecPythonSub/ADC.md
rename to docs/sbs/zh/BSP/ADC.md
index a3216a4c719d33a1027efa1db83b22c214aa3029..573350acac2a01c2a53c60725d2fabe26d9d0a3f 100644
--- a/docs/Advanced_development/zh/QuecPythonSub/ADC.md
+++ b/docs/sbs/zh/BSP/ADC.md
@@ -1,18 +1,24 @@
+## 修订历史
+
+| 版本 | 日期 | 作者 | 变更表述 |
+| ---- | ---------- | ------ | -------------------------------------------------- |
+| 1.0 | 2021-09-10 | Kayden | 增加修订历史,参考链接,更换截图和代码下载链接位置 |
+
# **QuecPython ADC采样开发使用说明**
## 硬件描述
本文主要基于EC600S_QuecPython_EVB进行介绍,其他开发板类同。
-本部分介绍可结合光敏传感器实验进行学习:https://python.quectel.com/doc/doc/little_demo/zh/QuecPythonTest/Photoresistor.html
+本部分介绍可结合光敏传感器实验进行学习:[光敏传感器实验](https://python.quectel.com/doc/doc/little_demo/zh/QuecPythonTest/Photoresistor.html)
目前EC600S开放共2路ADC,2路ADC连接位置如下图所示:
-其他模组开放ADC情况可查看硬件支持内容,链接:https://python.quectel.com/doc/doc/Quecpython_intro/zh/Qp_Product_intro/Hardware_Support.html
+其他模组开放ADC情况可查看硬件支持内容:[硬件支持](https://python.quectel.com/doc/doc/Quecpython_intro/zh/Qp_Product_intro/Hardware_Support.html)
-具体ADC相关API使用介绍链接:https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=adc
+具体ADC相关API使用介绍:[ADC相关API](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=adc)
-ADC硬件原理图请查看模组硬件设计手册和开发板原理图,官网下载链接:https://python.quectel.com/download
+ADC硬件原理图请查看模组硬件设计手册和开发板原理图[官网下载链接](https://python.quectel.com/download)
资料如有缺失可在QQ群搜索群文件获取:445121768
diff --git a/docs/Advanced_development/zh/QuecPythonSub/I2C.md b/docs/sbs/zh/BSP/I2C.md
old mode 100755
new mode 100644
similarity index 83%
rename from docs/Advanced_development/zh/QuecPythonSub/I2C.md
rename to docs/sbs/zh/BSP/I2C.md
index 2d8551bd9c7c2c1079e945bbc31dfb2a17b34bc6..6353ee806ea51908ecf6b12f084ca72c080feb6e
--- a/docs/Advanced_development/zh/QuecPythonSub/I2C.md
+++ b/docs/sbs/zh/BSP/I2C.md
@@ -1,3 +1,9 @@
+## 修订历史
+
+| 版本 | 日期 | 作者 | 变更描述 |
+| ---- | ---------- | ------ | -------------------------------------------- |
+| 1.0 | 2021-09-13 | Kayden | 增加修订历史,删除参考代码,新增参考实验链接 |
+
## 简介
本文主要介绍QuecPython I2C模块的使用。
@@ -41,6 +47,6 @@ I2C的数据和地址传输都带响应。响应包括“应答(ACK)”和
### 快速开始
1. 具体关于 QuecPython I2C 的详细的API 请参考:[QuecPython-machine - 硬件相关功能-I2C](https://python.quectel.com/wiki/#/zh-cn/api/QuecPythonClasslib?id=i2c)
-2. 关于I2C的应用实验详情参考内部温度传感器实验:https://python.quectel.com/doc/doc/little_demo/zh/QuecPythonTest/i2c_aht.html
-3. 关于I2C的应用实验详情还可以参考加速度传感器实验:https://python.quectel.com/doc/doc/little_demo/zh/QuecPythonTest/i2c_lis2dh.html
+2. 关于I2C的应用实验详情参考温湿度传感器实验:[温湿度传感器实验](https://python.quectel.com/doc/doc/little_demo/zh/QuecPythonTest/i2c_aht.html)
+3. 关于I2C的应用实验详情还可以参考加速度传感器实验:[加速度传感器实验](https://python.quectel.com/doc/doc/little_demo/zh/QuecPythonTest/i2c_lis2dh.html)
diff --git a/docs/Advanced_development/zh/QuecPythonSub/code/adc_file.py b/docs/sbs/zh/BSP/code/adc_file.py
similarity index 100%
rename from docs/Advanced_development/zh/QuecPythonSub/code/adc_file.py
rename to docs/sbs/zh/BSP/code/adc_file.py
diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/ADC_1.png b/docs/sbs/zh/BSP/media/ADC_1.png
similarity index 100%
rename from docs/Advanced_development/zh/QuecPythonSub/media/ADC_1.png
rename to docs/sbs/zh/BSP/media/ADC_1.png
diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/ADC_2.png b/docs/sbs/zh/BSP/media/ADC_2.png
similarity index 100%
rename from docs/Advanced_development/zh/QuecPythonSub/media/ADC_2.png
rename to docs/sbs/zh/BSP/media/ADC_2.png
diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/ADC_3.png b/docs/sbs/zh/BSP/media/ADC_3.png
similarity index 100%
rename from docs/Advanced_development/zh/QuecPythonSub/media/ADC_3.png
rename to docs/sbs/zh/BSP/media/ADC_3.png
diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_03.png b/docs/sbs/zh/BSP/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_03.png
similarity index 100%
rename from docs/Advanced_development/zh/QuecPythonSub/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_03.png
rename to docs/sbs/zh/BSP/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_03.png
diff --git a/docs/Advanced_development/zh/QuecPythonSub/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_04.png b/docs/sbs/zh/BSP/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_04.png
similarity index 100%
rename from docs/Advanced_development/zh/QuecPythonSub/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_04.png
rename to docs/sbs/zh/BSP/media/Qp_Advanced_development_QuecPythonSub_i2c_bus_04.png
diff --git a/docs/sbs/zh/sidebar.yaml b/docs/sbs/zh/sidebar.yaml
index 76718ad17cef480a705ef0102e99bd27e4630604..7d26d6166a16e73181352f60a463249d2aebd9c0 100644
--- a/docs/sbs/zh/sidebar.yaml
+++ b/docs/sbs/zh/sidebar.yaml
@@ -13,11 +13,12 @@ items:
- label: PWM开发
file: BSP/PWM开发.md
- label: ADC采样开发
- file: BSP/ADC采样开发.md
+ file: BSP/ADC.md
- label: SPI总线开发
file: BSP/SPI.md
- label: 网络应用
items:
+
- label: dataCall数据拨号
file: QuecPythonWirelessNetwork/DataCall.md
- label: SIM卡功能开发