event.h

Go to the documentation of this file.

/*
 * Copyright (c) 2024 Vogl Electronic GmbH
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_MGMT_HAWKBIT_EVENT_H_
#define ZEPHYR_INCLUDE_MGMT_HAWKBIT_EVENT_H_
 
#include <zephyr/kernel.h>
#include <zephyr/sys/slist.h>
 
enum hawkbit_event_type {
        HAWKBIT_EVENT_ERROR,
        HAWKBIT_EVENT_ERROR_NETWORKING,
        HAWKBIT_EVENT_ERROR_PERMISSION,
        HAWKBIT_EVENT_ERROR_METADATA,
        HAWKBIT_EVENT_ERROR_DOWNLOAD,
        HAWKBIT_EVENT_ERROR_ALLOC,
        HAWKBIT_EVENT_UPDATE_DOWNLOADED,
        HAWKBIT_EVENT_NO_UPDATE,
        HAWKBIT_EVENT_CANCEL_UPDATE,
        HAWKBIT_EVENT_START_DOWNLOAD,
        HAWKBIT_EVENT_END_DOWNLOAD,
        HAWKBIT_EVENT_START_RUN,
        HAWKBIT_EVENT_END_RUN,
        HAWKBIT_EVENT_BEFORE_REBOOT,
};
 
struct hawkbit_event_callback;
 
typedef void (*hawkbit_event_callback_handler_t)(struct hawkbit_event_callback *cb,
                                                 enum hawkbit_event_type event);
 
struct hawkbit_event_callback {
        sys_snode_t node;
 
        hawkbit_event_callback_handler_t handler;
 
        enum hawkbit_event_type event;
};
 
#define HAWKBIT_EVENT_CREATE_CALLBACK(_callback, _handler, _event)                                 \
        struct hawkbit_event_callback _callback = {                                                \
                .handler = _handler,                                                               \
                .event = _event,                                                                   \
        }
 
static inline void hawkbit_event_init_callback(struct hawkbit_event_callback *callback,
                                               hawkbit_event_callback_handler_t handler,
                                               enum hawkbit_event_type event)
{
        __ASSERT(callback, "Callback pointer should not be NULL");
        __ASSERT(handler, "Callback handler pointer should not be NULL");
 
        callback->handler = handler;
        callback->event = event;
}
 
int hawkbit_event_add_callback(struct hawkbit_event_callback *cb);
 
int hawkbit_event_remove_callback(struct hawkbit_event_callback *cb);
 
#endif /* ZEPHYR_INCLUDE_MGMT_HAWKBIT_EVENT_H_ */