nrf_sdh.h

/*
 * Copyright (c) 2024 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef NRF_SDH_H__
#define NRF_SDH_H__
 
#include <stdbool.h>
#include <zephyr/toolchain.h>
#include <zephyr/sys/util.h>
#include <zephyr/sys/iterable_sections.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* Helper macros to check for equality */
 
#define H_NRF_SDH_OBSERVER_PRIO_HIGHEST_HIGHEST 1
#define H_NRF_SDH_OBSERVER_PRIO_HIGH_HIGH 1
#define H_NRF_SDH_OBSERVER_PRIO_USER_USER 1
#define H_NRF_SDH_OBSERVER_PRIO_USER_LOW_USER_LOW 1
#define H_NRF_SDH_OBSERVER_PRIO_LOWEST_LOWEST 1
 
#define PRIO_LEVEL_IS_VALID(level)                                                                 \
        COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_HIGHEST_##level, (),                                   \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_HIGH_##level, (),                                     \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_USER_##level, (),                                     \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_USER_LOW_##level, (),                                 \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_LOWEST_##level, (),                                   \
        (BUILD_ASSERT(0, "Invalid priority level")))))))))))
 
#define PRIO_LEVEL_ORD(level)                                                                      \
        COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_HIGHEST_##level, (0),                                  \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_HIGH_##level, (1),                                    \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_USER_##level, (2),                                    \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_USER_LOW_##level, (3),                                \
        (COND_CODE_1(H_NRF_SDH_OBSERVER_PRIO_LOWEST_##level, (4),                                  \
        (BUILD_ASSERT(0, "Invalid priority level")))))))))))
 
enum nrf_sdh_state_evt {
        NRF_SDH_STATE_EVT_ENABLE_PREPARE,
        NRF_SDH_STATE_EVT_ENABLED,
        NRF_SDH_STATE_EVT_BLE_ENABLED,
        NRF_SDH_STATE_EVT_DISABLE_PREPARE,
        NRF_SDH_STATE_EVT_DISABLED,
};
 
typedef int (*nrf_sdh_state_evt_handler_t)(enum nrf_sdh_state_evt state, void *context);
 
struct nrf_sdh_state_evt_observer {
        nrf_sdh_state_evt_handler_t handler;
        void *context;
        bool is_busy;
};
 
#define NRF_SDH_STATE_EVT_OBSERVER(_observer, _handler, _ctx, _prio)                               \
        PRIO_LEVEL_IS_VALID(_prio);                                                                \
        static TYPE_SECTION_ITERABLE(struct nrf_sdh_state_evt_observer, _observer,                 \
                                     nrf_sdh_state_evt_observers, PRIO_LEVEL_ORD(_prio)) = {       \
                .handler = _handler,                                                               \
                .context = _ctx,                                                                   \
        }
 
typedef void (*nrf_sdh_stack_evt_handler_t)(void *context);
 
struct nrf_sdh_stack_evt_observer {
        nrf_sdh_stack_evt_handler_t handler;
        void *context;
};
 
#define NRF_SDH_STACK_EVT_OBSERVER(_observer, _handler, _ctx, _prio)                               \
        PRIO_LEVEL_IS_VALID(_prio);                                                                \
        static const TYPE_SECTION_ITERABLE(struct nrf_sdh_stack_evt_observer, _observer,           \
                                           nrf_sdh_stack_evt_observers, PRIO_LEVEL_ORD(_prio)) = { \
                .handler = _handler,                                                               \
                .context = _ctx,                                                                   \
        }
 
int nrf_sdh_enable_request(void);
 
int nrf_sdh_disable_request(void);
 
int nrf_sdh_observer_ready(struct nrf_sdh_state_evt_observer *observer);
 
void nrf_sdh_suspend(void);
 
void nrf_sdh_resume(void);
 
bool nrf_sdh_is_suspended(void);
 
void nrf_sdh_evts_poll(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* NRF_SDH_H__ */