描述

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

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

樹莓派代碼

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

PiSquare 代碼 (MicroPython)

PiSquare 上已經安裝了 MicroPython，因此您應該可以立即復制此代碼。

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

怎么運行的

樹莓派服務器

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

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

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

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

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

PiSquare 客戶端

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

消息格式

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

一般格式為：

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

有效負載的結構取決于所需的“操作”。對于此 HAT，它是“requeststatus”或“changestate”。

'changestate' 動作的格式，它打開/關閉燈/插頭或切換狀態，是：

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

“requeststatus”動作的格式，請求燈/插頭的當前狀態（開或關）

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

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

結論

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