You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
IoT-For-Beginners/translations/tw/1-getting-started/lessons/4-connect-internet/wio-terminal-telemetry.md

91 lines
3.0 KiB

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<!--
CO_OP_TRANSLATOR_METADATA:
{
"original_hash": "4bcc29fe2b65e56eada83d2476279227",
"translation_date": "2025-08-24T23:08:25+00:00",
"source_file": "1-getting-started/lessons/4-connect-internet/wio-terminal-telemetry.md",
"language_code": "tw"
}
-->
# 通過網絡控制夜燈 - Wio Terminal
在本課程的這部分,您將通過 MQTT broker 從 Wio Terminal 發送光線強度的遙測數據。
## 安裝 JSON Arduino 庫
使用 JSON 是通過 MQTT 發送消息的一種流行方式。有一個 Arduino 的 JSON 庫,可以讓讀取和寫入 JSON 文檔變得更加簡單。
### 任務
安裝 Arduino JSON 庫。
1. 在 VS Code 中打開夜燈項目。
1.`platformio.ini` 文件的 `lib_deps` 列表中添加以下額外的一行:
```ini
bblanchon/ArduinoJson @ 6.17.3
```
這將導入 [ArduinoJson](https://arduinojson.org),一個 Arduino 的 JSON 庫。
## 發佈遙測數據
下一步是創建一個包含遙測數據的 JSON 文檔並將其發送到 MQTT broker。
### 任務 - 發佈遙測數據
將遙測數據發佈到 MQTT broker。
1.`config.h` 文件的底部添加以下代碼,以定義 MQTT broker 的遙測主題名稱:
```cpp
const string CLIENT_TELEMETRY_TOPIC = ID + "/telemetry";
```
`CLIENT_TELEMETRY_TOPIC` 是設備將用來發佈光線強度的主題。
1. 打開 `main.cpp` 文件
1. 在文件頂部添加以下 `#include` 指令:
```cpp
#include <ArduinoJSON.h>
```
1.`loop` 函數內,緊接著 `delay` 之前添加以下代碼:
```cpp
int light = analogRead(WIO_LIGHT);
DynamicJsonDocument doc(1024);
doc["light"] = light;
string telemetry;
serializeJson(doc, telemetry);
Serial.print("Sending telemetry ");
Serial.println(telemetry.c_str());
client.publish(CLIENT_TELEMETRY_TOPIC.c_str(), telemetry.c_str());
```
此代碼讀取光線強度,並使用 ArduinoJson 創建一個包含該強度的 JSON 文檔。然後將其序列化為字符串,並通過 MQTT 客戶端發佈到遙測 MQTT 主題。
1. 將代碼上傳到您的 Wio Terminal並使用串行監視器查看光線強度數據被發送到 MQTT broker。
```output
Connecting to WiFi..
Connected!
Attempting MQTT connection...connected
Sending telemetry {"light":652}
Sending telemetry {"light":612}
Sending telemetry {"light":583}
```
> 💁 您可以在 [code-telemetry/wio-terminal](../../../../../1-getting-started/lessons/4-connect-internet/code-telemetry/wio-terminal) 文件夾中找到此代碼。
😀 您已成功從設備發送遙測數據。
**免責聲明**
本文件使用 AI 翻譯服務 [Co-op Translator](https://github.com/Azure/co-op-translator) 進行翻譯。我們致力於提供準確的翻譯,但請注意,自動翻譯可能包含錯誤或不準確之處。應以原始語言的文件作為權威來源。對於關鍵資訊,建議尋求專業人工翻譯。我們對因使用本翻譯而引起的任何誤解或誤釋不承擔責任。