軟硬整合系列 · 開源硬體+韌體 · 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%)
操作:← → 或頁尾按鈕翻頁;上方角色列可以直接跳到任一站。右上角可切換深淺色。
01 — 產品設計師
決定要什麼、說清楚做不到什麼|需求方本人
先講清楚要什麼,也先講清楚它做不到什麼。
想知道家裡有沒有、
、
,
順便看,
還要能。
隱含條件:
做得到
- 判斷一個空間「有沒有在動」(移動分數+有動/沒動)
- 看夜間或睡覺時動作的多寡與時段
- 溫度、濕度、氣壓
- 用紅外線送日立冷氣(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、一顆電晶體,以及一顆紅外線接收頭(先錄下遙控器的碼,確認協定)。
- 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 Ω。
到貨先確認的三件事清單
- C3 的排針焊在哪一面、腳位絲印是否和本頁一致(右上應是 5V、G、3.3)。
- 感測板的腳序絲印(常見 VDD、SDA、GND、SCL,但各家不同)、有沒有 SDO 焊點。
- 紅外線 LED 的長短腳、規格書電流;電晶體 E/B/C 腳序(不同廠牌不一樣)。
03 — 接線
讀腳位、出接線圖|AI 判讀腳位並自繪接線圖;需求方本人照圖接線
四條線接感測器,再接紅外線發射電路與接收頭;看絲印,不看線色。
- 讀 pinout。原廠原理圖與尺寸圖絲印、Espressif 晶片規格書、第三方腳位整理交叉比對(來源列在
wiring/PINMAP.md)。 - 選腳。避開 strapping(GPIO2/8/9)、USB(GPIO18/19)、UART0(GPIO20/21);I²C 用 GPIO4/5,紅外線發射用 GPIO3,接收用 GPIO10。
- 自己畫圖。SuperMini、感測板、電晶體、LED 都用 SVG 自繪(CC0),線端座標由程式算到腳位中心,每條線都落在真的腳上。
- 校稿。逐張看圖:字有沒有重疊、線有沒有蓋住腳名、手機上看不看得清楚。
- 人照圖接。先拔 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。到貨後先量電流與實際可控距離再調。
接完、通電前的檢查步驟
- 拔掉 USB 再接線、改線。
- 對絲印:VDD→3V3、GND→GND、SDA→GPIO4(右排 #4)、SCL→GPIO5(左排 #1)。
- 三用電表量 3V3 對 GND、5V 對 GND:不應導通(嗶聲)。
- IR:LED 長腳(陽極)朝 5V;電晶體 E 接地、B 接 1 kΩ、C 接 LED。
- 通電後看開機 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 的結構
模型載入中…
算繪圖為 R2;尚未印出實物。
看深度
佈局:感測器、熱源、天線三者的取捨機構
- 壁掛時長軸垂直:感測艙在最下方,冷空氣從下端與兩側格柵進來;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
兩盤,和問答機一起排:先白盤(滑蓋),再黑盤(殼身)。免支撐。
列印順序: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 m | 90 g(其中 Wi-Fi 滑蓋約 6 g) |
| 2 | 黑 PLA | 殼身、感測板頂壓條、洞洞板頂壓條、3 mm LED 轉接套 ×2 | 底座、大圓鈕、開關座、卡圈、墊片組、OLED/麥克風壓條、喇叭後腔、喇叭壓環 | 11 h 25 m | 100 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 節點的件)
- 滑蓋(白盤):燕尾兩側沒有 brim 殘邊;兩道彈片切縫用名片可以從前端插到底;IR 發射窗、VS1838B 接收窗、BOOT/RST 孔、LED 窗都通透。
- 殼身 × 滑蓋(黑盤印好後):滑蓋從上端沿燕尾槽推到底,最後一聲「喀」扣住、不會自己滑開。太緊或太鬆就改
cad/scad/mod_wifi_case.scad的fdm_gap(太緊 0.35、太鬆 0.25),殼身與滑蓋一起重印。 - 鑰匙孔:M3 盤頭螺絲頭能進入口,往上滑 6 mm 卡住。
- 開口: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 一層一層往上疊。
印完先量什麼驗收
- 滑蓋(白盤):燕尾兩側沒有 brim 殘邊;兩道彈片切縫用名片從前端插得到底;IR 發射窗、接收窗、BOOT/RST 孔、LED 窗都通透。
- 殼身×滑蓋:滑蓋從上端沿燕尾槽推到底,最後「喀」一聲扣住、不會自己滑開。太緊或太鬆改
fdm_gap(0.35/0.25),殼身與滑蓋一起重印。 - 鑰匙孔:M3 盤頭螺絲頭能進入口,往上滑 6 mm 卡住。
- USB-C 線從外面插得進讓位孔;LED 座、導槽、接收頭口袋沒有絲線或垂料。
為什麼黑殼身、白滑蓋決策
手邊只有黑、白兩色 PLA。殼身黑色耐看、不顯髒;滑蓋白色,板載 LED 的光從薄皮透出來看得到。和另一個模組合併成兩盤一起印,換料只要一次。
06 — 韌體
選路線、寫設定、編譯|AI 研究上游並撰寫 ESPHome 設定
ESPHome 內建的 ESPectre 看動作,加上溫濕度氣壓與日立冷氣紅外線,設定檔與錄碼韌體都編譯過。
- 選路線ESPHome 2026.10 內建
espectre - 寫設定一份
wifi-node.yaml,帳密放 secrets - 編譯主設定+錄碼韌體等 8 種組合全部通過(ESP-IDF 5.5.6)
- 燒錄待零件到貨(尚未實機)
RAM=靜態配置(321,296 B 中);Flash=應用程式分區(1,835,008 B 中)。執行期 heap 用量要實機才量得到。
# 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,設定檔裡不寫死任何位址。
i2c: sda: GPIO4 scl: GPIO5 scan: true # 開機 log 列出 0x38、0x76/0x77 sensor: - platform: aht10 variant: AHT20 # 溫度、濕度(0x38) temperature: {name: Temperature, id: aht20_temperature} humidity: {name: Humidity, id: aht20_humidity} - platform: bmp280_i2c address: 0x77 # 看到 0x76 就改 pressure: {name: Pressure}
每 60 秒更新一次。AHT20 的溫度同時拿給冷氣當「目前溫度」。
# packages/ir-hardware.yaml(與 ir-learn.yaml 共用) remote_transmitter: - id: ir_tx pin: GPIO3 # 經 NPN 驅動 IR LED remote_receiver: - id: ir_rx pin: {number: GPIO10, inverted: true} # VS1838B climate: - platform: hitachi_ac344 # RF11T1 → AC344(文獻) name: Hitachi AC transmitter_id: ir_tx receiver_id: ir_rx # 追蹤遙控器按了什麼 sensor: aht20_temperature # 房間溫度來自 AHT20 supports_heat: false # RF11T1 沒有暖氣鍵
RF11T1 對應 AC344 是文獻上的對應:先燒 ir-learn.yaml 用接收頭逐鍵錄碼確認;解不出來就改 hitachi_ac424 或學習碼備案(docs/IR_HITACHI.md)。
web_server: # 每個實體一個 JSON 端點+SSE port: 80 version: 3 prometheus: # GET /metrics # 選配(預設關):packages 裡把行首的 # 刪掉 # mqtt: !include packages/mqtt.yaml # ir_raw_scenes: !include packages/ir-raw-scenes.yaml
web_server+prometheus 讓 flash 多約 39 KB、靜態 RAM 多約 0.3 KB;執行期 HTTP 連線的 heap 還要實機量。
看深度
為什麼選 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。
- 準備帳密。
cp secrets.example.yaml secrets.yaml,填自己的 Wi-Fi(只支援 2.4 GHz)與密碼。 - 編譯。在 Python 虛擬環境裝 ESPHome 2026.10.x,
esphome compile wifi-node.yaml。 - 第一次 USB 燒錄。
esphome run wifi-node.yaml,選序列埠。燒不進去:按住 BOOT、點一下 RST、放開 BOOT 再試。 - 看 log。確認連上 Wi-Fi、I²C 掃描到 0x38 與 0x76/0x77、ESPectre 開始校準(保持房間安靜)。
- 先確認冷氣協定(接收頭必備)。第一次先燒
ir-learn.yaml,拿 RF11T1 遙控器對著接收頭逐鍵按,確認解成 AC344;再燒回主設定。 - 加進 Home Assistant。設定 → 裝置與服務會出現
wifi-node;開機 15 分鐘內完成配對(API 金鑰此時才配發)。
HTTP 端點(同一個區網內)
有沒有動(ESPectre 的判斷結果)。回應格式依 ESPHome web_server:
{"id":"binary_sensor/Motion","value":false,"state":"OFF"}格式示意,非實機輸出。
AHT20 溫度。濕度、氣壓同理:/sensor/Humidity、/sensor/Pressure、/sensor/Movement%20Score。
{"id":"sensor/Temperature","value":25.1,"state":"25.1 °C"}格式示意,非實機輸出。
冷氣的「預期狀態」:最後一次送出的模式、目標溫度、風速,加上 AHT20 量到的目前溫度。不是冷氣回報的真實狀態。
{"id":"climate/Hitachi AC","mode":"COOL","target_temperature":26,"current_temperature":25.1,"fan_mode":"AUTO", ...}欄位示意,非實機輸出。
送紅外線指令。參數:mode(OFF/COOL/HEAT/DRY/FAN_ONLY/HEAT_COOL)、target_temperature、fan_mode、swing_mode。
curl -X POST "http://wifi-node.local/climate/Hitachi%20AC/set?mode=COOL&target_temperature=26&fan_mode=AUTO"
wifi-node.local 是韌體預設的 mDNS 名稱,只在同一個區網內解析得到。
Prometheus 格式,只放原始值,給既有的監控系統抓。
esphome_sensor_value{id="temperature",name="Temperature",unit="°C"} 25.1
esphome_binary_sensor_value{id="motion",name="Motion"} 0格式示意,非實機輸出。
Server-Sent Events:狀態一變就推送,適合即時面板。web_server 內建的網頁也是用它。
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 才到。到貨前能做的都做了;跟實物有關的每一項,都標成「待實機」。
| 項目 | 狀態 | 說明 |
|---|---|---|
| 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、可控距離與角度 |
| 外殼列印與試裝 | 待實機 | 滑蓋鬆緊、板子與感測板裝得進去 |
看深度
到貨驗收計畫(照順序)計畫
- 對絲印、量 C3 與感測板尺寸;殼試裝。
- 只接感測板,燒韌體,看 I²C 掃描與溫濕度氣壓讀值。
- 放到最終位置,重新開機讓 ESPectre 校準(保持安靜),走動、靜止各測幾次,記錄移動分數。
- 夜間讓狗自由活動,確認有動會亮,並記錄誤報情況(例如風扇、窗簾)。
- 接上紅外線電路,先用手機相機看 LED 有沒有在閃(多數手機前鏡頭看得到 940 nm),再對冷氣測開關、模式、溫度。
- 接收頭接好後燒
ir-learn.yaml,逐鍵錄 RF11T1 的碼、確認是不是 AC344;解不出來就用學習碼備案。 - 和參考溫濕度計並放 30 分鐘,求溫度偏移後寫進設定。
已知風險風險
- Wi-Fi 省電關閉、無線電一直開:盒內溫度會比室溫高,AHT20 讀值要校正。
- 紅外線 LED 射程與角度:被殼壁擋住或角度不對,冷氣就收不到。
- RF11T1 對應 AC344 只是文獻:協定不對時冷氣完全沒反應;擺風在部分日立機型有已知問題。
- Mesh 網路漫遊:會讓 CSI 基準改變,建議固定連同一台基地台。
- 仿板差異:按鍵、LED、天線位置可能和原廠圖不同。
製作紀錄(邊做邊記)
誰、在什麼時候、做了什麼|哪裡出錯、又怎麼改
這不是事後補寫的完美流程,是一路做、一路記下來的。
時間是台灣時間,新的在上面;不確定的時間標「約」。零件到貨、印製、實機驗證的消息會繼續往上加。
11/15(日)23:39AI上線後檢查前後差異,發現頁首標題被我換成短版,蓋掉了基建|監看在線上頁改好的完整標題。
- 失敗:更新前只拿自己上一版部署的 zip 比對,沒有比對線上頁,看不到別人改過的地方。
- 修正:頁首改回監看設定的完整標題,逐字相同。
- 完整標題在手機上會擠壓頁碼與深淺色按鈕,另外加一行樣式讓它們不換行,頁首那行本身不動。
- 修正:更新流程加防呆,線上頁若有別人改過、新版沒納入的行就停止,並用當時的線上備份重現測試。
Claude Opus 工作分頁
11/15(日)23:35產品系列命名改為「產品名:賣點|軟硬整合系列」,本專案標題是「Wi‑Fi 偵測節點:不裝鏡頭也知道有人|軟硬整合系列」。
- ToolHub 標題由基建|監看統一改名,改名期間暫停更新專案頁,本機先備好頁面標題、封面與姊妹頁連結文字,README 與紀錄標題先在 GitHub 改好。
- 解除暫停後,更新流程改成先讀 CMS 目前的標題、逐位元組原樣送回,Wi‑Fi 的不換行連字號不可被正規化,並加測試把關。
- 失敗:標題替換腳本重跑時把導言重複了一句。
- 修正:先判斷新字串是否已存在再替換。
- 失敗:宋體把不換行連字號畫成全形,大標看起來像「Wi - Fi」。
- 修正:只讓大標的 Wi‑Fi 改用拉丁襯線字型顯示,字元本身不變。
Claude Opus 工作分頁
11/15(日)21:06AI發現 CMS 更新時若沒帶自訂 slug,會被依名稱重新產生;已改成每次更新都帶 slug、更新後回讀確認,並重送修正。
- 上線後驗證重跑 15/15(CMS 欄位、slug、描述都保留)。
- 完整報告 qa/REPORT.md 完成,回報需求方。
Claude Opus 工作分頁
11/15(日)21:02AI第一次跑一鍵更新流程,遇到三個問題都已修正。
- 失敗:bash 把緊接在變數後的全形符號當成變數名的一部分,腳本一開始就停下;修正:變數一律加大括號。
- 失敗:姊妹專案「兒童 AI 問答機」的 ToolHub 頁剛上架,自動補上的連結被掃描擋下(ToolHub 網域預設禁止);修正:只精確放行該頁的公開網址。
- 失敗:更新後驗證把下載結果當成文字比對,誤判失敗(其實已更新成功);修正後重跑,扣掉平台注入的按鈕後逐字相同、縮圖等於封面。
Claude Opus 工作分頁
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 工作分頁
11/15(日)20:56AI上線前最後一次看封面,發現封面圖上還寫著「大金紅外線」(下午改成日立時漏改;文字在圖片裡,掃描抓不到)→ 改成「日立冷氣紅外線」並重產封面。
- 教訓:圖片裡的文字要用眼睛看,不能只靠文字掃描。
Claude Opus 工作分頁
11/15(日)20:50–20:53軟體專案頁新增「製作紀錄(邊做邊記)」一站(可依角色篩選、可展開),頁面 QA 28/28 通過(桌機/手機、深淺色截圖)。
Claude Opus 工作分頁
11/15(日)20:44–20:53AIsecret 掃描擴大到 G-code、STEP 與 Release 附檔,最後 0 命中(153 個檔案)。
- 失敗:G-code 座標與 STEP 浮點數被誤判成禁用數字或編號格式。修正:G-code 只掃註解、STEP 只掃檔頭與字串。
- 失敗:正向測試發現 Windows 的使用者資料夾路徑原本偵測不到。修正:補上規則,假資料正向測試 14+6 種全部抓到。
- 文件裡出現的內部工作編號與帳號字樣,改成一般寫法。
Claude Opus 工作分頁
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 工作分頁
11/15(日)20:35AIG-code 的註解裡留有切片電腦的本機路徑 → Release 版只清掉這類註解行,其餘每一行逐字比對相同。
- STEP 與 G-code 都超過 10 MB,不放進 git 主樹,改附在 GitHub Release。
Claude Opus 工作分頁
11/15(日)20:34–20:39韌體全部重新編譯:9 種組合(含 R2 腳位對照組)都通過,C/C++ 警告 0;主設定 RAM 34.2%、Flash 61.0%,和下午相同。
Claude Opus 工作分頁
11/15(日)20:33韌體對照 R2 組裝文件發現 IR 腳位不同:R2 以 GPIO7(發射)/GPIO6(接收)舉例,本專案韌體與接線圖是 GPIO3/GPIO10。
- 決定:以已編譯的韌體為準;外殼不用改,線都走板下、同一個缺口。
- 另把 GPIO7/GPIO6 的組合也編譯一次當備案,改兩行就能切換。
Claude Opus 工作分頁
11/15(日)20:31AI階段 B 開始:需求方授權端到端做完並上線(公開 GitHub repo+ToolHub 新工具)。
Claude Opus 工作分頁
11/15(日)20:30機構R2 最終版交件:SCAD、STL(組裝、列印姿態、備用版本)、STEP、算繪圖 11 張、組裝與列印文件、現行兩盤 G-code,以及 Onshape R2 公開連結。
- R2 已含 IR LED 座(上端左側、往上傾 15°)、VS1838B 的 Ø8 接收窗(上端右側,與發射相距 25.4 mm)、洞洞板導槽。
CAD R2 分頁
11/15(日)16:51切片重切現行版 G-code:兩盤重新置中,風扇改回第 1–3 層全關(對齊之前已成功印過的外殼設定)。
- 舊檔一律不用;兩個模組的 cad-drop 拿到的是同一組兩盤。
切片端(兩模組合排)
11/15(日)13:16切片收到兩個模組合排的兩盤 G-code,逐項驗證:白盤全部通過,黑盤 43/44。
- 失敗:黑盤首層速度不合格(姊妹模組的 brim 避讓段快速移動後,沒有恢復原本的進給速度)→ 退回合排端修正後重驗。
CAD R2 分頁
11/15(日)13:00–13:02AI閘門:外殼 R2 還沒交件 → 上線腳本演練通過後先停下,回報「階段 A 完成,等 R2,尚未上線」。
Claude Opus 工作分頁
11/15(日)12:58–12:59AI收尾檢查:大金字樣殘留 0、secret 掃描 0 命中、頁面 QA 25/25;repo 建好第一個 commit(還沒 push)。
Claude Opus 工作分頁
11/15(日)12:51–12:56韌體改成日立之後全部重新編譯:8 種組合都通過,C/C++ 警告 0。
- 主設定 RAM 34.2%、Flash 61.0%;錄碼設定 RAM 33.4%、Flash 52.8%。
Claude Opus 工作分頁
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 分頁同時把接收窗改成必要開口。
需求方
- 韌體改用 ESPHome
11/15(日)約 12:25–12:32AIsecret 掃描、封面、上傳用 zip、上線腳本(預設只演練)、頁面 QA 第一輪。
- 誤判修正:SVG 座標、文件章節編號被當成 IP 位址 → 調整比對規則,並用 14 種假資料做正向測試確認仍抓得到。
- 顯示問題:襯線字型把不換行連字號畫成「Wi - Fi」→ 全部改用一般連字號。
Claude Opus 工作分頁
11/15(日)12:12軟體做專案頁的 3D 檢視器:three.js r160(MIT)打包,GLB 由組裝座標 STL 轉成,殼身與滑蓋分件、可以滑開。
Claude Opus 工作分頁
11/15(日)約 12:10–12:30機構R2 背景研究兩條線:零件尺寸、開發板腳位與 IR 電路;另寫好 G-code 檢查工具(brim 避讓、逐項驗證)。
CAD R2 分頁
11/15(日)12:07接線開始畫接線圖與腳位表:總圖、IR 電路圖、接線檢查清單,全部自繪 SVG+PNG(CC0)。
- 不用沒有授權的第三方板圖;腳位用官方資料交叉核對,來源寫在
wiring/PINMAP.md。 - 加了一塊分接小板:開發板只有一支 3V3、一支 GND,感測板、接收頭、電晶體都要從這裡分線。
接線 subagent
- 不用沒有授權的第三方板圖;腳位用官方資料交叉核對,來源寫在
11/15(日)12:07產品追加需求:用紅外線控制家裡的冷氣(當時以為是大金)。
- IR LED 用 NPN 電晶體從 5V 驅動;接收頭當時列為選配。
需求方
11/15(日)約 12:05–12:20韌體第一次
esphome compile(ESP-IDF 5.5.6)。- 失敗:API 的全零加密金鑰被拒絕。修正:改成
encryption: {},第一次連上 Home Assistant 時才配發金鑰,並開 15 分鐘的配對視窗。 - 失敗:
packages:底下只剩註解時會變成空值。修正:整段一起註解掉,要用再打開。
Claude Opus 工作分頁
- 失敗:API 的全零加密金鑰被拒絕。修正:改成
11/15(日)12:00機構外殼 R2 開工:改成排針已焊的開發板、加 AHT20+BMP280 導槽、黑殼身+白滑蓋兩色。
- 為了天線淨空,殼加寬,天線前方的空氣從 8.0 mm 增加到 14.4 mm。
CAD R2 分頁
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 工作分頁
- 輸出走 Home Assistant 原生 API;另開 HTTP(
11/15(日)11:59產品定下這次的共用規則:每個模組各做一個開源 repo+一個 ToolHub 專案頁,仿照機房溫濕度感測器那個專案頁的形式。
- 誠實原則:零件還沒到,頁面與 README 只能寫編譯通過、尚未實機驗證。
- 上線分兩階段:先在本機做完全部成品,等外殼 R2 交件才上線。
需求方(經機構工程師 bot 轉達)
11/15(日)11:21機構R1 交件:STL、算繪圖、組裝說明。
- R1 還沒有紅外線開口,只當專案頁的暫用模型。
CAD R1 分頁
11/15(日)10:21機構外殼 R1 開工:OpenSCAD 建模,殼身+沿長軸滑開的滑蓋。
- 約 10:25–10:37 由研究 subagent 查開發板、感測板尺寸與腳位,主線交叉核對後才採用。
CAD R1 分頁
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,授權全文)。
狀態:韌體編譯通過、靜態檢查通過,尚未實機驗證。本頁不含任何實機量測數字。









