1. 項目概述為什么我們需要一個自動風(fēng)扇控制應(yīng)用最近在搗鼓智能家居發(fā)現(xiàn)一個挺有意思的需求家里的風(fēng)扇尤其是那種老式的機械風(fēng)扇能不能也“智能”起來比如根據(jù)房間的溫度自動調(diào)節(jié)風(fēng)速或者根據(jù)我是否在家自動開關(guān)。市面上當(dāng)然有成品的智能風(fēng)扇但價格不菲而且功能未必完全符合自己的習(xí)慣。于是我決定自己動手基于涂鴉智能的 Tuya Link SDK開發(fā)一個自動風(fēng)扇控制應(yīng)用。這個項目的核心就是利用 Tuya Link SDK 作為橋梁將一個普通的、支持紅外遙控或Wi-Fi/藍牙模塊改裝的風(fēng)扇接入到我們自己編寫的邏輯控制程序中。這樣一來我們就能擺脫對成品智能家居APP固定場景的依賴實現(xiàn)高度定制化的自動化。比如你可以寫一段邏輯當(dāng)書房溫度傳感器讀數(shù)超過28攝氏度且室內(nèi)人體傳感器檢測到有人時自動開啟風(fēng)扇并設(shè)置為3檔自然風(fēng)如果溫度低于26度或者人離開房間超過10分鐘則自動關(guān)閉。這種顆粒度的控制是很多通用APP難以實現(xiàn)的。對于開發(fā)者、硬件愛好者或者僅僅是希望提升生活便利性的朋友來說這個項目都是一個很好的切入點。它不要求你從零開始設(shè)計電路和通信協(xié)議Tuya Link SDK 已經(jīng)封裝了與涂鴉云平臺和設(shè)備通信的復(fù)雜細(xì)節(jié)。你只需要關(guān)注業(yè)務(wù)邏輯在什么條件下執(zhí)行什么操作。這大大降低了智能硬件開發(fā)的門檻。接下來我將詳細(xì)拆解從環(huán)境搭建、設(shè)備接入、邏輯編寫到最終部署的完整過程并分享其中踩過的坑和總結(jié)的經(jīng)驗。2. 核心思路與技術(shù)選型解析2.1 為什么選擇 Tuya Link SDK在決定自己開發(fā)自動化應(yīng)用時我評估了幾個主流方案。直接使用廠商APP如米家、涂鴉智能的自動化場景功能受限無法執(zhí)行復(fù)雜判斷和自定義延時。使用 Home Assistant 等開源平臺功能強大但部署和維護有一定復(fù)雜度且對特定云平臺設(shè)備的支持有時需要社區(qū)插件穩(wěn)定性存疑。而選擇 Tuya Link SDK主要基于以下幾點考量首先生態(tài)兼容性好。涂鴉的IoT平臺接入了海量的設(shè)備品類和品牌很多性價比高的智能風(fēng)扇、溫濕度計、人體傳感器都支持涂鴉方案。這意味著你通過一個SDK理論上可以控制家里絕大多數(shù)基于涂鴉方案的設(shè)備統(tǒng)一了控制入口。其次SDK封裝成熟開發(fā)效率高。Tuya Link SDK 提供了從設(shè)備配網(wǎng)、上下行消息通信、設(shè)備管理到云端API調(diào)用的一整套解決方案。我們不需要關(guān)心MQTT/HTTP長連接的維護、數(shù)據(jù)包的加密解密、設(shè)備證書的管理等底層細(xì)節(jié)只需要調(diào)用相應(yīng)的接口函數(shù)專注于業(yè)務(wù)邏輯的開發(fā)。這對于快速原型驗證和功能迭代至關(guān)重要。再者靈活性高。相比于使用固定的APP自己編寫應(yīng)用意味著無限的可能性。你可以將風(fēng)扇控制與任何你想要的輸入源結(jié)合比如本地的天氣API、你自己的日程表、甚至是通過攝像頭圖像分析得出的房間人數(shù)。SDK提供了這種將物理設(shè)備能力“代碼化”的途徑。最后成本可控。對于個人開發(fā)者涂鴉云平臺提供了免費的開發(fā)資源包足以支撐一個小型家庭自動化項目的設(shè)備連接數(shù)和消息調(diào)用量。你無需為服務(wù)器和消息中間件付費。當(dāng)然它也有局限比如你的應(yīng)用邏輯運行環(huán)境需要有網(wǎng)絡(luò)連接與涂鴉云通信斷網(wǎng)時自動化會失效。但對于大多數(shù)基于云狀態(tài)觸發(fā)如地理位置、天氣或定時任務(wù)來說這可以接受。對于要求本地斷網(wǎng)可用的場景則需要考慮本地化部署的SDK或其它方案。2.2 整體架構(gòu)設(shè)計我們的自動化風(fēng)扇控制應(yīng)用整體上是一個運行在服務(wù)器可以是家里的樹莓派、舊電腦或者云服務(wù)器上的后臺服務(wù)。它的架構(gòu)可以清晰地分為三層1. 設(shè)備與云層這是由涂鴉平臺負(fù)責(zé)的部分。智能風(fēng)扇作為受控設(shè)備和溫濕度傳感器、人體傳感器作為觸發(fā)設(shè)備通過Wi-Fi或藍牙連接到涂鴉云。它們按照預(yù)設(shè)的數(shù)據(jù)點DP格式上報狀態(tài)如溫度值、有人/無人和接收控制指令如開關(guān)、風(fēng)速檔位。2. 邏輯控制層我們的應(yīng)用核心這是我們編寫的應(yīng)用程序所在。它通過 Tuya Link SDK 訂閱相關(guān)設(shè)備的消息。當(dāng)傳感器上報數(shù)據(jù)時SDK會回調(diào)我們的處理函數(shù)。我們在處理函數(shù)中編寫判斷邏輯例如if (temperature 28 presence true) {...}當(dāng)條件滿足時再通過SDK向風(fēng)扇設(shè)備發(fā)送控制指令。3. 配置與管理接口可選但推薦一個簡單的Web界面或配置文件用于讓用戶也就是我們自己能夠動態(tài)調(diào)整自動化的閾值和規(guī)則而無需修改代碼和重啟服務(wù)。例如通過一個網(wǎng)頁設(shè)置觸發(fā)溫度為26-30度可調(diào)風(fēng)速檔位映射等。這可以通過一個輕量的HTTP服務(wù)器如Python的Flask來實現(xiàn)。這個架構(gòu)的關(guān)鍵在于我們的應(yīng)用是“事件驅(qū)動”的。它并不需要不停地輪詢設(shè)備狀態(tài)而是當(dāng)設(shè)備狀態(tài)發(fā)生變化時云平臺會通過SDK主動推送消息給我們極大地減少了無效請求和資源消耗。接下來我們就從零開始一步步搭建這個系統(tǒng)。3. 開發(fā)環(huán)境準(zhǔn)備與SDK初始化3.1 賬號創(chuàng)建與項目配置第一步你需要訪問涂鴉IoT平臺官網(wǎng)并注冊一個開發(fā)者賬號。這個過程是免費的。登錄后在控制臺你需要完成以下幾個關(guān)鍵操作創(chuàng)建項目選擇“智能生活”或“智慧行業(yè)”解決方案個人項目選智能生活即可填寫項目名稱比如“AutoFanController”。注意選擇正確的數(shù)據(jù)中心這會影響設(shè)備連接的服務(wù)器位置通常根據(jù)你的地理位置選擇。獲取關(guān)鍵憑證項目創(chuàng)建成功后在“開發(fā)”標(biāo)簽頁下你會找到Access ID和Access Secret。這組密鑰相當(dāng)于你的應(yīng)用訪問涂鴉云的賬號密碼務(wù)必妥善保管不要泄露到公開代碼庫中。我們后續(xù)在初始化SDK時需要用到它們。創(chuàng)建設(shè)備在“設(shè)備”標(biāo)簽頁為你計劃使用的風(fēng)扇和傳感器創(chuàng)建設(shè)備。你需要知道每個設(shè)備的產(chǎn)品IDPID。這個PID通?？梢栽谠O(shè)備本身的標(biāo)簽、說明書上找到或者在涂鴉智能APP添加設(shè)備后的設(shè)備信息里看到。在平臺創(chuàng)建設(shè)備時選擇“自定義品類”或搜索對應(yīng)品類然后輸入PID。創(chuàng)建后平臺會為每個設(shè)備生成一個唯一的device_id。這個device_id是我們代碼中定位和控制具體設(shè)備的依據(jù)。注意這里有一個常見的坑。很多人在涂鴉智能APP上添加設(shè)備后就想當(dāng)然地在開發(fā)平臺用同一個賬號找設(shè)備但可能找不到。這是因為APP上添加的設(shè)備通常關(guān)聯(lián)的是“用戶”賬號而開發(fā)平臺操作的是“開發(fā)者”賬號下的“項目”。你需要確保設(shè)備是在當(dāng)前開發(fā)項目下創(chuàng)建的。對于已存在的設(shè)備有時需要通過APP分享設(shè)備到你的開發(fā)者賬號或者在開發(fā)平臺通過掃碼等方式重新添加。3.2 本地開發(fā)環(huán)境搭建我選擇使用 Python 來進行開發(fā)因為其語法簡潔生態(tài)豐富非常適合快速開發(fā)這類自動化腳本。當(dāng)然Tuya Link SDK 也支持 Java, Node.js, Go 等多種語言你可以根據(jù)自己熟悉的語言選擇。# 創(chuàng)建一個新的項目目錄 mkdir auto-fan-control cd auto-fan-control # 創(chuàng)建虛擬環(huán)境推薦避免包沖突 python -m venv venv # 激活虛擬環(huán)境 # Windows: venv\Scripts\activate # Linux/Mac: source venv/bin/activate # 安裝 Tuya Link SDK for Python pip install tuyalink除了核心SDK我們可能還需要一些輔助庫比如用于構(gòu)建簡單Web配置面板的flask以及處理HTTP請求的requests如果你需要調(diào)用外部API如天氣服務(wù)。pip install flask requests3.3 SDK初始化與設(shè)備監(jiān)聽安裝好環(huán)境后我們開始編寫應(yīng)用的主干代碼。首先創(chuàng)建一個main.py文件進行SDK的初始化和連接。import time import logging from tuyalink import TuyaLink # 配置日志方便調(diào)試 logging.basicConfig(levellogging.INFO) # 從環(huán)境變量或配置文件中讀取敏感信息不要硬編碼在代碼里 ACCESS_ID 你的Access ID ACCESS_SECRET 你的Access Secret DEVICE_ID_FAN 你的風(fēng)扇設(shè)備ID DEVICE_ID_SENSOR_TEMP 你的溫濕度計設(shè)備ID DEVICE_ID_SENSOR_PRESENCE 你的人體傳感器設(shè)備ID class AutoFanController: def __init__(self): # 初始化TuyaLink客戶端 self.client TuyaLink( access_idACCESS_ID, access_secretACCESS_SECRET, device_idDEVICE_ID_FAN, # 這里可以填任意一個你已授權(quán)設(shè)備的ID用于建立連接 on_connectedself.on_connected, on_disconnectedself.on_disconnected, on_messagesself.on_messages ) self.fan_status {power: False, speed: 0} self.sensor_data {temperature: 25.0, presence: False} def on_connected(self): SDK連接成功回調(diào) logging.info(成功連接到涂鴉云) # 連接成功后訂閱所有相關(guān)設(shè)備的消息 # 注意SDK初始化時用了一個device_id建立連接但可以訂閱其他設(shè)備 # 具體訂閱方式可能因SDK版本而異以下為示例邏輯 self.client.subscribe_device_msg(DEVICE_ID_SENSOR_TEMP) self.client.subscribe_device_msg(DEVICE_ID_SENSOR_PRESENCE) logging.info(已訂閱傳感器設(shè)備消息。) def on_disconnected(self): SDK斷開連接回調(diào) logging.warning(與涂鴉云連接斷開。) def on_messages(self, msg): 收到設(shè)備消息回調(diào) msg 是一個字典包含設(shè)備ID、數(shù)據(jù)點等信息 logging.info(f收到消息: {msg}) device_id msg.get(deviceId) dps msg.get(dps) # 數(shù)據(jù)點集合是設(shè)備狀態(tài)的核心 if not dps: return # 根據(jù)設(shè)備ID更新本地狀態(tài) if device_id DEVICE_ID_SENSOR_TEMP: # 假設(shè)溫濕度計的DPID 1是溫度單位可能是攝氏度*10常見 temp_raw dps.get(1) if temp_raw is not None: self.sensor_data[temperature] temp_raw / 10.0 logging.info(f溫度更新: {self.sensor_data[temperature]}°C) elif device_id DEVICE_ID_SENSOR_PRESENCE: # 假設(shè)人體傳感器的DPID 1是有人狀態(tài)True/False presence dps.get(1) if presence is not None: self.sensor_data[presence] presence logging.info(f人體感應(yīng)更新: {self.sensor_data[presence]}) elif device_id DEVICE_ID_FAN: # 更新風(fēng)扇本地狀態(tài)用于邏輯判斷或UI顯示 if 1 in dps: # 假設(shè)DPID 1是開關(guān) self.fan_status[power] dps[1] if 3 in dps: # 假設(shè)DPID 3是風(fēng)速檔位 self.fan_status[speed] dps[3] # 狀態(tài)更新后執(zhí)行自動化邏輯判斷 self.evaluate_automation_rules() def evaluate_automation_rules(self): 核心自動化邏輯判斷函數(shù) temp self.sensor_data[temperature] presence self.sensor_data[presence] fan_is_on self.fan_status[power] # 規(guī)則1有人且溫度高時開風(fēng)扇 if presence and temp 28.0 and not fan_is_on: logging.info(f條件滿足有人({presence})溫度({temp}°C) 28°C風(fēng)扇關(guān)閉。執(zhí)行開啟風(fēng)扇。) self.control_fan(powerTrue, speed3) # 假設(shè)3檔為自然風(fēng) # 規(guī)則2無人或溫度低時關(guān)風(fēng)扇 elif (not presence or temp 26.0) and fan_is_on: logging.info(f條件滿足無人({not presence})或溫度({temp}°C) 26°C風(fēng)扇開啟。執(zhí)行關(guān)閉風(fēng)扇。) self.control_fan(powerFalse) def control_fan(self, powerNone, speedNone): 向風(fēng)扇發(fā)送控制指令 dps {} if power is not None: dps[1] power # 對應(yīng)開關(guān)DP if speed is not None: dps[3] speed # 對應(yīng)風(fēng)速DP if dps: # 這里調(diào)用SDK的發(fā)布消息方法具體函數(shù)名請查閱最新SDK文檔 success self.client.publish_command(DEVICE_ID_FAN, dps) if success: logging.info(f風(fēng)扇控制指令發(fā)送成功: {dps}) else: logging.error(風(fēng)扇控制指令發(fā)送失敗) def run(self): 啟動服務(wù) self.client.start() # 啟動SDK開始連接和消息循環(huán) try: # 保持主線程運行 while True: time.sleep(1) except KeyboardInterrupt: logging.info(正在關(guān)閉應(yīng)用...) self.client.stop() logging.info(應(yīng)用已退出。) if __name__ __main__: controller AutoFanController() controller.run()這段代碼構(gòu)建了整個應(yīng)用的骨架。AutoFanController類負(fù)責(zé)管理連接、狀態(tài)和邏輯。on_messages是核心回調(diào)任何設(shè)備狀態(tài)更新都會觸發(fā)它。我們在其中更新本地緩存的狀態(tài)然后立即調(diào)用evaluate_automation_rules來判斷是否需要控制風(fēng)扇。實操心得DPID的獲取代碼中的dps.get(1)、dps.get(3)里的數(shù)字1、3叫做數(shù)據(jù)點標(biāo)識符DP ID。這是整個開發(fā)過程中最容易出錯的地方。每個設(shè)備的功能都對應(yīng)一個或多個DP ID但其具體含義哪個ID代表開關(guān)哪個代表溫度是由產(chǎn)品開發(fā)時定義的沒有統(tǒng)一標(biāo)準(zhǔn)。獲取DP ID最可靠的方法有兩種1. 在涂鴉IoT平臺找到對應(yīng)產(chǎn)品的“功能定義”頁面查看。2. 在設(shè)備在線時通過SDK或調(diào)試工具先接收一條設(shè)備上報的消息觀察其dps字段的結(jié)構(gòu)。務(wù)必確認(rèn)清楚后再編寫控制邏輯。4. 核心自動化邏輯的深化與優(yōu)化基礎(chǔ)的“溫度高有人就開”邏輯已經(jīng)實現(xiàn)但一個健壯的自動化系統(tǒng)需要考慮更多邊界情況和復(fù)雜場景。4.1 引入狀態(tài)防抖與延遲判斷傳感器數(shù)據(jù)可能存在波動或瞬時誤報。例如人體傳感器可能因為寵物經(jīng)過而短暫觸發(fā)溫度傳感器讀數(shù)也可能有小幅跳動。直接響應(yīng)每一次變化會導(dǎo)致風(fēng)扇頻繁啟停體驗極差。解決方案是加入防抖Debounce和延遲判斷。import time class AutoFanController: def __init__(self): # ... 其他初始化 ... self.last_presence_time 0 # 最后一次檢測到有人的時間戳 self.presence_debounce_window 30 # 無人判定防抖窗口單位秒例如30秒內(nèi)無信號才算真無人 self.temp_hysteresis 1.0 # 溫度遲滯避免在臨界點震蕩。例如升溫到29度開降溫到27度才關(guān)。 def evaluate_automation_rules(self): temp self.sensor_data[temperature] presence self.sensor_data[presence] fan_is_on self.fan_status[power] current_time time.time() # 更新有人狀態(tài)的時間戳 if presence: self.last_presence_time current_time # 計算“有效無人”狀態(tài)當(dāng)前無信號且已持續(xù)超過防抖窗口 effective_absence (not presence) and (current_time - self.last_presence_time self.presence_debounce_window) # 使用帶遲滯的溫度判斷 temp_threshold_on 28.0 temp_threshold_off 28.0 - self.temp_hysteresis # 假設(shè)遲滯1度則27度關(guān) # 優(yōu)化后的規(guī)則 if (presence or not effective_absence) and temp temp_threshold_on and not fan_is_on: # 條件當(dāng)前有人或處于防抖窗口內(nèi)視為可能還有人且溫度超過開啟閾值 logging.info(f條件滿足有效有人溫度({temp}°C) {temp_threshold_on}°C。執(zhí)行開啟風(fēng)扇。) self.control_fan(powerTrue, speed3) elif effective_absence and temp temp_threshold_off and fan_is_on: # 條件確認(rèn)無人且溫度低于關(guān)閉閾值 logging.info(f條件滿足確認(rèn)無人溫度({temp}°C) {temp_threshold_off}°C。執(zhí)行關(guān)閉風(fēng)扇。) self.control_fan(powerFalse) # 注意這里沒有處理“有人但溫度低了”和“無人但溫度高了”的情況可根據(jù)需要添加。通過引入presence_debounce_window和temp_hysteresis系統(tǒng)的行為變得更加平滑和人性化避免了因傳感器噪聲導(dǎo)致的誤動作。4.2 實現(xiàn)多檔位與模式映射簡單的開關(guān)控制不夠用。我們可能希望溫度越高風(fēng)扇風(fēng)速越大。這需要實現(xiàn)一個映射邏輯。def evaluate_automation_rules(self): # ... 獲取狀態(tài) ... # 假設(shè)我們定義風(fēng)速檔位0-關(guān)1-低風(fēng)2-中風(fēng)3-高風(fēng)4-自然風(fēng) speed_mapping { (26.0, 28.0): 1, # 26-28度低風(fēng) (28.0, 30.0): 2, # 28-30度中風(fēng) (30.0, 35.0): 3, # 30-35度高風(fēng) (35.0, float(inf)): 4, # 35度以上自然風(fēng)如果支持 } target_speed 0 # 默認(rèn)關(guān) if presence or not effective_absence: for (temp_low, temp_high), speed in speed_mapping.items(): if temp_low temp temp_high: target_speed speed break # 只有當(dāng)目標(biāo)狀態(tài)與當(dāng)前狀態(tài)不同時才發(fā)送指令減少不必要的通信 if fan_is_on ! (target_speed 0): self.control_fan(power(target_speed 0), speedtarget_speed) elif fan_is_on and self.fan_status.get(speed) ! target_speed: # 風(fēng)扇已開但檔位需要調(diào)整 self.control_fan(speedtarget_speed)這段代碼根據(jù)溫度區(qū)間動態(tài)選擇風(fēng)速檔位。同時增加了狀態(tài)比對只有狀態(tài)確實發(fā)生變化時才發(fā)送控制指令減少了網(wǎng)絡(luò)流量和設(shè)備負(fù)載。4.3 集成外部數(shù)據(jù)源天氣與時間自動化可以更智能。比如在梅雨季節(jié)即使溫度高但濕度太大開風(fēng)扇可能體感并不舒適。或者在夜間睡眠時段自動降低風(fēng)速避免著涼。import requests from datetime import datetime class AutoFanController: def __init__(self): # ... 其他初始化 ... self.weather_api_key 你的天氣API密鑰 self.weather_city 你的城市 self.outdoor_humidity 60.0 # 默認(rèn)室外濕度 self.update_weather_interval 1800 # 30分鐘更新一次天氣 self.last_weather_update 0 def get_outdoor_weather(self): 獲取室外天氣示例使用和風(fēng)天氣API current_time time.time() if current_time - self.last_weather_update self.update_weather_interval: return self.outdoor_humidity try: url fhttps://devapi.qweather.com/v7/weather/now?location{self.weather_city}key{self.weather_api_key} response requests.get(url, timeout5) data response.json() if data[code] 200: self.outdoor_humidity float(data[now][humidity]) self.last_weather_update current_time logging.info(f更新室外濕度: {self.outdoor_humidity}%) except Exception as e: logging.error(f獲取天氣失敗: {e}) return self.outdoor_humidity def evaluate_automation_rules(self): # ... 獲取室內(nèi)溫濕度、人體狀態(tài) ... current_hour datetime.now().hour is_night 23 current_hour or current_hour 6 # 晚上11點到早上6點算夜間 outdoor_humidity self.get_outdoor_weather() # 復(fù)合條件規(guī)則 # 規(guī)則白天有人溫度高且室外濕度不高80%時開風(fēng)扇 condition_to_turn_on ( (not is_night) and (presence or not effective_absence) and temp 28.0 and outdoor_humidity 80.0 ) # 規(guī)則夜間或者無人或者溫度低或者濕度過高時關(guān)風(fēng)扇 condition_to_turn_off ( is_night or effective_absence or temp 26.0 or outdoor_humidity 80.0 ) and fan_is_on if condition_to_turn_on and not fan_is_on: night_speed_adjustment 0.5 if is_night else 1.0 # 夜間風(fēng)速減半 target_speed self.calculate_speed_by_temp(temp) * night_speed_adjustment self.control_fan(powerTrue, speedint(target_speed)) elif condition_to_turn_off: self.control_fan(powerFalse)通過引入天氣API和本地時間判斷自動化規(guī)則變得更加精細(xì)和貼合實際生活場景真正實現(xiàn)了“智能”控制。5. 構(gòu)建簡易配置與管理界面將閾值、規(guī)則邏輯硬編碼在代碼里不利于調(diào)整。我們可以用一個簡單的Web界面來動態(tài)管理這些配置。這里使用Flask快速搭建。from flask import Flask, request, jsonify, render_template_string import threading # 在AutoFanController類外或內(nèi)部啟動一個Flask應(yīng)用 app Flask(__name__) # 假設(shè)我們有一個全局的控制器實例實際應(yīng)用中需妥善處理 controller_global None HTML_TEMPLATE !DOCTYPE html html headtitle風(fēng)扇自動控制器配置/titlestylebody {font-family: sans-serif; margin: 20px;} .section {margin-bottom: 30px; padding: 15px; border:1px solid #ccc;}/style/head body h1自動風(fēng)扇控制配置/h1 div classsection h2當(dāng)前狀態(tài)/h2 p室內(nèi)溫度: span idcurrent_temp{{ state.temp }}/span °C/p p人體感應(yīng): span idcurrent_presence{{ state.presence }}/span/p p風(fēng)扇狀態(tài): span idcurrent_fan{{ state.fan_power }} (檔位: {{ state.fan_speed }})/span/p button onclickfetchStatus()刷新狀態(tài)/button /div div classsection h2規(guī)則配置/h2 form onsubmitupdateConfig(event) label開啟溫度閾值 (°C): input typenumber step0.1 nametemp_on value{{ config.temp_on }}/labelbrbr label關(guān)閉溫度閾值 (°C): input typenumber step0.1 nametemp_off value{{ config.temp_off }}/labelbrbr label人體感應(yīng)防抖時間 (秒): input typenumber namedebounce_win value{{ config.debounce_win }}/labelbrbr label夜間模式起始時間: input typetime namenight_start value{{ config.night_start }}/labelbrbr label夜間模式結(jié)束時間: input typetime namenight_end value{{ config.night_end }}/labelbrbr input typesubmit value保存配置 /form p idconfig_msg/p /div script function fetchStatus() { fetch(/api/status).then(rr.json()).then(data{ document.getElementById(current_temp).textContent data.temp; document.getElementById(current_presence).textContent data.presence; document.getElementById(current_fan).textContent data.fan_power (檔位: data.fan_speed ); }); } function updateConfig(e) { e.preventDefault(); const formData new FormData(e.target); const data Object.fromEntries(formData); fetch(/api/config, {method:POST, headers:{Content-Type:application/json}, body: JSON.stringify(data)}) .then(rr.json()).then(res{ document.getElementById(config_msg).textContent res.message; }); } // 頁面加載時獲取一次狀態(tài) window.onload fetchStatus; /script /body /html app.route(/) def index(): if controller_global: state { temp: round(controller_global.sensor_data[temperature], 1), presence: 有人 if controller_global.sensor_data[presence] else 無人, fan_power: 開啟 if controller_global.fan_status[power] else 關(guān)閉, fan_speed: controller_global.fan_status[speed] } # 這里簡化處理實際配置應(yīng)從文件或數(shù)據(jù)庫讀取 config {temp_on: 28.0, temp_off: 26.0, debounce_win: 30, night_start:23:00, night_end:06:00} return render_template_string(HTML_TEMPLATE, statestate, configconfig) return 控制器未就緒 app.route(/api/status) def get_status(): if controller_global: return jsonify({ temp: controller_global.sensor_data[temperature], presence: controller_global.sensor_data[presence], fan_power: controller_global.fan_status[power], fan_speed: controller_global.fan_status[speed] }) return jsonify({error: not ready}), 503 app.route(/api/config, methods[POST]) def update_config(): new_config request.json # 這里應(yīng)該將new_config保存到配置文件或數(shù)據(jù)庫并更新controller_global中的規(guī)則參數(shù) logging.info(f收到新配置: {new_config}) # 示例更新控制器的閾值 # controller_global.temp_threshold_on float(new_config.get(temp_on, 28.0)) # controller_global.temp_threshold_off float(new_config.get(temp_off, 26.0)) return jsonify({message: 配置更新成功}) def run_web_interface(): app.run(host0.0.0.0, port5000, debugFalse, use_reloaderFalse) # 在主程序中啟動Web界面線程 if __name__ __main__: controller AutoFanController() controller_global controller # 簡單全局化生產(chǎn)環(huán)境需用更好的方式管理 web_thread threading.Thread(targetrun_web_interface, daemonTrue) web_thread.start() controller.run()現(xiàn)在你可以通過訪問http://你的服務(wù)器IP:5000來查看系統(tǒng)狀態(tài)并動態(tài)修改自動化規(guī)則了。這極大地提升了系統(tǒng)的可用性和靈活性。6. 部署、監(jiān)控與問題排查6.1 服務(wù)化部署與自啟動開發(fā)完成后我們需要讓這個Python腳本在后臺穩(wěn)定運行。在Linux系統(tǒng)如樹莓派上可以將其配置為系統(tǒng)服務(wù)。創(chuàng)建一個服務(wù)文件/etc/systemd/system/auto-fan.service[Unit] DescriptionAuto Fan Control Service Afternetwork.target [Service] Typesimple Userpi # 替換為你的用戶名 WorkingDirectory/home/pi/auto-fan-control # 替換為你的項目路徑 EnvironmentPATH/home/pi/auto-fan-control/venv/bin # 指向虛擬環(huán)境 ExecStart/home/pi/auto-fan-control/venv/bin/python /home/pi/auto-fan-control/main.py Restarton-failure RestartSec10 [Install] WantedBymulti-user.target然后執(zhí)行sudo systemctl daemon-reload sudo systemctl enable auto-fan.service sudo systemctl start auto-fan.service sudo systemctl status auto-fan.service # 查看狀態(tài)這樣應(yīng)用就會在系統(tǒng)啟動時自動運行并在崩潰后自動重啟。6.2 日志與監(jiān)控完善的日志是排查問題的生命線。我們之前使用了logging.basicConfig但可以配置得更加強大例如按日期滾動記錄日志文件。import logging from logging.handlers import TimedRotatingFileHandler def setup_logging(): log_format %(asctime)s - %(name)s - %(levelname)s - %(message)s log_file auto_fan.log # 文件處理器每天午夜?jié)L動保留7天 file_handler TimedRotatingFileHandler(log_file, whenmidnight, backupCount7) file_handler.setLevel(logging.INFO) file_handler.setFormatter(logging.Formatter(log_format)) # 控制臺處理器 console_handler logging.StreamHandler() console_handler.setLevel(logging.DEBUG) console_handler.setFormatter(logging.Formatter(log_format)) # 獲取根logger并配置 logger logging.getLogger() logger.setLevel(logging.DEBUG) logger.addHandler(file_handler) logger.addHandler(console_handler) # 在程序開始時調(diào)用 setup_logging()6.3 常見問題排查速查表在實際運行中你可能會遇到以下問題。這里提供一個快速排查指南問題現(xiàn)象可能原因排查步驟與解決方案SDK連接失敗報MQTT connect error1. Access ID/Secret 錯誤。2. 設(shè)備ID未授權(quán)給當(dāng)前項目。3. 網(wǎng)絡(luò)問題無法連接涂鴉云。1. 檢查控制臺Access ID/Secret是否正確復(fù)制注意空格。2. 在IoT平臺確認(rèn)使用的device_id是否屬于當(dāng)前項目。3. 嘗試ping openapi.tuyacn.com(中國區(qū)) 檢查網(wǎng)絡(luò)連通性。收不到設(shè)備消息1. 設(shè)備離線。2. 訂閱的設(shè)備ID不正確。3. 設(shè)備DP上報格式或DPID理解錯誤。1. 在涂鴉智能APP檢查設(shè)備是否在線。2. 核對代碼中訂閱的device_id與平臺是否一致。3.關(guān)鍵步驟使用SDK的調(diào)試模式或平臺“日志服務(wù)”查看設(shè)備原始上報數(shù)據(jù)確認(rèn)DP結(jié)構(gòu)。控制指令發(fā)送成功但設(shè)備無反應(yīng)1. 控制指令的DPID或值格式錯誤。2. 設(shè)備處于本地控制模式如物理開關(guān)關(guān)閉未響應(yīng)云端指令。3. 設(shè)備功能不支持該指令如風(fēng)扇無擺頭功能卻發(fā)送擺頭指令。1. 再次核對產(chǎn)品功能定義確認(rèn)DPID和值類型布爾型、枚舉型、數(shù)值型。2. 確保設(shè)備處于可云端控制的狀態(tài)如通電、聯(lián)網(wǎng)。3. 先在涂鴉智能APP手動操作一次確認(rèn)設(shè)備功能正常。自動化規(guī)則不觸發(fā)1. 傳感器數(shù)據(jù)未成功更新到sensor_data。2. 規(guī)則判斷條件邏輯有誤如and/or混淆。3. 防抖/遲滯參數(shù)設(shè)置過大導(dǎo)致響應(yīng)遲鈍。1. 檢查日志確認(rèn)on_messages回調(diào)是否被觸發(fā)以及dps解析是否正確。2. 在evaluate_automation_rules函數(shù)開始處打印所有輸入變量進行邏輯調(diào)試。3. 臨時調(diào)小防抖時間和遲滯值觀察行為。Web界面無法訪問1. 防火墻未開放5000端口。2. Flask服務(wù)綁定到了127.0.0.1(localhost)。3. 服務(wù)進程未啟動。1. 檢查服務(wù)器防火墻規(guī)則sudo ufw allow 5000。2. 確保app.run中host0.0.0.0。3. 檢查服務(wù)狀態(tài)sudo systemctl status auto-fan.service查看日志。實操心得調(diào)試是王道智能家居項目硬件、軟件、網(wǎng)絡(luò)交織問題來源復(fù)雜。最有效的調(diào)試方法是“分而治之”首先確保單個設(shè)備能在涂鴉智能APP中正?？刂七@排除了硬件和基礎(chǔ)聯(lián)網(wǎng)問題。其次使用SDK提供的示例代碼或調(diào)試工具單獨測試設(shè)備的訂閱和控制這驗證了SDK配置和云通信。最后再將驗證好的設(shè)備集成到你的自動化邏輯中。日志要盡可能詳細(xì)在關(guān)鍵決策點輸出變量狀態(tài)。遇到詭異問題不妨重啟一下設(shè)備、路由器甚至整個服務(wù)很多時候有奇效。通過以上步驟一個功能相對完善、可配置、易維護的自動風(fēng)扇控制應(yīng)用就搭建完成了。它不僅解決了最初的需求還為你未來集成更多設(shè)備、實現(xiàn)更復(fù)雜的智能場景打下了堅實的基礎(chǔ)。這個項目的樂趣在于你可以完全按照自己的生活習(xí)慣去定義規(guī)則讓技術(shù)真正服務(wù)于生活。