# 檢視從 LoRaWAN 裝置傳送的上行訊息格式
<a name="lorawan-uplink-metadata-format"></a>

在將 LoRaWAN 裝置連接至 AWS IoT Core for LoRaWAN 之後，您可以觀察將從無線裝置接收的上行訊息格式。

## 在可以觀察上行訊息之前
<a name="lorawan-uplink-metadata-prerequisites"></a>

您必須已加入無線裝置，並將裝置連接至 AWS IoT，以便它可以傳輸和接收資料。如需如何將裝置加入至 AWS IoT Core for LoRaWAN 的相關資訊，請參閱 [將裝置加入 AWS IoT Core for LoRaWAN](lorawan-onboard-end-devices.md)。

## 上行訊息包含哪些內容？
<a name="lorawan-uplink-metadata-contains"></a>

LoRaWAN 裝置藉由使用 LoRaWAN 閘道來連接至 AWS IoT Core for LoRaWAN。您從裝置收到的上行訊息將包含下列資訊。
+ 對應至從無線裝置傳送之加密承載訊息的承載資料。
+ 無線中繼資料，其中包括：
  + 裝置資訊，例如 DevEui、資料速率，以及裝置操作所在的頻率通道。
  + 連接至裝置之閘道的選用額外參數和閘道資訊。閘道參數包括閘道的 EUI、SNR 和 RSSi。

  透過使用無線中繼資料，您可以取得有關無線裝置的實用資訊，以及在裝置與 AWS IoT 之間傳輸的資料。例如，您可以使用 `AckedMessageId` 參數，來檢查裝置是否已收到最後確認的下行訊息。或者，如果選擇包含閘道資訊，您可以識別是否要切換到更接近裝置的更強閘道通道。

## 如何觀察上行訊息？
<a name="lorawan-uplink-metadata-observe"></a>

在加入了您的裝置之後，您可以在 AWS IoT 主控台的 **Test** (測試) 頁面上使用 [MQTT 測試用戶端](https://console.aws.amazon.com/iot/home#/test)，以訂閱您在建立目的地時所指定的主題。在連接您的裝置並開始傳送承載資料之後，您會開始看到訊息。

此圖表會識別連接至 AWS IoT Core for LoRaWAN 之 LoRaWAN 系統中的重要元素，這會顯示主要資料平面和資料流經系統的方式。

![顯示 AWS IoT Core for LoRaWAN 資料如何從無線裝置傳遞至 AWS IoT 和其他服務的影像。](http://docs.aws.amazon.com/zh_tw/iot-wireless/latest/developerguide/images/iot-lorawan-data-flow.png)


當無線裝置開始傳送上行資料時，AWS IoT Core for LoRaWAN 會將無線中繼資料資訊與承載一起包裝，然後傳送到您的 AWS 應用程式。

## 上行訊息範例
<a name="lorawan-uplink-metadata-example"></a>

下列範例顯示從裝置接收之上行訊息的格式。

```
{
    "WirelessDeviceId": "5b58245e-146c-4c30-9703-0ca942e3ff35", 
    "PayloadData": "Cc48AAAAAAAAAAA=",    
    "WirelessMetadata":
    {
        "LoRaWAN":
        {
            "ADR": false,
            "Bandwidth": 125,
            "ClassB": false,
            "CodeRate": "4/5",
            "DataRate": "0",
            "DevAddr": "00b96cd4",
            "DevEui": "58a0cb000202c99",            
            "FOptLen": 2,
            "FCnt": 1,
            "Fport": 136,   
            "Frequency": "868100000",     
            "Gateways": [
             {
                    "GatewayEui": "80029cfffe5cf1cc",      
                    "Snr": -29,
                    "Rssi": 9.75
             }
             ],  
            "MIC": "7255cb07",  
            "MType": "UnconfirmedDataUp",
            "Major": "LoRaWANR1",
            "Modulation": "LORA", 
            "PolarizationInversion": false,    
            "SpreadingFactor": 12,                         
            "Timestamp": "2021-05-03T03:24:29Z"
            
        }
    }
}
```

### 從上行中繼資料中排除閘道中繼資料
<a name="lorawan-uplink-metadata-example2"></a>

如果您想要從上行中繼資料中排除閘道中繼資料資訊，請在建立服務設定檔時停用 **AddGwMetadata** 參數。如需停用此參數的相關資訊，請參閱 [新增裝置設定檔](lorawan-define-profiles.md#lorawan-service-profiles)。

在此情況下，您不會看到上行中繼資料中的 `Gateways` 區段，如下列範例所示。

```
{  
    "WirelessDeviceId": "0d9a439b-e77a-4573-a791-49d5c0f4db95",
    "PayloadData": "AAAAAAAA//8=",
    "WirelessMetadata": {
        "LoRaWAN": {
            "ClassB": false,
            "CodeRate": "4/5",
            "DataRate": "1",
            "DevAddr": "01920f27",
            "DevEui": "ffffff10000163b0",
            "FCnt": 1,
            "FPort": 5,
            "Timestamp": "2021-04-29T05:19:43.646Z"
    }
  }
}
```