注意内容 重要内容

安装Circuit Python

随着Circuit Python的不断发展，Adafruit将停止对旧版本的支持。如果你正在运行早期版本的Circuit Python，你需要更新到最新版本。通常情况下，Adafruit会支持最近的两个主要版本。

一些兼容Circuit Python的开发板已经预装了Circuit Python，其他一些Circuit Python兼容的开发板需要安装Circuit Python，此外要更新已经安装在开发板上的Circuit Python的版本。安装和更新的步骤是相同的。本节将介绍如何在开发板上安装或更新Circuit Python。

你只需要安装Circuit Python一次。之后就可以自由地进行编程，而无需再次进行此过程，直到下次更新大版本时为止。

下载最新版本

首先，你需要做的是下载最新版本的Circuit Python。

如果你已经在运行Circuit Python，请确保正在运行最新版本！如果不确定，可以按照以下步骤确保安装了最新版本。

在安装或更新Circuit Python之前，一定要备份代码！

在安装或更新Circuit Python之前，一定要备份代码！

在安装或更新Circuit Python之前，一定要备份代码！

大多数情况下，更新过程中不会从开发板上删除任何内容，但也有可能发生意外。如果你的开发板上已经有代码，请务必在进行下面的步骤之前将其备份到计算机上。

通过前往circuitpython.org下载您的开发板的最新固件。

接下来，需要使用USB数据线连接开发板与电脑。确保USB线是数据线！有些USB线只能充电，可能会导致很多问题。

对于Windows 7和8.1的用户

如果你使用的是Windows 7或8.1，您需要在插入开发板之前安装驱动程序。

如果你使用的是Windows 7或8.1，请查看Windows 7和8.1驱动程序页面以获取详细信息。

强烈建议你升级到Windows 10。

启动UF2引导程序

几乎所有的Circuit Python开发板都配备了一个名为UF2（USB Flash）的引导程序，它使安装和更新Circuit Python变得简单易上手。开发板必须处于BOOTLOADER模式下才可以烧录.uf2文件。如果你下载的.uf2文件与你的开发板名称匹配，那么可以继续阅读本节内容。然而，如果文件以.bin结尾，你需要进行更复杂的安装 - 请前往下面的连接获取详细信息。

https://learn.adafruit.com/welcome-to-circuitpython/non-uf2-installation

对于大多数开发板：

在开发板上可以找到复位按钮，通常在板上标有RESET或RST。（在Circuit Playground Express和Bluefruit上，它是位于板中心的较小按钮。）

连续按两次复位按钮进入BOOTLOADER模式，如果寄了没进去，没啥大问题，再来一次。如果您有一个Circuit Playground Express（不用查，这个很贵），而且是刚刚拿出袋子的，可以尝试按一次按钮。

 

对于RP2040开发板：

在RP2040开发板上，有可能有两个按钮（合宙家的只有一个，偷工减料了）：复位按钮和BOOTSEL/BOOT按钮。这两个按钮大小相同，都是小黑色按钮。要注意复位按钮通常在板上标有RESET或RST，而启动按钮在板上标有BOOTSEL或BOOT。

要进入RP2040开发板的BOOTLOADER模式，必须按住BOOTSEL按钮，并在继续按住的同时，按下并释放RESET按钮。继续按住BOOTSEL按钮，直到引导程序驱动器出现（好麻烦，不过也就弄一次）。

 

BOOTLOADER模式

一旦成功，开发板上的RGB状态LED灯将闪烁红色，然后变为绿色。计算机上将出现一个新的驱动器。

对于大多数开发板：

驱动器的名称是“开发板名称+BOOT”，其中开发板名称是特定开发板的引用。例如，基本的Feather开发板将具有FEATHERBOOT，而Trinket开发板将具有TRINKETBOOT等。

对于RP2040开发板：

所有RP2040开发板的驱动器名称都为RPI-RP2。

开发板现在处于引导模式，现在就可以安装或更新Circuit Python了！

 

安装Circuit Python

现在找到您下载的.uf2文件。将该文件拖到电脑上刚才文件管理器中显示的磁盘内。

开发板上的灯光再次闪烁，电脑上的磁盘消失，然后计算机上将显示一个名为CIRCUITPY的新磁盘。

Bang！已成功安装了CircuitPython！

CIRCUITPY和“开发板名称+BOOT”或RPI-RP2之间有什么区别？

当你将Circuit Python开发板连接到计算机时，计算机将将开发板的闪存视为USB闪存驱动器，可以存储文件。成功安装Circuit Python后，你将看到CIRCUITPY驱动器。当你在大多数开发板上双击复位按钮时，将看到“开发板名称+BOOT”的磁盘驱动器，或者在RP2040开发板上保持引导选择并点击复位时，将看到RPI-RP2磁盘驱动器。你可以将文件拖到引导驱动器和CIRCUITPY驱动器，但只有CIRCUITPY才能运行Circuit Python代码。

通常情况下，将文件拖到挂载的USB驱动器时，文件会复制到驱动器中，然后可以在文件资源管理器中看到。然而，将.uf2文件拖到引导驱动器时，它似乎会消失，驱动器会断开连接。这是正常的，不要大惊小怪哈。UF2本质上是一个安装程序文件（类似.exe），并不仅仅停留在驱动器上，而是在开发板处于bootloader模式（即引导驱动器）时安装Circuit Python。

可以试试将其他文件复制到引导驱动器，但它们不会倍开发板执行或对Circuit Python可用。因此，在安装Circuit Python完成后，请确保将文件拖到并在CIRCUITPY驱动器上进行编辑！

 

引导程序驱动器名称

此列表并非最详细版本，但应该足够了解引导程序驱动器名称中要查找的内容。

• Feather RP2040 = RPI-RP2

• QT Py RP2040 = RPI-RP2

• ItsyBitsy RP2040 = RPI-RP2

• Trinket M0 = TRINKETBOOT

• Gemma M0 = GEMMABOOT

• Circuit Playground Express = CPLAYBOOT

• ItsyBitsy M0 Express = ITSYBOOT

• ItsyBitsy M4 Express = ITSYM4BOOT

• Feather M0 Express = FEATHERBOOT

• Feather M4 Express = FEATHERBOOT

• Metro M0 Express = METROBOOT

• Metro M4 Express = METROM4BOOT

• Grand Central M4 Express = GCM4BOOT

• NeoTrelis M4 Express = TRELM4BOOT

• PyPortal, Pynt and Titano = PORTALBOOT