Wi‑Fi 偵測節點:不裝鏡頭也知道有人|軟硬整合系列

軟硬整合系列 · 開源硬體+韌體 · ESP32-C3 · Wi-Fi 感測 · 紅外線

Wi‑Fi 偵測節點:不裝鏡頭也知道有人

用家裡的 Wi-Fi 訊號看「有沒有東西在動」,順便量溫濕度與氣壓,還能用紅外線控制日立冷氣(遙控器 RF11T1)。從需求到驗證分成八站接力,每一站只做一件事,產出交給下一站;想懂細節,再點「看深度」。

  • 韌體編譯通過
  • 靜態檢查通過
  • 尚未實機驗證
  • 零件 11/17–11/20 到貨
  • ESP32-C3SuperMini,22.5 × 18 mm
  • 3 種功能動作、溫濕度氣壓、冷氣遙控
  • RAM 34.2%韌體編譯結果(Flash 61.0%)

操作:← → 或頁尾按鈕翻頁;上方角色列可以直接跳到任一站。右上角可切換深淺色。

外殼閉合等角算繪圖
外殼算繪圖(R2)。黑色殼身、白色滑蓋,上端有 IR 發射窗與接收窗;還沒有印出實物。

01 — 產品設計師

決定要什麼、說清楚做不到什麼|需求方本人

先講清楚要什麼,也先講清楚它做不到什麼。

想知道家裡有沒有、 、 , 順便看, 還要能。
隱含條件:

收到需求方三種要偵測的情境+環境數值+冷氣遙控
交出規格:支援 Wi-Fi CSI 的 ESP32 板、I²C 溫濕度氣壓板、紅外線發射電路
Wi-Fi 基地台2.4 GHz,固定一台 CSI ESP32-C3ESPectre:有沒有動ESPHome 韌體一個房間一台 AHT20+BMP280溫度・濕度・氣壓 I²C 紅外線 日立冷氣遙控器 RF11T1・單向 Home AssistantESPHome API 自動探索 HTTP JSON・/metrics同一個區網內讀取 全部留在自己的區網, 不開對外連線
大方向。不加攝影機;動作偵測靠 Wi-Fi 訊號的變化,數值與控制都交給 Home Assistant。

做得到

  • 判斷一個空間「有沒有在動」(移動分數+有動/沒動)
  • 看夜間或睡覺時動作的多寡與時段
  • 溫度、濕度、氣壓
  • 用紅外線送日立冷氣(RF11T1)的遙控指令

做不到(誠實說)

  • 分不出是人還是狗,也不能數人數
  • 不是睡眠分期,不是醫療或保全級設備
  • 需要穩定的 2.4 GHz 基地台;一台只顧一個空間
  • 冷氣協定待實機確認;沒有狀態回饋

點畫線的詞:看它變成哪個決定、交給哪一站(上方角色列會一起亮)。

看深度

完整限制清單:哪些情況會不準限制
  • 只能看到「有動」。ESPectre 偵測的是無線環境的變化;上游文件明寫它不辨識人、不數人數、不能證明房間是空的,也不能取代安全認證的保全、醫療或緊急系統。
  • 分不出人與狗。狗走動、窗簾被風吹、電風扇擺頭,都可能讓分數升高。
  • 睡眠只看身體動作。翻身、起身看得到;睡眠分期、呼吸、心跳都不在這個偵測器的範圍。
  • 需要穩定的 2.4 GHz 基地台。CSI 來自基地台和節點之間的封包;Mesh 網路漫遊換基地台會讓訊號基準改變,建議固定連同一台。
  • 一台只顧一個空間。牆、家具、基地台位置與干擾都會影響範圍;上游建議離基地台約 3–8 m 起試。
  • 校準期要保持靜止。預設偵測器開機時會校準;校準期間房間要安靜,搬動節點後要重新開機校準。
  • 溫度會被板子烘高。Wi-Fi 一直開著、省電關閉,C3 會發熱;感測器放殼的下格,並建議和參考溫度計並放求偏移。
  • 冷氣協定待實機確認。日立 RF11T1 遙控器在文獻上對應 AC344 格式,要先用接收頭錄碼確認;睡眠、快速、節能、定時、防霉等進階鍵不一定支援。
  • 冷氣是單向發射。需要視線可達;Home Assistant 顯示的是「最後送出的指令」或接收頭聽到「遙控器按了什麼」,不是冷氣真實狀態。

怎麼驗收這些限制:

沒有攝影機,不等於沒有隱私問題隱私

CSI 沒有影像也沒有聲音,但「什麼時候有人在動」就能看出作息、睡眠和家裡沒人的時段。這也是上游專案自己強調的設計考量。

  • 資料只送到自己的 Home Assistant;韌體不連任何雲端服務。
  • HTTP 端點沒有登入保護時只能在受信任的區網用,不要做連接埠轉發。
  • 韌體與設定檔不含任何 Wi-Fi 帳密;帳密放在不進版控的 secrets.yaml。
這一頁的決定,後面在哪裡兌現扣合
  • Wi-Fi CSI、一房一台 → 、
  • 溫濕度要準、不被熱源烘到 → 、
  • 遙控日立冷氣(RF11T1)→ 、
  • 交給 Home Assistant、不開對外連線 →
  • 誠實標示驗證狀態 →

02 — 採購

把規格變成零件清單|通用規格,不指定賣家

核心兩片板子:ESP32-C3 SuperMini,加一片 AHT20+BMP280。

C3 SuperMini 是上游 ESPectre 社群驗證過的板子;二合一感測板一片就有溫濕度與氣壓。冷氣遙控另外加一顆紅外線 LED、一顆電晶體,以及一顆紅外線接收頭(先錄下遙控器的碼,確認協定)。

收到三種偵測情境、環境數值、冷氣遙控
交出C3(排針已焊)、4 腳 I²C 感測板、IR LED+NPN+兩顆電阻、VS1838B 接收頭
交出板子尺寸(多數待到貨實量)
  • ESP32-C3 SuperMini(USB-C、排針已焊、4 MB flash、陶瓷天線)×1
  • AHT20+BMP280 二合一 I²C 模組(約 16 × 16 mm、4 腳)×1
  • 杜邦線(母對母)或細線+焊錫×4
  • USB-C 資料線+5 V 充電頭(≥1 A)×1
  • PLA 線材:黑(殼身)、白(滑蓋)各少量
  • M3 盤頭螺絲+壁虎(壁掛,選用)×2
  • 紅外線 LED 940 nm、5 mm型號以實物為準×1(備 2)
  • NPN 電晶體 S8050 或 2N2222(TO-92)×1
  • LED 限流電阻 33 Ω、1/4 W×1
  • 基極電阻 1 kΩ、1/4 W×1
  • 小塊洞洞板或飛線(約 20 × 15 mm)×1
  • VS1838B 紅外線接收頭(38 kHz)必備:錄遙控碼、確認協定×1

只列通用規格,不列價格與賣家。完整規格與來源見 repo 的 bom/BOM.md。

看深度

為什麼是 C3 SuperMini選型
  • ESPectre 的 ESPHome 前端支援 ESP32、S2、S3、C3、C5、C6;上游的 C3 範例設定註明 SuperMini 由社群驗證過。
  • 板子小(22.52 × 18.00 mm,原廠尺寸圖),USB-C 直接燒錄與看 log,不需要另外的 USB 轉序列晶片。
  • 只有 2.4 GHz(C3 晶片本身如此),剛好符合 CSI 的建議頻段。
  • 同款常以不同名稱販售,仿板間按鍵、LED、天線位置可能不同:到貨先對絲印。
二合一感測板:兩顆晶片、兩個位址規格
  • AHT20:溫度、濕度,I²C 位址固定 0x38。
  • BMP280:氣壓(也有溫度),位址 0x76(SDO 接地)或 0x77(SDO 接電源)。多數二合一小板是 0x77;韌體預設 0x77,開機 log 會列出掃描到的位址,看到 0x76 就改設定。
  • BMP280 的金屬蓋上有小孔,不要封住、不要貼泡棉。
  • 板上多半已有 I²C 上拉電阻,到貨確認;VDD 一律接 3V3。
紅外線零件:為什麼要電晶體規格

紅外線 LED 要約 100 mA 的脈衝電流才射得遠,C3 的腳位只能推幾十 mA。所以讓 GPIO 推一顆 NPN 電晶體,LED 的電流從 USB 5 V 經電晶體走。算式在 。

手上的 LED 型號未確認:若規格書寫的電流上限低於 100 mA,限流電阻改用 47–68 Ω。

到貨先確認的三件事清單
  1. C3 的排針焊在哪一面、腳位絲印是否和本頁一致(右上應是 5V、G、3.3)。
  2. 感測板的腳序絲印(常見 VDD、SDA、GND、SCL,但各家不同)、有沒有 SDO 焊點。
  3. 紅外線 LED 的長短腳、規格書電流;電晶體 E/B/C 腳序(不同廠牌不一樣)。

03 — 接線

讀腳位、出接線圖|AI 判讀腳位並自繪接線圖;需求方本人照圖接線

四條線接感測器,再接紅外線發射電路與接收頭;看絲印,不看線色。

  1. 讀 pinout。原廠原理圖與尺寸圖絲印、Espressif 晶片規格書、第三方腳位整理交叉比對(來源列在 wiring/PINMAP.md)。
  2. 選腳。避開 strapping(GPIO2/8/9)、USB(GPIO18/19)、UART0(GPIO20/21);I²C 用 GPIO4/5,紅外線發射用 GPIO3,接收用 GPIO10。
  3. 自己畫圖。SuperMini、感測板、電晶體、LED 都用 SVG 自繪(CC0),線端座標由程式算到腳位中心,每條線都落在真的腳上。
  4. 校稿。逐張看圖:字有沒有重疊、線有沒有蓋住腳名、手機上看不看得清楚。
  5. 人照圖接。先拔 USB;對著實物絲印接,不要憑線色或位置猜。
收到C3(排針已焊)、4 腳感測板、IR 零件
交出感測器在下格、板子在上格、天線端淨空;IR LED 與接收頭要開口
交出SDA=GPIO4、SCL=GPIO5、IR 發射=GPIO3、接收=GPIO10
ESP32-C3 SuperMini 接線圖:3V3 接感測板 VDD、GND 接 GND、GPIO4 接 SDA、GPIO5 接 SCL;GPIO3 經 1 kΩ 接 NPN 基極,5V 經 LED 與 33 Ω 接集極;接收頭 VS1838B 的 OUT 接 GPIO10、VCC 接 3V3
接線總圖(自繪,CC0)。元件面朝上、USB-C 朝上;第幾腳從 USB 端往下數。腳序以實物絲印為準。
點左邊的線,或在「腳位判讀」點任一腳,這裡會說明為什麼這樣接。

看深度

感測板接 3V3,不接 5V原理

感測板的 I²C 上拉電阻接在 VDD。VDD 接 5V 時,SDA/SCL 也會被拉到 5V,而 ESP32-C3 的腳位不耐 5V。整個模組用 USB 5V 供電沒問題,板子會穩壓成 3.3V;只有紅外線 LED 刻意從 5V 取電,而且中間隔著電晶體。

為什麼是 GPIO4/5/3/10:要避開哪些腳原理
  • GPIO2、8、9:strapping,開機時會被讀取;GPIO8 還接板載藍 LED,GPIO9 接 BOOT 鍵。
  • GPIO18、19:USB D−/D+,SuperMini 內部接 USB-C,沒拉出來。
  • GPIO20、21:UART0,保留給序列埠 log。
  • GPIO12–17:接 SPI flash,沒拉出來。
  • C3 的 I²C 走 GPIO matrix,可接任意腳;Arduino 預設的 8/9 只是慣例,正好踩到 strapping,所以不用。
  • GPIO4–7 也是 JTAG:GPIO4/5 拿來當 I²C 後 pad JTAG 不能用,但 USB 燒錄與 log 不受影響。
IR 驅動計算:電阻、電流、為什麼不直驅計算
  • 限流電阻:R = (Vbus − Vf − Vce(sat)) / If = (5.0 − 1.35 − 0.25) / 0.10 ≈ 34 Ω,取 33 Ω,If ≈ 103 mA(Vf 1.2–1.4 V 時約 100–108 mA)。
  • 電阻功率:峰值 I²R ≈ 0.35 W;但 38 kHz 載波約 50% 占空比,協定裡亮與不亮又約各半,平均約峰值的 1/4 以下,每次按鍵只送約 0.1–0.5 秒,1/4 W 電阻足夠。
  • 基極:Ib = (3.3 − 0.7) / 1 kΩ ≈ 2.6 mA,強制 β ≈ 40,遠低於 S8050/2N2222 在 100 mA 的最小 hFE,電晶體會完全導通。
  • 為什麼不讓 GPIO 直接推 LED:C3 單腳只能推幾十 mA,100 mA 會傷腳,降到安全電流又射不遠。
  • 為什麼不從 3V3 取電:3.3 V 扣掉 Vf 與 Vce 後餘裕小,電流對 Vf 誤差很敏感;而且 100 mA 脈衝會和 Wi-Fi 發射的電流尖峰共用板上的 3.3 V 穩壓器。

完整算式與規格書來源在 repo 的 wiring/PINMAP.md。到貨後先量電流與實際可控距離再調。

接完、通電前的檢查步驟
  1. 拔掉 USB 再接線、改線。
  2. 對絲印:VDD→3V3、GND→GND、SDA→GPIO4(右排 #4)、SCL→GPIO5(左排 #1)。
  3. 三用電表量 3V3 對 GND、5V 對 GND:不應導通(嗶聲)。
  4. IR:LED 長腳(陽極)朝 5V;電晶體 E 接地、B 接 1 kΩ、C 接 LED。
  5. 通電後看開機 log 的 I²C 掃描:應出現 0x38 與 0x76 或 0x77。
腳位來源與這些圖的授權出處
  • 腳位:SuperMini 原廠原理圖與尺寸圖、Espressif ESP32-C3 規格書、ESPHome 元件文件,交叉比對結果見 wiring/PINMAP.md。
  • 圖:板子、模組、電晶體、LED 全部自繪(CC0-1.0);沒有使用授權不明的第三方板圖。
  • 接線圖與文件本身隨硬體以 CERN-OHL-P-2.0 釋出。

04 — 機構/3D

建模、留容差、顧可印性|AI 協助 OpenSCAD 建模與自動檢查

殼分兩件:殼身,加一片沿長軸滑開的蓋。感測器在下格,板子在上格,天線端淨空。

R2(目前版本)

  • 感測艙在下、MCU 艙在上:熱往上走,不經過感測器
  • 雙層隔牆中間夾通風縫,只留走線缺口
  • 天線前方約 14.4 mm 只有空氣(R2 為此把殼加寬);線與螺絲都不進天線區
  • 上端 IR 艙:IR LED 座往上傾 15°、VS1838B 的 Ø8 接收窗、洞洞板導槽
  • 壁掛鑰匙孔、立放腳墊位;懸空 ≤45°,免支撐
  • 零件還沒到:未量到的尺寸都做成可容 ±1 mm 的結構
收到感測器下格、板子上格、天線淨空;IR LED 與接收頭位置
收到C3 排針已焊(R2 在板下預留約 10 mm)、感測板約 16 × 16 mm
交出殼身(黑)、滑蓋(白)的 STL,已擺好列印姿態

模型載入中…

—
拖曳旋轉;滾輪或雙指縮放;右鍵或雙指拖曳平移。殼身與滑蓋是分開的兩件,滑蓋沿長軸往上端滑出。
外殼閉合等角算繪圖
閉合
滑蓋半開
滑蓋半開
拿掉滑蓋的俯視圖
拿掉滑蓋
剖面圖:感測艙、隔牆、MCU 艙
剖面
爆炸圖:殼身、滑蓋、開發板與感測板
爆炸圖
紅外線 LED 孔視角與發射錐示意
紅外線孔視角
天線端剖面:天線前方淨空
天線端剖面
壁掛方向示意
壁掛示意

算繪圖為 R2;尚未印出實物。

在 Onshape 開啟公開 CAD 文件(R2)→ R1 舊版 →

看深度

佈局:感測器、熱源、天線三者的取捨機構
  • 壁掛時長軸垂直:感測艙在最下方,冷空氣從下端與兩側格柵進來;C3 的熱往上排,不經過感測艙。
  • 天線(C3 的陶瓷天線端)朝側牆,前方只有空氣與格柵窗;CSI 對天線附近的金屬與會晃動的線很敏感。
  • 不要裝在金屬面、金屬櫃或鋁箔隔熱牆上;USB 線往下固定,不要晃動。
零件還沒到,殼就要先印:容差怎麼留決策

零件 11/17–11/20 才到,但希望先印殼。所以 PCB 厚度、USB-C 凸出量、感測板尺寸這些還沒量到的值,都用側擋+頂壓肋+可壓縮結構容 ±1 mm 以上,不做緊配口袋。到貨後先量,必要時只重印一件。

紅外線 LED 與接收窗的開口R2 已含

R2 外殼已加上:朝冷氣方向的 IR LED 座(上端左側、往上傾 15°,蓋上開喇叭形窗;5 mm LED 直接卡入,3 mm 用列印轉接套)、VS1838B 接收窗(上端右側、Ø8,必備)、直立洞洞板導槽+頂壓條。發射與接收相距 25.4 mm,都避開天線淨空區、感測艙與鑰匙孔。

R2 已含:IR LED 座(上端左側、往上傾 15°,喇叭形窗按 ±27° 開)、VS1838B 的 Ø8 接收窗(上端右側,與發射相距 25.4 mm)、洞洞板導槽與頂壓條。R2 的組裝文件以 GPIO7/GPIO6 舉例;本專案韌體與接線圖用 GPIO3/GPIO10,外殼不受影響(線都走板下、同一個缺口)。

模型檔與這個 3D 檢視器檔案
  • OpenSCAD 原始檔、STL(組裝座標與列印姿態)、算繪圖都在 repo 的 cad/,授權 CERN-OHL-P-2.0。
  • 檢視器載入的 GLB 由組裝座標 STL 轉成(殼身+頂壓條、滑蓋兩個 node),用 three.js r160(MIT)顯示;只有進到這一站才下載。
  • STEP 與兩盤 G-code 檔案大,不放在 git,附在 GitHub Release v0.1.0。

05 — 列印

切片、排盤、印完先量|列印端切片;AI 驗證 G-code

兩盤,和問答機一起排:先白盤(滑蓋),再黑盤(殼身)。免支撐。

點一格看「是什麼+這次怎麼設」。
收到殼身、滑蓋的 STL(列印姿態)
交出印完先量:滑蓋鬆緊、C3 與感測板試放

列印順序:R2(兩個模組一起排,只有兩盤)

狀態:以下是 CAD 自動檢查與切片軟體的估計值,尚未實際印出驗證。

本模組(Wi-Fi 偵測節點)和姊妹專案「兒童 AI 問答機」(MOD-ASK,repo:https://github.com/h2ocloud/mod-ask-kids-ai)的外殼,排在同一組兩盤裡一起印:一盤白、一盤黑。兩個模組只要換一次線材。只想印 Wi-Fi 節點的話,用本 repo 的 cad/stl/plate/WIFI_WHITE.stl、cad/stl/plate/WIFI_BLACK.stl 自己切片即可。

兩盤的順序

順序顏色Wi-Fi 節點的件同盤的問答機件切片軟體估計用料(約)
1白 PLA滑蓋上殼、前面板10 h 04 m90 g(其中 Wi-Fi 滑蓋約 6 g)
2黑 PLA殼身、感測板頂壓條、洞洞板頂壓條、3 mm LED 轉接套 ×2底座、大圓鈕、開關座、卡圈、墊片組、OLED/麥克風壓條、喇叭後腔、喇叭壓環11 h 25 m100 g(其中 Wi-Fi 約 26.5 g)
合計約 21.5 小時約 190 g
  • 為什麼白盤先印:白盤比較短;問答機上殼最大、最容易翹,先印先發現問題。黑盤裡配合件和小件最多,等白盤印好才方便一起試裝。
  • 兩盤都超過 10 小時:建議白天開印,第 1 層全程看著,中途巡一次;不要整夜無人看管。

通用條件

  • FDM 印表機(作者用 Ender-3 級、220 × 220 熱床)、0.4 mm 噴嘴、PLA(只用黑、白兩色)
  • Cura「Low」品質:層高 0.28 mm、2 道牆、免支撐
  • 附著:5 mm brim;滑蓋周圍與彈片切縫處刻意不留 brim(brim 會把彈片黏死)
  • 冷卻:第 1–3 層風扇關閉,第 4 層起全速
  • 本 repo 的 Release(v0.1.0)附有作者那台印表機的兩盤 G-code,含該機的校正值,換印表機請用 STL 自己切片

印完先檢查(Wi-Fi 節點的件)

  1. 滑蓋(白盤):燕尾兩側沒有 brim 殘邊;兩道彈片切縫用名片可以從前端插到底;IR 發射窗、VS1838B 接收窗、BOOT/RST 孔、LED 窗都通透。
  2. 殼身 × 滑蓋(黑盤印好後):滑蓋從上端沿燕尾槽推到底,最後一聲「喀」扣住、不會自己滑開。太緊或太鬆就改 cad/scad/mod_wifi_case.scad 的 fdm_gap(太緊 0.35、太鬆 0.25),殼身與滑蓋一起重印。
  3. 鑰匙孔:M3 盤頭螺絲頭能進入口,往上滑 6 mm 卡住。
  4. 開口:USB-C 線從外面插得進讓位孔;IR LED 座、感測板導槽、洞洞板導槽、接收頭口袋沒有絲線或垂料(有就用美工刀清)。

選印:快速試配片

cad/stl/plate/WIFI_COUPON.stl(滑軌段、滑蓋前段、IR LED 座、USB-C 段、轉接套)約 30 分鐘,零件到貨後最先印來試配;尚未切成 G-code。

G-code 與 STEP 不放在頁面上:到 GitHub Release v0.1.0 下載(STL 壓縮檔、兩盤 G-code、STEP)。

看深度

切片在做什麼概念

切片軟體把 3D 模型切成一層一層(這次每層 0.28 mm),再算出噴頭每一層要走的路徑與擠出量,存成 G-code。FDM 印表機就照著 G-code 一層一層往上疊。

印完先量什麼驗收
  1. 滑蓋(白盤):燕尾兩側沒有 brim 殘邊;兩道彈片切縫用名片從前端插得到底;IR 發射窗、接收窗、BOOT/RST 孔、LED 窗都通透。
  2. 殼身×滑蓋:滑蓋從上端沿燕尾槽推到底,最後「喀」一聲扣住、不會自己滑開。太緊或太鬆改 fdm_gap(0.35/0.25),殼身與滑蓋一起重印。
  3. 鑰匙孔:M3 盤頭螺絲頭能進入口,往上滑 6 mm 卡住。
  4. USB-C 線從外面插得進讓位孔;LED 座、導槽、接收頭口袋沒有絲線或垂料。
為什麼黑殼身、白滑蓋決策

手邊只有黑、白兩色 PLA。殼身黑色耐看、不顯髒;滑蓋白色,板載 LED 的光從薄皮透出來看得到。和另一個模組合併成兩盤一起印,換料只要一次。

06 — 韌體

選路線、寫設定、編譯|AI 研究上游並撰寫 ESPHome 設定

ESPHome 內建的 ESPectre 看動作,加上溫濕度氣壓與日立冷氣紅外線,設定檔與錄碼韌體都編譯過。

  1. 選路線ESPHome 2026.10 內建 espectre
  2. 寫設定一份 wifi-node.yaml,帳密放 secrets
  3. 編譯主設定+錄碼韌體等 8 種組合全部通過(ESP-IDF 5.5.6)
  4. 燒錄待零件到貨(尚未實機)
預設設定CSI+感測+IR 收發+HTTPRAM 34.2%
Flash 61.0%
全部選配+MQTT+指定 ping+學習碼按鈕RAM 35.5%
Flash 67.9%

RAM=靜態配置(321,296 B 中);Flash=應用程式分區(1,835,008 B 中)。執行期 heap 用量要實機才量得到。

收到GPIO4/5(I²C)、GPIO3(IR 發射)、GPIO10(接收)
交出Home Assistant 實體、HTTP JSON、/metrics
# ESPHome 2026.10 起內建,不用 external_components
espectre:
  detection_algorithm: lightweight  # 開機校準,期間保持靜止
  traffic_generator_mode: ping      # 預設 ping 預設閘道

binary_sensor:
  - platform: espectre
    motion: {name: Motion}
sensor:
  - platform: espectre
    movement: {name: Movement Score}

wifi:
  ssid: !secret wifi_ssid           # 帳密只在 secrets.yaml
  password: !secret wifi_password
  power_save_mode: none             # CSI 需要無線電一直醒著

要 ping 別台主機時,啟用 packages/csi-ping-target.yaml,目標 IP 寫在 secrets.yaml,設定檔裡不寫死任何位址。

看深度

為什麼選 ESPHome 內建的 espectre選型
  • ESPectre 有 ESPHome、Native、Matter 三種前端;要接 Home Assistant、又要加溫濕度與紅外線,ESPHome 最省事。
  • ESPHome 2026.10 起內建 espectre 元件;上游的 external component 路線已標示淘汰、預計 ESPectre 3.3 移除。所以直接用內建元件,不必從 GitHub 拉元件。
  • 內建元件沒有 ESPectre 的 Direct API(瀏覽器工具用);需要時可加上游的 espectre_direct 附加元件,這版沒加。
版本、框架、已知限制需求
  • ESPHome ≥ 2026.10(本專案用 2026.10.2 編譯);框架 ESP-IDF ≥ 5.5.3(或 Arduino ≥ 3.3.7)。本專案用 ESP-IDF,編譯時拉到 5.5.6。
  • Wi-Fi 省電關閉:元件會強制關閉省電,讓無線電持續收 CSI,所以耗電與發熱比一般 ESPHome 裝置高。
  • 不做漫遊掃描:元件會停止 ESPHome 的週期漫遊掃描(掃描會讓無線電離開頻道好幾秒);斷線時仍會正常重連。
  • 流量:CSI 要有封包才有資料,預設 ping 預設閘道;網路要允許這些流量。
  • RMT:C3 有 2 個發送+2 個接收通道;紅外線發射用 1 個、接收頭用 1 個,ESPectre 不用 RMT。日立一幀約 346 個 symbol,比 RMT 硬體記憶體(96)長,要靠接收的 ping-pong 接續,需實機確認。
日立 RF11T1 的協定:文獻說 AC344,要實機確認協定
  • 紅外線函式庫 IRremoteESP8266 的支援清單寫「Hitachi RF11T1 remote (HITACHI_AC344)」:43 bytes、38 kHz、標頭 3300/1700 µs。
  • ESPHome 對應平台是 hitachi_ac344(另有 hitachi_ac424),可接收解碼;原作者測的是 RF10T1 遙控器,不是 RF11T1。
  • 支援:關/冷氣/除濕/送風、16–32 °C、風速 4 段、左右擺風。睡眠、快速、節能、定時、防霉等鍵沒有對應控制項;擺風在部分機型有已知問題。
  • 所以接收頭是必備:先燒 ir-learn.yaml,對著接收頭逐鍵按,看是解成 AC344、AC424,還是只有 raw/pronto。
  • 備案:把錄到的 raw/pronto 做成固定情境按鈕(例如冷氣 24 °C、關機、除濕、睡眠),見 packages/ir-raw-scenes.yaml。

逐鍵錄碼流程與紀錄表見 repo 的 docs/IR_HITACHI.md。

授權:為什麼韌體是 GPL-3.0授權

ESPectre 是 GPL-3.0-only,ESPHome 的 C++ 執行程式碼是 GPLv3。編出來的韌體是一個結合後的程式,散布時整體要用 GPLv3。所以本專案的韌體設定檔採 GPL-3.0-only,與上游一致;硬體(外殼、接線、BOM)仍用 CERN-OHL-P-2.0。

07 — 整合

燒錄、接 Home Assistant、開 HTTP|需求方本人操作;AI 寫步驟

燒進去之後,Home Assistant 自己找到它;要用程式讀,就打 HTTP。

  1. 準備帳密。cp secrets.example.yaml secrets.yaml,填自己的 Wi-Fi(只支援 2.4 GHz)與密碼。
  2. 編譯。在 Python 虛擬環境裝 ESPHome 2026.10.x,esphome compile wifi-node.yaml。
  3. 第一次 USB 燒錄。esphome run wifi-node.yaml,選序列埠。燒不進去:按住 BOOT、點一下 RST、放開 BOOT 再試。
  4. 看 log。確認連上 Wi-Fi、I²C 掃描到 0x38 與 0x76/0x77、ESPectre 開始校準(保持房間安靜)。
  5. 先確認冷氣協定(接收頭必備)。第一次先燒 ir-learn.yaml,拿 RF11T1 遙控器對著接收頭逐鍵按,確認解成 AC344;再燒回主設定。
  6. 加進 Home Assistant。設定 → 裝置與服務會出現 wifi-node;開機 15 分鐘內完成配對(API 金鑰此時才配發)。
收到編譯通過的設定檔
交出實體清單、HTTP 端點、逐鍵錄碼紀錄表,等實機驗收

HTTP 端點(同一個區網內)

Home Assistant 會出現哪些實體實體
  • 動作:Motion(有動/沒動)、Movement Score(0–1)、Calibrating(校準中)、CSI Traffic Source(流量來源)、Recalibrate(重新校準)。
  • 環境:Temperature、Humidity(AHT20)、Pressure(BMP280)。
  • 冷氣:Hitachi AC(開關=模式 OFF、冷氣/除濕/送風、目標溫度 16–32 °C、風速 自動/低/中/高、左右擺風)。
  • 診斷:Wi-Fi Signal、Uptime、BMP280 Temperature、CSI 收包率等。

看深度

安全邊界:只在受信任的區網用安全
  • HTTP 端點預設沒有登入;要保護就在設定檔打開 web_server 的 auth(帳密放 secrets)。
  • 不要把裝置做連接埠轉發到網際網路;要從外面看,走 Home Assistant 自己的遠端存取或 VPN。
  • Home Assistant API 金鑰在第一次配對時才配發,而且只在開機後 15 分鐘內接受;拿到金鑰的人也能 OTA 更新韌體,所以只在自己的網路配對。
為什麼用 web_server+prometheus,不自己寫 API取捨

前一個專案(機房溫濕度感測器)是自己寫的 Arduino HTTP API。這次改用 ESPHome,內建的 web_server 已經每個實體一個 JSON 端點、可以 POST 控制冷氣,prometheus 元件給 /metrics,不用另外維護程式碼。代價是 flash 多約 39 KB;也沒有歷史緩衝(歷史交給 Home Assistant 或 Prometheus 存)。

MQTT(選配,預設關)選配

在設定檔的 packages 打開 mqtt,broker 與帳密寫在 secrets。已經用 Home Assistant API 時通常不需要;只用 MQTT 時可以把 discovery 打開。全部選配一起開時,靜態 RAM 35.5%、flash 67.9%(編譯結果)。

冷氣狀態為什麼會不同步限制

紅外線是單向的:節點送出指令,冷氣不會回報收到沒有。Home Assistant 顯示的是「最後送出的指令」。有人用原本的遙控器改設定、或指令沒射到(擋住、角度、距離),畫面就和冷氣不一致。接收頭聽得到遙控器送的碼時(而且協定解得出來),畫面會跟著更新;但那只代表「遙控器按了什麼」,不是冷氣的真實狀態(尚未實機驗證)。

08 — 驗證

把做了的和還沒做的分開寫|AI 跑檢查;到貨後需求方實機驗收

現在只能說:編譯通過、靜態檢查通過、尚未實機驗證。

零件 11/17–11/20 才到。到貨前能做的都做了;跟實物有關的每一項,都標成「待實機」。

收到燒錄步驟、實體清單、HTTP 端點
交出實機結果回頭驗證需求與限制
項目狀態說明
ESPHome 編譯(9 種組合)通過2026.10.2、ESP-IDF 5.5.6;含主設定、錄碼韌體、學習碼備案、R2 腳位對照組;用範本假值
設定檔驗證通過esphome config 全部組合 valid
機密掃描(repo+網頁+Release 附檔)0 命中帳密、金鑰、內網位址、本機路徑、個資;含 G-code、STEP、STL、GLB、圖片 metadata
腳位交叉查證靜態原廠資料+晶片規格書+ESPHome 文件
外殼 STL 流形與干涉靜態由外殼分頁自動檢查(R2:4 種版本 × 44 項干涉/功能全過、故意改壞 22/22 抓得到;兩盤 G-code 逐項驗證全過)
動作偵測實際效果待實機擺放、校準、誤報率
I²C 位址、溫濕度偏差待實機0x76/0x77、與參考溫度計比對
紅外線控制日立冷氣(RF11T1)待實機RF11T1 是否真的是 AC344、可控距離與角度
外殼列印與試裝待實機滑蓋鬆緊、板子與感測板裝得進去

看深度

到貨驗收計畫(照順序)計畫
  1. 對絲印、量 C3 與感測板尺寸;殼試裝。
  2. 只接感測板,燒韌體,看 I²C 掃描與溫濕度氣壓讀值。
  3. 放到最終位置,重新開機讓 ESPectre 校準(保持安靜),走動、靜止各測幾次,記錄移動分數。
  4. 夜間讓狗自由活動,確認有動會亮,並記錄誤報情況(例如風扇、窗簾)。
  5. 接上紅外線電路,先用手機相機看 LED 有沒有在閃(多數手機前鏡頭看得到 940 nm),再對冷氣測開關、模式、溫度。
  6. 接收頭接好後燒 ir-learn.yaml,逐鍵錄 RF11T1 的碼、確認是不是 AC344;解不出來就用學習碼備案。
  7. 和參考溫濕度計並放 30 分鐘,求溫度偏移後寫進設定。
已知風險風險
  • Wi-Fi 省電關閉、無線電一直開:盒內溫度會比室溫高,AHT20 讀值要校正。
  • 紅外線 LED 射程與角度:被殼壁擋住或角度不對,冷氣就收不到。
  • RF11T1 對應 AC344 只是文獻:協定不對時冷氣完全沒反應;擺風在部分日立機型有已知問題。
  • Mesh 網路漫遊:會讓 CSI 基準改變,建議固定連同一台基地台。
  • 仿板差異:按鍵、LED、天線位置可能和原廠圖不同。

製作紀錄(邊做邊記)

誰、在什麼時候、做了什麼|哪裡出錯、又怎麼改

這不是事後補寫的完美流程,是一路做、一路記下來的。

時間是台灣時間,新的在上面;不確定的時間標「約」。零件到貨、印製、實機驗證的消息會繼續往上加。

  1. 11/15(日)23:39AI上線後檢查前後差異,發現頁首標題被我換成短版,蓋掉了基建|監看在線上頁改好的完整標題。
    • 失敗:更新前只拿自己上一版部署的 zip 比對,沒有比對線上頁,看不到別人改過的地方。
    • 修正:頁首改回監看設定的完整標題,逐字相同。
    • 完整標題在手機上會擠壓頁碼與深淺色按鈕,另外加一行樣式讓它們不換行,頁首那行本身不動。
    • 修正:更新流程加防呆,線上頁若有別人改過、新版沒納入的行就停止,並用當時的線上備份重現測試。

    Claude Opus 工作分頁

  2. 11/15(日)23:35產品系列命名改為「產品名:賣點|軟硬整合系列」,本專案標題是「Wi‑Fi 偵測節點:不裝鏡頭也知道有人|軟硬整合系列」。
    • ToolHub 標題由基建|監看統一改名,改名期間暫停更新專案頁,本機先備好頁面標題、封面與姊妹頁連結文字,README 與紀錄標題先在 GitHub 改好。
    • 解除暫停後,更新流程改成先讀 CMS 目前的標題、逐位元組原樣送回,Wi‑Fi 的不換行連字號不可被正規化,並加測試把關。
    • 失敗:標題替換腳本重跑時把導言重複了一句。
    • 修正:先判斷新字串是否已存在再替換。
    • 失敗:宋體把不換行連字號畫成全形,大標看起來像「Wi - Fi」。
    • 修正:只讓大標的 Wi‑Fi 改用拉丁襯線字型顯示,字元本身不變。

    Claude Opus 工作分頁

  3. 11/15(日)21:06AI發現 CMS 更新時若沒帶自訂 slug,會被依名稱重新產生;已改成每次更新都帶 slug、更新後回讀確認,並重送修正。
    • 上線後驗證重跑 15/15(CMS 欄位、slug、描述都保留)。
    • 完整報告 qa/REPORT.md 完成,回報需求方。

    Claude Opus 工作分頁

  4. 11/15(日)21:02AI第一次跑一鍵更新流程,遇到三個問題都已修正。
    • 失敗:bash 把緊接在變數後的全形符號當成變數名的一部分,腳本一開始就停下;修正:變數一律加大括號。
    • 失敗:姊妹專案「兒童 AI 問答機」的 ToolHub 頁剛上架,自動補上的連結被掃描擋下(ToolHub 網域預設禁止);修正:只精確放行該頁的公開網址。
    • 失敗:更新後驗證把下載結果當成文字比對,誤判失敗(其實已更新成功);修正後重跑,扣掉平台注入的按鈕後逐字相同、縮圖等於封面。

    Claude Opus 工作分頁

  5. 11/15(日)21:01AI階段 B 上線完成:公開 GitHub repo(main、tag v0.1.0、Release 附 STL 壓縮檔/兩盤 G-code/STEP)與 ToolHub 新工具都已上線。
    • 上線後驗證 15/15:帶 Host 的公開網址、縮圖與 favicon、zip 22 個檔、線上 3D 檢視器、GitHub 匿名開啟與 README 圖片。
    • 線上頁比上傳檔多一段平台注入的「回 ToolHub」按鈕,扣掉後逐字相同。
    • 這一筆是第一次用 journal_append.sh 以同一個工具 id 加法更新。

    Claude Opus 工作分頁

  6. 11/15(日)20:56AI上線前最後一次看封面,發現封面圖上還寫著「大金紅外線」(下午改成日立時漏改;文字在圖片裡,掃描抓不到)→ 改成「日立冷氣紅外線」並重產封面。
    • 教訓:圖片裡的文字要用眼睛看,不能只靠文字掃描。

    Claude Opus 工作分頁

  7. 11/15(日)20:50–20:53軟體專案頁新增「製作紀錄(邊做邊記)」一站(可依角色篩選、可展開),頁面 QA 28/28 通過(桌機/手機、深淺色截圖)。

    Claude Opus 工作分頁

  8. 11/15(日)20:44–20:53AIsecret 掃描擴大到 G-code、STEP 與 Release 附檔,最後 0 命中(153 個檔案)。
    • 失敗:G-code 座標與 STEP 浮點數被誤判成禁用數字或編號格式。修正:G-code 只掃註解、STEP 只掃檔頭與字串。
    • 失敗:正向測試發現 Windows 的使用者資料夾路徑原本偵測不到。修正:補上規則,假資料正向測試 14+6 種全部抓到。
    • 文件裡出現的內部工作編號與帳號字樣,改成一般寫法。

    Claude Opus 工作分頁

  9. 11/15(日)20:40–20:52機構把 R2 接進 repo 與專案頁:可旋轉 GLB(殼身+頂壓條、滑蓋分件)、算繪圖 11 張、列印順序改寫成兩模組合排的通用說明、組裝文件加上腳位差異說明。
    • 列印順序只寫通用條件(PLA、Cura Low 0.28、免支撐、第 1–3 層關風扇),不寫印表機設定檔與偏移數值。
    • 新增 Release 附檔:STL 壓縮檔、兩盤 G-code、STEP;專案頁只放算繪圖與 GLB,下載連到 Release。

    Claude Opus 工作分頁

  10. 11/15(日)20:35AIG-code 的註解裡留有切片電腦的本機路徑 → Release 版只清掉這類註解行,其餘每一行逐字比對相同。
    • STEP 與 G-code 都超過 10 MB,不放進 git 主樹,改附在 GitHub Release。

    Claude Opus 工作分頁

  11. 11/15(日)20:34–20:39韌體全部重新編譯:9 種組合(含 R2 腳位對照組)都通過,C/C++ 警告 0;主設定 RAM 34.2%、Flash 61.0%,和下午相同。

    Claude Opus 工作分頁

  12. 11/15(日)20:33韌體對照 R2 組裝文件發現 IR 腳位不同:R2 以 GPIO7(發射)/GPIO6(接收)舉例,本專案韌體與接線圖是 GPIO3/GPIO10。
    • 決定:以已編譯的韌體為準;外殼不用改,線都走板下、同一個缺口。
    • 另把 GPIO7/GPIO6 的組合也編譯一次當備案,改兩行就能切換。

    Claude Opus 工作分頁

  13. 11/15(日)20:31AI階段 B 開始:需求方授權端到端做完並上線(公開 GitHub repo+ToolHub 新工具)。

    Claude Opus 工作分頁

  14. 11/15(日)20:30機構R2 最終版交件:SCAD、STL(組裝、列印姿態、備用版本)、STEP、算繪圖 11 張、組裝與列印文件、現行兩盤 G-code,以及 Onshape R2 公開連結。
    • R2 已含 IR LED 座(上端左側、往上傾 15°)、VS1838B 的 Ø8 接收窗(上端右側,與發射相距 25.4 mm)、洞洞板導槽。

    CAD R2 分頁

  15. 11/15(日)16:51切片重切現行版 G-code:兩盤重新置中,風扇改回第 1–3 層全關(對齊之前已成功印過的外殼設定)。
    • 舊檔一律不用;兩個模組的 cad-drop 拿到的是同一組兩盤。

    切片端(兩模組合排)

  16. 11/15(日)13:16切片收到兩個模組合排的兩盤 G-code,逐項驗證:白盤全部通過,黑盤 43/44。
    • 失敗:黑盤首層速度不合格(姊妹模組的 brim 避讓段快速移動後,沒有恢復原本的進給速度)→ 退回合排端修正後重驗。

    CAD R2 分頁

  17. 11/15(日)13:00–13:02AI閘門:外殼 R2 還沒交件 → 上線腳本演練通過後先停下,回報「階段 A 完成,等 R2,尚未上線」。

    Claude Opus 工作分頁

  18. 11/15(日)12:58–12:59AI收尾檢查:大金字樣殘留 0、secret 掃描 0 命中、頁面 QA 25/25;repo 建好第一個 commit(還沒 push)。

    Claude Opus 工作分頁

  19. 11/15(日)12:51–12:56韌體改成日立之後全部重新編譯:8 種組合都通過,C/C++ 警告 0。
    • 主設定 RAM 34.2%、Flash 61.0%;錄碼設定 RAM 33.4%、Flash 52.8%。

    Claude Opus 工作分頁

  20. 11/15(日)12:47產品更正:冷氣是日立(遙控器 RF11T1),不是大金。
    • 韌體改用 ESPHome hitachi_ac344(IRremoteESP8266 的對照表把 RF11T1 歸在 HITACHI_AC344;這只是文獻對應,要錄原廠遙控器確認)。
    • 因為協定不確定,VS1838B 接收頭從選配改成必備,寫進主要 BOM 與接線圖。
    • 新增錄碼用的 firmware/ir-learn.yaml 與 docs/IR_HITACHI.md(逐鍵錄碼流程、raw/pronto 備案)。
    • repo、頁面、文件裡的大金字樣全部移除;CAD R2 分頁同時把接收窗改成必要開口。

    需求方

  21. 11/15(日)約 12:25–12:32AIsecret 掃描、封面、上傳用 zip、上線腳本(預設只演練)、頁面 QA 第一輪。
    • 誤判修正:SVG 座標、文件章節編號被當成 IP 位址 → 調整比對規則,並用 14 種假資料做正向測試確認仍抓得到。
    • 顯示問題:襯線字型把不換行連字號畫成「Wi - Fi」→ 全部改用一般連字號。

    Claude Opus 工作分頁

  22. 11/15(日)12:12軟體做專案頁的 3D 檢視器:three.js r160(MIT)打包,GLB 由組裝座標 STL 轉成,殼身與滑蓋分件、可以滑開。

    Claude Opus 工作分頁

  23. 11/15(日)約 12:10–12:30機構R2 背景研究兩條線:零件尺寸、開發板腳位與 IR 電路;另寫好 G-code 檢查工具(brim 避讓、逐項驗證)。

    CAD R2 分頁

  24. 11/15(日)12:07接線開始畫接線圖與腳位表:總圖、IR 電路圖、接線檢查清單,全部自繪 SVG+PNG(CC0)。
    • 不用沒有授權的第三方板圖;腳位用官方資料交叉核對,來源寫在 wiring/PINMAP.md。
    • 加了一塊分接小板:開發板只有一支 3V3、一支 GND,感測板、接收頭、電晶體都要從這裡分線。

    接線 subagent

  25. 11/15(日)12:07產品追加需求:用紅外線控制家裡的冷氣(當時以為是大金)。
    • IR LED 用 NPN 電晶體從 5V 驅動;接收頭當時列為選配。

    需求方

  26. 11/15(日)約 12:05–12:20韌體第一次 esphome compile(ESP-IDF 5.5.6)。
    • 失敗:API 的全零加密金鑰被拒絕。修正:改成 encryption: {},第一次連上 Home Assistant 時才配發金鑰,並開 15 分鐘的配對視窗。
    • 失敗:packages: 底下只剩註解時會變成空值。修正:整段一起註解掉,要用再打開。

    Claude Opus 工作分頁

  27. 11/15(日)12:00機構外殼 R2 開工:改成排針已焊的開發板、加 AHT20+BMP280 導槽、黑殼身+白滑蓋兩色。
    • 為了天線淨空,殼加寬,天線前方的空氣從 8.0 mm 增加到 14.4 mm。

    CAD R2 分頁

  28. 11/15(日)12:00AI本專案開工:研究上游 ESPectre(Wi-Fi CSI 動作偵測,GPL-3.0),決定用 ESPHome 2026.10 內建的 espectre 元件。
    • 輸出走 Home Assistant 原生 API;另開 HTTP(web_server)與 /metrics(Prometheus);MQTT 選配、預設關閉。
    • 因為 ESPectre 與 ESPHome 元件是 GPL,韌體設定檔採 GPL-3.0-only;硬體維持 CERN-OHL-P-2.0。

    Claude Opus 工作分頁

  29. 11/15(日)11:59產品定下這次的共用規則:每個模組各做一個開源 repo+一個 ToolHub 專案頁,仿照機房溫濕度感測器那個專案頁的形式。
    • 誠實原則:零件還沒到,頁面與 README 只能寫編譯通過、尚未實機驗證。
    • 上線分兩階段:先在本機做完全部成品,等外殼 R2 交件才上線。

    需求方(經機構工程師 bot 轉達)

  30. 11/15(日)11:21機構R1 交件:STL、算繪圖、組裝說明。
    • R1 還沒有紅外線開口,只當專案頁的暫用模型。

    CAD R1 分頁

  31. 11/15(日)10:21機構外殼 R1 開工:OpenSCAD 建模,殼身+沿長軸滑開的滑蓋。
    • 約 10:25–10:37 由研究 subagent 查開發板、感測板尺寸與腳位,主線交叉核對後才採用。

    CAD R1 分頁

  32. 11/15(日)之前採購零件已安排,預計 11/17(二)–11/20(五)陸續到貨。
    • 所以這一輪做出來的東西只能寫「編譯通過/靜態檢查通過/尚未實機驗證」;量測與實測要等零件到了才做。

    採購 bot

同一份紀錄也在 GitHub repo 的 docs/JOURNAL.md。

回扣+開源

一顆小盒子,背後要懂的東西其實很多。

表面只有八句話。下面每一格都是點開才看得到的深度:點了會跳回那一站,直接打開那一段。

→→→→→→→↺

01產品設計師

02採購

03接線

04機構

05列印

06韌體

07整合

08驗證

✎製作紀錄

素材:外殼算繪圖與 3D 模型取自本專案機構成果;接線圖全部自繪(CC0-1.0);3D 檢視器使用 three.js r160(MIT,授權全文)。

狀態:韌體編譯通過、靜態檢查通過,尚未實機驗證。本頁不含任何實機量測數字。