[文件] UDP 範例補上 onDeviceStatus 使用示範

兩個 UDP 範例（同步 + Async）原本只有 onMessage handler，現在補上
onDeviceStatus handler，示範上游設備上下線通知如何接收。

- 印出格式：「Device ▲ ONLINE / ▼ OFFLINE  deviceId  @ endpoint」
- 註解標清楚：需在 EdgeLink Server 把這台 Arduino 設為 forward target
  才會收到事件，且 LOCAL_PORT 需 > 0

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: changlin.cai

SDK/Arduino/EdgeLink.zip

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:724467f47af27f9820e95db52c6cefeb706e2b772251e32a99383ed30281fa9b
-size 10007
+oid sha256:621f49148ede9e0cfdea4b0560ece07853a62f2d4a382a88f342e37c4cb692f0
+size 10473

SDK/Arduino/EdgeLink/examples/udp_async_sensor/udp_async_sensor.ino

@@ -28,8 +28,9 @@ const uint16_t LOCAL_PORT    = 0;
 AsyncUDP         asyncUdp;
 EdgeLinkAsyncUDP edgelink(asyncUdp);
 
-// LOCAL_PORT > 0 時才會觸發。callback 在 AsyncUDP task 內執行（非 loop()），
-// 盡量短、不要呼叫 Serial.print 大量輸出，必要時用 queue 傳回主執行緒處理。
+// LOCAL_PORT > 0 時才會觸發。一般業務訊息（已過濾掉 EDGELINK_* 控制訊息）
+// callback 在 AsyncUDP task 內執行（非 loop()），盡量短、不要呼叫 Serial.print 大量輸出，
+// 必要時用 queue 傳回主執行緒處理。
 void onMessage(const String& msg, IPAddress remoteIP, uint16_t remotePort) {
     Serial.print("[EdgeLink AsyncUDP] From ");
     Serial.print(remoteIP);
@@ -39,6 +40,17 @@ void onMessage(const String& msg, IPAddress remoteIP, uint16_t remotePort) {
     Serial.println(msg);
 }
 
+// 上游設備在 EdgeLink Server 上下線通知（30s timeout-based）。
+// 需在 EdgeLink Server 把這台 ESP32 設成某 UDP port 的 forward target 才會收到。
+// 同樣在 AsyncUDP task 內執行。
+void onDeviceStatus(bool connected, const String& endpoint, const String& deviceId) {
+    Serial.print("[EdgeLink AsyncUDP] Device ");
+    Serial.print(connected ? "▲ ONLINE  " : "▼ OFFLINE ");
+    Serial.print(deviceId);
+    Serial.print("  @ ");
+    Serial.println(endpoint);
+}
+
 void setup() {
     Serial.begin(115200);
 
@@ -53,6 +65,7 @@ void setup() {
     Serial.println(WiFi.localIP());
 
     edgelink.onMessage(onMessage);
+    edgelink.onDeviceStatus(onDeviceStatus);
     if (!edgelink.begin(LOCAL_PORT)) {
         Serial.println("AsyncUDP listen failed");
         while (true) delay(1000);

SDK/Arduino/EdgeLink/examples/udp_sensor/udp_sensor.ino

@@ -28,7 +28,7 @@ const uint16_t LOCAL_PORT     = 0;
 WiFiUDP     wifiUdp;
 EdgeLinkUDP edgelink(wifiUdp);
 
-// LOCAL_PORT > 0 才會觸發。
+// LOCAL_PORT > 0 才會觸發。一般業務訊息（已過濾掉 EDGELINK_* 控制訊息）
 void onMessage(const String& msg, IPAddress remoteIP, uint16_t remotePort) {
     Serial.print("[EdgeLink UDP] From ");
     Serial.print(remoteIP);
@@ -38,6 +38,16 @@ void onMessage(const String& msg, IPAddress remoteIP, uint16_t remotePort) {
     Serial.println(msg);
 }
 
+// 上游設備在 EdgeLink Server 上下線通知（30s timeout-based）。
+// 需在 EdgeLink Server 把這台 Arduino 設成某 UDP port 的 forward target 才會收到。
+void onDeviceStatus(bool connected, const String& endpoint, const String& deviceId) {
+    Serial.print("[EdgeLink UDP] Device ");
+    Serial.print(connected ? "▲ ONLINE  " : "▼ OFFLINE ");
+    Serial.print(deviceId);
+    Serial.print("  @ ");
+    Serial.println(endpoint);
+}
+
 void setup() {
     Serial.begin(115200);
 
@@ -53,6 +63,7 @@ void setup() {
 
     edgelink.begin(LOCAL_PORT);
     edgelink.onMessage(onMessage);
+    edgelink.onDeviceStatus(onDeviceStatus);
     Serial.println("EdgeLink UDP ready");
 }