기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
HTTP를 사용한 OTA 업데이트 사전 조건
중요
이 문서는 FreeRTOS 릴리스 202012.00에서 사용하기 위한 FreeRTOS 사용 설명서의 보관 버전입니다. 이 문서의 최신 버전은 FreeRTOS 사용 설명서를 참조하세요.
이 단원에서는 HTTP를 사용하여 무선 업데이트(OTA)를 수행하기 위한 일반적인 요구 사항에 대해 설명합니다. 버전 201912.00부터 FreeRTOS OTA는 HTTP 또는 MQTT 프로토콜을 사용하여 펌웨어 업데이트 이미지를에서 디바이스 AWS IoT 로 전송할 수 있습니다.
참고
-
펌웨어 이미지를 전송하는 데 HTTP 프로토콜을 사용할 수도 있지만 작업 실행 알림, 작업 문서 및 실행 상태 업데이트 송수신 등 AWS IoT Core 와의 다른 상호 작용에서 coreMQTT 라이브러리를 사용하기 때문에 coreMQTT 라이브러리가 여전히 필요합니다.
-
OTA 업데이트 작업에 대해 MQTT 및 HTTP 프로토콜을 모두 지정하는 경우 각 디바이스의 OTA 에이전트 소프트웨어 설정에 따라 펌웨어 이미지를 전송하는 데 사용되는 프로토콜이 결정됩니다. OTA 에이전트를 기본 MQTT 프로토콜 메서드에서 HTTP 프로토콜로 변경하려면 장치의 FreeRTOS 소스 코드를 컴파일하는 데 사용되는 헤더 파일을 수정할 수 있습니다.
최소 요구 사항
-
디바이스 펌웨어에는 필요한 FreeRTOS 라이브러리(coreMQTT, HTTP, OTA 에이전트 및 해당 종속성)가 포함되어 있어야 합니다.
-
OTA 프로토콜의 구성을 변경하여 HTTP를 통한 OTA 데이터 전송을 활성화하려면 FreeRTOS 버전 201912.00 이상이 필요합니다.
구성
\vendors\boards\
파일에서 다음과 같은 OTA 프로토콜 구성을 참조하십시오.board
\aws_demos\config_files\aws_ota_agent_config.h
/** * @brief The protocol selected for OTA control operations. * This configuration parameter sets the default protocol for all the OTA control * operations like requesting an OTA job, updating the job status, and so on. * * Note - Only MQTT is supported at this time for control operations. */ #define configENABLED_CONTROL_PROTOCOL ( OTA_CONTROL_OVER_MQTT ) /** * @brief The protocol selected for OTA data operations. * This configuration parameter sets the protocols selected for the data operations * like requesting file blocks from the service. * * Note - Both MQTT and HTTP are supported for data transfer. This configuration parameter * can be set to the following - * Enable data over MQTT - ( OTA_DATA_OVER_MQTT ) * Enable data over HTTP - ( OTA_DATA_OVER_HTTP) * Enable data over both MQTT & HTTP ( OTA_DATA_OVER_MQTT | OTA_DATA_OVER_HTTP ) */ #define configENABLED_DATA_PROTOCOLS ( OTA_DATA_OVER_MQTT ) /** * @brief The preferred protocol selected for OTA data operations. * * Primary data protocol will be the protocol used for downloading files if more than * one protocol is selected while creating OTA job. Default primary data protocol is MQTT * and the following update here switches to HTTP as primary. * * Note - use OTA_DATA_OVER_HTTP for HTTP as primary data protocol. */ #define configOTA_PRIMARY_DATA_PROTOCOL ( OTA_DATA_OVER_MQTT )
HTTP를 통한 OTA 데이터 전송을 활성화하려면
-
configENABLED_DATA_PROTOCOLS
를OTA_DATA_OVER_HTTP
로 변경합니다. -
OTA가 업데이트되면 MQTT 또는 HTTP 프로토콜을 사용할 수 있도록 두 프로토콜을 모두 지정할 수 있습니다.
configOTA_PRIMARY_DATA_PROTOCOL
을OTA_DATA_OVER_HTTP
로 변경하여 디바이스에서 사용하는 기본 프로토콜을 HTTP로 설정할 수 있습니다.
참고
HTTP는 OTA 데이터 작업에만 지원됩니다. 제어 작업의 경우 MQTT를 사용해야 합니다.
디바이스별 구성
- ESP32
-
RAM 양의 제한으로 인해 HTTP를 OTA 데이터 프로토콜로 활성화할 때는 BLE를 꺼야 합니다.
vendors/espressif/boards/esp32/aws_demos/config_files/aws_iot_network_config.h
파일에서AWSIOT_NETWORK_TYPE_WIFI
를configENABLED_NETWORKS
전용으로 변경합니다./** * @brief Configuration flag which is used to enable one or more network interfaces for a board. * * The configuration can be changed any time to keep one or more network enabled or disabled. * More than one network interfaces can be enabled by using 'OR' operation with flags for * each network types supported. Flags for all supported network types can be found * in "aws_iot_network.h" * */ #define configENABLED_NETWORKS ( AWSIOT_NETWORK_TYPE_WIFI )
메모리 사용량
MQTT를 데이터 전송에 사용하는 경우 제어 및 데이터 작업 간에 공유되므로 MQTT 연결에 추가 힙 메모리가 필요하지 않습니다. 그러나 HTTP를 통해 데이터를 전송하려면 추가 힙 메모리가 필요합니다. 다음은 FreeRTOS xPortGetFreeHeapSize
API를 사용하여 계산된 모든 지원되는 플랫폼의 힙 메모리 사용량 데이터입니다. OTA 라이브러리를 사용하기에 충분한 RAM이 있는지 확인해야 합니다.
- Texas Instruments CC3220SF-LAUNCHXL
-
제어 작업(MQTT): 12KB
데이터 작업(HTTP): 10KB
참고
TI는 하드웨어에서 SSL을 수행하기 때문에 RAM을 훨씬 적게 사용하므로 mbedtls 라이브러리를 사용하지 않습니다.
- Microchip Curiosity PIC32MZEF
-
제어 작업(MQTT): 65KB
데이터 작업(HTTP): 43KB
- Espressif ESP32
-
제어 작업(MQTT): 65KB
데이터 작업(HTTP): 45KB
참고
ESP32의 BLE는 약 87KB의 RAM을 사용합니다. 위의 디바이스별 구성에서 언급한 모든 내용을 활성화할 수 있는 RAM이 충분하지 않습니다.
- Windows 시뮬레이터
-
제어 작업(MQTT): 82KB
데이터 작업(HTTP): 63KB
- Nordic nrf52840-dk
-
HTTP는 지원되지 않습니다.
디바이스 정책
이 정책을 사용하면 OTA 업데이트에 MQTT 또는 HTTP를 사용할 수 있습니다.
HTTP를 사용하여 OTA 업데이트를 수신하는 각 장치는 AWS IoT 에 항목으로 등록되어야 하며, 여기에 나열된 것과 같은 연결 정책이 있어야 합니다. "Action"
및 "Resource"
객체의 항목에 대한 자세한 내용은 AWS IoT 핵심 정책 작업 및 AWS IoT 핵심 작업 리소스에서 확인할 수 있습니다.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iot:Connect", "Resource": "arn:
partition
:iot:region
:account
:client/${iot:Connection.Thing.ThingName}" }, { "Effect": "Allow", "Action": "iot:Subscribe", "Resource": [ "arn:partition
:iot:region
:account
:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/jobs/*" ] }, { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Receive" ], "Resource": [ "arn:partition
:iot:region
:account
:topic/$aws/things/${iot:Connection.Thing.ThingName}/jobs/*" ] } ] }
Notes
-
iot:Connect
권한을 사용하면 MQTT를 통해 디바이스를 AWS IoT 에 연결할 수 있습니다. -
AWS IoT 작업 주제에 대한
iot:Subscribe
및iot:Publish
권한(.../jobs/*
)을 사용하면 연결된 디바이스가 작업 알림 및 작업 문서를 수신하고 작업 실행의 완료 상태를 게시할 수 있습니다. -
iot:Receive
권한을 통해 AWS IoT Core 는 해당 주제에 대한 메시지를 현재 연결된 디바이스에 게시할 수 있습니다. MQTT 메시지를 전송할 때마다 이 권한을 확인합니다. 이 권한을 사용하면 주제를 현재 구독 중인 클라이언트에 대한 액세스 권한을 취소할 수 있습니다.