OTAUpdater.cpp

/*
 *
 *    Copyright (c) 2021 Project CHIP Authors
 *
 *    Licensed under the Apache License, Version 2.0 (the "License");
 *    you may not use this file except in compliance with the License.
 *    You may obtain a copy of the License at
 *
 *        http://www.apache.org/licenses/LICENSE-2.0
 *
 *    Unless required by applicable law or agreed to in writing, software
 *    distributed under the License is distributed on an "AS IS" BASIS,
 *    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *    See the License for the specific language governing permissions and
 *    limitations under the License.
 */
#include <OTAUpdater.h>
#include <esp_log.h>
#include <esp_ota_ops.h>
#include <esp_system.h>

namespace {

const char * TAG                            = "OTAUpdate";
bool mOTAUpdateInProgress                   = false;
const esp_partition_t * mOTAUpdatePartition = nullptr;
esp_ota_handle_t mOTAUpdateHandle;
uint32_t mOTAUpdateImageLen = 0;

} // namespace

bool OTAUpdater::IsInProgress(void)
{
    return mOTAUpdateInProgress;
}

esp_err_t OTAUpdater::Begin(void)
{
    if (mOTAUpdateInProgress == true)
    {
        ESP_LOGW(TAG, "Already in progress");
        return ESP_ERR_INVALID_STATE;
    }

    ESP_LOGI(TAG, "Begin");
    mOTAUpdatePartition = esp_ota_get_next_update_partition(NULL);
    if (mOTAUpdatePartition == NULL)
    {
        ESP_LOGE(TAG, "Partition not found");
        return ESP_ERR_NOT_FOUND;
    }
    ESP_LOGI(TAG, "Writing to partition subtype %d at offset 0x%x", mOTAUpdatePartition->subtype, mOTAUpdatePartition->address);

    esp_err_t err = esp_ota_begin(mOTAUpdatePartition, OTA_WITH_SEQUENTIAL_WRITES, &mOTAUpdateHandle);
    if (err != ESP_OK)
    {
        ESP_LOGE(TAG, "esp_ota_begin failed (%s)", esp_err_to_name(err));
        return err;
    }
    mOTAUpdateImageLen   = 0;
    mOTAUpdateInProgress = true;
    return ESP_OK;
}

esp_err_t OTAUpdater::Write(const void * data, size_t length)
{
    if (mOTAUpdateInProgress == false)
    {
        return ESP_ERR_INVALID_STATE;
    }

    esp_err_t err = esp_ota_write(mOTAUpdateHandle, data, length);
    if (err != ESP_OK)
    {
        ESP_LOGE(TAG, "esp_ota_write failed (%s)", esp_err_to_name(err));
        Abort();
        return err;
    }

    mOTAUpdateImageLen += length;
    ESP_LOGI(TAG, "Written image length %d", mOTAUpdateImageLen);
    return ESP_OK;
}

esp_err_t OTAUpdater::Abort(void)
{
    if (mOTAUpdateInProgress == false)
    {
        return ESP_ERR_INVALID_STATE;
    }

    ESP_LOGI(TAG, "Abort");
    mOTAUpdateInProgress = false;
    mOTAUpdateImageLen   = 0;
    return esp_ota_abort(mOTAUpdateHandle);
}

esp_err_t OTAUpdater::End(void)
{
    if (mOTAUpdateInProgress == false)
    {
        return ESP_ERR_INVALID_STATE;
    }

    ESP_LOGI(TAG, "OTA image length %d bytes", mOTAUpdateImageLen);
    esp_err_t err = esp_ota_end(mOTAUpdateHandle);
    if (err != ESP_OK)
    {
        if (err == ESP_ERR_OTA_VALIDATE_FAILED)
        {
            ESP_LOGE(TAG, "Image validation failed, image is corrupted");
        }
        else
        {
            ESP_LOGE(TAG, "esp_ota_end failed (%s)!", esp_err_to_name(err));
        }
    }
    mOTAUpdateInProgress = false;
    return err;
}

// TODO: Apply update after delayed action time
// TODO: Handle applying update after reboot
esp_err_t OTAUpdater::Apply(uint32_t delayedActionTime)
{
    if (mOTAUpdateInProgress == true)
    {
        return ESP_ERR_INVALID_STATE;
    }

    esp_err_t err = esp_ota_set_boot_partition(mOTAUpdatePartition);
    if (err != ESP_OK)
    {
        ESP_LOGE(TAG, "esp_ota_set_boot_partition failed (%s)!", esp_err_to_name(err));
        return err;
    }

    ESP_LOGI(TAG, "Applying, Boot partition set offset:0x%x", mOTAUpdatePartition->address);
    ESP_LOGI(TAG, "Prepare to restart system!");
    esp_restart();
}