callbacks.h

Go to the documentation of this file.

/*
 * Copyright (c) 2022-2026 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef H_MCUMGR_CALLBACKS_
#define H_MCUMGR_CALLBACKS_
 
#include <inttypes.h>
#include <zephyr/sys/slist.h>
#include <zephyr/mgmt/mcumgr/mgmt/mgmt.h>
#include "callback_defines.h"
 
#if defined(CONFIG_MCUMGR_GRP_FS) || defined(__DOXYGEN__)
#include <zephyr/mgmt/mcumgr/grp/fs_mgmt/fs_mgmt_callbacks.h>
#endif
 
#if defined(CONFIG_MCUMGR_GRP_IMG) || defined(__DOXYGEN__)
#include <zephyr/mgmt/mcumgr/grp/img_mgmt/img_mgmt_callbacks.h>
#endif
 
#if defined(CONFIG_MCUMGR_GRP_OS) || defined(__DOXYGEN__)
#include <zephyr/mgmt/mcumgr/grp/os_mgmt/os_mgmt_callbacks.h>
#endif
 
#if defined(CONFIG_MCUMGR_GRP_SETTINGS) || defined(__DOXYGEN__)
#include <zephyr/mgmt/mcumgr/grp/settings_mgmt/settings_mgmt_callbacks.h>
#endif
 
#if defined(CONFIG_MCUMGR_GRP_ENUM) || defined(__DOXYGEN__)
#include <zephyr/mgmt/mcumgr/grp/enum_mgmt/enum_mgmt_callbacks.h>
#endif
 
#ifdef __cplusplus
extern "C" {
#endif


typedef enum mgmt_cb_return (*mgmt_cb)(uint32_t event, enum mgmt_cb_return prev_status,
                                       int32_t *rc, uint16_t *group, bool *abort_more, void *data,
                                       size_t data_size);

enum smp_group_events {
        MGMT_EVT_OP_CMD_RECV                    = MGMT_DEF_EVT_OP_ID(MGMT_EVT_GRP_SMP, 0),

        MGMT_EVT_OP_CMD_STATUS                  = MGMT_DEF_EVT_OP_ID(MGMT_EVT_GRP_SMP, 1),

        MGMT_EVT_OP_CMD_DONE                    = MGMT_DEF_EVT_OP_ID(MGMT_EVT_GRP_SMP, 2),

        MGMT_EVT_OP_CMD_ALL                     = MGMT_DEF_EVT_OP_ALL(MGMT_EVT_GRP_SMP),
};

struct mgmt_callback {
        sys_snode_t node;

        mgmt_cb callback;

        uint32_t event_id;
};

struct mgmt_evt_op_cmd_arg {
        uint16_t group;

        uint8_t id;
 
        union {
                uint8_t op;

                int err;

                int status;
        };
};

uint8_t mgmt_evt_get_index(uint32_t event);

enum mgmt_cb_return mgmt_callback_notify(uint32_t event, void *data, size_t data_size,
                                         int32_t *err_rc, uint16_t *err_group);

void mgmt_callback_register(struct mgmt_callback *callback);

void mgmt_callback_unregister(struct mgmt_callback *callback);

 
#ifdef __cplusplus
}
#endif
 
#endif /* H_MCUMGR_CALLBACKS_ */