【冷氣遙控 2/7】第一份韌體：確認硬體真的會動

charles · 發表於 2026-9-25 02:34:08

上一篇你把 ESP32、紅外線發射 LED、接收頭接好了。這一篇要燒第一份韌體進去，然後用兩個實驗證明「發射真的在發、接收真的在收」。

這篇還不會控制冷氣。 冷氣的協定是下一篇的事。這一篇只回答一個問題：硬體到底有沒有活著。

會分這麼細是有原因的。紅外線壞掉的時候是完全安靜的 —— 沒有錯誤訊息、沒有紅字、冷氣就只是沒反應。如果你在「硬體沒驗過」的狀態下直接去試冷氣協定，你會有兩個未知數同時在動，而且永遠分不出是哪一個。

做完這篇你會有什麼

一台在你家 Wi-Fi 上、可以無線更新的 ESP32
親眼確認過發射 LED 在閃（用手機前鏡頭看）
日誌裡看得到你家冷氣遙控器按下去的原始訊號
這台裝置已經出現在 Home Assistant 的裝置清單裡

這篇用的版本：ESPHome 2026.9.0、Home Assistant Core 2026.9.3。下面所有的選單名稱和設定寫法都是照這兩個版本寫的，如果你看到的畫面對不上，先確認版本。

步驟 1：選一條燒錄的路

ESPHome 有一個叫 Device Builder 的網頁面板，負責編譯設定檔、把韌體燒進板子、以及看日誌。你必須先有一個 Device Builder。

它有四種裝法，先選一種再往下走 —— 這一步選錯的話，後面每一步的畫面都會對不上。

你家 HA 是 HA OS（HA Green、HA Yellow、或自己裝在樹莓派／迷你主機上的 HAOS） → 選 A：HA 的應用程式版。最省事，日誌、燒錄、HA 整合全在同一個瀏覽器分頁裡
你家 HA 是用 Docker 跑的（Container 版） → HA 的應用程式機制在這種安裝方式上不存在，選 B：桌面版 或 C：Docker 版
你還沒有 Home Assistant，只是想先讓板子動起來 → 選 B：桌面版。它是獨立程式，跟 HA 完全無關
你只想花三分鐘確認板子沒壞 → 選 D：瀏覽器版，但它燒不了這篇的設定檔，看完下面的說明再決定

A：Home Assistant 的應用程式版

在 Home Assistant 裡走 設定 → 應用程式 → 安裝應用程式（英文介面是 Settings → Apps → Install App）。

⚠ 這個選單名稱在 2026.2 改過。 舊教學寫的是「設定 → 附加元件 → 附加元件商店」，那是 2026.2 之前的名字。功能完全一樣，只是「附加元件（Add-ons）」正式改名成「應用程式（Apps）」了。看到舊名稱的教學不代表它錯，只是它的選單路徑要自己換算。

在清單裡找 ESPHome Device Builder，點進去按安裝，再按啟動，然後把在側邊欄顯示打開。

你會看到：左邊側邊欄多出一個 ESPHome 的項目，點進去是一片空的裝置清單。

清單裡根本找不到 ESPHome Device Builder → 代表 ESPHome 的存放庫還沒註冊。按右上角的 ⋮ 選 存放庫（Repositories），貼上 https://github.com/esphome/home-assistant-addon 按新增，關掉對話框再找一次。

看不到側邊欄的項目 → 「在側邊欄顯示」那個開關沒打開，回應用程式頁面再確認一次。

B：桌面版（Windows / macOS / Linux）

這是比較新的選項，很多 2025 年的教學還沒提到它。到 esphome.io 的安裝頁選你的作業系統，下載安裝檔：

Windows —— 下載 .exe，雙擊安裝。跳出「Windows 已保護您的電腦」時按其他資訊 → 仍要執行。裝完從開始功能表開啟
macOS —— 下載 .dmg，把 ESPHome Device Builder 拖進應用程式資料夾。第一次開啟時 macOS 會問，按開啟。需要 10.15 以上
Linux —— 有 .deb、.rpm、AUR 套件和 AppImage 四種。用 AppImage 的話記得 chmod +x

你會看到：一個視窗，裡面就是 Device Builder 的網頁介面，跟 A 的內容一模一樣。

Linux 上序列埠抓不到 → 把自己加進 dialout 群組（`sudo usermod -a -G dialout $USER`），登出再登入。

C：Docker 版

docker run --rm --net=host -v "${PWD}":/config -it ghcr.io/esphome/esphome

複製代碼

跑起來之後開 http://localhost:6052。

--net=host 不能省。 Device Builder 需要 mDNS 才能自己發現裝置、才能用 ac-ir.local 這種名字連線。在 Docker Desktop 上沒有 host 網路模式，只能改成 -p 6052:6052 —— 面板照樣會跑，但之後每次連裝置都得手動打 IP。

D：瀏覽器版（web.esphome.io）

用 Chrome 或 Edge 打開 web.esphome.io，插上板子，按 Connect 選序列埠，再按 Prepare for First Use → Install，最後填 Wi-Fi 帳密。

⚠ 這條路有一個硬限制，而且很多教學沒講清楚：它只能燒一份通用的空白韌體，沒有辦法燒本篇的設定檔（沒有 remote_transmitter、沒有 remote_receiver、沒有測試按鈕）。它的用途是「先讓板子上網」，然後在 Device Builder 的 Discovered 區塊把它收編進來，再套用你的設定檔。

所以 D 不能取代 A/B/C，只能當 A/B/C 的前置。 如果你只是想確認板子沒壞，它三分鐘就能給你答案；但做完這篇你還是需要 A、B、C 其中一個。

另外它只在 Chromium 核心的瀏覽器（Chrome、Edge、Opera）上能用，Safari 不行。

步驟 2：USB 線與驅動程式

第一次燒錄一定要用 USB 線接電腦，沒有例外。 板子上現在還沒有 ESPHome，沒有任何東西在聽無線更新的要求 —— 「無線」是靠已經跑起來的 ESPHome 提供的服務，雞生蛋蛋生雞。

線要接到哪一台電腦：接到你現在操作瀏覽器的這一台，不是 Home Assistant 主機。Device Builder 是透過瀏覽器的序列埠功能去燒的，所以板子要插在你面前這台。

以下還有約 80% 的內容
登入後即可閱讀完整教學

登入繼續閱讀使用 Google 登入

		自動登入	找回密碼
密碼			立即註冊

【冷氣遙控 2/7】第一份韌體：確認硬體真的會動

延伸閱讀

瀏覽過的版塊