注意內(nèi)容重要內(nèi)容

創(chuàng)建和編輯你的代碼

Circuit?Python 最大的優(yōu)點之一是啟動和運行代碼非常簡單。本節(jié)介紹如何創(chuàng)建和編輯你的第一個 Circuit?Python 程序。

要創(chuàng)建和編輯代碼，只需要一個代碼編輯器，而代碼編輯器有很多很多選擇。Adafruit 強烈推薦使用 Mu，它專為 Circuit?Python 設(shè)計，非常簡單易用，并帶有內(nèi)置的串口控制臺。

如果你不能或不想使用 Mu，還有許多其他編輯器也同樣可以使用。編輯器推薦頁面(https://learn.adafruit.com/welcome-to-circuitpython/recommended-editors)提供了更多詳細信息。如果你沒有使用 Mu，請在寫入文件后執(zhí)行 Windows 上的 "Eject" 或 "Safe Remove"，或在 Linux 上執(zhí)行 "sync"等指令。（在 MacOS 上不會出現(xiàn)這個問題。）

?

創(chuàng)建代碼

安裝 Circuit?Python 會在CIRCUITPY U盤上生成一個 code.py 文件。如果要開始寫自己的代碼，需要打開代碼編輯器，從 CIRCUITPY U盤加載 code.py 文件。

如果你正在使用 Mu，點擊按鈕欄中的 "Load" 按鈕，導(dǎo)航到 CIRCUITPY U盤，并選擇 code.py進行加載就可以了。

將以下代碼復(fù)制并粘貼到編輯器中：

//******************分割線******************//

import board

import digitalio

import time

?

led = digitalio.DigitalInOut(board.LED)

led.direction = digitalio.Direction.OUTPUT

?

while True:

????led.value = True

????time.sleep(0.5)

????led.value = False

????time.sleep(0.5)

//******************分割線******************//

KB2040、QT Py 和 Trinkeys 沒有板載的紅色 LED，它們有一個 WS2812 LED。上述示例在 KB2040、QT Py 或 Trinkeys 開發(fā)板上將無法運行！

?

如果你正在使用 KB2040、QT Py 或 Trinkey，請下載 WS2812示例。(https://github.com/adafruit/Adafruit_Learning_System_Guides/blob/main/Welcome_to_CircuitPython/code.py)

//******************分割線******************//

Blink example for boards with ONLY a NeoPixel LED (e.g. without a built-in red LED).

Includes QT Py and various Trinkeys.

?

Requires two libraries from the Adafruit CircuitPython Library Bundle.

Download the bundle from circuitpython.org/libraries and copy the

following files to your CIRCUITPY/lib folder:

* neopixel.mpy

* adafruit_pixelbuf.mpy

?

Once the libraries are copied, save this file as code.py to your CIRCUITPY

drive to run it.

"""

import time

import board

import neopixel

?

pixels = neopixel.NeoPixel(board.NEOPIXEL, 1)

?

while True:

????pixels.fill((255, 0, 0))

????time.sleep(0.5)

????pixels.fill((0, 0, 0))

time.sleep(0.5)

//******************分割線******************//

WS2812?閃爍示例使用內(nèi)置的WS2812，但時間代碼是相同的?？梢允褂面溄觾?nèi)的WS2812?閃爍示例來繼續(xù)學習本指南。（就上面那一大串，不用再點開網(wǎng)站了，都復(fù)制過來了）

代碼復(fù)制進去以后效果如圖所示。要注意在 "while True:" 行下面，接下來的四行以四個空格開頭，且縮進的量完全相同。在此之前的所有行都沒有前面的空格縮進。

將 code.py 文件保存到 CIRCUITPY U盤上。

板載?LED 現(xiàn)在應(yīng)該在每半秒鐘閃爍一次。

恭喜，你剛剛運行了你的第一個 Circuit?Python 程序！

在大多數(shù)開發(fā)板上，都板載了微小的紅色 LED，在 ItsyBitsy nRF52840 開發(fā)板上，板載了一個微小的藍色 LED，而在 QT Py M0、QT Py RP2040 和 Trinkey 系列開發(fā)板上，只會找到一個 WS2812?LED。

編輯代碼

要編輯代碼，需要在編輯器中打開 CIRCUITPY U盤上的 code.py 文件。對代碼進行所需的更改然后保存文件。就這么簡單！只要文件保存完畢，代碼更改就會生效。

在繼續(xù)之前，有一個警告...

不要在保存文件和更改代碼的時候點擊復(fù)位按鈕或拔下開發(fā)板！

開發(fā)板上的 Circuit?Python 固件會檢測到文件發(fā)生更改或?qū)懭?，并自動重新啟動代碼。如果在計算機將文件寫入開發(fā)板之前拔下或復(fù)位開發(fā)板，可能會損壞驅(qū)動器。如果發(fā)生這種情況，可能會丟失已經(jīng)寫好的代碼，因此定期備份代碼備份非常重要。

有幾種避免文件系統(tǒng)損壞的方法。

1. 使用在保存文件時完全寫出文件的編輯器。查看推薦編輯器頁面(https://learn.adafruit.com/welcome-to-circuitpython/recommended-editors)了解不同的編輯選項的詳細信息。

如果將文件從主機計算機拖放到 CIRCUITPY U盤上，仍然需要執(zhí)行第二步，即在保存完文件后執(zhí)行 "Eject" 或 "Sync"（下一步）以確保文件完全寫入。

2. 寫入后彈出或同步驅(qū)動器

如果使用的是我們不推薦的編輯器，仍然有辦法讓它工作。

在 Windows 上，可以彈出或安全移除 CIRCUITPY U盤。它實際上不會彈出（物理），但它會強制操作系統(tǒng)將文件保存到磁盤。在 Linux 上，可以在終端中使用 sync 命令強制寫入磁盤。

如果使用 Windows 資源管理器或 Linux 圖形文件管理器將文件拖放到 CIRCUITPY 上，也需要執(zhí)行此操作。

?

哦，不，我做錯了什么，現(xiàn)在 CIRCUITPY U盤不顯示了?。?！

不要擔心！破壞驅(qū)動器并不是世界末日（也不會是開發(fā)板的末日?。Ｈ绻l(fā)生這種情況，請按照每個開發(fā)板指南上的故障排除頁面上的步驟來重新啟動你的開發(fā)板。

（https://learn.adafruit.com/welcome-to-circuitpython/troubleshooting）

?

回到代碼編輯...

現(xiàn)在！讓我們嘗試編輯你添加到開發(fā)板上的程序。在編輯器中打開 code.py 文件并進行一個簡單的更改。將第一個 0.5 更改為 0.1。代碼應(yīng)該如下所示：

//******************分割線******************//

import board

import digitalio

import time

?

led = digitalio.DigitalInOut(board.LED)

led.direction = digitalio.Direction.OUTPUT

?

while True:

????led.value = True

????time.sleep(0.1)

????led.value = False

????time.sleep(0.5)

//******************分割線******************//

其余的代碼保持不變，保存文件?？纯窗遢dLED 會發(fā)生什么變化？有些東西發(fā)生了變化！知道為什么嗎？

不必止步于此！讓我們繼續(xù)前進。將第二個 0.5 更改為 0.1，使其如下所示：

//******************分割線******************//

while True:

????led.value = True

????time.sleep(0.1)

????led.value = False

????time.sleep(0.1)

//******************分割線******************//

現(xiàn)在它閃爍得非?？?！

現(xiàn)在嘗試將這兩個 0.1 都改為 1。由于增加了 LED 保持亮和滅的時間，LED 閃爍速度會慢得多。

做得好！做得很棒！現(xiàn)在你已經(jīng)準備好開始嘗試新的示例并對其進行編輯，看看會發(fā)生什么！這些只是簡單的更改，但是不積跬步無以至千里。進行所需的更改，保存它，然后查看結(jié)果。實際上，就是這么簡單so easy！

程序文件的命名

Circuit?Python 在開發(fā)板上尋找一個要運行的代碼文件有四個文件選項：code.txt、code.py、main.txt 和 main.py。Circuit?Python 按照這個順序?qū)ふ疫@些文件，然后運行它找到的第一個文件。盡管 code.py 是建議的代碼文件名，但重要的是要知道還有其他選項存在。如果你寫的程序似乎在工作時沒有更新，請確保沒有創(chuàng)建另一個同名但無用的代碼文件。