描述

至少可以說，PiSquare附帶的原始代碼非常簡陋！愚蠢的是，我曾假設(shè)PiSquare會附帶一些允許與 HAT 交互的可配置軟件。有點像，但太基礎(chǔ)了。

這個項目的目的是調(diào)查和編寫 Raspberry Pi 和PiSquare的代碼。我選擇了我擁有的最簡單的 HAT 之一——PiHut Status 板。它由 5 個按鈕和 10 個 LED（5 個紅色和 5 個綠色）組成。我選擇的任務(wù)是控制機艙中的一些燈和插頭，并查看每個燈和插頭的狀態(tài)。燈是 Philips Hue，插頭是 TP-Link——兩者都有 Python 庫（phue和kasa）。

樹莓派代碼

• 將 PiServer 文件夾復(fù)制到您的 Raspberry Pi。
• 安裝以下所需的 python 庫（通常是 pip3 install library ）：
• 湯姆
• phue
• 蟒蛇卡薩
• 安裝以下所需的 python 庫（通常是 pip3 安裝庫）：toml phue python-kasa
• 編輯 configuration.toml 文件（在“configs”文件夾中）以定義燈和插頭的名稱。
• 運行 pisquare-server.py

PiSquare 代碼 (MicroPython)

PiSquare 上已經(jīng)安裝了 MicroPython，因此您應(yīng)該可以立即復(fù)制此代碼。

• 將這三個文件復(fù)制到您的 PiSquare
• 將“psconfig_template.py”重命名為“psconfig.py”
• 編輯 psconfig.py 并適當(dāng)更改值，單獨保留引腳轉(zhuǎn)換。
• 安裝 picozero 庫。
• 運行 main.py

怎么運行的

樹莓派服務(wù)器

服務(wù)器軟件將讀取配置文件（TOML格式）。您應(yīng)該能夠定義多個 HAT 配置，因此您可以將多個 PiSquares 與一個 Pi 服務(wù)器（未經(jīng)測試）一起使用。

這三個值（psalias、類型和主機）定義了每個按鈕的“名稱”、它控制的設(shè)備類型以及每個“處理程序”中使用的“主機”值。

每個 HAT 都需要自己的庫來處理特定 HAT 的輸入/輸出。在啟動“偵聽器”代碼之前，服務(wù)器將為每個 HAT 實例化一個類對象。

“偵聽器”代碼（希望如此！）是通用的，僅用于處理來自 PiSquare 的輸入。目前，該流量始終從 PiSquare 開始，對每個請求的響應(yīng)都會發(fā)送回 PiSquare。我希望稍后擴展它，這樣它也可以從 Pi 開始對話。

PiHutStatus 類設(shè)置并處理來自 PiSquare 的所有消息。該定義由 configuration.toml 文件提供。如果您編寫自己的 HAT 處理程序代碼，則需要確保包含“handlerequest”方法，該方法接收從 PiSquare 發(fā)送的消息并執(zhí)行您想要的任何操作！

PiSquare 客戶端

main.py 中的 PiSquare 客戶端代碼主要是特定于 HAT 的。但是，它確實包含一段通用代碼，用于處理 PiSquare 與 Wi-Fi 的連接以及與 Pi 之間的消息發(fā)送/接收。

消息格式

Python 很好地處理了 Python 字典和 JSON 之間的轉(zhuǎn)換，所以我使用 JSON 在 PiSquare 和 Pi 之間發(fā)送信息。

一般格式為：

{'client': 'clientname', 'payload': {payload}}`

有效負載的結(jié)構(gòu)取決于所需的“操作”。對于此 HAT，它是“requeststatus”或“changestate”。

'changestate' 動作的格式，它打開/關(guān)閉燈/插頭或切換狀態(tài)，是：

{'action': 'changestate', 
 'button': 'whichbutton',
 'status': 'on/off/toggle'}

“requeststatus”動作的格式，請求燈/插頭的當(dāng)前狀態(tài)（開或關(guān)）

{'action': 'requeststatus', 
 'button': 'whichbutton'}

對于您自己的 HAT，您可以根據(jù)需要定義有效負載！

結(jié)論

PiSquare并不完美，但經(jīng)過一些爭論，我已經(jīng)定型并能夠處理一頂簡單的帽子，并為通信端提供了一堆可重用的代碼。Comms 仍然需要一些工作（例如從 Pi 初始化對話），但希望這是一個足夠好的開始，讓大多數(shù)人開始使用大多數(shù) HAT。