From b7a2f8fa2cb6b2748e1d5115b4c25269732b8564 Mon Sep 17 00:00:00 2001 From: "rex.zhou" Date: Thu, 3 Apr 2025 09:55:17 +0800 Subject: [PATCH 1/5] =?UTF-8?q?SPI=E5=9E=8B=E5=8F=B7=E8=B0=83=E6=95=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/peripherals/machine.SPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh/peripherals/machine.SPI.md b/zh/peripherals/machine.SPI.md index f376c0b..1690f03 100644 --- a/zh/peripherals/machine.SPI.md +++ b/zh/peripherals/machine.SPI.md @@ -315,7 +315,7 @@ - +
-- Gitee From 76461bef310dd23a481a930ba18ff9b6c6b1557e Mon Sep 17 00:00:00 2001 From: "rex.zhou" Date: Thu, 3 Apr 2025 11:32:47 +0800 Subject: [PATCH 2/5] =?UTF-8?q?en=20SPI=20=E5=9E=8B=E5=8F=B7=E8=B0=83?= =?UTF-8?q?=E6=95=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/peripherals/machine.SPI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/en/peripherals/machine.SPI.md b/en/peripherals/machine.SPI.md index e56269a..2fadef7 100644 --- a/en/peripherals/machine.SPI.md +++ b/en/peripherals/machine.SPI.md @@ -305,7 +305,7 @@ This class provides bus protocol of serial peripheral interface (SPI) .
SPI通道
- +
-- Gitee From 365a5dae9b7ecbe8470e5bd3303d97dc1ad8ed2d Mon Sep 17 00:00:00 2001 From: "rex.zhou" Date: Thu, 10 Apr 2025 17:35:04 +0800 Subject: [PATCH 3/5] =?UTF-8?q?SPI=E5=86=85=E5=AE=B9=E9=94=99=E8=AF=AF?= =?UTF-8?q?=E3=80=81SPI=E9=83=A8=E5=88=86=E5=9E=8B=E5=8F=B7=E6=9E=84?= =?UTF-8?q?=E9=80=A0=E5=87=BD=E6=95=B0=E5=8F=82=E6=95=B0=E4=BB=8B=E7=BB=8D?= =?UTF-8?q?=E7=BC=BA=E5=A4=B1=E3=80=81IIC=E7=A4=BA=E4=BE=8B=E5=8F=82?= =?UTF-8?q?=E6=95=B0=E5=86=97=E4=BD=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/peripherals/machine.I2C.md | 2 +- en/peripherals/machine.SPI.md | 19 +++++++++++++++++-- zh/peripherals/machine.I2C.md | 2 +- zh/peripherals/machine.SPI.md | 35 +++++++++++++++++++++++++---------- 4 files changed, 44 insertions(+), 14 deletions(-) diff --git a/en/peripherals/machine.I2C.md b/en/peripherals/machine.I2C.md index ecc0ffd..1d05ccf 100644 --- a/en/peripherals/machine.I2C.md +++ b/en/peripherals/machine.I2C.md @@ -84,7 +84,7 @@ This class is designed for the two-wire serial protocol for communication betwee ```python >>> from machine import I2C >>># Creates an I2C object ->>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE,0) # Returns an I2C object +>>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE) # Returns an I2C object ``` **I2C Pin Correspondences:** diff --git a/en/peripherals/machine.SPI.md b/en/peripherals/machine.SPI.md index 2fadef7..731b431 100644 --- a/en/peripherals/machine.SPI.md +++ b/en/peripherals/machine.SPI.md @@ -8,7 +8,7 @@ This class provides bus protocol of serial peripheral interface (SPI) .
-
+
class machine.SPI(spi, mode, clk, [group])

Parameter:

@@ -23,6 +23,21 @@ This class provides bus protocol of serial peripheral interface (SPI) .
+
+
class machine.SPI(spi, mode, clk, [group])
+
+

Parameter:

+
    +

  • port - Integer type. Channel selection: [0,1].

    +
    • +

  • mode - SPI working mode.
    Clock polarity CPOL: The pin level of clock signal SCLK when SPI is idle (0: low level; 1: high level)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

    +
    • +

  • clk - Clock frequency.
    0 ：100kHz
    1 ：200MHz
    2 ：300MHz
    3 ：400MHz
    4 ：500MHz
    5 ：600MHz
    6 ：700MHz7 ：812.5kHz
    8 ：1.625MHz
    9 ：3.25MHz
    10 ：6.5MHz
    11 ：13MHz
    12 ：26MHz
    13 ：52MHz

    +
    • +

    The 52MHz clock frequency has high requirements for hardware.

    +
+
+ 
class machine.SPI(spi, mode, clk, [group])
@@ -200,7 +215,7 @@ This class provides bus protocol of serial peripheral interface (SPI) .
SPI
- +
diff --git a/zh/peripherals/machine.I2C.md b/zh/peripherals/machine.I2C.md index 0c8e2f6..cac4bd1 100644 --- a/zh/peripherals/machine.I2C.md +++ b/zh/peripherals/machine.I2C.md @@ -85,7 +85,7 @@ ```python >>> from machine import I2C >>> # 创建I2C对象 ->>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE,0) # 返回I2C对象 +>>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE) # 返回I2C对象 ``` **I2C引脚对应关系：** diff --git a/zh/peripherals/machine.SPI.md b/zh/peripherals/machine.SPI.md index 1690f03..247df11 100644 --- a/zh/peripherals/machine.SPI.md +++ b/zh/peripherals/machine.SPI.md @@ -8,14 +8,14 @@
-
+
class machine.SPI(spi, mode, clk, [group])

参数描述：

  • spi - 通道选择[0,1]，int类型。

    • -

  • mode - I2C 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

    +

  • mode - SPI 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

  • clk - 时钟频率，说明如下：
    0 ：812.5kHz
    1 ：1.625MHz
    2 ：3.25MHz
    3 ：6.5MHz
    4 ：13MHz
    5 ：26MHz
    6 ：52MHz

    • @@ -23,6 +23,21 @@
+
+
class machine.SPI(spi, mode, clk, [group])
+
+

参数描述：

+
    +

  • spi - 通道选择[0,1]，int类型。

    +
    • +

  • mode - SPI 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

    +
    • +

  • clk - 时钟频率，说明如下：
    0 ：100kHz
    1 ：200kHz
    2 ：300MHz
    3 ：400MHz
    4 ：500MHz
    5 ：600MHz
    6 ：700MHz
    7 ：812.5kHz
    8 ：1.625MHz
    9 ：3.25MHz
    10 ：6.5MHz
    11 ：13MHz
    12 ：26MHz
    13 ：52MHz

    +
    • +

    52MHz时钟频率对硬件要求较高。

    +
+
+ 
class machine.SPI(spi, mode, clk, [group])
@@ -30,7 +45,7 @@

  • spi - 通道选择[0,1]，int类型。

    • -

  • mode - I2C 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

    +

  • mode - SPI 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

  • clk - 时钟频率，说明如下：
    0 ：812.5kHz
    1 ：1.625MHz
    2 ：3.25MHz
    3 ：6.5MHz
    4 ：13MHz

    • @@ -46,7 +61,7 @@

    • spi - 通道选择[0,1]，int类型。

      • -

    • mode - I2C 的工作模式，int类型，说明如下：
      时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
      0 ：CPOL=0, CPHA=0
      1 ：CPOL=0, CPHA=1
      2 ：CPOL=1, CPHA=0
      3 ：CPOL=1, CPHA=1

      +

    • mode - SPI 的工作模式，int类型，说明如下：
      时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
      0 ：CPOL=0, CPHA=0
      1 ：CPOL=0, CPHA=1
      2 ：CPOL=1, CPHA=0
      3 ：CPOL=1, CPHA=1

    • clk - 时钟频率，说明如下：
      0 ：812.5kHz
      1 ：1.625MHz
      2 ：3.25MHz
      3 ：6.5MHz
      4 ：13MHz

      • @@ -55,14 +70,14 @@
-
+
class machine.SPI(spi, mode, clk, [group])

参数描述：

  • spi - 通道选择[0,1]，int类型。

    • -

  • mode - I2C 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

    +

  • mode - SPI 的工作模式，int类型，说明如下：
    时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
    0 ：CPOL=0, CPHA=0
    1 ：CPOL=0, CPHA=1
    2 ：CPOL=1, CPHA=0
    3 ：CPOL=1, CPHA=1

  • clk - 时钟频率，说明如下：
    0 ：781.25KHz
    1 ：1.5625MHz
    2 ：3.125MHz
    3 ：5MHz
    4 ：6.25MHz
    5 ：10MHz
    6 ：12.5MHz
    7 ：20MHz
    8 ：25MHz
    9 ：33.33MHz

    • @@ -76,7 +91,7 @@

    • spi - 通道选择[0,1]，int类型。

      • -

    • mode - I2C 的工作模式，int类型，说明如下：
      时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
      0 ：CPOL=0, CPHA=0
      3 ：CPOL=1, CPHA=1

      +

    • mode - SPI 的工作模式，int类型，说明如下：
      时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
      0 ：CPOL=0, CPHA=0
      3 ：CPOL=1, CPHA=1

    • clk - 时钟频率，说明如下：
      0 ：781.25KHz
      X ：XMHz (X in [1,39])

      • @@ -90,7 +105,7 @@

      • spi - 通道选择[0,1]，int类型。

        • -

      • mode - I2C 的工作模式，int类型，说明如下：
        时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
        0 ：CPOL=0, CPHA=0
        1 ：CPOL=0, CPHA=1
        2 ：CPOL=1, CPHA=0
        3 ：CPOL=1, CPHA=1

        +

      • mode - SPI 的工作模式，int类型，说明如下：
        时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
        0 ：CPOL=0, CPHA=0
        1 ：CPOL=0, CPHA=1
        2 ：CPOL=1, CPHA=0
        3 ：CPOL=1, CPHA=1

      • clk - 时钟频率，说明如下：
        0 ：97.656kHz
        1 ：100kHz
        2 ：812.5kHz
        3 ：1.3MHz
        4 ：1.625MHz
        5 ：2MHz
        6 ：3.25MHz
        7 ：4.333MHz
        8 ：6.6MHz
        9 ：11.93MHz
        10 ：13MHz
        11 ：13.92MHz
        12 ：16.7MHz
        13 ：20.875MHz
        14 ：27.83MHz

        • @@ -104,7 +119,7 @@

        • spi - 通道选择[0,1]，int类型。

          • -

        • mode - I2C 的工作模式，int类型，说明如下：
          时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
          0 ：CPOL=0, CPHA=0
          1 ：CPOL=0, CPHA=1
          2 ：CPOL=1, CPHA=0
          3 ：CPOL=1, CPHA=1

          +

        • mode - SPI 的工作模式，int类型，说明如下：
          时钟极性CPOL：即SPI空闲时，时钟信号SCLK的电平(0:空闲时低电平; 1:空闲时高电平)
          0 ：CPOL=0, CPHA=0
          1 ：CPOL=0, CPHA=1
          2 ：CPOL=1, CPHA=0
          3 ：CPOL=1, CPHA=1

        • clk - 时钟频率，说明如下：
          0 ：500kHz
          1 ：1MHz
          2 ：5MHz
          3 ：10MHz
          4 ：20MHz

          • @@ -210,7 +225,7 @@
SPI
- +
-- Gitee From db1fb25f734cc26406a752688d29f27866df0d99 Mon Sep 17 00:00:00 2001 From: "rex.zhou" Date: Thu, 10 Apr 2025 17:58:08 +0800 Subject: [PATCH 4/5] =?UTF-8?q?IIC=E7=A4=BA=E4=BE=8B=E8=B0=83=E6=95=B4?= =?UTF-8?q?=E2=80=94=E2=80=94362K?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh/peripherals/machine.I2C.md | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/zh/peripherals/machine.I2C.md b/zh/peripherals/machine.I2C.md index cac4bd1..dd563e8 100644 --- a/zh/peripherals/machine.I2C.md +++ b/zh/peripherals/machine.I2C.md @@ -79,14 +79,27 @@ +
-**示例：** - -```python +
+

示例：

+

 >>> from machine import I2C
 >>> # 创建I2C对象
 >>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE)  # 返回I2C对象
-```
+
+
+ +
+

示例：

+

+>>> from machine import I2C
+>>> # 创建I2C对象
+>>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE,0)  # 返回I2C对象
+
+
+
+ **I2C引脚对应关系：** -- Gitee From 3554d67ad111b236fd1d4df878083a320491764e Mon Sep 17 00:00:00 2001 From: "rex.zhou" Date: Thu, 10 Apr 2025 18:01:16 +0800 Subject: [PATCH 5/5] =?UTF-8?q?IIC=20en=E7=A4=BA=E4=BE=8B=E8=B0=83?= =?UTF-8?q?=E6=95=B4=E2=80=94=E2=80=94362K?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/peripherals/machine.I2C.md | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/en/peripherals/machine.I2C.md b/en/peripherals/machine.I2C.md index 1d05ccf..591559e 100644 --- a/en/peripherals/machine.I2C.md +++ b/en/peripherals/machine.I2C.md @@ -78,14 +78,27 @@ This class is designed for the two-wire serial protocol for communication betwee
+
-**Example:** - -```python +
+

Example:

+

 >>> from machine import I2C
->>># Creates an I2C object
+>>> # Creates an I2C object
 >>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE)  # Returns an I2C object
-```
+
+
+ +
+

Example:

+

+>>> from machine import I2C
+>>> # Creates an I2C object
+>>> i2c_obj = I2C(I2C.I2C0, I2C.STANDARD_MODE,0)  # Returns an I2C object
+
+
+
+ **I2C Pin Correspondences:** -- Gitee
SPI通道