HOME Assistant MQTT 室內多功能空氣品質感測器

搭配的硬體是採用攀藤 pms5003t 搭配一個 sgp30 eco2 與 tvoc ，還有4路輸出控制，可以接繼電器或者 MOS 開關，提供給 ha 可以控制四路的輸出。此外監控室內空氣品質 pm2.5 pm1.0 pm10 的濃度，eco2 的濃度 tvoc 濃度，溫度濕度以及一路人體移動感測狀態回報。

實體參數說明

控制類實體

_rebootcmd 【SWITCH】重啟設備
_relay1 【SWITCH 1 】 Retained 屬性 / 高電平觸發類
_relay2 【SWITCH 2 】 Retained 屬性 / 高電平觸發類
_relay3 【SWITCH 3 】 Retained 屬性 / 高電平觸發類
_relay4 【SWITCH 4 】 Retained 屬性 / 高電平觸發類

感測器實體
_airhumi 濕度單位 %
_airTemp 溫度單位 °C
_co2 二氧化碳濃度單位 ppm
_tvoc TVOC濃度單位 ppb
_motion 人體移動 Binary_senor 【觸發 or 安全】

_CpuTemp ESP32溫度單位 °C
_ipaddr 設備IP位置 xxx.xxx.xxx.xxx
_myUptime 設備上線時間單位 min
_rssi WIFI訊號強度單位 dBm
_ssid WIFI-AP名稱 XXXXXX

_pm_1_0 PM 1.0 濃度單位 μg/m³
_pm_2_5 PM 2.5 濃度單位 μg/m³
_pm_10_0 PM 10.0 濃度單位 μg/m³

_dust_n0p3 粒徑 0.3 um
_dust_n0p5 粒徑 0.5 um
_dust_n1p0 粒徑 1.0 um
_dust_n2p5 粒徑 2.5 um
_dust_n5p0 粒徑 5.0 um
_dust_n10p0 粒徑 10.0 um

適用硬體與接線

本韌體適用於 ESP32 系列包含 NodeMCU-32S 與 Goouuu esp32 包含 ESP32-DevKitC WROOM 開發板皆可使用。

攀藤 PMS5003T 粉塵感測器 ( 接 5V 供電)

感測器 TX 腳位接 RXD gpio_ 25
感測器 RX 腳位接 TXD gpio_ 32

輸入偵測腳位 ( 接 3.3V or 5V 供電)

適用於 HC-SR05, SR-602,HC-SR505 或其他可發出 0-3.3V 電平訊號的感測器高電平觸發

輸入偵測腳位 gpio_33

SGP30 空氣品質感測器 ( 接 3.3V 供電)

I2C SDA腳位 gpio_18
I2C SCL 腳位 gpio_19

控制腳位

可以銜接 3.3V 繼電器控 AC/DC 或 MOS 電路板控直流設備

Relay1_PIN gpio_16
Relay2_PIN gpio_17
Relay3_PIN gpio_18
Relay4_PIN gpio_19

重設腳位 ( WIFI 連線控制)

ESP32 板子上的 RST 按鈕按著 10秒會恢復出廠預設。 GPIO_0 接地 10秒會清空所有WIFI設定，開啟AP模式等待配置。

Wifi 和 MQTT 配置

配置入口網站

上電載入至 ESP32 後，則必須使用 WiFi Manager 入口網站設定網路參數。

在您的智慧型手機上，開啟WIFI之後搜尋 OSG_XXX 的熱點，連線網路後輸入密碼 your_password 即可連接，對於所有設備的訊息，它都會列印在序列監視器日誌上。

一旦連接到 WiFi，就會出現一個網頁。在 Android 上，您可能還會看到一個彈出窗口，詢問您是否要在沒有網路連線的情況下連接到它。答案是，總是/一直。如果未出現該網頁，請按一下 WiFi 存取點和「管理路由器」。

點擊 Configure WIFI 設定

點選你的WIFI 熱點後輸入連線密碼，開始配置其他參數

1. 燒錄完成後，打開你的手機，開啟 WIFI 功能後，在熱點的清單中，你會看到 OSG_XXXX 開頭的熱點AP，這就是你的ESP32。

2. 登入這個AP熱點，預設的密碼 your_password

3. 登入後就可以看到 Configure WIFI，點入後就可以設定你的 WIFI 帳號密碼與 MQTT的相關設定。例如 Mqtt 伺服器位置，登入帳號與密碼。

4. mqtt secure 先不要勾選，除非你的MQTT 伺服器必須使用 8883 加密連線

5. Gateway name 這裡是訂你設備的識別名稱，請勿使用中文，用數字會英文字母定義。(也可以預設不用改，系統自動用ESP32的MAC來區分不會打架)

6. mqtt base topic 這裡是設定Mqtt 探索 prefix的識別字串，你也可以依照你自己的環境修改，不過這裡的設定要與HA的設定一致。

7. otapassword 這是當設備連線WIFI後，你想要登入這個ESP32要輸入的密碼，可以登入進去修改MQTT的設定或一些站點的資訊。

本韌體適用於 ESP32 – WROOM系列模組基於ESP32 -D0WD 雙核心晶片，也適用於 ESP32-S 的晶片，支援 Home Assistant Auto Discovery 設備自動部屬，免編輯 Yaml檔案。

目前版本只支援 MQTT 非加密的連線 (1883) ，您如果有興趣可以使用 ESP32 燒錄後，設定 WIFI 與 MQTT 伺服器後就可以看到設備了。

本韌體有支援可用性回報，當設備離線 Home Assistant 會顯示為不可用, 設備恢復連線後通知 Home Assistant。

腳位說明:

GPIO0 也就是 esp32開發版上的 boot 鍵長按 10秒重設ESP32並清空所有 WIFI 設定。

GPIO 16 為控制繼電器的腳位。有支援 Last Will 的功能，設備重新開機會回復上一次的狀態。

GPIO 33 運作模式為偵測到有信號會持續通知 HA 維持 30秒，期間如果持預有感測到有移動或訊號就持續，直到沒有偵測到訊號後 30 秒內通知 HA 為安全沒有觸發。

您可以自行銜接 HC-SR501 PIR 人體紅外感應模組的輸出腳或 SR-602 DC3.3~15V 微型人體紅外線感應模組都可以使用，當然也可以用 RCWL-0516 微波雷達感應開關模組

不過目前基於微波雷達感應可能會與 WIFI產生干擾造成誤判，這部分需要電路來解決，不在本次討論範圍。基本上這個輸入腳位可以銜接任何感測器會提供高電平訊號的都可以，自己注意一下電壓，輸入的電壓不能超過 3.3 否則會燒毀 ESP32

MqTT 設定上的注意事項:

1. 你必須要先安裝 MQTT 伺服器

(例如: mosquitto 或 EMXQ) 並於裝置與服務的功能上設定好 MQTT 整合，啟用 Mqtt 探索 prefix – 必須使用 prefix 才能使用自動部屬的功能，如果你有啟用的狀態下，預設的 prefix 為 homeassistant

2. 設定設備時於 “mqtt base topic” 這個欄位就是設定你 HA 所設定的 prefix, 例如: homeassistant 之後儲存後就會重新開機並連線到你的 HA

設定欄位說明

選擇您的 WiFi 熱點
設定您的 WiFi 密碼
設定您的 MQTT 伺服器 IP 或網域名稱（對於 Home Assistant，homeassistant.local或者 IP位置，如果你的 MQTT 伺服器是區網外則可以輸入伺服器的IP位置）
設定您的 MQTT 伺服器連接埠（預設：1883）
設定 MQTT 安全連接框以選擇連接是否應該安全（預設：否沒有勾選）
將 MQTT 伺服器 CA 憑證複製/貼上到 MQTT 伺服器憑證方塊中（預設：否空白）（僅在使用安全連線時才需要），請務必包含-----BEGIN CERTIFICATE-----和-----END CERTIFICATE-----標記
設定您的 MQTT 伺服器使用者名稱（可選，最多 64 個字元）
設定您的 MQTT 伺服器密碼（可選，最多 64 個字元）
請設定Home Assistant MQTT 的 discovery_prefix 【設定你 HA 所設定的 prefix, 例如: homeassistant 之後儲存後就會重新開機並連線到你的 HA】
如果需要更改，請設定您的網關名稱
設定您的設備密碼（預設：空，最少 8 個字符，最多 64 個字符），此密碼用於 WebUI登入（登入名稱：“admin”，密碼：“”）
option_time 是設定設備幾秒一次發送資料給 ha，建議 15 秒以上
option_temp 溫度補償，PMS5003T 如果沒有用盒子包起來的話，預設建議 +4 度補償，如果有放入盒子內就不用設定
option_humi 濕度補償，PMS5003T 如果沒有用盒子包起來的話，預設建議 +6 度補償，如果有放入盒子內就不用設定

ESP 系列: HOME Assistant MQTT 室內多功能空氣品質感測器

版本: 1.0 / 硬體支援: ESP32

抱歉!! 你的瀏覽器不支援，請使用 Google Chrome! 抱歉!! 瀏覽模式不支援，請改用https:// 連線

HOME Assistant MQTT 室內多功能空氣品質感測器