在我的例子中，我創(chuàng)建了兩個(gè)提要：一個(gè)用于文本（稱為 signtext），一個(gè)用于顏色（稱為 signcolor）。創(chuàng)建這兩個(gè)提要后，我將它們分配給我創(chuàng)建的名為“矩陣門戶報(bào)價(jià)”的組。稍后您將需要這些名稱以供參考，因此請記住它們！

--

如果您想將 gform2adafruitIO 用于不同的項(xiàng)目，Adafruit 發(fā)布了許多其他有關(guān) Adafruit IO 的有用指南，無論您的具體要求是什么，它們都將為您提供幫助。這是一系列有用的 Adafruit IO 指南：https ://learn.adafruit.com/series/adafruit-io-basics 。

第 4 步：環(huán)境變量設(shè)置

設(shè)置好 Adafruit IO 帳戶后，您應(yīng)該有一個(gè)用戶名和一個(gè)密鑰。我將向您展示如何將這些安全地存儲(chǔ)為環(huán)境變量，這樣您就不會(huì)意外地將這些私人信息發(fā)布到網(wǎng)絡(luò)上。該程序使用 python-dotenv 包來執(zhí)行此操作。

要設(shè)置環(huán)境變量，請?jiān)诳寺〈鎯?chǔ)庫的目錄中創(chuàng)建一個(gè)名為“.env”的文件。在您喜歡的文本編輯器中打開此文件，并按以下格式提供您的用戶名和密鑰：

ADAFRUIT_IO_KEY=<put_your_adafruit_io_key_here>
ADAFRUIT_IO_USERNAME=<put_your_adafruit_io_username_here>

你們都完成了！Python 腳本將成功地將您的信息導(dǎo)入代碼中。如果您曾經(jīng)將代碼發(fā)布到 GitHub，default.gitignore 文件將自動(dòng)知道排除您的 .env 文件，這樣您的私鑰就不會(huì)與大眾共享！

第 5 步：修改代碼

現(xiàn)在，您需要對(duì)代碼進(jìn)行一些細(xì)微的修改，以使其適用于您的特定情況。

更新您的 .csv 文件的 URL。

• 修改變量 CSV_URL 以指向您的 Google 表格發(fā)布 .csv 文件的 URL。
• CSV_URL = ""

設(shè)置要存儲(chǔ)的最大報(bào)價(jià)數(shù)。

• 修改變量 MAX_QUOTES 以控制要存儲(chǔ)在 Adafruit IO Feed 中的最大報(bào)價(jià)數(shù)
• MAX_QUOTES =
• 如果您指定 10，它將保留 10 個(gè)最近的報(bào)價(jià)/顏色

設(shè)置 Adafruit IO feed 的名稱。分組時(shí)，feed 的名稱格式為：“group_name.feed_name”。

• TEXT_FEED = 'matrix-portal-quotes.signtext'
• COLOR_FEED = 'matrix-portal-quotes.signcolor'
• 就我而言，我有兩個(gè)提要：一個(gè)用于文本，一個(gè)用于顏色。
• 我在 Adafruit IO 門戶中將它們組合在一起。

如果您將此代碼用于完全不同的項(xiàng)目，您還需要修改 processing() 函數(shù)。我的處理函數(shù)將表單數(shù)據(jù)組織成一個(gè)帶標(biāo)簽的字典結(jié)構(gòu)。然后它會(huì)檢查以確保顏色有效并且文本沒有褻瀆。您將需要更改 processing() 以滿足您的需求。

第 6 步：執(zhí)行程序

要查看源代碼，請?jiān)L問此 Github 存儲(chǔ)庫。

程序說明

以下是程序每個(gè)功能的功能描述：

fetch_form_data()

• 使用 requests 庫下載 Google Sheet 的.csv 文件。
• 將下載的文件與上次檢索的文件進(jìn)行比較，以查看是否有新的提交數(shù)據(jù)。
• 如果有新數(shù)據(jù)，則繼續(xù)對(duì)其進(jìn)行處理。否則，程序結(jié)束。

加工（）

• 將表單數(shù)據(jù)組織成字典結(jié)構(gòu)。
• 調(diào)用 color_check() 處理顏色數(shù)據(jù)并查看它是否有效。
• 調(diào)用 profanity_check() 來處理文本數(shù)據(jù)并查看它是否沒有褻瀆。

adafruitIOaccess()

• 使用 Rest API 與 Adafruit IO 連接。
• 從文本和顏色提要中提取現(xiàn)有值。
• 將新值添加到這些提要中。
• 如果值超過了值的最大限制，則從這些提要中刪除它們。

更新文件（）

• 成功完成所有其他任務(wù)后，用當(dāng)前下載的.csv 覆蓋以前的下載.csv 以供下次執(zhí)行。

以下是運(yùn)行代碼的 2 種不同方式的描述。

第一個(gè) if __name__ == "__main__": 選項(xiàng)：

• 程序只執(zhí)行一次然后存在。非常適合安排腳本運(yùn)行。
• 我的腳本在 Raspberry Pi 上運(yùn)行并使用 cron 進(jìn)行調(diào)度。使用此工具來計(jì)算調(diào)度。
• 下面我將展示如何向 cron 添加任務(wù)以安排腳本每 30 分鐘運(yùn)行一次。

sudo crontab -e
*/30 * * * * /usr/bin/python3 /home/pi/Documents/gform2adafruitIO/gform2adafruitIO.py

第二個(gè) if __name__ == "__main__": 選項(xiàng)：

• 程序永遠(yuǎn)在循環(huán)中重復(fù)執(zhí)行。執(zhí)行之間有一個(gè)睡眠間隔。
• 通過修改此行設(shè)置睡眠間隔（以秒為單位）： INTRVL = 1800
• 下面我展示如何調(diào)用程序。

python3 gform2adafruitIO.py

第 7 步：Adafruit 矩陣門戶信息

?

?

如果您想使用 Adafruit Matrix Portal 運(yùn)行這個(gè)特定的 Marquee Sign 示例，請查看以下鏈接。這些指南將引導(dǎo)您了解如何設(shè)置 Matrix 門戶以及如何在 Adafruit IO 中設(shè)置提要。

Adafruit Matrix 門戶產(chǎn)品頁面：https ://www.adafruit.com/product/4745

一般 Adafruit 矩陣門戶信息：https ://learn.adafruit.com/adafruit-matrixportal-m4

自定義滾動(dòng)報(bào)價(jià)教程：https ://learn.adafruit.com/aio-quote-board-matrix-display

第 8 步：更多項(xiàng)目

更多項(xiàng)目，請?jiān)L問我的頁面：

• https://dargen.io
• https://github.com/mjdargen
• https://www.hackster.io/mjdargen
• https://www.buymeacoffee.com/mjdargen