fw.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 Golioth, Inc.
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef GOLIOTH_INCLUDE_NET_GOLIOTH_FW_H_
#define GOLIOTH_INCLUDE_NET_GOLIOTH_FW_H_
 
#include <net/golioth.h>
 
enum golioth_fw_state {
    GOLIOTH_FW_STATE_IDLE = 0,
    GOLIOTH_FW_STATE_DOWNLOADING = 1,
    GOLIOTH_FW_STATE_DOWNLOADED = 2,
    GOLIOTH_FW_STATE_UPDATING = 3,
};
 
enum golioth_dfu_result {
    GOLIOTH_DFU_RESULT_INITIAL = 0,
    GOLIOTH_DFU_RESULT_FIRMWARE_UPDATED_SUCCESSFULLY,
    GOLIOTH_DFU_RESULT_NOT_ENOUGH_FLASH_MEMORY,
    GOLIOTH_DFU_RESULT_OUT_OF_RAM,
    GOLIOTH_DFU_RESULT_CONNECTION_LOST,
    GOLIOTH_DFU_RESULT_INTEGRITY_CHECK_FAILURE,
    GOLIOTH_DFU_RESULT_UNSUPPORTED_PACKAGE_TYPE,
    GOLIOTH_DFU_RESULT_INVALID_URI,
    GOLIOTH_DFU_RESULT_FIRMWARE_UPDATE_FAILED,
    GOLIOTH_DFU_RESULT_UNSUPPORTED_PROTOCOL,
};
 
struct golioth_fw_download_ctx {
    struct golioth_blockwise_download_ctx blockwise_ctx;
    char uri[64];
    size_t uri_len;
};
 
int golioth_fw_desired_parse(const uint8_t *payload, uint16_t payload_len,
                 uint8_t *version, size_t *version_len,
                 uint8_t *uri, size_t *uri_len);
 
int golioth_fw_observe_desired(struct golioth_client *client,
                   struct coap_reply *reply,
                   coap_reply_t desired_cb);
 
int golioth_fw_download(struct golioth_client *client,
            struct golioth_fw_download_ctx *ctx,
            const char *uri, size_t uri_len,
            struct coap_reply *reply,
            golioth_blockwise_download_received_t received_cb);
 
int golioth_fw_report_state(struct golioth_client *client,
                const char *package_name,
                const char *current_version,
                const char *target_version,
                enum golioth_fw_state state,
                enum golioth_dfu_result result);
 
#endif /* GOLIOTH_INCLUDE_NET_GOLIOTH_FW_H_ */