# Lab16 Communicate with IoT Platform

###### tags: `2024工業物聯網`
助教：睿翔

# IoT Platform 使用說明 (ThingSpeak)
ThingSpeak是一個提供物聯網分析平台服務的網站，讓你能夠在雲端收集、可視化和分析實時的資料。此外，ThingSpeak也能即時地將你的設備發佈到它的平台上進行數據的可視化。

### 點擊連結註冊並且登入 https://thingspeak.com/
<font color='red'>請使用學校Email註冊</font>
## 樹莓派串接 IoT Platform 即時監測實例 (DHT11)
### 新增channel
### 查看API Key
## IoT Platform 溝通方式 (HTTP request)

| 方法 | 目標 | 說明 | HTTP 回應狀態碼 |
| ------ | ------------ | ----------------------------------------------------------------------------------- | --------------- |
| GET | 單個資源 URL | 取得資源 | 200 |
| GET | 資源集合 URL | 取得資源集合(或是如果伺服器有進行分頁，取得它的一頁) | 200 |
| POST | 資源集合 URL | 建立一個新資源並將它加入集合，伺服器會選擇新資源的 URL，在回應的Location 標頭回傳它 | 201 |
| PUT | 單個資源 URL | 修改既有的資源，或者當用戶端可以選擇資源 URL 時，這個方法也可以用來建立新資源 | 200 or 204 |
| DELETE | 單個資源 URL | 刪除一個資源 | 200 or 204 |
| DELETE | 資源集合 URL | 刪除集合的所有資源 | 200 or 204 |

延伸資料：
[HTTP request methods](https://developer.mozilla.org/en-US/docs/Web/HTTP/Methods)
[淺談 HTTP Method：表單中的 GET 與 POST 有什麼差別？](https://blog.toright.com/posts/1203/%E6%B7%BA%E8%AB%87-http-method%EF%BC%9A%E8%A1%A8%E5%96%AE%E4%B8%AD%E7%9A%84-get-%E8%88%87-post-%E6%9C%89%E4%BB%80%E9%BA%BC%E5%B7%AE%E5%88%A5%EF%BC%9F.html)
參考資料：
[Flask 網頁開發](https://www.books.com.tw/products/0010793455)

## 關鍵程式碼片段
由於 mini conda 把樹莓派的 python 版本改為 3.4，強烈建議將樹莓派重灌以徹底移除 conda
記得先備份程式碼！！！
請參考[Lab03 DHT11](https://hackmd.io/@MCAS/IIoT_Lab03)，修改時請改為 'BCM2711'
__將資料透過 HTTP request 發送至 ThinkSpeak__

# 改成你創建的 ThingSpeak channel 所顯示的 <Write-API-Key>
ThingSpeak_WriteApiKey = '3HVRLATG7INCEH2U'
# 每 `detection_period` 秒偵測一次
detection_period = 5

# 取得目前的溫濕度
humidity, temperature = get_sensor_data()

# 若有讀取到資料就轉成格式化字串型態，並透過 API key 以 GET request 方式上傳至 ThinkSpeak
if humidity is not None and temperature is not None: # 若 `DHT.read_retry` 失敗，會回傳 None
    ThingSpeak_API_URL = f'https://api.thingspeak.com/update?api_key={ThingSpeak_WriteApiKey}&' \
                         f'field1={"{0:0.1f}".format(temperature)}&' \
                         f'field2={"{0:0.1f}".format(humidity)}'
    query = requests.get(ThingSpeak_API_URL)
    print(f'HTTP: {query.status_code}') # 查看 HTTP 狀態碼，若為 200 表示傳送成功
    print(now+',', 'temperature:', temperature, '度C,', 'humidity:', humidity, '%') # 標準輸出溫溼度於本地端
else:
    # 感測器讀取失敗就立即重讀
    print('Failed to get reading. Try again!')
    continue

# 上傳完數據之後就暫停 `detection_period` 秒
time.sleep(detection_period)

## 輸出範例
__命令列標準輸出範例__

__ThinkSpeak 監控畫面__

# 本週作業說明與繳交規範
1. 根據前述關鍵程式碼的教學，自行更改 Lab2 DHT11 的程式碼，完成下列要求:
* 使用 while loop 使程式能持續監測 (監測頻率自行設定)
* 程式要可以使用 Keyboard Interrupt (Ctrl+C) 終止程式
* 透過 HTTP GET request 上傳資料至 ThingSpeak
2. 作業繳交規範
* 每組繳交一份壓縮檔即可，檔名請命名為「groupX_lab06」
* 壓縮檔請包含 程式碼檔案 (.py檔) 與 實作影片檔
* 實作影片需拍攝樹莓派連接DHT11的電路接法、程式運作畫面 (命令列標準輸出)、ThinkSpeak 即時監測畫面
3. 繳交期限：05/14 23:59