

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# OTA(Over-the-Air) 업데이트 데모 애플리케이션
<a name="ota-demo"></a>

FreeRTOS에는 무선 업데이트(OTA) 라이브러리의 기능을 시연하는 데모 애플리케이션이 포함되어 있습니다. OTA 데모 애플리케이션은 `freertos/demos/ota/ota_demo_core_mqtt/ota_demo_core_mqtt.c` 또는 `freertos/demos/ota/ota_demo_core_http/ota_demo_core_http.c` 파일에 위치합니다.

OTA 데모 애플리케이션은 다음을 수행합니다.

1. FreeRTOS 네트워크 스택과 MQTT 버퍼 풀을 초기화합니다.

1. `vRunOTAUpdateDemo()`를 사용하여 OTA 라이브러리 연습을 위한 태스크를 생성합니다.

1. `_establishMqttConnection()`를 사용하여 MQTT 클라이언트를 생성합니다.

1. 를 사용하여 AWS IoT MQTT 브로커에 연결하고 MQTT 연결 해제 콜백을 `IotMqtt_Connect()` 등록합니다`prvNetworkDisconnectCallback`.

1. `OTA_AgentInit()`를 호출하여 OTA 작업을 생성하고, OTA 작업이 완료될 때 사용할 콜백을 등록합니다.

1. `xOTAConnectionCtx.pvControlClient = _mqttConnection;`을 사용하여 MQTT 연결을 재사용합니다.

1. MQTT 연결이 끊어지면 애플리케이션은 OTA 에이전트를 일시 중단하고 지수 지연 및 지터를 사용하여 재연결을 시도한 다음 OTA 에이전트를 다시 시작합니다.

OTA 업데이트를 사용하려면 먼저 [FreeRTOS 무선 업데이트(OTA)](freertos-ota-dev.md)에 명시된 모든 사전 조건을 완료해야 합니다.

OTA 업데이트를 위한 설정을 완료한 경우 OTA 기능을 지원하는 플랫폼에서 FreeRTOS OTA 데모를 다운로드, 빌드, 플래시 및 실행합니다. 디바이스별 데모 지침은 다음 FreeRTOS 적격 디바이스에서 사용할 수 있습니다.
+ [Texas Instruments CC3220SF-LAUNCHXL](download-ota-ti.md)
+ [Microchip Curiosity PIC32MZEF](download-ota-mchip.md)
+ [Espressif ESP32](download-ota-esp.md)
+ [Renesas RX65N에서 FreeRTOS OTA 데모를 다운로드, 빌드, 플래시, 실행합니다.](download-rx65n-ota.md)

디바이스에서 OTA 데모 애플리케이션을 빌드, 플래시 및 실행한 후 AWS IoT 콘솔 또는를 사용하여 OTA 업데이트 작업을 AWS CLI 생성할 수 있습니다. OTA 업데이트 작업을 생성했으면, 터미널 에뮬레이터를 연결하여 OTA 업데이트의 진행 상황을 확인합니다. 프로세스 중에 발생한 오류를 기록해 둡니다.

OTA 업데이트 작업이 성공하면 다음과 같은 출력이 표시됩니다. 간결하게 하기 위해 이 예제에서는 일부 행을 목록에서 제거했습니다.

```
    249 21207 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    250 21247 [MQTT Agent Task] [core_mqtt.c:886] [INFO] [MQTT] Packet received. ReceivedBytes=601.
    251 21247 [MQTT Agent Task] [core_mqtt.c:1045] [INFO] [MQTT] De-serialized incoming PUBLISH packet: DeserializerResult=MQTTSuccess.
    252 21248 [MQTT Agent Task] [core_mqtt.c:1058] [INFO] [MQTT] State record updated. New state=MQTTPubAckSend.
    253 21249 [MQTT Agent Task] [ota_demo_core_mqtt.c:976] [INFO] [MQTT] Received job message callback, size 548.
    254 21252 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[execution.jobId: AFR_OTA-9702f1a3-b747-4c3e-a0eb-a3b0cf83ddbb]
    255 21253 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[execution.jobDocument.afr_ota.streamname: AFR_OTA-945d320b-a18b-441b-b435-4a18d4e7671f]
    256 21255 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[execution.jobDocument.afr_ota.protocols: ["MQTT"]]
    257 21256 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[filepath: aws_demos.bin]
    258 21257 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[filesize: 1164016]
    259 21258 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[fileid: 0]
    260 21259 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[certfile: ecdsa-sha256-signer.crt.pem]
    261 21260 [OTA Agent Task] [ota.c:1575] [INFO] [OTA] Extracted parameter [ sig-sha256-ecdsa: MEQCIE1SFkIHHiZAvkPpu6McJtx7SYoD... ]
    262 21261 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[fileType: 0]
    263 21262 [OTA Agent Task] [ota.c:2199] [INFO] [OTA] Job document was accepted. Attempting to begin the update.
    264 21263 [OTA Agent Task] [ota.c:2323] [INFO] [OTA] Job parsing success: OtaJobParseErr_t=OtaJobParseErrNone, Job name=AFR_OTA-9702f1a3-b747-4c3e-a0eb-a3b0cf83ddbb
    265 21318 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    266 21418 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    267 21469 [OTA Agent Task] [ota.c:938] [INFO] [OTA] Setting OTA data interface.
    268 21470 [OTA Agent Task] [ota.c:2839] [INFO] [OTA] Current State=[CreatingFile], Event=[ReceivedJobDocument], New state=[CreatingFile]
    269 21482 [MQTT Agent Task] [core_mqtt.c:886] [INFO] [MQTT] Packet received. ReceivedBytes=3.
    270 21483 [OTA Agent Task] [ota_demo_core_mqtt.c:1503] [INFO] [MQTT] SUBSCRIBED to topic $aws/things/__test_infra_thing71/streams/AFR_OTA-945d320b-a18b-441b-b435-4a18d4e7671f/data/cbor to bro
    271 21484 [OTA Agent Task] [ota.c:2839] [INFO] [OTA] Current State=[RequestingFileBlock], Event=[CreateFile], New state=[RequestingFileBlock]
    272 21518 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    273 21532 [MQTT Agent Task] [core_mqtt_agent_command_functions.c:76] [INFO] [MQTT] Publishing message to $aws/things/__test_infra_thing71/streams/AFR_OTA-945d320b-a18b-441b-b435-4a18d4e7671f/
    274 21534 [OTA Agent Task] [ota_demo_core_mqtt.c:1553] [INFO] [MQTT] Sent PUBLISH packet to broker $aws/things/__test_infra_thing71/streams/AFR_OTA-945d320b-a18b-441b-b435-4a18d4e7671f/get/cbor
    275 21534 [OTA Agent Task] [ota_mqtt.c:1112] [INFO] [OTA] Published to MQTT topic to request the next block: topic=$aws/things/__test_infra_thing71/streams/AFR_OTA-945d320b-a18b-441b-b435-4a1
    276 21537 [OTA Agent Task] [ota.c:2839] [INFO] [OTA] Current State=[WaitingForFileBlock], Event=[RequestFileBlock], New state=[WaitingForFileBlock]
    277 21558 [MQTT Agent Task] [core_mqtt.c:886] [INFO] [MQTT] Packet received. ReceivedBytes=4217.
    278 21559 [MQTT Agent Task] [core_mqtt.c:1045] [INFO] [MQTT] De-serialized incoming PUBLISH packet: DeserializerResult=MQTTSuccess.
    279 21560 [MQTT Agent Task] [core_mqtt.c:1058] [INFO] [MQTT] State record updated. New state=MQTTPublishDone.
    280 21561 [MQTT Agent Task] [ota_demo_core_mqtt.c:1026] [INFO] [MQTT] Received data message callback, size 4120.
    281 21563 [OTA Agent Task] [ota.c:2464] [INFO] [OTA] Received valid file block: Block index=0, Size=4096
    282 21566 [OTA Agent Task] [ota.c:2683] [INFO] [OTA] Number of blocks remaining: 284
     
    ... // Output removed for brevity
     
    3672 42745 [OTA Agent Task] [ota.c:2464] [INFO] [OTA] Received valid file block: Block index=284, Size=752
    3673 42747 [OTA Agent Task] [ota.c:2633] [INFO] [OTA] Received final block of the update.
    (428298) ota_pal: No such certificate file: ecdsa-sha256-signer.crt.pem. Using certificate in ota_demo_config.h.
    3674 42818 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 285   Queued: 285   Processed: 284   Dropped: 0
    3675 42918 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 285   Queued: 285   Processed: 284   Dropped: 0
     
    ... // Output removed for brevity
     
    3678 43197 [OTA Agent Task] [ota.c:2654] [INFO] [OTA] Received entire update and validated the signature.
    3685 43215 [OTA Agent Task] [ota_demo_core_mqtt.c:862] [INFO] [MQTT] Received OtaJobEventActivate callback from OTA Agent.
     
    ... // Output removed for brevity
     
    2 39 [iot_thread] [INFO ][DEMO][390] ---------STARTING DEMO---------
     
    [0;32mI (3633) WIFI: WIFI_EVENT_STA_CONNECTED
    [0;32mI (4373) WIFI: SYSTEM_EVENT_STA_GOT_IP
     
    ... // Output removed for brevity 
     
    4 351 [sys_evt] [INFO ][DEMO][3510] Connected to WiFi access point, ip address: 255.255.255.0.
    5 351 [iot_thread] [INFO ][DEMO][3510] Successfully initialized the demo. Network type for the demo: 1
    6 351 [iot_thread] [ota_demo_core_mqtt.c:1902] [INFO] [MQTT] OTA over MQTT demo, Application version 0.9.1
    7 351 [iot_thread] [ota_demo_core_mqtt.c:1323] [INFO] [MQTT] Creating a TLS connection to <endpoint>-ats.iot.us-west-2.amazonaws.com:8883.
    9 718 [iot_thread] [core_mqtt.c:886] [INFO] [MQTT] Packet received. ReceivedBytes=2.
    10 718 [iot_thread] [core_mqtt_serializer.c:970] [INFO] [MQTT] CONNACK session present bit not set.
    11 718 [iot_thread] [core_mqtt_serializer.c:912] [INFO] [MQTT] Connection accepted.
     
    ... // Output removed for brevity
     
    17 736 [OTA Agent Task] [ota_demo_core_mqtt.c:1503] [INFO] [MQTT] SUBSCRIBED to topic $aws/things/__test_infra_thing71/jobs/notify-next to broker.
    18 737 [OTA Agent Task] [ota_mqtt.c:381] [INFO] [OTA] Subscribed to MQTT topic: $aws/things/__test_infra_thing71/jobs/notify-next
    30 818 [iot_thread] [ota_demo_core_mqtt.c:1850] [INFO] [MQTT]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    31 819 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[execution.jobId: AFR_OTA-9702f1a3-b747-4c3e-a0eb-a3b0cf83ddbb]
    32 820 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[execution.statusDetails.updatedBy: 589824]
    33 822 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[execution.jobDocument.afr_ota.streamname: AFR_OTA-945d320b-a18b-441b-b435-4a18d4e7671f]
    34 823 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[execution.jobDocument.afr_ota.protocols: ["MQTT"]]
    35 824 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[filepath: aws_demos.bin]
    36 825 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[filesize: 1164016]
    37 826 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[fileid: 0]
    38 827 [OTA Agent Task] [ota.c:1645] [INFO] [OTA] Extracted parameter: [key: value]=[certfile: ecdsa-sha256-signer.crt.pem]
    39 828 [OTA Agent Task] [ota.c:1575] [INFO] [OTA] Extracted parameter [ sig-sha256-ecdsa: MEQCIE1SFkIHHiZAvkPpu6McJtx7SYoD... ]
    40 829 [OTA Agent Task] [ota.c:1684] [INFO] [OTA] Extracted parameter: [key: value]=[fileType: 0]
    41 830 [OTA Agent Task] [ota.c:2102] [INFO] [OTA] In self test mode.
    42 830 [OTA Agent Task] [ota.c:1936] [INFO] [OTA] New image has a higher version number than the current image: New image version=0.9.1, Previous image version=0.9.0
    43 832 [OTA Agent Task] [ota.c:2120] [INFO] [OTA] Image version is valid: Begin testing file: File ID=0
    53 896 [OTA Agent Task] [ota.c:794] [INFO] [OTA] Beginning self-test.
    62 971 [OTA Agent Task] [ota_demo_core_mqtt.c:1553] [INFO] [MQTT] Sent PUBLISH packet to broker $aws/things/__test_infra_thing71/jobs/AFR_OTA-9702f1a3-b747-4c3e-a0eb-a3b0cf83ddbb/update to br63 971 [MQTT Agent Task] [core_mqtt.c:1045] [INFO] [MQTT] De-serialized incoming PUBLISH packet: DeserializerResult=MQTTSuccess.
    65 973 [MQTT Agent Task] [core_mqtt.c:1058] [INFO] [MQTT] State record updated. New state=MQTTPublishDone.
    64 973 [OTA Agent Task] [ota_demo_core_mqtt.c:902] [INFO] [MQTT] Successfully updated with the new image.
```

# 무선(OTA) 데모 구성
<a name="ota-demo-specific-config"></a>

OTA 데모 구성은 `aws_iot_ota_update_demo.c`에서 제공하는 데모별 구성 옵션입니다. 이러한 구성은 OTA 라이브러리 구성 파일에 제공된 OTA 라이브러리 구성과 다릅니다.

**OTA\$1DEMO\$1KEEP\$1ALIVE\$1SECONDS**  
MQTT 클라이언트의 경우 이 구성은 한 제어 패킷의 전송을 완료한 후 다음 제어 패킷의 전송을 시작하는 데 소요될 수 있는 최대 시간 간격입니다. 제어 패킷이 없는 경우 PINGREQ가 전송됩니다. 브로커는 이 유지 기간의 1.5배 이내에 메시지 또는 PINGREQ 패킷을 전송하지 않는 클라이언트와의 연결을 끊어야 합니다. 이 구성은 애플리케이션의 요구 사항에 따라 조정해야 합니다.

**OTA\$1DEMO\$1CONN\$1RETRY\$1BASE\$1INTERVAL\$1SECONDS**  
네트워크 연결을 재시도하기 전의 기본 간격(초)입니다. OTA 데모는 이 기본 시간 간격 이후에 재연결을 시도합니다. 시도가 실패할 때마다 간격이 두 배로 늘어납니다. 이 기본 지연의 최대값까지의 임의 지연도 간격에 추가됩니다.

**OTA\$1DEMO\$1CONN\$1RETRY\$1MAX\$1INTERVAL\$1SECONDS**  
네트워크 연결을 재시도하기 전의 최대 간격(초)입니다. 재연결 지연은 시도가 실패할 때마다 두 배로 늘어나지만 이 최대값에 같은 간격의 지터를 더한 값까지만 지연될 수 있습니다.

# Texas Instruments CC3220SF-LAUNCHXL에 대한 FreeRTOS OTA 데모 다운로드, 빌드, 플래시 및 실행
<a name="download-ota-ti"></a>

**중요**  <a name="deprecation-message"></a>
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.<a name="download-demo"></a>

**FreeRTOS 및 OTA 데모 코드를 다운로드하려면**
+ GitHub 사이트 [https://github.com/FreeRTOS/FreeRTOS](https://github.com/FreeRTOS/FreeRTOS)에서 소스 코드를 다운로드할 수 있습니다.<a name="build-demo"></a>

**데모 애플리케이션을 빌드하려면**

1. 의 지침에 따라 `aws_demos` 프로젝트를 Code Composer Studio로 가져오[FreeRTOS 시작하기](freertos-getting-started.md)고, AWS IoT 엔드포인트, Wi-Fi SSID 및 암호, 보드의 프라이빗 키 및 인증서를 구성합니다.

1.  `freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`를 열고 `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED`를 주석으로 처리한 다음 `CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED` 또는 `CONFIG_OTA_HTTP_UPDATE_DEMO_ENABLED`를 정의합니다.

1. 솔루션을 빌드하고 오류 없이 빌드되는지 확인합니다.

1. 터미널 에뮬레이터를 시작하고 다음 설정을 사용하여 보드에 연결합니다.
   + 전송 속도: 115200
   + 데이터 비트: 8
   + 패리티: 없음
   + 정지 비트: 1

1. 보드에서 프로젝트를 실행하여 Wi-Fi 및 AWS IoT MQTT 메시지 브로커에 연결할 수 있는지 확인합니다.

실행되면 터미널 에뮬레이터에 다음과 같은 텍스트가 표시됩니다.

```
    0 1000 [Tmr Svc] Simple Link task created
    Device came up in Station mode
    1 2534 [Tmr Svc] Write certificate...
    2 5486 [Tmr Svc] [ERROR] Failed to destroy object. PKCS11_PAL_DestroyObject failed.
    3 5486 [Tmr Svc] Write certificate...
    4 5776 [Tmr Svc] Security alert threshold = 15
    5 5776 [Tmr Svc] Current number of alerts = 1
    6 5778 [Tmr Svc] Running Demos.
    7 5779 [iot_thread] [INFO ][DEMO][5779] ---------STARTING DEMO---------
    8 5779 [iot_thread] [INFO ][INIT][5779] SDK successfully initialized.
    Device came up in Station mode
    [WLAN EVENT] STA Connected to the AP: afrlab-pepper , BSSID: 74:83:c2:b4:46:27
    [NETAPP EVENT] IP acquired by the device
    Device has connected to afrlab-pepper
    Device IP Address is 192.168.36.176 
    9 8283 [iot_thread] [INFO ][DEMO][8282] Successfully initialized the demo. Network type for the demo: 1
    10 8283 [iot_thread] [INFO] OTA over MQTT demo, Application version 0.9.0
    11 8283 [iot_thread] [INFO] Creating a TLS connection to <endpoint>-ats.iot.us-west-2.amazonaws.com:8883.
    12 8852 [iot_thread] [INFO] Creating an MQTT connection to <endpoint>-ats.iot.us-west-2.amazonaws.com.
    13 8914 [iot_thread] [INFO] Packet received. ReceivedBytes=2.
    14 8914 [iot_thread] [INFO] CONNACK session present bit not set.
    15 8914 [iot_thread] [INFO] Connection accepted.
    16 8914 [iot_thread] [INFO] Received MQTT CONNACK successfully from broker.
    17 8914 [iot_thread] [INFO] MQTT connection established with the broker.
    18 8915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    19 8953 [OTA Agent T] [INFO] Current State=[RequestingJob], Event=[Start], New state=[RequestingJob]
    20 9008 [MQTT Agent ] [INFO] Packet received. ReceivedBytes=3.
    21 9015 [OTA Agent T] [INFO] SUBSCRIBED to topic $aws/things/__test_infra_thing73/jobs/notify-next to broker.
    22 9015 [OTA Agent T] [INFO] Subscribed to MQTT topic: $aws/things/__test_infra_thing73/jobs/notify-next
    23 9504 [MQTT Agent ] [INFO] Publishing message to $aws/things/__test_infra_thing73/jobs/$next/get.
    24 9535 [MQTT Agent ] [INFO] Packet received. ReceivedBytes=2.
    25 9535 [MQTT Agent ] [INFO] Ack packet deserialized with result: MQTTSuccess.
    26 9536 [MQTT Agent ] [INFO] State record updated. New state=MQTTPublishDone.
    27 9537 [OTA Agent T] [INFO] Sent PUBLISH packet to broker $aws/things/__test_infra_thing73/jobs/$next/get to broker.
    28 9537 [OTA Agent T] [WARN] OTA Timer handle NULL for Timerid=0, can't stop.
    29 9537 [OTA Agent T] [INFO] Current State=[WaitingForJob], Event=[RequestJobDocument], New state=[WaitingForJob]
    30 9539 [MQTT Agent ] [INFO] Packet received. ReceivedBytes=120.
    31 9539 [MQTT Agent ] [INFO] De-serialized incoming PUBLISH packet: DeserializerResult=MQTTSuccess.
    32 9540 [MQTT Agent ] [INFO] State record updated. New state=MQTTPublishDone.
    33 9540 [MQTT Agent ] [INFO] Received job message callback, size 62.
    34 9616 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=execution
    35 9616 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=execution.jobId
    36 9617 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=execution.jobDocument
    37 9617 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=execution.jobDocument.afr_ota
    38 9617 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=execution.jobDocument.afr_ota.protocols
    39 9618 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=execution.jobDocument.afr_ota.files
    40 9618 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=filesize
    41 9618 [OTA Agent T] [INFO] Failed job document content check: Required job document parameter was not extracted: parameter=fileid
    42 9619 [OTA Agent T] [INFO] Failed to parse JSON document as AFR_OTA job: DocParseErr_t=7
    43 9619 [OTA Agent T] [INFO] No active job available in received job document: OtaJobParseErr_t=OtaJobParseErrNoActiveJobs
    44 9619 [OTA Agent T] [ERROR] Failed to execute state transition handler: Handler returned error: OtaErr_t=OtaErrJobParserError
    45 9620 [OTA Agent T] [INFO] Current State=[WaitingForJob], Event=[ReceivedJobDocument], New state=[CreatingFile]
    46 9915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    47 10915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    48 11915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    49 12915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    50 13915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
    51 14915 [iot_thread] [INFO]  Received: 0   Queued: 0   Processed: 0   Dropped: 0
```

# Microchip Curiosity PIC32MZEF에 대한 FreeRTOS OTA 데모 다운로드, 빌드, 플래시 및 실행
<a name="download-ota-mchip"></a>

**중요**  <a name="deprecation-message"></a>
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.

**참고**  
Microchip의 합의에 따라 AWS는 FreeRTOS 참조 통합 리포지토리 메인 브랜치에서 Curiosity PIC32MZEF(DM320104)를 제거하고 새 릴리스에는 더 이상 제공하지 않을 예정입니다. Microchip은 PIC32MZEF(DM320104)를 더 이상 새로운 설계에 사용하지 않는 것이 좋다는 [공지문](https://www.microchip.com/DevelopmentTools/ProductDetails/PartNO/DM320104)을 발표했습니다. PIC32MZEF 프로젝트 및 소스 코드는 이전 릴리스 태그를 통해 계속 액세스할 수 있습니다. Microchip은 고객이 새로운 설계에 Curiosity [PIC32MZ-EF-2.0 개발 보드(DM320209)](https://devices.amazonaws.com/detail/a3G0h0000077I69EAE/Curiosity-PIC32MZ-EF-2-0-Development-Board)를 사용할 것을 권장합니다. PIC32MZv1 플랫폼은 FreeRTOS 참조 통합 리포지토리의 [v202012.00](https://github.com/aws/amazon-freertos/tree/202012.00)에서 계속 찾을 수 있습니다. 그러나 FreeRTOS 참조의 [v202107.00](https://github.com/aws/amazon-freertos/tree/202107.00)에서는 이 플랫폼을 더 이상 지원하지 않습니다.<a name="mch-dowload-demo"></a>

**FreeRTOS OTA 데모 코드를 다운로드하려면**
+ GitHub 사이트 [https://github.com/FreeRTOS/FreeRTOS](https://github.com/FreeRTOS/FreeRTOS)에서 소스 코드를 다운로드할 수 있습니다.<a name="mch-build-demo"></a>

**OTA 업데이트 데모 애플리케이션을 빌드하려면**

1. 의 지침에 따라 `aws_demos` 프로젝트를 MPLAB X IDE로 [FreeRTOS 시작하기](freertos-getting-started.md) 가져오고, AWS IoT 엔드포인트, Wi-Fi SSID 및 암호, 보드용 프라이빗 키 및 인증서를 구성합니다.

1. `vendors/vendor/boards/board/aws_demos/config_files/ota_demo_config.h` 파일을 열고 인증서를 입력합니다.

   ```
   [] = "your-certificate-key";
   ```

1. 코드 서명 인증서의 내용을 여기에 붙여넣습니다.

   ```
   #define otapalconfigCODE_SIGNING_CERTIFICATE [] = "your-certificate-key";
   ```

   `aws_clientcredential_keys.h`와 동일한 형식에 따릅니다. 각 줄은 줄 바꿈 문자('\$1n')로 끝나고 따옴표로 묶여 있어야 합니다.

   예를 들어, 인증서는 다음과 비슷합니다.

   ```
   "-----BEGIN CERTIFICATE-----\n"
   "MIIBXTCCAQOgAwIBAgIJAM4DeybZcTwKMAoGCCqGSM49BAMCMCExHzAdBgNVBAMM\n"
   "FnRlc3Rf62lnbmVyQGFtYXpvbi5jb20wHhcNMTcxMTAzMTkxODM1WhcNMTgxMTAz\n"
   "MTkxODM2WjAhMR8wHQYDVQBBZZZ0ZXN0X3NpZ25lckBhbWF6b24uY29tMFkwEwYH\n"
   "KoZIzj0CAQYIKoZIzj0DAQcDQgAERavZfvwL1X+E4dIF7dbkVMUn4IrJ1CAsFkc8\n"
   "gZxPzn683H40XMKltDZPEwr9ng78w9+QYQg7ygnr2stz8yhh06MkMCIwCwYDVR0P\n"
   "BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMDMAoGCCqGSM49BAMCA0gAMEUCIF0R\n"
   "r5cb7rEUNtWOvGd05MacrgOABfSoVYvBOK9fP63WAqt5h3BaS123coKSGg84twlq\n"
   "TkO/pV/xEmyZmZdV+HxV/OM=\n"
   "-----END CERTIFICATE-----\n";
   ```

1. [Python 3](https://www.python.org/downloads/) 이상을 설치합니다.

1. `pip install pyopenssl`을 실행하여 `pyOpenSSL`을 설치합니다.

1. 코드 서명 인증서를 `demos/ota/bootloader/utility/codesigner_cert_utility/` 경로에 .pem 형식으로 복사합니다. 인증서 파일의 이름을 `aws_ota_codesigner_certificate.pem`으로 바꿉니다.

1.  `freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`를 열고 `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED`를 주석으로 처리한 다음 `CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED` 또는 `CONFIG_OTA_HTTP_UPDATE_DEMO_ENABLED`를 정의합니다.

1. 솔루션을 빌드하고 오류 없이 빌드되는지 확인합니다.

1. 터미널 에뮬레이터를 시작하고 다음 설정을 사용하여 보드에 연결합니다.
   + 전송 속도: 115200
   + 데이터 비트: 8
   + 패리티: 없음
   + 정지 비트: 1

1. 보드에서 디버거를 분리하고 보드에서 프로젝트를 실행하여 Wi-Fi 및 AWS IoT MQTT 메시지 브로커에 연결할 수 있는지 확인합니다.

프로젝트를 실행할 때 MPLAB X IDE에서 출력 창을 열어야 합니다. **ICD4** 탭이 선택되는지 확인합니다. 다음과 같이 출력되어야 합니다.

```
Bootloader version 00.09.00
[prvBOOT_Init] Watchdog timer initialized.
[prvBOOT_Init] Crypto initialized.

[prvValidateImage] Validating image at Bank : 0
[prvValidateImage] No application image or magic code present at: 0xbd000000
[prvBOOT_ValidateImages] Validation failed for image at 0xbd000000

[prvValidateImage] Validating image at Bank : 1
[prvValidateImage] No application image or magic code present at: 0xbd100000
[prvBOOT_ValidateImages] Validation failed for image at 0xbd100000

[prvBOOT_ValidateImages] Booting default image.


>0 36246 [IP-task] vDHCPProcess: offer ac140a0eip
                                                 1 36297 [IP-task] vDHCPProcess: offer ac140a0eip
                 2 36297 [IP-task]

IP Address: 172.20.10.14
3 36297 [IP-task] Subnet Mask: 255.255.255.240
4 36297 [IP-task] Gateway Address: 172.20.10.1
5 36297 [IP-task] DNS Server Address: 172.20.10.1


6 36299 [OTA] OTA demo version 0.9.2
7 36299 [OTA] Creating MQTT Client...
8 36299 [OTA] Connecting to broker...
9 38673 [OTA] Connected to broker.
10 38793 [OTA Task] [prvSubscribeToJobNotificationTopics] OK: $aws/things/devthingota/jobs/$next/get/accepted
11 38863 [OTA Task] [prvSubscribeToJobNotificationTopics] OK: $aws/things/devthingota/jobs/notify-next
12 38863 [OTA Task] [OTA_CheckForUpdate] Request #0
13 38964 [OTA] [OTA_AgentInit] Ready.
14 38973 [OTA Task] [prvParseJSONbyModel] Extracted parameter [ clientToken: 0:devthingota ]
15 38973 [OTA Task] [prvParseJSONbyModel] parameter not present: execution
16 38973 [OTA Task] [prvParseJSONbyModel] parameter not present: jobId
17 38973 [OTA Task] [prvParseJSONbyModel] parameter not present: jobDocument
18 38973 [OTA Task] [prvParseJSONbyModel] parameter not present: streamname
19 38973 [OTA Task] [prvParseJSONbyModel] parameter not present: files
20 38975 [OTA Task] [prvParseJSONbyModel] parameter not present: filepath
21 38975 [OTA Task] [prvParseJSONbyModel] parameter not present: filesize
22 38975 [OTA Task] [prvParseJSONbyModel] parameter not present: fileid
23 38975 [OTA Task] [prvParseJSONbyModel] parameter not present: certfile
24 38975 [OTA Task] [prvParseJSONbyModel] parameter not present: sig-sha256-ecdsa
25 38975 [OTA Task] [prvParseJobDoc] Ignoring job without ID.
26 38975 [OTA Task] [prvOTA_Close] Context->0x8003b620
27 38975 [OTA Task] [prvPAL_Abort] Abort - OK
28 39964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
29 40964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
30 41964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
31 42964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
32 43964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
33 44964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
34 45964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
35 46964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
36 47964 [OTA] State: Ready  Received: 1   Queued: 1   Processed: 1   Dropped: 0
```

터미널 에뮬레이터에 다음과 같은 텍스트가 표시됩니다.

```
AWS Validate: no valid signature in descr: 0xbd000000
AWS Validate: no valid signature in descr: 0xbd100000


>AWS Launch:  No Map performed. Running directly from address: 0x9d000020?
AWS Launch:  wait for app at: 0x9d000020
WILC1000: Initializing...
0 0 

>[None] Seed for randomizer: 1172751941
1 0 [None] Random numbers: 00004272 00003B34 00000602 00002DE3
Chip ID 1503a0

[spi_cmd_rsp][356][nmi spi]: Failed cmd response read, bus error...

[spi_read_reg][1086][nmi spi]: Failed cmd response, read reg (0000108c)...

[spi_read_reg][1116]Reset and retry 10 108c

Firmware ver. : 4.2.1

Min driver ver : 4.2.1

Curr driver ver: 4.2.1

WILC1000: Initialization successful!

Start Wi-Fi Connection...
Wi-Fi Connected
2 7219 [IP-task] vDHCPProcess: offer c0a804beip
3 7230 [IP-task] vDHCPProcess: offer c0a804beip
4 7230 [IP-task] 

IP Address: 192.168.4.190
5 7230 [IP-task] Subnet Mask: 255.255.240.0
6 7230 [IP-task] Gateway Address: 192.168.0.1
7 7230 [IP-task] DNS Server Address: 208.67.222.222


8 7232 [OTA] OTA demo version 0.9.0
9 7232 [OTA] Creating MQTT Client...
10 7232 [OTA] Connecting to broker...
11 7232 [OTA] Sending command to MQTT task.
12 7232 [MQTT] Received message 10000 from queue.
13 8501 [IP-task] Socket sending wakeup to MQTT task.
14 10207 [MQTT] Received message 0 from queue.
15 10256 [IP-task] Socket sending wakeup to MQTT task.
16 10256 [MQTT] Received message 0 from queue.
17 10256 [MQTT] MQTT Connect was accepted. Connection established.
18 10256 [MQTT] Notifying task.
19 10257 [OTA] Command sent to MQTT task passed.
20 10257 [OTA] Connected to broker.
21 10258 [OTA Task] Sending command to MQTT task.
22 10258 [MQTT] Received message 20000 from queue.
23 10306 [IP-task] Socket sending wakeup to MQTT task.
24 10306 [MQTT] Received message 0 from queue.
25 10306 [MQTT] MQTT Subscribe was accepted. Subscribed.
26 10306 [MQTT] Notifying task.
27 10307 [OTA Task] Command sent to MQTT task passed.
28 10307 [OTA Task] [OTA] Subscribed to topic: $aws/things/Microchip/jobs/$next/get/accepted

29 10307 [OTA Task] Sending command to MQTT task.
30 10307 [MQTT] Received message 30000 from queue.
31 10336 [IP-task] Socket sending wakeup to MQTT task.
32 10336 [MQTT] Received message 0 from queue.
33 10336 [MQTT] MQTT Subscribe was accepted. Subscribed.
34 10336 [MQTT] Notifying task.
35 10336 [OTA Task] Command sent to MQTT task passed.
36 10336 [OTA Task] [OTA] Subscribed to topic: $aws/things/Microchip/jobs/notify-next

37 10336 [OTA Task] [OTA] Check For Update #0
38 10336 [OTA Task] Sending command to MQTT task.
39 10336 [MQTT] Received message 40000 from queue.
40 10366 [IP-task] Socket sending wakeup to MQTT task.
41 10366 [MQTT] Received message 0 from queue.
42 10366 [MQTT] MQTT Publish was successful.
43 10366 [MQTT] Notifying task.
44 10366 [OTA Task] Command sent to MQTT task passed.
45 10376 [IP-task] Socket sending wakeup to MQTT task.
46 10376 [MQTT] Received message 0 from queue.
47 10376 [OTA Task] [OTA] Set job doc parameter [ clientToken: 0:Microchip ]
48 10376 [OTA Task] [OTA] Missing job parameter: execution
49 10376 [OTA Task] [OTA] Missing job parameter: jobId
50 10376 [OTA Task] [OTA] Missing job parameter: jobDocument
51 10378 [OTA Task] [OTA] Missing job parameter: ts_ota
52 10378 [OTA Task] [OTA] Missing job parameter: files
53 10378 [OTA Task] [OTA] Missing job parameter: streamname
54 10378 [OTA Task] [OTA] Missing job parameter: certfile
55 10378 [OTA Task] [OTA] Missing job parameter: filepath
56 10378 [OTA Task] [OTA] Missing job parameter: filesize
57 10378 [OTA Task] [OTA] Missing job parameter: sig-sha256-ecdsa
58 10378 [OTA Task] [OTA] Missing job parameter: fileid
59 10378 [OTA Task] [OTA] Missing job parameter: attr
60 10378 [OTA Task] [OTA] Returned buffer to MQTT Client.
61 11367 [OTA] [OTA] Queued: 1   Processed: 1   Dropped: 0
62 12367 [OTA] [OTA] Queued: 1   Processed: 1   Dropped: 0
63 13367 [OTA] [OTA] Queued: 1   Processed: 1   Dropped: 0
64 14367 [OTA] [OTA] Queued: 1   Processed: 1   Dropped: 0
65 15367 [OTA] [OTA] Queued: 1   Processed: 1   Dropped: 0
66 16367 [OTA] [OTA] Queued: 1   Processed: 1   Dropped: 0
```

이 출력은 Microchip Curiosity PIC32MZEF가 OTA 업데이트에 필요한 MQTT 주제에 연결하고 AWS IoT 구독할 수 있음을 보여줍니다. 대기 중인 OTA 업데이트 작업이 없으므로 `Missing job parameter` 메시지가 필요합니다.

# Espressif ESP32에 대한 FreeRTOS OTA 데모 다운로드, 빌드, 플래시 및 실행
<a name="download-ota-esp"></a>

**중요**  <a name="deprecation-message"></a>
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.

1. [GitHub](https://github.com/aws/amazon-freertos)에서 FreeRTOS 소스를 다운로드합니다. 자세한 내용은 [README.md](https://github.com/aws/amazon-freertos/blob/main/README.md) 파일을 참조하십시오. 모든 필요한 소스와 라이브러리가 포함된 IDE에서 프로젝트를 생성합니다.

1. [Espressif 시작하기](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_espressif.html)의 지침에 따라 필요한 GCC 기반 도구 체인을 설정합니다.

1. `freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`를 열고 `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED`를 주석으로 처리한 다음 `CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED` 또는 `CONFIG_OTA_HTTP_UPDATE_DEMO_ENABLED`를 정의합니다.

1. `vendors/espressif/boards/esp32/aws_demos` 디렉터리에서 `make`를 실행하여 데모 프로젝트를 빌드합니다. [Espressif 시작하기](https://docs.aws.amazon.com/freertos/latest/userguide/getting_started_espressif.html)에 설명된 대로 `make flash monitor`를 실행하여 데모 프로그램을 플래시하고 출력을 확인할 수 있습니다.

1. OTA 업데이트 데모를 실행하기 전에:
   + `freertos/vendors/vendor/boards/board/aws_demos/config_files/aws_demo_config.h`를 열고 `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED`를 주석으로 처리한 다음 `CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED` 또는 `CONFIG_OTA_HTTP_UPDATE_DEMO_ENABLED`를 정의합니다.
   + `vendors/vendor/boards/board/aws_demos/config_files/ota_demo_config.h`를 열고 다음 위치에서 SHA-256/ECDSA 코드 서명 인증서를 복사합니다.

     ```
     #define otapalconfigCODE_SIGNING_CERTIFICATE [] = "your-certificate-key";
     ```

# Renesas RX65N에서 FreeRTOS OTA 데모를 다운로드, 빌드, 플래시, 실행합니다.
<a name="download-rx65n-ota"></a>

**중요**  <a name="deprecation-message"></a>
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.

이 장에서는 Renesas RX65N에서 FreeRTOS OTA 데모 애플리케이션을 다운로드, 빌드, 플래시, 실행하는 방법을 보여줍니다.

**Topics**
+ [운영 환경 설정](#download-rx65n-ota-environment)
+ [AWS 리소스 설정](#download-rx65n-ota-setup)
+ [헤더 파일을 가져오고 구성하고 aws\$1demos 및 boot\$1loader를 빌드합니다.](#download-rx65n-ota-import-configure)

## 운영 환경 설정
<a name="download-rx65n-ota-environment"></a>

이 섹션의 절차에서는 다음 환경을 사용합니다.
+ **IDE**: e2 studio 7.8.0, e2 studio 2020-07
+ **도구 체인**: CCRX Compiler v3.0.1
+ **대상 디바이스**: RSKRX65N-2MB
+ **디버거**: E2, E2 Lite 에뮬레이터
+ **소프트웨어**: Renesas Flash Programmer, Renesas 보안 플래시 프로그래머.exe, Tera Term

**하드웨어를 설정하려면**

1. E2 Lite 에뮬레이터 및 USB 직렬 포트를 RX65N 보드 및 PC에 연결합니다.

1. 전원을 RX65N에 연결합니다.

## AWS 리소스 설정
<a name="download-rx65n-ota-setup"></a>

1. FreeRTOS 데모를 실행하려면 AWS IoT 서비스에 액세스할 권한이 있는 IAM 사용자가 있는 AWS 계정이 있어야 합니다. 아직 [AWS계정 및 권한 설정](freertos-prereqs.md#freertos-account-and-permissions)의 단계를 완료하지 않았다면 지금 수행합니다.

1. OTA 업데이트를 설정하려면 [OTA 업데이트 사전 조건](ota-prereqs.md)의 단계를 따릅니다. 특히 [MQTT를 사용한 OTA 업데이트 사전 조건](ota-mqtt-freertos.md)의 단계를 따르십시오.

1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/home)을 엽니다.

1. 왼쪽 탐색 창에서 **관리**를 선택한 후 **사물**을 선택하여 사물을 하나 생성합니다.

    AWS IoT에서 사물이란 특정 디바이스 또는 논리적 엔터티의 표현입니다. 사물은 물리적 장치 또는 센서일 수 있습니다(예: 전구 또는 벽면 스위치). 또한 애플리케이션의 인스턴스와 같은 논리적 엔터티이거나에 연결되지 AWS IoT는 않지만에 연결된 디바이스(예: 엔진 센서 또는 제어판이 있는 자동차)와 관련된 물리적 엔터티일 수도 있습니다.는 사물을 관리하는 데 도움이 되는 사물 레지스트리를 AWS IoT 제공합니다.

   1. **생성**을 선택하고 **단일 사물 생성**을 선택합니다.

   1. 사물의 **이름**을 입력하고 **다음**을 선택합니다.

   1. [**Create certificate**]를 선택합니다.

   1. 생성된 세 개의 파일을 다운로드한 다음 **활성화**를 선택합니다.

   1. **정책 연결**을 선택합니다.  
![\[다운로드할 파일이 표시된 콘솔 화면\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/download-these-files-rx65n.png)

   1. [디바이스 정책](ota-mqtt-freertos.md#ota-mqtt-freertos-device-policy)에서 생성한 정책을 선택합니다.

      MQTT를 사용하여 OTA 업데이트를 수신하는 각 디바이스는에 사물로 등록해야 하며 AWS IoT 사물에는 나열된 것과 같은 연결된 정책이 있어야 합니다. `"Action"` 및 `"Resource"` 객체의 항목에 대한 자세한 내용은 [AWS IoT 핵심 정책 작업](https://docs.aws.amazon.com/iot/latest/developerguide/iot-policy-actions.html) 및 [AWS IoT 핵심 작업 리소스](https://docs.aws.amazon.com/iot/latest/developerguide/iot-action-resources.html)에서 확인할 수 있습니다.

**참고**
      + `iot:Connect` 권한을 통해 디바이스는 MQTT를 AWS IoT 통해에 연결할 수 있습니다.
      +  AWS IoT 작업(`.../jobs/*`) 항목에 대한 `iot:Subscribe` 및 `iot:Publish` 권한을 사용하면 연결된 디바이스에서 작업 알림과 작업 문서를 수신하고 작업 실행 완료 상태를 게시할 수 있습니다.
      +  AWS IoT OTA 스트림(`.../streams/*`) 주제에 대한 `iot:Subscribe` 및 `iot:Publish` 권한을 통해 연결된 디바이스는 OTA 업데이트 데이터를 가져올 수 있습니다 AWS IoT. MQTT를 통해 펌웨어 업데이트를 수행하려면 이러한 권한이 필요합니다.
      + `iot:Receive` 권한을 통해 AWS IoT Core 는 연결된 디바이스에 해당 주제에 대한 메시지를 게시할 수 있습니다. MQTT 메시지를 전송할 때마다 이 권한을 확인합니다. 이 권한을 사용하면 주제를 현재 구독 중인 클라이언트에 대한 액세스 권한을 취소할 수 있습니다.

1. 코드 서명 프로필을 생성하고 코드 서명 인증서를 등록하려면 AWS

   1. 키와 인증을 생성하려면 [Renesas MCU 펌웨어 업데이트 디자인 정책](https://www.renesas.com/us/en/document/apn/renesas-mcu-firmware-update-design-policy)의 섹션 7.3 "OpenSSL을 이용하여 ECDSA-SHA256 키 페어 생성"을 참조하세요.

   1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/home)을 엽니다. 왼쪽 탐색 창에서 **관리**를 선택하고 **작업**을 선택합니다. **작업 생성**을 선택하고 **OTA 업데이트 작업 생성**을 선택합니다.

   1. **업데이트할 디바이스 선택**에서 **선택**을 선택하고 이전에 생성한 사물을 선택합니다. **다음**을 선택합니다.

   1. **FreeRTOS OTA 업데이트 작업 생성** 페이지에서 다음을 수행합니다.

      1. **펌웨어 이미지 전송을 위한 프로토콜 선택**에서 **MQTT**를 선택합니다.

      1. **펌웨어 이미지 선택 및 서명**에서 **나를 위해 새 펌웨어 이미지에 서명**을 선택합니다.

      1. **코드 서명 프로필**에서 **생성**을 선택합니다.

      1. **코드 서명 프로필 생성** 창에서 **프로필 이름**을 입력합니다. **디바이스 하드웨어 플랫폼**에서 **Windows 시뮬레이터**를 선택합니다. **코드 서명 인증서**에서 **가져오기**를 선택합니다.

      1. 인증서(`secp256r1.crt`), 인증서 프라이빗 키(`secp256r1.key`) 및 인증서 체인(`ca.crt`)을 찾아 선택합니다.

      1. **디바이스에 있는 코드 서명 인증서의 경로 이름**을 입력합니다. 그런 다음 **생성**을 선택합니다.

1. 에 대한 코드 서명에 대한 액세스 권한을 부여하려면의 단계를 AWS IoT따릅니다[에 대한 코드 서명에 대한 액세스 권한 부여 AWS IoT](code-sign-policy.md).

PC에 Tera Term이 설치되어 있지 않은 경우 [https://ttssh2.osdn.jp/index.html.en](https://ttssh2.osdn.jp/index.html.en)에서 다운로드하여 여기에 표시된 대로 설정할 수 있습니다. 디바이스의 USB 직렬 포트를 PC에 연결했는지 확인하세요.

![\[Tera Term 직렬 포트 설정 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/tera-team-rx65n.png)


## 헤더 파일을 가져오고 구성하고 aws\$1demos 및 boot\$1loader를 빌드합니다.
<a name="download-rx65n-ota-import-configure"></a>

시작하려면 최신 버전의 FreeRTOS 패키지를 선택합니다. 그러면 이 패키지가 GitHub에서 다운로드되고 자동으로 프로젝트로 가져와집니다. 그러므로 FreeRTOS 구성과 애플리케이션 코드 작성에 집중할 수 있습니다.

1. e2 studio 시작.

1. **파일**을 선택하고 **가져오기…**를 선택합니다.

1. **Renesas GitHub FreeRTOS(IoT 라이브러리 포함) 프로젝트**를 선택합니다.  
![\[e-squared studio 가져오기 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/import-renesas-project-rx65n.png)

1. **추가 버전 확인...**을 선택하여 다운로드 대화 상자를 표시합니다.  
![\[e-squared studio 다운로드 대화 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/check-more-version-rx65n.png)

1. 최신 패키지를 선택합니다.  
![\[e-squared studio 모듈 다운로드 대화 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/choose-latest-version-rx65n.png)

1. **동의**를 선택하여 최종 사용자 사용권 계약을 수락합니다.  
![\[e-squared studio EULA 대화 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/eula-rx65n.png)

1. 다운로드가 완료될 때까지 기다립니다.  
![\[다운로드 진행률 표시줄\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/downloading-rx65n.png)

1. **aws\$1demos** 및 **boot\$1loader** 프로젝트를 선택한 다음 **마침**을 선택하여 프로젝트를 가져옵니다.  
![\[프로젝트 가져오기 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/import-projects-rx65n.png)

1. 두 프로젝트 모두 프로젝트 속성을 엽니다. 탐색 창에서 **도구 체인 편집기**를 선택합니다.

   1. **현재 도구 체인**을 선택합니다.

   1. **현재 빌더**를 선택합니다.  
![\[e-squared studio 속성 창\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/project-properties-rx65n.png)

1. 탐색 창에서 **설정**을 선택합니다. **도구 체인** 탭을 선택하고 **버전**을 선택합니다.  
![\[Renesas CCRX 버전 v3.01.00에 대한 도구 체인 통합 설정과 도구 체인을 변경할 수 있는 옵션.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/project-properties-toolchain-rx65n.png)

   **도구 설정** 탭을 선택하고 **변환기**를 확장한 다음 **출력**을 선택합니다. 기본 창에서 **출력 16진수 파일**이 선택되어 있는지 확인한 다음 **출력 파일 유형**을 선택합니다.  
![\[출력 16진수 파일, 출력 파일 유형, 출력 디렉터리 및 파일 분할 옵션과 같은 컴파일러 및 링커 옵션을 보여주는 C/C++ 빌드 구성 설정 창입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/project-properties-settings-rx65n.png)  
![\[스택 분석, 도구 체인 편집기, C/C++ 일반, MCU, 프로젝트 참조 등의 옵션이 포함된 인터페이스 설정 트리\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/project-properties-settings-2-rx65n.png)

1. 부트 로더 프로젝트에서 `projects\renesas\rx65n-rsk\e2studio\boot_loader\src\key\code_signer_public_key.h`를 열고 퍼블릭 키를 입력합니다. 퍼블릭 키를 생성하는 방법에 대한 자세한 내용은 [RX65N에서 Amazon 웹 서비스를 사용하여 FreeRTOS OTA를 구현하는 방법](https://www.renesas.com/us/en/document/apn/rx-family-how-implement-freertos-ota-using-amazon-web-services-rx65n) 및 [Renesas MCU 펌웨어 업데이트 디자인 정책](https://www.renesas.com/us/en/document/apn/renesas-mcu-firmware-update-design-policy) 섹션 7.3 "OpenSSL을 사용하여 ECDSA-SHA256 키 페어 생성하기"를 참조하세요.  
![\[CODE_SIGNER_PUBLIC_KEY에 대한 정의가 있는 C 헤더 파일과 PEM 인코딩 코드 서명자 퍼블릭 키 변수를 보여주는 Code Editor입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/open-bootloader-project-rx65n.png)

   그런 다음 프로젝트를 빌드하여 `boot_loader.mot`를 생성합니다.

1. `aws_demos` 프로젝트를 엽니다.

   1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/home)을 엽니다.

   1. 왼쪽 탐색 창에서 **설정**을 선택합니다. **디바이스 데이터 엔드포인트** 텍스트 상자에서 사용자 지정 엔드포인트를 기록해 둡니다.

   1. **관리**를 선택하고 **사물**을 선택합니다. 보드의 AWS IoT 사물 이름을 기록해 둡니다.

   1. `aws_demos` 프로젝트에서 `demos/include/aws_clientcredential.h`를 열고 다음 값을 지정합니다.

      ```
      #define clientcredentialMQTT_BROKER_ENDPOINT[] = "Your AWS IoT endpoint";
      #define clientcredentialIOT_THING_NAME "The AWS IoT thing name of your board"
      ```  
![\[AWS IoT 사물 이름 및 브로커 엔드포인트 구성 설정을 보여주는 코드 조각입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/client-credential-rx65n.png)

   1. `tools/certificate_configuration/CertificateConfigurator.html` 파일을 엽니다.

   1. 이전에 다운로드한 인증서 PEM 파일과 프라이빗 키 PEM 파일을 가져옵니다.

   1. **aws\$1clientcredential\$1keys.h 생성 및 저장**을 선택하고 `demos/include/` 디렉터리에서 이 파일로 바꿉니다.  
![\[AWS IoT 콘솔에서 클라이언트 인증서와 프라이빗 키 PEM 파일을 제공하는 필드와 aws_clientcredential_keys.h 파일을 생성하고 저장하는 버튼이 있는 인증서 구성 도구입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/certificate-config-tool-rx65n.png)

   1. `vendors/renesas/boards/rx65n-rsk/aws_demos/config_files/ota_demo_config.h` 파일을 열고 다음 값을 지정합니다.

      ```
      #define otapalconfigCODE_SIGNING_CERTIFICATE [] = "your-certificate-key";
      ```

      여기서 *your-certificate-key*는 `secp256r1.crt` 파일의 값입니다. 인증서의 각 줄 뒤에 ‘\$1’를 추가해야 합니다. `secp256r1.crt` 파일을 생성하는 방법에 대한 자세한 내용은 [RX65N에서 Amazon 웹 서비스를 사용하여 FreeRTOS OTA를 구현하는 방법](https://www.renesas.com/us/en/document/apn/rx-family-how-implement-freertos-ota-using-amazon-web-services-rx65n) 및 [Renesas MCU 펌웨어 업데이트 디자인 정책](https://www.renesas.com/us/en/document/apn/renesas-mcu-firmware-update-design-policy) 섹션 7.3 "OpenSSL을 사용하여 ECDSA-SHA256 키 페어 생성하기"를 참조하세요.  
![\[수정된 인증서 데이터가 있는 PEM 인코딩 코드 서명자 인증서 상수 문자열을 정의하는 C 코드를 보여주는 소스 코드 파일입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/codesigner-cert-rx65n.png)

1. **작업 A: 펌웨어의 초기 버전 설치**

   1. `vendors/renesas/boards/board/aws_demos/config_files/aws_demo_config.h` 파일을 열고 `#define CONFIG_CORE_MQTT_MUTUAL_AUTH_DEMO_ENABLED`를 주석으로 처리한 다음 `CONFIG_OTA_MQTT_UPDATE_DEMO_ENABLED` 또는 `CONFIG_OTA_HTTP_UPDATE_DEMO_ENABLED`를 정의합니다.

   1. `demos/include/ aws_application_version.h` 파일을 열고 펌웨어의 초기 버전을 `0.9.2`로 설정합니다.  
![\[메이저, 마이너 및 빌드 버전 번호에 대한 매크로를 포함하여 애플리케이션의 버전 정의를 보여주는 코드 조각입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/firmware-version-rx65n.png)

   1. **섹션 뷰어**에서 다음 설정을 변경합니다.  
![\[메모리 주소, SU, SI, 레지스터와 같은 섹션 이름, 네트워크 버퍼, 예외 및 작업 버튼과 같은 인터페이스 구성 요소를 보여주는 섹션 뷰어 창입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/section-viewer-rx65n.png)

   1. **빌드**를 선택하여 `aws_demos.mot` 파일을 생성합니다.

1. Renesas 보안 플래시 프로그래머를 사용하여 `userprog.mot` 파일을 생성합니다. `userprog.mot`는 `aws_demos.mot` 및 `boot_loader.mot`의 조합입니다. 이 파일을 RX65N-RSK로 플래시하여 초기 펌웨어를 설치할 수 있습니다.

   1. [https://github.com/renesas/Amazon-FreeRTOS-Tools](https://github.com/renesas/Amazon-FreeRTOS-Tools)를 다운로드하고 `Renesas Secure Flash Programmer.exe`를 엽니다.

   1. **초기 펌웨어** 탭을 선택한 후 다음 파라미터를 설정합니다.
      + **프라이빗 키 경로** - `secp256r1.privatekey`의 위치입니다.
      + **부트 로더 파일 경로** - `boot_loader.mot`(`projects\renesas\rx65n-rsk\e2studio\boot_loader\HardwareDebug`)의 위치입니다.
      + **파일 경로** - `aws_demos.mot`(`projects\renesas\rx65n-rsk\e2studio\aws_demos\HardwareDebug`)의 위치입니다.  
![\[MCU, 펌웨어 확인, 시퀀스 번호, AES 키 경로 및 파일 경로 필드가 있는 보안 플래시 프로그래머 창을 Renesas합니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/secure-flash-rx65n.png)

   1. `init_firmware`라는 이름의 디렉터리를 생성합니다. `userprog.mot`를 생성하여 `init_firmware` 디렉터리에 저장합니다. 생성이 성공했는지 확인합니다.

1. RX65N-RSK에서 초기 펌웨어를 플래시합니다.

   1. [https://www.renesas.com/tw/en/products/software-tools/tools/programmer/renesas-flash-programmer-programming-gui.html](https://www.renesas.com/tw/en/products/software-tools/tools/programmer/renesas-flash-programmer-programming-gui.html)에서 최신 버전의 Renesas 플래시 프로그래머(프로그래밍 GUI)를 다운로드합니다.

   1. `vendors\renesas\rx_mcu_boards\boards\rx65n-rsk\aws_demos\flash_project\erase_from_bank\ erase.rpj` 파일을 열어 뱅크에 있는 데이터를 지웁니다.

   1. **시작**을 선택하여 뱅크를 지웁니다.  
![\[RX 그룹 마이크로컨트롤러 프로젝트 세부 정보, 파일 경로, 지우기, 프로그램, 시작 및 확인 버튼을 사용한 확인과 같은 플래시 작업 옵션을 보여주는 Renesas 플래시 프로그래머 창입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/flash-programmer-erasing-rx65n.png)

   1. `userprog.mot`를 플래시하려면 **찾아보기…**를 선택하고 `init_firmware` 디렉터리로 이동한 다음, `userprog.mot` 파일을 선택하고 **시작**을 선택합니다.  
![\[마이크로컨트롤러 RX 그룹, 프로그램 파일을 탐색하는 옵션, 지우기 및 시작 버튼, 삭제할 선택한 블록의 상태 세부 정보를 포함한 지우기 작업 설정을 보여주는 Renesas 플래시 프로그래머 창입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/flash-programmer-complete-rx65n.png)

1. RX65N-RSK에 펌웨어 버전 0.9.2(초기 버전)가 설치되었습니다. 이제 RX65N-RSK 보드에서 OTA 업데이트를 수신합니다. PC에서 Tera Term을 연 경우 초기 펌웨어가 실행될 때 다음과 같은 내용이 표시됩니다.

   ```
   -------------------------------------------------
   RX65N secure boot program
   -------------------------------------------------
   Checking flash ROM status.
   bank 0 status = 0xff [LIFECYCLE_STATE_BLANK]
   bank 1 status = 0xfc [LIFECYCLE_STATE_INSTALLING]
   bank info = 1. (start bank = 0)
   start installing user program.
   copy secure boot (part1) from bank0 to bank1...OK
   copy secure boot (part2) from bank0 to bank1...OK
   update LIFECYCLE_STATE from [LIFECYCLE_STATE_INSTALLING] to [LIFECYCLE_STATE_VALID]
   bank1(temporary area) block0 erase (to update LIFECYCLE_STATE)...OK
   bank1(temporary area) block0 write (to update LIFECYCLE_STATE)...OK
   swap bank...
   -------------------------------------------------
   RX65N secure boot program
   -------------------------------------------------
   Checking flash ROM status.
   bank 0 status = 0xf8 [LIFECYCLE_STATE_VALID]
   bank 1 status = 0xff [LIFECYCLE_STATE_BLANK]
   bank info = 0. (start bank = 1)
   integrity check scheme = sig-sha256-ecdsa
   bank0(execute area) on code flash integrity check...OK
   jump to user program
   0 1 [ETHER_RECEI] Deferred Interrupt Handler Task started
   1 1 [ETHER_RECEI] Network buffers: 3 lowest 3
   2 1 [ETHER_RECEI] Heap: current 234192 lowest 234192
   3 1 [ETHER_RECEI] Queue space: lowest 8
   4 1 [IP-task] InitializeNetwork returns OK
   5 1 [IP-task] xNetworkInterfaceInitialise returns 0
   6 101 [ETHER_RECEI] Heap: current 234592 lowest 233392
   7 2102 [ETHER_RECEI] prvEMACHandlerTask: PHY LS now 1
   8 3001 [IP-task] xNetworkInterfaceInitialise returns 1
   9 3092 [ETHER_RECEI] Network buffers: 2 lowest 2
   10 3092 [ETHER_RECEI] Queue space: lowest 7
   11 3092 [ETHER_RECEI] Heap: current 233320 lowest 233320
   12 3193 [ETHER_RECEI] Heap: current 233816 lowest 233120
   13 3593 [IP-task] vDHCPProcess: offer c0a80a09ip
   14 3597 [ETHER_RECEI] Heap: current 233200 lowest 233000
   15 3597 [IP-task] vDHCPProcess: offer c0a80a09ip
   16 3597 [IP-task] IP Address: 192.168.10.9
   17 3597 [IP-task] Subnet Mask: 255.255.255.0
   18 3597 [IP-task] Gateway Address: 192.168.10.1
   19 3597 [IP-task] DNS Server Address: 192.168.10.1
   20 3600 [Tmr Svc] The network is up and running
   21 3622 [Tmr Svc] Write certificate...
   22 3697 [ETHER_RECEI] Heap: current 232320 lowest 230904
   23 4497 [ETHER_RECEI] Heap: current 226344 lowest 225944
   24 5317 [iot_thread] [INFO ][DEMO][5317] ---------STARTING DEMO---------
   
   25 5317 [iot_thread] [INFO ][INIT][5317] SDK successfully initialized.
   26 5317 [iot_thread] [INFO ][DEMO][5317] Successfully initialized the demo. Network type for the demo: 4
   27 5317 [iot_thread] [INFO ][MQTT][5317] MQTT library successfully initialized.
   28 5317 [iot_thread] [INFO ][DEMO][5317] OTA demo version 0.9.2
   
   29 5317 [iot_thread] [INFO ][DEMO][5317] Connecting to broker...
   
   30 5317 [iot_thread] [INFO ][DEMO][5317] MQTT demo client identifier is rx65n-gr-rose (length 13).
   31 5325 [ETHER_RECEI] Heap: current 206944 lowest 206504
   32 5325 [ETHER_RECEI] Heap: current 206440 lowest 206440
   33 5325 [ETHER_RECEI] Heap: current 206240 lowest 206240
   38 5334 [ETHER_RECEI] Heap: current 190288 lowest 190288
   39 5334 [ETHER_RECEI] Heap: current 190088 lowest 190088
   40 5361 [ETHER_RECEI] Heap: current 158512 lowest 158168
   41 5363 [ETHER_RECEI] Heap: current 158032 lowest 158032
   42 5364 [ETHER_RECEI] Network buffers: 1 lowest 1
   43 5364 [ETHER_RECEI] Heap: current 156856 lowest 156856
   44 5364 [ETHER_RECEI] Heap: current 156656 lowest 156656
   46 5374 [ETHER_RECEI] Heap: current 153016 lowest 152040
   47 5492 [ETHER_RECEI] Heap: current 141464 lowest 139016
   48 5751 [ETHER_RECEI] Heap: current 140160 lowest 138680
   49 5917 [ETHER_RECEI] Heap: current 138280 lowest 138168
   59 7361 [iot_thread] [INFO ][MQTT][7361] Establishing new MQTT connection.
   62 7428 [iot_thread] [INFO ][MQTT][7428] (MQTT connection 81cfc8, CONNECT operation 81d0e8) Wait complete with result SUCCESS.
   63 7428 [iot_thread] [INFO ][MQTT][7428] New MQTT connection 4e8c established.
   64 7430 [iot_thread] [OTA_AgentInit_internal] OTA Task is Ready.
   65 7430 [OTA Agent T] [prvOTAAgentTask] Called handler. Current State [Ready] Event [Start] New state [RequestingJob]
   66 7431 [OTA Agent T] [INFO ][MQTT][7431] (MQTT connection 81cfc8) SUBSCRIBE operation scheduled.
   67 7431 [OTA Agent T] [INFO ][MQTT][7431] (MQTT connection 81cfc8, SUBSCRIBE operation 818c48) Waiting for operation completion.
   68 7436 [ETHER_RECEI] Heap: current 128248 lowest 127992
   69 7480 [OTA Agent T] [INFO ][MQTT][7480] (MQTT connection 81cfc8, SUBSCRIBE operation 818c48) Wait complete with result SUCCESS.
   70 7480 [OTA Agent T] [prvSubscribeToJobNotificationTopics] OK: $aws/things/rx65n-gr-rose/jobs/$next/get/accepted
   71 7481 [OTA Agent T] [INFO ][MQTT][7481] (MQTT connection 81cfc8) SUBSCRIBE operation scheduled.
   72 7481 [OTA Agent T] [INFO ][MQTT][7481] (MQTT connection 81cfc8, SUBSCRIBE operation 818c48) Waiting for operation completion.
   73 7530 [OTA Agent T] [INFO ][MQTT][7530] (MQTT connection 81cfc8, SUBSCRIBE operation 818c48) Wait complete with result SUCCESS.
   74 7530 [OTA Agent T] [prvSubscribeToJobNotificationTopics] OK: $aws/things/rx65n-gr-rose/jobs/notify-next
   75 7530 [OTA Agent T] [prvRequestJob_Mqtt] Request #0
   76 7532 [OTA Agent T] [INFO ][MQTT][7532] (MQTT connection 81cfc8) MQTT PUBLISH operation queued.
   77 7532 [OTA Agent T] [INFO ][MQTT][7532] (MQTT connection 81cfc8, PUBLISH operation 818b80) Waiting for operation completion.
   78 7552 [OTA Agent T] [INFO ][MQTT][7552] (MQTT connection 81cfc8, PUBLISH operation 818b80) Wait complete with result SUCCESS.
   79 7552 [OTA Agent T] [prvOTAAgentTask] Called handler. Current State [RequestingJob] Event [RequestJobDocument] New state [WaitingForJob]
   80 7552 [OTA Agent T] [prvParseJSONbyModel] Extracted parameter [ clientToken: 0:rx65n-gr-rose ]
   81 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: execution
   82 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: jobId
   83 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: jobDocument
   84 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: afr_ota
   85 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: protocols
   86 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: files
   87 7552 [OTA Agent T] [prvParseJSONbyModel] parameter not present: filepath
   99 7651 [ETHER_RECEI] Heap: current 129720 lowest 127304
   100 8430 [iot_thread] [INFO ][DEMO][8430] State: Ready  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   101 9430 [iot_thread] [INFO ][DEMO][9430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   102 10430 [iot_thread] [INFO ][DEMO][10430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   103 11430 [iot_thread] [INFO ][DEMO][11430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   104 12430 [iot_thread] [INFO ][DEMO][12430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   105 13430 [iot_thread] [INFO ][DEMO][13430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   106 14430 [iot_thread] [INFO ][DEMO][14430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   107 15430 [iot_thread] [INFO ][DEMO][15430] State: WaitingForJob  Received: 1   Queued: 0   Processed: 0   Dropped: 0
   ```

1. **작업 B: 펌웨어 버전 업데이트**

   1. `demos/include/aws_application_version.h` 파일을 열고 `APP_VERSION_BUILD` 토큰 값을 `0.9.3`으로 높입니다.

   1. 프로젝트를 다시 빌드합니다.

1. Renesas 보안 플래시 프로그래머로 `userprog.rsu` 파일을 생성하여 펌웨어의 버전을 업데이트합니다.

   1. `Amazon-FreeRTOS-Tools\Renesas Secure Flash Programmer.exe` 파일을 엽니다.

   1. **펌웨어 업데이트** 탭을 선택한 후 다음 파라미터를 설정합니다.
      + **파일 경로** - `aws_demos.mot` 파일(`projects\renesas\rx65n-rsk\e2studio\aws_demos\HardwareDebug`)의 위치입니다.

   1. `update _firmware`이라는 디렉터리를 생성합니다. `userprog.rsu`를 생성하여 `update_firmware` 디렉터리에 저장합니다. 생성이 성공했는지 확인합니다.  
![\[MCU 선택, 펌웨어 확인 유형, 시퀀스 번호, AES MAC 키 필드 및 보안 펌웨어 생성을 위한 파일 경로 입력이 포함된 보안 플래시 프로그래머 창을 Renesas합니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/update-firmware-rx65n.png)

1. [업데이트를 저장할 Amazon S3 버킷 생성](dg-ota-bucket.md)에 설명된 대로 펌웨어 업데이트 `userproj.rsu`를 Amazon S3 버킷에 업로드합니다.  
![\[폴더, 업로드, 버전 및 권한 옵션이 있는 Amazon S3 버킷 관리 인터페이스\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/upload-firmware-rx65n.png)

1. RX65N-RSK 펌웨어를 업데이트하는 작업을 생성합니다.

   AWS IoT 작업은 하나 이상의 연결된 디바이스에 보류 중인 [작업을](https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html) 알리는 서비스입니다. 작업을 사용하여 디바이스 플릿을 관리하거나, 디바이스의 펌웨어 및 보안 인증서를 업데이트하거나, 디바이스 재시작 및 진단과 같은 관리 작업을 수행할 수 있습니다.

   1. [AWS IoT 콘솔](https://console.aws.amazon.com/iotv2/)에 로그인합니다. 탐색 창에서 **관리**를 선택하고 **작업**을 선택합니다.

   1. **작업 생성**을 선택하고 **OTA 업데이트 작업 생성**을 선택합니다. 사물을 선택하고 **다음**을 선택합니다.

   1. 다음과 같이 FreeRTOS OTA 업데이트 작업을 생성합니다.
      + **MQTT**를 선택합니다.
      + 이전 섹션에서 생성한 코드 서명 프로필을 선택합니다.
      + Amazon S3 버킷에 업로드한 펌웨어 이미지를 선택합니다.
      + **디바이스에 있는 펌웨어 이미지의 경로 이름**에 **test**를 입력합니다.
      + 이전 섹션에서 생성한 IAM 역할을 선택합니다.

   1. **다음**을 선택합니다.  
![\[새 펌웨어에 서명하고, 이전에 서명된 펌웨어를 선택하고, 사용자 지정 서명된 펌웨어를 사용하고, 코드 서명 프로파일, 펌웨어 이미지 파일, 디바이스 경로 및 OTA 업데이트 작업을 위한 IAM 역할을 지정하는 옵션이 포함된 펌웨어 이미지 서명 및 OTA 업데이트 설정입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/create-job-next-rx65n.png)

   1. ID를 입력한 다음 **생성**을 선택합니다.

1. Tera Term을 다시 열어 펌웨어가 OTA 데모 버전 0.9.3으로 성공적으로 업데이트되었는지 확인합니다.  
![\[브로커에 대한 스레드의 초기화 및 연결을 보여주는 명령줄 출력입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/update-successful-rx65n.png)

1.  AWS IoT 콘솔에서 작업 상태가 **성공**인지 확인합니다.  
![\[1개의 리소스가 성공했음을 보여주는 AFR OTA-demo 테스트 작업 개요입니다.\]](http://docs.aws.amazon.com/ko_kr/freertos/latest/userguide/images/completed-succeeded-rx65n.png)

# 자습서: FreeRTOS Bluetooth Low Energy를 사용하여 Espressif ESP32 OTA 업데이트 수행
<a name="ota-updates-esp32-ble"></a>

**중요**  <a name="deprecation-message"></a>
이 라이브러리는 더 이상 사용되지 않는 Amazon-FreeRTOS 리포지토리에서 호스팅됩니다. 새 프로젝트를 생성할 때는 [여기서 시작](freertos-getting-started-modular.md)하는 것이 좋습니다. 현재 사용되지 않는 Amazon-FreeRTOS 리포지토리를 기반으로 하는 기존 FreeRTOS 프로젝트가 이미 있는 경우에는 [Amazon-FreeRTOS Github 리포지토리 마이그레이션 가이드](github-repo-migration.md) 섹션을 참조하세요.

이 자습서에서는 Android 디바이스의 MQTT 블루투스 로우 에너지 프록시에 연결된 Espressif ESP32 마이크로컨트롤러를 업데이트하는 방법을 보여줍니다. 무선(OTA) 업데이트 작업을 사용하여 AWS IoT Over-the-air 업데이트합니다. 디바이스는 Android 데모 앱에 입력된 Amazon Cognito 자격 증명을 AWS IoT 사용하여에 연결합니다. 권한이 부여된 운영자가 클라우드에서 OTA 업데이트를 시작합니다. 디바이스가 Android 데모 앱을 통해 연결되면 OTA 업데이트가 시작되고 디바이스의 펌웨어가 업데이트됩니다.

FreeRTOS 버전 2019.06.00 메이저 이상에는 Wi-Fi 프로비저닝 및 AWS IoT 서비스에 대한 보안 연결에 사용할 수 있는 Bluetooth Low Energy MQTT 프록시 지원이 포함되어 있습니다. 블루투스 로우 에너지 기능을 사용하면 Wi-Fi 없이도 모바일 디바이스와 페어링하여 연결할 수 있는 저전력 디바이스를 구축할 수 있습니다. 디바이스는 일반 액세스 프로필(GAP) 및 일반 속성(GATT) 프로필을 사용하는 Android 또는 iOS 블루투스 로우 에너지 SDK를 통해 연결하여 MQTT로 통신할 수 있습니다.

블루투스 로우 에너지를 통한 OTA 업데이트를 허용하기 위해 따라야 할 단계는 다음과 같습니다.

1. **스토리지 구성:** Amazon S3 버킷 및 정책을 생성하고 업데이트를 수행할 수 있는 IAM 사용자를 구성합니다.

1. **코드 서명 인증서 생성:** 서명 인증서를 생성하고 IAM 사용자가 펌웨어 업데이트에 서명하도록 허용합니다.

1. **Amazon Cognito 인증 구성:** 보안 인증 정보 공급자, 사용자 풀, 애플리케이션의 사용자 풀 액세스 권한을 생성합니다.

1. **FreeRTOS 구성:** 블루투스 로우 에너지, 클라이언트 보안 인증 정보 및 코드 서명 퍼블릭 인증서를 설정합니다.

1. **Android 앱 구성:** 보안 인증 정보 공급자, 사용자 풀을 설정하고 Android 디바이스에 애플리케이션을 배포합니다.

1. **OTA 업데이트 스크립트 실행:** OTA 업데이트를 시작하려면 OTA 업데이트 스크립트를 사용합니다.

업데이트 작동 방식에 대한 자세한 내용은 [FreeRTOS 무선 업데이트(OTA)](freertos-ota-dev.md) 섹션을 참조하세요. 블루투스 로우 에너지 MQTT 프록시 기능을 설정하는 방법에 대한 자세한 내용은 Richard Kang의 [Using 블루투스 로우 에너지 with FreeRTOS on Espressif ESP32](https://aws.amazon.com/blogs/iot/using-bluetooth-low-energy-with-amazon-freertos-on-espressif-esp32/) 게시물을 참조하세요.

## 사전 조건
<a name="ota-updates-esp32-ble-prereq"></a>

이 자습서의 단계를 수행하려면 다음 리소스가 필요합니다.
+ ESP32 개발 보드.
+ MicroUSB-USB A 케이블.
+  AWS 계정(프리 티어면 충분함).
+ Android v 6.0 이상 및 블루투스 버전 4.2 이상이 탑재된 Android 스마트폰.

개발용 컴퓨터에는 다음이 필요합니다.
+ Xtensa 도구 체인과 FreeRTOS 소스 코드 및 예제를 위한 충분한 디스크 공간(최대 500Mb).
+ Android Studio 설치.
+ [AWS CLI](https://aws.amazon.com/cli/) 설치.
+ Python3 설치.
+ [Python용 boto3 AWS Software 개발자 키트(SDK)](https://github.com/boto/boto3)입니다.

이 자습서의 단계에서는 Xtensa 도구 체인, ESP-IDF 및 FreeRTOS 코드가 홈 디렉터리의 `/esp` 디렉터리에 설치되어 있다고 가정합니다. `$PATH` 변수에 `~/esp/xtensa-esp32-elf/bin`을 추가해야 합니다.

## 1단계: 스토리지 구성
<a name="ota-updates-esp32-ble-step1"></a>

1. 펌웨어 이미지를 보관할 버전 관리가 활성화된 [업데이트를 저장할 Amazon S3 버킷 생성](dg-ota-bucket.md).

1. [OTA 업데이트 서비스 역할 생성](create-service-role.md) 단계를 수행하고 이 역할에 다음 관리형 정책을 추가합니다.
   + AWSIotLogging
   + AWSIotRuleActions
   + AWSIotThingsRegistration
   + AWSFreeRTOSOTAUpdate

1. OTA 업데이트를 수행할 수 있는 [사용자를 생성](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html)합니다. 이 사용자는 계정에 서명하여 IoT 디바이스에 펌웨어 업데이트를 배포할 수 있으며 모든 디바이스에서 OTA 업데이트를 수행할 수 있습니다. 액세스는 신뢰할 수 있는 엔터티로만 제한되어야 합니다.

1. [OTA 사용자 정책 생성](create-ota-user-policy.md) 단계를 수행한 후 IAM 사용자에 연결합니다.

## 2단계: 코드 서명 인증서 생성
<a name="ota-updates-esp32-ble-step2"></a>

1. 펌웨어 이미지를 보관할 버전 관리가 활성화된 Amazon S3 버킷을 생성합니다.

1. 펌웨어 서명에 사용할 수 있는 코드 서명 인증서를 생성합니다. 인증서를 가져올 때 인증서 Amazon 리소스 이름(ARN)을 적어 둡니다.

   ```
   aws acm import-certificate --profile=ota-update-user --certificate file://ecdsasigner.crt --private-key file://ecdsasigner.key
   ```

   출력 예시:

   ```
   {
   "CertificateArn": "arn:aws:acm:us-east-1:<account>:certificate/<certid>"
   }
   ```

   나중에 ARN을 사용하여 서명 프로필을 생성할 것입니다. 원하는 경우 다음 명령을 사용하여 지금 프로필을 만들 수 있습니다.

   ```
   aws signer put-signing-profile --profile=ota-update-user --profile-name esp32Profile --signing-material certificateArn=arn:aws:acm:us-east-1:account:certificate/certid --platform AmazonFreeRTOS-Default --signing-parameters certname=/cert.pem
   ```

   출력 예시:

   ```
   {
   "arn": "arn:aws:signer::<account>:/signing-profiles/esp32Profile"
   }
   ```

## 3단계: Amazon Cognito 인증 구성
<a name="ota-updates-esp32-ble-step3"></a>

**AWS IoT 정책 생성**

1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)에 로그인합니다.

1. 콘솔의 오른쪽 상단에서 **내 계정**을 선택합니다. **계정 설정**에서 12자리 계정 ID를 기록해 둡니다.

1. 왼쪽 탐색 창에서 **설정**을 선택합니다. **디바이스 데이터 엔드포인트**에서 엔드포인트 값을 기록해 둡니다. 엔드포인트는 `xxxxxxxxxxxxxx.iot.us-west-2.amazonaws.com`과 비슷합니다. 이 예제에서 AWS 리전은 "us-west-2"입니다.

1. 왼쪽 탐색 창에서 **보안**을 선택하고 **정책**를 선택한 다음 **생성**을 선택합니다. 계정에 아무 정책도 없는 경우 “아직 정책이 없습니다.” 라는 메시지가 표시되고 **정책 생성**을 선택할 수 있습니다.

1. 정책의 이름을 입력합니다(예: "esp32\$1mqtt\$1proxy\$1iot\$1policy").

1. **설명문 추가** 섹션에서 **고급 모드**를 선택합니다. 다음 JSON을 복사하여 정책 편집기 창에 붙여 넣습니다. `aws-account-id`를 계정 ID로 바꾸고 `aws-region`을 현재 리전(예: "us-west-2")으로 바꿉니다.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "iot:Connect",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Publish",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Subscribe",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           },
           {
               "Effect": "Allow",
               "Action": "iot:Receive",
               "Resource": "arn:aws:iot:us-east-1:123456789012:*"
           }
       ]
   }
   ```

------

1. **생성(Create)**을 선택합니다.

**AWS IoT 사물 생성**

1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)에 로그인합니다.

1. 왼쪽 탐색 창에서 **관리**를 선택한 후 **사물**을 선택합니다.

1. 오른쪽 상단에서 **생성**을 선택합니다. 계정에 등록된 사물이 없는 경우 “아직 등록한 사물이 없습니다.”라는 메시지가 표시되고 **사물 등록**을 선택할 수 있습니다.

1. ** AWS IoT 사물 생성** 페이지에서 **단일 사물 생성을** 선택합니다.

1. **디바이스를 사물 레지스트리에 추가** 페이지에 사물의 이름을 입력합니다(예: "esp32-ble"). 영숫자, 하이픈(-) 및 밑줄() 문자만 허용됩니다. **다음**을 선택합니다.

1. **사물에 대한 인증서 추가** 페이지의 **원클릭 인증서 생성**에서 **인증서 생성**을 선택합니다. 인증 및 권한 부여에 Amazon Cognito 보안 인증 정보를 사용하는 BLE 프록시 모바일 앱을 사용하기 때문에 디바이스 인증서가 필요하지 않습니다.

**Amazon Cognito 앱 클라이언트 생성**

1. [Amazon Cognito 콘솔](https://console.aws.amazon.com/cognito/users/)에 로그인합니다.

1. 오른쪽 상단의 탐색 배너에서 **사용자 풀 생성**을 선택합니다.

1. 풀 이름을 입력합니다(예: "esp32\$1mqtt\$1proxy\$1user\$1pool").

1. [**Review defaults**]를 선택합니다.

1. **앱 클라이언트**에서 **앱 클라이언트 추가**를 선택한 다음 **앱 클라이언트 추가**를 선택합니다.

1. 앱 클라이언트 이름을 입력합니다(예: "mqtt\$1app\$1client").

1. **클라이언트 비밀 생성**이 선택되어 있는지 확인합니다.

1. **앱 클라이언트 생성**을 선택합니다.

1. **풀 세부 정보로 돌아가기**를 선택합니다.

1. 사용자 풀의 **검토** 페이지에서 **사용자 생성**을 선택합니다. “사용자 풀이 성공적으로 생성되었습니다.”라는 메시지가 표시됩니다. 풀 ID를 기록해 둡니다.

1. 탐색 창에서 **앱 클라이언트**를 선택합니다.

1. **세부 정보 표시**를 선택합니다. 앱 클라이언트 ID와 앱 클라이언트 비밀을 기록해 둡니다.

**Amazon Cognito ID 풀 생성**

1. [Amazon Cognito 콘솔](https://console.aws.amazon.com/cognito/federated)에 로그인합니다.

1. **새 자격 증명 풀 생성**을 선택합니다.

1. ID 풀의 이름을 입력합니다(예: "mqtt\$1proxy\$1identity\$1pool").

1. **인증 공급자**를 확장합니다.

1. **Cognito** 탭을 선택합니다.

1. 이전 단계에서 기록해 둔 사용자 풀 ID와 앱 클라이언트 ID를 입력합니다.

1. **풀 생성**을 선택합니다.

1. 다음 페이지에서 인증된 자격 증명 및 인증되지 않은 자격 증명에 대한 새 역할을 생성하려면 **허용**을 선택합니다.

1. 자격 증명 풀 ID(`us-east-1:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx` 형식)를 기록해 둡니다.

**IAM 정책을 인증된 자격 증명에 연결**

1. [Amazon Cognito 콘솔](https://console.aws.amazon.com/cognito/federated)을 엽니다.

1. 방금 생성한 자격 증명 풀(예: "mqtt\$1proxy\$1identity\$1pool")을 선택합니다.

1. **자격 증명 풀 편집**을 선택합니다.

1. 인증된 역할에 할당된 IAM 역할을 기록해 둡니다(예: "Cognito\$1mqtt\$1proxy\$1identity\$1poolAuth\$1Role").

1. [IAM 콘솔(IAM console)](https://console.aws.amazon.com/iam/home)을 엽니다.

1. 탐색 창에서 **역할**을 선택합니다.

1. 할당된 역할(예: "Cognito\$1mqtt\$1proxy\$1identity\$1poolAuth\$1Role")을 검색하여 선택합니다.

1. **인라인 정책 추가**를 선택한 후 **JSON**을 선택합니다.

1. 다음 정책을 입력합니다.

------
#### [ JSON ]

****  

   ```
   {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
          {
             "Effect": "Allow",
             "Action": [
                "iot:AttachPolicy",
                "iot:AttachPrincipalPolicy",
                "iot:Connect",
                "iot:Publish",
                "iot:Subscribe"
             ],
             "Resource": "*"
          }]
       }
   ```

------

1. **정책 검토**를 선택합니다.

1. 정책 이름을 입력합니다(예: "mqttProxyCognitoPolicy").

1. **정책 생성**을 선택합니다.

## 4단계: Amazon Freertos 구성
<a name="ota-updates-esp32-ble-step4"></a>

1. [FreeRTOS GitHub 리포지토리](https://github.com/aws/amazon-freertos)에서 최신 버전의 Amazon FreeRTOS 코드를 다운로드합니다.

1. OTA 업데이트 데모를 활성화하려면 [Espressif ESP32-DevKitC 및 ESP-WROVER-KIT 시작하기](getting_started_espressif.md)의 단계를 따릅니다.

1. 다음 파일을 추가로 수정합니다.

   1. `vendors/espressif/boards/esp32/aws_demos/config_files/aws_demo_config.h`를 열고 `CONFIG_OTA_UPDATE_DEMO_ENABLED`를 정의합니다.

   1. `vendors/espressif/boards/esp32/aws_demos/common/config_files/aws_demo_config.h`를 열고 `democonfigNETWORK_TYPES`를 `AWSIOT_NETWORK_TYPE_BLE`로 변경합니다.

   1. `demos/include/aws_clientcredential.h`를 열고 `clientcredentialMQTT_BROKER_ENDPOINT`의 엔드포인트 URL을 입력합니다.

      `clientcredentialIOT_THING_NAME`의 사물 이름을 입력합니다(예: "esp32-ble"). Amazon Cognito 보안 인증 정보를 사용할 때는 인증서를 추가할 필요가 없습니다.

   1. `vendors/espressif/boards/esp32/aws_demos/config_files/aws_iot_network_config.h`를 열고 `configSUPPORTED_NETWORKS` 및 `configENABLED_NETWORKS`를 `AWSIOT_NETWORK_TYPE_BLE`만 포함하도록 변경합니다.

   1. `vendors/vendor/boards/board/aws_demos/config_files/ota_demo_config.h` 파일을 열고 인증서를 입력합니다.

      ```
      #define otapalconfigCODE_SIGNING_CERTIFICATE [] = "your-certificate-key";
      ```

   애플리케이션이 시작하여 데모 버전을 출력합니다.

   ```
   11 13498 [iot_thread] [INFO ][DEMO][134980] Successfully initialized the demo. Network type for the demo: 2
   12 13498 [iot_thread] [INFO ][MQTT][134980] MQTT library successfully initialized.
   13 13498 [iot_thread] OTA demo version 0.9.20
   14 13498 [iot_thread] Creating MQTT Client...
   ```

## 5단계: Android 앱 구성
<a name="ota-updates-esp32-ble-step5"></a>

1. [amazon-freertos-ble-android-sdk](https://github.com/aws/amazon-freertos-ble-android-sdk) GitHub 리포지토리에서 Android 블루투스 로우 에너지 SDK 및 샘플 앱을 다운로드합니다.

1. `app/src/main/res/raw/awsconfiguration.json` 파일을 열고 다음 JSON 샘플의 지침에 따라 Pool Id, Region, AppClientId, AppClientSecret을 입력합니다.

   ```
   {
     "UserAgent": "MobileHub/1.0",
     "Version": "1.0",
     "CredentialsProvider": {
       "CognitoIdentity": {
         "Default": {
           "PoolId": "Cognito->Manage Identity Pools->Federated Identities->mqtt_proxy_identity_pool->Edit Identity Pool->Identity Pool ID",
           "Region": "Your region (for example us-east-1)"
         }
       }
     },
   
     "IdentityManager": {
       "Default": {}
     },
   
     "CognitoUserPool": {
       "Default": {
         "PoolId": "Cognito-> Manage User Pools -> esp32_mqtt_proxy_user_pool -> General Settings -> PoolId",
         "AppClientId": "Cognito-> Manage User Pools -> esp32_mqtt_proxy_user_pool -> General Settings -> App clients ->Show Details",
         "AppClientSecret": "Cognito-> Manage User Pools -> esp32_mqtt_proxy_user_pool -> General Settings -> App clients ->Show Details",
         "Region": "Your region (for example us-east-1)"
       }
     }
   }
   ```

1. `app/src/main/java/software/amazon/freertos/DemoConstants.java`를 열고 이전에 생성한 정책 이름(예: *esp32\$1mqtt\$1proxy\$1iot\$1policy*)과 리전(예: *us-east-1*)을 입력합니다.

1. 데모 앱을 빌드하고 설치합니다.

   1. Android Studio에서 **빌드**를 선택한 다음 **모바일 앱 만들기**를 선택합니다.

   1. **실행**을 선택한 다음 **앱 실행**을 선택합니다. Android Studio의 logcat 창으로 이동하여 로그 메시지를 모니터링할 수 있습니다.

   1. Android 디바이스의 로그인 화면에서 계정을 생성합니다.

   1. 사용자를 생성합니다. 사용자가 이미 있는 경우 보안 인증 정보를 입력합니다.

   1. Amazon FreeRTOS 데모가 디바이스 위치에 액세스할 수 있도록 허용합니다.

   1. 블루투스 로우 에너지 디바이스를 스캔합니다.

   1. 찾은 디바이스의 슬라이더를 **켜기**로 이동합니다.

   1. ESP32용 직렬 포트 디버그 콘솔에서 **y**를 누릅니다.

   1. **페어링 및 연결**을 선택합니다.

1. 연결이 설정되면 **더 보기...** 링크가 활성화됩니다. 연결이 완료되면 Android 디바이스 logcat에서 연결 상태가 "BLE\$1CONNECTED"로 변경되어야 합니다.

   ```
   2019-06-06 20:11:32.160 23484-23497/software.amazon.freertos.demo I/FRD: BLE connection state changed: 0; new state: BLE_CONNECTED
   ```

1. 메시지를 전송하기 전에 Amazon FreeRTOS 디바이스와 Android 디바이스가 MTU를 협상합니다. logcat에 다음 결과가 표시됩니다.

   ```
   2019-06-06 20:11:46.720 23484-23497/software.amazon.freertos.demo I/FRD: onMTUChanged : 512 status: Success
   ```

1. 디바이스가 앱에 연결되고 MQTT 프록시를 사용하여 MQTT 메시지를 보내기 시작합니다. 디바이스가 통신할 수 있는지 확인하려면 MQTT\$1CONTROL 특성 데이터 값을 01로 변경되어야 합니다.

   ```
   2019-06-06 20:12:28.752 23484-23496/software.amazon.freertos.demo D/FRD: <-<-<- Writing to characteristic: MQTT_CONTROL with data: 01
   2019-06-06 20:12:28.839 23484-23496/software.amazon.freertos.demo D/FRD: onCharacteristicWrite for: MQTT_CONTROL; status: Success; value: 01
   ```

1. 디바이스가 페어링되면 ESP32 콘솔에 프롬프트가 표시됩니다. BLE를 활성화하려면 **y**를 누릅니다. 이 단계를 수행할 때까지 데모는 작동하지 않습니다.

   ```
   E (135538) BT_GATT: GATT_INSUF_AUTHENTICATION: MITM Required
   W (135638) BT_L2CAP: l2cble_start_conn_update, the last connection update command still pending.
   E (135908) BT_SMP: Value for numeric comparison = 391840
   15 13588 [InputTask] Numeric comparison:391840
   16 13589 [InputTask] Press 'y' to confirm
   17 14078 [InputTask] Key accepted
   W (146348) BT_SMP: FOR LE SC LTK IS USED INSTEAD OF STK
   18 16298 [iot_thread] Connecting to broker...
   19 16298 [iot_thread] [INFO ][MQTT][162980] Establishing new MQTT connection.
   20 16298 [iot_thread] [INFO ][MQTT][162980] (MQTT connection 0x3ffd5754, CONNECT operation 0x3ffd586c) Waiting for operation completion.
   21 16446 [iot_thread] [INFO ][MQTT][164450] (MQTT connection 0x3ffd5754, CONNECT operation 0x3ffd586c) Wait complete with result SUCCESS.
   22 16446 [iot_thread] [INFO ][MQTT][164460] New MQTT connection 0x3ffc0ccc established.
   23 16446 [iot_thread] Connected to broker.
   ```

## 6단계: OTA 업데이트 스크립트 실행
<a name="ota-updates-esp32-ble-step6"></a>

1. 사전 조건을 설치하려면 다음 명령을 실행합니다.

   ```
   pip3 install boto3
   ```

   ```
   pip3 install pathlib
   ```

1. `demos/include/aws_application_version.h`에서 FreeRTOS 애플리케이션 버전을 높입니다.

1. 새 .bin 파일을 빌드합니다.

1. python 스크립트 [ start\$1ota.py](https://github.com/aws-samples/amazon-freertos-ota-scripts/blob/master/scripts/start_ota.py)를 다운로드합니다. 스크립트에 대한 도움말을 보려면 터미널 창에서 다음 명령을 실행합니다.

   ```
   python3 start_ota.py -h
   ```

   다음과 같은 내용이 표시되어야 합니다.

   ```
   usage: start_ota.py [-h] --profile PROFILE [--region REGION]
                       [--account ACCOUNT] [--devicetype DEVICETYPE] --name NAME
                       --role ROLE --s3bucket S3BUCKET --otasigningprofile
                       OTASIGNINGPROFILE --signingcertificateid
                       SIGNINGCERTIFICATEID [--codelocation CODELOCATION]
   Script to start OTA update
   optional arguments:
   -h, --help            show this help message and exit
   --profile PROFILE     Profile name created using aws configure
   --region REGION       Region
   --account ACCOUNT     Account ID
   --devicetype DEVICETYPE thing|group
   --name NAME           Name of thing/group
   --role ROLE           Role for OTA updates
   --s3bucket S3BUCKET   S3 bucket to store firmware updates
   --otasigningprofile OTASIGNINGPROFILE
                         Signing profile to be created or used
   --signingcertificateid SIGNINGCERTIFICATEID
                         certificate id (not arn) to be used
   --codelocation CODELOCATION
                         base folder location (can be relative)
   ```

1. 제공된 CloudFormation 템플릿을 사용하여 리소스를 생성한 경우 다음 명령을 실행합니다.

   ```
   python3 start_ota_stream.py --profile otausercf --name esp32-ble --role ota_ble_iot_role-sample --s3bucket afr-ble-ota-update-bucket-sample --otasigningprofile abcd --signingcertificateid certificateid
   ```

   ESP32 디버그 콘솔에서 업데이트가 시작되는 것을 확인할 수 있습니다.

   ```
   38 2462 [OTA Task] [prvParseJobDoc] Job was accepted. Attempting to start transfer.
   ---
   49 2867 [OTA Task] [prvIngestDataBlock] Received file block 1, size 1024
   50 2867 [OTA Task] [prvIngestDataBlock] Remaining: 1290
   51 2894 [OTA Task] [prvIngestDataBlock] Received file block 2, size 1024
   52 2894 [OTA Task] [prvIngestDataBlock] Remaining: 1289
   53 2921 [OTA Task] [prvIngestDataBlock] Received file block 3, size 1024
   54 2921 [OTA Task] [prvIngestDataBlock] Remaining: 1288
   55 2952 [OTA Task] [prvIngestDataBlock] Received file block 4, size 1024
   56 2953 [OTA Task] [prvIngestDataBlock] Remaining: 1287
   57 2959 [iot_thread] State: Active  Received: 5   Queued: 5   Processed: 5   Dropped: 0
   ```

1. OTA 업데이트가 완료되면 OTA 업데이트 프로세스에 필요한 경우 디바이스가 다시 시작됩니다. 그런 다음 업데이트된 펌웨어를 사용하여 연결을 시도합니다. 업그레이드가 성공하면 업데이트된 펌웨어가 활성 상태로 표시되고 콘솔에서 업데이트된 버전을 확인할 수 있습니다.

   ```
   13 13498 [iot_thread] OTA demo version 0.9.21
   ```