

# 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 콘솔의 **테스트** 페이지에서 [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/ko_kr/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"
    }
  }
}
```