From 4335bff93dcc0a27338c3483a4683b8d417e97eb Mon Sep 17 00:00:00 2001 From: ZhouZaihang Date: Sat, 17 Jul 2021 13:56:32 +0800 Subject: [PATCH 1/2] =?UTF-8?q?fix:=20i2c=20=E5=BC=95=E8=84=9A=E5=AE=9A?= =?UTF-8?q?=E4=B9=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- machine/I2C/README.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/machine/I2C/README.md b/machine/I2C/README.md index cd033fc..53c97eb 100644 --- a/machine/I2C/README.md +++ b/machine/I2C/README.md @@ -106,13 +106,7 @@ ## I2C引脚定义 -共有7个引脚可以用作 I²C 的通讯引脚。 - -<<<<<<< HEAD:machine/IIC/README.md -  waffle nano拥有 2 个 I²C 总线端口，根据用户的配置，总线端口可以用作 I²C 主机。其中组号为0的I²C已经被板载内置传感器所使用，无法进行跟多额外操作。 -======= -  waffle nano拥有 2 个 I²C 总线端口，根据用户的配置，总线端口可以用作 I²C 主机。 ->>>>>>> master:machine/I2C/README.md +waffle nano 共有7个引脚可以用作 I²C 的通讯引脚。拥有 2 个 I²C 总线端口，根据用户的配置，总线端口可以用作 I²C 主机。 > 其中板载内置传感器连接到引脚：`Pin9，Pin10`。所以在操作板载传感器时需配置 `0` 号端口 I²C 总线对象，比如 `i2c = I2C(0, sda=Pin(10), scl=Pin(9)`。 -- Gitee From 2a6ae0a2b7d920829c3c7b9e2c7de817cd623bda Mon Sep 17 00:00:00 2001 From: ZhouZaihang Date: Sat, 17 Jul 2021 14:13:27 +0800 Subject: [PATCH 2/2] =?UTF-8?q?fix:=20=E4=BF=AE=E8=AE=A2ADC=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- machine/ADC/README.md | 41 +++++++++++++++++++++++------------------ 1 file changed, 23 insertions(+), 18 deletions(-) diff --git a/machine/ADC/README.md b/machine/ADC/README.md index 26e87c4..285a574 100644 --- a/machine/ADC/README.md +++ b/machine/ADC/README.md @@ -15,24 +15,28 @@ ## 概要 -  本节讲解ADC的概念，以及MicroPython中的ADC实现。 +  本文档介绍 `ADC` 的概念，以及 `OpenHarmony` 中 `Python` 的 `ADC` 接口。`Waffle NanoV1` 的 `ADC` 模块具有以下功能特点： + +- 输入时钟 3MHz，12bit 采样精度，单通道采样频率<200KHz。 +- 共 8 个通道，支持软件配置 0～7 任意通道使能，逻辑按通道编号先低后高发起切换，每个通道采样 1 个数，通道切换时会使 ADC 电路进行 1 次复位处理。 +- 支持对 ADC 采样数据进行平均滤波处理，平均次数支持 1（不进行平均）、2、4、8；多通道时，每个通道接收 N 个数据（平均滤波个数）再切换通道。 ### ADC是什么 -- ADC的英文全称是Analog / Digital Converter，是将模拟信号转换为数字信号的转换器，ADC是单片机读取传感器信号的常见方式。 +- `ADC` 的英文全称是`Analog / Digital Converter`，是将模拟信号转换为数字信号的转换器，ADC是单片机读取传感器信号的常见方式。 - 日常生活中的信号，例如光照强度，声波，电池电压 这些都是模拟值。 想对模拟信号(电压，光照强度，声波)进行测量，用数字信号进行表达，这个时候需要**ADC** 模拟数字信号转换器。 ## ADC通用方法集合 -  ADC接口定义了完成ADC传输的通用方法集合，包括： +  `ADC`接口定义了完成`ADC`传输的通用方法集合，包括： -- ADC初始化 +- `ADC`初始化 - 设置平均算法采样次数 -- 读取ADC采样数据 +- 读取`ADC`采样数据 ## ADC引脚定义 -  有7个引脚有ADC功能，分别对应ADC的7个通道。（注意，在Waffle Nano中 9、10号引脚作为与板载传感器沟通的主要线路,3,4号引脚作为REPL的主要线路，这四个引脚已被使用，无法进行二次使用） +  有7个引脚有`ADC`功能，分别对应`ADC`的7个通道。（注意，在`Waffle Nano`中 `9`、`10`号引脚作为与板载传感器沟通的主要线路,`3`,`4`号引脚作为`REPL`的主要线路，**这四个引脚已被使用，无法用作别的功能**） | 引脚 | 功能 | | ------ | ---- | @@ -46,7 +50,7 @@ ## machine.ADC API详解 -  使用`from machine import ADC`导入 `machine` 模块的模数转换类 `ADC` +  使用 `from machine import ADC` 导入 `machine` 模块的模数转换类 `ADC`   再使用 `TAB` 按键来查看 `ADC` 中所包含的内容： @@ -73,6 +77,8 @@ EQU_MODEL_8 EQU_MODEL_BUTT equ   class machine.ADC(channel) +可传入参数： + - `channel`：ADC通道 ### 构建ADC @@ -81,7 +87,7 @@ EQU_MODEL_8 EQU_MODEL_BUTT equ ```python >>> from machine import ADC,Pin ->>> adc=ADC(Pin(7)) #将GPIO 7 设置为ADC +>>> adc=ADC(Pin(7)) #将Pin 7 设置为ADC ``` ### 函数 @@ -110,20 +116,20 @@ adc=ADC(Pin(7)) ```python >>> from machine import ADC,Pin ->>> adc=ADC(Pin(7)) #将GPIO 7 设置为ADC +>>> adc=ADC(Pin(7)) #将Pin 7 设置为ADC >>> adc.equ(ADC.EQU_MODEL_8) #设置ADC平均算法的采样次数为8次 True ``` #### ADC测量电压范围 -  默认电压为3.3V，引脚不可能超过管脚电压**3.3v**。 +  默认电压为`3.3V`，引脚不可能超过管脚电压**3.3v**。 #### ADC采样   `adc.read()` -  函数说明：进行ADC采样，返回采样数据 +  函数说明：进行`ADC`采样，返回采样数据   示例： @@ -136,17 +142,16 @@ True ## 示例 -  将waffle nano的一些GPIO引脚设置成ADC，看其电压变化如何。 +  `将waffle nano`的一些`GPIO`引脚设置成`ADC`，看其电压变化如何。 ```python -from machine import Pin +from machine import ADC,Pin adc=ADC(Pin(7)) adc.equ(ADC.EQU_MODEL_8) adc.read() ``` -- 第一行导入 machine 模块的硬件类 Pin和数模转换类ADC -- 第二行把waffle nano默认的GPIO 7号引脚设置为ADC通道3 -- 第三行设置ADC的平均计算的采样次数为8次 -- 第四行读取采样值 - +- 第一行导入 `machine` 模块的硬件类 `Pin` 和数模转换类 `ADC` +- 第二行把`waffle nano` 7号引脚设置为默认的`GPIO` 功能，并作为参数创建为 `ADC` 对象 +- 第三行设置 `ADC` 的平均计算的采样次数为 `8` 次 +- 第四行读取采样值 \ No newline at end of file -- Gitee