示範如何破解 M2 接入到 HA（/Ft. 紅軍；插件作者：洋蔥大）

把 Aqara M2 網關刷成社群韌體後接入 Home Assistant 的完整示範。分「舊版 M2」與「2022 版 M2 POE」兩種燒錄方式，逐段附原作者連結與畫面。

本教學涉及刷寫第三方社群韌體與 telnet 操作，有變磚（無法開機）風險；使用的燒錄工具、韌體為第三方社群作品（非 Aqara 官方、非惟家開發）。以下外部連結為原作者資源，日後可能失效或更新，請以原作者 GitHub repo 最新版為準。

設定畫面可能因版本與設備不同而有差異。想交流使用經驗，歡迎加入惟家 LINE 社群；社群以使用者互助為主，非官方一對一技術支援。

一、洋蔥大的 Aqara Gateway 外掛

HA 端使用的外掛（原作者洋蔥大）：niceboygithub / AqaraGateway（GitHub）

舊版 M2 硬體燒錄接點對照圖：M2 UART 點位圖（GitHub）

・最新 M2 韌體：M2 韌體列表

・下載 gw_global_tool.expect、最新 M2 韌體、flasher_m2gl.bin，三個檔案放同一資料夾。

・安裝 Homebrew（brew.sh）後安裝相依套件：

bash

brew install expect lrzsz stty

・Mac 燒錄懶人包：下載 mac_m2 懶人包（第三方短址·可能失效）；賦予執行權限：

bash

chmod +x gw_global_tool.expect

・HACS Repository 輸入：niceboygithub/AqaraGateway

・安裝最新版本 0.2.0（要支援 Aqara M3 需選 Master 版）。

・安裝完畢後重啟 HA。

進入「設定」→「裝置與服務」→ 點選燒錄完成的 M2，即完成接入 HA。

・M2 POE 版斷電。

・下載 USB 燒錄檔案（M2 POE 燒錄說明），copy 到 USB 隨身碟（FAT32）後插入 M2 的 USB 孔。

・按住 M2 前置按鈕上電，直到前置 LED 變紫色後鬆開，等 M2 重啟即完成燒錄。

・Telnet 登入 M2（帳號 root、無密碼）後輸入更新指令，執行完 reboot；再 Telnet 登入重複一次更新指令後 reboot 即完成。

・懶人包下載 curl：

bash

cd /tmp && wget -O /tmp/curl "http://master.dl.sourceforge.net/project/aqarahub/binutils/curl?viasf=1" && chmod a+x /tmp/curl

・關閉自動更新指令參考：niceboygithub/AqaraGateway

・懶人包關閉指令：

bash

mkdir -p /data/ota_dir
touch /data/ota_dir/lumi_fw.tar
chattr +i /data/ota_dir/lumi_fw.tar