QEC MySQL HMI 測試工具是一套圖形化的 MySQL 驗證工具，運行於 QEC-M-070T 平台上。透過 800 × 480 觸控式 HMI，使用者可以經由 Ethernet 連接 MySQL Server，並直接在面板上執行測試資料寫入、資料表讀取、安全刪除記錄、自動寫入測試，以及操作紀錄檢視等功能。
本範例設計為一套適合初學者使用的測試工具與教學示範。它可以協助使用者理解從 HMI 操作、SQL 執行，到畫面回饋顯示的完整流程，而不需要一開始就建立完整的正式資料庫管理系統。
1. 快速概覽
- 透過 Ethernet TCP/IP，從 QEC-M-070T 連線至 MySQL / MariaDB Server。
- 可由 HMI 手動輸入測試資料，並立即驗證資料庫寫入結果。
- 可讀取資料表記錄，並支援排序、筆數限制選擇、分頁顯示與總筆數統計。
- 透過安全的 FIND → PREVIEW → DELETE → CONFIRM 流程刪除資料記錄。
- 可執行 Auto Test，定期寫入模擬資料，並追蹤 OK / FAIL 結果。
- 可使用 LOG 與 Retry Buffer 檢視 SQL 執行結果，並重新嘗試寫入失敗的自動測試資料。
2. 功能總覽
本工具提供六個 HMI 頁面，每個頁面皆對應 MySQL 測試流程中的特定操作。使用者可以依序完成資料庫連線、資料寫入、資料表讀取、資料刪除、自動測試執行，以及操作紀錄檢視等步驟。
2.1 INSERT — 手動測試資料輸入
INSERT 頁面用於手動寫入一筆測試記錄。使用者選擇資料表後，輸入 name、age 與 class，並按下 INSERT。接著 HMI 會將 SQL INSERT 操作加入佇列，並顯示執行結果。
2.2 READ — 分頁查詢資料記錄
READ 頁面可用於查詢資料表記錄，並支援選擇資料表、排序方向與讀取筆數限制。畫面同時會顯示目前頁碼、資料範圍、總筆數，並提供 PREV / NEXT 按鈕供使用者切換瀏覽。
2.3 DELETE — 查詢後安全刪除資料
DELETE 頁面會先依照 ID 查詢資料記錄，並顯示該筆資料的預覽內容。使用者必須確認操作後，工具才會送出 DELETE 指令，以降低測試過程中誤刪資料的風險。
2.4 AUTO — 自動寫入測試
AUTO 頁面會定期將模擬資料寫入所選資料表。畫面會顯示總操作次數、OK / FAIL 計數、最新 SQL 執行時間、Readback 狀態，以及最新產生的模擬資料。
2.5 LOG — 操作紀錄與重試暫存區
LOG 頁面會記錄連線事件、SQL 操作、Auto Test 狀態與錯誤訊息。自動寫入失敗的資料會被儲存在 Retry Buffer 中，並可透過 RETRY ALL 再次送出。
2.6 SETTINGS — 執行期間連線設定
SETTINGS 頁面可讓使用者在程式執行期間修改 Server IP、Port 與 Database。這些設定屬於暫時性的執行期間設定，重新開機後會恢復為 sketch 中的預設值。
3. 第一次端到端測試流程
以下流程可用於驗證完整的 MySQL HMI 操作路徑，包含連線、寫入、讀取、刪除、自動測試與 Log 檢視。
- 開啟 QEC-M-070T 電源，並確認 HMI 標題列顯示 Not Connected.
- 按下 CONNECT 並確認狀態變更為 Connected.
- 在 INSERT 頁面中，選擇
aaa_test，按下 SAMPLE，接著按下 INSERT. - 切換至 READ 頁面，選擇
aaa_test，將 Sort 設為 DESC，將 Limit 設為 10然後按下 READ. - 確認新寫入的資料出現在 RECORDS 表格中。
- 切換至 DELETE 頁面，輸入該筆資料的 ID，按下 FIND，並確認預覽資料。
- 按下 DELETE ，並再次確認以刪除該筆資料。
- 回到 READ 頁面並再次查詢，確認該筆資料已被刪除。
- 切換至 AUTO 頁面，選擇
aaa_test與 3s 間隔，然後按下 START. - 觀察 TOTAL / OK / FAIL、Last SQL 與 LOG 頁面的紀錄，最後按下 STOP.
4. 所需設備
| 部件 | 必要條件 |
| QEC 主站 | QEC-M-070T 或相容的 QEC HMI |
| 網路 | QEC 裝置與 MySQL Server 之間需建立 Ethernet 連線 |
| 資料庫 | QEC 裝置可連線存取的 MySQL / MariaDB Server |
| 資料表 | aaa_test 以及 bbb_test ，欄位包含 id, name, age和 class_name |
| 函式庫參考 | LVGL 7.1.11、SCoop、Ethernet TCP/IP、MySQL library |
5. 重要提示
本範例主要用於封閉式 LAN 或實驗室環境中的教學、驗證與測試工具用途。若要應用於正式系統，請加入適當的存取控制、指令驗證、SQL 防護、錯誤處理，以及安全的網路架構設計。
執行期間的 SETTINGS 頁面可暫時修改 Server IP、Port 與 Database。重新開機後，裝置會恢復為 sketch 中的預設值。
6. 資源
- 開發指南 PDF： QEC_MySQL_Test_Tool_EN | QEC_MySQL_Test_Tool_CN
- 86Duino 端原始碼： QEC_MySQL_Test_Tool.zip
- 86Duino IDE 與 QEC 軟體工具： 軟體
7. 後續延伸
此 MySQL HMI 測試工具可進一步擴充 schema 檢查、更完整的設備資料格式、連線 keep-alive、權限管理、SQL 參數保護，以及更詳細的錯誤分類，以支援更接近正式系統的應用需求。
我們將持續推出穩健且創新的 EtherCAT 自動化平台，讓機台整合更聰明、更快速。欲取得更多資訊或索取樣品，歡迎來信 info@icop.com.tw，致電離您最近的 ICOP分公司，或聯絡我們的 全球官方經銷商。.