AIR API

WF8266R AIR 提供了 RESTful API 做為操作介面，只需要利用簡單的 http 協定就能整合及運用，以下 API 為服務名稱，例如想要設定 AIR 的網路連線可資網址列輸入

IP

http://你的 AIR IP 位址/scan

這樣就可以設定了。所以你需要知道 IP 位址和要操作的服務名稱及參數，IP 位址可以在物聯雲 APP 中看到，同時在 AIR 的顯示器第4頁同時也有目前的 IP 及版本資訊。

mDNS

除了使用 IP 以外，你可以利用 mDNS 服務，AIR 預設的位址是

http://myairXXXX.local

Windows 用戶需要安裝 Bonjour Print Services : https://support.apple.com/kb/DL999?locale=en_US

AIR 顯示器換頁

換頁方式有 3 種

1. 利用物聯雲 APP 的 《 及 》操作
2. 按下白色鍵， 或是將 GPIO0 碰一下 GND
3. 使用 RESTful API 服務

網路連接及更新

/scan : 連接路由器

使用 UI 來填寫 SSID 及密碼

/user/set : 設定 Wi-Fi 連接

參數 : ssid 連接基地台名稱, password 密碼

/firmware : 韌體上傳

手動上傳 BIN 檔更新

設備操作

/oled/next : 顯示器切下一個畫面

/oled/previous : 顯示器切上一個畫面

/oled/on : 打開顯示器

/oled/off : 關閉顯示器

/pm25s : 讀取神榮感測資料

/pm25g : 讀取 PLANTOWER 感測資料

{"PMCF10":113,"PMCF25":163,"PMCF100":198,"PMAT10":75,"PMAT25":108,"PMAT100":131,"PMCount03":5076,"PMCount05":105,"PMCount10":28928,"PMCount25":1400,"PMCount50":0,"PMCount100":0}

/sleep : 休眠

/rst : 重開機

/ap/on : 打開 AP

/ap/off : 關閉 AP

/dht : 讀取 DHT 系列溫濕度感測資料

參數 : pin 腳位, type 型號 (11,21,22)

/sht31 : 讀取 SHT 系列溫濕度感測資料

/aprs : 讀取氣象站

WindDir 風向, WindSpeedAvg_min 平均每分鐘風速 m/s, WindSpeedMax 最大風速 m/s, Rain_hour 時雨量 mm, Rain_day 日雨量 mm, C 溫度, H 濕度, BarPressure 氣壓 hPa

{"WindDir":225,"WindSpeedAvg_min":0.00,"WindSpeedMax":1.34,"Rain_hour":0.00,"Rain_day":0.00,"C":29.44,"H":64,"BarPressure":1008.90}

設定

/geo : 地點

參數 : lat 緯度, lon 經度

/config : 上傳更新頻率(秒)

參數 : timer 更新頻率, sleep 休眠時間

/oled/config : OLED 圖表更新頻率(秒)

參數 : timer 更新頻率

/temp/config 溫濕度感測設定

參數 : type 感測器種類(0 : DHT, 1: SHT)

/pm25/config 空氣品質感測設定

參數 : type 感測器種類 (0 : 神榮, 1: PLANTOWER A1/G3/G5/G7, 2:PTQS1005, 3:PMS5003T, 4:PMS5003S, 5:PMS5003ST)

/server/config : 資料上傳服務設定

參數 : url 主機網址, data 服務名稱及資料

資料參數 : {1} PM2.5, {2} 溫度, {3}  濕度, {4} PM10, {5} 風向, {6} 風速(分), {7} 時雨量, {8} 氣壓, {9} 二氧化碳(CO2), {10} 揮發性 TVOC, {11} 甲醛 HCHO 

例如 ： 上傳到 http://yoursite/get.php?a=1&b=2&c=3, 其中 & 符號要換成 %26

url = http://yoursite

data = get.php?a={1}%26b={2}%26c={3}

/led/config : 彩色指示燈開關

參數 : state 狀態(0: 關, 1: 開)

/aprs/config : APRS 氣象站開關

參數 : state 狀態(0: 關, 1: 開)

其他

/payload : 上傳到 LASS 的資料格式

/app/info : 設備設定值及狀態

/app/scan : 取得設備附近 AP 清單

/ifttt/maker IFTTT KEY

http://ip/ifttt/maker?key=XXX

/ifttt/alarm 警示條件

alert : 預警值

occur : 發生值

kpi : 監聽指標 [0]溫度 [1]濕度 [2]PM2.5 [3]PM10

event : IFTTT 事件名稱 正常事件,預警事件,發生事件

IFTTT Maker 參數 : Value1 監聽值, Value2 設備編號

例如 : 已設置事件 PM25A 和 PM25O ，當 PM2.5 值 〉70 時發送 PM25A, PM2.5 值 〉100 時發送 PM25O, 〈 70 發送 PM25G

http://ip/ifttt/alarm?alert=70&occur=100&kpi=2&event=PM25G,PM25A,PM25O