at_monitor.h

Go to the documentation of this file.

/*
 * Copyright (c) 2021 Nordic Semiconductor ASA
 *
 * SPDX-License-Identifier: LicenseRef-Nordic-5-Clause
 */
 
#ifndef AT_MONITOR_H_
#define AT_MONITOR_H_
 
#include <stddef.h>
#include <stdbool.h>
#include <zephyr/kernel.h>
#include <zephyr/sys/util_macro.h>
#include <zephyr/toolchain.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef void (*at_monitor_handler_t)(const char *notif);
 
struct at_monitor_entry {
        const char *filter;
        const at_monitor_handler_t handler;
        struct {
                uint8_t paused : 1; /* Monitor is paused. */
                uint8_t direct : 1; /* Dispatch in ISR. */
        } flags;
};
 
#define ANY NULL
#define PAUSED 1
#define ACTIVE 0
 
#define AT_MONITOR(name, _filter, _handler, ...)                                                   \
        static void _handler(const char *);                                                        \
        static STRUCT_SECTION_ITERABLE(at_monitor_entry, name) = {                                 \
                .filter = _filter,                                                                 \
                .handler = _handler,                                                               \
                .flags.direct = false,                                                             \
                COND_CODE_1(__VA_ARGS__, (.flags.paused = __VA_ARGS__,), ())                       \
        }
 
#define AT_MONITOR_ISR(name, _filter, _handler, ...)                                               \
        static void _handler(const char *);                                                        \
        static STRUCT_SECTION_ITERABLE(at_monitor_entry, name) = {                                 \
                .filter = _filter,                                                                 \
                .handler = _handler,                                                               \
                .flags.direct = true,                                                              \
                COND_CODE_1(__VA_ARGS__, (.flags.paused = __VA_ARGS__,), ())                       \
        }
 
static inline void at_monitor_pause(struct at_monitor_entry *mon)
{
        mon->flags.paused = true;
}
 
static inline void at_monitor_resume(struct at_monitor_entry *mon)
{
        mon->flags.paused = false;
}
 
#ifdef __cplusplus
}
#endif
 
#endif /* AT_MONITOR_H_ */