diff --git a/docs/sbs/zh/BSP/GPIO.md b/docs/sbs/zh/BSP/GPIO.md index 218833c5849f9fee351eedd68f074eabf11e2b2f..73e941f9577b6bb13c731c7df492f46bf8481fc2 100644 --- a/docs/sbs/zh/BSP/GPIO.md +++ b/docs/sbs/zh/BSP/GPIO.md @@ -1,8 +1,8 @@ ## 修订历史 -| Version | Date | Author | Change expression | -| ------- | ---------- | ------ | ----------------- | -| 1.0 | 2021-09-06 | David | Initial version | +| Version | Date | Author | Change expression | +| ------- | ---------- | ---------- | ----------------- | +| 1.0 | 2021-09-06 | David.Tang | Initial version | ## PIN diff --git a/docs/sbs/zh/BSP/PWM.md b/docs/sbs/zh/BSP/PWM.md index c85bae3fb8a1995336889b342019b337d3618cf8..b569f260e5fb3af6ade608aeaa00866693bf26c2 100644 --- a/docs/sbs/zh/BSP/PWM.md +++ b/docs/sbs/zh/BSP/PWM.md @@ -1,8 +1,8 @@ ## 修订历史 -| Version | Date | Author | Change expression | -| ------- | ---------- | ------ | ----------------- | -| 1.0 | 2021-09-06 | David | Initial version | +| Version | Date | Author | Change expression | +| ------- | ---------- | ---------- | ----------------- | +| 1.0 | 2021-09-06 | David.Tang | Initial version | 文档主要基于EC600X(包括EC600S、EC600N、EC600U)介绍如何使用 QuecPython_PWM。PWM是一种对模拟信号电平进行数字编码的方法。根据相应载荷的变化来调制晶体管基极或MOS管栅极的偏置,来实现晶体管或MOS管导通时间的改变,从而实现开关稳压电源输出的改变。这种方式能使电源的输出电压在工作条件变化时保持恒定,是利用微处理器的数字信号对模拟电路进行控制的一种非常有效的技术。脉冲宽度调制是利用微处理器的数字输出来对模拟电路进行控制的一种非常有效的技术,广泛应用在从测量、通信到功率控制与变换的许多领域中。 diff --git a/docs/sbs/zh/BSP/UART.md b/docs/sbs/zh/BSP/UART.md index 7fbd5c8598bd6089419aac8df5055d69cbf7784e..c5a538beac3aa14e3f77afbb98d5c02881117e13 100644 --- a/docs/sbs/zh/BSP/UART.md +++ b/docs/sbs/zh/BSP/UART.md @@ -1,8 +1,8 @@ ## 修订历史 -| Version | Date | Author | Change expression | -| ------- | ---------- | ------ | ----------------- | -| 1.0 | 2021-09-02 | David | Initial version | +| Version | Date | Author | Change expression | +| ------- | ---------- | ---------- | ----------------- | +| 1.0 | 2021-09-02 | David.Tang | Initial version | 文档主要基于EC600X(包括EC600S、EC600N、EC600U)介绍如何使用QuecPython_UART,UART作为一种通用串行数据总线,用于异步通信,可实现全双工传输和接收。在嵌入式设计中,UART用来与PC进行通信,包括监控调试器和其它器件。通过本文你将了解到EC600X_UART的所有设置参数及使用方法。 diff --git a/docs/sbs/zh/QuecPythonPlatform/Audio.md b/docs/sbs/zh/QuecPythonPlatform/Audio.md new file mode 100644 index 0000000000000000000000000000000000000000..40caf497d1984c0422027121396fa35f70976b23 --- /dev/null +++ b/docs/sbs/zh/QuecPythonPlatform/Audio.md @@ -0,0 +1,72 @@ +## 修订历史 +| 版本 | 日期 | 作者 | 变更表述 | +|------|------|------|------| +| 1.0 | 2021-4-6 | gary.zhou | 初版 | +| 1.1 | 2021-9-16 | David.Tang | 增加多模组的适用性 | + + +## 硬件连接 + +| 开发板型号 | 开发板对应PIN脚 | 开发板上对应的连接位置 | 对应的音频通道 | +| -------------------------------------------------------- | ------------------------------ | ---------------------- | -------------- | +| EC600S_QuecPython_EVB_V1.3
EC600N_QuecPython_EVB_V1.3 | PIN21、PIN22 | J7 | 通道0 | +| EC600U_QuecPython_EVB_V1.3 | PIN21、PIN22
PIN109、PIN110 | J7
J6的PIN14、PIN15 | 通道0
通道2 | + +针对EC600S/N的硬件连接图如下: + +![audio_01](media/audio_01.png) + +针对EC600U_通道0的硬件连接图如下: + +![audio_02](media/audio_02.png) + +针对EC600U_通道2的硬件连接图如下: + +![audio_03](media/audio_03.png) + +## 下载验证 + +1. 根据测试场景,调整下面代码的注释。 + + ```python + # -*- coding: UTF-8 -*- + #备注如下: + #(1)对于EC600S和EC600N的话,下面的代码不需要做任何修改,就可以播放 + #(2)对于EC600U的通道0的话,注释掉18行(18行的配置对这个播放没有影响) + #(3)对于EC600U的通道2的话,注释掉12行和19行,取消注释13行; + import utime as time + import audio + from machine import Pin + + + def example_audio_mp3(): + aud = audio.Audio(0) # 配置通道0 + # aud = audio.Audio(2) # 配置通道2 + aud.setVolume(9) + ''' + 使能外接喇叭播放 + ''' + # Pin(Pin.GPIO11, Pin.OUT, Pin.PULL_PD, 1) # 官方板V1.1使用 + Pin(Pin.GPIO9, Pin.OUT, Pin.PULL_PD, 1) # 官方板V1.2和V1.3使用 + # U: 表示用户目录, GUI下载工具会将文件下载到 /usr 文件下 + aud.play(2, 1, "U:/example.mp3") + pass + + if __name__ == "__main__": + example_audio_mp3() + ``` + + + +2. 将随包的 example.mp3 和修改好的 example_audio_file.py 文件下载到开发板中。 + +3. 运行 example_audio_file.py 脚本即可。 + + + + +## 配套代码 + + + + 下载代码和音频文件 \ No newline at end of file diff --git a/docs/sbs/zh/QuecPythonPlatform/code/Audio.rar b/docs/sbs/zh/QuecPythonPlatform/code/Audio.rar new file mode 100644 index 0000000000000000000000000000000000000000..64e38e8f83702c2c0c98d5f04a30638ddb56f757 Binary files /dev/null and b/docs/sbs/zh/QuecPythonPlatform/code/Audio.rar differ diff --git a/docs/sbs/zh/QuecPythonPlatform/code/example.mp3 b/docs/sbs/zh/QuecPythonPlatform/code/example.mp3 new file mode 100644 index 0000000000000000000000000000000000000000..1d36dd78c62237d5a4ecd1f32841815ed3e33a3e Binary files /dev/null and b/docs/sbs/zh/QuecPythonPlatform/code/example.mp3 differ diff --git a/docs/sbs/zh/QuecPythonPlatform/code/example_audio_file.py b/docs/sbs/zh/QuecPythonPlatform/code/example_audio_file.py new file mode 100644 index 0000000000000000000000000000000000000000..84df3371f4262067e32079631fc313147558d2d3 --- /dev/null +++ b/docs/sbs/zh/QuecPythonPlatform/code/example_audio_file.py @@ -0,0 +1,25 @@ +# -*- coding: UTF-8 -*- +#备注如下: +#(1)对于EC600S和EC600N的话,下面的代码不需要做任何修改,就可以播放 +#(2)对于EC600U的通道0的话,注释掉18行(18行的配置对这个播放没有影响) +#(3)对于EC600U的通道2的话,注释掉12行和19行,取消注释13行; +import utime as time +import audio +from machine import Pin + + +def example_audio_mp3(): + aud = audio.Audio(0) # 配置通道0 + # aud = audio.Audio(2) # 配置通道2 + aud.setVolume(9) + ''' + 使能外接喇叭播放 + ''' + # Pin(Pin.GPIO11, Pin.OUT, Pin.PULL_PD, 1) # 官方板V1.1使用 + Pin(Pin.GPIO9, Pin.OUT, Pin.PULL_PD, 1) # 官方板V1.2和V1.3使用 + # U: 表示用户目录, GUI下载工具会将文件下载到 /usr 文件下 + aud.play(2, 1, "U:/example.mp3") + pass + +if __name__ == "__main__": + example_audio_mp3() diff --git a/docs/sbs/zh/QuecPythonPlatform/media/audio_01.png b/docs/sbs/zh/QuecPythonPlatform/media/audio_01.png new file mode 100644 index 0000000000000000000000000000000000000000..3c344a43085a495f5d412a085723b18fb5d44f1d Binary files /dev/null and b/docs/sbs/zh/QuecPythonPlatform/media/audio_01.png differ diff --git a/docs/sbs/zh/QuecPythonPlatform/media/audio_02.png b/docs/sbs/zh/QuecPythonPlatform/media/audio_02.png new file mode 100644 index 0000000000000000000000000000000000000000..a2511585b7ddd55e77c0a1bfebff9e2aac3ffc88 Binary files /dev/null and b/docs/sbs/zh/QuecPythonPlatform/media/audio_02.png differ diff --git a/docs/sbs/zh/QuecPythonPlatform/media/audio_03.png b/docs/sbs/zh/QuecPythonPlatform/media/audio_03.png new file mode 100644 index 0000000000000000000000000000000000000000..0d13edd79a3ab670db63680908314b8c8f67d41b Binary files /dev/null and b/docs/sbs/zh/QuecPythonPlatform/media/audio_03.png differ diff --git a/docs/sbs/zh/QuecPythonWirelessNetwork/sim.md b/docs/sbs/zh/QuecPythonWirelessNetwork/sim.md index 6c931616a6e34442c2e0a28b9df1f1ac5aa03d1d..f952e5148494e6c4eefbe749d858ddf24a81e1a5 100644 --- a/docs/sbs/zh/QuecPythonWirelessNetwork/sim.md +++ b/docs/sbs/zh/QuecPythonWirelessNetwork/sim.md @@ -1,8 +1,8 @@ ## 修订记录 -| 版本 | 日期 | 作者 | 变更表述 | -| ---- | ---------- | ------ | ------------ | -| 1.0 | 2021-09-13 | Kayden | 初始版本修订 | +| 版本 | 日期 | 作者 | 变更表述 | +| ---- | ---------- | ---------- | ------------ | +| 1.0 | 2021-09-13 | David.Tang | 初始版本修订 | ## 前言