【雕爷学编程】MicroPython手册之 pyboard 的 UART（串行总线）

MicroPython是为了在嵌入式系统中运行Python 3编程语言而设计的轻量级版本解释器。与常规Python相比，MicroPython解释器体积小(仅100KB左右)，通过编译成二进制Executable文件运行，执行效率较高。它使用了轻量级的垃圾回收机制并移除了大部分Python标准库，以适应资源限制的微控制器。

MicroPython主要特点包括:
1、语法和功能与标准Python兼容,易学易用。支持Python大多数核心语法。
2、对硬件直接访问和控制,像Arduino一样控制GPIO、I2C、SPI等。
3、强大的模块系统,提供文件系统、网络、图形界面等功能。
4、支持交叉编译生成高效的原生代码,速度比解释器快10-100倍。
5、代码量少,内存占用小,适合运行在MCU和内存小的开发板上。
6、开源许可,免费使用。Shell交互环境为开发测试提供便利。
7、内置I/O驱动支持大量微控制器平台，如ESP8266、ESP32、STM32、micro:bit、掌控板和PyBoard等。有活跃的社区。

MicroPython的应用场景包括:
1、为嵌入式产品快速构建原型和用户交互。
2、制作一些小型的可 programmable 硬件项目。
3、作为教育工具,帮助初学者学习Python和物联网编程。
4、构建智能设备固件,实现高级控制和云连接。
5、各种微控制器应用如物联网、嵌入式智能、机器人等。

使用MicroPython需要注意:
1、内存和Flash空间有限。
2、解释执行效率不如C语言。
3、部分库函数与标准版有差异。
4、针对平台优化语法,订正与标准Python的差异。
5、合理使用内存资源,避免频繁分配大内存块。
6、利用原生代码提升速度关键部位的性能。
7、适当使用抽象来封装底层硬件操作。

总体来说,MicroPython让Python进入了微控制器领域，是一项重要的创新，既降低了编程门槛，又提供了良好的硬件控制能力。非常适合各类物联网和智能硬件的开发。

MicroPython的pyboard是一种基于STM32F405RG微控制器的开发板，它可以运行MicroPython语言，实现各种有趣和有用的功能。它的主要特点有：

体积小巧，采用邮票孔设计，方便嵌入各种项目中。
内置了4个LED灯，1个开关，1个复位按钮，1个用户按钮，1个USB接口，1个SD卡插槽，1个RTC电池座等。
内置了三轴加速度计（MMA7660），可以检测板子的运动和倾斜。
支持完整的MicroPython语言功能，包括REPL交互模式，内置模块，文件系统操作等。
支持多种通信协议，如UART，SPI，I2C，CAN等。
支持多种外设和传感器的接入和控制，如LCD屏幕，音频放大器，温湿度传感器等。

MicroPython的pyboard UART（串行总线）是一种可以实现双工串行通信协议的功能，它可以用于与其他设备或电脑进行数据交换。pyboard UART（串行总线）的主要特点、应用场景，以及需要注意的事项如下：

主要特点：

pyboard UART（串行总线）可以使用pyb.UART类来创建UART对象，分别用于输出或输入模拟值到指定的引脚。
pyboard UART（串行总线）可以设置通信的参数，如波特率、位数、奇偶校验、停止位等，不同的参数会影响通信的速度和可靠性。
pyboard UART（串行总线）可以使用read()方法或readinto()方法来读取UART值，前者是返回一个字节对象，后者是将字节存储到给定的缓冲区。
pyboard UART（串行总线）可以使用write()方法或writechar()方法来输出UART值，前者是写入一个字节对象，后者是写入一个整数字符。
pyboard UART（串行总线）还可以使用sendbreak()方法来发送中断条件，这会在比正常传输字符所需的时间更长的时间内将总线驱动为低电平。

应用场景：

pyboard UART（串行总线）可以用于与其他设备进行数据交换，如GPS模块、蓝牙模块、WiFi模块等，这些设备可以提供位置信息、无线连接、网络服务等功能。
pyboard UART（串行总线）可以用于与电脑进行数据交换，如通过USB转串口模块或无线串口模块，这些模块可以实现pyboard与电脑之间的通信和控制。
pyboard UART（串行总线）可以用于实现简单的通信协议，如Modbus、RS-485等，这些协议可以用于工业控制、智能家居等领域。

需要注意的事项：

pyboard UART（串行总线）的输入输出电压范围是0～3.3V，如果与其他设备通信时电压不匹配，可能会损坏芯片或引脚。因此，在接入外部信号时，需要注意信号的幅值和极性，并使用电平转换电路或保护电路来适配或隔离信号。
pyboard UART（串行总线）的通信频率受到芯片时钟、闪存访问速度和编程模式等因素的影响。在高通信频率下，可能会出现数据丢失或时序不准确的情况。因此，在使用UART时，需要根据实际需求选择合适的参数，并测试其性能和稳定性。
pyboard UART（串行总线）的引脚分配和物理位置因不同型号的pyboard而异。在使用UART时，需要注意选择正确的引脚，并避免与其他功能冲突。

实际运用程序参考代码案例：

案例1：使用pyb.UART类读取GPS模块发送的NMEA数据，并解析出经纬度信息。

import pyb
from machine import Pin

#创建UART对象
uart = pyb.UART(3, 9600) #Pin='X9' and 'X10'

#定义一个函数，用于解析NMEA数据
def parse_nmea(data):
    #判断数据是否以'$GPRMC'开头
    if data.startswith('$GPRMC'):
        #按逗号分割数据
        fields = data.split(',')
        #判断数据是否有效
        if fields[2] == 'A':
            #获取纬度和纬度方向
            lat = float(fields[3])
            lat_dir = fields[4]
            #获取经度和经度方向
            lon = float(fields[5])
            lon_dir = fields[6]
            #将纬度和经度转换为十进制格式
            lat = (lat // 100) + (lat % 100) / 60
            lon = (lon // 100) + (lon % 100) / 60
            #根据方向调整符号
            if lat_dir == 'S':
                lat = -lat
            if lon_dir == 'W':
                lon = -lon
            #返回纬度和经度
            return lat, lon
    #否则返回None
    return None

while True:
    #读取一行数据
    data = uart.readline()
    #如果数据不为空，尝试解析NMEA数据
    if data:
        result = parse_nmea(data)
        #如果解析成功，打印纬度和经度
        if result:
            lat, lon = result
            print('Latitude:', lat, 'Longitude:', lon)

案例2：使用pyb.UART类与电脑进行数据交换，通过USB转串口模块。

import pyb
from machine import Pin

#创建UART对象
uart = pyb.UART(1, 115200) #Pin='X9' and 'X10'

while True:
    #读取一个字符，并转换为整数
    char = uart.readchar()
    #如果字符不为-1，表示有数据接收
    if char != -1:
        #打印接收到的字符的ASCII码和字符本身
        print('Received:', char, chr(char))
        #将接收到的字符加1后发送回电脑
        uart.writechar(char + 1)

案例3：使用pyb.UART类实现Modbus RTU协议，读取温湿度传感器的数据。

import pyb
from machine import Pin

#创建UART对象
uart = pyb.UART(6, 9600) #Pin='Y1' and 'Y2'

#定义一个函数，用于计算CRC校验码
def crc16(data):
    crc = 0xFFFF #初始值为0xFFFF
    for byte in data: #遍历每个字节
        crc ^= byte #异或当前字节
        for _ in range(8): #循环8次，每次处理一位
            if crc & 0x0001: #如果最低位为1，右移一位并异或多项式0xA001
                crc >>= 1 
                crc ^= 0xA001 
            else: #否则只右移一位
                crc >>= 1 
    return crc #返回CRC校验码

while True:
    #构造Modbus RTU请求帧，从地址为0x01的设备读取寄存器地址为0x0000的两个寄存器（温湿度）
    request = bytearray([0x01, 0x03, 0x00, 0x00, 0x00, 0x02])
    #计算并添加CRC校验码（低字节在前，高字节在后）
    crc = crc16(request)
    request.append(crc & 0xFF)
    request.append(crc >> 8)
    #发送请求帧到UART总线上
    uart.write(request)
    #等待响应帧到达（至少5个字节）
    while uart.any() < 5:
        pass 
    #读取响应帧（7个字节）
    response = uart.read(7)
    #判断响应帧是否有效（长度、地址、功能码、CRC等）
    if len(response) == 7 and response[0] == 0x01 and response

案例4：通过串口发送和接收数据：

import pyb

uart = pyb.UART(1, 9600)  # 初始化UART对象，使用UART 1，波特率9600

while True:
    uart.write("Hello, UART!")  # 发送数据

    if uart.any():
        data = uart.read()  # 接收数据
        print("Received: {}".format(data))

这个程序使用 MicroPython 在开发板上配置 UART 对象，并通过串口发送和接收数据。使用 UART 对象 uart 初始化 UART 1，并设置波特率为9600。在一个循环中，使用 uart.write() 方法发送数据。然后通过 uart.any() 方法检查是否有数据接收，如果有，则使用 uart.read() 方法接收数据，并在终端打印接收到的数据。

案例5：通过串口与其他设备进行通信：:

import pyb

uart = pyb.UART(1, 9600)  # 初始化UART对象，使用UART 1，波特率9600

while True:
    if uart.any():
        data = uart.read()  # 接收数据
        
        # 处理接收到的数据
        # ...
        
        response = "Processed data"  # 响应数据
        uart.write(response)  # 发送响应数据

这个程序使用 MicroPython 在开发板上配置 UART 对象，并通过串口与其他设备进行通信。使用 UART 对象 uart 初始化 UART 1，并设置波特率为9600。在一个循环中，使用 uart.any() 方法检查是否有数据接收，如果有，则使用 uart.read() 方法接收数据。然后根据接收到的数据进行处理，并生成响应数据。最后使用 uart.write() 方法发送响应数据。

案例6：使用串口进行调试输出：:

import pyb

uart = pyb.UART(2, 115200)  # 初始化UART对象，使用UART 2，波特率115200

while True:
    debug_info = "Debug information"  # 调试信息
    uart.write(debug_info)  # 发送调试信息
    
    # 执行其他任务
    # ...

这个程序使用 MicroPython 在开发板上配置 UART 对象，并通过串口进行调试输出。使用 UART 对象 uart 初始化 UART 2，并设置波特率为115200。在一个循环中，将调试信息存储在变量 debug_info 中，并使用 uart.write() 方法发送调试信息。然后继续执行其他任务。这些代码示例展示了 MicroPython 在开发板上配置和使用串行总线（UART）的实际应用。请注意，具体的UART配置和功能可能会根据硬件和需求进行调整。

案例7：发送数据：

import pyb

uart = pyb.UART(1, 9600)  # 初始化UART对象，使用UART1，波特率为9600

data = "Hello, UART!"  # 要发送的数据

uart.write(data)  # 发送数据

在上述示例中，我们使用pyb.UART()初始化一个UART对象，并指定使用UART1，并设置波特率为9600。然后，我们定义要发送的数据，这里设置为"Hello, UART!"。使用uart.write()函数将数据发送到UART总线。

案例8：接收数据：:

import pyb

uart = pyb.UART(1, 9600)  # 初始化UART对象，使用UART1，波特率为9600

while True:
    if uart.any():
        data = uart.read(10)  # 从UART总线接收最多10个字符的数据
        print(data)

在上述示例中，我们使用pyb.UART()初始化一个UART对象，并指定使用UART1，并设置波特率为9600。然后，在主循环中，使用uart.any()函数检查是否有数据可用。如果有数据可用，使用uart.read()函数从UART总线中读取最多10个字符的数据，并将其打印输出。

案例9：UART通信回环测试：:

import pyb

uart = pyb.UART(1, 9600)  # 初始化UART对象，使用UART1，波特率为9600

while True:
    if uart.any():
        data = uart.read(1)  # 从UART总线接收1个字符的数据
        uart.write(data)  # 将接收到的数据发送回UART总线

在上述示例中，我们使用pyb.UART()初始化一个UART对象，并指定使用UART1，并设置波特率为9600。然后，在主循环中，使用uart.any()函数检查是否有数据可用。如果有数据可用，使用uart.read()函数从UART总线中读取1个字符的数据，并使用uart.write()函数将接收到的数据发送回UART总线。这样实现了一个简单的UART通信回环测试。这些示例提供了使用MicroPython在pyboard上进行串行通信（UART）操作的实际运用程序的参考代码。你可以根据具体的需求和应用场景进行修改和扩展。

请注意，以上示例仅供参考，具体的使用方法可能因不同的硬件平台和MicroPython版本而有所差异。在实际编程中，你需要根据你所使用的硬件和具体需求进行适当的调整。