跳到內容
快速入門 產品說明

產生程式

WizDash 會依專案的連線設定與儀表板內容,產生可直接在 Arduino IDE 開啟的 ESP32 範本。

WizDash 專案頁與展開的專案選單,專案卡片右側有「管理」按鈕,選單中包含進入儀表板、連線設定、裝置資訊與產生 Arduino 程式碼
步驟 1–2:在「專案」頁點選專案卡片右側的「管理」,專案選單會從畫面下方展開,再點選「產生 Arduino 程式碼」。
  1. 開啟 App,進入「專案」頁。
  2. 找到要產生程式的專案,點選該專案卡片右側的「管理」按鈕。
  3. 在展開的專案選單中,點選「產生 Arduino 程式碼」。
  4. 在「Arduino 程式碼」對話框,依需要設定下方的可選周邊;MQTT 專案還會多出 OTA 開關。
  5. 點選「複製此程式碼」,貼到 Arduino IDE;或點選「匯出檔案」,存成 .ino 檔。

連線設定尚未完成時,App 會顯示「連線設定未完成」的提示,不會開啟對話框。請先在同一個專案選單點選「連線設定」,完成後再回來產生。

範本包含所選連線方式的完整連線流程,以及兩個需要你補充的函式:

  • sendData 把顯示元件的 key 組成一個 JSON 物件送給 App。
  • onCommand 接收 App 送來的指令,並在註解處預留對應的硬體動作。

範本是開發的起點,不是成品。若沒有指定周邊,感測數值會以示範數字代替,控制元件的硬體動作也會以 TODO 標示。燒錄前,請確認腳位、JSON key,以及 WiFi 或 broker 參數。在 Android 上,存檔的位置是「下載」資料夾。

WizDash 完整 Arduino 程式碼檢視視窗,展示 WizDash_ESP32.ino 中的 sendData() 與 onCommand() 實作結構
點選「點擊查看完整程式碼」即可展開檢視完整的 WizDash_ESP32.ino,包含自動對應元件 JSON key 的 sendData() 與 onCommand() 結構。

燒錄前,請先在 Arduino IDE 完成兩件事。產生的範本最上方註解也列有相同的清單。

  1. 選擇開發板。開啟「Tools → Board」,選擇與你的開發板相符的 ESP32 型號,例如 ESP32 Dev Module、ESP32S3 Dev Module 或 ESP32C3 Dev Module。若尚未安裝 ESP32 開發板支援套件,請先在「Boards Manager」安裝 Espressif 的 esp32。
  2. 安裝函式庫。開啟「Tools → Manage Libraries」,搜尋並安裝下表的函式庫。
連線方式函式庫作者用途
全部ArduinoJsonBenoit Blanchon,需 v7 以上組成 sendData 的 JSON 物件,並解析 onCommand 收到的指令
BLENimBLE-Arduinoh2zero提供 BLE 服務與廣播
WiFiWebSocketsMarkus Sattler在埠號 81 提供 WebSocket 服務
MQTTPubSubClientNick O’Leary連接你自備的 MQTT broker

WiFi、ESPmDNS、WiFiUdp、WiFiClientSecure,以及 OTA 使用的 HTTPClient、Update,都內建在 ESP32 開發板支援套件中,不必另外安裝。

ArduinoJson 若是 v6 或更舊的版本,範本會編譯失敗。若出現找不到標頭檔的錯誤,請先確認上表的函式庫已安裝,且版本符合。

產生程式時,可以把部分元件直接接到常見周邊。這些選擇只套用在這一次產生,不會存入專案。

周邊可對應的元件
DHT11 溫濕度感測器垂直溫度計、水滴波浪球
可變電阻數據面板顯示原始讀值;圓環儀表板與進度條顯示百分比
繼電器或外接 LED一個狀態開關,可選低電位或高電位觸發
RGB LED一個顏色選擇器,可選共陰極或共陽極
PMS3003/5003/7003 粉塵感測器一個數據面板

勾選 DHT11 時,除了上表的函式庫,還需要另外安裝 DHT sensor library(Adafruit 出品)與 Adafruit Unified Sensor。範本最上方註解會在勾選後自動加上這兩項。其餘周邊直接使用 ESP32 內建的功能(analogRead、digitalWrite、analogWrite、Serial2),不需要額外的函式庫。

若儀表板含有地圖元件,並要自行接上 GPS 模組,範本內的註解建議搭配 TinyGPS++ 函式庫。範本不會替你插入 GPS 讀取程式。

可選的腳位以傳統 ESP32-WROOM 為準,並避開開機時有特殊用途的腳位。

MQTT 專案在產生程式時,可額外勾選包含 OTA 更新的版本,詳見OTA 韌體更新。

WizDash 產生 Arduino 程式碼對話框上半部,顯示包含 OTA 開關、DHT11 溫濕度周邊綁定晶片與 .ino 韌體程式碼預覽
周邊與 OTA 設定(上):勾選是否包含 MQTT OTA 更新,並將溫濕度元件綁定至 DHT11 指定 GPIO。
WizDash 產生 Arduino 程式碼對話框下半部,顯示可變電阻 ADC1 GPIO 腳位選擇與繼電器數位輸出設定
周邊腳位設定(下):可將圓環儀表板或數據面板對應至可變電阻(ADC1 GPIO),或將狀態開關對應至繼電器/LED。