# QIoT Suite Lite 簡單使用介紹(以mqtt為範例)

## 建立IoT 應用
1. 登入QIoT Suite Lite，切換頁面到"IoT 應用"，點擊"新增IoT應用"

2. 填入IoT應用名稱後點擊"建立"

## 新增IoT 裝置及IoT 裝置資源
1. 建立"IoT 應用"完成後，接著新增"IoT 裝置"，點擊"新增IoT 裝置"

2. 填入"IoT 裝置名稱"，其他欄位只是方便您管理IoT裝置，不會影響到功能性，可自由選填。完成後點擊"新增"

3. 接下來新增"IoT 裝置資源"，點擊下圖紅框處，接下來點擊新增資源

4. 填入"資源名稱"和"資源Id"，系統會依據"**IoT 裝置名稱**"和"**IoT 裝置資源Id**"組合成一組專屬的mqtt topic，其他部分選填不影響功能。完成後點擊新增後點擊關閉

## 產生連線資訊檔(resourceinfo.json)
1. 現在要產生連線相關資訊檔(resourceinfo.json)，點擊下圖紅框處

2. 選擇要使用的通訊協定，此處選擇mqtt為範例，選擇後點擊下一步

3. 畫面會顯示所有相關的連線資訊，依據這裡的連線資訊設定mqtt client端，此處將會顯示mqtt broker ip、port、username、password、各個資源的topic

## 使mqtt.fx模擬軟體進行連線
可參考此篇教學文章設定mqtt client端:[**如何使用 MQTT 連接到 QNAP QIoT Suite Lite?**](https://www.qnap.com/go/how-to/tutorial/article/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8-mqtt-%E9%80%A3%E6%8E%A5%E5%88%B0-qnap-qiot-suite-lite/)
可以在此處下載mqtt.fx mqtt client端模擬軟體:[**mqtt.fx**](https://mqttfx.jensd.de/index.php/download)

1. 開啟mqtt.fx
2. 設定mqtt broker連線資訊

3. 進行連線

4. 依照連線資訊檔(resourceinfo.json)各個資源提供的Topic進行publish跟subscribe(QOS 2選項不支援)，請參考 [**如何使用 MQTT 連接到 QNAP QIoT Suite Lite?**](https://www.qnap.com/go/how-to/tutorial/article/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8-mqtt-%E9%80%A3%E6%8E%A5%E5%88%B0-qnap-qiot-suite-lite/) 設定Publish的payload，資料格式須為JSON : `{"value":<data>}`，EX : `{"value":1234}`

5. 可在"IoT 應用" > "IoT 裝置"的"IoT 裝置資料日誌"中顯示裝置傳送上來的資料

## 使用Dashboard 呈現資料
參考[**如何使用 QIoT Suite Lite 儀表板 (從 v1.1.1 升級到 v1.1.2)?**](https://www.qnap.com/go/how-to/tutorial/article/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8-qiot-suite-lite-%E5%84%80%E8%A1%A8%E6%9D%BF-%E5%BE%9E-v1-1-1-%E5%8D%87%E7%B4%9A%E5%88%B0-v1-1-2)

1. 切到儀表板頁面，點擊"編輯"

2. 點選下圖紅框(1)處新增面板並點選紅框(2)處新增widget

3. 選擇您要的 widget 類型(此處以測量為範例)，填入相關資訊，在 "值" 欄位選擇您要呈現的 IoT 裝置資源及payload裡解析出來的Json Key (此處範例為剛剛新建的裝置資源: qiotsupported_temperature > value)完成後點擊"儲存"

7. 點選 "完成編輯" 即完成

## 使用Rule 傳送資料至Device
可參考此篇教學文章(準備工作段落):[**如何使用 ESP8266 連線至 QNAP QIoT Suite Lite？**](https://www.qnap.com/go/how-to/tutorial/article/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8-esp8266-%E9%80%A3%E7%B7%9A%E8%87%B3-qnap-qiot-suite-lite)

1. 切換頁面至Rule
2. 刪除預設的所有rule

3. 將QBroker out 及 inject拉至白色編輯區中

4. 雙擊設定QBroker out，填入名子及選擇要發送payload IoT裝置資源的目標，QoS及保留選項可依據需求自由選擇

5. 雙擊設定inject，有效內容填入JSON格式payload

6. 將兩個node連接起來並按下儲存

7. 點擊觸發紐觀看Client端是否有收到

###### tags: `Tutorial`