当前位置：首页 > news >正文

CircuitPython硬件接口编程实战：GPIO、ADC、PWM与舵机控制详解

news 2026/6/6 20:47:52

1. 项目概述与硬件接口基础

如果你刚开始接触嵌入式开发，可能会被一堆术语搞晕：GPIO、PWM、ADC、DAC……听起来很复杂，但其实它们就是微控制器（比如你手上的Adafruit开发板）和外部世界（比如按钮、LED、传感器、电机）对话的几种“语言”。我玩了十多年硬件，从最早的Arduino到现在的CircuitPython，感觉CircuitPython让硬件编程的门槛降低了不少，特别是对Python开发者来说，几乎是无缝上手。这篇文章，我就以Adafruit家族几款主流板子为例，带你彻底搞懂这些基础但至关重要的硬件接口编程。

简单来说，GPIO就是板子上那些可以让你自由定义功能的小金属片（引脚）。你可以告诉某个引脚：“你现在是输入模式，去听听有没有按钮被按下”；或者“你现在是输出模式，去点亮那个LED”。数字IO处理的就是“有”或“无”（高电平或低电平，通常是3.3V和0V）这种非黑即白的信号。而模拟IO的世界则是连续的，比如一个电位器旋转时输出的电压可能在0V到3.3V之间平滑变化，模拟输入（ADC）就是用来读取这个连续值的“耳朵”。反过来，模拟输出（DAC）则是用连续变化的电压去“说话”，不过很多便宜的单片机没有真正的DAC，这时就需要PWM来“模拟”模拟输出。PWM（脉冲宽度调制）是一种非常聪明的数字技巧，通过快速开关来控制平均功率，从而实现LED调光、电机调速和舵机角度控制。无论你是想做个小机器人、环境监测站还是智能家居控制器，这些都绕不开。

下面，我们就从最基础的找引脚开始，一步步拆解数字IO、模拟IO、PWM和舵机控制的原理与实战代码。我会把不同板子（Circuit Playground Express, Trinket M0, Gemma M0, QT Py M0, Feather M0/M4 Express, ItsyBitsy M0/M4 Express, Metro M0/M4 Express）的引脚差异、接线图、代码适配要点都讲清楚，让你不管用哪块板子，都能快速找到对应引脚，把代码跑起来。

2. 硬件准备与引脚识别实战

开始写代码前，第一件事是认清你手里的板子，并找到正确的引脚。这是所有硬件项目的第一步，也是最容易出错的一步。接错了线，代码再漂亮也没用。

2.1 核心概念：引脚的多重身份

首先要建立一个关键认知：开发板上的一个物理引脚，往往有多个“名字”和功能。例如，一个引脚可能同时被标记为数字引脚D2、模拟输入引脚A1、甚至可能还具备PWM能力。在CircuitPython中，我们通过board模块来访问这些引脚，使用的名称通常是丝印上最显眼的那个。比如Feather M0 Express上的A1引脚，在代码里就是board.A1。理解这一点，能避免很多“这个引脚怎么不能用”的困惑。

2.2 各开发板关键引脚位置详解

不同板子的设计布局不同，我们根据输入资料，把常用功能涉及的引脚位置汇总如下。强烈建议在操作时，将你的实物板子与下图或官方Pinout图对照确认。

数字输入（以按钮为例）与板载LED引脚（D13）：

Circuit Playground Express:按钮接在D7引脚（位于电池接口和复位按钮之间）。板载LED是D13（在USB Micro口旁边）。
Trinket M0:使用D2引脚（标记为“2”，位于“3V”和“1”之间）。板载LED是D13（标记为“13”，在USB口旁边）。
Gemma M0:使用D2引脚（也是一个鳄鱼夹友好的焊盘，同时标有“D2”和“A1”，靠近USB口）。板载LED在板子上“GND”标签旁边，电源开关上方。
QT Py M0:使用D2引脚（标记为A2，在USB口附近，A1和A3之间）。注意：QT Py M0没有板载红色LED！你需要外接一个LED，正极接SCK，负极接一个470Ω电阻后再接GND。
Feather M0/M4 Express:使用D5引脚（标记为“5”）。板载LED是D13（标记为“#13”，在USB口旁边）。
ItsyBitsy M0/M4 Express:使用D2引脚（标记为“2”，位于“MISO”和“EN”标签之间）。板载LED在复位按钮旁边，“3”和“4”标签之间。
Metro M0/M4 Express:使用D2引脚（位于板子左上角附近）。板载LED标记为“L”，在USB口旁边。

模拟输入（以电位器为例）引脚（通常是A1）：

Circuit Playground Express:A1在板子右侧。该板有7个模拟引脚。
Trinket M0:A1就是标记为“2”的引脚（在红色LED同侧）。有5个模拟引脚。
Gemma M0:A1在板子顶部，USB Micro口左侧。有3个模拟引脚。
QT Py M0:A1在USB口附近，A0和A2之间。有10个模拟引脚。
Feather M0/M4 Express:A1在电池接口的对侧边缘。有6个模拟引脚。
ItsyBitsy M0/M4 Express:A1在板子中间，“Adafruit”的“A”字母附近。有6个模拟引脚。
Metro M0/M4 Express:A1在板载DC插孔的同侧。M0和M4都有6个模拟引脚。

模拟输出（DAC）引脚：这是真正的模拟电压输出，非PWM模拟。非常重要：在M0系列板子上，通常只有A0引脚支持真正的DAC模拟输出。M4系列板子（如Metro M4 Express）可能有两个（A0和A1）。具体位置：

Circuit Playground Express:A0在电池接口附近的VOUT和A1之间。
Trinket M0:A0标记为“1~”，位于“0”和“2”之间，靠近板子中部。
Gemma M0:A0在板子右侧中间，电源开关旁边。
QT Py M0:A0在USB口旁边，“QT”丝印附近。
Feather M0 Express:A0在电池接口对侧，GND和A1之间，靠近复位按钮。
Feather M4 Express:A0位置同Feather M0，但焊盘两侧有白色括号标记。
ItsyBitsy M0/M4 Express:A0在VHI和A1之间，靠近“Adafruit”的“A”，焊盘有括号标记。
Metro M0 Express:A0在VIN和A1之间，位于DC插孔同侧的排针中间。
Metro M4 Express:A0位置同M0版本。特别注意：Metro M4 Express有两个真正的模拟输出引脚：A0和A1。

PWM引脚：PWM支持非常广泛，几乎每个数字引脚都支持PWM，但总有例外。最需要记住的例外就是真正的模拟输出引脚A0（在M0上）通常不支持PWM。文章后面提供了一个脚本，可以自动检测你的板子哪些引脚支持PWM。

舵机控制引脚：舵机需要PWM信号，因此任何支持PWM的引脚都可以用来控制舵机。在示例中，常用A1或A2。务必查阅你的板子手册或使用后面的检测脚本，确认你选用的引脚支持PWM。

实操心得：拿到一块新板子，我做的第一件事就是去Adafruit官网找到该板子的“Pinout”页面并打印出来，或者存到手机里。在代码里，dir(board)命令可以列出所有可用的引脚名称，这在不确定时是个很好的探索方法。接线时，对于Gemma、Circuit Playground这类板子，用鳄鱼夹最方便；对于Feather、Metro等有排针的板子，杜邦线是首选。给舵机供电时，如果发现板子突然复位或连接断开，大概率是舵机耗电超过了USB端口的供电能力，务必准备一个外接的5V电源（如电池盒）单独给舵机供电。

3. 数字输入输出（Digital IO）深度解析

数字IO是基础中的基础，它让微控制器能感知开关状态和控制LED亮灭。

3.1 数字输入：读取按钮状态

数字输入用于读取一个引脚上是高电平（通常是3.3V）还是低电平（0V）。最常见的应用就是接一个按钮。按钮一端接信号引脚，另一端接GND（接地），同时信号引脚需要通过一个上拉电阻连接到3.3V。幸运的是，现代微控制器内部大多集成了可软件控制的上拉电阻，我们无需外接。

下面是一个通用的读取按钮状态的代码框架：

import time import board import digitalio # 1. 创建按钮对象并配置引脚 # 根据你的板子修改 `board.D7` 为实际的引脚，例如 `board.D2` for Trinket button = digitalio.DigitalInOut(board.D7) button.direction = digitalio.Direction.INPUT button.pull = digitalio.Pull.UP # 启用内部上拉电阻，默认引脚为高电平，按下按钮时变为低电平 # 2. 创建LED对象并配置引脚 # 根据你的板子修改 `board.LED`，对于QT Py M0需要外接LED到SCK引脚 led = digitalio.DigitalInOut(board.LED) # 对于QT Py M0，改为 board.SCK led.direction = digitalio.Direction.OUTPUT while True: # 3. 读取按钮状态 # 由于启用了上拉电阻(Pull.UP)，按钮未按下时值为True，按下时值为False if not button.value: # 如果按钮被按下（值为False） led.value = True # 点亮LED print("Button pressed!") else: led.value = False # 熄灭LED time.sleep(0.01) # 短暂延迟，防止程序跑飞并降低CPU占用

代码拆解与原理：

digitalio.DigitalInOut(pin): 创建一个数字IO对象，并绑定到指定的硬件引脚。
direction属性: 设置为INPUT或OUTPUT，定义引脚方向。
pull属性: 对于输入引脚，可以配置内部上拉 (Pull.UP) 或下拉 (Pull.DOWN) 电阻。上拉电阻确保引脚在悬空（按钮未按下）时保持稳定的高电平状态，避免因静电干扰产生误触发。这是我们最常用的配置。
value属性: 对于输入，读取它返回True(高电平) 或False(低电平)。对于输出，写入True或False来设置引脚电平。

针对不同板子的适配：代码中的注释已经提示了关键修改点。例如，对于QT Py M0，你需要：

外接一个LED，正极接SCK引脚，负极接一个470Ω电阻后接GND。
将代码中创建LED对象的那一行改为：led = digitalio.DigitalInOut(board.SCK)。

注意事项：time.sleep(0.01)这个短暂延迟至关重要。没有它，while True循环会以极限速度运行，可能造成：
按键抖动误判：机械按钮在按下和弹起的瞬间会产生快速的电平抖动，高速扫描可能会读取到多次按下/释放。虽然本例中影响不大，但在需要精确计次时，需要加入“消抖”逻辑。
CPU占用率100%：程序会无意义地空转，消耗大量电能，对于电池供电项目很不友好。
阻塞其他任务：在更复杂的程序中，可能会影响其他并发操作的及时响应。对于简单的状态检测，10ms的延迟是一个很好的平衡点。

3.2 数字输出：驱动LED与外部设备

数字输出更简单，就是设置引脚电平。驱动LED时，必须串联一个限流电阻（通常220Ω-1kΩ），直接连接3.3V引脚和LED会因电流过大烧毁LED或损坏单片机引脚。开发板的板载LED通常已经内置了这个电阻。

import time import board import digitalio led = digitalio.DigitalInOut(board.LED) # 使用板载LED led.direction = digitalio.Direction.OUTPUT while True: led.value = True # 高电平，LED亮 time.sleep(0.5) # 亮0.5秒 led.value = False # 低电平，LED灭 time.sleep(0.5) # 灭0.5秒

驱动更大负载：引脚输出电流有限（通常每个引脚~20mA，所有引脚总和有上限）。要驱动继电器、电机或大功率LED，必须使用晶体管（如MOSFET）或电机驱动模块（如DRV8833、L298N）作为“开关”，单片机引脚仅提供控制信号。

4. 模拟输入（Analog In）与ADC原理

模拟输入让我们能够读取真实世界中连续变化的物理量，比如光线强度、温度、压力、旋钮位置等，这些传感器通常输出一个与物理量成比例的电压信号。

4.1 ADC工作原理与代码实现

微控制器内部有一个叫ADC（模数转换器）的模块，它负责将引脚上的模拟电压（例如0-3.3V）转换成一个数字值。CircuitPython的analogio库封装了这个过程。常见的ADC分辨率是16位（如SAMD21），这意味着它可以将电压范围分成 2^16 = 65536 个等级。0V对应数值0，3.3V对应数值65535。

import time import board from analogio import AnalogIn # 初始化模拟输入引脚，例如A1 analog_in = AnalogIn(board.A1) def get_voltage(pin): """将ADC原始值（0-65535）转换为电压值（0-3.3V）的辅助函数""" return (pin.value * 3.3) / 65536 while True: # 方法1：直接读取原始ADC值（0-65535） raw_value = analog_in.value print(f"Raw ADC: {raw_value}") # 方法2：使用辅助函数读取电压值 voltage = get_voltage(analog_in) print(f"Voltage: {voltage:.2f} V") # 格式化输出，保留两位小数 print("-" * 20) time.sleep(0.5)

代码解析：

AnalogIn(board.A1): 创建模拟输入对象，指定引脚。
pin.value: 属性，直接返回16位的原始ADC数值（0-65535）。
get_voltage()函数: 一个实用的转换函数。公式电压 = (原始值 / 65536) * 参考电压。这里参考电压是3.3V。除以65536而不是65535是因为ADC输出范围是0到65535（共65536个等级）。

4.2 实战：连接电位器并读取

电位器是一个经典的模拟输入实验元件。接线方法如下：

电位器左侧引脚 → 板子GND
电位器中间引脚（滑片） → 板子A1（信号端）
电位器右侧引脚 → 板子3.3V（或3Vo）

旋转电位器旋钮，滑片输出的电压就在0V到3.3V之间变化，串口监视器或Mu编辑器的绘图器（Plotter）上就能看到变化的数值或波形图。

常见问题与排查：
读数跳动/不稳定：这是正常现象，源于电源噪声、ADC本身精度和外部干扰。可以通过软件滤波来平滑数据，例如“移动平均滤波”：连续读取N次，然后取平均值。
def read_smooth(pin, samples=10): total = 0 for _ in range(samples): total += pin.value time.sleep(0.001) # 每次读取间微小延迟 return total / samples
错误提示AttributeError: 'module' object has no attribute 'A1'：这通常意味着你使用的CircuitPython固件版本太旧，或者该板子的board模块定义中确实没有A1这个引脚名。首先确保你安装了最新版的CircuitPython固件。其次，用print(dir(board))查看所有可用引脚名，确认正确的名称（可能是A2、D2等）。
电压读数始终为0或接近3.3：检查接线是否正确且牢固。用万用表测量电位器中间引脚对地的电压，看是否随旋钮变化。如果不变，可能是电位器损坏或接错了脚。

5. 模拟输出（DAC）与PWM技术详解

当我们需要输出一个模拟电压（比如生成特定的波形、控制某些需要模拟电压的器件）时，就需要用到DAC或PWM。

5.1 真正的模拟输出：DAC

只有少数引脚具备真正的DAC功能，它能输出0-3.3V之间任意精度的电压。在SAMD21（M0）芯片上，通常只有A0引脚是真正的模拟输出。

import board from analogio import AnalogOut # 初始化DAC输出引脚 (M0系列通常是A0， M4可能还有A1) analog_out = AnalogOut(board.A0) while True: # 让电压从0V缓慢上升到3.3V for i in range(0, 65535, 128): # 步进128，使循环快一些 analog_out.value = i # 再让电压从3.3V缓慢下降到0V for i in range(65535, 0, -128): analog_out.value = i

重要原理：代码中我们给.value赋值范围是0-65535，对应输出0-3.3V。但DAC的分辨率可能只有10位（1024级）。CircuitPython的AnalogOut对象内部会帮你处理这个映射。例如，对于10位DAC，写入值i会先被右移6位（除以64），因为 65535 / 1024 ≈ 64。所以analog_out.value = 5000实际输出的是第78级（5000/64≈78），电压约为 78/1024*3.3V ≈ 0.25V。

性能限制：由于Python解释器的开销，通过循环改变DAC值来生成波形（如正弦波）的频率很低，可能只有几赫兹（Hz），因此不适合用于音频播放等需要较高频率的应用。对于音频，需要使用专门的音频库和具备I2S接口的芯片（如M4系列）。

5.2 脉冲宽度调制：用数字信号“模拟”模拟输出

PWM是更通用且强大的技术。它通过快速开关（数字脉冲）来模拟一个中间电压。核心参数有两个：

频率（Frequency）：每秒开关多少次，单位Hz。例如，5000Hz表示每秒产生5000个脉冲。
占空比（Duty Cycle）：一个脉冲周期内，高电平时间所占的比例。50%占空比表示一半时间高电平，一半时间低电平。

如果这个开关频率足够高，负载（如LED、电机线圈）由于惯性来不及完全响应每次开关，其表现出的效果就是平均电压。例如，在3.3V系统下，50%占空比的PWM信号，其平均电压就是1.65V。

5.2.1 PWM控制LED亮度（固定频率）

这是PWM最直观的应用。

import time import board import pwmio # 对于大多数有板载LED的板子 led = pwmio.PWMOut(board.LED, frequency=5000, duty_cycle=0) # 对于QT Py M0等没有板载LED的，需外接LED到SCK引脚，并改用下面这行 # led = pwmio.PWMOut(board.SCK, frequency=5000, duty_cycle=0) while True: # 呼吸灯效果：亮度从0%到100%再到0% for i in range(0, 100): if i < 50: # 上升阶段: 占空比从0线性增加到65535（100%） led.duty_cycle = int(i * 2 * 65535 / 100) else: # 下降阶段: 占空比从65535线性减少到0 led.duty_cycle = 65535 - int((i - 50) * 2 * 65535 / 100) time.sleep(0.01) # 控制变化速度

代码解析：

pwmio.PWMOut(pin, frequency=5000, duty_cycle=0): 创建PWM输出对象。duty_cycle范围是0（0%）到65535（100%）。
呼吸灯逻辑：通过循环改变duty_cycle的值，实现亮度的平滑变化。time.sleep(0.01)决定了亮度变化的快慢。

5.2.2 PWM驱动蜂鸣器播放音调（可变频率）

通过改变PWM的频率，可以驱动无源蜂鸣器发出不同音调的声音。

import time import board import pwmio # 注意引脚差异：M0板子常用A2， M4板子常用A1（因为A2可能不支持PWM） # 对于M0板子 (如Feather M0, ItsyBitsy M0): piezo = pwmio.PWMOut(board.A2, duty_cycle=0, frequency=440, variable_frequency=True) # 对于M4板子 (如Feather M4, ItsyBitsy M4): # piezo = pwmio.PWMOut(board.A1, duty_cycle=0, frequency=440, variable_frequency=True) # 中音C大调音阶的频率 (单位: Hz) notes = (262, 294, 330, 349, 392, 440, 494, 523) while True: for freq in notes: piezo.frequency = freq # 改变频率以改变音高 piezo.duty_cycle = 65535 // 2 # 设置50%占空比，使蜂鸣器发声 time.sleep(0.25) # 发声0.25秒 piezo.duty_cycle = 0 # 占空比为0，停止发声 time.sleep(0.05) # 音符间短暂停顿 time.sleep(0.5) # 音阶播放完后的停顿

关键参数：

variable_frequency=True: 这个参数必须设置为True，才能允许在程序运行时动态改变PWM频率。对于控制LED，频率固定即可；对于发声，必须可变。
piezo.frequency: 直接赋值即可改变输出频率。频率单位是赫兹（Hz），人耳可听范围大约在20Hz到20kHz。
piezo.duty_cycle = 65535 // 2: 设置50%的占空比能让蜂鸣器以最大效率振动发声。设为0则停止。

简化方案：使用simpleio库adafruit_simpleio库提供了一个更简单的tone()函数。

import time import board import simpleio while True: for f in (262, 294, 330, 349, 392, 440, 494, 523): # 对于M0板子 simpleio.tone(board.A2, f, 0.25) # 在引脚A2上，以频率f播放0.25秒 # 对于M4板子 # simpleio.tone(board.A1, f, 0.25) time.sleep(0.05) # 音符间间隔 time.sleep(0.5)

simpleio.tone(pin, frequency, duration)一行代码就完成了频率设置、启动和停止，更加简洁。

实操心得与避坑指南：
引脚选择是最大的坑：务必确认你使用的引脚支持PWM。M4板子（如Feather M4 Express）的PWM引脚分布可能与M0板子不同。最可靠的方法是运行下面提供的PWM引脚检测脚本。
蜂鸣器不响？首先确认你用的是无源蜂鸣器（需要外部驱动频率），有源蜂鸣器（内部带振荡器）给电就响，无法播放音调。其次，检查正负极，长脚或标有“+”号的是正极，接信号引脚；短脚是负极，接GND。
PWM频率选择：
LED调光：频率最好在100Hz以上，低于100Hz人眼会感觉到闪烁。500Hz-5kHz是常用范围。
舵机控制：必须使用50Hz（周期20ms）的标准频率。舵机通过脉冲宽度（0.5ms-2.5ms）来识别角度，这个脉冲是在50Hz的周期内定义的。
电机控制：频率需要更高（通常几千Hz到几十kHz），以减少电机的啸叫声和开关损耗。
驱动能力：单片机引脚驱动电流有限。驱动大功率LED或电机时，PWM信号应输入到晶体管（如MOSFET）或电机驱动芯片的输入端，由它们来承担大电流开关任务。

5.3 实用工具：自动检测PWM引脚脚本

不确定你的板子哪个引脚支持PWM？把这个脚本拷进去运行一下，串口会打印出所有支持和不支持PWM的引脚。

import board import pwmio for pin_name in dir(board): pin = getattr(board, pin_name) try: p = pwmio.PWMOut(pin) p.deinit() # 释放PWM资源 print("PWM on:", pin_name) # 打印支持PWM的引脚 except ValueError: # 当引脚无效（如是模拟输入或专用功能引脚）时引发的错误 print("No PWM on:", pin_name) # 打印不支持PWM的引脚 except RuntimeError: # 定时器冲突错误（某些引脚共享定时器资源） print("Timers in use:", pin_name) # 打印定时器被占用的引脚 except TypeError: # 当dir(board)中的对象不是引脚时（如board模块的属性） pass # 忽略非引脚对象

运行这个脚本，你就能得到一份专属你板子的PWM引脚清单，后续项目选引脚时就心里有数了。

6. 舵机控制实战：从标准舵机到连续旋转舵机

舵机是机器人项目中的常客，它可以根据信号精确控制旋转角度。CircuitPython通过adafruit_motor.servo库让舵机控制变得异常简单。

6.1 舵机接线与供电警告

接线（三线舵机）：

棕色/黑色线 (GND)→ 开发板的GND。
红色线 (VCC)→外部5V电源正极。这是最重要的注意事项！
黄色/白色线 (信号)→ 开发板的任何PWM引脚（如A1,A2,D5等）。

供电警告：

绝对不要仅用USB给多个或扭矩大的舵机供电！USB端口提供的电流有限（通常500mA），而一个标准舵机堵转时电流可能超过1A。这会导致电压被拉低，造成开发板复位、程序崩溃，甚至损坏USB端口。
务必使用外部电源，如4节AA电池盒（约6V）或专用的5V/2A以上电源适配器，单独给舵机的VCC和GND供电。确保外部电源的GND与开发板的GND连接在一起（共地），这是信号正常工作的基础。
不要接3.3V，舵机通常需要5V才能正常工作。

6.2 标准180度舵机控制

标准舵机可以在0到180度之间旋转。

import time import board import pwmio from adafruit_motor import servo # 1. 创建PWM对象，频率必须设置为50Hz pwm = pwmio.PWMOut(board.A2, frequency=50) # 使用A2引脚，可根据板子调整 # 2. 创建舵机对象 # 对于标准180度舵机 my_servo = servo.Servo(pwm, min_pulse=500, max_pulse=2500) # 对于连续旋转舵机（见下一节） # my_servo = servo.ContinuousServo(pwm, min_pulse=1000, max_pulse=2000) while True: # 3. 控制舵机角度 print("Moving to 0 degrees") my_servo.angle = 0 time.sleep(1) print("Moving to 90 degrees") my_servo.angle = 90 time.sleep(1) print("Moving to 180 degrees") my_servo.angle = 180 time.sleep(1) # 也可以使用for循环平滑扫描 for angle in range(0, 181, 5): # 从0到180度，每次增加5度 my_servo.angle = angle time.sleep(0.05) for angle in range(180, -1, -5): # 从180到0度，每次减少5度 my_servo.angle = angle time.sleep(0.05)

关键参数解析：

pwmio.PWMOut(pin, frequency=50):舵机控制PWM频率必须是50Hz（周期20ms），这是所有标准舵机通信协议。
servo.Servo(pwm, min_pulse=500, max_pulse=2500): 创建标准舵机对象。
- min_pulse: 对应0度时的脉冲宽度（单位微秒，μs）。通常为500μs。
- max_pulse: 对应180度时的脉冲宽度。通常为2500μs。
- 为什么是500-2500μs？在20ms的周期内，一个0.5ms的高电平脉冲代表0度，1.5ms代表90度，2.5ms代表180度。这是 hobby servo 的标准。如果你的舵机转动范围不对（比如只能转90度），可以尝试调整这两个参数（例如设为1000和2000）。
my_servo.angle: 直接给这个属性赋值（0到180之间的数字），库会自动计算并生成对应的PWM脉冲。

6.3 连续旋转舵机控制

连续旋转舵机没有角度限制，你可以把它看作一个速度可正可反的直流电机。通过信号控制其旋转速度和方向。

import time import board import pwmio from adafruit_motor import servo pwm = pwmio.PWMOut(board.A2, frequency=50) # 创建连续旋转舵机对象 continuous_servo = servo.ContinuousServo(pwm, min_pulse=1000, max_pulse=2000) while True: print("Full speed forward") continuous_servo.throttle = 1.0 # 全速正转 time.sleep(2) print("Stop") continuous_servo.throttle = 0.0 # 停止 time.sleep(1) print("Half speed backward") continuous_servo.throttle = -0.5 # 半速反转 time.sleep(2) print("Stop") continuous_servo.throttle = 0.0 time.sleep(1)

关键参数解析：

servo.ContinuousServo(pwm, min_pulse=1000, max_pulse=2000): 创建连续旋转舵机对象。min_pulse和max_pulse的含义与标准舵机不同，它们定义了“全速反转”和“全速正转”的脉冲宽度。通常中位（停止）是1500μs。需要根据你的舵机规格微调。
continuous_servo.throttle: 油门属性，范围从-1.0 到 1.0。
- 1.0: 全速正转（顺时针）。
- 0.0: 停止。
- -1.0: 全速反转（逆时针）。
- 0.5: 半速正转。

舵机调试经验：
舵机抖动或吱吱叫：可能是供电不足或PWM信号不稳定。确保使用高质量、低阻抗的导线，并确保外部电源有足够的电流余量（建议每个标准舵机预留1A）。
舵机不转或只振动：首先检查接线（信号线是否接对？）。然后检查PWM频率是否为50Hz。最后，尝试调整min_pulse和max_pulse参数。有些廉价舵机可能需要将范围设为700, 2300才能覆盖全部角度。
多个舵机控制：每个舵机需要独立的信号线（PWM引脚）。它们可以共享同一个5V和GND电源，但务必确保电源功率足够。如果出现所有舵机一起“抽风”，几乎可以肯定是电源功率不足。
角度不准：舵机有机械误差，且angle属性是“期望角度”，实际到达的角度受负载影响。对于需要精确位置的控制（如机器人手臂），应考虑加入位置反馈（如电位器或编码器）。

7. 项目集成与高级应用思路

掌握了这些基础接口，你就可以将它们组合起来，构建更复杂的项目。这里提供几个思路和集成时的注意事项。

思路一：环境控制面板

硬件：电位器（模拟输入）控制参数（如亮度阈值），按钮（数字输入）切换模式，舵机（PWM输出）控制物理开关（如百叶窗），LED（PWM输出）指示状态。
软件：主循环中读取电位器电压，映射到某个范围（如0-180度），然后控制舵机角度。根据按钮状态改变LED的闪烁模式或颜色（如果是RGB LED）。

思路二：简易示波器/信号发生器

模拟输入：读取一个变化的传感器信号（如麦克风、光敏电阻）。
模拟输出：用DAC生成一个简单的测试波形（如正弦波、三角波），虽然频率不高，但可用于学习信号处理概念。
数据可视化：通过串口将ADC读取的数据发送到电脑，用Python的Matplotlib或Mu编辑器的绘图器实时显示波形。

集成注意事项：

全局变量与状态机：避免在while True循环中使用冗长的if-else链。对于复杂逻辑，建议使用状态机模式，用一个变量（如state）来标记当前系统状态（如“待机”、“运行”、“报警”），每个状态下执行不同的操作。

非阻塞延迟：time.sleep()会阻塞整个程序。如果需要同时控制多个设备（如让LED闪烁的同时舵机匀速转动），可以使用时间戳比较的方式来实现非阻塞定时。

import time last_led_toggle = time.monotonic() led_interval = 0.5 # LED每0.5秒切换状态 led_state = False while True: current_time = time.monotonic() # 非阻塞控制LED if current_time - last_led_toggle >= led_interval: led_state = not led_state led.value = led_state last_led_toggle = current_time # 这里可以同时做其他事情，比如读取传感器 # ...

错误处理：在实际项目中，加入try-except块来捕获可能出现的运行时错误（如引脚配置错误、I2C设备丢失），并使程序能够优雅地恢复或重启，能极大提高项目的稳定性。
功耗管理：对于电池供电项目，在空闲时可以使用time.sleep()或microcontroller.idle()来降低功耗。彻底关闭不用的外设模块（如将PWM对象的duty_cycle设为0并deinit()）也能省电。