1. 项目概述：一个能“管住”你刷牙的智能小助手

每次刷牙都草草了事，牙医建议的两分钟总是坚持不下来？这大概是很多人的通病。作为一个喜欢鼓捣硬件的开发者，我一直在想，能不能做一个既有趣又实用的小玩意儿，把刷牙这件枯燥的事变得有仪式感，顺便也把CircuitPython这门好用的嵌入式语言玩得更溜一些。于是，就有了这个基于Circuit Playground Express（CPX）的智能牙刷计时器。

这个项目的核心目标很简单： 制作一个能精确计时两分钟，并通过运动（指针转动）、灯光（进度指示）和声音（开始/结束提示）三种方式，全方位提醒你刷牙时长的智能设备。 它不仅仅是一个计时器，更是一个融合了硬件控制、传感器交互和物理结构设计的微型嵌入式系统。对于刚接触CircuitPython或想从软件跨入硬件世界的朋友来说，这是一个绝佳的练手项目。你不需要复杂的电路知识，一块CPX开发板、一个伺服电机、几根导线，再加上一点3D打印或手工制作的耐心，就能亲手打造一个属于自己的智能硬件。

整个项目流程清晰地分为三个层面： 硬件层 负责物理连接与供电； 软件层 用CircuitPython编写控制逻辑，分别驱动电机、灯带和蜂鸣器； 结构层 则通过3D打印的外壳将一切整合成一个美观、可用的产品。接下来，我将带你一步步拆解这个项目，不仅告诉你“怎么做”，更会深入分析“为什么这么做”，并分享我在调试过程中踩过的那些坑和总结出的实用技巧。

2. 核心硬件选型与电路设计解析

工欲善其事，必先利其器。一个硬件项目的成功，一半取决于前期合理的硬件选型与扎实的电路设计。这个计时器虽然功能聚焦，但用到的核心部件各有讲究，连接方式也直接关系到系统的稳定性和代码编写的复杂度。

2.1 开发板：为什么是Circuit Playground Express？

在众多微控制器开发板中，我选择了Adafruit的Circuit Playground Express（CPX）。这并非随意之举，而是基于几个关键考量：

首先， 极低的上手门槛 。CPX堪称“嵌入式开发的瑞士军刀”，板载了10个可编程NeoPixel LED、一个运动传感器（加速度计）、一个温度传感器、一个光传感器、一个蜂鸣器以及多个触摸感应引脚。这意味着我们项目所需的灯光和声音提示功能，完全无需外接任何额外模块，大大简化了硬件复杂度。对于初学者，这避免了初期面对一堆分立元件时的茫然无措。

其次， 对CircuitPython的完美支持 。CPX是Adafruit力推的CircuitPython开发板，其UF2引导程序使得刷写固件和上传代码变得像在电脑上复制文件一样简单。你只需用USB线将其连接至电脑，它就会以一个U盘的形式出现，将编写好的 code.py 文件拖进去即可运行。这种“即插即用”的体验，彻底改变了传统嵌入式开发需要安装专用IDE、配置编译环境的繁琐流程。

最后， 丰富的扩展性与安全性 。CPX提供了多个模拟/数字输入输出引脚（A1-A6, A0），并配有标准的GND（地）和VOUT（电源输出）引脚，方便我们连接外部设备如伺服电机。其板载的稳压电路也能为外部元件提供稳定的3.3V电压，保护核心板不被错误的接线损坏。

注意 ：市面上还有标准版的Circuit Playground（非Express），它不支持CircuitPython，主要用Arduino IDE开发。购买时务必认准“Express”字样。此外，CPX采用USB-C接口，连接线更为通用，但部分老电脑可能需要USB-A to USB-C转接线。

2.2 执行机构：连续旋转伺服电机的奥秘

计时器的核心动作是指针的匀速转动。这里我们选用的是 连续旋转伺服电机 ，而非普通的180度舵机。这两者有本质区别：

• 标准舵机 ：接收PWM（脉冲宽度调制）信号，会将轴转动到指定的角度位置（如0度、90度）。它内部有电位器反馈，形成闭环控制，用于需要精确定位的场景，如机器人关节。
• 连续旋转伺服电机 ：它“误解”了角度信号。当你发送一个类似“转到90度”的PWM信号时，它不会停在某个位置，而是将其解释为“以某个速度持续旋转”。发送“0度”信号可能代表全速逆时针旋转，“180度”信号代表全速顺时针旋转，而“90度”信号则意味着停止。

对于我们的两分钟计时器，我们需要指针在120秒内匀速旋转180度（半圈）。使用连续舵机，我们只需在程序开始时发送一个对应“慢速顺时针旋转”的PWM信号，并在两分钟后停止信号即可。这种控制方式在代码上比用步进电机或直流电机加驱动模块要简单得多。

电机选型参数 ：我推荐使用工作电压在3V-6V之间的小型连续旋转舵机，如SG90的连续旋转版本。CPX的VOUT引脚可以提供3.3V电压，足以驱动这类微型舵机。务必确认电机是“连续旋转”型，通常产品描述或标签上会注明“Continuous Rotation”或“360度”。

2.3 电路连接：安全与稳定的基石

硬件连接看似简单，但错误的接线是烧毁元件的头号杀手。以下是伺服电机与CPX的连接详解及背后的原理：

1. 棕色线 -> GND（接地） ：这是电路的公共参考点，为电流提供返回路径。所有元件的GND都必须连接在一起，否则无法形成回路。
2. 红色线 -> VOUT（电源输出） ：为伺服电机提供工作电力。CPX的VOUT引脚输出的是经过板载稳压器处理的3.3V电压，比直接使用USB的5V（VBUS引脚）更稳定、更安全，能有效避免电压波动对核心板逻辑电路的干扰。
3. 橙色（或黄色/白色）线 -> A1（信号引脚） ：这是控制线。CPX通过这个引脚向舵机发送PWM控制信号。选择A1是因为它是一个兼具模拟输入和PWM输出功能的引脚，且位置方便接线。

实操心得：关于“鳄鱼夹” ：项目原文建议使用鳄鱼夹导线。这对于原型验证和快速测试非常方便。但在最终组装到3D打印外壳内时，鳄鱼夹可能因为体积大、连接不牢靠而带来麻烦。我的建议是，在最终版本中，将伺服电机的引线焊接上杜邦线（母头），然后直接插在CPX的引脚上，这样既稳固又节省空间。如果使用鳄鱼夹，务必确保夹子金属部分没有相互触碰导致短路。

为什么不用更简单的IO引脚？ CPX上还有像A0、A2等引脚。选择A1并无特殊硬件原因，更多是代码示例和引脚可用性的习惯。只要在代码中正确初始化对应的引脚对象，任何支持PWM输出的引脚（在CPX上大部分都可以）都可以使用。这体现了硬件抽象层的好处——软件逻辑与物理引脚解耦。

3. 软件开发：用CircuitPython实现三大功能模块

软件是项目的灵魂。我们将分别实现电机控制、灯光序列和声音提示三个独立功能，最后再将它们优雅地整合。我将使用Adafruit官方丰富的库，这能让我们的代码简洁而强大。

3.1 开发环境搭建：MU Editor vs. 其他选择

原文提到了MU Editor，这是一款专为MicroPython和CircuitPython设计的轻量级集成开发环境（IDE），内置了串行REPL（交互式解释器）和代码检查功能，对初学者非常友好。

安装与配置步骤 ：

1. 从MU Editor官网下载并安装对应操作系统的版本。
2. 用USB线连接CPX到电脑。此时，电脑上应该会出现一个名为 CIRCUITPY 的U盘驱动器。
3. 打开MU Editor，点击左下角的“模式”按钮，确保选择的是“CircuitPython”。编辑器会自动检测到连接的板子。
4. 点击“新建”文件，保存到 CIRCUITPY 驱动器的根目录下，并命名为 code.py 。CircuitPython会在每次板子上电或复位时自动执行这个文件。

替代方案 ：你也可以使用任何纯文本编辑器（如VS Code、Sublime Text）编写代码，然后手动将文件保存到 CIRCUITPY 盘。对于更复杂的项目，VS Code配合CircuitPython插件能提供更好的代码提示和项目管理体验。但对于本项目，MU Editor的简洁性已经足够。

3.2 模块一：伺服电机控制代码深度剖析

让我们从最核心的电机控制开始。我们将编写一个函数，让指针在120秒内匀速旋转180度。

import board
import pwmio
import time

# 初始化PWM输出对象，连接到A1引脚
# frequency=50是舵机的标准PWM频率
pwm = pwmio.PWMOut(board.A1, frequency=50)

def rotate_timer(duration_seconds=120, total_angle=180):
    """
    控制连续旋转舵机匀速转动指定角度。
    :param duration_seconds: 总转动时间（秒）
    :param total_angle: 需要转动的总角度（度）
    """
    # 连续旋转舵机的控制参数需要校准！这是一个关键点。
    # 以下值（1.3ms脉冲宽度停止）因舵机个体差异而异，必须实测调整。
    # 通常，1.5ms脉冲宽度对应停止，小于1.5ms正转，大于1.5ms反转。
    stop_duty_cycle = 3277  # 对应约1.5ms脉冲 (1.5/20 * 65535)
    # 计算一个使舵机缓慢转动的占空比，这个值需要实验确定
    slow_forward_duty_cycle = 3000  # 需要根据实际调整

    # 关键计算：将总角度转换为舵机需要运行的时间比例。
    # 连续舵机无法直接控制角度，我们通过控制旋转时间来实现“模拟角度”。
    # 假设舵机在全速下转一圈需时T秒，则转动角度A所需时间 t = (A / 360) * T。
    # 但我们是匀速慢速，所以需要先知道在当前slow_forward_duty_cycle下，转360度要多久。
    # 这需要通过实验测量。假设我们测得当前速度下转一圈需40秒。
    measured_time_per_360 = 40.0  # 单位：秒，这是一个需要你实测的变量！
    required_time = (total_angle / 360.0) * measured_time_per_360

    print(f"目标：在{duration_seconds}秒内转动{total_angle}度")
    print(f"当前速度下，转动{total_angle}度理论需时{required_time:.1f}秒")

    if required_time > duration_seconds:
        print("错误：要求的转动时间小于当前速度下的理论最小时间。需要提高舵机速度或减少角度。")
        return

    # 启动舵机慢速转动
    pwm.duty_cycle = slow_forward_duty_cycle
    print("计时开始...")

    # 记录开始时间
    start_time = time.monotonic()

    # 核心循环：持续检查是否达到所需的“角度时间”或总时长
    while True:
        current_time = time.monotonic()
        elapsed = current_time - start_time

        # 条件1：如果转动“角度”所需时间到了，先停止舵机
        if elapsed >= required_time:
            pwm.duty_cycle = stop_duty_cycle
            print(f"角度转动完成，耗时{elapsed:.1f}秒。等待总时长结束...")
            # 条件2：继续等待，直到总刷牙时长结束
            while (time.monotonic() - start_time) < duration_seconds:
                time.sleep(0.1) # 短暂休眠，降低CPU占用
            break
        # 如果总时长意外先到了（理论上不会，因前面有判断），也停止
        elif elapsed >= duration_seconds:
            pwm.duty_cycle = stop_duty_cycle
            print("总时长到，停止。")
            break

        time.sleep(0.05) # 短暂休眠，避免循环过紧

    pwm.duty_cycle = stop_duty_cycle
    print("刷牙时间到！电机已停止。")

# 调用函数，开始一个2分钟（120秒），180度转动的计时
rotate_timer(120, 180)

代码关键点解析 ：

1. PWM与占空比 ：舵机通过接收周期为20ms（频率50Hz）的PWM脉冲工作。脉冲的高电平宽度（脉宽）决定了舵机的行为。对于连续舵机，1.5ms脉宽通常对应停止。 duty_cycle 是一个0-65535的值，代表一个周期内高电平所占的比例。 1.5ms / 20ms * 65535 ≈ 4915 ，但实际中，由于舵机差异和电路响应，这个“停止点”需要微调，可能在3277（约1.0ms）到6553（约2.0ms）之间。 你必须通过实验找到自己舵机的精确停止点 。
2. “角度”模拟策略 ：这是本项目的核心逻辑。我们无法直接命令连续舵机“转到90度”。我们的策略是： 用时间换空间 。先测出在某个 slow_forward_duty_cycle 下，舵机旋转360度需要的时间（ measured_time_per_360 ）。那么要旋转 total_angle ，就需要运行 (total_angle / 360) * measured_time_per_360 这么长时间。我们让舵机以固定速度运行这么长时间后停止，它就“相当于”转过了那个角度。
3. time.monotonic() ：这是CircuitPython中用于获取单调递增时间（不受系统时间调整影响）的函数，非常适合用于测量时间间隔。

避坑指南：舵机校准 ：拿到新舵机后，第一件事就是校准停止点。编写一个简单的测试程序，循环微调 pwm.duty_cycle 的值（例如从3000到5000，步进100），观察舵机何时完全停止。记录下这个值作为 stop_duty_cycle 。然后，再找一个比它稍小或稍大的值，让舵机以你满意的慢速开始旋转，记录为 slow_forward_duty_cycle 。这个过程必不可少，且每个舵机都不同。

3.3 模块二：NeoPixel LED进度指示器

CPX板载的10个NeoPixel LED环状排列，是完美的可视化进度条。我们可以让灯光像时钟一样，随着时间流逝逐一点亮或改变颜色。

import neopixel
import board

# 初始化NeoPixel，引脚为板载的NEOPIXEL，数量为10，亮度设为0.3以防过亮
pixels = neopixel.NeoPixel(board.NEOPIXEL, 10, brightness=0.3, auto_write=False)

def light_timer(duration_seconds=120):
    """
    使用NeoPixel LED显示刷牙进度。
    :param duration_seconds: 总计时时间
    """
    pixels.fill((0, 0, 0)) # 开始时关闭所有灯
    pixels.show()

    total_leds = len(pixels)
    interval = duration_seconds / total_leds  # 每个LED代表的时间段

    print("灯光进度指示开始...")
    start_time = time.monotonic()

    for i in range(total_leds + 1): # 循环次数比LED数多1，为了最后点亮全部
        # 计算当前应点亮到第几个LED
        leds_to_light = i
        # 清除所有LED
        pixels.fill((0, 0, 0))

        # 点亮已过去时间段对应的LED
        for led_index in range(leds_to_light):
            # 计算颜色：从绿色(开始)渐变到红色(结束)
            # 使用HSL或HSV色彩空间渐变会更平滑，这里简化使用RGB线性插值
            green = int(255 * (1 - led_index / (total_leds - 1)))
            red = int(255 * (led_index / (total_leds - 1)))
            blue = 0
            pixels[led_index] = (red, green, blue)

        pixels.show()

        # 等待下一个时间间隔，但需要更精确地控制总时间
        target_elapsed = (i) * interval
        while (time.monotonic() - start_time) < target_elapsed:
            time.sleep(0.01) # 短暂休眠进行忙等待

    # 计时结束，所有LED闪烁红色三次作为提示
    for _ in range(3):
        pixels.fill((255, 0, 0))
        pixels.show()
        time.sleep(0.5)
        pixels.fill((0, 0, 0))
        pixels.show()
        time.sleep(0.5)

    print("灯光进度指示结束。")

设计思路 ：

• 进度可视化 ：将120秒平均分给10个LED，每个LED代表12秒。每过12秒，就点亮下一个LED。
• 颜色渐变 ：为了更直观，让灯光颜色从起点（绿色，代表“刚开始/健康”）渐变到终点（红色，代表“时间将尽/停止”）。这里采用了简单的RGB线性插值。更高级的做法可以使用 colorsys 库进行HSV插值，获得更鲜艳的渐变效果。
• 结束提示 ：计时结束后，让所有LED闪烁红色三次，形成强烈的视觉反馈。

性能优化 ：代码中使用了 auto_write=False 。这意味着在设置完所有LED的颜色后，需要调用 pixels.show() 才会一次性更新所有LED。这比每设置一个像素就更新一次硬件要高效得多，能避免灯光更新时的闪烁感。

3.4 模块三：声音提示功能

CPX板载了一个小型蜂鸣器，可以播放简单的音调和旋律。我们用它在计时开始和结束时发出提示音。

import pulseio
import board

# 初始化PWM驱动蜂鸣器，连接到板载的SPEAKER引脚
# 注意：某些版本的CPX库可能使用`audioio`或`simpleio`，这里用通用PWM方法
buzzer = pwmio.PWMOut(board.SPEAKER, variable_frequency=True)

def play_tone(frequency, duration):
    """播放指定频率和时长的音调"""
    if frequency == 0:
        buzzer.duty_cycle = 0  # 占空比为0即无声
        time.sleep(duration)
        return
    buzzer.frequency = frequency
    buzzer.duty_cycle = 32768  # 50%占空比，产生方波，声音最响
    time.sleep(duration)
    buzzer.duty_cycle = 0  # 停止发声
    time.sleep(0.05)  # 短暂静音，区分连续音调

def sound_alert(start=True):
    """
    播放开始或结束提示音。
    :param start: True为开始音，False为结束音。
    """
    if start:
        print("播放开始提示音")
        # 一段上扬的提示音，表示开始
        play_tone(523, 0.1)  # C5
        play_tone(659, 0.1)  # E5
        play_tone(784, 0.2)  # G5
    else:
        print("播放结束提示音")
        # 一段下降的、重复的提示音，表示结束/警告
        for _ in range(3):
            play_tone(784, 0.15)  # G5
            play_tone(659, 0.15)  # E5
            play_tone(523, 0.15)  # C5
            time.sleep(0.1)

声音实现原理 ：蜂鸣器是一种无源发声元件，通过输入不同频率的PWM波（方波）来振动发声。频率决定了音高（如523Hz是C5），PWM信号的占空比影响了音色和音量（50%占空比方波声音最洪亮）。

注意 ：直接使用PWM驱动蜂鸣器可能会产生一些电磁噪音，且音色单一。如果对音质有更高要求，可以考虑使用 audiocore 和 audioio 库来播放WAV格式的音频文件，但需要将音频文件存入CPX的存储中，会占用更多空间。

4. 系统整合：多任务并发与代码结构优化

现在我们有三个独立的功能模块：电机转动、灯光进度和声音提示。但它们目前是顺序执行的，而我们需要它们 同时运行 。在单线程的微控制器上，我们需要一种方式来实现“并发”效果。这里介绍两种主流方法： 简单的时间片轮询 和 使用 asyncio 库的协程 。

4.1 方法一：时间片轮询（简单可靠）

这是嵌入式系统中最经典的并发模型。在一个主循环中，快速依次检查各个任务是否需要执行。

import board
import pwmio
import neopixel
import time

# ... (省略之前的初始化代码和函数定义，如 rotate_timer, light_timer, sound_alert) ...

# 但我们需要重构函数，使其变成“非阻塞”的状态机模式
class ToothbrushTimer:
    def __init__(self, total_time=120, total_angle=180):
        self.total_time = total_time
        self.total_angle = total_angle
        self.start_time = None
        self.state = "IDLE"  # 状态：IDLE, RUNNING, FINISHED

        # 电机参数（需校准）
        self.servo_slow_duty = 3000
        self.servo_stop_duty = 3277
        self.measured_time_per_360 = 40.0

        # 灯光参数
        self.led_interval = total_time / 10
        self.next_led_index = 0
        self.last_led_update_time = 0

        # 声音播放标志
        self.start_sound_played = False
        self.end_sound_played = False

    def start(self):
        if self.state == "IDLE":
            self.state = "RUNNING"
            self.start_time = time.monotonic()
            self.pwm.duty_cycle = self.servo_slow_duty
            print("计时器启动！")
            # 播放开始音（立即执行一次）
            self._play_start_sound()
            self.start_sound_played = True

    def update(self):
        """主更新函数，需要被频繁调用（例如在main loop中）"""
        if self.state != "RUNNING":
            return

        current_time = time.monotonic()
        elapsed = current_time - self.start_time

        # 1. 检查并更新灯光进度（非阻塞方式）
        if elapsed >= (self.next_led_index * self.led_interval) and self.next_led_index <= 10:
            # 计算应点亮的LED数
            leds_on = self.next_led_index
            pixels.fill((0,0,0))
            for i in range(leds_on):
                # ... (颜色计算代码，同前) ...
                pixels[i] = (red, green, blue)
            pixels.show()
            self.next_led_index += 1

        # 2. 检查电机是否应停止（基于角度时间）
        required_servo_time = (self.total_angle / 360.0) * self.measured_time_per_360
        if elapsed >= required_servo_time:
            self.pwm.duty_cycle = self.servo_stop_duty
            # 电机停止后，可以设置一个标志，这里简化处理

        # 3. 检查总时间是否结束
        if elapsed >= self.total_time:
            self._finish()

    def _play_start_sound(self):
        # ... (播放开始音的代码，使用非阻塞方式需要更复杂的状态机，这里为简化，假设瞬间完成) ...
        # 在实际非阻塞实现中，播放声音也需要分解成小步骤。
        pass

    def _finish(self):
        self.state = "FINISHED"
        self.pwm.duty_cycle = self.servo_stop_duty
        # 触发结束灯光闪烁（也需要在update中非阻塞实现）
        # 播放结束音
        if not self.end_sound_played:
            # ... 播放结束音 ...
            self.end_sound_played = True
        print("刷牙时间到！")

# 使用示例
timer = ToothbrushTimer()
timer.start()

# 主循环
while timer.state != "FINISHED":
    timer.update()
    time.sleep(0.01)  # 短暂延时，防止循环过快耗尽CPU

这种方法的优缺点 ：

• 优点 ：概念简单，不需要额外的库，对硬件资源要求低。
• 缺点 ：逻辑变得复杂，每个任务都要拆分成小块。如果某个任务（如一个长音调）阻塞了循环，其他任务就会卡住。

4.2 方法二：使用asyncio协程（现代优雅）

CircuitPython内置了 asyncio 库，它允许我们以看似“同步”的方式编写“异步”代码，非常适合处理多个需要等待的任务。

import asyncio
import board
import pwmio
import neopixel
import time
# 假设有非阻塞的声音播放函数

async def servo_task(duration, angle):
    """控制舵机转动的异步任务"""
    # ... 初始化PWM ...
    pwm.duty_cycle = slow_speed
    start = time.monotonic()
    required_time = (angle / 360) * measured_time_per_360

    # 等待舵机转动所需的时间
    await asyncio.sleep(required_time)
    pwm.duty_cycle = stop_speed
    print("舵机转动完成")

    # 继续等待，直到总时长结束
    remaining = duration - required_time
    if remaining > 0:
        await asyncio.sleep(remaining)
    print("舵机任务结束")

async def lights_task(duration):
    """控制灯光进度的异步任务"""
    # ... 初始化NeoPixel ...
    interval = duration / 10
    for i in range(11):
        # 更新灯光...
        pixels.show()
        # 等待下一个间隔点
        await asyncio.sleep(interval)
    # 计时结束，闪烁灯光
    for _ in range(3):
        pixels.fill((255,0,0))
        pixels.show()
        await asyncio.sleep(0.5)
        pixels.fill((0,0,0))
        pixels.show()
        await asyncio.sleep(0.5)
    print("灯光任务结束")

async def sound_task():
    """控制声音的异步任务"""
    # 播放开始音（假设play_tone_nonblocking是异步的）
    await play_start_sound_nonblocking()
    # 等待总时长（这里需要从其他任务获取信息，可通过asyncio.Event或Queue通信）
    await asyncio.sleep(120) # 简单起见，写死
    await play_end_sound_nonblocking()
    print("声音任务结束")

async def main():
    """主协程，并发运行三个任务"""
    print("智能牙刷计时器启动！")
    # 使用gather并发执行多个协程
    await asyncio.gather(
        servo_task(120, 180),
        lights_task(120),
        sound_task()
    )
    print("所有任务完成！")

# 运行事件循环
asyncio.run(main())

asyncio的优势 ：代码结构清晰，更接近人类的思维方式（“先让电机转着，同时去点灯，同时等着播放声音”）。 await asyncio.sleep() 不会阻塞整个系统，其他任务可以在此期间运行。这是处理嵌入式系统多任务的现代推荐方式。

项目选择 ：对于本项目，由于总时长固定（2分钟），且任务间耦合度不高，使用 时间片轮询 或 asyncio 均可。如果未来需要添加更复杂的交互（如按钮暂停、模式切换）， asyncio 的优势会更明显。在最终的“组合代码”中，我建议尝试使用 asyncio 来构建，这能让你的代码更具可扩展性和可读性。

5. 机械结构与外壳组装实战

软件和电路调试完毕后，我们需要给这个电子项目一个“家”。一个设计精良的外壳不仅能保护内部元件，还能提升产品的整体体验和美观度。原文提供了3D打印文件，我们将深入探讨组装细节和替代方案。

5.1 3D打印文件解读与打印准备

原文提供的文件（Base, Bottom, Arrow）通常是一个三件套的设计：

• Base（底座） ：主体外壳，用于容纳CPX开发板，并有一个孔位用于固定伺服电机。
• Bottom（底盖） ：用于封闭底座底部，可能设计有卡扣或螺丝孔。
• Arrow（指针） ：安装在伺服电机轴上的指针。

打印设置建议 ：

• 材料 ：PLA是最常见且易于打印的材料，强度足够，无异味，适合家用。
• 层高 ：0.2mm可以提供较好的表面质量和细节表现。
• 填充率 ：15%-20%即可，在保证结构强度的同时节省材料和打印时间。
• 支撑 ：原文提到“无需支撑”。这通常意味着模型在设计时考虑了3D打印的悬垂角度限制（一般45度以内）。如果切片软件提示有悬空部分，对于简单的几何体，仍然可以选择不加支撑，但最底部的第一层需要良好的床面附着力。
• 朝向 ：将模型最大面积的一面朝下放置，以增加稳定性。指针（Arrow）可能需要竖起来打印，以确保轴孔的圆度。

实操心得：打印后的处理 ：打印完成后，仔细检查伺服电机的安装孔和CPX的定位柱是否光滑。如果有毛刺或尺寸略小，可以使用小刀或精细锉刀进行修整。对于轴孔，如果与电机轴配合过紧，可以用适当尺寸的钻头轻轻手动扩孔，但务必小心，避免扩大过多导致指针打滑。

5.2 分步组装流程与技巧

组装顺序至关重要，错误的顺序可能导致无法安装或需要返工。

步骤一：电机预安装与测试

1. 在将电机装入底座前， 先进行“裸板测试” 。将电机用鳄鱼夹临时连接到CPX，上传最简单的电机测试代码，确认电机能正常转动、停止，且转向正确。这一步能排除电路和代码问题，避免装进去后发现不工作再拆的麻烦。
2. 将伺服电机放入底座的专用卡槽或孔位中。通常电机会有一个带凸耳的安装法兰，需要对应底座的形状放入。
3. 使用热熔胶固定电机 ：这是关键一步。热熔胶的优点是固化快、有一定弹性、易于拆除。但要注意：
   • 胶枪需预热充分，挤出胶条呈亮白色液态为佳。
   • 将胶涂在电机外壳与底座接触的侧面，而不是底部。因为底部可能需要散热，且胶太多可能影响底座与底盖的闭合。
   • 迅速将电机压入位，并保持十几秒直到胶初步固化。确保电机轴从顶部的孔中露出，且转动顺畅，没有被胶水阻碍。

步骤二：电路板安装与布线

1. 将CPX开发板放入底座对应的凹槽内，通常会有定位柱对应板子上的安装孔。
2. 布线管理 ：这是提升产品可靠性和美观度的细节。如果使用杜邦线，将信号线（橙色）、电源线（红色）、地线（棕色）整理好，用一小段扎带或电工胶布捆在一起，避免线材散乱。确保线材长度留有适当余量，不要绷得太紧，以免在合盖时被挤压或拉扯导致脱焊。
3. 将USB线从底座侧面的开口引出。这个开口的设计应能卡住USB线头，防止其被轻易拉出。如果开口过大，可以在USB头尾部缠绕一些电工胶布以增加摩擦力。

步骤三：指针安装与校准

1. 将打印好的指针（Arrow）安装到伺服电机的输出轴上。大多数微型舵机使用一种称为“舵机臂”的塑料十字套件，指针需要与之连接。你可能需要将指针的孔与舵机臂用附带的螺丝固定，或者如果指针设计为直接套在轴上，则可能需要使用一小滴可拆卸的胶水（如蓝丁胶）固定，以便后续校准位置。
2. “归零”校准 ：这是确保计时准确的关键。上传一个让舵机停在“停止点”的代码。待舵机停稳后，手动将指针调整到你所定义的“起始位置”（例如，指向12点钟方向）。然后小心地固定指针。如果使用胶水，确保胶水干透前不要移动指针。

步骤四：合盖与最终测试

1. 仔细检查内部所有连接，确保没有线材被电机齿轮或尖锐边缘卡住。
2. 将底盖对准底座，轻轻按压或拧紧螺丝（如果设计有螺丝孔）。合盖时应无明显阻力，如果合不上，切勿强行按压，应打开检查是否有元件或线材干涉。
3. 合盖后，连接USB电源，运行完整的计时程序。观察指针转动是否平滑、有无刮擦外壳的声音；灯光序列是否正确；声音提示是否正常。进行2分钟的全流程测试。

5.3 无3D打印机的替代方案

如果没有3D打印机，完全可以利用手边材料制作外壳，这甚至能赋予项目独特的个性。

• 材料选择 ：

  • 塑料收纳盒/药盒 ：透明或半透明的盒子便于观察内部灯光，且易于切割和打孔。
  • 木质小盒 ：质感更佳，可以使用激光切割或手工开孔。
  • 乐高积木 ：快速原型搭建的神器，灵活度高，易于修改。
  • 厚卡纸或泡沫板 ：适合制作轻量化的原型或展示模型。

• 制作要点 ：

  1. 空间规划 ：在盒内大致摆放CPX和电机，用笔标记出需要开孔的位置：电机轴孔、USB接口孔、NeoPixel灯珠的透光孔（如果需要）、复位按钮孔等。
  2. 开孔工具 ：对于塑料或木盒，可以使用手电钻、雕刻刀或加热的螺丝刀（小心操作）。对于卡纸，用美工刀即可。
  3. 固定方式 ：可以使用双面泡棉胶、蓝丁胶或热熔胶来固定电路板和电机。双面泡棉胶有一定厚度，能起到减震作用。
  4. 指针制作 ：可以用硬卡纸、冰棍棒或塑料片剪裁而成，用胶水固定在舵机臂上。

6. 调试、优化与扩展思路

即使按照步骤操作，也难免会遇到问题。这一章汇集了我在制作和教学过程中遇到的一些典型问题及其解决方案，并提供一些让项目变得更酷的扩展想法。

6.1 常见问题排查速查表

问题现象	可能原因	排查步骤与解决方案
CPX连接电脑后无 CIRCUITPY 盘符	1. USB线或接口问题。 2. CPX未进入引导程序模式。 3. 板载UF2引导程序损坏。	1. 换一根 数据线 （很多线只能充电）。换一个USB口。 2. 快速双击CPX上的复位按钮，NeoPixel灯应变为绿色。此时会出现一个名为 CPLAYBOOT 的盘符，将最新的CircuitPython UF2固件文件拖入即可刷新。 3. 从Adafruit官网下载对应板子的最新UF2文件，按上述方法刷入。
代码上传后无反应或报错	1. 文件未保存为 code.py 。 2. 代码语法错误。 3. 库文件缺失。	1. 确认文件保存在 CIRCUITPY 根目录，且名称是 code.py （不是 code.py.txt ）。 2. 在MU Editor中点击“检查”按钮，查看语法错误。通过串行REPL查看具体错误信息。 3. 确保使用了正确的 import 语句。必要时，将所需的库文件（如 adafruit_motor ）从CircuitPython库包中复制到 CIRCUITPY 盘的 lib 文件夹内。
伺服电机不转或抖动	1. 供电不足。 2. PWM信号错误。 3. 接线错误或接触不良。 4. 舵机损坏。	1. 确保红色线接在 VOUT 而非3.3V引脚。VOUT能提供更大电流。尝试外接5V电源单独给舵机供电（需共地）。 2. 重点校准停止点 。调整 duty_cycle 值，找到电机完全停止不抖动的点。 3. 检查鳄鱼夹是否夹紧，线序是否正确（棕-GND，红-VOUT，橙-信号）。 4. 将信号线暂时接到已知好的PWM引脚（如A0）测试。
指针转动速度/角度不准	1. measured_time_per_360 测量不准。 2. 舵机速度不一致。 3. 指针安装松动。	1. 精确测量：给舵机一个慢速信号，用秒表记录转整3圈的时间，除以3得到平均一圈时间。 2. 连续舵机在不同电压、温度下速度可能有微小波动，属于正常现象。可适当增加一点冗余时间。 3. 重新固定指针，确保与轴之间无滑动。
NeoPixel灯光不亮或颜色错乱	1. 亮度设置过低（ brightness=0 ）。 2. 像素索引错误。 3. auto_write 模式问题。	1. 检查 brightness 参数是否大于0（如0.3）。 2. CPX的NeoPixel索引是0到9。确保你的循环没有越界（如 range(11) ）。 3. 如果设置了 auto_write=False ，必须在修改颜色后调用 pixels.show() 。
蜂鸣器不响或声音小	1. 引脚错误。 2. 频率或占空比设置不当。 3. 库版本差异。	1. 确认使用 board.SPEAKER 引脚。有些教程可能用 A0 等，查看板子丝印确认。 2. 确保 duty_cycle 不为0（如32768）。频率要在可听范围（20Hz-20kHz），常用261Hz（C4）到2000Hz。 3. 尝试使用 simpleio 库的 tone 函数，可能更简单： import simpleio; simpleio.tone(board.SPEAKER, 440, duration=0.5) 。
程序运行一段时间后卡死	1. 内存泄漏（在循环中不断创建对象）。 2. 逻辑死循环。 3. 硬件过热或供电不稳。	1. 避免在循环内频繁创建 list , dict 等对象。将不变的对象移到循环外。 2. 检查 while 循环的退出条件是否永远无法满足。 3. 触摸CPX和舵机是否异常发热。尝试使用带电源的USB集线器供电。

6.2 项目优化与功能扩展

基础功能实现后，你可以尝试以下优化和扩展，让项目更具挑战性和实用性：

1. 添加物理按键控制 ：CPX有两个按钮（A和B）。你可以修改代码，实现“按A键开始/暂停计时”、“按B键重置”的功能。这需要学习CircuitPython的 digitalio 库来读取按钮状态，并修改状态机逻辑。

2. 实现无线控制与数据上传 ：为CPX搭配一个ESP32或RFM69无线模块，或者直接使用支持Wi-Fi的开发板（如Adafruit Feather ESP32）。这样你可以通过手机APP或网页远程启动计时器，甚至可以将每天的刷牙时长数据上传到云端，生成统计图表。

3. 引入运动检测 ：CPX本身自带加速度计。你可以增加一个功能：只有检测到牙刷在规律运动（模拟刷牙动作）时，计时器才会计时。如果用户停下来，计时也暂停。这能确保“有效刷牙时间”。这需要处理加速度传感器数据，设计一个简单的动作识别算法。

4. 设计更丰富的交互反馈 ：除了进度条灯光，可以利用加速度计实现“摇一摇切换模式”（如标准模式、敏感牙龈模式对应不同时长），或者通过触摸CPX的金色触摸引脚来调整亮度、音量。

5. 电源独立化 ：使用一块小型的锂电池（如3.7V LiPo）和充电模块，替换USB供电，让计时器完全摆脱线缆束缚，可以挂在浴室墙上。

这个基于CircuitPython的智能牙刷计时器项目，从核心的PWM电机控制、NeoPixel灯光编程，到多任务并发处理和3D打印外壳设计，完整地走完了一个嵌入式智能硬件产品的开发闭环。它没有停留在让灯闪烁一下的简单实验层面，而是解决了一个真实的小需求，并融合了软硬件协同设计。希望这个详细的拆解，不仅能让你成功复现这个有趣的作品，更能为你打开一扇门，去创造更多属于你自己的、软硬件结合的智能小装置。