CircuitPython嵌入式开发实战：从SAMD21板卡入门到环境光控灯项目

1. 项目概述：为什么选择CircuitPython？

如果你和我一样，是从Arduino的C/C++世界或者MicroPython社区转过来的，第一次接触CircuitPython时，可能会觉得有点“过于简单”。不就是把Python解释器塞进单片机里吗？但真正上手几个项目后，你会发现，它的设计哲学远不止于此。CircuitPython的核心价值在于，它将嵌入式开发的“编译-烧录-调试”循环，简化到了近乎“即写即得”的程度。你不再需要复杂的IDE、交叉编译工具链，甚至不需要按复位键。只需一个文本编辑器，修改CIRCUITPY盘符下的code.py文件，保存，代码立刻自动重启运行。这种开发体验的流畅性，对于快速原型验证、教学和创意实现来说，是革命性的。

本次实践，我们将以Adafruit的SAMD21系列非Express板卡（如Trinket M0、GEMMA M0）作为硬件平台。这类板卡的特点是内置闪存容量有限（通常256KB），没有外置的SPI Flash来存储文件系统，因此其CIRCUITPY驱动器空间非常宝贵，可能只有几十KB。这既是挑战，也是学习资源管理的好机会。我们将从最底层的系统安装与恢复讲起，逐步深入到控制板载NeoPixel、读取模拟信号等核心操作，过程中会穿插大量我在实际项目中踩过的坑和总结的优化技巧。无论你是想为智能家居设备添加一个小巧的控制器，还是制作一个可穿戴的互动艺术品，这篇指南都能为你铺平道路。

2. 硬件准备与系统安装

工欲善其事，必先利其器。在开始编程之前，确保你的硬件和软件环境就绪至关重要。对于SAMD21非Express板卡，这个过程有一些独特的细节需要注意。

2.1 认识你的开发板与UF2引导程序

首先，你需要明确你的板卡类型。Adafruit的SAMD21板卡主要分为两类：Express和非Express。两者的核心区别在于存储架构：

• Express板卡：如Feather M0 Express、Metro M0 Express，它们除了主控芯片的内置闪存，还额外搭载了一片SPI Flash芯片（通常是2MB或更大），专门用于存放CircuitPython的文件系统（CIRCUITPY驱动器）和用户库。因此空间充裕。
• 非Express板卡：如Trinket M0、GEMMA M0、QT Py M0。它们仅依赖SAMD21芯片内置的256KB闪存。这片闪存需要同时存放CircuitPython固件、引导程序、文件系统和你的代码。CIRCUITPY驱动器的可用空间可能只有20-30KB，比一张老式软盘还小。

对于非Express板卡，引导程序又分为两种：UF2引导程序和非UF2引导程序。UF2是微软推出的一种特殊的文件格式，其最大优点是，在支持它的操作系统（如Windows 10+、macOS、Linux）上，你可以像拷贝文件一样“拖拽”固件进行烧录，无需额外工具。

如何判断你的板卡是否有UF2引导程序？一个简单的方法是：将板卡通过USB连接到电脑，然后快速双击板载的复位按钮（Reset）。如果电脑上出现一个名为TRINKETBOOT、GEMMABOOT或类似[板卡名]BOOT的可移动磁盘，那么恭喜，你的板卡搭载了UF2引导程序。如果没有出现新的磁盘，而是串口设备重新枚举，那么它可能使用的是传统的bossac引导程序。

2.2 安装CircuitPython固件

对于有UF2引导程序的板卡，安装过程非常直观：

1. 下载固件：访问CircuitPython官网，找到对应你板卡型号的最新.uf2固件文件并下载。
2. 进入引导模式：用USB数据线连接板卡和电脑。快速双击板卡上的复位按钮。此时，电脑上应该会出现一个名为[板卡名]BOOT的驱动器。
3. 拖拽烧录：将下载好的.uf2文件直接拖拽或复制到[板卡名]BOOT驱动器中。驱动器会自动弹出，板卡将重启。
4. 完成：几秒钟后，电脑上会出现一个新的名为CIRCUITPY的可移动磁盘。这表明CircuitPython已成功运行。

注意：首次完成安装后，CIRCUITPY驱动器里通常只有boot_out.txt和一个空的lib文件夹。code.py文件需要你自己创建。这是你的主程序入口。

对于没有UF2引导程序的板卡（如Feather M0 Basic Proto），你需要使用bossac命令行工具进行刷写。这需要从Adafruit的GitHub仓库下载bossac，并通过命令行执行刷写命令。虽然步骤稍多，但官网通常有详细的指南。核心命令类似于：bossac -e -w -v -R --port=COMxx firmware.bin。其中-e代表擦除，-w是写入，-v是校验，-R是复位，COMxx需要替换成你的板卡实际占用的串口号。

2.3 空间危机：管理微小的CIRCUITPY驱动器

这是使用SAMD21非Express板卡时最先、也最常遇到的问题。你的“硬盘”只有几十KB，放几个库文件可能就满了。别慌，我们有多种策略来应对。

策略一：精简文件，手动瘦身最直接的方法是删除不必要的文件。

• 清理库文件：检查lib文件夹。CircuitPython固件本身包含一些核心模块（如time,board,digitalio），但像neopixel、adafruit_bus_device等常用库需要额外安装。只保留你当前项目确实需要的库，用完后及时删除。一个.mpy编译后的库文件可能就有几KB到十几KB。
• 删除驱动文件：Adafruit的板卡CIRCUITPY里有时会附带一个Windows 7 Driver文件夹，这是为旧版Windows准备的串口驱动。如果你使用的是Windows 10/11或macOS/Linux，可以安全删除这个文件夹，它能释放大约12KB的空间。
• 合并代码：如果你的code.py很长，可以考虑将部分功能模块化，但要注意，每个额外的.py文件都会占用空间。在空间极度紧张时，将所有代码写在一个文件里反而是更节省的（虽然不利于维护）。

策略二：代码格式化技巧——用Tab代替空格这是一个非常实用但容易被忽略的技巧。Python依靠缩进来定义代码块，通常建议使用4个空格。但在字节寸土寸金的微控制器上，一个Tab字符（\t）只占1个字节，而4个空格占4个字节。如果你的代码有很深的嵌套层次，这个改动能省下可观的空间。大多数现代代码编辑器（如VS Code、Atom）都可以设置“用Tab代替空格”或“保存时将缩进转换为Tab”。

策略三：对抗macOS的“隐藏文件”如果你用的是macOS，那么CIRCUITPY可能会被系统“悄悄”塞满一堆隐藏文件，如._.DS_Store、._.fseventsd等，这些文件会迅速吞噬宝贵空间。

永久性预防（推荐）： 在终端中执行以下命令，可以禁止macOS在CIRCUITPY卷上创建这些文件：

# 首先，找到你的CIRCUITPY卷的挂载点，通常是 /Volumes/CIRCUITPY ls /Volumes # 禁用该卷的Spotlight索引 sudo mdutil -i off /Volumes/CIRCUITPY # 进入该卷并清理/阻止特定隐藏文件 cd /Volumes/CIRCUITPY sudo rm -rf .{,_.}{fseventsd,Spotlight-V*,Trashes} sudo mkdir .fseventsd sudo touch .fseventsd/no_log .metadata_never_index .Trashes cd -

执行后，这些烦人的隐藏文件就不会再自动生成了。

使用CircuitPython命令擦除（治本）： 在CircuitPython的REPL（串行交互界面）中，你可以直接擦除并重建整个文件系统，这会得到一个“干净”的、已针对macOS优化过的文件系统。

>>> import storage >>> storage.erase_filesystem()

警告：这个命令会立刻、不可逆地清除CIRCUITPY上的所有文件！请务必先备份你的code.py和必要的库文件。

策略四：安全的文件拷贝方式即使做了预防，从网上下载的文件（比如从GitHub下载的库）被拷贝到macOS时，仍可能产生._前缀的扩展属性文件。为了避免这种情况，永远不要用Finder直接拖拽复制。请使用终端的cp命令并加上-X参数：

# 拷贝单个文件，不复制扩展属性 cp -X neopixel.mpy /Volumes/CIRCUITPY/lib/ # 递归拷贝整个文件夹，不复制扩展属性 cp -rX my_library_folder /Volumes/CIRCUITPY/lib/

-X参数告诉macOS不要拷贝扩展属性，从而杜绝了隐藏文件的产生。

3. 从“Hello, World!”开始：闪烁NeoPixel

在编程世界，“Hello, World!”是起点。在嵌入式世界，这个起点就是让一个LED闪烁。CircuitPython板卡通常都板载了一个RGB NeoPixel LED，它就是我们完美的“Hello, World!”对象。

3.1 NeoPixel工作原理简介

NeoPixel是Adafruit对WS2812系列可寻址RGB LED的商标名称。它的神奇之处在于，只需要一根信号线，就能控制成百上千个LED，并且每个LED的颜色和亮度都可以独立编程。板载的这颗NeoPixel，本质上是一个集成了红色、绿色、蓝色三个LED芯片以及一个WS2812驱动IC的微型封装。

在CircuitPython中，我们通过neopixel库来控制它。通信协议是严格的单线时序信号，库函数帮我们处理了所有底层的时序细节，我们只需要关心颜色值。

3.2 第一个程序：让LED呼吸起来

在CIRCUITPY根目录下，创建或编辑code.py文件，输入以下代码：

# SPDX-FileCopyrightText: 2021 Kattni Rembor for Adafruit Industries # SPDX-License-Identifier: MIT """CircuitPython NeoPixel闪烁示例""" import time import board import neopixel # 1. 初始化NeoPixel对象 # board.NEOPIXEL 是这块板子上NeoPixel的预定义引脚 # 第二个参数 `1` 表示我们只控制1个NeoPixel（板载的就这一个） pixel = neopixel.NeoPixel(board.NEOPIXEL, 1) # 2. 设置亮度（可选，范围0.0-1.0） pixel.brightness = 0.3 # 设置为30%亮度，防止太刺眼 # 3. 主循环 while True: # 填充红色 (R, G, B) pixel.fill((255, 0, 0)) time.sleep(0.5) # 等待0.5秒 # 关闭LED (0, 0, 0) pixel.fill((0, 0, 0)) time.sleep(0.5)

保存文件。你会立刻看到板载的RGB LED开始以红色闪烁。

代码逐行解析与避坑指南：

1. 导入库：time用于延时，board包含了这块板子所有引脚的预定义名，neopixel是控制LED的核心库。如果保存后提示ModuleNotFoundError: No module named 'neopixel'，说明neopixel.mpy库文件不在/lib文件夹中。你需要从Adafruit的CircuitPython库包中获取并拷贝进去。
2. 对象初始化：neopixel.NeoPixel()是构造函数。第一个参数是引脚，使用board.NEOPIXEL这个常量是最可靠的方式，它适配了当前板卡的正确引脚。第二个参数是LED数量。这里有一个大坑：如果你要控制外接的LED灯带，数量一定要填对。填少了，后面的LED不受控；填多了，程序可能会因为访问超出范围的内存而崩溃。
3. 亮度设置：brightness属性是一个全局乘数。(255, 0, 0)在亮度0.3下，实际输出的红色值只有255*0.3≈76。重要提示：修改brightness会影响颜色准确性，尤其是低亮度时。对于颜色要求高的项目，建议在代码中直接计算低亮度下的RGB值，而将brightness保持在1.0。
4. 颜色元组：(R, G, B)。每个值范围0-255。(255,0,0)是纯红，(0,255,0)是纯绿，(0,0,255)是纯蓝。(255,255,255)是白色，(0,0,0)是熄灭。
5. 主循环：while True:是一个无限循环。嵌入式程序几乎都是这种结构，因为没有操作系统来调度任务，你的程序需要一直运行来处理逻辑。

实操心得：如何调试没有输出的程序？如果LED没亮，按以下步骤排查：

• 检查电源：USB口供电是否稳定？外接LED灯带时，务必单独供电，USB的500mA可能带不动很多LED。
• 检查接线：信号线（Din）是否接对了？LED灯带的数据流向是单向的，Din接控制信号，Dout接下一个LED的Din。
• 检查库文件：确认neopixel.mpy（或neopixel.py）文件在/lib目录下。
• 检查引脚：确认代码中使用的引脚号与物理连接一致。对于外接灯带，可能要用board.D5这样的具体数字引脚，而不是board.NEOPIXEL。
• 查看串口输出：连接串行终端（如Mu编辑器、PuTTY、screen /dev/ttyACM0 115200），看看是否有错误信息打印出来。这是最有效的调试手段。

4. 与物理世界交互：数字输入与模拟读取

让LED闪烁只是单向输出。一个完整的嵌入式项目，必须能感知外部世界。这主要通过数字输入和模拟输入来实现。

4.1 数字输入：用按钮控制LED

数字信号只有两种状态：高电平（通常为3.3V或5V，代表逻辑1）和低电平（0V，代表逻辑0）。最常见的数字输入设备就是按钮。

我们将实现“按下按钮，点亮LED；松开按钮，熄灭LED”的功能。这需要用到digitalio模块。

硬件连接： 大多数开发板都有一个预定义的BOOT或BUTTON按钮，其引脚已经在board模块中定义好，如board.BUTTON或board.D0。如果你的板子没有，或者你想用外接按钮，需要连接一个 tactile switch。连接方式：按钮一脚接开发板的某个数字引脚（如board.D2），另一脚接地（GND）。通常不需要额外电阻，因为我们会使用芯片内部的上拉电阻。

代码实现：

# SPDX-FileCopyrightText: 2021 Kattni Rembor for Adafruit Industries # SPDX-License-Identifier: Unlicense """ CircuitPython数字输入示例 - 使用按钮开关控制板载NeoPixel """ import board import digitalio import neopixel # 初始化NeoPixel pixel = neopixel.NeoPixel(board.NEOPIXEL, 1) pixel.brightness = 0.1 # 亮度调低，按钮控制时看着舒服 # 初始化按钮引脚为输入模式，并启用内部上拉电阻 button = digitalio.DigitalInOut(board.BUTTON) # 使用板载BOOT按钮 button.switch_to_input(pull=digitalio.Pull.UP) while True: # 读取按钮状态 # 当按钮按下时，引脚被拉到GND（低电平），button.value 为 False # 当按钮松开时，内部上拉电阻将引脚拉到3.3V（高电平），button.value 为 True if not button.value: # 如果按钮被按下（值为False） pixel.fill((0, 255, 0)) # 点亮为绿色 else: pixel.fill((0, 0, 0)) # 熄灭

关键原理与技巧：

• 上拉电阻：pull=digitalio.Pull.UP这行代码启用了微控制器内部的电阻，将引脚电压“拉高”到3.3V。当按钮未按下时，引脚通过这个电阻连接到3.3V，我们读到True（高电平）。当按钮按下时，引脚直接短路到GND（0V），电压被“拉低”，我们读到False。这种方式可以避免引脚悬空时产生不确定的随机值。
• 消抖：机械按钮在按下和松开的瞬间，金属触点会发生物理弹跳，导致电平在极短时间内快速变化多次。上面的简单代码没有处理这个问题，在要求严格的场合（如计数）可能会误触发。一个简单的软件消抖方法是检测到状态变化后，延时一小段时间（如10毫秒）再读取一次确认状态。CircuitPython的keypad库提供了更专业的消抖和事件处理功能。
• not button.value：因为上拉模式下，按下是False，松开是True。所以判断按下的条件就是not button.value（非真即假，取反）。

4.2 模拟输入：读取电位器与电压值

模拟信号是连续变化的电压值。微控制器通过模数转换器（ADC）将这个连续的电压值，离散化成一个数字。对于SAMD21，其ADC是12位的，但CircuitPython为了统一接口，将其值映射到了0-65535（16位无符号整数）的范围。

硬件连接：电位器作为电压分压器我们用一个10KΩ的电位器（可变电阻）来演示。电位器有三个引脚：两端（假设为A和C）接电源（3.3V）和地（GND），中间引脚（B，也叫滑片）接ADC引脚（如board.A0）。

• 当滑片转到A端，B点电压等于A点电压（3.3V），ADC读到接近65535。
• 当滑片转到C端，B点电压等于C点电压（0V，GND），ADC读到接近0。
• 滑片在中间，B点电压是3.3V的一半（1.65V），ADC读到大约32767。

代码实现：读取原始ADC值

# SPDX-FileCopyrightText: 2021 Kattni Rembor for Adafruit Industries # SPDX-License-Identifier: MIT """CircuitPython模拟引脚原始值读取示例""" import time import board import analogio # 初始化A0引脚为模拟输入 analog_pin = analogio.AnalogIn(board.A0) while True: # 读取原始ADC值，范围 0-65535 raw_value = analog_pin.value print("Raw ADC:", raw_value) time.sleep(0.1) # 延时100ms，避免串口输出刷屏太快

打开串行终端（波特率115200），旋转电位器，你会看到数值在0-65535之间变化。

进阶：将ADC值转换为实际电压原始ADC值不够直观。我们更关心的是实际的电压值。转换公式基于一个比例关系：电压 = (ADC原始值 / ADC最大可能值) * 参考电压在CircuitPython中，ADC最大可能值是65535，参考电压通常是3.3V（对于SAMD21）。

def get_voltage(pin): """将ADC原始值转换为电压值 (单位: 伏特)""" return (pin.value * 3.3) / 65535 while True: voltage = get_voltage(analog_pin) print("Voltage: {:.2f} V".format(voltage)) # 格式化输出，保留两位小数 time.sleep(0.1)

现在，串口输出的就是直观的电压值了，范围大约在0V到3.3V之间。

实操心得：ADC的精度与噪声

• 分辨率：12位ADC的理论分辨率是 3.3V / 4096 ≈ 0.8mV。但实际受噪声影响，有效位数会降低。
• 噪声：电源噪声、数字电路干扰都会影响ADC读数。你可能会发现即使电位器不动，读到的最后几位数字也在跳动。对于要求不高的应用（如音量调节），可以软件滤波，比如连续采样10次取平均值。
• 参考电压：公式中的3.3V是假设ADC的参考电压就是系统电压。对于高精度测量，有些MCU有独立的、更稳定的参考电压引脚。SAMD21非Express板卡通常直接用3.3V作为参考，其精度取决于LDO稳压器的质量。

5. 深入核心：读取CPU温度与更多传感器

微控制器内部往往集成了许多有用的外设，其中一个就是温度传感器。它可以用来监测芯片的工作温度，对于评估散热情况或制作温度相关的应用很有帮助。

5.1 读取内部CPU温度

CircuitPython通过microcontroller模块提供了访问CPU温度的接口，非常简单：

import microcontroller import time while True: temp_c = microcontroller.cpu.temperature print("CPU Temperature: {:.1f} C".format(temp_c)) time.sleep(2) # 每2秒读一次，温度变化没那么快

原理与注意事项： 这个温度传感器测量的是CPU芯片内部结温，而不是环境温度。当CPU全速运行复杂代码时，其温度会比环境温度高不少。你可以尝试运行一个计算密集型的循环（比如for i in range(1000000): x = i*i），同时打印温度，会看到明显的上升。因此，它更适合用于监控芯片自身是否过热，而不是精确测量室温。

转换为华氏度： 如果需要，可以轻松转换：temp_f = temp_c * 9/5 + 32。

5.2 连接外部I2C传感器（以MCP9808为例）

内部传感器功能有限。要测量环境温度、湿度、气压等，需要连接外部传感器。I2C总线是连接这类传感器的常用方式，它只需要两根线（SDA数据线，SCL时钟线）就能连接多个设备。

我们以高精度温度传感器MCP9808为例。首先，你需要将传感器用STEMMA QT/Qwiic连接线（或杜邦线）连接到开发板的I2C引脚上。对于大多数板子，I2C引脚是board.SDA和board.SCL。

步骤一：安装库MCP9808不是内置库。你需要从Adafruit的CircuitPython库包中找到adafruit_mcp9808.mpy文件，并将其拷贝到CIRCUITPY驱动器的lib文件夹中。同时，它可能依赖adafruit_bus_device和adafruit_register库，确保一并拷贝。

步骤二：编写代码

import time import board import busio import adafruit_mcp9808 # 1. 创建I2C总线对象 i2c = busio.I2C(board.SCL, board.SDA) # 2. 创建传感器对象，传入I2C总线对象 # 0x18是MCP9808的默认I2C地址 sensor = adafruit_mcp9808.MCP9808(i2c, address=0x18) while True: # 3. 读取温度（摄氏度） temp_c = sensor.temperature temp_f = temp_c * 9 / 5 + 32 print("Temperature: {:.2f} C {:.2f} F".format(temp_c, temp_f)) time.sleep(1)

I2C排查技巧： 如果运行后没有输出或报错，可以尝试以下方法：

1. 检查接线：SDA、SCL、VCC（3.3V）、GND四根线是否接对、接牢。
2. 检查地址：使用I2C扫描程序确认设备地址。很多传感器有地址选择引脚，可以改变地址。

   import board import busio i2c = busio.I2C(board.SCL, board.SDA) while not i2c.try_lock(): pass try: print("I2C addresses found:", [hex(addr) for addr in i2c.scan()]) finally: i2c.unlock()

3. 检查上拉电阻：I2C总线需要上拉电阻（通常4.7KΩ）将SDA和SCL线拉到高电平。许多开发板（包括大多数Adafruit板）和传感器模块（如MCP9808 breakout）已经内置了这些电阻。如果使用裸传感器芯片，你必须自己添加外部上拉电阻。

6. 项目实战：制作一个环境光控灯

让我们把前面学到的知识组合起来，做一个简单但完整的小项目：一个根据环境光强度自动调节亮度的“小夜灯”。我们用光敏电阻（或任何模拟输出的光传感器）读取环境光，用NeoPixel LED作为灯。

硬件清单：

• CircuitPython开发板（如Trinket M0）
• 光敏电阻模块（或模拟环境光传感器，如Adafruit ALS-PT19）
• 10KΩ电阻（如果使用裸光敏电阻）
• 面包板和杜邦线

电路连接（使用光敏电阻分压电路）：

1. 将光敏电阻一端接3.3V。
2. 将光敏电阻另一端接一个10KΩ固定电阻，固定电阻另一端接GND。
3. 光敏电阻与固定电阻的连接点，接到开发板的模拟输入引脚A0。这样，光照越强，光敏电阻阻值越小，A0点电压越接近3.3V；光照越弱，A0点电压越接近0V。

代码实现：

import time import board import analogio import neopixel # 初始化硬件 light_sensor = analogio.AnalogIn(board.A0) led = neopixel.NeoPixel(board.NEOPIXEL, 1) led.brightness = 0.5 # 设置一个基础亮度上限，防止太亮 # 校准参数：需要在实际环境中测试得到 DARK_THRESHOLD = 15000 # ADC值低于此值认为环境很暗 BRIGHT_THRESHOLD = 50000 # ADC值高于此值认为环境很亮 def map_value(value, in_min, in_max, out_min, out_max): """将一个数值从一个区间线性映射到另一个区间""" return (value - in_min) * (out_max - out_min) / (in_max - in_min) + out_min while True: # 读取光照强度 light_level = light_sensor.value # 根据光照计算LED亮度 (反向：越暗，LED越亮) if light_level < DARK_THRESHOLD: # 环境很暗，LED全亮（暖黄色） led.fill((255, 150, 0)) # 暖黄色 elif light_level > BRIGHT_THRESHOLD: # 环境很亮，LED关闭 led.fill((0, 0, 0)) else: # 中间状态，亮度随光照平滑变化 # 将光照水平映射到亮度系数 1.0 -> 0.0 (暗->亮) brightness_factor = map_value(light_level, DARK_THRESHOLD, BRIGHT_THRESHOLD, 1.0, 0.0) # 将亮度系数限制在0.0-1.0之间 brightness_factor = max(0.0, min(1.0, brightness_factor)) # 计算实际RGB值 (暖黄色 * 亮度系数) r = int(255 * brightness_factor) g = int(150 * brightness_factor) b = 0 led.fill((r, g, b)) time.sleep(0.1) # 每100ms更新一次

项目优化与思考：

1. 校准：DARK_THRESHOLD和BRIGHT_THRESHOLD需要你在实际使用环境中测试确定。可以在代码开始时加一个校准模式，打印出当前的light_sensor.value，然后你在明暗环境下分别记录数值。
2. 滤波：光敏电阻的响应可能有噪声或抖动。可以在代码中加入一个简单的移动平均滤波：维护一个最近N次读数的列表，取平均值作为当前光照水平。
3. 省电：如果使用电池供电，可以考虑在环境很亮时，让MCU进入轻睡眠模式（time.sleep()更长的时间），以节省电力。
4. 扩展：可以加入一个按钮，切换自动模式/手动模式/常亮模式。在手动模式下，可以用另一个电位器来调节LED亮度。

7. 故障排除与高级技巧

即使按照指南操作，你也难免会遇到问题。这里汇总了一些常见问题的排查思路和高级使用技巧。

7.1 常见问题速查表

7.2 高级技巧：优化性能与内存

对于SAMD21这类资源受限的MCU，优化至关重要。

• 使用.mpy文件：库文件有.py（源代码）和.mpy（预编译字节码）两种格式。.mpy文件加载更快，占用内存更少。始终优先使用.mpy版本。
• 冻结模块：对于永远不会更改的核心库（甚至是你自己写的常用函数），可以将其“冻结”到CircuitPython固件中。这需要从源码编译固件，属于高级操作，但可以极大节省CIRCUITPY空间和启动时的RAM占用。
• 管理内存：
  • 避免在循环中创建大的列表或字典。
  • 使用gc.collect()手动触发垃圾回收（需要先import gc），特别是在完成一个大任务后。
  • 使用sys.getsizeof()查看对象占用内存情况（import sys）。
• 使用array代替list处理大量数值数据：array模块提供了紧凑的数值数组，比Python列表更节省内存。
• 谨慎使用浮点数：SAMD21没有硬件浮点单元（FPU），浮点运算由软件模拟，非常慢。在性能关键的循环中，尽量使用整数运算。例如，颜色计算可以全部用0-255的整数完成。

7.3 深入理解：boot.py与代码执行顺序

CIRCUITPY根目录下有两个特殊的Python文件：

1. boot.py：在CircuitPython启动时首先执行，且只执行一次。通常用于进行一些非常早期的硬件初始化，或者修改USB配置（例如，将板卡设置为MIDI设备而非串行设备）。注意：在boot.py中打印信息是看不到的，因为此时USB可能还未就绪。
2. code.py：在boot.py执行完毕后自动开始执行的主程序文件。你的主要代码在这里。
3. main.py：如果存在code.py，则main.py不会被执行。只有当code.py不存在时，CircuitPython才会尝试执行main.py。这是一种备选机制。

一个boot.py的典型用例——禁用自动重载： 当你通过串口与传感器通信时，每次保存code.py导致的自动重载可能会打断通信。可以在boot.py中加入以下代码来禁用自动重载：

import supervisor supervisor.runtime.autoreload = False

这样，只有手动按复位键时，代码才会重启。

从点亮第一个LED到读取传感器数据，再到构建一个完整的互动项目，CircuitPython以其极低的入门门槛和强大的表达能力，让嵌入式开发变得直观而有趣。对于SAMD21非Express这类小容量板卡，虽然空间限制带来了挑战，但也迫使你养成精简、高效编码的好习惯。记住，遇到问题第一反应是打开串口终端看错误信息；空间不够了，就想想哪些文件能删，代码能不能用Tab缩进；想做复杂项目时，先评估资源，必要时升级到Flash更大的Express板卡。嵌入式开发的世界很大，CircuitPython是你探索这个世界的一把顺手且快乐的钥匙。