가져오기 작업을 사용하여 Sidewalk 디바이스 프로비저닝 - AWS IoT Wireless
Sidewalk 대량 프로비저닝 작동 방법Sidewalk 대량 프로비저닝의 주요 고려 사항CSV 파일 형식Sidewalk 대량 프로비저닝 사용 방법

가져오기 작업을 사용하여 Sidewalk 디바이스 프로비저닝

이 단원에서는 AWS IoT 콘솔, Amazon Sidewalk용 AWS IoT Core API 작업 또는 AWS CLI를 사용하여 Sidewalk 디바이스를 대량으로 프로비저닝하는 방법을 설명줍니다. 다음 섹션에서는 Sidewalk 디바이스를 대량 프로비저닝하는 방법을 설명합니다.

주제

Sidewalk 대량 프로비저닝 작동 방법

다음 단계는 대량 프로비저닝의 작동 방식을 보여줍니다.

  1. 무선 디바이스 가져오기 작업 시작

    Sidewalk 디바이스를 대량으로 프로비저닝하려면 가져오기 태스크를 생성하고 Amazon Sidewalk용 AWS IoT Core에 온보딩할 디바이스의 Sidewalk 제조 일련번호(SMSN)를 제공해야 합니다. 제조업체가 Amazon Sidewalk에 제어 로그를 업로드한 후 이메일을 통해 디바이스의 Sidewalk 제조 일련번호(SMSN)를 CSV 파일로 받았습니다. 이 워크플로와 제어 로그를 받는 방법에 대한 자세한 내용은 Amazon Sidewalk 설명서에서 Amazon Sidewalk 디바이스 제조를 참조하세요.

  2. 백그라운드에서 가져오기 프로세스 실행

    Amazon Sidewalk용 AWS IoT Core가 가져오기 태스크 요청을 받으면 태스크 설정을 시작하고 시스템을 자주 폴링하는 백그라운드 프로세스를 시작합니다. 백그라운드 프로세스가 가져오기 태스크 지침을 받으면 CSV 파일을 읽기 시작합니다. 동시에 Amazon Sidewalk용 AWS IoT Core는 Amazon Sidewalk로부터 제어 로그가 수신되었는지 확인합니다.

  3. 무선 디바이스 레코드 생성

    Amazon Sidewalk에서 제어 로그를 수신하면 Amazon Sidewalk용 AWS IoT Core는 제어 로그의 일련번호가 CSV 파일의 SMSN 값과 일치하는지 확인합니다. 일련번호가 일치하면 Amazon Sidewalk용 AWS IoT Core는 주어진 일련번호에 해당하는 Sidewalk 디바이스에 대한 무선 디바이스 레코드를 생성하기 시작합니다. 모든 디바이스가 온보딩되면 가져오기 작업이 완료됨으로 표시됩니다.

Sidewalk 대량 프로비저닝의 주요 고려 사항

Sidewalk 디바이스를 Amazon Sidewalk용 AWS IoT Core에 대량으로 프로비저닝할 때 고려해야 할 몇 가지 주요 사항은 다음과 같습니다.

  • 디바이스 프로필을 생성한 AWS 계정에서 AWS IoT 콘솔 또는 Amazon Sidewalk용 AWS IoT Core API 작업을 사용하여 대량 프로비저닝을 수행해야 합니다.

  • Sidewalk 디바이스를 대량 프로비저닝하기 전에 디바이스 프로필에 공장 지원을 나타내는 DAK 정보가 이미 포함되어 있어야 합니다. 그렇지 않으면 AWS IoT 콘솔을 사용한 대량 프로비저닝이나 대량 프로비저닝 API 작업이 실패할 수 있습니다.

  • 가져오기 태스크를 시작한 후 CSV 파일을 처리하고, 무선 디바이스를 가져오고, Amazon Sidewalk용 AWS IoT Core에 온보딩하는 데 최소 10분이 걸릴 수 있습니다.

  • 무선 디바이스 가져오기 작업은 시작되면 90일 동안 실행됩니다. 이 기간 동안 Amazon Sidewalk로부터 제어 로그를 수신했는지 확인합니다. 90일 이전에 Amazon Sidewalk로부터 제어 로그를 받지 못한 경우, 작업 세부 정보를 볼 때 만료되었다는 메시지와 함께 작업이 완료됨으로 표시됩니다. 가져오기 작업에서 제어 로그를 기다리고 있던 디바이스의 온보딩 상태는 실패로 표시됩니다.

  • 이미 생성한 가져오기 작업을 업데이트하려고 시도할 때는 작업에 다른 디바이스를 추가만 할 수 있습니다. 가져오기 작업을 생성한 후 가져오기 작업에 이미 추가된 디바이스에서 작업이 시작되기 전에는 언제든지 새 디바이스를 추가할 수 있습니다. 원래 가져오기 작업에 이미 있는 디바이스의 일련번호가 업데이트 파일에 포함된 경우 해당 일련번호는 무시됩니다.

  • 업데이트 작업을 요청하면 가져오기 작업을 생성할 때 사용한 것과 동일한 IAM 역할이 Amazon S3 버킷의 CSV 파일에 액세스하는 것으로 간주됩니다.

  • 작업이 이미 성공적으로 완료되었거나 작업이 업데이트되지 않은 경우에만 가져오기 작업을 삭제할 수 있습니다. 잘못된 IAM 역할을 제공했거나 Amazon S3 버킷 파일을 찾을 수 없는 경우 작업이 업데이트되지 않을 수 있습니다. 가져오기 작업이 PENDING 상태인 경우 작업을 업데이트하거나 삭제할 수 없습니다.

  • 작업으로 가져오는 CSV 파일은 다음 섹션에 설명된 형식을 사용해야 합니다.

CSV 파일 형식

가져오기 태스크에 지정하는 Amazon S3 버킷에 포함된 CSV 파일은 다음 형식을 사용해야 합니다.

  • 행 1은 키워드 smsn을 사용해야 합니다. 이 키워드는 가져오는 CSV 파일에 가져올 디바이스의 SMSN이 포함되어 있음을 나타냅니다.

  • 2행 이후의 행에는 온보딩할 디바이스의 SMSN을 포함해야 합니다. 디바이스 SMSN은 64자리 16진수 문자 형식이어야 합니다.

이 JSON 파일은 샘플 CSV 파일 형식을 보여줍니다.

smsn
1C1A10B0AC0A200C012BBAC2CBB1B21CB12C0CA2AC1C1BB22CAA01C1B0B01122
B122C2B1121BACA2221001AC1B22012AAC11112C11C2A100C1C2B012A1100C10
02B222C110B0A210B0A0C2C112CCCAC21C1C0B0AA1221AB1022A2CC11B1B1122
C2C021CA1C111CCAB1221C0021C1C2AAA0AA1A2A01ABC10CBAACCA2A0121022A
0CB22C01BBC2CA2C0B11001121ACB2ABB0BB0121C2BA101C012CC2B20C011AC0

Sidewalk 대량 프로비저닝 사용 방법

다음 단계는 Amazon Sidewalk 대량 프로비저닝을 사용하는 방법을 보여줍니다.

  1. 디바이스 일련번호 제공

    Sidewalk 디바이스를 프로비저닝하려면 온보딩할 디바이스의 일련번호를 제공해야 합니다. 다음 방법 중 하나를 사용하여 디바이스를 프로비저닝할 수 있습니다.

    • Sidewalk 제조 일련번호(SMSN)를 사용하여 각 디바이스를 개별적으로 프로비저닝합니다. 이 방법은 적절한 IAM 역할이 포함된 CSV 파일을 업로드하거나 디바이스가 작업에 온보딩할 준비가 될 때까지 기다릴 필요 없이 워크플로를 테스트하고 디바이스를 더 빠르게 온보딩하려는 경우에 유용합니다.

    • CSV 파일에 프로비저닝할 디바이스의 SMSN이 포함된 Amazon S3 버킷 URL을 제공하여 디바이스를 대량으로 프로비저닝합니다. 이 방법은 온보딩할 디바이스의 수량이 많을 때 특히 유용합니다. 이 경우 각 디바이스를 개별적으로 온보딩하는 것은 따분한 일일 수 있습니다. 대신 Amazon S3 버킷에 업로드된 CSV 파일의 경로와 파일에 액세스할 수 있는 IAM 역할만 제공하면 됩니다.

  2. 가져오기 작업 및 디바이스 온보딩 상태 확보

    생성하는 각 가져오기 작업에 대해 작업 온보딩 상태 및 작업에 추가된 디바이스의 온보딩 상태에 대한 정보를 검색할 수 있습니다. 또한 작업 또는 디바이스 온보딩이 실패한 이유와 같은 추가 상태 정보도 볼 수 있습니다. 자세한 내용을 알아보려면 다음 섹션을 참조하세요.

  3. (선택 사항) 가져오기 작업 업데이트 또는 삭제

    이미 생성한 가져오기 작업을 업데이트하거나 삭제할 수 있습니다.

    • 이미 추가된 디바이스에서 태스크가 시작되기 전에 언제든지 가져오기 태스크를 업데이트하고 태스크에 디바이스를 추가할 수 있습니다. Amazon Sidewalk용 AWS IoT Core는 가져오기 태스크를 생성할 때 사용한 역할과 동일한 IAM 역할을 맡습니다. 작업을 생성할 때 작업에 추가하려는 디바이스의 일련번호가 들어 있는 새 CSV 파일을 지정하세요.

      참고

      기존 가져오기 태스크를 업데이트할 때는 태스크에 디바이스를 추가만 할 수 있습니다. Amazon Sidewalk용 AWS IoT Core는 이미 가져오기 태스크에 있는 디바이스와 태스크에 추가하려는 디바이스 간에 통합 태스크를 수행합니다. 가져오기 작업에 이미 있는 디바이스의 일련번호가 새로운 파일에 포함된 경우 해당 일련번호는 무시됩니다.

    • 이미 성공적으로 완료된 가져오기 작업이나 IAM 역할 정보가 잘못된 경우 또는 작업을 생성하거나 업데이트할 때 S3 버킷 파일을 사용할 수 없는 경우 업데이트가 실패한 가져오기 작업을 삭제할 수 있습니다.

주제