# 멀티캐스트 그룹 생성 및 그룹에 디바이스 추가
콘솔 또는 CLI를 사용하여 멀티캐스트 그룹을 생성할 수 있습니다. 멀티캐스트 그룹을 처음 생성하는 경우 콘솔을 사용하여 멀티캐스트 그룹을 추가하는 것이 좋습니다. 멀티캐스트 그룹을 관리하고 그룹에서 디바이스를 추가하거나 제거하려는 경우 CLI를 사용합니다.
추가한 종단 디바이스와 신호를 주고받은 후 AWS IoT Core for LoRaWAN은 종단 디바이스와 공유 키를 설정하고 데이터 전송을 위한 파라미터를 설정합니다.
## 필수 조건
멀티캐스트 그룹을 생성하고 그룹에 디바이스를 추가하려면 다음을 수행합니다.
+ FUOTA 구성 파라미터 `GenAppKey` 및 `FPorts`를 지정하여 멀티캐스트 및 FUOTA 설정을 위해 디바이스를 준비합니다. 자세한 내용은 [멀티캐스트 및 FUOTA 구성을 위한 디바이스 준비](lorawan-prepare-devices-multicast.md) 단원을 참조하십시오.
+ 디바이스가 클래스 B 또는 클래스 C 작동 모드를 지원하는지 확인합니다. 디바이스가 지원하는 디바이스 클래스에 따라 **클래스 B 지원(Supports Class B)** 또는 **클래스 C 지원(Supports Class C)** 모드 중 하나 또는 둘 모두가 사용되는 디바이스 프로파일을 선택합니다. 디바이스 프로파일에 대한 자세한 내용은 [AWS IoT Core for LoRaWAN에 프로파일 추가](lorawan-define-profiles.md) 섹션을 참조하세요.
멀티캐스트 세션이 시작될 때 클래스 B 또는 클래스 C 배포 기간은 다운링크 메시지를 그룹의 디바이스로 전송하는 데 사용됩니다.
## 콘솔을 사용하여 멀티캐스트 그룹 생성
콘솔을 사용하여 멀티캐스트 그룹을 생성하려면 AWS IoT 콘솔의 [멀티캐스트 그룹(Multicast groups)](https://console.aws.amazon.com/iot/home#/wireless/multicastGroups) 페이지로 이동하고 **멀티캐스트 그룹 생성(Create multicast group)**을 선택합니다.
1.
**멀티캐스트 그룹 생성**
멀티캐스트 그룹을 생성하려면 그룹에 대한 멀티캐스트 속성과 태그를 지정합니다.
1.
**멀티캐스트 속성 지정**
멀티캐스트 속성을 지정하려면 멀티캐스트 그룹에 대해 다음 정보를 입력합니다.
+ **이름(Name)**: 멀티캐스트 그룹의 고유한 이름을 입력합니다. 이름에는 문자, 숫자, 하이픈 및 밑줄만 포함되어야 합니다. 공백은 포함할 수 없습니다.
+ **설명(Description)**: 멀티캐스트 그룹에 대한 설명(선택 사항)을 제공할 수 있습니다. 설명 길이는 최대 2,048자입니다.
1.
**멀티캐스트 그룹용 태그**
선택적으로 모든 키-값 페어를 멀티캐스트 그룹에 대한 **태그(Tags)**로 제공할 수 있습니다. 멀티캐스트 그룹 생성을 계속하려면 **다음(Next)**을 선택합니다.
1.
**멀티캐스트 그룹에 디바이스 추가**
멀티캐스트 그룹에 개별 디바이스나 디바이스 그룹을 추가할 수 있습니다. 디바이스를 추가하려면
1.
**RFRegion 지정**
멀티캐스트 그룹에 대한 **RFRegion** 또는 주파수 대역을 지정합니다. 멀티캐스트 그룹의 **RFRegion**은 멀티캐스트 그룹에 추가하는 디바이스의 **RFRegion**과 일치해야 합니다. **RFRegion**에 대한 자세한 내용은 [게이트웨이 및 디바이스 연결을 위한 LoRa 주파수 대역 선택 고려](lorawan-rfregion-permissions.md#lorawan-frequency-bands) 섹션을 참조하세요.
1.
**멀티캐스트 디바이스 클래스 선택**
멀티캐스트 세션 시작 시 멀티캐스트 그룹의 디바이스를 클래스 B 또는 클래스 C 모드로 전환할지 여부를 선택합니다. 클래스 B 세션은 일반 다운링크 슬롯에서 다운링크 메시지를 수신할 수 있으며 클래스 C 세션은 언제든지 다운링크 메시지를 수신할 수 있습니다.
1.
**그룹에 추가할 디바이스를 선택합니다.**
멀티캐스트 그룹에 디바이스를 개별적으로 추가할지 일괄적으로 추가할지 선택합니다.
+ 디바이스를 개별적으로 추가하려면 그룹에 추가할 각 디바이스의 무선 디바이스 ID를 입력합니다.
+ 디바이스를 일괄 추가하려면 디바이스 프로파일 또는 태그별로 추가하려는 디바이스를 필터링합니다. 디바이스 프로파일의 경우 클래스 B, 클래스 C 또는 두 디바이스 클래스를 모두 지원하는 프로파일이 있는 디바이스를 추가할 수 있습니다.
1. 멀티캐스트 그룹을 생성하려면 **생성(Create)**을 선택합니다.
멀티캐스트 그룹 세부 정보와 추가한 디바이스가 그룹에 나타납니다. 멀티캐스트 그룹 및 디바이스의 상태 및 문제 해결에 대한 자세한 내용은 [멀티캐스트 그룹 및 그룹의 디바이스 상태 모니터링 및 문제 해결](lorawan-multicast-status.md) 섹션을 참조하세요.
멀티캐스트 그룹을 생성한 후 **작업(Action)**을 선택하여 디바이스를 편집 또는 삭제하거나 멀티캐스트 그룹에 추가할 수 있습니다. 디바이스를 추가한 후에는 다운링크 페이로드가 그룹의 디바이스로 전송되도록 세션을 예약할 수 있습니다.
## API를 사용하여 멀티캐스트 그룹 생성
API를 사용하여 멀티캐스트 그룹을 생성하고 그룹에 디바이스를 추가하려면
1.
**멀티캐스트 그룹 생성**
멀티캐스트 그룹을 생성하려면 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_CreateMulticastGroup.html) API 작업 또는[https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/create-multicast-group.html) CLI 명령을 사용합니다. `input.json` 파일을 `create-multicast-group` 명령에 대한 입력으로 제공할 수 있습니다.
```
aws iotwireless create-multicast-group \
--cli-input-json file://input.json
```
여기서 각 항목은 다음과 같습니다.
**input.json 내용**
```
{
"Description": "Multicast group to send downlink payload and perform FUOTA.",
"LoRaWAN": {
"DlClass": "ClassB",
"RfRegion": "US915"
},
"Name": "MC_group_FUOTA"
}
```
멀티캐스트 그룹을 생성한 후 다음 API 작업 또는 CLI 명령을 사용하여 멀티캐스트 그룹에 대한 정보를 업데이트, 삭제 또는 가져올 수 있습니다.
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/update-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateMulticastGroup) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/get-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListMulticastGroups) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-multicast-groups.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteMulticastGroup) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/delete-multicast-group.html)
1.
**멀티캐스트 그룹에 디바이스 추가**
멀티캐스트 그룹에 디바이스를 개별적으로 또는 일괄적으로 추가할 수 있습니다.
+ 멀티캐스트 그룹에 디바이스를 일괄적으로 추가하려면 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkAssociateWirelessDeviceWithMulticastGroup.html) API 작업 또는[https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-associate-wireless-device-with-multicast-group.html) CLI 명령을 사용합니다. 멀티캐스트 그룹에 일괄적으로 연결하려는 디바이스를 필터링하려면 쿼리 문자열을 제공합니다. 다음은 지정된 ID가 연결된 디바이스 프로파일이 있는 디바이스 그룹을 추가하는 방법을 보여줍니다.
```
aws iotwireless start-bulk-associate-wireless-device-with-multicast-group \
--id "12abd34e-5f67-89c2-9293-593b1bd862e0" \
--cli-input-json file://input.json
```
여기서 각 항목은 다음과 같습니다.
**input.json 내용**
```
{
"QueryString": "DeviceProfileName: MyWirelessDevice AND DeviceProfileId: d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf",
"Tags": [
{
"Key": "Multicast",
"Value": "ClassB"
}
]
}
```
여기서 `multicast-groups/d6d8ef8e-7045-496d-b3f4-ebcaa1d564bf/bulk`는 디바이스를 그룹과 연결하는 데 사용되는 URL입니다.
+ 멀티캐스트 그룹에 디바이스를 개별적으로 추가하려면 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_AssociateWirelessDeviceWithMulticastGroup.html) API 작업 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/associate-wireless-device-with-multicast-group.html) CLI를 사용합니다. 그룹에 추가할 각 디바이스의 무선 디바이스 ID를 입력합니다.
```
aws iotwireless associate-wireless-device-with-multicast-group \
--id "12abd34e-5f67-89c2-9293-593b1bd862e0" \
--wireless-device-id "ab0c23d3-b001-45ef-6a01-2bc3de4f5333"
```
멀티캐스트 그룹을 생성한 후 다음 API 작업 또는 CLI 명령을 사용하여 멀티캐스트 그룹에 대한 정보를 보거나 장치 연결을 해제할 수 있습니다.
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DisassociateWirelessDeviceFromMulticastGroup.html) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/disassociate-wireless-device-from-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartBulkDisassociateWirelessDeviceFromMulticastGroup.html) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-bulk-disassociate-wireless-device-from-multicast-group.html)
+ [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDevices) 또는 [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/list-wireless-devices.html)
**참고**
`ListWirelessDevices` API 작업은 일반적으로 무선 디바이스 및 멀티캐스트 그룹 또는 FUOTA 태스크와 연결된 무선 디바이스를 나열하는 데 사용할 수 있습니다.
멀티캐스트 그룹과 연결된 무선 디바이스를 나열하려면 `MulticastGroupID`를 필터로 하여 `ListWirelessDevices` API 작업을 사용합니다.
FUOTA 태스크와 연결된 무선 장치를 나열하려면 `ListWirelessDevices`를 필터로 하여 `FuotaTaskID` API 작업을 사용합니다.
## 다음 단계
멀티캐스트 그룹을 생성하고 디바이스를 추가한 후 계속해서 디바이스를 추가하고 멀티캐스트 그룹과 디바이스의 상태를 모니터링할 수 있습니다. 디바이스가 그룹에 성공적으로 추가되었으면 다운링크 메시지를 구성하고 디바이스로 전송하도록 예약할 수 있습니다. 다운링크 메시지를 전송하려면 먼저 디바이스가 **멀티캐스트 설정 준비 상태(Multicast setup ready)**여야 합니다. 다운링크 메시지를 예약하면 상태가 **세션 시도 중(Session attempting)**으로 변경됩니다. 자세한 내용은 [멀티캐스트 그룹의 디바이스로 전송하도록 다운링크 메시지 예약](lorawan-multicast-schedule-downlink.md) 단원을 참조하십시오.
멀티캐스트 그룹에 있는 디바이스의 펌웨어를 업데이트하려면 AWS IoT Core for LoRaWAN을 사용하여 펌웨어 무선 업데이트(FUOTA)를 수행할 수 있습니다. 자세한 내용은 [AWS IoT Core for LoRaWAN 디바이스의 펌웨어 무선 업데이트(FUOTA)](lorawan-mc-fuota-overview.md) 단원을 참조하십시오.
디바이스가 추가되지 않았거나 멀티캐스트 그룹 또는 디바이스 상태에 오류가 표시되는 경우 오류 위로 마우스를 가져가 자세한 정보를 보고 해결할 수 있습니다. 여전히 오류가 표시되는 경우 문제를 해결하는 방법에 대한 자세한 내용은 [멀티캐스트 그룹 및 그룹의 디바이스 상태 모니터링 및 문제 해결](lorawan-multicast-status.md) 섹션을 참조하세요.